# 2026-03-27 CMP-47 `dbtool-tui` TTY smoke 契约收口计划

## 目标

- 固化 `dbtool-tui` 的 TTY-required 启动口径
- 给 QA / CI 一个最小可重复 smoke 入口
- 把非 TTY 限制写入源码与文档，而不是继续靠口头说明

## 本轮执行

- 在 `apps/tui/src/main.rs` 增加非 TTY 前置检查与测试
- 新增 `scripts/tui/smoke-tty.sh` 作为统一 smoke 入口
- 新增 `TUI_SMOKE_RUNBOOK.md`
- 更新 `apps/tui/README.md`、`README.md`、`DEVELOPING.md`、`TUI_TEST_STRATEGY.md`、`TUI_ACCEPTANCE_CHECKLIST.md`、`TUI_REGRESSION_CHECKLIST.md`

## 当前结果

- 已验证：`scripts/tui/smoke-tty.sh ./target/debug/dbtool-tui` 在当前预构建二进制上退出 `0`
- 已验证：日志包含 `Workspace`
- 已知限制：当前 runner 无 Rust 工具链，无法重建 `dbtool-tui` 验证新的非 TTY 提示文案
- 文档口径：已明确区分“当前预构建产物行为”与“源码目标行为”