# Documentation Out-of-Date Analysis

**Generated:** 2026-06-13
**Workspace version:** 0.2.0-beta.1
**Latest commit:** dd6e80f (2026-06-13)

## Summary
- Total docs checked: 64
- Outdated docs: 12
- Stale version refs: 5
- Undocumented recent changes: 8
- Stale date refs: 15+

## Stale Version References

| File | Line | Version Referenced | Current Version | Drift |
|------|------|-------------------|-----------------|-------|
| `docs/sysdes.md` | 6 | 0.9.8 | N/A (doc version) | Last updated 2026-05-14, 30 days stale |
| `docs/srs.md` | 7 | 0.9.9 | N/A (doc version) | Last updated 2026-05-18, 26 days stale |
| `docs/sysrs.md` | 5 | 0.9.11 | N/A (doc version) | Last updated 2026-06-07, 6 days stale |
| `docs/material3-guideline.md` | ~4 | 0.9.2 | N/A (doc version) | Last updated 2026-05-14, 30 days stale |
| `tools/windows-smoke.md` | 6 | `product/scaffold-v0` branch | `main` | Default branch changed per CHANGELOG |

## Stale Date References

| File | Date | Age | Issue |
|------|------|-----|-------|
| `docs/implementation-status-2026-05-28.md` | 2026-05-28 | 16 days | Pre-dates DV baseline (2026-05-29) and 8 major feature PRs |
| `docs/architecture/sad.md` | 2026-05-29 | 15 days | Missing file transfer, poke notifications, desktop VAD features |
| `docs/architecture/sdd.md` | 2026-05-29 | 15 days | Missing file transfer, poke notifications, desktop VAD features |
| `docs/verification/verification-master-plan.md` | 2026-05-29 | 15 days | Missing file transfer and poke notification verification |
| `docs/verification/swe4-unit-verification-plan.md` | 2026-05-29 | 15 days | Missing new test coverage for file transfer |
| `docs/verification/swe5-software-integration-verification-plan.md` | 2026-05-29 | 15 days | Missing file transfer integration verification |
| `docs/verification/swe6-software-verification-plan.md` | 2026-05-29 | 15 days | Missing file transfer software verification |
| `docs/verification/sys4-system-integration-verification-plan.md` | 2026-05-29 | 15 days | Missing file transfer system verification |
| `docs/governance/product-decision-register.md` | 2026-05-29 | 15 days | Missing file-transfer-related decisions |
| `docs/governance/document-index.md` | 2026-05-29 | 15 days | Missing file-transfer-design.md, file-transfer-research.md, file-transfer-implementation-plan.md |
| `docs/security/security-privacy-legal-guideline.md` | 2026-05-29 | 15 days | Missing file transfer security considerations |
| `docs/security/threat-model.md` | 2026-05-29 | 15 days | Missing file transfer threat analysis |
| `docs/i18n/localization-architecture.md` | 2026-05-29 | 15 days | Missing poke notification l10n strings |
| `docs/legal/trademark-and-attribution-review.md` | 2026-05-29 | 15 days | Missing cacache license review |
| `docs/privacy/privacy-policy.md` | 2026-05-29 | 15 days | Missing file transfer data handling |

## Undocumented Recent Changes

| Change | Date | Expected Doc | Status |
|--------|------|-------------|--------|
| File transfer system (avatar/icon download with cacache) | 2026-06-10 | README.md, SAD, SDD, CHANGELOG | Not in README crate list, not in CHANGELOG |
| Poke notifications (local notifications, settings, bridge) | 2026-06-08 | SAD, SDD, CHANGELOG | Not in CHANGELOG |
| Desktop Silero ONNX VAD + Windows PTT modernization | 2026-06-09 | SAD, SDD, CHANGELOG | Not in CHANGELOG |
| iOS RemoteIO+WebRTC APM path removal | 2026-06-10 | SAD, SDD | Not documented |
| SonoraExperimental bridge API removal | 2026-06-10 | SAD, SDD, bridge docs | Not documented |
| iOS AVAudioSession activation fix | 2026-06-10 | Platform docs | Not documented |
| iOS Debug build unblocking + FRB regeneration | 2026-06-10 | Build docs | Not documented |
| poke-without-message design | 2026-06-09 | Design docs | Committed but not indexed |

## Feature Drift

### Documented but No Longer in Code
| Feature | Doc File | Last Seen In Code |
|---------|----------|-------------------|
| `SonoraExperimental` bridge API | `docs/architecture/sdd.md` (implied) | Removed 2026-06-10 (commit 2b28549) |
| iOS `ios_raw_unit.rs` | `docs/implementation-status-2026-05-28.md:33` | Removed 2026-06-10 (commit 3f9ea4f) |
| `SnapshotChanged` event variant | CHANGELOG v0.3.0 | Removed end-to-end |
| Timer-based snapshot polling | CHANGELOG v0.2.0-beta.1 | Replaced by event-driven UI |

### In Code but Not Documented
| Feature | Code Location | Expected Doc |
|---------|--------------|-------------|
| `chanora_cache` crate (cacache-backed blob store) | `crates/chanora_cache/` | README.md crate list, SAD, SDD |
| File transfer protocol support | `crates/chanora_protocol/` | SAD, SDD, CHANGELOG |
| Poke notification service | `apps/chanora_flutter/lib/services/` | SAD, SDD, CHANGELOG |
| Poke notification settings UI | `apps/chanora_flutter/lib/widgets/` | SAD, SDD |
| Desktop Silero ONNX VAD | `crates/chanora_audio/src/vad/silero_onnx.rs` | SAD, SDD |
| Windows PTT modernization | `crates/chanora_audio/src/ptt_backends/windows.rs` | SAD, SDD |
| `poke_limiter.rs` | `crates/chanora_protocol/src/poke_limiter.rs` | SAD, SDD |
| Local notification plugin integration | `apps/chanora_flutter/` | SAD, SDD |

