Commit Graph
15 Commits
Author SHA1 Message Date
ssw 0bb32d5ae2 auto(14b5ea1b9bd9): session end @ 2026-07-23T15:04:41 (+10f) 2026-07-23 15:04:41 +08:00
sswandClaude fa605579f3 test: cover eventhub blocker fixes
Co-Authored-By: Claude <[email protected]>
2026-07-22 16:51:06 +08:00
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