# CMP-51 TUI Live Evidence Boundary

- 日期：2026-03-27
- 负责人：Senior Frontend Engineer

## Goal

统一 `dbtool-usable-v1` 对 TUI 的证据分层口径，避免把 `sqlite-local` 局部 live path 误写成整体通过。

## Assessment

- 当前仓库已有两个前端可见面：`apps/tui` 终端工作台与 `gui/` 静态 foundation。
- `CMP-51` 当前不新增 UI 功能，重点是修正文档与验收边界。
- 现有文档已经说明 TUI 缺少 PostgreSQL / MySQL network live，但 `partial` 定义与 README 口径不够集中，容易让 QA/PM 误读。

## Scope

1. 在 TUI README 中固定三层结论：shell baseline、`sqlite-local` local live、network live
2. 在 usable-v1 QA 文档中补齐 `partial` 定义和判定规则
3. 在根 README 与 release/pre-release 文档中同步相同口径

## Out of Scope

- 新增 PostgreSQL / MySQL network live 实现
- 修改 `db-app` / CLI 契约
- 扩张到 GUI 正式工程

## Validation

- `git diff --stat -- README.md apps/tui/README.md USABLE_ACCEPTANCE_CHECKLIST.md USABLE_EVIDENCE_LEDGER.md USABLE_PRE_RELEASE_CHECKLIST.md USABLE_RELEASE_GATE.md`
- `git status --short -- README.md apps/tui/README.md USABLE_ACCEPTANCE_CHECKLIST.md USABLE_EVIDENCE_LEDGER.md USABLE_PRE_RELEASE_CHECKLIST.md USABLE_RELEASE_GATE.md`

## Result

- TUI 的 usable-v1 结论被固定为：shell baseline=`pass`、`sqlite-local`=`partial`、PostgreSQL/MySQL network live=`blocked`
- `partial` 在 evidence ledger 中获得显式定义
- README、QA checklist 与 release gate 使用同一套前端口径