feat(usable): integrate current dbtool implementation snapshot

Co-Authored-By: Paperclip <noreply@paperclip.ing>

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

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