Skip to content

I2692 — The join state is projected to the briefing, the Cockpit, the UI, the handbook, the site and GitHub Pages

Show every surface the same derived state and the same rule, authored once, so that no page restates it by hand and a worker, a person and a visitor read one account of how workers keep together.

BLOCKED wave 1 · p0 · implementation profile · runs alone

Part of development-runtime — The runtime has a development surface.

Blocked. This issue cannot start until I2690 is done. The status is derived from that, not declared.

Objective

Show every surface the same derived state and the same rule, authored once, so that no page restates it by hand and a worker, a person and a visitor read one account of how workers keep together.

Why

The owner, 2026-10-13, after a session worked three hours stale and unannounced in a cluster of nineteen workers: this must never happen again; it must be formalized, derived, inferred, enforced, in .ai, announced, a hard requirement, on GitHub Pages, tested, documented and on the landing page. See ADR 0226.

Current state

Measured on master f0696ec535 on 2026-10-13: docs/MESH.md describes announcing in prose; the landing page and the handbook do not say what keeps a late worker from working alone; no screen shows who is stale or unannounced.

Desired state

The SessionStart briefing opens with the four facts; /ui and the Cockpit show each worker's state on the board; docs/MESH.md, the handbook and the site's description of coordination are generated from the rule and the capability; the landing page answers 'how do the workers not collide' with the evidence chain; the published Pages carry all of it.

Scope

  • apps/majordomus-cli/src/ui/
  • docs/MESH.md
  • site/
  • scripts/generate-site-data

Out of scope

  • Deriving or enforcing the state: I2690 and I2691
  • A new screen framework

Dependencies

Acceptance criteria

  • The briefing's first block names current, attached, announced and useful
  • The board screen marks a worker that is behind or unannounced, linking its session
  • docs/MESH.md and the site page are generated and majordomus generate --check is clean
  • The deployed Pages answer with the same text at the released commit, which pages-live verifies

Validation

  • bin/majordomus plan validate
  • majordomus generate --check
  • scripts/pages current

Evidence required

  • join_state_on_ui
  • join_state_on_pages

Evidence

None recorded. Every token above needs a command or an artifact behind it before this issue can be completed; narrative is refused.

Timeline

started
—
verified
—
completed
—

Those three fields, the evidence above and the state of the dependencies are all the status is made of. There is no status field to disagree with them.

Canonical record: .ai/repo/project/issues/I2692.yaml. Read it back with majordomus plan show I2692.

Searches the titles and descriptions of every page this site publishes.