docs(fleet): v0.3 last-mile roadmap #296

Merged
johnride merged 1 commits from docs/v0-3-roadmap into feat/smoke-test-contract 2026-05-25 12:28:49 +00:00
Owner

Authoritative plan for the last mile before fleet ships to a real
customer. Picks up where v0_2_plan.md left the chapter structure.

Twelve chapters, organized in execution order:

  1. Dashboard role enforcement (security gap, do right now)
  2. Operator restart + aggregator recovery (more critical than smoke)
  3. Application log forwarding companion (dashboard utility)
  4. Agent self-upgrade, NATS-coordinated, systemd-resident
  5. Graceful deployment upgrade (roll-forward only — customer ask)
  6. Init containers in PodmanV0Score
  7. System upgrade, rollback deferred to v0.4
  8. Secrets via Zitadel + OpenBao (blocked on harmony_secret work)
  9. Agent time-drift verification
  10. Phase 1 smoke wiring
  11. CI yaml minimization (longer-term)
  12. NATS callout CI hardening (minimal)

Customer constraints baked in: deployments are roll-forward only
(no auto-rollback on Deployment failure); system rollback half of
the upgrade ADR is deferred to v0.4 (snapshot is created but not
used for revert in v0.3); secrets must go through Zitadel + OpenBao
(no plaintext shortcut).

Includes:

  • feature checklist as a status table (14 items),
  • sequencing table with ordering rationale,
  • per-chapter goal / current state with file:line citations /
    plan / open questions / "done when",
  • out-of-scope table with target version + reason,
  • cross-cutting open questions Q1–Q5.

Format follows the user's "tables over prose" preference: every
multi-item section is either a table or bold-led bullets with
nested supporting detail. Scannable at three depths (30-second
scroll for bold leads, 2-minute read for nested detail, deep read
with code where it matters).

Authoritative plan for the last mile before fleet ships to a real customer. Picks up where v0_2_plan.md left the chapter structure. Twelve chapters, organized in execution order: 1. Dashboard role enforcement (security gap, do right now) 2. Operator restart + aggregator recovery (more critical than smoke) 3. Application log forwarding companion (dashboard utility) 4. Agent self-upgrade, NATS-coordinated, systemd-resident 5. Graceful deployment upgrade (roll-forward only — customer ask) 6. Init containers in PodmanV0Score 7. System upgrade, rollback deferred to v0.4 8. Secrets via Zitadel + OpenBao (blocked on harmony_secret work) 9. Agent time-drift verification 10. Phase 1 smoke wiring 11. CI yaml minimization (longer-term) 12. NATS callout CI hardening (minimal) Customer constraints baked in: deployments are roll-forward only (no auto-rollback on Deployment failure); system rollback half of the upgrade ADR is deferred to v0.4 (snapshot is created but not used for revert in v0.3); secrets must go through Zitadel + OpenBao (no plaintext shortcut). Includes: - feature checklist as a status table (14 items), - sequencing table with ordering rationale, - per-chapter goal / current state with file:line citations / plan / open questions / "done when", - out-of-scope table with target version + reason, - cross-cutting open questions Q1–Q5. Format follows the user's "tables over prose" preference: every multi-item section is either a table or bold-led bullets with nested supporting detail. Scannable at three depths (30-second scroll for bold leads, 2-minute read for nested detail, deep read with code where it matters).
johnride added 1 commit 2026-05-25 12:24:52 +00:00
docs(fleet): v0.3 last-mile roadmap
All checks were successful
Run Check Script / check (pull_request) Successful in 2m25s
9deebab1ff
Authoritative plan for the last mile before fleet ships to a real
customer. Picks up where v0_2_plan.md left the chapter structure.

Twelve chapters, organized in execution order:

  1. Dashboard role enforcement (security gap, do right now)
  2. Operator restart + aggregator recovery (more critical than smoke)
  3. Application log forwarding companion (dashboard utility)
  4. Agent self-upgrade, NATS-coordinated, systemd-resident
  5. Graceful deployment upgrade (roll-forward only — customer ask)
  6. Init containers in PodmanV0Score
  7. System upgrade, rollback deferred to v0.4
  8. Secrets via Zitadel + OpenBao (blocked on harmony_secret work)
  9. Agent time-drift verification
  10. Phase 1 smoke wiring
  11. CI yaml minimization (longer-term)
  12. NATS callout CI hardening (minimal)

Customer constraints baked in: deployments are roll-forward only
(no auto-rollback on Deployment failure); system rollback half of
the upgrade ADR is deferred to v0.4 (snapshot is created but not
used for revert in v0.3); secrets must go through Zitadel + OpenBao
(no plaintext shortcut).

Includes:
  - feature checklist as a status table (14 items),
  - sequencing table with ordering rationale,
  - per-chapter goal / current state with file:line citations /
    plan / open questions / "done when",
  - out-of-scope table with target version + reason,
  - cross-cutting open questions Q1–Q5.

Format follows the user's "tables over prose" preference: every
multi-item section is either a table or bold-led bullets with
nested supporting detail. Scannable at three depths (30-second
scroll for bold leads, 2-minute read for nested detail, deep read
with code where it matters).
johnride merged commit 269ab2fbed into feat/smoke-test-contract 2026-05-25 12:28:49 +00:00
johnride deleted branch docs/v0-3-roadmap 2026-05-25 12:28:50 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: NationTech/harmony#296
No description provided.