Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.
JavaScript agentic-codingai-agentsai-governanceautonomous-agentsclaude-codeclicode-reviewcodexcoding-agentsdeveloper-toolsgit-hooksllmlocal-firstmulti-agentsoftware-factoryspec-driven-developmentverificationvibe-coding
/** @pullboard-test-input source-tree */
/** The approved contribution wording and the maintainers' complete safe intake path [I11]. */
import assert from 'node:assert/strict';
import { createHash } from 'node:crypto';
import { readFileSync } from 'node:fs';
import { test } from 'node:test';
/** Read a public contribution document from the checked source tree. */
const read = path => readFileSync(new URL('../' + path, import.meta.url), 'utf8');
test('CONTRIBUTING teaches the sign-off and the runbook names every step [I11]', () => {
const contributing = read('CONTRIBUTING.md');
assert.match(contributing, /How to sign off/u);
assert.equal(createHash('sha256').update(contributing).digest('hex'),
'bc9cf801e22c57244033d2b9e69add43019278d63ca6e7adbce3d7ef94245e5d',
'the approved contributor guide, including the accurate CLA description, is preserved');
for (const phrase of ['git commit -s', 'git commit --amend -s --no-edit', 'git rebase --signoff main',
'Contributor License Agreement', 'You keep ownership', 'patents', 'We aim to reply within 7 days']) {
assert.ok(contributing.includes(phrase), phrase);
}
for (const phrase of ['Apache Individual Contributor License Agreement v2.2 terms', 'Pullboard as recipient',
'nonprofit-bylaws sentence and form fields are omitted', 'acceptance is through the CLA bot']) {
assert.ok(contributing.includes(phrase), phrase);
}
const runbook = read('docs/contributing-runbook.md');
for (const phrase of [
'When an issue arrives',
'Reply when capacity allows: thank them, and say what happens next',
'on our board as #N', 'a question first', 'not planned, because',
'File it on the board, or map it onto an existing item or milestone', 'Link the board item in the reply',
'When a pull request arrives',
'there is no fixed response time', 'ask for a sign-off if any commit lacks one', 'How to sign off',
'Read the diff before running anything', 'changes outside the stated purpose', 'new dependencies (refuse them)',
'sensitive paths (relay, sealing, signing, person moves, hooks, code that runs commands)',
'network calls, file access outside the repo, obfuscation, big pasted blocks',
'The check is the contributor\'s new test, which must fail on `main` and pass at their commit',
'Record the PR number, the author and the exact commit',
'a container or throwaway VM with no credentials, no access to the home folder and no network',
'the full gate on the minimum Node version (22.13) plus the current version',
'the browser tests when the change touches the view or relay',
'outside code never runs on a machine holding credentials',
'Sensitive paths need the owner\'s approval',
'Confirm the [CLA](../CLA.md) before merge', 'through the CLA bot on their first pull request',
'land through the merge train', 'Never use GitHub\'s merge button',
'The contributor stays the commit author', 'Co-authored-by', 'Keep their `Signed-off-by` line',
'The PR shows as merged, or we close it with a link to the landed commit', 'Thank them, and link the receipt',
'comment with the verifier\'s note in plain words', 'the item is verified again at the new commit',
'Declining:** close with a clear, kind reason', 'Merging is always the project\'s call',
]) {
assert.ok(runbook.includes(phrase), phrase);
}
assert.doesNotMatch(runbook, /reply within 3 days/iu);
const template = read('.github/pull_request_template.md');
assert.match(template, /- \[ \].*sign.*off/iu);
assert.match(template, /CLA/u);
assert.match(template, /(?:linked.issue|fixes #)/iu);
const cla = read('CLA.md');
assert.match(cla, /\bversion 2\.2\b/u);
assert.equal(createHash('sha256').update(cla).digest('hex'),
'866fe77a4eb04eb948c5f92494804136ecce3980bc3e6280d7e638f0791a691c',
'the coordinator-approved 0124 CLA companion is copied without changing its terms');
for (const phrase of ['Pullboard', 'Grant of Copyright License', 'Grant of Patent License',
'You reserve all right', 'WITHOUT WARRANTIES']) assert.ok(cla.includes(phrase), phrase);
assert.ok(!cla.includes('[email protected]'), 'the Apache recipient is not presented as Pullboard contact');
for (const path of ['SECURITY.md', 'CODE_OF_CONDUCT.md']) assert.ok(read(path).trim(), path);
});