ssw
ce3ee63bd5
refactor(dacli): ADR-0018 移除 app init --auto-recover flag, 改为 create-if-missing 默认行为
...
init 的语义就是'让 app 处于可用状态', system 缺失时唯一合理动作就是 create.
旧 --auto-recover flag 让用户做'恢复 vs 不恢复'是伪决策, 'recover' 用词也误导
(实际场景是干净缺失, 就是 create, 不是恢复旧残骸).
变更:
- src/commands/app/init.ts: 删 --auto-recover option + 分支, 直接调 create
runAutoRecover → runCreateAppIfMissing (语义更准确)
- src/commands/app/{_check_system,context,login}.ts: 3 处 hint 文案统一
- src/core/_health_check.ts: hint 文案统一
- docs/尚数网基本开发规范v3.0.md: 2 处示例更新
- docs/decisions/0018-app-init-no-recover-flag.md: ADR 完整记录决策理由
验证: npx tsx src/cli.ts app init --help 不再含 --auto-recover;
tsc --noEmit 通过; app init --appCode=testspace 实跑正常
⚠ 破坏性变更: 仍在用 --auto-recover 的脚本会报 'unknown option'
缓解: 历史 M2 重启脚本是手动跑, 影响可控; v3.x changelog 待补
2026-07-30 09:29:54 +08:00
ssw and Claude
60f0221561
docs(dacli): ADR 0017 smartProps unification + BS-新141 (AP-fc-9/AP-fu-4)
...
ADR 0017 (新文件):
- 根因 #2 (AI Login expired): NCPF/SSW 后端 LLM token 失效, dacli 端不可修
- 检测 isLoginExpired(msg) → 跳过 SSW fallback (避免 5s/10s/20s 浪费)
- 修复路径必须不依赖 AI: 启发式兜底 + 接受手工 JSON
- 改进 1: smartProps 抽离 SMART_PROPS public API
- 改进 2 (P0): form update --fields 集成 SMART_PROPS, AI 失败 tolerant (try/catch)
- 改进 3 (P0): applyHeuristicDictType 新启发式 (不依赖 AI, 100% 确定)
- 改进 4 (P2): applyHeuristicRelationForm 扩展 select → relationForm
- 实施: e04bcb3 (auto session end) + eca3885 (BS-新141 + 9 tests)
- 验证: typecheck 0 错 / 67 test files / 574 tests 全绿
_anti_patterns.ts 新增 2 条:
- AP-fc-9 (P0, BS-新141): --ai 只决定 jnpfKey, 不绑具体 id (dictType/modelId/
relationField 永远空, 跟 prompt 是否含 enCode 无关). 修复走 SMART_PROPS
启发式兜底 + 手工 JSON 补
- AP-fu-4 (P0, BS-新141): 之前 form update --fields 不集成 smartProps,
用户被迫手工写完整 schema. v2.5+ 默认 ON, --no-smart-props 关. AI
Login expired 不阻塞, 启发式兜底
cross-refs: BS-新131/132/133/141 + decisions/0017 + decisions/0002
来源: jxcj M2 2026-07-23 实战 + 验证实验 jxcjrelationtest/jxcjdicttest/
jxcjditest (849912141677856005/849913609722004741/849914591969281285)
Co-Authored-By: Claude <[email protected] >
2026-07-28 21:02:33 +08:00
ssw and Claude
c2861c053d
docs: design webapi contract hardening
...
Co-Authored-By: Claude <[email protected] >
2026-07-28 14:43:34 +08:00
ssw
42a9958e18
auto(14b5ea1b9bd9): session end @ 2026-07-27T17:13:29 (+1f)
2026-07-27 17:13:30 +08:00
ssw
206f1fd86c
auto(14b5ea1b9bd9): session end @ 2026-07-27T16:31:03 (+4f)
2026-07-27 16:31:03 +08:00
ssw and Claude
3f1cb3a03b
feat(dacli): JNPF7 验证闭环 Stage 0 + P0-6 preview + workflow canvas 回归修复
...
Stage 0 (验证基础设施):
- 5 层验证工具链 (tools/) + JSON Schema + validate-baseline.sh CI gate
- P0-9: components-whitelist.yaml 单一来源 + parseFlowXml 消漂移 (create.ts tag 改消费 component-map.json)
- E-2: docs/components.md 文档化 6 个 pass-through 组件
- P1-16: validate-baseline 接入 quality-gate.sh
- L3 回归测试 (bs117 / bpmn-bs / antipattern-output) + mock LLM 库
P0-6 (user-in-the-loop):
- form create --ai --preview: 提交前渲染字段表格 (CJK 对齐) + TTY 交互确认 (_preview.ts)
workflow canvas 回归修复 (v0.22+ SSW 迁移引入):
- parseFlowXml 命名空间无关 (flowNodes 缺口)
- _autoLayout 无 DI 时合成完整 BPMNDiagram+Shape+Edge + bpmn2 归一化 (canvas 缺口)
- 真实后端 + 浏览器设计器验证画布渲染; 详见 jnpf7-analysis §14
quality-gate 全绿: tsc 0 · vitest 483 · doc:check · baseline L1-L5
Co-Authored-By: Claude <[email protected] >
2026-07-27 12:49:44 +08:00
ssw
e2a8369490
v0.22+ (2026-07-25) P1-5 + BS-新43 闭环 + NCPF 全面清理
...
[pre-existing vitest failures: 5 drift 检测 (BS-drift-F-5), 与本会话改动无关, 不阻塞提交]
形式:
- 9 个修复 (P0-1/2/3, P1-4/6/7/5, P2-8/9)
- 整合 NCPF 时代 band-aid: callNcpfBackendWithRetry / callSswAiRepair / callSswAiWorkflowRepair
- NCPF 引用 53 → 0 (仅 README 1 行历史叫法)
- form/workflow --ai 单一 SSW 路径 (callSswBuildForm + callSswBuildWorkflow)
- 删 dead code -226 行
新增 (10 untracked):
- tests/unit/ai_ssw_build_form.test.ts (4 测试)
- tests/unit/output_filter_stderr.test.ts
- tests/unit/relationform_auto_tdd3.test.ts
- tests/unit/role_assign_p0_1.test.ts
- tests/unit/role_list_null_data.test.ts
- tests/unit/test_browser_appcode_default.test.ts
- tests/unit/user_create_password.test.ts
- src/commands/form/_relationform_completeness.ts
- docs/decisions/0017-tdd2-end-to-end-findings.md
- docs/dacli-hardening-2026-07-25-tdd2.md
修改:
- src/commands/form/_ai.ts (-226 行 dead code, +180 行简化)
- src/commands/form/create.ts (12 处 NCPF 描述清理)
- src/commands/_post_reminders.ts / _ssw_retry.ts (1-2 处 NCPF 清理)
- src/commands/app/status.ts (3 处 NCPF 清理)
- src/commands/form/{_form_repair,_validate,_smart_props}.ts (各 1-2 处清理)
- README.md 5 大铁律 §2 + 架构核心 + 高频命令 + 命名规范 4 处描述更新
- docs/尚数网基本开发规范v3.0.md (1 处 NCPF 清理)
2026-07-26 10:04:16 +08:00
ssw
d322fcca32
auto(14b5ea1b9bd9): session end @ 2026-07-25T20:49:24 (+1f)
2026-07-25 20:49:26 +08:00
ssw
53874e7617
auto(14b5ea1b9bd9): session end @ 2026-07-25T10:34:06 (+1f)
2026-07-25 10:34:07 +08:00
ssw
955a3780a6
fix(docs): 删 2 条历史遗留 docs 路径引用 (audit.ts + storage/list.ts)
...
跟进 df213fd 归档的剩余 2 条 drift findings:
- form/audit.ts: docs/dos/debug.md + TC_C_SOURCE_IMPORT.md (dos app 不存在)
- storage/list.ts: docs/dacli/2/dacli-conf-usage.md (路径从未存在)
保留 web + api 段, 仅删 stale ref 行。
验证: npm run doc:check → ✅ 0 drift (270 文件 / 215 命令 / 25 反模式)
2026-07-24 16:38:58 +08:00
ssw
df213fdfad
fix(dacli-docs): 修审计报告 14 项 + 加 CI 校验防再漂 (P0/P1/P2 全清)
...
审计报告 docs/dacli-doc-audit-report.md 14 项全部采纳:
P0 (3 项事实错误, 直接误导 AI 执行):
- ANTI_PATTERN F_→f_ 前缀 (form update --fields 实际是小写)
- ANTI_PATTERN AP-fc-4 vs AP-fu-1 矛盾 (统一指向 form import --autoTable)
- ANTI_PATTERN form info <enCode> 误导 (改为 <id>, 加 enCode 自动解析 fallback)
P1 (3 项文档漂移):
- CLAUDE.md "含 FK 时必用 --fields" → 实际已废弃, 删除 + form/create.ts Commander 加 DEPRECATED
- doc/get.ts 引用 Java DocCommand.java → 改指 TS _parser.ts
- AP-fd-1 "--cascade 必带" 过度约束 → 改为可选
P2 (2 项衔接断裂):
- Source 路径 web/.../ → web/apps/jnpf-web-apps-main/src/ (73 文件)
- test/run TC-B 前置提示 (需 menu 挂载)
附加 (CI script 抓出的 8 条额外路径 drift, 已就近修正):
- di/create|export|copy: DataInterfaceController.java 路径补 jnpf-java-boot/ + jnpf/base/controller/
- print/delete|update: PrintDevController.java 同上
- org/create: OrganizeController.java 路径 jnpf/controller/ → jnpf/permission/controller/
- form/codegen|audit: FormGenerator/FormGenerator.vue 加 /components/ + /src/ 前缀
- workflow/create: flowEngine + FlowProcess 加 views/onlineDev/ + components/ 前缀
- workflow/syncForm: FlowableProcessDesigner.vue 不存在 → 改指 Form.vue
- msg/notice*: notice.ts 不存在 → 改指 msgMonitor.ts
- bigscreen/delete|update: 双前缀 web/.../src/jnpf-web-datascreen-vue3/ → jnpf/前端/
- app/login: api/auth.ts → api/core/auth.ts
- apis/refresh|status|info: Java ApiService 路径 → TS 化指向
- test/render: sysData/formDesign 加 views/ 前缀
- form/create: formDesign/Form.vue 加 views/onlineDev/ 前缀
Task 1.6 收尾: 删 core/help.ts legacy (~85 行 dead code):
- AI_FLAGS / getMeta / maybeInterceptAiHelp / renderAiHelp
- installAiHelpHook alias / _aiMeta 副作用 / AiHelp type alias
新增 docs/doc-drift-findings-2026-07-24.md (2 条无法自动修复的 docs 路径, 待人工)
新增 scripts/check-doc-drift.ts (scripts/check-doc-drift.ts, 218 行):
- 4 类检查: 命令引用 / arg-opt 一致性 / source 路径 / ANTI_PATTERNS 命令引用
- 接入 npm run doc:check
- 验证: 修复前 21 处 drift → 修复后 2 处 (已归档)
测试: typecheck 0 errors, 387/387 tests pass, doc:check 报告 2 known issues
2026-07-24 16:33:31 +08:00
ssw and Claude
d52744d697
docs(decisions): add ADR 0016 app clear p1-2e scope ghost
...
Co-Authored-By: Claude <[email protected] >
2026-07-24 08:44:55 +08:00
ssw and Claude
cba74702f2
chore(docs): commit 上轮遗留文件 (归档指针 + 2 审计 + jxcj M2 字段修复脚本) (2026-07-23)
...
补提交上一轮 (commit 64fbb4a cmd-review/drift 归档 + 76c2937 broken ref reroute + b4dce30 auto-gen 撤回) 期间未落库的 4 个文件:
1. docs/cmd-review/README.md (30 行)
- 上轮归档逻辑产出物, 指向 archive/cmd-review-2026-07/, 给新会话 AI 引路
- 本应在 commit 64fbb4a (cmd-review 全归档) 一并提交, 但当时遗漏
- 含归档原因 / 当前权威 (dacli <cmd> --help) / 历史快照定位指引
2. docs/audit-2026-07-22.md (192 → 196 行, 顶部加 deprecate 头)
- macOS 上做的中立审计, 已知 3 条核心结论 (本机崩溃 / 硬编码路径 / B 关卡退化) 全部是环境错位误判
- 顶部加 ⚠️ 头, 指向 audit-2026-07-23-deep §更正声明 + §12 容器内实跑复核
- 仍成立部分: 硬编码 /home/ubuntu/...ccWorkDir (脆弱性), 双包管理器, wrapCommand 迁移不完整
3. docs/audit-2026-07-23-deep.md (292 行, 完整)
- 深度审计 (架构层), 容器内 'docker exec jnpf-all-in-one' 复跑后更正前一版 3 条误判
- 实测: tsc --noEmit 48 错 (src 内, 违反 README §232 铁律), vitest unit 20 失败 (集中在 blindspot_guards 漂移)
- 主结论修订: ssw-loop 在 intended 环境里 '能驱动开发' (int 撤回初版 '仪式化' 措辞)
- 但真正结构性盲点: 整套质量体系不跑 tsc/vitest → 48 类型错 + 20 失败与全绿关卡并存
- 修订后 5 件优先事: (1) 补 tsc+vitest 进回路 (2) 修 48 src 类型错 (3) 修 blindspot 漂移 (4) 抽 getCcWorkDir() (5) 统一包管理器
4. docs/web-patches/jxcj-m2-field-fix.py (227 行)
- jxcj M2 form schema 字段修正脚本 (webapi PUT fallback)
- 背景: dacli form create --ai 重命名字段 + 丢失 dictType + 误判 userSelect, form update --fields 间歇报 'System abnormality'
- 走 Python PUT 直接调 JNPF webapi 兜底修复 (跟 DACLI 数据建模路径平行)
- 配套 web-patches/README.md 当前 Patches 状态表 (只列 .md, py 脚本独立)
- 注: 该脚本不属于 jnpf/boot 基线改动, 是 dacli 之外的应用级修复脚本, 按 web-patches 规则不入归档
触发: 用户要求 '提交' untracked 3 文件, 顺手补 cmd-review/README.md 上轮遗漏.
Co-Authored-By: Claude <[email protected] >
2026-07-23 15:58:49 +08:00
ssw and Claude
b4dce306a0
revert: 删除 auto-gen anti-patterns.md 链路 (_anti_patterns.ts 保留给 --help Pitfalls) (2026-07-23)
...
撤回上一轮尝试 (commit 9e21fea 之前 '加 AP-* entry + 重生成 md' 意向未落 commit 但改了文件) 涉及的反模式 auto-gen 链路.
# 之前考虑
- _anti_patterns.ts 是 13 个命令 --help Pitfalls 段的 compile-time SSOT (installHelpHookWithPatterns → enrichHelp 自动注入)
- docs/anti-patterns.md 通过 gen-anti-patterns-md.sh 从 ts 生成, 用于人类/外部 AI 读
# 撤回原因
- 重生成时 4 个手动加的内容被覆盖丢失: AP-cross-business-info-leak + AP-cross-smartprops-missing-update + BS-新132 修订 + BS-新133 修订
- 根因: AntiPattern schema (1 行 wrong / 1-2 行 right / 1-2 句 rationale) 信息密度太低, 装不下 'mitigation 多步骤 + BS 修订 + jxcj M2 验证实验数据'
- 强行加进去违反 schema 精神, 不加进去就丢内容
- 两难说明: ts→md auto-gen 对反模式这种文档不合适 (schema 跟实际信息密度不匹配)
# 此 commit
1. 删除 docs/anti-patterns.md (304 行, 人类阅读目的)
2. 删除 scripts/gen-anti-patterns-md.sh (49 行, generator)
3. 删除 scripts/extract_anti_patterns.ts (20 行, extractor)
4. _anti_patterns.ts: 文件头注释 '由 TS 自动生成 md' → 'compile-time SSOT, 不再 auto-gen md'
5. ANTI_PATTERNS 撤回到 253 行纯净版 (撤上一轮加的 'form codegen' + 'cross' CommandKey + 3 个 entry)
# 保留
- _anti_patterns.ts 本身保留 (installHelpHookWithPatterns 仍依赖 enrichHelp 注入 AP-* 给 --help 输出)
- 实测: 'dacli form create --help' 仍输出 'Pitfalls (踩过的坑):' 段
- 13 个命令 (form create/info/update/delete, di create, app context, test run, workflow create, menu create, dm create, dict typeCreate) --help 仍自动含 AP-* 反模式
# 后续
- 4 个丢失内容 (AP-cross-business-info-leak + AP-cross-smartprops-missing-update + BS-新132/133 修订) 暂未沉淀, 后续如需可入 docs/{app}/jxcj/learnings.md (应用特定) 或 ssw-loop SKILL.md (通用元规则)
- 反模式新内容优先入 _anti_patterns.ts 走 --help 自动路径 (machine-readable 优势)
Co-Authored-By: Claude <[email protected] >
2026-07-23 15:37:40 +08:00
ssw
0bb32d5ae2
auto(14b5ea1b9bd9): session end @ 2026-07-23T15:04:41 (+10f)
2026-07-23 15:04:41 +08:00
ssw and Claude
64fbb4ac0a
docs: archive cmd-review 25 + drift round 20 (2026-07-23)
...
清理 help 体系干扰/过期信息, 整体归档:
1. cmd-review/ 25 文件 → archive/cmd-review-2026-07/
- 22 个 2026-06-30 一波生成的命令审计
- 1 个 bigscreen-components (2026-07-01)
- 1 个 bigscreen (2026-07-01)
- 1 个 app (2026-07-01)
- 含 form/dm/menu M2 实战更新版 (建议已落地, 整体降级归档)
- cmd-review/ 留 README.md 指针
2. drift/ 20 个 round summary → archive/drift-rounds-2026-07/
- round 3-4/5/6/7/7b/8/9/10/11/12/13/14/15/16/17 + day summary
- drift/ 保留 README/USAGE/fetch-baseline.sh 基础设施
- drift/README.md 加 ⚠️ 头
3. 改引用:
- dacli/README.md §必读文档 改指 archive
- 7 个 ADR (0001-0004/0011/0013/0015) 顶部加 ⚠️ 头说明引用路径已迁
- archive/README.md 加 cmd-review-2026-07/ + drift-rounds-2026-07/ 段, 更新结构图, 更新 AI 误读防御清单
新权威源:
- 命令用法 → 'dacli <cmd> --help' (DacliHelp 注入 pitfalls/bestPractices/decisionTree)
- 决策理由 → docs/decisions/0001-0016 ADR (git-tracked, 权威)
- 反模式 → docs/anti-patterns.md (auto-gen, _anti_patterns.ts 为单一权威)
触发: 用户反馈 'dacli help 体系感觉很多干扰/过期信息, 看看怎么处理'
+ 'cmd-review 22 + drift 13 round 意义不大, 也可归档'
Co-Authored-By: Claude <[email protected] >
2026-07-23 15:04:18 +08:00
ssw
41cc72a309
auto(14b5ea1b9bd9): session end @ 2026-07-23T10:49:11 (+1f)
2026-07-23 10:49:11 +08:00
ssw
571737ccaa
auto(14b5ea1b9bd9): session end @ 2026-07-23T09:50:13 (+1f)
2026-07-23 09:50:15 +08:00
ssw
15d39451c3
auto(14b5ea1b9bd9): session end @ 2026-07-22T21:25:12 (+1f)
2026-07-22 21:25:12 +08:00
ssw and Claude
fa605579f3
test: cover eventhub blocker fixes
...
Co-Authored-By: Claude <[email protected] >
2026-07-22 16:51:06 +08:00
ssw
c584e9f4c1
auto(14b5ea1b9bd9): session end @ 2026-07-21T21:53:43 (+1f)
2026-07-21 21:53:43 +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
715fcb9a59
feat(dacli): P3 全量 18 _validate.ts → ValidationError 一源
...
每个 per-module _validate.ts 之前都自己 declare `export interface
ValidationError { field?, message, code? }` (跟 _error_codes.ts 完全一致),
导致跟 _error_codes.ts 定义漂移 (有的加 step/stepName, 有的加 docstring,
字段含义略不同但定义都一样).
这次统一 18 文件 import { ValidationError } from '../_error_codes.ts',
让所有 step machine 输出格式 + aggregate 跨模块一致.
机械改造:
- 18 文件: 删本地 export interface ValidationError block
- 加 `import { ValidationError } from '../_error_codes.ts'`
- 5 个文件 (dict/form/menu/role/workflow) import 因 docstring 在前, 落
在 interface 之后, 第二次 fix-up 移到 import 块首
- 总变更: 18 insertions, 131 deletions (净减 113 行, 重复 definition 没了)
验证:
- TS compile: 56 errors baseline 不变, 0 新错误
- 65/65 单元测试 (output_filter/auto_fix/report_wired 3 文件)
- blindspot_guards 12 个测试失败 (跑 `git stash` 验证: 是 pre-existing
baseline 问题, 不是本次引入)
- dacli datasource create 端到端 validation 错误格式不变
附带: docs/cmd-review/scan-2026-07-21.md 8 维度扫描报告 (含 ADR 0015
没列的 4 项新发现: workflow shim / console.log 范围扩大 / form/create 13
process.exit / DacliError 实际无重复).
2026-07-21 17:20:55 +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
a104101a8a
feat(dacli): info 类接 CommandLog + README 路径速查更新 + drift 日志归档
...
src/commands/form/info.ts: --json 特殊语义 (BS-新1 解码 formData escaped) 用手动 .option(--verbose) 避开 addOutputOptions 重复 --json 注册
src/commands/dict/datalist.ts: try/catch/finally + CommandLog L3
src/commands/dm/{list,fields}.ts: 同模式
README.md: 路径速查表加 datasource/storage/integration/report + G-X1 workflow 扩展提示 (2026-07-21 nginx 尾 slash 调整后)
docs/drift/2026-07-20-d0720-jxcj.md: jxcj drift 日志归档
tests/unit/defhttp_shim_envelope.test.ts (新): defhttp shim envelope 单元测试
2026-07-21 13:00:16 +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
ssw and Claude
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
ec10f7ddfc
auto(bfc0cfa2c3a4): session end @ 2026-07-20T08:58:21 (+1f)
2026-07-20 08:58:21 +08:00
ssw
5a8cbca732
chore(.claude): archive dacli-ts + jnpf-browser-automation skills, clean CLAUDE.md references
2026-07-17 13:26:49 +08:00
ssw and Claude
fc2282f259
chore: remove all dacli-ts references, rename to dacli
...
Co-Authored-By: Claude <[email protected] >
2026-07-17 12:20:48 +08:00
ssw
60432caef2
feat(dacli): add gen-anti-patterns-md.sh + first auto-generated anti-patterns markdown
...
- scripts/extract_anti_patterns.ts: extracts ANTI_PATTERNS from _anti_patterns.ts to stdout
- scripts/gen-anti-patterns-md.sh: bash wrapper with --check mode for CI
- docs/anti-patterns.md: auto-generated from 25 entries across 11 commands
2026-07-17 12:03:07 +08:00
ssw
79447386ad
docs(dacli): create decisions/ directory + 9 ADR documents (0001-0009)
2026-07-17 11:59:47 +08:00
ssw and Claude
9e21fea692
feat(form): R17 P1 启发式扩展 — AI 4 限制闭环 (jxcj M1 实战驱动)
...
P1-1 vm-to-jnpfKey 启发式 (form/_form_repair.ts):
- 新增 VM_RULES 6 条 + mapVmToJnpfKey 函数
- 优先级: vm 启发式 > label 启发式 (客观 > 主观)
- 修 AI 控件类型错选:
- datetime + timePicker → datePicker (jxcj f_start_time)
- text + 富文本 label → editor (jxcj f_introduction)
- int + dict + 状态字段 → radio (jxcj f_state)
- int + 数字字段名 → inputNumber
- decimal → inputNumber
- varchar(>500) + 长文本 → textarea
P1-2 upload 控件不标 required (form/_smart_props.ts):
- 新增 SKIP_REQUIRED_JNPFKEYS 白名单 (12 jnpfKey)
- 白名单: uploadImg/uploadFile/editor/relationForm/popupTable/
popupSelect/autoComplete/sign/rate/colorPicker/link/iframe
- 即使 label 含"必" 也不标 required (jxcj f_wechat_qrcode 修复)
- 返回值加 skipped 字段 (log 跳过计数)
P1-3 category 关键词匹配 (form/create.ts):
- autoDeriveCategoryFromBusinessType 优先用 appCode + formName 关键词
- 例: jxcj + "数据要素" / "大赛" → 找 businessType 字典匹配
- fallback: AI 推理 → items[0]
- 解决跨 appCode 默认"车辆管理" 问题
vitest (tests/integration/drift/round17-fix-batch5.spec.ts):
- 13 fixture 全部 PASS (P0 wire-up + P1-1/2/3 + TS 编译基线)
- 累计 vitest: 70 → 83 (+13)
drift (docs/drift/2026-07-15-round17-plan.md):
- R17 全部完成 (P0+P1+P2 部分)
- 累计 21 项修复, AI 4 限制闭环
验证:
- TS compile: 49 errors (baseline) == 49 errors after (0 新错) ✅
- jxcj M1 对照: f_competition_id (R17 P0) / f_start_time (R17 P1-1) /
f_wechat_qrcode (R17 P1-2) / category 默认"车辆管理" (R17 P1-3) 全部修复
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <[email protected] >
2026-07-15 16:41:09 +08:00
ssw and Claude
6d785ce9b0
fix(form): wire up autoDetectAndInjectRelationForm (BS-新117 R17 P0)
...
历史 (2026-07-15 jxcj M1 复盘):
- form/_relationForm_auto.ts:144 函数定义但 0 import/call
- form/create.ts:59 relationFormAuto 选项声明 + --no-relation-form-auto flag
- 文档声称"默认 ON 自动注入"实际未生效
- jxcj topicDirection.f_competition_id 应是 relationForm 但生成 input
修复:
- form/create.ts:295 在 --ai 路径 webBuildFormData 之前
- 真正调 autoDetectAndInjectRelationForm(aiModelListForBfd)
- 默认 ON (除非 --no-relation-form-auto)
- TS cast 解决 strict mode type 不匹配 (aiModelList 含 billRule/unique 等 extra fields)
验证:
- TS compile: 49 errors (baseline) == 49 errors after (0 新错)
- jxcj M1 实战对照: 之前 f_competition_id 是 input, R17+ 应是 relationForm
drift/docs/drift/2026-07-15-round17-plan.md:
- R17 P0 完成 (本 commit)
- R17 P1 待: vm-to-jnpfKey 启发式 + upload 控件不标 required
- R17 P2 待: NCPF backend LLM 修复 (跨团队)
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <[email protected] >
2026-07-15 16:35:03 +08:00
ssw
3e279325f3
feat(dacli): R16 in-process FormRepair (TS 镜像 ssw, 替代 HTTP)
...
- 新增 dacli/src/commands/form/_form_repair.ts (137 行):
- mapLabelToJnpfKey: 18 条 label→jnpfKey 启发式 (镜像 ssw FormRepairServiceImpl)
- repairFormDataFields: type_drift 修复 + F_ 前缀还原
- repairFormDataFromString: JSON string 接口对齐 ssw endpoint
- form/create.ts: 删 R14 HTTP fetch (auth blocked by JNPF Sa-Token),
改 in-process repairFormDataFromString 调用
- 镜像架构: ssw-common (Java) 是权威, dacli (TS) 是镜像,
同步维护; 加新规则时两边一起改
- 新增 vitest:
- tests/integration/drift/round15-fix-batch4.spec.ts (18 tests)
- tests/unit/workflow/create_stale_retry.test.ts (3 tests)
- 累计 70 vitest 全部 PASS, TS 编译 0 新错
R15 验证: form type_drift 5→0, column_drift 58→0 预期 (R17 重跑验证)
2026-07-15 15:45:20 +08:00
ssw
ff594c6779
docs(dacli): R15 vs R14 summary + ssw FormRepair auth blocked finding
2026-07-15 13:42:57 +08:00
ssw
259580b240
fix(dacli): R14 BS-新44/52/41/43b/45 drift fixes + 25 vitest
...
- BS-新44 (P0): di/_lookup.ts 用 getDataInterfaceSelector 优先 + category iterate fallback (collectDiCategories)
- BS-新52 (P1): fullName autoStrip helper 加 _encode_validator.ts, 4 caller 集成 (form/dict/workflow/menu)
- BS-新41 (P1): menu type=9 moduleId 注入 (isFormMenuType = [3,4,9,11])
- BS-新43b (P2): workflow stale pre-validate cleanup + retry ONCE
- BS-新45 (R14): form/create.ts 调 ssw FormRepair /api/ssw/form/repair-fields post-create
- 25 vitest in tests/integration/drift/round13-fix-batch3.spec.ts
2026-07-15 12:12:44 +08:00
ssw and Claude
aee1a72c12
fix: Round 12 drift batch 2 (smartProps fallback + lookup helpers + workflow trivial detection)
...
Round 12 batch 1 修了 F1/F2/F6 + workflow ENCODE_REGEXP 去重, batch 2 闭环剩 3 项.
- BS-新41 (form smartProps fallback): 5/5 form required=false drift 因 NCPF 后端返
'Login expired' → source='none' → 0 字段填 → required 保持 web 默认 false.
加 applyHeuristicRequired(formData): label 含 */必 → required=true,
vmodel 末为 id/code/key/name/num/serial → 通常必填. create.ts 在 source='none'
时 fallback 跑启发式.
- BS-新42/43 (role/di lookup): role/di inline list-and-find 抽取到 _lookup.ts 跟
dict/menu 一致. lookupRoleIdByEnCode / lookupDataInterfaceIdByEnCode. 5/5 id=undefined
在 Round 13 应收敛.
- BS-新43 (workflow --ai trivial detection): NCPF backend /workflow/ai LLM prompt
缺节点规格, 5/5 都生 StartEvent→Task_1→EndEvent 3-node trivial, 业务流 4-10 节点
全丢. web 端 workflow API 没暴露 getAiInfo (探索发现注释是误导), 无法 webapi 化.
加客户端 detectTrivialFlowXml: 数 userTask 元素 <2 视为 trivial, 强 WARN 推荐
--flowXml 直传 baseline.
Tests: 38/38 PASS
- tests/integration/drift/round12-fix-batch2.spec.ts (10 tests, NEW)
- existing: round12-fix-batch1.spec.ts + round12-cross-module.spec.ts
Docs: docs/drift/2026-07-15-round12-fix-batch2.md
Co-Authored-By: Claude <[email protected] >
2026-07-15 10:34:37 +08:00
ssw and Claude
f840f2961a
fix: Round 12 drift batch 1 (enCode autoStrip + DI uniqueness + report cells)
...
Round 12 drift loop on ts2 (5 random baseline per module) surfaced:
- BS-新38: 5/8 modules fail BS-56 when --enCode='round12-foo' contains '-'.
Add autoStripEnCode() helper + apply at 7 create.ts action entries.
workflow/_validate.ts also de-dupes: import shared ENCODE_REGEXP+validateEnCode
instead of local copy (was 5th duplicate).
- BS-新39: 4/5 DI hit 'name cannot be repeated' (BS-47 EXIST002) at backend.
Root cause: di/create.ts:251 hardcoded category filter, step machine only
scans one category so cross-category enCode duplicates slipped through.
Fix: remove hardcoded filter, scan all DIs platform-wide. Better error msg.
- BS-新40: 5/5 report rebuild lost cells — baseline f_content 126k-466k chars
ureport XML replaced by default '{cells:[]}'' stub.
Fix: add --from-json-file option (mirrors di/create.ts pattern), reads full
baseline body and overrides required fields.
Tests: 28/28 PASS
- tests/integration/drift/round12-cross-module.spec.ts (Round 12 sweep)
- tests/integration/drift/round12-fix-batch1.spec.ts (batch 1 regression)
Docs: docs/drift/2026-07-15-round12-summary.md + ...-fix-batch1.md
Co-Authored-By: Claude <[email protected] >
2026-07-15 10:11:12 +08:00
ssw
72c7a3e05c
auto(bfc0cfa2c3a4): session end @ 2026-07-15T07:27:50 (+1f)
2026-07-15 07:27:50 +08:00
ssw
04e85a5433
docs: round 11 盲点固化总结 (6 类固化, 1 P0+3 P1+1 P0 后端+2 已知)
...
本轮触发: testspace drift loop 跑 5 form + 5 workflow 时, 端到端发现 6 类盲点
- BS-newPWD-1: user resetPwd 漏传 account + validatePassword (P0, 已修)
- BS-newAI-1: --ai 失败信息误导, BS-56 包装成 AI 失败 (P1, 已修)
- BS-newAI-2: SSW fallback 异常截断 60 字符, NPE 看不见 (P1, 已修)
- BS-newNCPF-1: NCPF 静默空响应直接 fallback SSW 太激进 (P2, 已修)
- BS-LLMNPE-1: SswLLMClient LLM 响应解析链式 NPE (P0 后端, 已修)
- BS-snapshot-1 / BS-jnpfLaunch-1: 已知不可修, 写进 known limitations
整体盲点统计 (Round 1-11): 32 类已固化或标记
2026-07-14 22:13:32 +08:00
ssw
ecd0e934e9
Round 10: 修 dict 3 类 + di 3 类漂移 (BS-drift-D-1/2/3 + DI-1/2/3 RESOLVED)
...
dacli 改动 (12 行):
- dacli di create 加 --fieldJson/--parameterJson/--dataConfigJson 3 选项
- 透传 baseline schema, 替代默认 '[]' / 空模板
测试闭环 (46 tests, 全部 PASS):
- dict-drift.spec.ts: 25 tests (5 dict 重建, items + parentId + category 100% 跟 baseline 一致)
- di-drift.spec.ts: 21 tests (5 di 重建, fieldJson + parameterJson + dataConfigJson 100% 跟 baseline 一致)
漂移数据 (5+5 重建, 21 items + 10 fields + 1 param + 5 configs):
- dict: PositionType(3) RoleType(3) EnterpriseNature(5) Education(8) OrganizeType(2)
- di: 3323/0001(zhenfenye/al)/bingtu - 3 种 type (SQL/API/static) 都验证
总测试: 250 → 263 PASS
2026-07-14 12:09:53 +08:00