## Per-File Out-of-Date Assessment

### README.md
- **Last meaningful update:** Unknown (no date in file)
- **Stale sections:**
  - Crate list (line 242-249): Missing `chanora_cache` and `chanora_resolver` crates
  - Repository layout (line 233-249): Missing `chanora_cache`, `chanora_resolver`, `chanora_prefetch`
  - Status section (line 16-23): References "v0.9.x document set" — no specific date
  - Development section (line 398-409): Missing `just` commands (justfile exists)
- **Missing recent changes:** File transfer system, poke notifications, desktop VAD

### docs/sysdes.md
- **Version:** 0.9.8
- **Last change record:** 2026-05-14
- **Stale sections:** All — 30 days without update
- **Missing:** File transfer system element (SE-20?), poke notification interface (IF-015?)

### docs/srs.md
- **Version:** 0.9.9
- **Last change record:** 2026-05-18
- **Stale sections:** All — 26 days without update
- **Missing:** File transfer SRS requirements, poke notification SRS requirements, desktop VAD SRS requirements

### docs/sysrs.md
- **Version:** 0.9.11
- **Last change record:** 2026-06-07
- **Stale sections:** Mostly current but missing file transfer and poke notification requirements

### docs/architecture/sad.md
- **Date:** 2026-05-29
- **Stale sections:**
  - Component architecture table (line 39-50): Missing `chanora_cache` component
  - Missing file transfer architecture
  - Missing poke notification architecture
  - Missing desktop VAD architecture
- **Missing recent changes:** All PRs from 2026-06-07 through 2026-06-13

### docs/architecture/sdd.md
- **Date:** 2026-05-29
- **Stale sections:**
  - Module catalogue (line 15-31): Missing file transfer module, poke notification module
  - Missing `chanora_cache` module (SDD-MOD-016?)
  - Missing `poke_limiter` module
- **Missing recent changes:** All PRs from 2026-06-07 through 2026-06-13

### docs/implementation-status-2026-05-28.md
- **Date:** 2026-05-28 — 16 days old
- **Stale sections:**
  - "Done" table: Missing file transfer, poke notifications, desktop VAD, iOS fixes
  - "Partial / Scaffold Only": `chanora_cache` was scaffold, now implemented
  - "Not Done (P0 blockers)": iOS `AVAudioSession.Mode.voiceChat` — now implemented (commit 89bbfa1)
  - Android target compilation: Still blocked per DEC-034
  - Agent spec docs reference (line 140): States docs are "deleted" — stale cleanup note
- **Recommendation:** Update to reflect current state or create new status doc

### docs/governance/product-decision-register.md
- **Date:** 2026-05-29
- **Note:** DEC-033 and DEC-034 are present (lines 20-21). Missing decisions:
  - File transfer architecture decision
  - Poke notification feature decision

### docs/governance/document-index.md
- **Date:** 2026-05-29
- **Missing documents:**
  - `docs/architecture/file-transfer-design.md`
  - `docs/architecture/file-transfer-research.md`
  - `docs/architecture/file-transfer-implementation-plan.md`
  - `docs/superpowers/specs/2026-06-09-poke-without-message-design.md`

### docs/security/license-inventory.md
- **Status:** Refreshed 2026-06-09 (commit b841d3f)
- **Issue:** May be missing `cacache` dependency license if not in Cargo.lock at refresh time

### docs/material3-guideline.md
- **Version:** 0.9.2
- **Last change record:** 2026-05-14
- **Status:** 30 days stale, but Material 3 design may not have changed

### tools/windows-smoke.md
- **Stale reference:** Line 6 references `product/scaffold-v0` branch
- **Current default:** `main` per CHANGELOG v0.3.0

### docs/verification/*.md (all 5 files)
- **Date:** All dated 2026-05-29
- **Missing:** File transfer verification, poke notification verification, desktop VAD verification

## Recommendations

### Critical (blocks DV/release)
1. **Update `docs/implementation-status-2026-05-28.md`** — 16 days stale, missing 8 major PRs, iOS voiceChat now implemented
2. **Update `docs/governance/product-decision-register.md`** — Missing file transfer and poke notification decisions
3. **Update `docs/governance/document-index.md`** — Missing 3 file-transfer docs

### High Priority (DV completeness)
4. **Update `docs/architecture/sad.md`** — Missing file transfer, poke notifications, desktop VAD, chanora_cache component
5. **Update `docs/architecture/sdd.md`** — Missing file transfer, poke notifications, desktop VAD modules
6. **Update `docs/sysdes.md`** — 30 days stale, missing file transfer system elements
7. **Update `docs/srs.md`** — 26 days stale, missing file transfer and poke notification requirements
8. **Update CHANGELOG.md** — Missing v0.3.0+ changes (file transfer, poke notifications, desktop VAD, iOS fixes)

### Medium Priority (accuracy)
9. **Update README.md** — Missing `chanora_cache` and `chanora_resolver` in crate list
10. **Update `tools/windows-smoke.md`** — Fix stale branch reference
11. **Update verification plans** — Add file transfer and poke notification verification
12. **Update security docs** — Add file transfer threat analysis

### Low Priority (cleanup)
13. **Align document versions** — SysDes (0.9.8), SysRS (0.9.11), Material3 (0.9.2) have different version numbers
14. **Clean up path record files** — `docs/architecture/sysdes.md`, `docs/requirements/sysrs.md`, `docs/requirements/srs.md`, `docs/ui-ux/material3-guideline.md` are stubs pointing to canonical files