Files
dacli/docs/drift
ssw 22dfeaae64 Round 7b: B方案 真镜像 web constructTreeUtil.ts (替换自写算法)
问题: Round 7 我用 C方案 自写了简化版 BFS 水平布局算法, 违反镜像架构原则.
      用户质疑 '你是自己写的布局, 还是用平台的源码', 要求真复用 web 源码.

B方案: 用 webapi loader 模式镜像 web 端 constructTreeUtil.ts (763 行):
  1. 读 web/.../jnpf-bpmn/lib/utils/constructTreeUtil.ts 源
  2. shim 处理 bpmn-js 依赖:
     - NodeUtils → 本地 stub (BPMNTreeBuilder 自身只用了 getNextElementList, 已剔除)
     - '../config' → hasGatewayType 等常量
     - '../config/constants' → DEFAULT_CONNECT, DEFAULT_DISTANCE
     - '../config/variableName' → bpmnStart, bpmnTask, typeConfluence 等
  3. 剔除 bpmn-js runtime-only methods (Node 跑不了 modeling API):
     - formatCanvas / formatCanvasHorizontal (要 modeling.moveElements)
     - getElementsByGateway (要 NodeUtils.getNextElementList)
     - getGroupElementById (要 bpmn.get('elementRegistry'))
  4. 写 tmp 文件, dynamic import, 单进程缓存

保留的 web 纯方法 (BPMNTreeBuilder):
  - constructTree() — 构建 BPMN 树
  - bpmnTraverseTreeBFS() — BFS 水平布局核心算法
  - calculateVirtualHeight() — 同层 y 错开 (按 parentData.height 计算)
  - handleCollisionsByLevel() — 横向碰撞检测
  - findStartElement/findNodeById/getOutgoingConnections

端到端对比 (vehicleRefuelApprovalDemoV3):
  C方案 (Round 7 自写): y 全部 200 (统一对齐), x 350px 等距
  B方案 (Round 7b 真镜像): y 按 web 算法智能对齐 (4 approver 在 272, start/end 在 300)
                           start 不变 (root), 子节点 x = parentX + 150 + childWidth

镜像架构审计:
  ✅ 复用 web 算法 (BPMNTreeBuilder) - 不自创
  ✅ 复用 web 算法 (BFS 水平布局 + 虚拟高度 + 碰撞检测)
  ✅ 复用 web XML 解析 (bpmn-moddle)
  ✅ 镜像源引用 web 行号

vitest: 70/70 PASS (4 文件, 包括 8 个 autoLayout 单元测试), 575ms

改动:
- webapi/bpmnTreeBuilder.ts (NEW, 145 行): webapi loader, shim + dynamic import
- workflow/_autoLayout.ts (REWRITE): 用镜像 BPMNTreeBuilder 替换自写 BFS
- workflow-autolayout.spec.ts: 3 节点测试改成 web 算法预期值
- docs/drift/2026-07-14-round7b-autolayout-mirror-summary.md (NEW)
2026-07-14 10:04:32 +08:00
..

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 份漂移测试"

注意事项

  1. JNPF DB 表结构:跟 JNPF 版本耦合,升级后表名/字段可能变,需更新 SQL
  2. testspace 隔离:重建只在 testspace,不污染 developSystem/workSystem baseline
  3. commit 节奏:每轮 /loop 一 commit(CLAUDE.md §14)
  4. 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 复刻脚本(参考模式)