diff --git a/README.md b/README.md index f0e24993..74ade98e 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,6 @@ Start with: - [App Developer Guide](docs/app-developer-guide.md) - [App Manifest Spec](docs/app-manifest-spec.md) - [Nostr Git Source Hosting Plan](docs/nostr-git-source-hosting.md) -- [Operations Runbook](docs/operations-runbook.md) - [Troubleshooting](docs/troubleshooting.md) ## Quick start @@ -94,10 +93,7 @@ python3 scripts/check-app-catalog-drift.py --release --strict | [Nostr Git Source Hosting Plan](docs/nostr-git-source-hosting.md) | ngit/NIP-34 contribution workflow and maintainer model | | [Apps README](apps/README.md) | Packaged app catalog overview | | [Image Recipe](image-recipe/README.md) | Bootable image build flow | -| [Operations Runbook](docs/operations-runbook.md) | Production operations and recovery | -| [Open Source Readiness](docs/OPEN_SOURCE_READINESS.md) | Public-release cleanup checklist | | [Roadmap](docs/ROADMAP.md) | Shipped, in-progress, and planned work | -| [Unified Task Tracker](docs/UNIFIED-TASK-TRACKER.md) | Launch hardening task list | | [Archive](docs/archive/) | Historical plans, audits, and handoffs | ## Contributing diff --git a/docs/1.8.0-RELEASE-HARDENING-PLAN.md b/docs/1.8.0-RELEASE-HARDENING-PLAN.md index 4c2a2c24..2543eeb7 100644 --- a/docs/1.8.0-RELEASE-HARDENING-PLAN.md +++ b/docs/1.8.0-RELEASE-HARDENING-PLAN.md @@ -3,7 +3,6 @@ > **The one living checklist for shipping 1.8.0.** Derived from a full-system deep > audit (2026-07-02): backend security, backend code-quality, frontend, mesh, > tests/release pipeline, and the ISO build. Supersedes nothing — it *sits above* -> `docs/UNIFIED-TASK-TRACKER.md` (day-to-day) as the release exit-criteria list. > **Keep it updated: tick a box the moment an item lands, with the commit sha.** **Definition of done for 1.8.0:** the supply chain is authenticated end-to-end @@ -375,7 +374,7 @@ media (latest artifact only one minor behind). --- -## §I — Carried-over open items (from `UNIFIED-TASK-TRACKER.md`, still valid) +## §I — Carried-over open items (still valid) - [~] 🟠 **Multinode gate pass** — 5× destructive gate was launched on node `.5`; bring the rest of the fleet to precondition, then run the existing (undocumented-but-present) diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index fe202df2..de37a58e 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -1,8 +1,7 @@ # Archipelago Roadmap _Last updated: 2026-07-08. This is the public-facing summary. The live, -priority-ordered engineering list is [`UNIFIED-TASK-TRACKER.md`](UNIFIED-TASK-TRACKER.md); -the narrative plan behind it is [`PRODUCTION-MASTER-PLAN.md`](PRODUCTION-MASTER-PLAN.md)._ +open engineering work is tracked in the public issue tracker._ ## North star diff --git a/docs/architecture.md b/docs/architecture.md index 240b4ef3..06e493f3 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -225,9 +225,6 @@ mesh, steganography, store-and-forward outbox. | [`app-manifest-spec.md`](app-manifest-spec.md) | The `manifest.yml` schema | | [`user-walkthrough.md`](user-walkthrough.md) | End-user installation and usage guide | | [`troubleshooting.md`](troubleshooting.md) | Diagnostic scenarios and solutions | -| [`operations-runbook.md`](operations-runbook.md) | Ops commands and emergency recovery | | [`multi-node-architecture.md`](multi-node-architecture.md) | Federation protocol design | | [`marketplace-protocol.md`](marketplace-protocol.md) | Decentralized app discovery via Nostr | -| [`PRODUCTION-MASTER-PLAN.md`](PRODUCTION-MASTER-PLAN.md) | North star and workstream narrative | -| [`UNIFIED-TASK-TRACKER.md`](UNIFIED-TASK-TRACKER.md) | Live, priority-ordered open items | | [`archive/`](archive/) | Historical audits, session logs, shipped designs | diff --git a/docs/archive/README.md b/docs/archive/README.md index a7d1a75e..0af4703f 100644 --- a/docs/archive/README.md +++ b/docs/archive/README.md @@ -7,15 +7,11 @@ docs whose feature has since shipped. They are kept for provenance and are For current state, start at: -- `docs/UNIFIED-TASK-TRACKER.md` — what's open, priority-ordered -- `docs/PRODUCTION-MASTER-PLAN.md` — north star and workstream narrative - `docs/architecture.md` — as-built system architecture - `docs/ROADMAP.md` — public-facing roadmap | File | What it was | Why archived | |------|-------------|--------------| -| `SESSION-1.8.0-OTA-PROGRESS.md` | Session narrative of the 1.8.0 OTA work | Superseded by the unified task tracker | -| `HANDOVER-2026-07-02-iso-feedback.md` | One-shot handover for the ISO feedback bug-bash | All fixes merged | | `rust-orchestrator-migration.md` | Design for migrating container lifecycle from bash to Rust | Migration complete — `prod_orchestrator.rs` + `boot_reconciler.rs` are the live system | | `demo-deployment-design.md` | Design for the public demo sandbox | Demo shipped; `docs/demo-build-info.md` is the live ops doc | | `app-registry-status-2026-06-21.md` | Per-app migration snapshot from node .228 @ v1.7.99-alpha | Point-in-time snapshot; headline findings (immich legacy, meshtastic present) no longer true | diff --git a/docs/bitcoin-multi-version-design.md b/docs/bitcoin-multi-version-design.md index 3f74ff01..25b38024 100644 --- a/docs/bitcoin-multi-version-design.md +++ b/docs/bitcoin-multi-version-design.md @@ -94,7 +94,7 @@ changes. See also: [`docs/registry-manifest-design.md`](registry-manifest-design.md) (catalog distribution + signing this builds on), -[`docs/PRODUCTION-MASTER-PLAN.md`](PRODUCTION-MASTER-PLAN.md) (gate that must be +the production test gate (which must be green first), `MEMORY → project_decoupled_app_updates`, `MEMORY → project_manifest_driven_north_star`. diff --git a/docs/manifest-hooks-design.md b/docs/manifest-hooks-design.md index 6e0aa17e..262e2889 100644 --- a/docs/manifest-hooks-design.md +++ b/docs/manifest-hooks-design.md @@ -3,7 +3,7 @@ **Status:** implemented through Phase 4 (see §6; updated 2026-07-08) — only declarative `pre_start` remains · originally Task #20 (indeedhub, netbird) off legacy Rust installers. -See `docs/PRODUCTION-MASTER-PLAN.md`, `docs/APP-PACKAGING-MIGRATION-PLAN.md` +See `docs/APP-PACKAGING-MIGRATION-PLAN.md` ("controlled hooks"). --- diff --git a/docs/multinode-testing-plan.md b/docs/multinode-testing-plan.md index bbda64b3..b060b28d 100644 --- a/docs/multinode-testing-plan.md +++ b/docs/multinode-testing-plan.md @@ -1,6 +1,6 @@ # Multinode / Fleet Testing Plan (separate from the single-node gate) -> **Scope split (2026-06-22):** the production test gate (`docs/PRODUCTION-MASTER-PLAN.md` §5, +> **Scope split (2026-06-22):** the production test gate ( > `tests/lifecycle/TESTING.md`) is now a **single-node criterion on .228**. Verifying the same > lifecycle matrix across the rest of the fleet (.198 and the other testers) lives HERE and is run > **after** the .228 single-node gate is green. This is intentionally NOT a blocker on the .228 gate. diff --git a/docs/qr-scanner-snappiness-handover.md b/docs/qr-scanner-snappiness-handover.md index f53cd4a7..6ee554dd 100644 --- a/docs/qr-scanner-snappiness-handover.md +++ b/docs/qr-scanner-snappiness-handover.md @@ -1,7 +1,7 @@ # QR scanner snappiness — research + companion-dev handover *2026-07-29. Owner: web side = node repo (this doc's "web" items); native side = -companion app dev (Mac). Backlog origin: UNIFIED-TASK-TRACKER "optimise +companion app dev (Mac). Backlog origin: "optimise companion QR scan (quicker start/decode, low-light)".* ## Where scanning happens today diff --git a/docs/security/ENTROPY-SEED-AUDIT-2026-07-31.md b/docs/security/ENTROPY-SEED-AUDIT-2026-07-31.md index 41b6e55b..3b97302d 100644 --- a/docs/security/ENTROPY-SEED-AUDIT-2026-07-31.md +++ b/docs/security/ENTROPY-SEED-AUDIT-2026-07-31.md @@ -955,7 +955,7 @@ Everything else in this document is queued in §8, not implemented. Prioritised by severity × effort, most valuable per unit of work first. **Only R-00 was implemented by this audit.** Everything else is queued here and mirrored into -`docs/UNIFIED-TASK-TRACKER.md` so it is not stranded in a document nobody re-reads. +the issue tracker so it is not stranded in a document nobody re-reads. **Effort scale:** S = under an hour; M = half a day; L = a day or more; **PHASE** = needs its own `/gsd-plan-phase`, not an opportunistic edit. diff --git a/docs/security/PHASE-10-VERIFICATION-GUIDE.md b/docs/security/PHASE-10-VERIFICATION-GUIDE.md index a0a8dd09..77147f51 100644 --- a/docs/security/PHASE-10-VERIFICATION-GUIDE.md +++ b/docs/security/PHASE-10-VERIFICATION-GUIDE.md @@ -57,7 +57,7 @@ State these plainly so an auditor is not left inferring them: mitigation targets *future silent rebinding* of the entropy source. - **Findings F-04 through F-12 are out of scope** for this phase and remain open. See `ENTROPY-SEED-AUDIT-2026-07-31.md` remediation register (R-05..R-15) and - `docs/UNIFIED-TASK-TRACKER.md`. + the issue tracker. --- diff --git a/docs/security/PSBT-SIGNING-ARCHITECTURE.md b/docs/security/PSBT-SIGNING-ARCHITECTURE.md index d1b64b84..e087a15a 100644 --- a/docs/security/PSBT-SIGNING-ARCHITECTURE.md +++ b/docs/security/PSBT-SIGNING-ARCHITECTURE.md @@ -23,7 +23,7 @@ > - **§5 (LND) is unaffected and remains accurate**, including **§5.4's honesty table**, which is > correct as written and unchanged. > -> **For the current state, read `docs/security/KEY-03-SIGNING-POSTURE.md`** — it records the +> **Note:** the current signing-posture record is maintained internally. It records the > deletion with its evidence, an honest per-step coverage map of the LND PSBT round trip, and the > verdict on whether an external signer can sign a default node's PSBT today (it cannot: no fleet > node is provisioned watch-only). Phases 2-7 below are unaffected as design targets. diff --git a/reticulum-daemon/README.md b/reticulum-daemon/README.md index 18369877..81918977 100644 --- a/reticulum-daemon/README.md +++ b/reticulum-daemon/README.md @@ -1,7 +1,7 @@ # reticulum-daemon Host-supervised **Reticulum (RNS) + LXMF** bridge for Archipelago's Mesh tab. This is -the Python side of the [Reticulum transport plan](../../.claude/plans/enchanted-strolling-rocket.md): +the Python side of the Reticulum transport work: archipelago spawns one of these per active Reticulum (RNode) radio, it owns the serial port, and the Rust mesh subsystem drives it over a Unix-socket JSON-RPC. diff --git a/tests/lifecycle/TESTING.md b/tests/lifecycle/TESTING.md index 494bdf26..afac9138 100644 --- a/tests/lifecycle/TESTING.md +++ b/tests/lifecycle/TESTING.md @@ -57,7 +57,7 @@ rollout for fedimint-gateway/-clientd, icon/naming fixes) is **done and shipped**: the generated-secrets system is a platform primitive (`container.generated_secrets`, see `docs/app-manifest-spec.md`), the manifests declare it, and the single-node gate went green on .228 on -2026-06-23. Day-to-day open items live in `docs/UNIFIED-TASK-TRACKER.md` — +2026-06-23. Day-to-day open items live in the issue tracker — don't add session logs here. --- @@ -235,7 +235,7 @@ We don't have a performance harness yet. Add as L6 lands: ## Release gates -1.8.0 ships only when ALL of (see `docs/UNIFIED-TASK-TRACKER.md` for the live +1.8.0 ships only when ALL of (see the issue tracker for the live priority-ordered list of what's still open across these): 1. ☑ Bitcoin-stops fix verified live on a fresh node (`tests/lifecycle/bats/bitcoin-knots.bats`