feat(roles): the Triage template, read-only and human-only, with a system-only fence so no organization gains it (#1873) #1980

Merged
jason.woltje merged 2 commits from triage-fence into refactor 2026-11-16 17:45:38 +00:00
Owner

What changes

  • Adds the Triage role template, roles/triage.json and roles/triage.md. Tools: read, grep, find, ls. Network: none. Credentials: none. It sends to and receives from the human only. It holds no grant above the shipped chief of staff.
  • Adds a system-only list to the core vocabulary, naming triage. No organization can gain a template on that list. Every path refuses with the fixed code template-system-only.

The two land together on purpose. The template alone would be hireable in every organization, and a hire with no flagged line can be approved by an agent.

How

  • packages/organization/src/vocabulary.mjs: SYSTEM_ONLY, SYSTEM_ONLY_REFUSAL, systemOnly(). One list, read everywhere.
  • Refused at: hire and change proposals at org, project and root level; pack preview and apply; instances.set; launch; the organization file's own validation; agent-level writes; the template lists the Console offers.
  • The template still loads and validates as a template. No host, relay, route or CLI verb is added here. Nothing under contracts/, no schema change, no other template changed.

Tests

  • New: packages/organization/tests/system-only.test.mjs and packages/bus/tests/system-only.test.mjs, one test per refused path. On the commit before the fence, 16 of 18 and 9 of 10 fail.
  • Lane gate on 4a9c7a931: 349 files, each alone, 3843 pass, 0 fail, 4 skipped (org-quick-live).
  • Lead check on 4a9c7a931: 1150 pass, 0 fail over all organization and plugins tests and the hire, pack, template and instances tests in bus and webui.

Review

The template was reviewed with its design by a fresh claude-opus-5-5 reviewer: 11 findings, none P1, all fixed. The fence was reviewed by a second fresh reviewer, asked to find a path by which an organization still gains a Triage. It approved with no blocking finding.

Left for later

  • Organization create and the agent-level writes refuse, but answer org-invalid, agents-invalid or project-agents-invalid with the fixed code only as a message prefix.
  • The workflow step picker still lists triage as a step label. It creates no hire.
  • The HTTP status for the refusal is 409 in one table and 400 in two others.

Owner approval: Jason, 2026-11-16, for the template and the fence.

## What changes - Adds the Triage role template, `roles/triage.json` and `roles/triage.md`. Tools: read, grep, find, ls. Network: none. Credentials: none. It sends to and receives from the human only. It holds no grant above the shipped chief of staff. - Adds a system-only list to the core vocabulary, naming `triage`. No organization can gain a template on that list. Every path refuses with the fixed code `template-system-only`. The two land together on purpose. The template alone would be hireable in every organization, and a hire with no flagged line can be approved by an agent. ## How - `packages/organization/src/vocabulary.mjs`: `SYSTEM_ONLY`, `SYSTEM_ONLY_REFUSAL`, `systemOnly()`. One list, read everywhere. - Refused at: hire and change proposals at org, project and root level; pack preview and apply; `instances.set`; launch; the organization file's own validation; agent-level writes; the template lists the Console offers. - The template still loads and validates as a template. No host, relay, route or CLI verb is added here. Nothing under `contracts/`, no schema change, no other template changed. ## Tests - New: `packages/organization/tests/system-only.test.mjs` and `packages/bus/tests/system-only.test.mjs`, one test per refused path. On the commit before the fence, 16 of 18 and 9 of 10 fail. - Lane gate on 4a9c7a931: 349 files, each alone, 3843 pass, 0 fail, 4 skipped (`org-quick-live`). - Lead check on 4a9c7a931: 1150 pass, 0 fail over all organization and plugins tests and the hire, pack, template and instances tests in bus and webui. ## Review The template was reviewed with its design by a fresh claude-opus-5-5 reviewer: 11 findings, none P1, all fixed. The fence was reviewed by a second fresh reviewer, asked to find a path by which an organization still gains a Triage. It approved with no blocking finding. ## Left for later - Organization create and the agent-level writes refuse, but answer `org-invalid`, `agents-invalid` or `project-agents-invalid` with the fixed code only as a message prefix. - The workflow step picker still lists triage as a step label. It creates no hire. - The HTTP status for the refusal is 409 in one table and 400 in two others. Owner approval: Jason, 2026-11-16, for the template and the fence.
jason.woltje added 2 commits 2026-11-16 17:45:35 +00:00
roles/triage.json: read, grep, find and ls; network none; message.send within role and nothing
cross-role; no credentials; messaging to and from the human only. Every grant is a subset of the
chief of staff's, so no line is flagged above the chief. No web grant, so the REQ-HARN-2 pin holds.
roles/triage.md: Triage reads health, explains, and proposes existing mosaic verbs as cards the
person runs. It never hires, raises a hire, applies or drafts a pack apply, or reads a secret; of
the system config it reports only whether the check passed. Carries the proactive line every
contract pins. Template only, per Jason's 2026-11-16 ruling; no new grant, verb or transport.
One list, SYSTEM_ONLY in vocabulary.mjs, names triage; every path by which an
organization could gain one refuses with the one code template-system-only:
hire prepare at org, project and root level and a change onto it (hire.raise,
hire.start.console, decision.raise naming role.hire or role.change); the hire
and definitions template lists omit it; definition import; a definition copied
from it; organization roles, root agents and project agents; a pack record
pinning it; a starter pack defining it, so pack preview and apply refuse an
installed pack that names it; instances.set add and change for the human and
the tester, and the instances add list omits it. The broker passes the code
through and the webui tables map it. The template itself still loads and
validates. Red-first tests in organization and bus system-only.test.mjs; the
channel-proof hash of webui bus.mjs and the broker import pin are updated.
jason.woltje merged commit 4a9c7a931c into refactor 2026-11-16 17:45:38 +00:00
Sign in to join this conversation.