feat(usable): integrate current dbtool implementation snapshot

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

backlog/2026-03-27-closeout-issue-package.md

@@ -0,0 +1,168 @@
+# 2026-03-27 CTO Closeout Issue Package
+
+日期：2026-03-27  
+作者：CTO
+
+## 目的
+
+把当前已完成的大块实现，转换成下一批可直接分派、可验收、可关闭的 issue，避免团队继续在“功能已差不多”但“证据与签收未收口”的状态里空转。
+
+## 当前判断
+
+- `dbtool-cli-v1` 的主要风险已经从“功能未实现”切换到“发布证据不完整”。
+- `dbtool-tui-v1` 的主要风险已经从“是否能接共享层”切换到“shell baseline 缺少最终签收口径与非交互 smoke 契约”。
+- 当前不建议再创建大而模糊的“继续完善”任务；每个 issue 都应只解决一个可关闭问题。
+
+## Proposed Issues
+
+### 1. QA：CLI 剩余负路径证据补齐
+
+- **建议 owner**：QA Engineer
+- **目标**：把 CLI 当前未闭合的失败路径从“文档里写了待验证”推进到“有命令、有环境、有输出摘要的证据”
+- **范围**
+  - PostgreSQL / MySQL 错误凭据
+  - PostgreSQL / MySQL 网络不可达
+  - 空 schema / 空数据库反馈
+  - 空结果集导出行为
+  - 权限不足时的错误可读性
+- **不在范围**
+  - 新功能实现
+  - 新数据库接入
+  - TUI 验收
+- **输入文档**
+  - `ACCEPTANCE_CHECKLIST.md`
+  - `PRE_RELEASE_CHECKLIST.md`
+  - `TEST_STRATEGY.md`
+  - `SMOKE_RUNBOOK.md`
+- **交付物**
+  - 更新后的验收清单
+  - 每条负路径的执行命令与输出摘要
+  - 未能执行项的 blocker 说明
+- **验收标准**
+  - 所有当前未勾选但应在 CLI v1 范围内的负路径，都有“已验证”或“明确 blocker”
+  - 失败路径输出不泄露 secrets
+  - 文档状态与证据状态一致
+- **依赖**
+  - 具备 Docker 的宿主机或等价 QA 环境
+
+### 2. Release：跨平台 artifact 证据补齐
+
+- **建议 owner**：Backend / Release Engineer
+- **目标**：补齐 Linux / macOS / Windows release-smoke 的真实运行证据
+- **范围**
+  - GitHub Actions 或等价 runner 上的真实 workflow run
+  - artifact 名称、checksum、`--help`、`--version`
+  - 失败时的构建 / 打包 / smoke 分类
+- **不在范围**
+  - 新的打包格式
+  - 发布渠道设计变更
+- **输入文档**
+  - `.github/workflows/release-smoke.yml`
+  - `RELEASE_RUNBOOK.md`
+  - `PRE_RELEASE_CHECKLIST.md`
+- **交付物**
+  - 三平台 artifact smoke 证据
+  - 若失败则给出按平台分类的问题单
+  - 更新后的发布前清单
+- **验收标准**
+  - 三平台至少有一次可审计的真实运行记录
+  - artifact 命名、checksum sidecar、帮助与版本输出都与 runbook 一致
+  - 失败平台不会被模糊写成“待看”
+- **依赖**
+  - GitHub-hosted runners 或等价 CI
+
+### 3. CTO：CLI 文档与 checklist 一致性收口
+
+- **建议 owner**：CTO
+- **目标**：把 README、runbook、测试策略、验收清单之间的当前口径彻底对齐
+- **范围**
+  - `README.md`
+  - `SMOKE_RUNBOOK.md`
+  - `RELEASE_RUNBOOK.md`
+  - `ACCEPTANCE_CHECKLIST.md`
+  - `PRE_RELEASE_CHECKLIST.md`
+  - `TEST_STRATEGY.md`
+- **不在范围**
+  - 改功能语义
+  - 改产品边界
+- **交付物**
+  - 一组状态一致、无明显互相冲突的文档
+  - 当前已验证项 / 未验证项 / blocker 的统一口径
+- **验收标准**
+  - README 中的运行说明与实际可执行入口一致
+  - 各文档不再同时出现“已完成”和“未开始”的冲突表述
+  - 当前 runner 限制被明确写出，不伪装成本地已验证
+- **依赖**
+  - issue 1 和 issue 2 的最新证据
+
+### 4. Frontend / TUI：非交互 smoke 与启动契约定义
+
+- **建议 owner**：Senior Frontend Engineer
+- **目标**：解决 `dbtool-tui` 在非 TTY 场景下直接报终端设备错误、无法形成稳定 QA / CI smoke 入口的问题
+- **范围**
+  - `dbtool-tui` 的启动前置检查与错误信息
+  - `--help` 或等价非交互 smoke 行为
+  - 文档中的启动契约
+- **不在范围**
+  - live database integration
+  - 新工作台能力
+  - GUI 化改造
+- **输入文档**
+  - `apps/tui/README.md`
+  - `TUI_ACCEPTANCE_CHECKLIST.md`
+  - `TUI_TEST_STRATEGY.md`
+- **交付物**
+  - 明确的非交互行为定义
+  - 相关实现或文档修正
+  - QA 可重复执行的 smoke 步骤
+- **验收标准**
+  - 非 TTY 启动不再只返回底层设备错误
+  - QA / CI 能明确判断“环境不满足”还是“程序异常”
+  - shell baseline 的交互式能力不被破坏
+- **依赖**
+  - 当前 `apps/tui` shell baseline
+
+### 5. QA：TUI shell 签收收口
+
+- **建议 owner**：QA Engineer
+- **目标**：把当前 TUI shell baseline 从“已有实现”推进到“有明确签收状态”
+- **范围**
+  - 六区布局
+  - 焦点切换
+  - 顶部视图切换
+  - Ready / Loading / Error
+  - resize 降级
+  - 非交互 smoke 契约联动复核
+- **不在范围**
+  - live 数据库连接
+  - query/export 真实后端执行
+- **输入文档**
+  - `apps/tui/README.md`
+  - `TUI_ACCEPTANCE_CHECKLIST.md`
+  - `TUI_REGRESSION_CHECKLIST.md`
+- **交付物**
+  - 更新后的 TUI 验收与回归文档
+  - “已签收 / 未签收 / blocker” 的明确结论
+- **验收标准**
+  - `CMP-27` 所代表的 shell baseline 有最终签收判断
+  - shell 验收与未来 live integration 验收被明确拆开
+
+## Sequencing
+
+1. QA：CLI 剩余负路径证据补齐
+2. Release：跨平台 artifact 证据补齐
+3. CTO：CLI 文档与 checklist 一致性收口
+4. Frontend：TUI 非交互 smoke 与启动契约定义
+5. QA：TUI shell 签收收口
+
+## Team Boundaries
+
+- **Backend / Release**：守住 CLI 主功能与产物证据，不扩 scope
+- **Frontend**：只处理 TUI shell 契约与交互层，不引入 driver，不解析 CLI 文本
+- **QA**：把“写过文档”推进到“有证据能关闭”
+- **CTO**：排序、收口、去歧义，不亲自替团队长期实现
+
+## Hiring Judgment
+
+- 当前不建议启动招聘。
+- 若后续真实阻塞持续集中在 CI / release 基础设施而非产品实现，再考虑平台型支持，而不是盲目扩前后端人头。