3.3 KiB
0021-workflow-create-auto-rollback
日期: 2026-07-30 状态: Accepted 作者: claude-code (jxcj M1 ssw-loop 阶段 4.3 实战) 前置: ADR 0006 (workflow create startFormId), Save 自动回滚已实现 (line 519-537) 影响命令:
dacli workflow create
Context
jxcj M1 (2026-07-30) 阶段 4.3, 创建 jxcjauditflow workflow 失败 2 次:
第 1 次: workflow create 走 --ai 路径, semanticLint 报 ${initiator} ${reviewer} ${admin} unresolved, throw WORKFLOW_SEMANTIC_INVALID. template 残留 base_flow_template (enabledMark=0, flowId=null).
第 2 次: retry 创建, 后端报 step 2 唯一性 错误: enCode: 流程编码"jxcjauditflow"已存在 (后端 SU001 预校验).
修复路径: 先 dacli workflow delete --id=<draft_id> --yes 清理残留, 再 retry 成功.
现有自动回滚 (dacli/src/commands/workflow/create.ts:519-537): 仅在 Save (step 5) 失败时自动回滚 template. 但 semanticLint 失败 / AI 缺 flowXml / 任何 throw 都不在自动回滚范围.
Decision
dacli workflow create 任何 throw 后自动回滚 templateId (除 --keep-on-fail 外):
改进 1 (catch 块添加 BS-新145 兜底)
dacli/src/commands/workflow/create.ts:604-606 catch 块改为:
} catch (e) {
// BS-新145: 任何 throw 后自动清理 templateId 残留
if (templateId && !opts.keepOnFail) {
log.warn(`BS-新145: catch 自动清理 template ${templateId}`)
try {
const { spawnSync } = await import('node:child_process')
const r = spawnSync('npx', ['tsx', cliEntry, 'workflow', 'delete', '--id', templateId, '--yes'], { stdio: 'pipe', timeout: 10000 })
// ...
}
}
ctx.fail(...)
}
改进 2 (templateId 提前声明)
dacli/src/commands/workflow/create.ts:126 提前声明 let templateId = '', 让 catch 块可见 (原 line 384 在 try 内 const 声明, catch 不可见).
改进 3 (新增 BS-新145 + AP-wf-2)
- BS-新145: workflow create 任何 throw 后, template 残留 DB 阻塞 SU001 重试
- AP-wf-2: workflow create catch 自动回滚 (除非 --keep-on-fail 调试用)
Alternatives Considered
- 完全去掉残留风险, 改成 2 阶段提交 — 第 1 阶段只生成, 第 2 阶段 Save. 但 web 端 AiCreateModal 是 1 阶段, 镜像要保持. 否决.
- Save 前先检查 template 是否已存在, 存在则先 delete — 增加额外 API call, 默认 99% 不存在. 否决.
- throw 后 catch 统一 cleanup (本次决策) — 仅在异常路径触发, 性能影响 0. 采纳.
Consequences
正面
- BS-新145 防御明确: 任何 throw → 自动 cleanup
- 用户 retry 不需要手动 delete
--keep-on-fail仍可保留残留用于调试
负面
- catch 块多调一次 spawnSync (cleanup), 性能影响 ~50ms
- 用户若想看残留 debug, 必须显式传
--keep-on-fail
Cross-refs
- ADR 0006: workflow create startFormId (相关 workflow create 实战)
- BS-新145: 新增, workflow create 任何 throw 后 template 残留 DB 阻塞 SU001
- AP-wf-2: 新增, workflow create catch 自动回滚 (除非 --keep-on-fail)
_semantic_lint.ts:121: 现有 unresolved 检测 (throw 触发点)- jxcj M1 ssw-loop learnings.md 阶段 4.3 段: workflow create 残留踩坑
create.ts:519-537: Save 失败自动回滚 (本次扩展到 catch 块)