From 9152bb2b14c36a97f44ef98c10912920913ae00d Mon Sep 17 00:00:00 2001 From: Jason Woltje Date: Thu, 13 Aug 2026 10:15:13 -0500 Subject: [PATCH] docs: archive legacy implementation plans --- docs/archive/planning/README.md | 4 +++ .../2026-03-13-gateway-security-hardening.md | 0 .../2026-03-15-agent-platform-architecture.md | 0 .../2026-03-15-wave2-tui-layout-navigation.md | 0 .../2026-05-06-hermes-mosaic-alignment.md | 0 .../2026-05-07-coordination-resilience.md | 0 docs/archive/planning/legacy/README.md | 28 +++++++++++++++++++ .../planning/legacy}/authentik-sso-setup.md | 0 .../planning/legacy}/chroot-sandboxing.md | 0 .../planning/legacy}/gatekeeper-service.md | 0 .../legacy}/gateway-token-recovery.md | 0 .../legacy}/task-queue-unification.md | 0 docs/scratchpads/DOCS-IA-002-catalog-audit.md | 4 ++- 13 files changed, 35 insertions(+), 1 deletion(-) rename docs/{_old_structure/plans => archive/planning/legacy}/2026-03-13-gateway-security-hardening.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/2026-03-15-agent-platform-architecture.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/2026-03-15-wave2-tui-layout-navigation.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/2026-05-06-hermes-mosaic-alignment.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/2026-05-07-coordination-resilience.md (100%) create mode 100644 docs/archive/planning/legacy/README.md rename docs/{_old_structure/plans => archive/planning/legacy}/authentik-sso-setup.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/chroot-sandboxing.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/gatekeeper-service.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/gateway-token-recovery.md (100%) rename docs/{_old_structure/plans => archive/planning/legacy}/task-queue-unification.md (100%) diff --git a/docs/archive/planning/README.md b/docs/archive/planning/README.md index 100d0ef1..15223433 100644 --- a/docs/archive/planning/README.md +++ b/docs/archive/planning/README.md @@ -6,4 +6,8 @@ - [Planning bundle](monorepo-consolidation/README.md) — historical brief, board review, and Forge/MACP/framework-plugin work-package specifications. +## Legacy plans and deferred stubs + +- [Legacy planning index](legacy/README.md) — unreferenced implementation plans, a superseded SSO setup record, and explicitly deferred design stubs. + Use current package source, tests, audience guides, and approved control documents for present behavior and status. diff --git a/docs/_old_structure/plans/2026-03-13-gateway-security-hardening.md b/docs/archive/planning/legacy/2026-03-13-gateway-security-hardening.md similarity index 100% rename from docs/_old_structure/plans/2026-03-13-gateway-security-hardening.md rename to docs/archive/planning/legacy/2026-03-13-gateway-security-hardening.md diff --git a/docs/_old_structure/plans/2026-03-15-agent-platform-architecture.md b/docs/archive/planning/legacy/2026-03-15-agent-platform-architecture.md similarity index 100% rename from docs/_old_structure/plans/2026-03-15-agent-platform-architecture.md rename to docs/archive/planning/legacy/2026-03-15-agent-platform-architecture.md diff --git a/docs/_old_structure/plans/2026-03-15-wave2-tui-layout-navigation.md b/docs/archive/planning/legacy/2026-03-15-wave2-tui-layout-navigation.md similarity index 100% rename from docs/_old_structure/plans/2026-03-15-wave2-tui-layout-navigation.md rename to docs/archive/planning/legacy/2026-03-15-wave2-tui-layout-navigation.md diff --git a/docs/_old_structure/plans/2026-05-06-hermes-mosaic-alignment.md b/docs/archive/planning/legacy/2026-05-06-hermes-mosaic-alignment.md similarity index 100% rename from docs/_old_structure/plans/2026-05-06-hermes-mosaic-alignment.md rename to docs/archive/planning/legacy/2026-05-06-hermes-mosaic-alignment.md diff --git a/docs/_old_structure/plans/2026-05-07-coordination-resilience.md b/docs/archive/planning/legacy/2026-05-07-coordination-resilience.md similarity index 100% rename from docs/_old_structure/plans/2026-05-07-coordination-resilience.md rename to docs/archive/planning/legacy/2026-05-07-coordination-resilience.md diff --git a/docs/archive/planning/legacy/README.md b/docs/archive/planning/legacy/README.md new file mode 100644 index 00000000..56d07d7e --- /dev/null +++ b/docs/archive/planning/legacy/README.md @@ -0,0 +1,28 @@ +# Legacy plans and deferred design stubs + +> **Status:** Historical planning archive. These files preserve prior proposals and implementation approaches; they are not proof of shipped behavior or authority to run commands. + +The records below moved byte-identically from migration quarantine on 2026-08-10. Validate every claim against current source, tests, configuration, and safety policy before reuse. + +## Implementation plans + +- [Gateway security hardening](2026-03-13-gateway-security-hardening.md) +- [Agent platform architecture](2026-03-15-agent-platform-architecture.md) +- [Wave 2 TUI layout and navigation](2026-03-15-wave2-tui-layout-navigation.md) +- [Hermes–Mosaic alignment](2026-05-06-hermes-mosaic-alignment.md) +- [Coordination resilience](2026-05-07-coordination-resilience.md) +- [Gateway token recovery](gateway-token-recovery.md) + +## Setup record + +- [Authentik SSO setup](authentik-sso-setup.md) — superseded for current administration by the canonical [SSO provider guide](../../../ADMIN-GUIDE/security/sso-providers.md). + +## Explicitly deferred stubs + +- [Chroot agent sandboxing](chroot-sandboxing.md) +- [Gatekeeper service](gatekeeper-service.md) +- [Task queue unification](task-queue-unification.md) + +## Exclusions + +The Agent Reflection PRD remains in quarantine because a live MACP test names its intended canonical path. The WebUI/Fleet Claude bridge draft remains authority-gated and coupled to Fleet decisions. Neither was moved in this archival slice. diff --git a/docs/_old_structure/plans/authentik-sso-setup.md b/docs/archive/planning/legacy/authentik-sso-setup.md similarity index 100% rename from docs/_old_structure/plans/authentik-sso-setup.md rename to docs/archive/planning/legacy/authentik-sso-setup.md diff --git a/docs/_old_structure/plans/chroot-sandboxing.md b/docs/archive/planning/legacy/chroot-sandboxing.md similarity index 100% rename from docs/_old_structure/plans/chroot-sandboxing.md rename to docs/archive/planning/legacy/chroot-sandboxing.md diff --git a/docs/_old_structure/plans/gatekeeper-service.md b/docs/archive/planning/legacy/gatekeeper-service.md similarity index 100% rename from docs/_old_structure/plans/gatekeeper-service.md rename to docs/archive/planning/legacy/gatekeeper-service.md diff --git a/docs/_old_structure/plans/gateway-token-recovery.md b/docs/archive/planning/legacy/gateway-token-recovery.md similarity index 100% rename from docs/_old_structure/plans/gateway-token-recovery.md rename to docs/archive/planning/legacy/gateway-token-recovery.md diff --git a/docs/_old_structure/plans/task-queue-unification.md b/docs/archive/planning/legacy/task-queue-unification.md similarity index 100% rename from docs/_old_structure/plans/task-queue-unification.md rename to docs/archive/planning/legacy/task-queue-unification.md diff --git a/docs/scratchpads/DOCS-IA-002-catalog-audit.md b/docs/scratchpads/DOCS-IA-002-catalog-audit.md index b3c88d1d..0a74b0e8 100644 --- a/docs/scratchpads/DOCS-IA-002-catalog-audit.md +++ b/docs/scratchpads/DOCS-IA-002-catalog-audit.md @@ -87,6 +87,7 @@ Shared indexes, navigation, audit records, integration review, and final commits - [x] Complete independent navigation, safety, and stop-condition reviews; remediate every autonomous finding. - [x] Migrate the bounded historical mission archive and repair its two broken sibling links. - [x] Archive the unreferenced five-file monorepo-consolidation planning bundle byte-identically with explicit historical boundaries. +- [x] Archive ten unreferenced legacy plans/deferred stubs byte-identically; retain the live-test-coupled Agent Reflection PRD and authority-gated WebUI/Fleet draft in quarantine. ## Initial findings @@ -109,6 +110,7 @@ Shared indexes, navigation, audit records, integration review, and final commits - The #756 Discord code-review, security-review, and documentation-checklist reports had no source/test consumers and moved byte-identically to their canonical report categories. `docs/reports/README.md` labels their historical evidence boundary. - Independent safety review found that Discord external route strings are not proven to map to UUID conversation rows. Current pages now promise live routing/delivery only, disclose that persistence can fail while dispatch continues, and require pre-enrollment for privileged durable-session controls. - The monorepo-consolidation brief, board review, and three work-package specifications had no live consumers or internal links. They moved byte-identically to `archive/planning/`; current package existence supports historical classification but does not prove every old acceptance criterion. +- Ten additional unreferenced implementation plans, setup records, and deferred stubs moved byte-identically to `archive/planning/legacy/`. `agent-reflection-loop-PRD.md` was excluded because a MACP test names its intended canonical path; the WebUI/Fleet bridge draft was excluded because it remains authority-gated. ## Method @@ -167,4 +169,4 @@ Shared indexes, navigation, audit records, integration review, and final commits | Root test suite | BLOCKED/FAILED SAFELY — Fleet tests require missing `docs/fleet/`; gateway isolation test inherited a daemon DSN and failed authentication before cleanup DML. Not retried. | | Focused final tests | PASS — types 71, Discord 44, web 33, focused gateway 32, and lease-broker/mutator acceptance 57; `DATABASE_URL` unset, no services started | | Historical mission archive | PASS — 11 completed/superseded records moved under `archive/missions/`, indexed, and two broken sibling links repaired | -| Historical planning archive | PASS — five monorepo-consolidation records moved byte-identically under `archive/planning/`; source hashes and zero-consumer scan verified | +| Historical planning archive | PASS — five consolidation records plus ten legacy plans/stubs moved byte-identically under `archive/planning/`; hashes and zero-consumer scans verified |