docs(v1.0): re-audit milestone after Phase 7 gap closure

Author: alexandrebarsacq

.planning/config.json

@@ -8,6 +8,7 @@
     "research": true,
     "plan_check": true,
     "verifier": true,
-    "nyquist_validation": true
+    "nyquist_validation": true,
+    "_auto_chain_active": false
   }
-}
+}

.planning/v1.0-MILESTONE-AUDIT.md

@@ -1,59 +1,60 @@
 ---
 milestone: v1.0
-audited: 2026-03-19T19:00:00Z
+audited: 2026-03-19T20:00:00Z
 status: tech_debt
 scores:
   requirements: 22/22
-  phases: 6/6
-  integration: 21/22
+  phases: 7/7
+  integration: 24/24
   flows: 5/6
 gaps:
   requirements: []
-  integration:
-    - id: "MISS-01"
-      description: "README Limitation 12 contradicts implementation — states annotation/DESCRIPTION sync is not implemented, but Phase 3 fully implements it"
-      affected_requirements: ["DOC-01", "FIELD-01"]
-      severity: "medium"
-      evidence: "README.md lines 390-396 and line 488 contradict src/tw_adapter.rs annotation diff logic and E2E tests S-84/S-85"
-    - id: "MISS-02"
-      description: "--fail-fast flag has no behavioral E2E test"
-      affected_requirements: ["AUDIT-03"]
-      severity: "low"
-      evidence: "Only CLI parsing tests exist; behavioral path (error → loop break → non-zero exit) not E2E verified"
+  integration: []
   flows:
-    - id: "FLOW-01"
-      description: "New user flow partially misleading due to MISS-01"
-      affected_requirements: ["DOC-01"]
-      severity: "medium"
+    - id: "CATALOG-TRACEABILITY"
+      description: "CATALOG.md missing S-96–S-100 entries for compatibility tests"
+      affected_requirements: ["COMPAT-01", "COMPAT-02", "COMPAT-04"]
+      severity: "documentation-only"
+resolved_gaps:
+  - id: "MISS-01"
+    description: "README Limitation 12 contradicted implementation — resolved by Phase 7"
+    resolved_by: "07-01-PLAN.md"
+  - id: "FLOW-01"
+    description: "New user flow misleading due to MISS-01 — resolved by Phase 7"
+    resolved_by: "07-01-PLAN.md"
 tech_debt:
   - phase: "06-documentation-and-release"
     items:
-      - "README Limitation 12 (lines 390-396) incorrectly states annotation/DESCRIPTION sync is not implemented — needs correction"
-      - "README Roadmap (line 488) lists 'Annotation / DESCRIPTION sync' as v2 feature — already implemented"
-      - "README Field Mapping table missing annotations → DESCRIPTION row"
       - "06-01-SUMMARY.md frontmatter missing requirements_completed entries for DOC-01, DOC-02, DOC-04"
       - "CHANGELOG.md date placeholder 2026-03-XX must be replaced before tagging"
+  - phase: "04-compatibility"
+    items:
+      - "CATALOG.md missing S-96–S-100 entries and range row; total count shows 75 instead of 80"
   - phase: "05-ci-cd-and-packaging"
     items:
       - "CI pipeline not yet triggered (no push since workflow creation)"
       - "MUSL binary build not locally verified (musl-tools unavailable)"
   - phase: "01-code-audit-and-bug-fixes"
     items:
       - "--fail-fast behavioral path has no E2E or integration test"
-  - phase: "all"
-    items:
-      - "docs/compatibility/tasks-org.md not linked from README (surface-level reference only)"
 nyquist:
   compliant_phases: []
-  partial_phases: ["01", "02", "03", "04", "05", "06"]
+  partial_phases:
+    - "01-code-audit-and-bug-fixes"
+    - "02-relation-verification"
+    - "03-field-and-sync-correctness"
+    - "04-compatibility"
+    - "05-ci-cd-and-packaging"
+    - "06-documentation-and-release"
+    - "07-readme-accuracy-fixes"
   missing_phases: []
   overall: "partial"
 ---
 
-# Milestone v1.0 Audit Report
+# Milestone v1.0 Audit Report (Post-Phase 7)
 
 **Milestone:** v1.0 — Caldawarrior Hardening
-**Audited:** 2026-03-19
+**Audited:** 2026-03-19 (re-audit after Phase 7 gap closure)
 **Status:** tech_debt (no critical blockers; accumulated items need review)
 
 ## Requirements Coverage
@@ -80,12 +81,12 @@ nyquist:
 | COMPAT-04 | 4 | passed | 04-02 | [x] | satisfied |
 | PKG-01 | 5 | passed | 05-01 | [x] | satisfied |
 | PKG-02 | 5 | passed | 05-02 | [x] | satisfied |
-| DOC-01 | 6 | passed | — | [x] | satisfied* |
-| DOC-02 | 6 | passed | — | [x] | satisfied* |
+| DOC-01 | 6, 7 | passed | 07-01 | [x] | satisfied |
+| DOC-02 | 6 | passed | — | [x] | partial* |
 | DOC-03 | 6 | passed | 06-02 | [x] | satisfied |
-| DOC-04 | 6 | passed | — | [x] | satisfied* |
+| DOC-04 | 6 | passed | — | [x] | partial* |
 
-*DOC-01/02/04: 06-01-SUMMARY.md frontmatter missing `requirements_completed` entries; VERIFICATION.md confirms all satisfied.
+*DOC-02/04: VERIFICATION.md confirms both satisfied with evidence; 06-01-SUMMARY.md frontmatter `requirements_completed` is empty (metadata oversight).
 
 **Orphaned requirements:** None
 **Unsatisfied requirements:** None
