# Documentation Index

> Auto-generated by roll-doc-audit on 2026-06-21. Edit individual docs, not this file.

## Index

| Path | Title | Category | Description |
|------|-------|----------|-------------|
| `docs/acceptance-contract.md` | 验收契约权属 / Acceptance Contract Ownership | process | 契约是设计层拥有的冻结产物(cycle 起始快照+漂移检测)、证据分类(web/cmd/roll-capture/named-tests)、能力天花板(存在性/绑定/权属 vs evaluator 判内容) |
| `docs/architecture.md` | 系统设计 / System Architecture | architecture | 产品定位、设计原则、系统架构、领域模型、行为合同、事实来源 (US-TRUTH)、结构化交付真相、唯一查询入口、存储裁定、消费者契约 |
| `docs/difftest-freeze-paradigm.md` | 快照冻结测试范式 | testing | CLI 命令输出用 Vitest 快照冻结的行为契约测试范式与可移植性陷阱 |
| `docs/live-console.md` | 实时控制台指南 / Live Console Guide | guide | CLI-first 实时可观测指南：`roll loop cycle watch` 用法、三流契约、静态导出 vs 实时服务、证据按构造 |
| `docs/manifesto.md` | Roll 宣言 | product | Roll 产品宣言与愿景 |
| `docs/migration/role-taxonomy-v4.md` | Role Taxonomy v4 Migration | migration | Breaking migration note for Supervisor / Designer / Builder / Evaluator taxonomy, designed profiles, and open-pool casting |
| `docs/verification.md` | 验收 / Verification | process | 故事验收标准与证据规范 |

## Coverage Summary

- Total docs indexed: 7
- By category: architecture (1) / guide (1) / migration (1) / testing (1) / product (1) / process (2)

## Key Architecture Chapters (US-TRUTH epic)

`docs/architecture.md` 以下章节由 US-TRUTH 系列落地，是交付真相的架构准则：

| Section | Topic | Key Principle |
|---------|-------|---------------|
| 事实来源 (US-TRUTH 系列) | 权威矩阵 + 终态事件 + 选择器 + 读侧适配器 | 读侧一律走结构化选择器，不各自解析 backlog/events/runs |
| 结构化交付真相 | `DeliveryRecord` / `deliveries.jsonl` | Backlog 状态格 = 派生显示；机器绝不 parse markdown |
| 生命周期与裁定正交 | `LifecycleState` ⊥ `TruthState` | 两个维度独立承载，不互斥、不塌缩 |
| 唯一查询入口 | `queryStoryDelivery()` | picker/reconcile/dossier/watch 唯一确定性查询函数 |
| 存储裁定 | 不上 SQLite | append-only JSONL + 原子写；SQLite 仅可作派生缓存 |
| 消费者契约 | 各消费者输入/输出/行为 | 新增消费者必须走 queryStoryDelivery，写本地解析即回归 |