docs(federation): M2 mission planning — TASKS decomposition + manifest update #483

Merged

jason.woltje merged 2 commits from docs/federation-m2-plan into main 2026-04-22 01:24:02 +00:00

Conversation 0 Commits 2 Files Changed 2

+62 -7

jason.woltje commented 2026-04-22 01:12:48 +00:00

Owner

Copy Link

Copy Source

Summary

FED-M2 mission planning artifacts. No code changes — docs only.

• docs/federation/TASKS.md: Pre-M2 DEPLOY-01..DEPLOY-05 (test-deploy workstream, ~16K) + M2-01..M2-13 (code workstream, ~72K) decomposition. Replaces the prior "M2 deferred to mission planning" placeholder.
• docs/federation/MISSION-MANIFEST.md: M2 marked in-progress, Test Infrastructure block (mos-test-1/-2.woltje.com) added, Next Step section updated with parallel execution plan.

Workstream split

CODE workstream (M2-01..M2-13, ~72K, sequential):

• M2-01 DB migration (federation_grants/peers/audit_log + enums)
• M2-02 Step-CA sidecar
• M2-03 Scope JSON schema + validator
• M2-04 ca.service.ts (OID-bearing certs)
• M2-05 Sealed storage for client_key_pem
• M2-06 grants.service.ts
• M2-07 enrollment.controller.ts
• M2-08 Admin CLI
• M2-09 Integration tests
• M2-10 E2E (peer add)
• M2-11 Independent security review
• M2-12 Docs
• M2-13 Aggregate close + tag fed-v0.2.0-m2

DEPLOY workstream (DEPLOY-01..DEPLOY-05, ~16K, parallel):

• DEPLOY-01 Verify gateway:fed-v0.1.0-m1 image at git.mosaicstack.dev
• DEPLOY-02 deploy/portainer/federated-test.stack.yml
• DEPLOY-03 Deploy mos-test-1 + M1 acceptance
• DEPLOY-04 Deploy mos-test-2 + M1 acceptance
• DEPLOY-05 docs/federation/TEST-INFRA.md

Re-converges at M2-10 (E2E test) once both ready.

Test plan

• CI green
• No code changes — docs only

Refs #461 #482

## Summary FED-M2 mission planning artifacts. No code changes — docs only. - `docs/federation/TASKS.md`: Pre-M2 DEPLOY-01..DEPLOY-05 (test-deploy workstream, ~16K) + M2-01..M2-13 (code workstream, ~72K) decomposition. Replaces the prior "M2 deferred to mission planning" placeholder. - `docs/federation/MISSION-MANIFEST.md`: M2 marked in-progress, Test Infrastructure block (mos-test-1/-2.woltje.com) added, Next Step section updated with parallel execution plan. ## Workstream split **CODE workstream** (M2-01..M2-13, ~72K, sequential): - M2-01 DB migration (federation_grants/peers/audit_log + enums) - M2-02 Step-CA sidecar - M2-03 Scope JSON schema + validator - M2-04 ca.service.ts (OID-bearing certs) - M2-05 Sealed storage for client_key_pem - M2-06 grants.service.ts - M2-07 enrollment.controller.ts - M2-08 Admin CLI - M2-09 Integration tests - M2-10 E2E (peer add) - M2-11 Independent security review - M2-12 Docs - M2-13 Aggregate close + tag fed-v0.2.0-m2 **DEPLOY workstream** (DEPLOY-01..DEPLOY-05, ~16K, parallel): - DEPLOY-01 Verify gateway:fed-v0.1.0-m1 image at git.mosaicstack.dev - DEPLOY-02 deploy/portainer/federated-test.stack.yml - DEPLOY-03 Deploy mos-test-1 + M1 acceptance - DEPLOY-04 Deploy mos-test-2 + M1 acceptance - DEPLOY-05 docs/federation/TEST-INFRA.md Re-converges at M2-10 (E2E test) once both ready. ## Test plan - [ ] CI green - [ ] No code changes — docs only Refs #461 #482

jason.woltje added 2 commits 2026-04-22 01:12:49 +00:00

docs(federation): decompose FED-M2 + add deploy workstream ... 7652388c3a

- TASKS.md: 13 M2 tasks (Step-CA + grant schema + admin CLI) + 5 deploy tasks (mos-test-1/-2 on Portainer/Swarm)
- MISSION-MANIFEST.md: phase=M2 active; test infra table records mos-test-1/-2 as federation E2E hosts
- Refs new tracking issue #482 (deploy workstream); FED-M2 code workstream still tracks #461

Refs #461 #482

docs(federation): fix MISSION-MANIFEST layout and mark M2 in-progress ... 3d001fdb64

- Restore Parent Mission line to mission frontmatter (was split by Test Infrastructure block)
- M2 milestone row: not-started -> in-progress, started 2026-04-21
- Next Step section: replace "begin when greenlit" with active execution plan covering CODE + DEPLOY parallel workstreams

Refs #461 #482

jason.woltje merged commit b985d7bfe2 into main 2026-04-22 01:24:02 +00:00

jason.woltje referenced this issue from a commit 2026-04-22 01:24:03 +00:00

docs(federation): M2 mission planning — TASKS decomposition + manifest update (#483)

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

bug

Defect in framework tooling or delivered code

fleet-enhancement

Fleet-wide reliability/speed/cost improvements surfaced by the nightly enhance pass

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

be-coder-05 be-coder-06 be-coder-07 be-coder-08 coder-mos1 coder-mos2 coder2 coder3 f10-coder jason.woltje (Jason Woltje) merge-gate mos-dt-0 pepper rev-974 (Rev-974 (Mosaic reviewer seat, web1)) rev-security-02 rev0 scooby (Scooby) shaggy velma

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: mosaicstack/stack#483