Skip to content

Commit 2fdf403

Browse files
johnteeecursoragent
andcommitted
docs: schedule Sprint 1 work-direction execution after June 10 review
Add execution index with S1–S6 calendar, five P0 ticket plans (WDA-001, WDB-001/003, WDG-001/002), and route docs front door to the truth pass. Constraint: planning artifacts only; no production wiring in this commit Tested: validate_docs_consistency.py --test-quality-mode off; generate_docs_inventory.py Confidence: high Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 85109e4 commit 2fdf403

10 files changed

Lines changed: 364 additions & 6 deletions

docs/INDEX.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@ follow dated evidence documents only when you need the reasoning trail.
1515
| What can a daily user trust today? | [Daily-Driver Current Status](daily-driver-current-status.md) | Current truth; update whenever TUI, chat, agent mode, approval, cost, undo, or resume behavior changes. |
1616
| What is the current documentation-state assessment? | [Documentation State Review](analysis/documentation-state-review-2026-06-04.md) | Current dated evidence for corpus shape, drift risks, and consolidation priorities. |
1717
| What is the documentation operating model? | [Documentation Operating Model](governance/documentation-operating-model-2026-06-04.md) | Governance rulebook for claim types, TTL, owners, supersession, and CI guard targets. |
18-
| What should be done next? | [Documentation Optimization Master Plan](plans/documentation-optimization-master-plan-2026-06-04.md) | Execution plan for reducing drift and improving discoverability. |
18+
| What should be done next? | [Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md) | Sprint 1 truth pass (WDA-001, WDB-001, WDB-003, WDG-001/002) after the June 10 critical review. |
19+
| Documentation corpus optimization | [Documentation Optimization Master Plan](plans/documentation-optimization-master-plan-2026-06-04.md) | Execution plan for reducing drift and improving discoverability. |
1920
| What are the concrete work items? | [Documentation Optimization Work Items](work-log/documentation-optimization-work-items-2026-06-04.md) | Task ledger with priority, status, dependencies, and acceptance criteria. |
2021
| Exhaustive docs inventory (generated) | [Docs Inventory](generated/docs-inventory.md) | Deterministic catalog; not current truth — use this index table first. |
2122
| Documentation aging dashboard (generated) | [Docs Aging Dashboard](generated/docs-aging-dashboard.md) | Current-truth review freshness grouped by owner surface. |
@@ -46,7 +47,8 @@ governance ledgers should prefer the canonical set above.
4647
| Current daily-driver behavior | [Daily-Driver Current Status](daily-driver-current-status.md) |
4748
| Acceptance flow inventory | [Acceptance Coverage](acceptance.md) |
4849
| Roadmap state | [Roadmap Status](roadmap-status.md) |
49-
| Ticket execution order | [Ticket Execution Plans](plans/ticket-plans/index.md) |
50+
| Ticket execution order (daily-driver) | [Ticket Execution Plans](plans/ticket-plans/index.md) |
51+
| Work direction Sprint 1 tickets | [Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md) |
5052
| Module ownership and inspection paths | [Module Documentation Index](modules/INDEX.md) |
5153
| Release gates | [Release Checklist](release-checklist.md) and [Daily-Driver Release Gates](governance/daily-driver-release-gates-2026-06-02.md) |
5254
| Permission and approval behavior | [Permission And Approval Playbook](permission-and-approval-playbook.md) |
@@ -128,6 +130,8 @@ governance ledgers should prefer the canonical set above.
128130

129131
| Plan | Use it for |
130132
| --- | --- |
133+
| **[Work Direction Execution Index](plans/work-direction-execution-index-2026-06-10.md)** | **Current execution order: Sprint 1 truth pass (WDA/WDB/WDG) after June 10 review.** |
134+
| [Work Direction Decomposition](plans/work-direction-decomposition-2026-06-10.md) | Full WD-A … WD-H backlog with acceptance gates. |
131135
| [Documentation Optimization Master Plan](plans/documentation-optimization-master-plan-2026-06-04.md) | Prioritizing documentation work by stability, UX, risk, and ROI. |
132136
| [Documentation Optimization Work Items](work-log/documentation-optimization-work-items-2026-06-04.md) | Concrete task execution ledger. |
133137
| [Daily-Driver Complete Work Plan](plans/daily-driver-complete-work-plan-risk-roi-2026-06-04.md) | Daily-driver risk, feasibility, ROI, and sequence. |

