Decisions
The coverage architecture follows the accepted decisions below. The full framework rules live in the separate best-practices project.
| Decision | Choice | Status |
|---|---|---|
| Scope | First-party source, tests, docs, config, and infrastructure | Current |
| Excluded | Vendor, generated, build, cache, and lock files, with reasons | Current |
| Profiles | CLI, service, library, frontend | Framework |
| Stages | PoC, internal production, production | Framework |
| Partition order | Directory or module first, then kind and language tags | Current |
| Segment unit | One fresh model session per segment | Current |
| Discovery budget | Usable context, not the 25% query ratio | Current |
| Maintenance budget | Delta and query only | Current |
| Storage | SQLite ledger primary; JSONL and Markdown exports | Current |
| Raw reads | Blocked by default with an explicit override | Current in all four plugins |
| Watcher | Native inotify or FSEvents, polling fallback | Current |
| Workspace | Root of the same partition tree | Current survey and full read |
| Metrics | Coverage, freshness, retrieval, quality, meander | Draft |
Open decisions
- The leaf target at 64K, 128K, and 256K after quality testing.
- The synthesis cadence.
- The scope policy file format.
- The OpenCode guard plugin against a live OpenCode session.
- Native events on network filesystems that do not provide them.