Files
stack/docs/plans/2026-10-22_federation-r3.md
jason.woltje f0d0b31e9b docs: briefs for the activate --send/--no-sso row, FED R3 and the 193b1 split; phase 2 plan F39 fixes
- docs/plans/2026-10-22_activate-send-nosso.md: the row Mos approved in mos-1246. Darkwing builds,
  Filbert reviews. --no-sso drops --send, --send refuses without --sso (F39), test-release.sh cases.
- docs/plans/2026-10-22_federation-r3.md: FED R3, the broker user principal, on 193b1a's candidate.
  Owner Morgana, reviewer Dewey. Its parents R1 and row 196 have landed, and the filing was owed.
- human-users-build.md: 193b1 split into 193b1a (message filter, chained on 196) and 193b1b (viewer
  verbs and board refusals, after FED R3 and R4). Mutant 3 moves to 193b2 (sage-2288, morgana-0063).
- sso-phase2-window.md draft 2: the tool gap paragraph names the approved row, and rollback step 1
  drops "--send follows the pointer", since --no-sso drops --send (mos-1246 items 2 and 3).
2026-10-21 19:42:01 -05:00

2.7 KiB

Federation build row R3, the broker user principal (#414)

Sage, 2026-10-22. The design is Gizmoduck's agents/gizmoduck/work/federation/DESIGN.md at b93f098f0 on gizmoduck/federation-design (r4.11, sha256 1bcee8df0a3a8628a6646535b756c936ca6d9e7bcfa7e1dd2bf1d3f01715c8e6). Sections 3.5, 3.6 and 7 set R3's scope and test gate. Vikunja P19 #414. R3's parents, R1 (row 201) and row 196, have landed. I owed this filing when they did and missed it (morgana-0063). Row 205 (193b1a) and 193b1b wait on it.

Brief: FED R3, the broker user principal

Owner Morgana, after 193b1a's candidate goes to review. Reviewer Dewey (section 7: Filbert or Dewey). Gate owner Sage. Base: 193b1a's candidate (row 205), so R3 extends that row's trail and replies filter to user sessions instead of re-cutting it. If 193b1a changes in review, R3 rebases onto a new branch name.

What to build, in packages/bus/src/ (broker.mjs and a new user-cli.mjs) plus packages/harness/src/runner.mjs for the header line:

  1. The user proof: a path-bound packages/bus/src/user-cli.mjs with its own nonce variable (MOSAIC_BUS_USER_NONCE), checked with the user kind of row 196's verifyPrincipal (section 3.6 checks 1-3). R3 consumes that kind. It doesn't re-implement the parent walk.
  2. bindUser({ business, user }) and the broker changes 1-7 in section 3.6, including the reply path (B6), #userThread, user-thread-human, #waiting returning null for to: 'user', and the runner header line for from_role user, word for word.
  3. The collaborator verb list from section 3.5, exact, with its filters. Every other verb fails access-refused before its own checks. The grant is read per request through R1's loader and covers with level: 'collaborator'.
  4. The section 3.6 item 5 audit: every s.human and s.tester branch in broker.mjs, listed in the packet as user refused, user treated as human, or not reachable for a user.
  5. No revocation timer, access.reload or launcher change. Those are R4. No Console change. That is R6.

Tests, in packages/bus/tests/ and the runner's tests: the R3 test gate in section 7, item by item. Mutants: the five in section 7's R3 row, plus one that drops the 193b1a filter for user sessions (a user's trail of a hidden subject differs from an unknown id's). The agent-parent, non-Console-parent and kind-confusion mutants are row 196's and stay there.

Boundaries: no change to ~/.mosaic-dev, ~/.config/mosaic-dev, the live units or any live access.json. Tests use scratch roots. Single test files run freely, and suites need Sage's slot.

Gate: Dewey approves the manifest. The bus and harness suites and every scripts/test-*.sh are green on Sage's gate, and the mutants are killed.