扫描方法: Explore agent 全 codebase 扫描 dacli/src/commands/*.ts, 5 类规则 + 文件:行号. 5 大类遗留: 1. 裸 process.exit — 350+ 处 / 35+ 文件 (printCommandEnd L3 落盘被绕过) 2. console.log 残留 — 360 处 / 96 文件 (L1 stdout 三模式受影响) 3. throw new Error 未统一 DacliError — 37 处 (类型分叉风险) 4. TODO 注释 — 仅 3 处 (form/codegen --auto-menu + dm/drop TTY 拦截) 5. 重复 boilerplate: 5a addOutputOptions helper 覆盖不全 (38 文件手写 verbose/json) 5b per-module _validate.ts 18 处复制 ValidationError interface 5c printCommandEnd 失败收口样板 30+ 处重复, 无 helper 收口 (这是 P0 高 ROI) 5d history_bak backup name 字符串仅 app/clear.ts 单文件 6+ 处重复 优先级路线 (P0-P6, P0 最高价值 1 小时 + P1 0.5h 是 1 文件快修): - P0 (1h, 极高): wrapCommand(handler) helper 收口 5c - P1 (0.5h, 高): storage/info.ts:38 分叉修复 + dm/drop.ts TTY 拦截 - P2 (2-3h, 高): 大批量 printCommandEnd + try/catch 改造 (25+ 文件) - P3 (1h, 中): 18 _validate.ts 改 import ValidationError - P4 (1h, 中): addOutputOptions 38 文件迁移 - P5 (4+h, 中低): 360 console.log + 37 throw 统一 - P6 (大坑, 极高): 350+ process.exit 全量重构 (单 session 不可能, 留独立 ADR) 不做源码改造 (本 session 已收尾): - 已完成 6 commits (本 session) + 全部关键闭环 - 源码层遗留是 massive 后续工程, 强行做会引入更多问题 - 留 ADR 让后续 session 拿优先级列表直接挑目标 下游 hook: - 任一 P0-P4 完成时更新本 ADR 状态 (Superseded by 0016-...) 或新增 ADR - P6 350+ process.exit 太大坑, 留跨 session 专项治理
dacli Architecture Decision Records (ADR)
记录 dacli 关键设计选择的完整理由 + 替代方案 + 后果, 含来源 (drift round / BS 编号 / 实战 app)。
规则
- 每篇 ADR 标准结构 (见 template.md): Context / Decision / Alternatives / Consequences / Cross-refs
- 编号 4 位数, 顺序递增 (0001, 0002, ...)
- 不撤销旧 ADR; 改设计时新增 ADR 引用旧 ADR 并说明变化
- 不入 git 的临时调试日志不属于这里
索引
| 编号 | 标题 | 状态 |
|---|---|---|
| 0001 | FK 字段必显式 relationForm | Accepted |
| 0002 | form create --ai 4 限制 | Accepted |
| 0003 | form update 不同步物理表 | Accepted |
| 0004 | menu type=3 必传 moduleId | Accepted |
| 0005 | dict typeCreate 全平台唯一 | Accepted |
| 0006 | workflow 必传 startFormId | Accepted |
| 0007 | form --ai 不按依赖顺序 | Accepted |
| 0008 | test run 不自动注入 FK 数据 | Accepted |
| 0009 | 代码注释卫生规则 | Accepted |