docs/analysis/system-critical-review-2026-06-10-INDEX.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@
2626
| [Competitor Analyses vs Self Consolidation](competitor-analyses-vs-self-consolidation-2026-06-10.md) | 14-document market synthesis vs verified HEAD | Where does TeaAgent actually stand on every axis the corpus measured? |
2727
| [System Review Reasoning Ledger](system-review-reasoning-ledger-2026-06-10.md) | Public reasoning record | What was asked, what answered it, what remains unknown? |
2828
| [Work Direction Decomposition](../plans/work-direction-decomposition-2026-06-10.md) | Execution backlog (WD-A … WD-H) | What should be done next, in what order, with what gates? |
29+
| [Work Direction Execution Index](../plans/work-direction-execution-index-2026-06-10.md) | Sprint calendar + S1 ticket plans | What is scheduled this week, and what is the critical path? |
2930

3031
---
3132

docs/generated/docs-inventory.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
Generated by `python3 scripts/generate_docs_inventory.py`.
77
Do not edit this file manually — regenerate instead.
88

9-
**Markdown files:** 544
9+
**Markdown files:** 550
1010

1111
| Path | Bytes | SHA256 (12) |
1212
| --- | ---: | --- |
@@ -116,7 +116,7 @@ Do not edit this file manually — regenerate instead.
116116
| `analysis/strategic-features-report.md` | 8925 | `8dabee942a0c` |
117117
| `analysis/strategic-plans-consolidation-decision-2026-05-31.md` | 3295 | `c4dff9938507` |
118118
| `analysis/system-critical-review-2026-06-06-INDEX.md` | 11017 | `e4f41f18e748` |
119-
| `analysis/system-critical-review-2026-06-10-INDEX.md` | 6442 | `85915b43387d` |
119+
| `analysis/system-critical-review-2026-06-10-INDEX.md` | 6632 | `07720f4850da` |
120120
| `analysis/system-interrogation-map-2026-06-06.md` | 18982 | `0cf895c27f60` |
121121
| `analysis/system-review-reasoning-ledger-2026-06-06.md` | 13656 | `b6e4fd41125c` |
122122
| `analysis/system-review-reasoning-ledger-2026-06-10.md` | 7827 | `781b5dfb3ccb` |
@@ -258,7 +258,7 @@ Do not edit this file manually — regenerate instead.
258258
| `http-surface-auth.md` | 5135 | `e5299e595353` |
259259
| `implementation/daily-driver-fix-log.md` | 978 | `474648b41793` |
260260
| `implementation/fix-log-2026-06-02.md` | 8520 | `21239812e63e` |
261-
| `INDEX.md` | 18210 | `1c276996aba1` |
261+
| `INDEX.md` | 18888 | `77a51be6dad6` |
262262
| `maturity-matrix.md` | 6953 | `b5616937c67a` |
263263
| `migration-top-level-api.md` | 1505 | `2ba32dedee5a` |
264264
| `model-capability-matrix.md` | 4640 | `a5f83e814136` |
@@ -440,8 +440,14 @@ Do not edit this file manually — regenerate instead.
440440
| `plans/ticket-plans/TICKET-14-plan.md` | 4104 | `6dd7774d409a` |
441441
| `plans/ticket-plans/TICKET-15-plan.md` | 4683 | `4cc75d54172c` |
442442
| `plans/ticket-plans/TICKET-16-plan.md` | 8926 | `897f0b6669f9` |
443+
| `plans/ticket-plans/WDA-001-plan.md` | 2022 | `4f1394a2da60` |
444+
| `plans/ticket-plans/WDB-001-plan.md` | 1731 | `b8ee11c0c869` |
445+
| `plans/ticket-plans/WDB-003-plan.md` | 1825 | `4bc2916ac477` |
446+
| `plans/ticket-plans/WDG-001-plan.md` | 1765 | `155afa58ea63` |
447+
| `plans/ticket-plans/WDG-002-plan.md` | 1727 | `d0e674c9ab1c` |
443448
| `plans/ux-improvement-roadmap-2026-05-31.md` | 15201 | `368416e593d4` |
444-
| `plans/work-direction-decomposition-2026-06-10.md` | 10222 | `a331275802fb` |
449+
| `plans/work-direction-decomposition-2026-06-10.md` | 10371 | `cba4dd33a15d` |
450+
| `plans/work-direction-execution-index-2026-06-10.md` | 4882 | `57f3028f3045` |
445451
| `plugin-skill-catalog.md` | 4118 | `8d42b8f0c492` |
446452
| `processes/breaking-changes.md` | 820 | `2a43f4d37b6c` |
447453
| `processes/community-presence.md` | 5009 | `f33f69b2e8ff` |
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# WDA-001: Label Unwired H4/H5/H6 Modules
2+
3+
**Priority:** P0
4+
**Status:** Scheduled (Sprint 1)
5+
**Sprint:** 2026-06-10 → 2026-06-17
6+
**Primary files:** `teaagent/rbac.py`, `teaagent/policy_engine.py`, `teaagent/policy_routing.py`, `teaagent/consensus_validation.py`, `teaagent/eval_suite.py`, `teaagent/release_gate.py`, `teaagent/scope_creep.py`, `teaagent/prompt_regression.py`, `teaagent/repo_map_benchmark.py`, `teaagent/update/*`, `docs/roadmap-status.md`
7+
8+
## Problem
9+
10+
ENG-R1: ~12k lines of H4/H5/H6 components exist with 291 passing tests but
11+
**no production import path** references them. Roadmap and commit messages
12+
nevertheless imply implementation completeness.
13+
14+
## Scope
15+
16+
1. Add module-level docstring banner: `experimental — unwired` on every module
17+
in the import-graph island list (confirm list via WDB-001 dry-run before merge).
18+
2. Update `docs/roadmap-status.md` H4, H5, H6 rows to `Partially implemented —
19+
unwired` (or equivalent honest status) with evidence citation to engineering
20+
refresh ENG-R1.
21+
3. Do **not** wire any production path in this ticket.
22+
23+
## Acceptance criteria
24+
25+
- Every island module docstring contains `experimental — unwired`.
26+
- Roadmap horizon rows for H4/H5/H6 reflect unwired state with Next Gate =
27+
WDA-002 or WDB-001.
28+
- WDB-001 validator passes at HEAD (green after labels registered).
29+
- No behavioral change: acceptance + regression tiers unchanged.
30+
31+
## Verification
32+
33+
```bash
34+
python scripts/validate_wiring.py # after WDB-001 lands; dry-run script acceptable for WDA-001-only PR
35+
python scripts/validate_docs_consistency.py --test-quality-mode off
36+
python -m pytest tests/acceptance tests/test_rbac.py tests/test_policy_engine.py -q --tb=no
37+
```
38+
39+
## Risks
40+
41+
- Labeling without WDB-001 risks missing a newly wired module — land WDB-001
42+
in same sprint, ideally same PR stack.
43+
- Roadmap status vocabulary must stay within `ROADMAP_VALID_STATUS_VALUES` in
44+
`validate_docs_consistency.py`.
45+
46+
## Do not
47+
48+
- Claim H4/H5/H6 Complete.
49+
- Add features to unwired modules.
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# WDB-001: Import-Graph Wiring Validator
2+
3+
**Priority:** P0
4+
**Status:** Scheduled (Sprint 1)
5+
**Sprint:** 2026-06-10 → 2026-06-17
6+
**Depends on:** WDA-001 (label registry)
7+
**Primary files:** `scripts/validate_wiring.py` (new), `tests/test_validate_wiring.py` (new), `.github/workflows/*` or pre-commit config
8+
9+
## Problem
10+
11+
ENG-R2: There is no automated gate detecting modules that are implemented and
12+
tested but unreachable from production entry points. Doc⇄reality drift recurs
13+
every review cycle.
14+
15+
## Scope
16+
17+
1. New script walks import graph from entry points:
18+
- `teaagent/cli/__main__.py` and CLI handler tree
19+
- `teaagent/tui/`
20+
- `teaagent/runner/`
21+
- `teaagent/gateway/` (if present)
22+
- `scripts/` invoked by CI
23+
2. Report `teaagent/*` modules unreachable from any entry point.
24+
3. Allowlist only modules explicitly labeled `experimental — unwired` in
25+
docstring (parse first 40 lines) or listed in a checked-in allowlist file
26+
with expiry date.
27+
4. Wire into CI and `validate_docs_consistency.py` or pre-commit.
28+
29+
## Acceptance criteria
30+
31+
- Fixture test: unlabeled island module → validator exit 1.
32+
- HEAD after WDA-001 → validator exit 0.
33+
- Documented run command in `docs/acceptance.md` or release checklist.
34+
35+
## Verification
36+
37+
```bash
38+
python scripts/validate_wiring.py
39+
python -m pytest tests/test_validate_wiring.py -q
40+
python scripts/validate_docs_consistency.py --test-quality-mode off
41+
```
42+
43+
## Risks
44+
45+
- Dynamic imports and `__getattr__` lazy loading may cause false positives —
46+
use static analysis with documented exceptions.
47+
- Test-only imports must not count as "wired"; entry-point list is the contract.
48+
49+
## Do not
50+
51+
- Auto-delete unwired modules.
52+
- Treat test imports as production wiring.
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# WDB-003: Fix Roadmap Contradictions (H2–H6 vs Milestones)
2+
3+
**Priority:** P0
4+
**Status:** Scheduled (Sprint 1)
5+
**Sprint:** 2026-06-10 → 2026-06-17
6+
**Depends on:** WDA-001 evidence
7+
**Primary files:** `docs/roadmap-status.md`, `scripts/validate_docs_consistency.py`, `tests/test_validate_docs_consistency_mode.py`
8+
9+
## Problem
10+
11+
ENG-R2: `roadmap-status.md` shows H2/H3 Pending while M2/M3 Complete; H4–H6
12+
Pending while commit log (`fe2a881`, `4e0a9e9`) claims Horizon implementation.
13+
A trust product cannot ship contradictory canonical status.
14+
15+
## Scope
16+
17+
1. Reconcile horizon table with milestone table using evidence classes:
18+
- **Complete** — production entry path + acceptance citation.
19+
- **Partially implemented — unwired** — code + tests, no production import.
20+
- **Pending** — no substantive implementation.
21+
2. Add validator rule: horizon status must not contradict linked milestone exit
22+
evidence (extend `validate_docs_consistency.py`).
23+
3. Update header `Last updated` and `Last reviewed` to edit date.
24+
4. Remove or qualify stale claims (e.g. "4758 tests pass" without run date/commit).
25+
26+
## Acceptance criteria
27+
28+
- No row pairs where milestone says Complete and horizon says Pending without
29+
`Partially implemented` or explicit note.
30+
- H4/H5/H6 rows cite WDA-001 unwired state until WDA-002+ land.
31+
- Validator test covers a seeded contradiction fixture.
32+
- `validate_docs_consistency.py --test-quality-mode off` passes.
33+
34+
## Verification
35+
36+
```bash
37+
python scripts/validate_docs_consistency.py --test-quality-mode off
38+
python -m pytest tests/test_validate_docs_consistency_mode.py -q
39+
```
40+
41+
## Risks
42+
43+
- Over-correcting to Complete when only tests exist — use import-graph truth
44+
from WDB-001, not commit message text.
45+
46+
## Do not
47+
48+
- Mark H4/H5/H6 Complete while WDB-001 reports unwired clusters.
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# WDG-001: Diagnose Full-Suite SIGXCPU Truncation
2+
3+
**Priority:** P0
4+
**Status:** Scheduled (Sprint 1, parallel)
5+
**Sprint:** 2026-06-10 → 2026-06-17
6+
**Primary files:** `pyproject.toml`, `tests/conftest.py`, CI workflow logs, new `docs/analysis/suite-truncation-root-cause-2026-06-*.md`
7+
8+
## Problem
9+
10+
Two full-suite attempts on 2026-06-10 were killed by SIGXCPU (exit 152) at
11+
~50% progress with zero failures observed. Exit code was masked by a pipe in
12+
one run. The "4758 tests pass" roadmap claim is therefore unverifiable at HEAD
13+
in constrained environments.
14+
15+
## Scope
16+
17+
1. Reproduce on Python 3.12 with `faulthandler` and `pytest --timeout` enabled.
18+
2. Capture last-collected test, duration, and whether kill is OS CPU limit vs
19+
pytest internal timeout.
20+
3. Document root cause in a dated analysis note linked from roadmap and
21+
work-direction INDEX.
22+
4. If harness-side: fix pipe exit-code propagation (finding from reasoning ledger).
23+
5. If environment-side: document minimum CPU budget for full tier.
24+
25+
## Acceptance criteria
26+
27+
- Dated root-cause note with reproduction commands and environment matrix.
28+
- Clean full-suite summary on Python 3.12 in unconstrained environment **or**
29+
explicit WDG-002 tier split documenting full tier as nightly-only.
30+
- Roadmap/test-count claims cite run date + commit per WDB-004 intent.
31+
32+
## Verification
33+
34+
```bash
35+
PYTHONFAULTHANDLER=1 python -m pytest -q 2>&1 | tee /tmp/full-suite.log
36+
# Document exit code, last test, SIGXCPU vs other
37+
python -m pytest -m smoke -q # after WDG-002 markers exist
38+
```
39+
40+
## Risks
41+
42+
- May be unfixable in Cursor/sandbox environments — tiering (WDG-002) is the
43+
acceptable outcome.
44+
45+
## Do not
46+
47+
- Disable tests to force green full suite.
48+
- Quote undated test counts in roadmap after this ticket.
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# WDG-002: Suite Tiering (Smoke / Acceptance / Nightly)
2+
3+
**Priority:** P0
4+
**Status:** Scheduled (Sprint 1)
5+
**Sprint:** 2026-06-10 → 2026-06-17
6+
**Depends on:** WDG-001 findings (tier boundaries)
7+
**Primary files:** `pyproject.toml`, `tests/conftest.py`, `docs/acceptance.md`, CI workflows, `scripts/validate_docs_consistency.py`
8+
9+
## Problem
10+
11+
ENG-R5 / WDG-001: Single monolithic suite exceeds constrained environment CPU
12+
budgets. Merge gates need a fast smoke tier; release needs acceptance; mutation
13+
and eval belong on nightly.
14+
15+
## Scope
16+
17+
1. Register pytest markers: `smoke`, `acceptance`, `nightly` (align with existing
18+
acceptance dir where possible).
19+
2. Define profiles:
20+
- **smoke:** &lt;2 min, gates every PR
21+
- **acceptance:** current `tests/acceptance` + regression (~628 tests)
22+
- **nightly:** full suite + mutation + eval fixtures
23+
3. Document which tier gates merge vs release vs nightly CI.
24+
4. Extend docs validator to warn when README/roadmap cites full count without
25+
tier label (WDB-004 precursor).
26+
27+
## Acceptance criteria
28+
29+
- `pytest -m smoke` completes in &lt;2 min on CI runner class used by project.
30+
- Acceptance profile documented with exact command and test count at HEAD.
31+
- CI runs smoke on PR; acceptance on main; nightly scheduled.
32+
- `validate_docs_consistency.py --test-quality-mode off` passes.
33+
34+
## Verification
35+
36+
```bash
37+
python -m pytest -m smoke -q --tb=no
38+
python -m pytest tests/acceptance -q --tb=no
39+
# Document nightly command in docs/acceptance.md
40+
```
41+
42+
## Risks
43+
44+
- Marker migration is large — start by marking slow/mutation tests `nightly`,
45+
default remainder to smoke+acceptance split per directory convention.
46+
47+
## Do not
48+
49+
- Remove full suite; demote to nightly, do not delete.

docs/plans/work-direction-decomposition-2026-06-10.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
> **Claim class:** Proposal (execution backlog candidate).
55
> **Derived from:** the [2026-06-10 System Critical Review Package](../analysis/system-critical-review-2026-06-10-INDEX.md).
66
> **Succeeds:** [System Improvement Work Directions (2026-06-06)](system-improvement-work-directions-2026-06-06.md) — that backlog's WS1/WS2/WS3 spine is substantially executed (see refresh docs for per-item evidence); WS0/WS4/WS5/WS6 items not restated here remain valid.
7+
> **Execution schedule:** [Work Direction Execution Index](work-direction-execution-index-2026-06-10.md) — Sprint 1–6 calendar and ticket plans.
78
>
89
> Every direction below names its source finding, a falsifiable acceptance
910
> gate, and an explicit "do not do" boundary, per the governed-engineering

0 commit comments

Comments
 (0)