# Findings

## Architecture

- 后端使用 Go。
- 前端使用 Vue 3 + Vite。
- 工具以 localhost Web 应用运行。

## Data Sources

- `.codex/agents/*.toml`: 智能体配置。
- `.codex/config.toml`: 项目信任配置。
- `.codex/state_5.sqlite`: threads、thread_spawn_edges；Phase 3 通过 `mode=ro&immutable=1` 只读打开。
- `.codex/goals_1.sqlite`: thread_goals；Phase 3 通过 `mode=ro&immutable=1` 只读打开。
- 本机进程表：Codex 进程辅助判断。
- 项目工作流文件：task_plan.md、findings.md、progress.md、docs/project.md。

## Constraints

- 禁止读取或展示 `.codex/auth.json`。
- 禁止写入 SQLite。
- 默认不写 `.codex/config.toml`。
- `.codex/agents/*.toml` 仅允许经草稿、校验、diff、备份、确认后写回。

## Decisions

- 工作流显示使用动态事件流/DAG，不写死阶段或 agent 顺序。
- 所有推断状态必须显示来源和置信度。
- UI 全中文，技术缩写保留英文。
- Phase 3 使用纯 Go `modernc.org/sqlite v1.35.0` 读取 SQLite，避免 CGO 运行时依赖，并保持项目 `go 1.22` 兼容。
- SQLite 文件不存在时返回空列表和 `sqlite_missing`/`low` 来源证据；仅 state 或仅 goals 缺失时返回 `sqlite_partial` 聚合证据，并在 `sources.state` / `sources.goals` 分别标注缺失或只读来源。
- 动态工作流事件从 threads、spawn edges、goals、`task_plan.md` 证据构建，不假设固定角色顺序。