p0 line landing: coord board/roll + wrapper usage contract + dispatch layer (successor to #1467) #1468

Open
orch-01 wants to merge 6 commits from mosaic-cli-p0 into next
Member

Fresh PR successor to the checker-wedged #1467 (head-tracking broken). The p0 line landing: PR 1462 (issue-comment contract, merged 41e80463) + PR 1464 (16-wrapper usage contract + census) + PR 1463 (dispatch layer) integrated at mosaic-cli-p0 tip 7aba12ae (+#1467 requeue commit). Reviews: APPROVE 357 (1462), 359 after census correction (1464), comment 24869 full verdict (1463), integration APPROVE 360 official (rev-code-01, record ac026a1c lineage). CI green on the line.

Fresh PR successor to the checker-wedged #1467 (head-tracking broken). The p0 line landing: PR 1462 (issue-comment contract, merged 41e80463) + PR 1464 (16-wrapper usage contract + census) + PR 1463 (dispatch layer) integrated at mosaic-cli-p0 tip 7aba12ae (+#1467 requeue commit). Reviews: APPROVE 357 (1462), 359 after census correction (1464), comment 24869 full verdict (1463), integration APPROVE 360 official (rev-code-01, record ac026a1c lineage). CI green on the line.
orch-01 added 5 commits 2026-08-29 02:51:30 +00:00
Upstream of brain commits 08a00149 + 971586ef + the arm-6 sandbox fix
(brain 5th commit of 2026-08-28 series):

- R1: -b/--body is the canonical comment flag (matches issue-create,
  issue-edit, pr-create, pr-edit); -c/--comment stays a compatible alias.
- R4: usage errors print to stderr and exit 2, distinct from provider,
  credential, and verification failures (exit 1). Value-less flags fail
  loudly (previously -c with no value died silently at rc=1 via set -e on
  the failed shift 2). gh failures on the GitHub path normalize to exit 1
  (gh's own usage errors exit 2 and would collide with the reserved code).
- Tests: new usage-contract suite (help rc, unknown/missing/value-less rc=2
  on stderr, alias parse acceptance under a sandboxed runner, GitHub-path
  exit normalization with a stubbed gh, zero provider contact on parser
  failure); readback suite gains case 11 (full verified write via -b) and
  neutralizes seat-exported MOSAIC_GIT_IDENTITY / MOSAIC_BRAIN_HOME that
  escape the sandboxed HOME (documented HTTP 401 / fail-loud shapes).

Driver: a fleet seat full-stopped on an issue-comment usage error because
usage failures were indistinguishable from provider failures and the stop
gate treated every wrapper failure as blocking.
Codex review of a27b7dc9 (blocker): check-test-enumeration.sh rejects
unenumerated test files.

- test-issue-comment-usage-contract.sh enrolled in test:framework-shell
  (hermetic by construction: PATH stubs, sandboxed runner, no network).
- test-issue-comment-readback.sh enrolled and its stale exclusion removed.
  The exclusion's own note anticipated this: 'joins CI after the
  wrapper-half hermeticity fix' - that fix (neutralizing seat-exported
  MOSAIC_GIT_IDENTITY / MOSAIC_BRAIN_HOME that escape the sandboxed HOME)
  landed in a27b7dc9. Suite green in brain and worktree trees tonight.

Enumeration guard: OK (population 73, enumerated 60, excluded 14).
Co-authored-by: marcie <[email protected]>
Co-authored-by: marcie <[email protected]>
orch-01 added 1 commit 2026-08-29 02:56:58 +00:00
# Conflicts:
#	packages/mosaic/framework/tools/git/issue-comment.sh
#	packages/mosaic/framework/tools/git/test-issue-comment-usage-contract.sh
#	packages/mosaic/package.json
All checks were successful
ci/woodpecker/pr/ci Pipeline was successful
Required
Details
This pull request doesn't have enough required approvals yet. 0 of 1 official approvals granted.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin mosaic-cli-p0:mosaic-cli-p0
git checkout mosaic-cli-p0
Sign in to join this conversation.