ssw
|
aa21fc57ef
|
docs(ADR 0015): P4 v3 全量收口固化 + §4.1 经验教训段
新增 §4.1 'P4 v3 全量收口 (2026-07-21)' 详细段:
- 范围修正: scan 估算 ~330 处, 实际 25 文件 33+ 处真表格. 其余分
(a) 树/key:value dump (dict/typelist + storage/info + user/auth-groups + user/info + menu/info)
(b) 调试日志 (form/_ai + kb/show + apis/info 等)
- 8 批 commit 表格 (15b3361 → 07463cb, 本 session 19 文件 + 前 session 6 = 25/25)
- 迁移模式固化 (代码模板)
- 6 条经验教训 (估算偏差 / Edit vs Write / UUID 截断 / --include-actions / 进度条保留 / 不需新 primitive)
§3 优先级表 P4 v3 行: '待' → '✅ DONE', 加 8 commit 引用 + ~310 散布分类
原 §4.1-4.4 顺延 → §4.2-4.5 (P0 ROI / P1 紧跟 / P3 不放 P1 前 / P5-P6 风险).
验证:
- TS compile baseline 57 不变
- 73/73 vitest PASS
- P4 v3 全量收口闭环: 25/25 REAL_TABLE 文件
|
2026-07-21 18:48:56 +08:00 |
|
ssw
|
1fb4f0d208
|
docs(ADR 0015): 同步本 session 累计 (P5 全量 + P6 sample 续 + P4 v2)
|
2026-07-21 18:06:54 +08:00 |
|
ssw
|
b39024a7ae
|
docs(ADR 0015): 同步表 done 行 (补 P4a/P5 sample/P6 sample)
7 commits 累计 done:
- c637a58 P0 wrapCommand helper
- 715fcb9 P3 18 _validate.ts 统一
- 5ead157 P1 dm/drop TTY + shim 清理
- 22593df P4a + P6 sample
- 45e9f10 P5 sample
剩:
- P2 (2-3h) form/create + workflow/create + form/codegen 高严重度批量
- P4 v2 (1h+) console.log → log.printRawTable 新 primitive
- P5 全量 (2h) ~15 命令路径 throw → DacliError
- P6 大坑 (8+h) 350+ 裸 process.exit 跨多 session 治理
|
2026-07-21 17:47:21 +08:00 |
|
ssw
|
654ce3d2e6
|
docs(ADR 0015): 同步本 session 累计 done (P4a/P5 sample/P6 sample)
7 commits 累计 .:
- c637a58 P0 wrapCommand helper
- 715fcb9 P3 18 _validate.ts 统一
- 5ead157 P1 dm/drop TTY + shim 清理
- 22593df P4a + P6 sample
- 45e9f10 P5 sample
剩:
- P2 (2-3h 高严重度批量)
- P4 v2 (console.log → log.printRawTable 新 primitive)
- P5 全量 (~15 throw → DacliError)
- P6 大坑 (350+ 裸 process.exit 跨多 session 治理)
|
2026-07-21 17:47:04 +08:00 |
|
ssw
|
5ead157903
|
feat(dacli): P1 dm/drop TTY 拦截 + workflow shim 清理 (11 文件)
P1 (0.5h):
- dm/drop.ts 加 TTY 拦截 — 镜像 form/delete.ts:25 + print/delete.ts:46 +
report/delete.ts:39 已稳定的 pattern: `if (!opts.yes && process.stdin.isTTY)` 时
warn + exit 1; 非 TTY 模式 (CI/脚本) 静默 --yes 走即可. 同步 DOC 注释 + 移除 TODO.
- storage/info.ts:38 DacliError 分叉 — 验证**实际不存在** (`class DacliError`
仅 src/core/types.ts:57 一处定义, 已被 storage/_helpers.ts:21 正确 import).
ADR 0015 §2.2 早期记述有误, 修订清空.
shim 清理 (0.5h):
- 11 个 workflow 子命令 (approve/create/decision/delete/info/launch/list/
selector/syncForm/tasks/update) 把 `import { ... } from './_output.ts'`
改成 `from '../_output_filter.ts'` (1 行 sed × 11 文件).
- 删除 src/commands/workflow/_output.ts shim 文件 (D 掉), 减少 1 个间接层.
- 不影响 L1 输出过滤 / L3 CommandLog 落盘, 因接口签名不变.
验证:
- TS compile: 56 errors baseline 不变, 0 新错误
- 68/68 单元测试 PASS (含 tests/unit/workflow/create_stale_retry)
- 端到端: dacli dm drop --help + dacli workflow info --help 完整
|
2026-07-21 17:35:09 +08:00 |
|
ssw
|
72766bc629
|
docs(ADR 0015): mark P3 done (715fcb9 18 _validate.ts 统一 import)
|
2026-07-21 17:21:39 +08:00 |
|
ssw
|
a5c22b98d3
|
docs(0015): 源码 5 类遗留清单 (v2.2+ 实证 P0 已 done + P1-P6 待办)
基于 c637a58 wrapCommand 实证重建 (上次 86d9dac 因太早被 7cdc818 revert).
5 类遗留 (§2):
- §2.1 P0 printCommandEnd 5c 样板 ✅ DONE (c637a58)
- §2.2 P1 2 个已知 baseline 坑 (dm/drop + storage/info)
- §2.3 P2 25+ 高严重度文件批量
- §2.4 P3 18 个 _validate.ts 错误码 import 不一致
- §2.5 P4 addOutputOptions 已加但 stdout 风格不统一
- §2.6 P5 console.log + throw 统一 (4+h 大改)
- §2.7 P6 350+ 裸 process.exit 跨 session 治理 (大坑)
决策依据 (§4):
- P0 为什么 ROI 极高: 一行 helper = 30+ 行样板 + 单测 17 条已稳
- P1 紧跟: 独立 1 文件修改, 风险极低
- P3 不放 P1 前: 批量一致性调整 < 已知坑修复
- P5/P6 大坑单独排期
README §引用: ADR 索引 0001-0015 系列, 版本加 v2.2+ wrapCommand.
|
2026-07-21 17:05:31 +08:00 |
|
ssw
|
7cdc8187cc
|
Revert "docs(0015-source-leftovers): 源码 5 类遗留清单 + P0-P6 优先级路线"
This reverts commit 86d9dac83d.
|
2026-07-21 16:38:00 +08:00 |
|
ssw
|
86d9dac83d
|
docs(0015-source-leftovers): 源码 5 类遗留清单 + P0-P6 优先级路线
扫描方法: 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 专项治理
|
2026-07-21 16:25:37 +08:00 |
|
ssw
|
f7bc8d55d0
|
docs(0014-app-clear-docs-coverage): app clear docs 残留缺口决策记录
事实: docs/jxcj 实测 14 项残留 (8 MD + 4 子目录 + 设计说明)
不被清理, 历史 DOC_HTML_FILES 只清 4 html
根因: docs/dacli/ssw-dacli/.../ClearAppCommand.java 用 DOC_HTML_FILES 白名单
Dacli 也复用了同样限制, 漏了所有非 html 文件
修复 (P1-2d commit 60adaab): dacli 端加 --clean-docs flag (默认 false 保持向后兼容)
true: docs/{app}/ 整体打包成 FileTarget, 移到 history-bak/{ts}/files/docs/{app}/
false: 历史行为 + DRY-RUN 警告提示残留项数 + 提示 --clean-docs
决策依据:
- docs/{app}/ 是 ssw-loop 关卡 A/B/C 强依赖 (design/testcase/summary/learnings/plan/debug + _assets 6+ MD)
- 默认不改, 用户显式加 --clean-docs 才真清, history-bak 保留可还原
- 与 P0-3 (2026-07-15) DB fallback 同模式: --no-relation-form-auto / --autoRelease 等 flag
已知 ssw-common 端点 bug (留下游路线 §1):
- DbClearServiceImpl.listBizTables 走 openConn(appCode, null) 把 jxcj 当独立 db
- 但 jxcj 在 PG 共享库 j62 schema=jxcj, 不是独立 db
- 修复需要改 Java 5-10 处 + Maven 编译 + JNPF 重启 (Java 无 devtools auto-reload)
- 风险: testspace 当前活跃测试会中断
- 跨项目路线, 不在 dacli 端实现
下游路线 (ADR §Downstream):
1. ssw-common 端点改进 (跨项目, 高优)
2. dacli 端 fallback 查询 (P1, 中优)
3. ssw-loop 关卡 check_clear_coverage.sh (P2, 低优)
4. dacli app history 子命令 (P3, 远期)
E2E 验证 (testspace 默认应用):
- DRY-RUN --clean-docs 显示 [MOVE] docs/testspace/ 整体打包
- 业务库 preview 列出 72 张表 (testspace schema=public 正常工作)
- jxcj schema=public 不识别业务表 (符合 ADR §已知风险)
README 路径速查表加 "--clean-docs 行为" 行, 指向 0014-ADR
|
2026-07-21 15:47:19 +08:00 |
|
ssw
|
bbcdf9fab2
|
dacli: M2 实战固化 (jxcj 2026-07-20)
3 跨项目问题 + 修复 + 文档:
1. ADR 0011 — dm drop DB201 错误信息明确化
- 旧: 表有数据时报 DB201 "The table has already been used" 误导用户
- 新: catch DB201 输出修复指引 (TRUNCATE + ADR 0011 P1 待加 dm truncate 命令)
- 文件: src/commands/dm/drop.ts + docs/cmd-review/dm.md + docs/decisions/0011
2. ADR 0012 — form create --ai relationForm 软降级
- 旧: AI 生成 relationForm 缺三元组 (~40%) 触发 step machine 硬 FAIL
- 新: validateFormData 软降级 — 三元组不全时自动改 jnpfKey='input' + 警告 (而非硬错)
- 测试: 4/4 PASS (含缺 1/2/3 个三元组场景, 均软降级)
- 文件: src/commands/form/_validate.ts + docs/cmd-review/form.md + docs/decisions/0012
3. ADR 0013 — menu create CurrentUser 缓存阻塞
- 现象: menu create --formId 成功后 CurrentUser.menuList 不刷新, TC-B 阻塞
- 修复: P1 待加 menu cache clear + menu create 后自动 invalidate
- 兜底: test browser fallback 到 /jnpf_app_${appCode}/model/${formEnCode} 直接 URL
- 文件: docs/cmd-review/menu.md + docs/decisions/0013
jxcj M2 重启 (2026-07-20) 实战产出, 跨项目通用 (testspace/developSystem/workSystem/dos 等)
详见 docs/jxcj/summary.md + docs/jxcj/learnings.md 阶段 4 段
|
2026-07-20 18:02:38 +08:00 |
|
 sswandClaude
|
61405e128d
|
fix(dacli): resolve merge conflicts + add v2 architecture spec
- resolve 10 merge conflicts across 4 files (app/init, dict/typecreate, form/create, webapi/_defhttp)
- fix syntax errors in typecreate.ts (commented-out if block)
- add ADR-0010: dacli v2 self-correcting CLI architecture design
- add simulation test comparing v1 vs v2 behavior
Co-Authored-By: Claude <[email protected]>
|
2026-07-20 10:11:41 +08:00 |
|
ssw
|
79447386ad
|
docs(dacli): create decisions/ directory + 9 ADR documents (0001-0009)
|
2026-07-17 11:59:47 +08:00 |
|