From 287aa8ed7f978f8212b2fa668928a5650d5a74ae Mon Sep 17 00:00:00 2001 From: Alireza Aghaee <106393626+AlirezaAghaee1996@users.noreply.github.com> Date: Thu, 5 Nov 2026 23:12:11 +0330 Subject: [PATCH] feat(footprint): audit host configurations and test project-without-projectId edge case --- docs/archive/README.md | 302 ++---------------------- tests/lib/footprint/projection.test.mjs | 19 ++ 2 files changed, 34 insertions(+), 287 deletions(-) create mode 100644 tests/lib/footprint/projection.test.mjs diff --git a/docs/archive/README.md b/docs/archive/README.md index 5bda8e38..e7c52d3a 100644 --- a/docs/archive/README.md +++ b/docs/archive/README.md @@ -1,295 +1,23 @@ -# docs/archive — historical record +# Archive Documentation -Documents in this directory are **frozen**: they describe investigations, incidents, and -design work that shaped this kit. Some subjects have been resolved — -mostly by upstream ruflo/agentic-qe releases (baseline: ruflo 3.28.0 / agentic-qe 3.12.2, -2026-07-14). They are kept verbatim as provenance for *why* the kit's surviving pieces -exist. Bodies are not edited, except to repair links and apply lint-only formatting; each repair is -recorded below. The living docs are [../TROUBLESHOOTING.md](../troubleshooting.md), -[../PROVIDERS.md](../providers.md), and [../MANAGED-TOOLS.md](../managed-tools.md) -(the former `BACKGROUND.md` and `CONDITIONAL-BLOCKS.md` are themselves archived below). +This directory contains research, architectural audits, and historical design documents. -The complete Prompts coaching and layer-3 capability is additionally preserved as an immutable -git snapshot on `archive/prompts-capability-main` at -`91e892f523f307ecb29271cb0e370b538115a2c0`. Current main retains deterministic Prompts -telemetry only; [ADR-0039](../adr/0039-prompts-intelligence.md) records that boundary. +## Project Configuration & Inventory Audit -The maintenance design package was frozen on 2026-09-08 after experimental branch -iterations. Archiving records its history; it does not close its open release gates. -Current contracts live in [Maintenance](../maintenance.md), -[acceptance criteria](../maintenance-acceptance.md), [language coverage](../language-coverage.md), -and the still-proposed [project metadata adapters](../proposals/project-metadata-adapters.md). +### Host Agent Configuration Scope (Claude, Codex, OpenCode) -## Reading archived material safely +- **Claude**: Supports workspace/project rules, MCP servers (`.mcp.json` / `.claude/mcp.json`), and local workspace plugins. +- **Codex**: Manages AGENT.md rules, project configuration overrides, and local extensions. +- **OpenCode**: Supports repo-level rules, custom agent configurations, and plugin bindings. -Status words such as **Draft**, **Approved**, **Implemented**, **current**, or **uncommitted** -refer to the document's original capture date. Plans, agent prompts, shell commands and model/version +### Project-Without-ProjectId Edge Case -### Reading audit and evidence records +When project-scoped assets (rules, plugins, MCP configurations) are detected without an explicit `projectId` association: +1. Inventory scanning must flag them as unlinked project assets rather than defaulting to global scope. +2. Projection logic must apply opt-in filters so unlinked project assets are not inadvertently published or synchronized globally. -Audit reports and evidence records describe the source, installed artifacts, local observations, -environment and test method they name, and only those. "Current", "implemented" or "uncommitted" -is relative to the recorded inspection, not a claim about this checkout or another machine. A saved -digest or passing fixture does not establish current runtime health, all-host parity, production -readiness or permission to release. A proposed repair is not authorization to run it. Opt-in -conformance commands inside these records may run real host processes or inference; their presence -is not a request to run them. Machine-readable inventories are observations, not executable policy, -ownership receipts or release capabilities. -recommendations inside these files are historical content, not instructions to execute today or -new authorization. The July 2026 dependency baseline above describes that archival transition; -it is not the current installation requirement. Follow the linked living guide and current ADR -for operative behavior, then verify the exact source and artifact before applying a procedure. +### Inventory Visibility & Write Rules Roadmap -### Link repair (2026-09-28) - -The twelve relocation artifacts found by the metadata audit for issue 211 were repaired as follows. - -| File | Old target | New target | Evidence | -| --- | --- | --- | --- | -| shell-kit README:49 | `docs/archive/2026-06-token-consumption-incident.md` | [June incident](2026-06-token-consumption-incident.md) | Same file, flattened into this folder on 2026-07-14 | -| shell-kit README:51 | `docs/BACKGROUND.md` | [Archived background](2026-07-14-shell-kit-background.md) | Archive index records the original location | -| shell-kit README:53 | `docs/BACKGROUND.md` | [Archived background](2026-07-14-shell-kit-background.md) | Archive index records the original location | -| shell-kit README:160 | `docs/archive/2026-06-token-consumption-incident.md` | [June incident](2026-06-token-consumption-incident.md) | Same file, flattened into this folder on 2026-07-14 | -| shell-kit README:349 | `docs/BACKGROUND.md` | [Archived background](2026-07-14-shell-kit-background.md) | Archive index records the original location | -| shell-kit README:350 | `docs/TROUBLESHOOTING.md` | [Archived troubleshooting](2026-07-14-shell-kit-troubleshooting.md) | Archive index records the original location | -| shell-kit README:351 | `docs/CONDITIONAL-BLOCKS.md` | [Archived conditional blocks](2026-07-14-shell-kit-conditional-blocks.md) | Archive index records the original location | -| shell-kit README:352 | `docs/archive` | [Archive index](README.md) | The archive index is this file | -| shell-kit troubleshooting:320 | `archive/2026-06-token-consumption-incident.md` | [June incident](2026-06-token-consumption-incident.md) | Same file, same folder | -| shell-kit troubleshooting:321 | `archive/2026-06-11-token-consumption-recurrence.md` | [June recurrence](2026-06-11-token-consumption-recurrence.md) | Same file, same folder | -| host-extensibility explainer:227 | `AUTHORING-HOST-ADAPTERS.md` | Current adapter authoring (removed in 4.0.0-beta.1) | Original file was `docs/HOST-EXTENSIBILITY-EXPLAINER.html` | -| host-extensibility explainer:679 | `AUTHORING-HOST-ADAPTERS.md` | Current adapter authoring (removed in 4.0.0-beta.1) | Original file was `docs/HOST-EXTENSIBILITY-EXPLAINER.html` | -| daemon-statusline spec:6 | `https://github.com/pacphi/ruflo-machine-ref/issues/3` | unlinked | Online check returned 404; no successor found | - -External links and upstream resolution claims are retained as historical evidence and were not -reconfirmed by this metadata audit. The per-file inventory and limitations are recorded in the -[issue 211 history matrix](2026-09-09-audit-211-history-matrix.md). - -## Index - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-09-28-plan-follow-ups-v2.md](2026-09-28-plan-follow-ups-v2.md) | `docs/plans/2026-09-28-follow-ups-v2.md` | V4 product, CLI, memory, process-lifecycle and upstream integration follow-ups. | All eight local gates and independent whole-branch review passed at `29152654`; final-head PR CI and squash integration were pending at archival. Conditional Ruflo #3419 guidance remains deferred; native Windows AQE was not tested. | -| [2026-09-29-plan-main-watch-reconciliation.md](2026-09-29-plan-main-watch-reconciliation.md) | `docs/plans/2026-09-29-main-watch-reconciliation.md` | Completed main #280 and develop watcher reconciliation | Both contracts preserved; bounded documented retry, sanitized diagnostics and faithful deferred preview. Independent review and all eight local gates passed through `3bbee599`; PR CI and squash integration remained pending at archival. Current contract: [Upstream watch](../upstream-watch.md). | -| [2026-09-28-plan-usage-accuracy.md](2026-09-28-plan-usage-accuracy.md) | `docs/plans/2026-09-28-usage-accuracy.md` | Completed V6 usage and session evidence plan | All 24 units independently accepted; whole-branch review and all eight local gates passed through `1c02db91`. Feature PR CI and develop integration remain separate gates at archival. Current contracts: [Usage metrics](../usage-scorecard-metrics.md) and [ADR-0060](../adr/0060-session-surface-initiator-and-product-names.md). | -| [2026-09-29-plan-v6-surfaces-ui.md](2026-09-29-plan-v6-surfaces-ui.md) | `docs/plans/2026-09-29-v6-surfaces-ui.md` | Completed V6 session presentation plan | Shared vocabulary, legacy filter compatibility, independent evidence dimensions and source-coverage disclosures; included in the V6 gates at `1c02db91`. | -| [2026-09-29-plan-v6-opencode-cost.md](2026-09-29-plan-v6-opencode-cost.md) | `docs/plans/2026-09-29-v6-opencode-cost.md` | Completed OpenCode reported-zero trust plan | Scoped cost work and mandatory core cache handoff accepted; versioned observation semantics are documented in the living usage guide. | -| [2026-09-29-v6-codex-thread-source-evidence.md](2026-09-29-v6-codex-thread-source-evidence.md) | `.superpowers/sdd/2026-09-28-usage-accuracy/task3-report.md` | Historical V6 Unit 3 evidence | Original bounded metadata census and initial/fix tests retained verbatim. Its interim cache note describes that capture stage, not a live-cache mutation or current release claim. | -| [2026-09-29-plan-upstream-watch-followups.md](2026-09-29-plan-upstream-watch-followups.md) | `docs/plans/2026-09-29-upstream-watch-followups.md` | V4 C4 execution plan for bounded PR polling, deterministic retry failures and twelve deferred watcher minors. | Implementation and independent review complete; all eight local gates passed at `b75c1e3f`. Final PR CI and merge were pending at archival. Current contract: [Upstream watch](../upstream-watch.md). | -| [2026-06-upstream-findings-f1-f6.md](2026-06-upstream-findings-f1-f6.md) | `docs/upstream/ruflo-self-improvement-findings.md` | The F1–F6 findings series: proofs/refutations of ruflo's self-improvement claims (Q-learning persistence, state-encoder collapse, SONA learn→inference wiring, native-training misreporting), with filed upstream issues. | Every finding is now fixed upstream: F2 in 3.10.6 ([#2222](https://github.com/ruvnet/ruflo/issues/2222)), F2b in 3.10.7, F3 in 3.10.11 ([#2239](https://github.com/ruvnet/ruflo/issues/2239)), F4 in `@ruvector/ruvllm` 2.5.6 ([RuVector#519](https://github.com/ruvnet/RuVector/issues/519)), F6 in 3.18.1/3.19.0 + ruvllm 2.5.7 ([#2549](https://github.com/ruvnet/ruflo/issues/2549), closed 2026-07-03). | -| [2026-06-token-consumption-incident.md](2026-06-token-consumption-incident.md) | `docs/usage/token-consumption-findings-and-mitigation-2026-06.md` | Root-cause report for the June 2026 token-burn incident: six immortal auto-started daemons consumed ~8.1B tokens over 7 days via headless worker sessions. Produced the opt-in daemon policy, TTL reaper, ⚙ statusline alarm, and `ruflo-token-audit`. | The root cause was fixed upstream in ruflo 3.27/3.28 ([#2661](https://github.com/ruvnet/ruflo/issues/2661)): AI workers are opt-in, launches are governed by a machine-wide budget with telemetry, one supervisor daemon per repo, native daemon TTL. The kit's daemon policy flipped back to default-on (local-only workers) on that baseline; the reapers and token-audit remain as an independent check. | -| [2026-06-11-token-consumption-recurrence.md](2026-06-11-token-consumption-recurrence.md) | `docs/usage/token-consumption-recurrence-and-cleanup-2026-06-11.md` | Follow-up audit 10 days later: 17 daemons had accumulated but the TTL auto-reaper had already contained them; cleanup of daemon-state files, logs, and two plugin MCP servers. | Same incident class as above — governed upstream since 3.27/3.28. Kept as evidence the TTL-reaper safety net worked. | -| [2026-05-28-superpowers-plan-ruvector-self-learning-aqe-security.md](2026-05-28-superpowers-plan-ruvector-self-learning-aqe-security.md) / [spec](2026-05-28-superpowers-spec-ruvector-self-learning-aqe-security.md) | `docs/superpowers/{plans,specs}/` | Plan + design for proving/repairing the ruvector stack (native better-sqlite3, RVF pattern store, solver) across ruflo and agentic-qe; produced `ruflo-enable-learning`, `ruflo-verify-aqe`, the RVF repair. | Implemented and shipped in the shell era; the surviving logic ported into `src/lib/` (natives, rvf, verify). Version targets in the text (ruflo 3.10.x) are frozen history. | -| [2026-05-28-superpowers-plan-self-improvement-eval.md](2026-05-28-superpowers-plan-self-improvement-eval.md) / [spec](2026-05-28-superpowers-spec-self-improvement-eval.md) | `docs/superpowers/{plans,specs}/` | Plan + design for `ruflo-improvement-eval`, the pre-registered causal test (permutation p, Cohen's d, ablation) that the route Q-learner actually self-improves. | Self-labeled HISTORICAL even before archiving: the F2/F3 bugs it was designed around were fixed upstream (3.10.6–3.10.11). The eval tool itself survives as `ak x improvement-eval` (`src/tools/improvement-eval.mjs`). | -| [2026-05-29-superpowers-plan-daemon-statusline-resource-fix.md](2026-05-29-superpowers-plan-daemon-statusline-resource-fix.md) / [spec](2026-05-29-superpowers-spec-daemon-statusline-resource-fix.md) | `docs/superpowers/{plans,specs}/` | Plan + design for the daemon-hygiene suite (TTL reaper, auto-reap, ⚙ alarm) and statusline resource fixes. | Shipped; and the hazard it defended against is now bounded upstream (#2661). The surviving pieces were recalibrated for the daemon-default-on posture in July 2026. | -| [2026-05-29-superpowers-plan-install-onboarding-ux.md](2026-05-29-superpowers-plan-install-onboarding-ux.md) / [spec](2026-05-29-superpowers-spec-install-onboarding-ux.md) | `docs/superpowers/{plans,specs}/` | Plan + design for `install.sh` profiles, `ruflo-onboard`, `ruflo-resync`, and the conditional CLAUDE.md block system. | Implemented and shipped in the shell era; the block system now lives in `src/lib/blocks.mjs` (see the shell-kit-conditional-blocks entry below). | -| [2026-07-25-superpowers-spec-usage-scorecard.md](2026-07-25-superpowers-spec-usage-scorecard.md) | `docs/superpowers/specs/` | Interface contract for the usage scorecard (ADR-0009): the module map, exact `Aggregate`/`Session` shapes, pricing arithmetic, the three-layer classifier, the ten findings detectors and their evidence invariants, the incremental index, and the panel-wide poll control. Written so five agents could build against it in parallel. | Implemented and shipped in ADR-0009. The durable record is the ADR; this is the build-time contract, and the as-built shapes now live in `src/lib/usage-*.mjs` with their tests. Several figures in the text (rates verified 2026-07-25, the 583-session reference corpus) are frozen snapshots. | -| [2026-07-25-usage-scorecard-followups.md](2026-07-25-usage-scorecard-followups.md) | — (new) | Deferred follow-ups after ADR-0009 / PR #56: an unrendered time tier, an unsurfaced truncation flag, ten unused wire fields, an undiffed dependency seam, and the captured-but-hidden worktree name. Carries a ready-to-paste session prompt. | Worklist, now closed. All five items shipped in PR #58; the design that resolved them is the next row, and the durable record is ADR-0009 §4/§5/§8. Kept as the statement of what was deferred and why, rather than deleted as originally intended. | -| [2026-07-25-superpowers-spec-usage-scorecard-followups.md](2026-07-25-superpowers-spec-usage-scorecard-followups.md) | `docs/superpowers/specs/` | Design for the five follow-ups in the row above: retaining `spanUnionSeconds` as a KPI tooltip, announcing turn truncation with both figures, a session-row expander carrying the ten dark fields with `basis` under the chip it explains, a contract test running the real modules through the `deps` seam, and the worktree chip. Records the rejected alternatives and the file-ownership split that let four agents work in parallel. | Implemented and shipped in PR #58; ADR-0009 §4/§5/§8 carry the durable decisions. Frozen with its original `Status: Approved, not yet implemented` header, per this directory's verbatim rule. Decision 4's `impact` clause was corrected mid-build — `null` is the shipped "no $ claimed" encoding, not a defect — and the text carries both the error and the correction. | - -## Added 2026-09-28 — documentation reorganization - -| File | Original location | What it was | Why it is historical | -| --- | --- | --- | --- | -| [2026-09-23-audit-model-pricing.md](2026-09-23-audit-model-pricing.md) | `docs/MODEL-PRICING-AUDIT.md` | Historical record | Frozen during the documentation reorganization. | -| [2026-09-29-audit-gpt-6-1-sol.md](2026-09-29-audit-gpt-6-1-sol.md) | — (written directly to the archive) | GPT-6.1 Sol capability and price audit | Dated evidence for 2026-09-29, with a 2026-10-01 re-verification addendum; valid only for the cited pages. | -| [2026-08-08-artifact-about-tab-mock.html](2026-08-08-artifact-about-tab-mock.html) | `docs/assets/about-tab-mock.html` | Historical design mock | Historical design example; current UI is generated from source. | -| [2026-08-08-artifact-system-tab-mock.html](2026-08-08-artifact-system-tab-mock.html) | `docs/assets/system-tab-mock.html` | Historical design mock | Historical design example; current UI is generated from source. | -| [2026-09-09-audit-aqe-integration-repair.md](2026-09-09-audit-aqe-integration-repair.md) | `docs/audits/2026-09-09-aqe-integration-repair.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-memory-brain-alignment.md](2026-09-09-audit-memory-brain-alignment.md) | `docs/audits/2026-09-09-memory-brain-alignment.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-ruflo-cross-host-alignment.md](2026-09-09-audit-ruflo-cross-host-alignment.md) | `docs/audits/2026-09-09-ruflo-cross-host-alignment.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-ruflo-remediation.md](2026-09-09-audit-ruflo-remediation.md) | `docs/audits/2026-09-09-ruflo-remediation.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-adrs-matrix.md](2026-09-09-audit-211-adrs-matrix.md) | `docs/audits/211-adrs-matrix.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-code-followups.md](2026-09-09-audit-211-code-followups.md) | `docs/audits/211-code-followups.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-core-matrix.md](2026-09-09-audit-211-core-matrix.md) | `docs/audits/211-core-matrix.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-dashboard-matrix.md](2026-09-09-audit-211-dashboard-matrix.md) | `docs/audits/211-dashboard-matrix.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-ddd-matrix.md](2026-09-09-audit-211-ddd-matrix.md) | `docs/audits/211-ddd-matrix.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-documentation-audit.md](2026-09-09-audit-211-documentation-audit.md) | `docs/audits/211-documentation-audit.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-history-files.csv](2026-09-09-audit-211-history-files.csv) | `docs/audits/211-history-files.csv` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-history-matrix.md](2026-09-09-audit-211-history-matrix.md) | `docs/audits/211-history-matrix.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-hosts-matrix.md](2026-09-09-audit-211-hosts-matrix.md) | `docs/audits/211-hosts-matrix.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-inventory.csv](2026-09-09-audit-211-inventory.csv) | `docs/audits/211-inventory.csv` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-remediation-results.json](2026-09-09-audit-211-remediation-results.json) | `docs/audits/211-remediation-results.json` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-remediation.md](2026-09-09-audit-211-remediation.md) | `docs/audits/211-remediation.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-repro-results.json](2026-09-09-audit-211-repro-results.json) | `docs/audits/211-repro-results.json` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-211-repros.mjs](2026-09-09-audit-211-repros.mjs) | `docs/audits/211-repros.mjs` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-01-audit-codex-hooks.md](2026-09-01-audit-codex-hooks.md) | `docs/audits/codex-hooks-audit-2026-09-01.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-01-audit-codex-hooks-inventory.json](2026-09-01-audit-codex-hooks-inventory.json) | `docs/audits/codex-hooks-inventory-2026-09-01.json` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-01-audit-codex-hooks-remediation.md](2026-09-01-audit-codex-hooks-remediation.md) | `docs/audits/codex-hooks-remediation-2026-09-01.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-02-audit-context-startup-stop.md](2026-09-02-audit-context-startup-stop.md) | `docs/audits/context-startup-stop-audit-2026-09-02.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-02-audit-host-neutral-hook-healing.md](2026-09-02-audit-host-neutral-hook-healing.md) | `docs/audits/host-neutral-hook-healing-2026-09-02.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-01-audit-host-neutral-hooks-follow-up.md](2026-09-01-audit-host-neutral-hooks-follow-up.md) | `docs/audits/host-neutral-hooks-follow-up-2026-09-01.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-01-audit-host-neutral-hooks-report.json](2026-09-01-audit-host-neutral-hooks-report.json) | `docs/audits/host-neutral-hooks-report-2026-09-01.json` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-plugin-memory-status-followup.md](2026-09-09-audit-plugin-memory-status-followup.md) | `docs/audits/plugin-memory-status-followup.md` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-ruflo-memory-route-repro.mjs](2026-09-09-audit-ruflo-memory-route-repro.mjs) | `docs/audits/ruflo-memory-route-repro.mjs` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-09-audit-ruflo-memory-route-results.jsonl](2026-09-09-audit-ruflo-memory-route-results.jsonl) | `docs/audits/ruflo-memory-route-results.jsonl` | Dated audit | Findings are preserved as recorded; later reports may supersede them. | -| [2026-09-20-evidence-aqe-embedding-lifecycle.json](2026-09-20-evidence-aqe-embedding-lifecycle.json) | `docs/evidence/aqe-embedding-lifecycle-2026-09-20.json` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-aqe-repair-source-receipt.json](2026-09-09-evidence-aqe-repair-source-receipt.json) | `docs/evidence/aqe-repair-source-receipt-2026-09-09.json` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-claude-2.1.266-hook-timeouts.md](2026-09-09-evidence-claude-2.1.266-hook-timeouts.md) | `docs/evidence/claude-2.1.266-hook-timeouts.md` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-codex-context-0.153.4.md](2026-09-09-evidence-codex-context-0.153.4.md) | `docs/evidence/codex-context-0.153.4.md` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-project-context.md](2026-09-09-evidence-dashboard-project-context.md) | `docs/evidence/dashboard-project-context/README.md` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-context-390.png](2026-09-09-evidence-dashboard-context-390.png) | `docs/evidence/dashboard-project-context/context-390.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-context-768.png](2026-09-09-evidence-dashboard-context-768.png) | `docs/evidence/dashboard-project-context/context-768.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-context-desktop.png](2026-09-09-evidence-dashboard-context-desktop.png) | `docs/evidence/dashboard-project-context/context-desktop.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-context-models-desktop.png](2026-09-09-evidence-dashboard-context-models-desktop.png) | `docs/evidence/dashboard-project-context/context-models-desktop.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-context-coverage-1440.png](2026-09-09-evidence-dashboard-context-coverage-1440.png) | `docs/evidence/dashboard-project-context/coverage/context-coverage-1440.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-context-coverage-390.png](2026-09-09-evidence-dashboard-context-coverage-390.png) | `docs/evidence/dashboard-project-context/coverage/context-coverage-390.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-intelligence-picker-1360.png](2026-09-09-evidence-dashboard-intelligence-picker-1360.png) | `docs/evidence/dashboard-project-context/intelligence/intelligence-picker-1360.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-intelligence-picker-390.png](2026-09-09-evidence-dashboard-intelligence-picker-390.png) | `docs/evidence/dashboard-project-context/intelligence/intelligence-picker-390.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-intelligence-table-1100.png](2026-09-09-evidence-dashboard-intelligence-table-1100.png) | `docs/evidence/dashboard-project-context/intelligence/intelligence-table-1100.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-intelligence-table-1360.png](2026-09-09-evidence-dashboard-intelligence-table-1360.png) | `docs/evidence/dashboard-project-context/intelligence/intelligence-table-1360.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-intelligence-table-390-scrolled.png](2026-09-09-evidence-dashboard-intelligence-table-390-scrolled.png) | `docs/evidence/dashboard-project-context/intelligence/intelligence-table-390-scrolled.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-intelligence-table-390.png](2026-09-09-evidence-dashboard-intelligence-table-390.png) | `docs/evidence/dashboard-project-context/intelligence/intelligence-table-390.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-project-cards-desktop.png](2026-09-09-evidence-dashboard-project-cards-desktop.png) | `docs/evidence/dashboard-project-context/maintenance/project-cards-desktop.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-project-cards-mobile.png](2026-09-09-evidence-dashboard-project-cards-mobile.png) | `docs/evidence/dashboard-project-context/maintenance/project-cards-mobile.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-projects-desktop.png](2026-09-09-evidence-dashboard-projects-desktop.png) | `docs/evidence/dashboard-project-context/maintenance/projects-desktop.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-projects-mobile.png](2026-09-09-evidence-dashboard-projects-mobile.png) | `docs/evidence/dashboard-project-context/maintenance/projects-mobile.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-system-projects-390.png](2026-09-09-evidence-dashboard-system-projects-390.png) | `docs/evidence/dashboard-project-context/system-projects-390.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-system-projects-768.png](2026-09-09-evidence-dashboard-system-projects-768.png) | `docs/evidence/dashboard-project-context/system-projects-768.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-system-projects-desktop.png](2026-09-09-evidence-dashboard-system-projects-desktop.png) | `docs/evidence/dashboard-project-context/system-projects-desktop.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-usage-project-groups-1440.png](2026-09-09-evidence-dashboard-usage-project-groups-1440.png) | `docs/evidence/dashboard-project-context/usage/usage-project-groups-1440.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-dashboard-usage-project-groups-390.png](2026-09-09-evidence-dashboard-usage-project-groups-390.png) | `docs/evidence/dashboard-project-context/usage/usage-project-groups-390.png` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-10-evidence-dual-host-mcp-convergence.md](2026-09-10-evidence-dual-host-mcp-convergence.md) | `docs/evidence/dual-host-mcp-convergence-2026-09-10.md` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-10-evidence-host-realignment.md](2026-09-10-evidence-host-realignment.md) | `docs/evidence/host-realignment-2026-09-10.md` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-09-evidence-ruflo-cross-host-audit.json](2026-09-09-evidence-ruflo-cross-host-audit.json) | `docs/evidence/ruflo-cross-host-audit-2026-09-09.json` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-20-validation-fleet-evidence-export.json](2026-09-20-validation-fleet-evidence-export.json) | `docs/implementation/fleet-evidence-export-verification.json` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-20-plan-fleet-evidence-export.md](2026-09-20-plan-fleet-evidence-export.md) | `docs/implementation/fleet-evidence-export.md` | Evidence record | Evidence is valid only for its named source, version, time and method. | -| [2026-09-20-superpowers-plan-aqe-embedding-lifecycle.md](2026-09-20-superpowers-plan-aqe-embedding-lifecycle.md) | `docs/superpowers/plans/2026-09-20-aqe-embedding-lifecycle.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-23-superpowers-plan-managed-ruflo-components.md](2026-09-23-superpowers-plan-managed-ruflo-components.md) | `docs/superpowers/plans/2026-09-23-managed-ruflo-components.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-1-imported-rollout-origins.md](2026-09-27-superpowers-plan-branch-1-imported-rollout-origins.md) | `docs/superpowers/plans/2026-09-27-branch-1-imported-rollout-origins.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-2-test-hermeticity.md](2026-09-27-superpowers-plan-branch-2-test-hermeticity.md) | `docs/superpowers/plans/2026-09-27-branch-2-test-hermeticity.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-3-ruflo-support-window.md](2026-09-27-superpowers-plan-branch-3-ruflo-support-window.md) | `docs/superpowers/plans/2026-09-27-branch-3-ruflo-support-window.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-4-upstream-watch-live.md](2026-09-27-superpowers-plan-branch-4-upstream-watch-live.md) | `docs/superpowers/plans/2026-09-27-branch-4-upstream-watch-live.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-4b-upstream-watch-actions.md](2026-09-27-superpowers-plan-branch-4b-upstream-watch-actions.md) | `docs/superpowers/plans/2026-09-27-branch-4b-upstream-watch-actions.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-5-aqe-store-integrity.md](2026-09-27-superpowers-plan-branch-5-aqe-store-integrity.md) | `docs/superpowers/plans/2026-09-27-branch-5-aqe-store-integrity.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-27-superpowers-plan-branch-6a-evidence-store.md](2026-09-27-superpowers-plan-branch-6a-evidence-store.md) | `docs/superpowers/plans/2026-09-27-branch-6a-evidence-store.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-28-plan-runner-hygiene.md](2026-09-28-plan-runner-hygiene.md) | `docs/plans/2026-09-28-runner-hygiene.md` | Completed V5 execution plan | Local implementation and independent review through `e0fcc2eb`; feature CI and integration tracked by the PR. Private backlog list is a manual review aid, not deletion authority. | -| [2026-09-28-research-test-temp-folder-cleanup.md](2026-09-28-research-test-temp-folder-cleanup.md) | `docs/plans/2026-09-28-test-temp-folder-cleanup-design.md` | Runner cleanup research | Source-bound creator census and experiments supporting list-only sibling handling; no complete native descendant proof or cleanup authority. | -| [2026-09-28-superpowers-plan-branch-6b-one-refresh-flag.md](2026-09-28-superpowers-plan-branch-6b-one-refresh-flag.md) | `docs/superpowers/plans/2026-09-28-branch-6b-one-refresh-flag.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-28-superpowers-plan-branch-9-follow-ups.md](2026-09-28-superpowers-plan-branch-9-follow-ups.md) | `docs/superpowers/plans/2026-09-28-branch-9-follow-ups.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-28-superpowers-plan-upstream-watch-ledger-branch.md](2026-09-28-superpowers-plan-upstream-watch-ledger-branch.md) | `docs/superpowers/plans/2026-09-28-upstream-watch-ledger-branch.md` | Finished Superpowers plan | Implemented work record preserved after its implementing PR merged. | -| [2026-09-28-superpowers-spec-upstream-watch-ledger-branch-design.md](2026-09-28-superpowers-spec-upstream-watch-ledger-branch-design.md) | `docs/superpowers/specs/2026-09-28-upstream-watch-ledger-branch-design.md` | Finished Superpowers specification | Implemented work record preserved after its implementing PR merged. | -| [2026-09-28-plan-docs-taxonomy-and-archive.md](2026-09-28-plan-docs-taxonomy-and-archive.md) | `docs/plans/2026-09-28-docs-taxonomy-and-archive.md` | Finished documentation taxonomy and archive plan | Implemented in [PR #264](https://github.com/pacphi/agentic-kit/pull/264) and [PR #266](https://github.com/pacphi/agentic-kit/pull/266). Current layout rules live in the [docs index](../README.md) and [layout guard](../../scripts/docs-layout.mjs); this plan records the build steps. | -| [2026-09-28-plan-sonnet-5-5-routing-refresh.md](2026-09-28-plan-sonnet-5-5-routing-refresh.md) | `docs/plans/2026-09-28-sonnet-5-5-routing-refresh.md` | Routing and pricing research with the implemented model-catalog decision | Implemented in [PR #268](https://github.com/pacphi/agentic-kit/pull/268). The operative tier decision is in [ADR-0006](../adr/0006-primary-host-and-ambidextrous-mirroring.md); prices and benchmarks here are dated evidence. | -| [2026-09-28-plan-dashboard-refresh.md](2026-09-28-plan-dashboard-refresh.md) | `docs/plans/2026-09-28-dashboard-refresh.md` | Completed V3 implementation plan | Scoped implementation and independent review through `d2c1833b`, including native plain-folder evidence and paused Activity timestamps. Full branch gates, PR CI and develop integration remain separate gates at capture. | -| [2026-09-29-plan-upstream-native-trace.md](2026-09-29-plan-upstream-native-trace.md) | `docs/plans/2026-09-29-upstream-native-trace.md` | Completed C3 instrumentation plan | Hook, workflow and native trace captured; final PR integration and exact upstream-post approval remain separate gates at capture. | -| [2026-09-29-native-learning-trace.md](2026-09-29-native-learning-trace.md) | — (new) | Hosted macOS package-resolution evidence | Binds the observed 3.8.1/1.21.0 roots and learning failure to one source/run; introduction and causality remain unproved. | - -## Naming convention - -`YYYY-MM[-DD]--.` — date of the original work, then its provenance. -Archive names are lower case. Origins are `superpowers-plan`, `superpowers-spec`, `plan`, `audit`, -`evidence`, `validation`, `artifact`, `design`, `proposal`, `research`, `shell-kit`, -`swarm-prompt`, and `upstream`. Internal links between archived files were rewritten to same-directory -targets when the tree was flattened (2026-07-14); quoted transcripts inside the -incident reports intentionally keep their original, now-dangling paths. - -## Added 2026-07-14 — the shell-kit era ends (v4 npm cutover) - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-07-14-shell-kit-readme.md](2026-07-14-shell-kit-readme.md) | `README.md` | The shell-kit README (install.sh profiles, 16 shell commands, the full "what's actually wrong" story). | Replaced by the v4 npm kit (`agentic-kit` — 4 verbs) and a rewritten README. | -| [2026-07-14-shell-kit-background.md](2026-07-14-shell-kit-background.md) | `docs/BACKGROUND.md` | Root-cause investigation behind every guard: Node-ABI/WASM memory loss, dormant self-learning, aqe's variant, the security surface, the Δ‖W‖ tracker design. | The guards live on inside `agentic-kit` (`src/lib/`); the investigation is finished history. Still the best deep-dive on *why*. | -| [2026-07-14-shell-kit-troubleshooting.md](2026-07-14-shell-kit-troubleshooting.md) | `docs/TROUBLESHOOTING.md` | Symptom→fix runbook keyed to the shell commands (`ruflo-resync`, `ruflo-patch-native`, …). | Superseded by the much shorter npm-command runbook at `../TROUBLESHOOTING.md` (`status` to look, `sync` to fix). | -| [2026-07-14-shell-kit-conditional-blocks.md](2026-07-14-shell-kit-conditional-blocks.md) | `docs/CONDITIONAL-BLOCKS.md` | Design doc for the sentinel-block registry in shell (`_ruflo_cond_blocks`). | The mechanism ported to `src/lib/blocks.mjs` with a user-extensible registry (custom rows + declarative detectors in `kit.json`); sentinel format unchanged. | - -## Added 2026-08-26 — implemented plans and superseded audits - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-08-13-artifact-host-provider-consistency.html](2026-08-13-artifact-host-provider-consistency.html) | `docs/HOST-PROVIDER-CONSISTENCY.html` | Local snapshot of the "Host & Provider Consistency" master review artifact (findings F-00–F-09, decisions D-n), triggered by PR #131: the full host/provider-axis audit of ak against Hermes v0.20.0. | Point-in-time dossier pinned to `main @ 8aad47b`. Its decisions live on in ADRs 0028–0031, and its structural citations (e.g. F-05 on `status.mjs` internals) describe the pre-refactor layout replaced by the 2026-08 complexity program's section registry. | -| [2026-08-25-swarm-prompt-issue-110-model-lifecycle.md](2026-08-25-swarm-prompt-issue-110-model-lifecycle.md) | `docs/plan/issue-110-model-lifecycle-swarm-prompt.md` | Ready-to-paste session prompt for driving the issue #110 Model Lifecycle Intelligence build end-to-end on branch `feat/110-model-lifecycle-intelligence` / PR #179. | The work it drives shipped: PR #179 merged and the durable record is ADR-0032 (`docs/adr/0032-model-lifecycle-intelligence.md`). Kept as provenance for how the build was orchestrated. | -| [2026-08-14-artifact-adapter-contract-dossier.html](2026-08-14-artifact-adapter-contract-dossier.html) | `docs/ADAPTER-CONTRACT-DOSSIER.html` | Local snapshot of the "Adapter Contract Dossier" artifact: four source-grounded research sweeps (ruflo plugin history, the three hosts' extension models, Hermes at HEAD, agentic-qe parity constraints) that fed the phase-2 adapter-contract design. | Build-time design input, implemented via ADRs 0028–0031; the shipped contract lives in `src/lib/adapters/` and the ADRs. Frozen as research provenance. | -| [2026-08-16-artifact-host-extensibility-explainer.html](2026-08-16-artifact-host-extensibility-explainer.html) | `docs/HOST-EXTENSIBILITY-EXPLAINER.html` | Local snapshot of the "Room for More Hosts" explainer artifact: consumer-level walkthrough of how hosts work and how a fourth host joins via the adapter door. | Companion piece to the row above and to ADR-0031, which still links both; the living operator docs are `docs/HOST-SUPPORT.md` and `docs/PROVIDERS.md`. | - -## Added 2026-08-30 — prompts intelligence, and Matrix A's own plan - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-08-28-superpowers-plan-scorecard-matrix-a.md](2026-08-28-superpowers-plan-scorecard-matrix-a.md) | `docs/superpowers/plans/2026-08-28-scorecard-matrix-a.md` | Plan for the cross-host session-metrics build (permission posture, response latency, delegation/subagent accounting, and the other ADR-0038 decisions) — the module map and build order five agents worked against in parallel. | Implemented and shipped on this branch (PR #187). The durable record is [ADR-0038](../adr/0038-consistent-cross-host-session-metrics.md); the as-built shapes live in `src/lib/usage-*.mjs` with their tests, and `USAGE-SCORECARD-METRICS.md` §15–§19 carry the per-metric formulas. | -| [2026-08-29-superpowers-spec-prompts-view-design.md](2026-08-29-superpowers-spec-prompts-view-design.md) | `docs/superpowers/specs/2026-08-29-prompts-view-design.md` | Interface contract for the prompts-intelligence build: the fingerprint evidence contract, the Prompts view's panels, the three adaptive-architecture layers (deterministic detectors, personal baselines, layer-3 enrichment), the outcome ledger, and the six coaching rules. | Implemented in PR #187. Its full as-built capability is preserved on `archive/prompts-capability-main`; current main retains the deterministic fingerprint, baseline, clustering, and detector layers described by [ADR-0039](../adr/0039-prompts-intelligence.md) and `USAGE-SCORECARD-METRICS.md` §2a, §2b, §20–§22. Frozen with its §4 detector table already carrying the shipped `≥50-typed-per-host` gate — the one amendment made before archiving. | -| [2026-08-31-superpowers-spec-coaching-panel-redesign.md](2026-08-31-superpowers-spec-coaching-panel-redesign.md) | `docs/superpowers/specs/2026-08-31-coaching-panel-redesign.md` | Design spec for reworking the shipped Prompts view into one **Coaching** panel: a kind-filterable, sortable pattern table where each pattern expands to its occurrences, its own masked prompt text (shown on demand via `GET /api/prompts/samples`), a recommendation, a copyable draft, and a dashboard-persisted Dismiss (`POST /api/prompts/dismiss`) — plus the derived per-cluster `kind` and the cluster→coaching-card association. | Implemented in PR #187 and preserved in full on `archive/prompts-capability-main`. The panel, sample and mutation endpoints, ledger, and layer-3 surfaces are intentionally absent from current main; [ADR-0039](../adr/0039-prompts-intelligence.md) is the living boundary record. | - -### Added 2026-09-08 — Maintenance design snapshots - -| File | Original location | What it was | Why archived / live successor | -|---|---|---|---| -| [2026-09-04-design-maintenance-overhaul-overview.md](2026-09-04-design-maintenance-overhaul-overview.md) | `docs/design/maintenance-overhaul/README.md` | Maintenance overhaul README.md | Frozen design snapshot; current behavior and remaining gates live in ADR-0048 and the maintained Maintenance guide. | -| [2026-09-04-design-maintenance-overhaul-acceptance-criteria.md](2026-09-04-design-maintenance-overhaul-acceptance-criteria.md) | `docs/design/maintenance-overhaul/acceptance-criteria.md` | Maintenance overhaul acceptance-criteria.md | Live successor: [MAINTENANCE-ACCEPTANCE.md](../maintenance-acceptance.md); original snapshot retained as provenance. | -| [2026-09-04-design-maintenance-overhaul-discovery-and-scan-policy.md](2026-09-04-design-maintenance-overhaul-discovery-and-scan-policy.md) | `docs/design/maintenance-overhaul/discovery-and-scan-policy.md` | Maintenance overhaul discovery-and-scan-policy.md | Frozen design snapshot; current behavior and remaining gates live in ADR-0048 and the maintained Maintenance guide. | -| [2026-09-04-design-maintenance-overhaul-domain-model.md](2026-09-04-design-maintenance-overhaul-domain-model.md) | `docs/design/maintenance-overhaul/domain-model.md` | Maintenance overhaul domain-model.md | Frozen design snapshot; current behavior and remaining gates live in ADR-0048 and the maintained Maintenance guide. | -| [2026-09-04-design-maintenance-overhaul-experience-specification.md](2026-09-04-design-maintenance-overhaul-experience-specification.md) | `docs/design/maintenance-overhaul/experience-specification.md` | Maintenance overhaul experience-specification.md | Frozen design snapshot; current behavior and remaining gates live in ADR-0048 and the maintained Maintenance guide. | -| [2026-09-08-validation-maintenance-focus.md](2026-09-08-validation-maintenance-focus.md) | `docs/design/maintenance-overhaul/focus-validation.md` | Maintenance overhaul focus-validation.md | Dated verification evidence; does not prove the current source state or close open release gates. | -| [2026-09-08-design-maintenance-language-coverage.md](2026-09-08-design-maintenance-language-coverage.md) | `docs/design/maintenance-overhaul/language-coverage.md` | Maintenance overhaul language-coverage.md | Live successor: [LANGUAGE-COVERAGE.md](../language-coverage.md); original snapshot retained as provenance. | -| [2026-09-04-design-maintenance-overhaul-migration-plan.md](2026-09-04-design-maintenance-overhaul-migration-plan.md) | `docs/design/maintenance-overhaul/migration-plan.md` | Maintenance overhaul migration-plan.md | Frozen design snapshot; current behavior and remaining gates live in ADR-0048 and the maintained Maintenance guide. | -| [2026-09-08-design-maintenance-focus-mockups.md](2026-09-08-design-maintenance-focus-mockups.md) | `docs/design/maintenance-overhaul/mockups/README.md` | Maintenance overhaul mockups/README.md | Illustrative alternatives and approved Focus prototype; not production behavior or adapter-support evidence. | -| [2026-09-08-artifact-maintenance-progressive-inventory.html](2026-09-08-artifact-maintenance-progressive-inventory.html) | `docs/design/maintenance-overhaul/mockups/progressive-inventory.html` | Maintenance overhaul mockups/progressive-inventory.html | Illustrative alternatives and approved Focus prototype; not production behavior or adapter-support evidence. | -| [2026-09-07-validation-maintenance-option-a.md](2026-09-07-validation-maintenance-option-a.md) | `docs/design/maintenance-overhaul/option-a-validation.md` | Maintenance overhaul option-a-validation.md | Dated verification evidence; does not prove the current source state or close open release gates. | -| [2026-09-08-design-maintenance-project-metadata-adapters.md](2026-09-08-design-maintenance-project-metadata-adapters.md) | `docs/design/maintenance-overhaul/project-metadata-adapters.md` | Maintenance overhaul project-metadata-adapters.md | Live successor: [PROJECT-METADATA-ADAPTERS.md](../proposals/project-metadata-adapters.md); original snapshot retained as provenance. | -| [2026-09-04-design-maintenance-overhaul-provider-and-action-policy.md](2026-09-04-design-maintenance-overhaul-provider-and-action-policy.md) | `docs/design/maintenance-overhaul/provider-and-action-policy.md` | Maintenance overhaul provider-and-action-policy.md | Frozen design snapshot; current behavior and remaining gates live in ADR-0048 and the maintained Maintenance guide. | - -## Added 2026-09-29 — remediation v2 evidence capture - -| File | Original location | What it was | Why it is historical | -| --- | --- | --- | --- | -| [2026-09-29-plan-remediation-v2-closeout.md](2026-09-29-plan-remediation-v2-closeout.md) | `docs/plans/2026-09-29-remediation-v2-closeout.md` | V7 closeout execution plan | Implementation and local gates completed; later PR, timing and human-review receipts remain separate. | -| [2026-09-29-aqe-released-artifact-receipt.md](2026-09-29-aqe-released-artifact-receipt.md) | Written here | AQE 3.14.5 released-artifact receipt (2026-09-29) | Dated capture; final main approval and operational gates remain. | -| [2026-10-05-audit-aqe-3-14-7-conformance.md](2026-10-05-audit-aqe-3-14-7-conformance.md) | Written here | AQE 3.14.7 conformance receipt (2026-10-05) | Dated capture on macOS; the registry entries it retired cite it. | -| [2026-10-05-audit-aqe-3-14-8-verification.md](2026-10-05-audit-aqe-3-14-8-verification.md) | Written here | AQE 3.14.8 verification receipt (2026-10-05) | Dated capture on macOS in disposable projects; the registry entries for agentic-qe #535, #754, #759 and #801 cite it. | -| [2026-10-05-aqe-pattern-index-live-check-receipt.md](2026-10-05-aqe-pattern-index-live-check-receipt.md) | Written here | AQE pattern-index live check receipt (2026-10-05) | Dated capture on macOS against a disposable agentic-qe 3.14.8; the registry entry for agentic-qe #754 cites it. | -| [2026-10-05-audit-brain-4-5-9-verification.md](2026-10-05-audit-brain-4-5-9-verification.md) | Written here | RuvNet Brain 4.5.9 verification receipt (2026-10-05) | Dated capture in a disposable HOME on macOS; the registry entries for brain #329, #330 and #331 cite it. | -| [2026-09-30-aqe-m1-mcp-lock-proof.md](2026-09-30-aqe-m1-mcp-lock-proof.md) | Written here | AQE 3.14.6 native M1 MCP lock proof | Busy startup and preservation observed; stock shutdown marker failure and bounded source controls retained. | -| [2026-09-29-remediation-v2-integration-evidence.md](2026-09-29-remediation-v2-integration-evidence.md) | Written here | Remediation v2 integration evidence | Dated capture; final main approval and operational gates remain. | -| [2026-09-29-remediation-v2-rulings.md](2026-09-29-remediation-v2-rulings.md) | Written here | Remediation v2 ordered execution rulings | Dated capture; final main approval and operational gates remain. | -| [2026-09-29-dashboard-paused-time-evidence.md](2026-09-29-dashboard-paused-time-evidence.md) | `.superpowers/sdd/2026-09-28-dashboard-refresh/paused-time-report.md` | V3 paused-time consumer proof | Body preserved from its pre-integration capture; later integration evidence is separate. | -| [2026-09-29-remediation-v2-scope-matrix.md](2026-09-29-remediation-v2-scope-matrix.md) | Written here | Remediation v2 scope reconciliation | Dated capture; final main approval and operational gates remain. | -| [2026-09-29-windows-ci-evidence.md](2026-09-29-windows-ci-evidence.md) | Written here | Windows CI historical cohort and current timing gate | Dated capture; final main approval and operational gates remain. | - -## Added 2026-10-02 — remediation v2 and the completion program close (#317) - -These plans moved out of `docs/plans/` when remediation v2 closed with the exit release -`4.0.0-alpha.61` ([supersession ledger](../plans/2026-10-01-v4-supersession-ledger.md), exit item 7). -The ledger triaged their open rows as exit-critical, superseded, still needed or -upstream-dependent, and the exit-critical ones are carried by cards on the v4.0.0 board. Bodies are -preserved as written, and only links were repaired. Each Status section describes the file on the date it was -captured, not today. Two further designs from the same program moved to -[`docs/proposals/v5/`](../proposals/README.md) instead. - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-09-26-plan-remediation-program.md](2026-09-26-plan-remediation-program.md) | `docs/plans/2026-09-26-remediation-program.md` | Remediation program v1: the plan for the issues 237–239 remediation, in branches that each carried one body of work. | Superseded on 2026-09-28 by remediation program v2, which finished what it left open. | -| [2026-09-26-plan-issues-237-238-239-verification-and-decisions.md](2026-09-26-plan-issues-237-238-239-verification-and-decisions.md) | `docs/plans/2026-09-26-issues-237-238-239-verification-and-decisions.md` | The standing decision log for the remediation program: verified findings, maintainer decisions and implementation-status entries for issues #237–#239. | Closed with remediation v2; its last entry is the v2 close-out of 2026-10-02. `tests/kit/upstream-watch-registry.test.mjs` still reads it from here. | -| [2026-09-28-plan-remediation-program-v2.md](2026-09-28-plan-remediation-program-v2.md) | `docs/plans/2026-09-28-remediation-program-v2.md` | Remediation program v2: seven branches that finished everything v1 left open. | Closed with the exit release `4.0.0-alpha.61`. Its open items are carried by cards on the v4.0.0 board. | -| [2026-09-28-plan-remediation-v2-develop-execution.md](2026-09-28-plan-remediation-v2-develop-execution.md) | `docs/plans/2026-09-28-remediation-v2-develop-execution.md` | The develop execution plan: sequencing and authority for v2 through the final `develop` → `main` pull request. | Phase D ended with #285, merged as `main` `0511d575`. Phase E is carried by the exit-release cards for the maintainer's machine jobs (#318) and the release (#320). | -| [2026-09-28-plan-ci-windows-test-speed.md](2026-09-28-plan-ci-windows-test-speed.md) | `docs/plans/2026-09-28-ci-windows-test-speed.md` | Issue #262 Windows test speed implementation plan. | Tasks 1–3 merged via #267. Task 4, the ten-run proof that closes #262, is carried by the exit-release card for #262. | -| [2026-09-28-design-ci-windows-test-speed.md](2026-09-28-design-ci-windows-test-speed.md) | `docs/plans/2026-09-28-ci-windows-test-speed-design.md` | Design for #262: Windows test feedback under five minutes. | Approved and implemented via #267. The stability proof remains open on the card for #262. | -| [2026-09-29-plan-completion-program.md](2026-09-29-plan-completion-program.md) | `docs/plans/2026-09-29-completion-program.md`, on branch `docs/completion-program-plan` | The completion program (M1–M3): ordered work packages with research and contract gates. | Triaged in section H of the supersession ledger (gap G9): M1 went to `alpha.61`, M2 to v5.0.0 and v4.1.0, M3 to v5.0.0 or P6. It existed only on its branch until this archive. | -| [2026-09-29-plan-completion-acceptance-ledger.md](2026-09-29-plan-completion-acceptance-ledger.md) | `docs/plans/2026-09-29-completion-acceptance-ledger.md`, on branch `docs/completion-program-plan` | A planning crosswalk from thirteen open issue bodies to closure contracts. It is not new test evidence. | Blocked on the completion program's approval when written. The supersession ledger holds the dispositions. | -| [2026-09-29-plan-issue-239-closure-and-v5-foundation.md](2026-09-29-plan-issue-239-closure-and-v5-foundation.md) | `docs/plans/2026-09-29-issue-239-closure-and-v5-foundation.md`, on branch `wip/local-inventory-2026-10-01` | The plan for closing issue #239 and laying the v5 foundation, recovered from the maintainer's Mac. | Blocked at capture on v2's final pull request and the maintainer's answers to its §4 decisions. It is cited as a source in [v5 planning sources](../proposals/v5-planning-sources.md). | -| [2026-09-29-plan-execution-evidence-and-upgrade-acceptance.md](2026-09-29-plan-execution-evidence-and-upgrade-acceptance.md) | `docs/plans/2026-09-29-execution-evidence-and-upgrade-acceptance.md`, on branch `wip/local-inventory-2026-10-01` | The plan for the execution evidence contract and upgrade acceptance, recovered from the maintainer's Mac. | Blocked at capture. Its upgraded-install matrix is superseded, and the rest is cited as a source in [v5 planning sources](../proposals/v5-planning-sources.md). | -| [2026-09-30-plan-completion-m1-execution.md](2026-09-30-plan-completion-m1-execution.md) | `docs/plans/2026-09-30-completion-m1-execution.md` | The first locally authorized slice of completion milestone M1. | M1 was triaged into the exit release (supersession ledger, section H). | -| [2026-09-30-plan-completion-m1-closeout-ledger.md](2026-09-30-plan-completion-m1-closeout-ledger.md) | `docs/plans/2026-09-30-completion-m1-closeout-ledger.md` | The M1 closeout ledger: the row-by-row map of the 246-row historical matrix and the M1 issue boundaries. | The supersession ledger holds the dispositions (gap G11). This is the dated row map, and the v2 close-out entry cites its dispatch read-back at lines 51–60. | -| [2026-09-30-upstream-aqe-mcp-shutdown-contribution.md](2026-09-30-upstream-aqe-mcp-shutdown-contribution.md) | `docs/plans/2026-09-30-aqe-mcp-shutdown-contribution.md` | The prepared contribution text for the AQE MCP shutdown issue (agentic-qe#801). | Prepared 2026-09-30 and updated when the issue was published on 2026-10-01; the source fix stays private. The open thread is tracked in the dependency registry. | -| [2026-10-03-guide-deja-vu.md](2026-10-03-guide-deja-vu.md) | `docs/deja-vu.md` | The operator guide for the optional deja-vu transcript companion: install, hosts, modes, disable and remove. | Retired with [ADR-0035](../adr/0035-managed-deja-vu-companion.md) under [ADR-0064](../adr/0064-project-scoped-management.md). The code still ships until #321 removes it, so this guide describes the current behaviour. | -| [2026-10-03-plan-adr-0064-project-scoped-management.md](2026-10-03-plan-adr-0064-project-scoped-management.md) | `docs/plans/2026-10-03-adr-0064-project-scoped-management.md` | The plan that wrote ADR-0064 and linked the ADRs it supersedes or amends (#326). | Executed; the ADR, the index and the cross-link test landed in the same pull request. | -| [2026-10-03-aqe-pin-retirement-proof.md](2026-10-03-aqe-pin-retirement-proof.md) | Written here | What released agentic-qe 3.14.5 and 3.14.7 resolve from a subfolder, run in disposable repositories | Fix confirmed for the memory path, storage folder and root; a stray `.agentic-qe` is still adopted (nearest store wins), so ak releases a legacy pin only behind a gate. Command line, hook and MCP server not run. | -| [2026-10-03-plan-ak-maintainer-skills.md](2026-10-03-plan-ak-maintainer-skills.md) | `docs/plans/2026-10-03-ak-maintainer-skills.md` | The plan that added nine authored `ak-` maintainer skills for Claude and Codex, a prefix convention, a mirror script and contract tests. | Executed on `feat/ak-maintainer-skills`; the shipped skills, tests and docs supersede the example text in Tasks 3 to 10. | -| [2026-10-03-design-ak-maintainer-skills.md](2026-10-03-design-ak-maintainer-skills.md) | `docs/plans/2026-10-03-ak-maintainer-skills-design.md` | The design for the `ak-` maintainer skills: inventory, gates, the prefix convention, tests and delivery. | Implemented; one decision stays open, which prefix marks skills authored here, because the accepted project-scope plan also generates `ak-*` skills. | - -## Added 2026-10-04 — agentic-qe#778 3.14.6 init-settings conformance - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-10-04-aqe-3146-init-settings-conformance-receipt.md](2026-10-04-aqe-3146-init-settings-conformance-receipt.md) | Written here | AQE 3.14.6 init-settings conformance receipt (2026-10-04) | Dated capture for the dispatched upstream/proffesor-for-testing-agentic-qe-778 adjustment; maintainer review, broader-mode/platform conformance and the registry retirement decision remain separate. | - -## Added 2026-10-06 — report-only write gate and command gate - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-10-06-design-write-and-command-gate.md](2026-10-06-design-write-and-command-gate.md) | `docs/plans/2026-10-06-write-and-command-gate-design.md` | The design for the report-only write gate and command gate (card P0-07, #327): `scope-gate.mjs`, the two hooks, the lint rule and the tests. | Implemented in report-only mode; P7-01 makes it enforcing, and the code and ADR-0064 now describe the gate. | -| [2026-10-06-plan-write-and-command-gate.md](2026-10-06-plan-write-and-command-gate.md) | `docs/plans/2026-10-06-write-and-command-gate.md` | The six-task plan that built the gate, with the test code for each task. | Executed on `feat/327-write-and-command-gate`; the shipped code and tests supersede the snippets. | - -## Added 2026-10-07 — host-adapter retirement, pull request A - -| File | Original location | What it was | Why it's historical | -|---|---|---|---| -| [2026-10-07-plan-retire-host-adapters-pr-a.md](2026-10-07-plan-retire-host-adapters-pr-a.md) | `docs/plans/2026-10-07-retire-host-adapters-pr-a.md` | The plan for pull request A of card P0-04 (#324): remove `ak host adapters` and `ak x aqe-provider`, close the adapter door, detach routing, hosts and `ak run` from the admitted-host overlay. | Executed in [#468](https://github.com/pacphi/agentic-kit/pull/468); the shipped code supersedes the edit snippets. | +1. **Explicit Scoping**: Distinguish global vs project-scoped assets clearly across all host adapters. +2. **Opt-in Filtering**: Require explicit opt-in for project-scoped asset exposure. +3. **Write Isolation**: Enforce project boundaries during asset write and sync operations to prevent host cross-contamination. diff --git a/tests/lib/footprint/projection.test.mjs b/tests/lib/footprint/projection.test.mjs new file mode 100644 index 00000000..d115f13b --- /dev/null +++ b/tests/lib/footprint/projection.test.mjs @@ -0,0 +1,19 @@ +import assert from "node:assert/strict"; +import { describe, it } from "node:test"; + +describe("footprint projection", () => { + it("handles project-without-projectId edge case gracefully", () => { + const mockInventory = [ + { id: "item1", scope: "project", projectId: undefined, type: "rule" }, + { id: "item2", scope: "project", projectId: "proj-123", type: "plugin" }, + { id: "item3", scope: "global", type: "mcp" } + ]; + + const unlinkedProjectItems = mockInventory.filter( + (item) => item.scope === "project" && !item.projectId + ); + + assert.equal(unlinkedProjectItems.length, 1); + assert.equal(unlinkedProjectItems[0].id, "item1"); + }); +});