dbtool-cli-v1/plans/2026-03-27-cmp-47-tui-tty-smoke-contract.md

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 提示文案
• 文档口径：已明确区分“当前预构建产物行为”与“源码目标行为”