@@ -97,32 +98,24 @@ nyquist:
 | 1 | Code Audit and Bug Fixes | 10/10 | ✓ passed | — |
 | 2 | Relation Verification | 9/9 | ✓ passed | 1 human verification (RF Docker suite) |
 | 3 | Field and Sync Correctness | 15/15 | ✓ passed | Re-verified after gap closure (03-03) |
-| 3.1 | Gap Closure | — | ✓ complete | Closed Phase 3 gaps (task modify refactor) |
 | 4 | Compatibility | 4/4 | ✓ passed | — |
 | 5 | CI/CD and Packaging | 11/11 | ✓ passed | 2 human verification items (CI/release triggers) |
 | 6 | Documentation and Release | 8/8 | ✓ passed | — |
+| 7 | README Accuracy Fixes | 4/4 | ✓ passed | Closed MISS-01 and FLOW-01 from initial audit |
 
-## Cross-Phase Integration
+## Resolved Gaps (from Initial Audit)
 
-**Score:** 21/22 exports wired correctly
+Phase 7 was created to close two gaps found in the initial v1.0 audit:
 
-### Integration Issues
+**MISS-01 (RESOLVED):** README Limitation 12 no longer contradicts implementation. Rewritten to "Only first annotation synced to DESCRIPTION" with correct body text. Field Mapping table now includes `annotations[0] → DESCRIPTION` row. v2 Roadmap no longer lists annotation sync as planned.
 
-**MISS-01 (Medium): README contradicts implementation — annotation/DESCRIPTION sync**
-- README Limitation 12 (lines 390-396) states: "TaskWarrior annotations are not mapped to any CalDAV field"
-- Reality: Phase 3 implemented full annotation ↔ DESCRIPTION bidirectional sync (`tw_adapter.rs` tag/annotation diff, E2E tests S-84/S-85)
-- README Roadmap (line 488) lists "Annotation / DESCRIPTION sync" as a v2 feature
-- README Field Mapping table missing `annotations → DESCRIPTION` row
-- **Impact:** Users won't know the feature exists; may implement workarounds unnecessarily
-- **Affected requirements:** DOC-01, FIELD-01
+**FLOW-01 (RESOLVED):** New user flow is no longer misleading. README now accurately describes annotation sync as implemented and links to `docs/compatibility/tasks-org.md` from the Compatibility section.
 
-**MISS-02 (Low): --fail-fast behavioral path untested E2E**
-- CLI flag parsing verified via unit tests
-- The behavioral path (sync error → loop break → non-zero exit) has no E2E or integration test
-- Logic is simple (one conditional break in writeback.rs:462)
-- **Affected requirements:** AUDIT-03
+## Cross-Phase Integration
 
-## E2E User Flows
+**Score:** 24/24 exports wired correctly — no orphaned exports, no missing connections.
+
+**E2E Flows:** 5/6 complete.
 
 | Flow | Description | Status |
 |------|-------------|--------|
@@ -131,28 +124,25 @@ nyquist:
 | Error handling | --fail-fast → error → non-zero exit | ⚠ Partial (no E2E test) |
 | CI pipeline | push → lint + test + e2e + audit | ✓ Complete (untriggered) |
 | Release | v* tag → MUSL binary → GitHub Release | ✓ Complete (untriggered) |
-| New user | README → install → config → sync → schedule | ⚠ Partial (MISS-01 doc inaccuracy) |
+| New user | README → install → config → sync → schedule | ✓ Complete (MISS-01 resolved) |
 
 ## Tech Debt Summary
 
 ### Phase 6: Documentation and Release
-- README Limitation 12 incorrectly states annotation/DESCRIPTION sync is not implemented
-- README Roadmap lists already-implemented feature as v2
-- README Field Mapping table missing `annotations → DESCRIPTION` row
-- 06-01-SUMMARY.md frontmatter missing `requirements_completed` entries
+- 06-01-SUMMARY.md frontmatter missing `requirements_completed` entries for DOC-01, DOC-02, DOC-04
 - CHANGELOG.md date placeholder `2026-03-XX` needs replacement before tagging
 
+### Phase 4: Compatibility
+- `tests/robot/docs/CATALOG.md` missing S-96–S-100 entries; total shows 75 instead of 80
+
 ### Phase 5: CI/CD and Packaging
 - CI pipeline not yet triggered (no push since workflow creation)
 - MUSL binary build not locally verified (musl-tools unavailable on dev host)
 
 ### Phase 1: Code Audit and Bug Fixes
 - `--fail-fast` behavioral path has no E2E or integration test
 
-### Cross-Phase
-- `docs/compatibility/tasks-org.md` not linked from README (surface-level reference only)
-
-**Total: 9 items across 4 categories**
+**Total: 6 items across 4 phases** (down from 9 in initial audit — 3 resolved by Phase 7)
 
 ## Nyquist Compliance
 
@@ -164,8 +154,9 @@ nyquist:
 | 04 | exists | partial | `/gsd:validate-phase 4` |
 | 05 | exists | partial | `/gsd:validate-phase 5` |
 | 06 | exists | partial | `/gsd:validate-phase 6` |
+| 07 | exists | partial | `/gsd:validate-phase 7` |
 
-All 6 phases have VALIDATION.md scaffolds but none are fully compliant. This is a test coverage gap, not a feature gap.
+All 7 phases have VALIDATION.md scaffolds but none are fully compliant. This is a test coverage gap, not a feature gap.
 
 ## Human Verification Items (Operational)