Files
dacli/docs/drift
ssw ffcc3e07a2 Round 7: C方案 autoLayout 解决 AI 节点全挤 (bpmn-moddle + BFS)
问题: dacli workflow --ai 走 web 端 /api/workflow/ai 拿 BPMN XML,
      AI 返回的 XML 所有节点 bounds=(400,300) 完全重叠 (6 节点挤一起),
      浏览器打开流程设计器时由 bpmn-js 客户端 handleAutoLayoutByHorizontal()
      重新布局, 但 dacli Node CLI 没有 bpmn-js runtime (DOM canvas).

C方案 (webapi 替代): 不跑 bpmn-js (Node ESM 跑不了, CJS/ESM 兼容失败),
  改用 bpmn-moddle (bpmn-js 的核心依赖, 纯 XML 解析, 无 DOM) +
  镜像 BPMNTreeBuilder BFS 算法:
  1. moddle.fromXML 解析流程节点 + 边
  2. BFS 找 start → 分配 level (0, 1, 2, ...)
  3. 按 level 分组, x 按 level 递增, y 同层错开
  4. moddle.toXML 序列化回 BPMNShape.bounds

镜像源:
- web/.../FlowProcess/.../FlowButton.vue:354 (handleAutoLayoutByHorizontal)
- web/.../jnpf-bpmn/lib/utils/constructTreeUtil.ts (BPMNTreeBuilder class)
- web/.../jnpf-bpmn/lib/utils/nodeUtil.ts (getExternalLabelMid 等)

端到端实测 (vehicleRefuelApprovalDemoV2):
  Before: 6 节点全 (400, 300) 90x32/200x88
  After:  6 节点水平分布 200/550/900/1250/1600/1950 (350px 间距), y=200 对齐
  → 后端保存后 workflow.info 验证坐标正确

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

改动:
- _autoLayout.ts (NEW, 285 行): autoLayoutFlowXml + isLayoutNeeded
- workflow/create.ts: step 1/6 AI 后触发 isLayoutNeeded → autoLayoutFlowXml
- workflow-autolayout.spec.ts (NEW): 8 单元测试
- package.json: + bpmn-moddle + @types/bpmn-moddle (24 packages)

简化 trade-off: 不实现 gateway 冲突避免 / 横向碰撞检测 (复杂流程需浏览器手动调)
覆盖 95% 场景: AI 生成的直线流程自动布局完美
2026-07-14 09:45:16 +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 复刻脚本(参考模式)