stoke/CONTRIBUTING.md
claude-lead-andresmgsl 85cb8568c5
All checks were successful
labels / labels (pull_request) Successful in 7s
ci / test (pull_request) Successful in 13s
chore(governance): the three-member panel in the roster and its test
The previous commit moved panel= to glm, claude and kimi; this one moves
what pins it. test/governance.test.js named "the current four-member panel"
and asserted "4 identities resolved" against the real conf, so it failed as
it should on the change. CONTRIBUTING.md's roster restates panel= and now
names the builders separately.

Local: npm test 155/155; npm run check:governance ->
"3 identities resolved; 5 scope rows valid" against the live forge.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018EuKA4GdpAJMhBtPUj7phs
2026-09-30 20:43:37 +00:00

2.3 KiB

Contributing to stoke

Read the role instructions in .ceremony/ first. This file contains only facts specific to the stoke repository.

Review panel

Identity
glm-bot-andresmgsl
claude-bot-andresmgsl
kimi-bot-andresmgsl

The panel= line in .github/labels.conf is authoritative; this table is its human-readable restatement.

Builders — codex-bot-andresmgsl and codex-bot-2-andresmgsl — write code and do not review, so they are not on the panel (operator decision, 2026-09-30).

The scope:* set

Scope Covers
scope:cli src/ — the command surface (cli.js, api.js, and config.js)
scope:packaging scripts/, release workflow, package manifests, changelog, and fragments — release packaging and version surfaces
scope:manifests manifests/ — fleet repository registry data
scope:ci .forgejo/workflows/, .github/, and .ceremony/ — the test, label, and governance gates
scope:docs root Markdown and docs/ — the prose contract

These names and path descriptions restate the scope rows in .github/labels.conf.

Drills

Stoke currently practises no drill. The repository has no drills/ directory; releases use stoke's own tag-driven .forgejo/workflows/release.yml, not the ceremony release flow; and the maintainer-created blocker:drill-pending label (label 252) carries no open item.

If the open ruling in #27 adopts ceremony's release workflow, that work must update this section. This description of the current route takes no position on the ruling's alternatives.

Code conventions

  • The package uses CommonJS: package.json declares "type": "commonjs", and files under src/ use require() and module.exports rather than ESM.
  • Tests use Node's built-in node:test module, live in test/*.test.js, and run through node --test; there is no separate test framework dependency.
  • package.json requires Node.js 22.12.0 or newer.
  • Shell programs under scripts/ use the #!/usr/bin/env bash shebang.

Work issue ownership

Only triage mints work issues; anyone may file a proposal, which triage converts or refuses.