Skip to content

Commit 2fbe708

Browse files
committed
fix: refresh stale competitive docs and align current-truth references to roadmap-status
Constraint: CI use-case-matrix job requires docs to be up to date Tested: refresh_competitive_docs --check, validate_docs_consistency, validate_wiring, sync_acceptance_tiers all pass Confidence: high
1 parent bc91763 commit 2fbe708

6 files changed

Lines changed: 14 additions & 9 deletions

File tree

docs/generated/docs-aging-dashboard.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
55
**Stale threshold:** 90 days since `Last reviewed`
66
**Current-truth docs scanned:** 17
7-
**Needs attention (working tier only):** 4
7+
**Needs attention (working tier only):** 5
88
**Archive-tier docs (exempt from staleness):** 1
99

1010
Regenerate: `python3 scripts/report_docs_aging.py`
@@ -35,6 +35,12 @@ Regenerate: `python3 scripts/report_docs_aging.py`
3535
| --- | --- | --- | --- | --- |
3636
| `docs/INDEX.md` | stale_by_mtime | 2026-06-17 | 2026-06-18 | Missing owner banner; File modified after last reviewed date |
3737

38+
### verification
39+
40+
| Document | Status | Last reviewed | File mtime | Notes |
41+
| --- | --- | --- | --- | --- |
42+
| `docs/acceptance.md` | stale_by_mtime | 2026-06-17 | 2026-06-19 | File modified after last reviewed date |
43+
3844
## Archive Tier (Dated, Immutable Records — Exempt from Staleness Checks)
3945

4046
These docs are dated records and are not expected to be kept current.

docs/generated/docs-inventory.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -234,7 +234,7 @@ Do not edit this file manually — regenerate instead.
234234
| `error-reference.md` | working | 4897 | `4d8a143b3322` |
235235
| `gateway-oauth-tenants.md` | working | 1818 | `0ff9c7df4652` |
236236
| `generated/command-snippet-inventory.md` | working | 8128 | `f11e933dfa4d` |
237-
| `generated/docs-aging-dashboard.md` | working | 3602 | `f95fd149825d` |
237+
| `generated/docs-aging-dashboard.md` | working | 3821 | `e61f46ac99f4` |
238238
| `generated/release-docs-evidence.md` | working | 2121 | `0b9568a4e278` |
239239
| `governance-compliance.md` | constitution | 1645 | `d7665f2f7864` |
240240
| `governance/code-review-checklist.md` | working | 4379 | `f580da208c75` |
@@ -247,10 +247,10 @@ Do not edit this file manually — regenerate instead.
247247
| `governance/daily-driver-review-checklist-2026-06-02.md` | archive | 960 | `107656b04f20` |
248248
| `governance/do-not-claim.md` | working | 5155 | `d1b45294a961` |
249249
| `governance/doc-maintenance-policy-2026-06-02.md` | archive | 2315 | `08509c53c280` |
250-
| `governance/doc-taxonomy-and-ownership.md` | working | 6845 | `ea885921b5df` |
250+
| `governance/doc-taxonomy-and-ownership.md` | working | 6893 | `5374a1b9cf5b` |
251251
| `governance/document-state-model.md` | working | 5707 | `a9ad3ae9a759` |
252252
| `governance/documentation-audit-cadence-2026-06-06.md` | archive | 2238 | `606fa5e32f98` |
253-
| `governance/documentation-operating-model-2026-06-04.md` | archive | 7922 | `55ad1ccc430e` |
253+
| `governance/documentation-operating-model-2026-06-04.md` | archive | 7954 | `e6c44a62392b` |
254254
| `governance/evidence-to-principle-policy.md` | working | 3881 | `5d3c6636ba67` |
255255
| `governance/guarded-claims-registry.md` | working | 4598 | `5dd375f30589` |
256256
| `governance/integration-contracts.md` | working | 2516 | `9c09d10f0160` |
@@ -585,7 +585,7 @@ Do not edit this file manually — regenerate instead.
585585
| `tui-chat-reference.md` | working | 3286 | `c6ad73248894` |
586586
| `tui-daily-driver-guide.md` | working | 3406 | `a5728b08e7d4` |
587587
| `USAGE.md` | working | 39599 | `eba29909cbd2` |
588-
| `use-case-matrix.md` | working | 3807 | `7103bb3d6eee` |
588+
| `use-case-matrix.md` | working | 3791 | `21e3f6951df6` |
589589
| `use-cases.md` | working | 19403 | `5df246528dc8` |
590590
| `ux-stability-contract.md` | working | 2238 | `1c5511e10ede` |
591591
| `wasm-skill-ci.md` | working | 974 | `8340d6f1e5c1` |

docs/governance/doc-taxonomy-and-ownership.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Users and agents should start here:
6161
|------|------------|
6262
| Daily-use truth | `docs/daily-driver-current-status.md` |
6363
| Daily-driver review package | `docs/analysis/daily-driver-review-INDEX-2026-06-01.md` |
64-
| Execution order | `docs/plans/ticket-plans/index.md` |
64+
| Execution order | `docs/roadmap-status.md` (historical closures: `docs/plans/ticket-plans/index.md`) |
6565
| Roadmap status | `docs/roadmap-status.md` |
6666
| Module ownership | `docs/modules/INDEX.md` |
6767
| Governance policy | `docs/governance/doc-maintenance-policy-2026-06-02.md` |

docs/governance/documentation-operating-model-2026-06-04.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ default. Add a supersession note or update an index.
8080
| --- | --- | --- |
8181
| What should users do today? | `docs/daily-driver-current-status.md` | Guides and troubleshooting docs. |
8282
| Which findings are active? | Active findings ledger or successor | Dated review packages. |
83-
| Which work is next? | `docs/plans/ticket-plans/index.md` and active work logs | Master plans. |
83+
| Which work is next? | `docs/roadmap-status.md` | Active work logs; historical closures in `docs/plans/ticket-plans/index.md`. |
8484
| Which roadmap horizon owns the work? | `docs/roadmap-status.md` | Roadmap rationale and work items. |
8585
| Which subsystem owns a local risk? | `docs/modules/<module>/risks.md` | Module index and central risk register. |
8686
| Which safety claim is release-blocking? | Governance release gates and security docs | Threat model, FMEA, risk register. |

docs/use-case-matrix.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Generated from `docs/acceptance.md` by `scripts/build_use_case_matrix.py`.
44

55
Landscape survey reviewed: **2026-06-06** ([../scripts/refresh_agent_readme_survey.md](../scripts/refresh_agent_readme_survey.md)).
6-
Open partial/planned gaps (P1/P2): **3** (see [use-cases.md](use-cases.md#partial--planned-gaps-docs--packaging)).
6+
Open partial/planned gaps (P1/P2): **3** (see [use-cases.md](use-cases.md#partial--planned-gaps)).
77

88
Time-to-first-useful-run: **0.715s** (pip install -e . → teaagent init → teaagent daily --dry-run). Refresh with `python3 scripts/measure_time_to_first_run.py --write docs/ergonomics-kpi.json`.
99

scripts/validate_docs_consistency.py

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1819,7 +1819,6 @@ def _scan_doc_links(
18191819
'docs/tui-daily-driver-guide.md',
18201820
'docs/permission-and-approval-playbook.md',
18211821
'docs/governance/README.md',
1822-
'docs/plans/ticket-plans/index.md',
18231822
'docs/analysis/active-findings-status-ledger-2026-06-06.md',
18241823
)
18251824

0 commit comments

Comments
 (0)