镜像架构原则实践: BS-drift-W-3 (AI 节点数自由生成) 不可强约束, 硬编码角色/节点数会引入维护负担 + 漏业务专属角色 + 跨语言失败. 采用 '复用规则文字 + 引用 web 源码行号' 的务实镜像策略: 镜像源: web/packages/jnpf/plugins/jnpf-bpmn/lib/utils/bpmnLintUtil.ts 镜像 4 规则: - 规则 1 (line 73): 必须有 start + end + approver - 规则 2 (line 84): 只能有 1 个 start - 规则 3 (line 106): 只能有 1 个 end - 规则 5 (line 130+): parallel/inclusive 网关必须成对 (偶数个) 规则 4 (edges 进出线) 跳过: dacli parseFlowXml 不解析 sequenceFlow 边 (web _webapi_helpers.ts:215 注释). 未来 v0.22+ 用 webapi loader 整个 import bpmnLintUtil.ts (含边校验), 需先用 shim 把 flowNodes 转 ElementRegistry-like 结构. 5 类漂移全部 RESOLVED: - BS-drift-M-1/2, BS-drift-W-1/2/4 (Round 5) - BS-drift-W-3 (Round 6 镜像修复) ✓ NEW vitest: 62/62 PASS (22 menu + 31 workflow drift + 9 validator 单元测试), 419ms 改动: - workflow/_webapi_helpers.ts: 加 validateFlowNodeStructure (镜像 4 规则) - workflow/create.ts: step 4/6 调用 mirror validator - tests/integration/drift/workflow-validator.spec.ts (NEW): 9 单元测试 - tests/integration/drift/workflow-drift.spec.ts: BS-W-3 切到 RESOLVED via mirror - docs/drift/2026-07-14-round6-w3-mirror-summary.md (NEW): 完整总结
dacli Drift Detection Loop
目的:用 JNPF baseline(developSystem + workSystem)当 oracle,通过 /loop TDD 模式检测 dacli 重建行为漂移。
工作流概览(5 个环节)
Phase 1: 脚本直读 JNPF DB → /tmp/dacli-loop/baseline-{ts}.json
Phase 2: AI 推理描述(oracle JSON → 业务描述字符串)
Phase 3: AI 用 dacli <module> create --ai "<描述>" 重建(仅 testspace)
Phase 4: AI diff(baseline vs 新生成)
Phase 5: AI 写测试 + 写本轮 summary
详见 /home/ubuntu/.claude/plans/abstract-churning-adleman.md(完整设计)。
覆盖模块(8 个)
| 模块 | baseline 表 | 重建命令 | 测试文件 |
|---|---|---|---|
| form | base_visual_dev |
dacli form create --ai "<描述>" |
dacli/tests/integration/drift/form-drift.spec.ts |
| workflow | base_workflow_template |
dacli workflow create --ai "<描述>" |
dacli/tests/integration/drift/workflow-drift.spec.ts |
| di | base_data_interface |
dacli di create --ai "<描述>" |
dacli/tests/integration/drift/di-drift.spec.ts |
| menu | base_menu |
dacli menu create --formId=<id> --ai "<描述>" |
dacli/tests/integration/drift/menu-drift.spec.ts |
| dict | base_dict_type + base_dict_data |
dacli dict typeCreate --ai "<描述>" |
dacli/tests/integration/drift/dict-drift.spec.ts |
| role | base_role |
dacli role create --ai "<描述>" |
dacli/tests/integration/drift/role-drift.spec.ts |
| report | base_visual_report |
dacli report create --ai "<描述>" |
dacli/tests/integration/drift/report-drift.spec.ts |
| datascreen | blade_visual |
dacli bigscreen construct --ai "<描述>" |
dacli/tests/integration/drift/datascreen-drift.spec.ts |
关键约束
- Loop 不改 dacli 业务代码:loop 只产出测试 + summary
- 所有文档归本目录:
{YYYY-MM-DD}-summary.md(每轮一份) - 测试归
dacli/tests/integration/drift/:每个漂移类别 1 个 vitest case(durable 资产) - /loop 用 Claude Code 平台自带:不包装自定义 skill
文件索引
每轮总结(按时间倒序)
- (暂无,第一轮 loop 跑完后生成)
历史归档
(按月份归档总结)
Polishing 触发流程
读最新 {date}-summary.md → 看到待修漂移类别 → 开修复会话:
# 1. 看当前漂移状态
cat dacli/docs/drift/$(date +%Y-%m-%d)-summary.md
# 2. 跑相关测试(vitest 失败信息是修复入口)
cd $ccWorkDir/dacli && npx vitest run tests/integration/drift/{module}-drift.spec.ts
# 3. 读失败信息 → 改 dacli → 跑通 → 标 [x] → 提交
# commit: "fix: {category} drift (BS-新X)"
/loop 启动模板
在 Claude Code 会话里:
# Round 1 (form 模块):
/loop 30m "1. 跑 fetch-baseline.sh 拿 form baseline → /tmp/dacli-loop/baseline-{ts}.json
2. 读 JSON,推理 form 描述(enCode + fullName + 字段 label)
3. 在 testspace 跑 'dacli form create --ai \"<描述>\" --autoRelease'
4. diff baseline vs 重建结果,按字段分类 missing/extra/changed
5. 写 vitest 到 dacli/tests/integration/drift/form-drift.spec.ts
6. 写 summary 到 dacli/docs/drift/{date}-summary.md"
Round 1 启动 Checklist
- DB 连接配置(
~/.dacli-token/db-config.env,PG_CONN 指向 JNPF 业务库) - JNPF 平台 DB 表名确认(
base_visual_dev等) - testspace 应用可用(
dacli app switch --appCode=testspace) - 跑 fetch-baseline.sh → JSON 含 21+53=74 张 form
- AI 跑完整 Phase 2-5 → 测试 PASS + summary 写好
- Round 1 commit: "Round 1: drift loop 初始化 + form 模块 N 份漂移测试"
注意事项
- JNPF DB 表结构:跟 JNPF 版本耦合,升级后表名/字段可能变,需更新 SQL
- testspace 隔离:重建只在 testspace,不污染 developSystem/workSystem baseline
- commit 节奏:每轮 /loop 一 commit(CLAUDE.md §14)
- NCPF 不确定性:
--ai走 NCPF backend LLM,行为可能波动,必要时多跑几次取一致结果
相关文档
/home/ubuntu/.claude/plans/abstract-churning-adleman.md— 完整设计(plan)dacli/.claude/skills/dacli-ts/SKILL.md— dacli 主 skill(loop 入口索引)dacli/.claude/skills/dacli-ts/references/baseline/README.md— 现有 baseline 复刻体系(与 drift loop 互补)dacli/.claude/skills/dacli-ts/examples/baseline/all.sh— 现有 baseline 复刻脚本(参考模式)