Skip to content

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.

fix(lanes): teach lead routing and preserve help forms [A5,I11,N37,B21]

Corey Olson010aae6be9c6
diff --git a/docs/formats.md b/docs/formats.md
index 3ff92a4c..2fced428 100644
--- a/docs/formats.md
+++ b/docs/formats.md
@@ -444,6 +444,7 @@ The `event` table is a SQLite schema object governed by `SCHEMA_VERSION`; its ap
| `main-moved` | coordinator | `batch`, `items`, `sha` |
| `withdraw` | coordinator | `reason` |
| `refreeze` | coordinator, or live holder adopting a pending correction | `before`, `after`, optional `retainedClaim` |
+| `lane-lead` | coordinator | `lane`, `seat` |
| `hold` | coordinator | `lane`, `reason` |
| `unhold` | coordinator | `lane` |
| `hold_item` | coordinator | `reason` |
@@ -451,7 +452,7 @@ The `event` table is a SQLite schema object governed by `SCHEMA_VERSION`; its ap
| `guards` | board | `missing`, `changed`, `stale` |
| `rigor-notice` | rigor | `cause`, `items`, `occurrences`, `neverAgain`, `engine`, automatic-Rigor `drafts` |
| `rigor-draft` | rigor | `id`, `target`, `cause`, exact typed `source`, `unproved` (always true), `items`, `occurrences`, `engine` |
-| `shout` | sender | `shout`, `to`, `decision`, `request`, `answers` |
+| `shout` | sender | `shout`, `to`, `decision`, `request`, `answers`, `messageKind` |
| `shout_news` | sender | `shout`, `to`, `decision`, `request`, `answers` |
| `flake-observation` | reporting agent | `engine`, `observation` |
| `flake-repair` | reporting agent | `engine`, `key`, `item` |
@@ -463,7 +464,7 @@ The `event` table is a SQLite schema object governed by `SCHEMA_VERSION`; its ap
| `sentinel-start` | running agent | `name`, `digest`, `run`, `until`, `engine` |
| `sentinel-run` | running agent | `name`, `digest`, `run`, `result`, `engine` |
| `sentinel-failure` | sentinel | `name`, `digest`, `run`, `cause`, `engine` |
-| `pass` | coordinator | `shout`, `to`, `decision`, `request`, `answers` |
+| `pass` | coordinator, or lane lead | `shout`, `to`, `decision`, `request`, `answers` |
| `answer` | answerer | `shout`, `to`, `decision`, `request`, `answers`, `outcome`, `channel`, engine-20 `implies`, `supersedes`, decision-origin `provenance` |
| `row_decision` | person | `record`, `channel` |
| `row_draft` | builder, or rigor | engine-55 `row`, `written` |
@@ -511,7 +512,7 @@ A project with `"submitGate": "landing"` can also set `"submitInvariants": ["tes
With `"submitGate": "landing"`, `"submitDeferAbove": N` (a whole number, 1 or more; absent by default) moves an affected selection of more than N test files from submit to landing. Such a submit runs its frozen check, the static checks and `submitInvariants` only, records the selection as `submissionProof.deferredFiles`, and notes `<count> affected test files deferred to the landing gate` on the submission, where `show` prints it. A full-gate landing already runs every file. A landing with `"landing": { "publish": "separate" }` runs the recorded files on the merged tree before anything lands; a red sends back each item whose own deferred files failed, and nothing in that batch lands.
<!-- pass-rule:start -->
-The `pass` event is emitted by `passDecision` only for the coordinator; another agent receives `COORDINATOR_ONLY`. Its event actor is the coordinator. The person receives the passed decision, while the event table records who performed the pass.
+The `pass` event is emitted by `passDecision` only for the coordinator in the historical protocol; another agent receives `COORDINATOR_ONLY`. The lane-lead engine also permits the addressed lead to escalate its own lane question to the coordinator. Its event actor is the coordinator or that lane lead. The coordinator passes to the person; the lead passes to the coordinator, while the event table records who performed the pass.
<!-- pass-rule:end -->
## Static view export
@@ -676,3 +677,5 @@ not a native move, parent identity, configuration or authority record. Missing/d
replays activity. Reads freeze an event high-water mark before observing Git; subsequent events
and messages remain pending. News has a separate cursor so an ordinary poll cannot consume a
future session-start digest.
+
+The lane-lead engine, numbered at landing, adds coordinator-only `setLaneLead` with `{agentId, lane, seat, lanes}`. The seat is an existing agent in that lane, or `null` to remove the lead. Its `lane-lead` event records `lane` and `seat`. Typed shout routing records `messageKind` (`question`, `blocker` or `decision`); a status shout is refused. Older recorded engines retain their original routing and event details. Questions and blockers go to the named lead; lead decisions and explicit escalations go to the coordinator. Naming a lead grants no claim, lease or person authority.
diff --git a/docs/formats.test.js b/docs/formats.test.js
index 0f01bac5..0eeaaaea 100644
--- a/docs/formats.test.js
+++ b/docs/formats.test.js
@@ -56,6 +56,7 @@ import {
reopen,
reserveReview,
SCHEMA_VERSION,
+ setLaneLead,
shout,
verify,
withdraw,
@@ -300,6 +301,11 @@ function recordEventContract() {
register(board, { lane: 'docs', path: '/builder', family: 'codex' });
register(board, { lane: 'docs', path: '/builder', model: 'Fixture Model' });
const reviewer = register(board, { lane: 'tests', path: '/reviewer' });
+ setLaneLead(board, { agentId: coordinator, lane: 'docs', seat: builder, lanes: ['docs', 'tests'] });
+ const laneWorker = register(board, { lane: 'docs', path: '/lane-worker' });
+ const laneQuestion = shout(board, { from: laneWorker, to: coordinator, text: 'sample lane escalation', decision: true, lanes: ['docs', 'tests'] });
+ passDecision(board, laneQuestion, { agentId: builder, note: 'Needs coordination', lanes: ['docs', 'tests'] });
+ setLaneLead(board, { agentId: coordinator, lane: 'docs', seat: null, lanes: ['docs', 'tests'] });
register(board, { lane: 'small', path: '/small', route: 'light' });
ensureCoordinator(board, '/coordinator-moved');
shout(board, { from: builder, to: 'all', text: 'sample announcement', lanes: ['docs', 'tests'] });
@@ -719,6 +725,7 @@ test('[A5] schema, versions, event kinds and event detail fields match live beha
family: 'agent',
model: 'agent',
moved: 'coordinator',
+ 'lane-lead': 'coordinator',
add: 'item creator',
edit: 'editor',
attempt: 'reporting agent',
@@ -744,7 +751,7 @@ test('[A5] schema, versions, event kinds and event detail fields match live beha
for (const row of actualRows) {
const kind = row.event_kind;
const entry = actual[kind] ?? { actors: new Set(), fields: new Set() };
- const actor = kind === 'refreeze' && row.event_by !== COORDINATOR
+ const actor = kind === 'pass' && row.event_by !== COORDINATOR ? 'lane lead' : kind === 'refreeze' && row.event_by !== COORDINATOR
? 'live holder adopting a pending correction'
: actorByKind[kind] ?? actors[row.event_by] ?? 'unknown';
entry.actors.add(actor);
diff --git a/src/help.js b/src/help.js
index 071c10f0..68ab163a 100644
--- a/src/help.js
+++ b/src/help.js
@@ -348,7 +348,7 @@ const HELP_ALIASES = {
help: { usage: 'pullboard help', source: null },
version: { usage: 'pullboard version', source: null },
whoami: { usage: 'pullboard whoami', source: 'whoami' },
- lanes: { usage: 'pullboard lanes [lead <lane> <seat|off>]', source: 'whoami' },
+ lanes: { usage: 'pullboard lanes', source: 'whoami' },
agents: { usage: 'pullboard agents', source: 'whoami' },
lane: { usage: 'pullboard lane add <name> --owns <path>[,<path>]', source: 'lane add' },
status: { usage: 'pullboard status', source: 'whoami' },
diff --git a/src/templates.js b/src/templates.js
index cb4a1811..5c80b735 100644
--- a/src/templates.js
+++ b/src/templates.js
@@ -146,6 +146,8 @@ When a reject names a structured cause, add \`--cause <key>\` (\`test:<file>::<t
The coordinator merges verified items into the main line; builders never merge. When a release ships, the coordinator runs \`pullboard milestone ship <name>\`: it records main's commit and moves the items that have not landed into the next milestone. \`pullboard health\` lists every stuck item: a lapsed claim, a review nobody took, accepted work that never landed, an old hold, an unanswered decision. Each line says why, since when, the next step and who takes it; run it at the start of a session and take the steps that name you.
+Lane leads are off until the coordinator names an existing lane seat with \`pullboard lanes lead <lane> <seat|off>\`. Questions and blockers sent with \`pullboard shout coordinator "<text>" --kind question|blocker --decision\` reach that lead. The lead answers or uses \`pullboard pass <shout-id> "<why>"\` to escalate to the coordinator; only its decisions and escalations go upward. Status stays activity, not a coordination shout. A lead gains no claim, lease or person-approval authority.
+
For recurring checks, \`pullboard sentinels\` lists this board's watches, their approvals and their latest results. Propose one with \`pullboard sentinel propose <name> --check "<command>" --every hourly --owner coordinator\`; a proposal does not run until the person approves its exact command, directory and schedule. Only the person runs \`pullboard sentinel approve <name>\` or \`pullboard sentinel decline <name> --reason "<why>"\` from their own terminal or Pullboard View. Agents never approve their own proposals; send the decision to the coordinator.
For spare test capacity, use \`pullboard runner add <ssh-host> --slots <n> --browser <n>\`. It registers SSH capacity on this machine; \`pullboard runner list\` shows each runner's registered slots and browsers, and \`pullboard resources\` shows their usage. Only committed source goes to a runner, and board moves stay here. To see whether this board is linked to the relay, and for which GitHub account, run \`pullboard relay status\`.
diff --git a/test/lane-lead.test.js b/test/lane-lead.test.js
index c040d5ba..25b3da0d 100644
--- a/test/lane-lead.test.js
+++ b/test/lane-lead.test.js
@@ -62,6 +62,10 @@ test('a lane question reaches its lead and only the decision reaches the coordin
assert.equal(message(box, blocked.id).shout_to, leadId);
const status = box.run(box.web, 'shout', 'coordinator', 'Still implementing', '--kind', 'status', '--json');
assert.equal(JSON.parse(status.out).error?.code, 'STATUS_IS_ACTIVITY');
+ const beforeDeniedDecision = document(box, box.repo, 'export');
+ const decision = box.run(box.web, 'shout', 'coordinator', 'Worker cannot decide for the lane', '--kind', 'decision', '--json');
+ assert.equal(JSON.parse(decision.out).error?.code, 'NOT_LANE_LEAD');
+ assert.deepEqual(document(box, box.repo, 'export'), beforeDeniedDecision, 'a refused non-lead decision changes no durable history');
const answer = document(box, lead, 'answer', String(question.id), 'Use the local interface');
assert.ok(document(box, box.web, 'inbox').shouts.some(row => row.shout_id === answer.id));
assert.ok(document(box, box.repo, 'inbox').shouts.some(row => row.shout_from === leadId && row.shout_text.includes('Use the local interface')),