Login
View Ticket
Login
Ticket Hash: 5667eb44d6592fd1a590405f67e9c6e28f6426ea
Title: Docs freshness audit: sweep docs against current behavior (semantic search surfaced stale content)
Status: Closed Type: task
Severity: Normal Priority: medium
Subsystem: docs Resolution: Overcome_By_Events
Last Modified: 2026-11-09 21:53:27
34.3 hours ago
Created: 2026-07-07 00:04:56
127.3 days ago
Version Found In:
Description:
Trigger: running semantic search over the corpus (query "claude", 2026-07-06) surfaced multiple docs that are out of date relative to current behavior. Semantic search is now a practical doc-audit tool; use it.

Do a freshness pass over docs/ (and the top-level *.md: README, TODO, PROGRESS, BACKLOG) against how the system actually behaves now. Known-stale hot spots to check first: - PROGRESS.md — only partially caught up (entries between 2026-06-16 and 2026-07-06 were not backfilled: interactor import, vector Phases 0-2, df65 retirement, the provider-protocol milestone, session-lifecycle work). - docs/architecture.md — recently grew the provider-protocol section; verify the surrounding seam/provider text still matches (ProviderProtocol + config.chat/embed facade, no api_style branching in consumers). - Anything the "claude" results flagged (session isolation, capability, runner docs) that describes retired mechanisms.

Method: use semantic_search / vec-search to pull the doc chunk for a behavior, compare to the code/current reality, and correct. This operationalizes the accuracy axis already in docs/review-checklist.md.

Acceptance: - A pass over docs/ + top-level *.md with each stale claim either corrected or ticketed. - PROGRESS.md backfilled (or an explicit note of the gap window with pointers). - A short docs/ freshness note recorded (date of last audit).

Relates to docs/review-checklist.md (accuracy axis) and the summary-as-staleness-detector ticket.

User Comments:
added on 2026-11-09 21:53:27:

Closed in OCX's ticket sort, batch 6 (ollama post 8f6c9afbb7): tracked under the semantic-search row of docs/parity-v1.md (0e2d18fbea), held: the maintainer chose Fossil's full-text search first. Reopen this when semantic search is taken up.