{
  "schema": "seam-history-routing/v1",
  "version": 2,
  "updated": "2026-04-26",
  "policy": {
    "source_of_truth": "HISTORY.md",
    "index": "HISTORY_INDEX.md",
    "route_statuses": ["active", "moved", "retired"],
    "mutation_rule": "Routes may be added, moved, retired, or recreated, but old route facts must remain reconstructable through HISTORY.md and this manifest's status/supersedes/moved_to fields.",
    "deletion_rule": "Delete from active use by setting status=retired. Do not remove the only record of a route unless the removal is itself recorded in HISTORY.md and a replacement route preserves lookup continuity."
  },
  "routes": [
    {
      "id": "maintenance",
      "parent": null,
      "status": "active",
      "description": "Operational maintenance records, cleanup, service state, and local environment hygiene.",
      "match_topics": ["verify"],
      "match_refs": [],
      "ledger": "docs/ledgers/maintenance/README.md",
      "introduced": "085",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "maintenance/docker",
      "parent": "maintenance",
      "status": "active",
      "description": "Docker service state, ports, containers, volumes, guarded adapter runs, and cleanup decisions.",
      "match_topics": ["docker", "pgvector", "verify"],
      "match_refs": ["docker", "run_real_adapters_guarded", "pgvector"],
      "ledger": "docs/ledgers/maintenance/docker.md",
      "introduced": "085",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "maintenance/pgvector",
      "parent": "maintenance",
      "status": "active",
      "description": "PgVector runtime state, adapter tests, DSN handling, and service cleanup.",
      "match_topics": ["pgvector", "vector", "doctor", "verify"],
      "match_refs": ["pgvector", "SEAM_PGVECTOR_DSN", "run_real_adapters_guarded"],
      "ledger": "docs/ledgers/maintenance/pgvector.md",
      "introduced": "085",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "protocol",
      "parent": null,
      "status": "active",
      "description": "Cross-agent protocol, temporal continuity, history invariants, and context discipline.",
      "match_topics": ["protocol", "history", "multi-agent"],
      "match_refs": ["AGENTS.md", "CLAUDE.md", "REPO_LEDGER.md"],
      "ledger": "docs/ledgers/protocol/README.md",
      "introduced": "079",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "protocol/context",
      "parent": "protocol",
      "status": "active",
      "description": "Token-budget policy, context packs, snapshots, and anti-bloat routing.",
      "match_topics": ["protocol", "history", "snapshot", "verify"],
      "match_refs": ["build_context_pack", "write_snapshot", "HISTORY_INDEX.md"],
      "ledger": "docs/ledgers/protocol/context.md",
      "introduced": "080",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "protocol/security",
      "parent": "protocol",
      "status": "active",
      "description": "Secret hygiene, provider session links, redaction, deletion, and scan gates.",
      "match_topics": ["protocol", "verify", "history"],
      "match_refs": ["verify_continuity", ".env", "CLAUDE.md", "AGENTS.md"],
      "ledger": "docs/ledgers/protocol/security.md",
      "introduced": "078",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "runtime",
      "parent": null,
      "status": "active",
      "description": "Runtime behavior, CLI/dashboard operation, installers, and platform launchers.",
      "match_topics": ["dashboard", "installer", "command"],
      "match_refs": ["seam_runtime", "seam.py", "installers", "scripts"],
      "ledger": null,
      "introduced": "001",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "runtime/compression",
      "parent": "runtime",
      "status": "active",
      "description": "Readable lossless compression, MIRL machine-language artifacts, SEAM-LX backing payloads, and direct query semantics.",
      "match_topics": ["mirl", "compress", "compile", "lx1", "codec", "retrieval", "search"],
      "match_refs": ["MIRL_V1.md", "lossless.py", "compress-doc", "SEAM-LX", "machine_artifacts"],
      "ledger": "docs/ledgers/runtime/compression.md",
      "introduced": "087",
      "supersedes": "018",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "runtime/dashboard",
      "parent": "runtime",
      "status": "active",
      "description": "Dashboard UI, chat, command routing, model switching, and launcher behavior.",
      "match_topics": ["dashboard", "chat", "command", "tui", "textual"],
      "match_refs": ["seam_runtime/dashboard.py", "scripts/windows/launch_dashboard"],
      "ledger": null,
      "introduced": "003",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "docs/archive-routing",
      "parent": null,
      "status": "active",
      "description": "Active versus archive separation for docs/code and stale-context prevention.",
      "match_topics": ["readme", "ledger", "protocol", "history"],
      "match_refs": ["docs/CODE_LAYOUT.md", "docs/archive", "archive/code", ".rgignore"],
      "ledger": "docs/CODE_LAYOUT.md",
      "introduced": "075",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    },
    {
      "id": "benchmark/publication",
      "parent": null,
      "status": "active",
      "description": "Benchmark archival, publication metadata, reproducibility, and hash requirements.",
      "match_topics": ["benchmark", "bundle", "fixture", "gold-standard"],
      "match_refs": ["store_benchmark", "benchmark_report", "publication_manifest"],
      "ledger": null,
      "introduced": "008",
      "supersedes": "none",
      "moved_to": null,
      "retired_reason": null
    }
  ]
}
