openfeel 1.1.1 → 1.1.2

package/dist/commands/flow.js

@@ -1,9 +1,12 @@
 import { execSync } from 'node:child_process';
-import { existsSync, copyFileSync, readFileSync } from 'node:fs';
+import { existsSync, copyFileSync, readFileSync, rmSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { FlowManager, isFlowConcurrentError, normalizeAgentName } from '../core/flow-manager.js';
+import { FlowManager, isFlowConcurrentError, normalizeAgentName, detectFillState, PHASE_PATH_MAX_DEPTH } from '../core/flow-manager.js';
 import { PipelinePhaseSchema, PIPELINE_PHASES } from '../core/pipeline-schema.js';
+import { validateStageId, suggestStageId, normalizeStageId } from '../core/plan/path.js';
 import { MetricsStore } from '../core/metrics.js';
+import { addReviewEntry } from '../core/view/entry.js';
+import { handleAddStageError, handleConcurrentConflict } from './shared/errors.js';
 import { t, getCliLang } from '../core/i18n.js';
 export function registerFlowCommand(program) {
     const flow = program
@@ -15,9 +18,15 @@ export function registerFlowCommand(program) {
         .description('显示流水线状态摘要')
         .option('--verbose', '增强输出：配置级联、最近状态变更、下游 Agent 就绪状态')
         .option('-n, --lines <n>', '最近状态变更条数（默认 5）', '5')
+        .option('--json', 'Output as JSON (machine-readable, single JSON document)')
         .action((options) => {
         const lang = getCliLang(process.cwd());
         const mgr = createManager();
+        // B1-1：--json 分支须为首行输出且纯 JSON 单文档（不打印标题/颜色/提示行）
+        if (options.json) {
+            console.log(JSON.stringify(buildStatusJson(mgr), null, 2));
+            return;
+        }
         if (!options.verbose) {
             console.log(mgr.summary(lang));
             // 各阶段 phase 展示
@@ -59,6 +68,7 @@ export function registerFlowCommand(program) {
         // ── 配置级联状态 ──
         console.log(t('flow.status.cascadeTitle', lang));
         const allKeys = new Set([
+            ...Object.keys(v.cascade.profileDefaults),
             ...Object.keys(v.cascade.configDefaults),
             ...Object.keys(v.cascade.statusOverrides),
         ]);
@@ -69,11 +79,12 @@ export function registerFlowCommand(program) {
             console.log(t('flow.status.cascadeHeader', lang));
             console.log('─────────────────────────────────────────────────');
             for (const key of [...allKeys].sort()) {
+                const prof = v.cascade.profileDefaults[key] ?? '-';
                 const def = v.cascade.configDefaults[key] ?? '-';
                 const over = v.cascade.statusOverrides[key] ?? '-';
                 const eff = v.cascade.effective[key] ?? '-';
                 const overFlag = v.cascade.statusOverrides[key] ? '*' : ' ';
-                console.log(`${key.padEnd(18)} ${def.padEnd(12)} ${overFlag}${over.padEnd(11)} ${eff}`);
+                console.log(`${key.padEnd(18)} ${prof.padEnd(12)} ${def.padEnd(12)} ${overFlag}${over.padEnd(11)} ${eff}`);
             }
             console.log(t('flow.status.cascadeNote', lang));
         }
@@ -127,13 +138,24 @@ export function registerFlowCommand(program) {
     flow
         .command('overview')
         .description('全状态可视化视图（openfeel flow overview 的后端实现）')
-        .action(() => {
+        .option('--json', 'Output as JSON')
+        .action((options) => {
         const lang = getCliLang(process.cwd());
         const mgr = createManager();
         if (!mgr.isLoaded()) {
+            // B1 契约：--json 时仍输出纯 JSON 单文档
+            if (options.json) {
+                console.log(JSON.stringify({ schemaVersion: 1, initialized: false }));
+                return;
+            }
             console.log(t('common.noInit', lang));
             return;
         }
+        // B1-5：--json 分支纯 JSON 单文档（不打印任何标题/颜色/提示行）
+        if (options.json) {
+            console.log(JSON.stringify(buildOverviewJson(mgr), null, 2));
+            return;
+        }
         const phase = mgr.getPhase();
         const current = mgr.getCurrent();
         const summary = mgr.getSummary();
@@ -254,35 +276,120 @@ export function registerFlowCommand(program) {
     flow
         .command('current')
         .description('显示当前阶段和操作')
-        .action(() => {
+        .option('--json', 'Output as JSON')
+        .action((options) => {
         const lang = getCliLang(process.cwd());
         const mgr = createManager();
         if (!mgr.isLoaded()) {
+            // B1 契约：--json 时仍输出纯 JSON 单文档（未初始化 → 空串字段）
+            if (options.json) {
+                console.log(JSON.stringify({ schemaVersion: 1, stage: '', op: '', phase: '' }));
+                return;
+            }
             console.log(t('common.noInit', lang));
             return;
         }
         const phase = mgr.getPhase(); // MetaPhase: active/paused/done
         const current = mgr.getCurrent();
-        const summary = mgr.getSummary();
         const data = mgr.getData();
-        const stagePhase = current?.stage && data?.stages[current.stage]
-            ? data.stages[current.stage].phase
+        // B8：getCurrent() 在 op 为空时返回 null（契约不变）；命令层回退读取 pipeline.current 展示 stage + 「（无 op）」
+        const rawCurrent = data?.pipeline.current;
+        const displayStage = current?.stage ?? rawCurrent?.stage ?? '';
+        const displayOp = current?.op ?? rawCurrent?.op ?? '';
+        // B1-2：--json 分支纯 JSON 单文档（op 为空串而非 null，便于机器消费）
+        if (options.json) {
+            console.log(JSON.stringify({ schemaVersion: 1, stage: displayStage, op: displayOp, phase: phase ?? '' }));
+            return;
+        }
+        const summary = mgr.getSummary();
+        const stagePhase = displayStage && data?.stages[displayStage]
+            ? data.stages[displayStage].phase
             : t('common.none', lang);
         console.log(t('flow.current.globalStatus', lang) + `: ${phase}`);
-        console.log(t('common.stage', lang) + `: ${current?.stage ?? t('common.none', lang)}`);
+        // B8：stage 存在但无 op → `{stage}（无 op）`；stage 亦空 → 保持既有「(无)」文案
+        if (!displayStage) {
+            console.log(t('common.stage', lang) + `: ${t('common.none', lang)}`);
+        }
+        else if (!displayOp) {
+            console.log(t('common.stage', lang) + `: ` + t('flow.current.noOpTmpl', lang, { stage: displayStage }));
+        }
+        else {
+            console.log(t('common.stage', lang) + `: ${displayStage}`);
+        }
         console.log(t('flow.current.stagePhase', lang) + `: ${stagePhase}`);
-        console.log(t('flow.current.currentOp', lang) + `: ${current ? `${current.stage}.${current.op}` : t('common.none', lang)}`);
+        console.log(t('flow.current.currentOp', lang) + `: ${displayOp ? `${displayStage}.${displayOp}` : t('common.none', lang)}`);
         console.log(t('flow.current.retryCount', lang) + `: ${summary.retryCount}`);
     });
     // flow metrics — 展示 Agent 性能指标
     flow
         .command('metrics')
         .description('展示 Agent 性能指标')
-        .action(() => {
+        .option('--json', 'Output as JSON')
+        .action((options) => {
         const lang = getCliLang(process.cwd());
         const store = MetricsStore.getInstance();
         store.load();
-        console.log(store.summary());
+        // B1-4：--json 输出结构化指标（顶层对象 + schemaVersion），不输出人类可读表格
+        if (options.json) {
+            console.log(JSON.stringify({ schemaVersion: 1, ...store.getSummaryData() }, null, 2));
+            return;
+        }
+        console.log(store.summary(lang));
+    });
+    // flow phases — 自描述：列出全部合法 phase 与运行时转移表
+    flow
+        .command('phases')
+        .description('列出全部合法 phase 及其流转映射（自描述）')
+        .option('--json', 'Output { phases, transitions, advanceAccepted, schemaVersion } as JSON')
+        .action((options) => {
+        const lang = getCliLang(process.cwd());
+        const mgr = createManager();
+        const phases = mgr.getPipelinePhases();
+        const transitions = mgr.getPipelineTransitions();
+        // 运行时 vs 内置默认 transitions 差异（T19：使漂移可见，不补组合键）
+        const defaults = mgr.getDefaultTransitions();
+        const missingKeys = Object.keys(defaults).filter((k) => !(k in transitions));
+        const extraKeys = Object.keys(transitions).filter((k) => !(k in defaults));
+        const changedKeys = Object.keys(defaults).filter((k) => k in transitions && JSON.stringify(defaults[k]) !== JSON.stringify(transitions[k]));
+        const transitionsDiff = { missing: missingKeys, extra: extraKeys, changed: changedKeys };
+        if (options.json) {
+            // advanceAccepted = 内置 15 phase（flow advance 的推进白名单），与 phases（运行时存在视图，可含自定义）显式区分
+            // 既有三字段（phases/transitions/advanceAccepted）+ transitionsDiff 逐字保留；仅追加 schemaVersion:1（B1-6）
+            // 注：schemaVersion 未来变更须递增版本号
+            console.log(JSON.stringify({ schemaVersion: 1, phases, transitions, advanceAccepted: [...PIPELINE_PHASES], transitionsDiff }, null, 2));
+            return;
+        }
+        console.log(t('flow.phases.title', lang));
+        console.log(t('flow.phases.listLabel', lang) + `: ${phases.length}`);
+        for (const p of phases) {
+            console.log(`  - ${p}`);
+        }
+        console.log('');
+        console.log(t('flow.phases.transitionsLabel', lang) + ':');
+        for (const [key, targets] of Object.entries(transitions)) {
+            console.log(`  ${key} → [${targets.join(', ')}]`);
+        }
+        console.log('');
+        // 差异提示（非空时输出）——T19
+        if (missingKeys.length + extraKeys.length + changedKeys.length > 0) {
+            const parts = [];
+            if (missingKeys.length > 0) {
+                parts.push(t('flow.phases.transitionsDiffMissing', lang, { keys: missingKeys.join(', ') }));
+            }
+            if (extraKeys.length > 0) {
+                parts.push(t('flow.phases.transitionsDiffExtra', lang, { keys: extraKeys.join(', ') }));
+            }
+            if (changedKeys.length > 0) {
+                parts.push(t('flow.phases.transitionsDiffChanged', lang, { keys: changedKeys.join(', ') }));
+            }
+            console.log(t('flow.phases.transitionsDiffNote', lang, { detail: parts.join('; ') }));
+        }
+        // 边界：运行时 pipeline.yaml 含内置 15 phase 之外的 phase 时提示差异（cli/BUG-001 方案 B）
+        const customPhases = phases.filter((p) => !PIPELINE_PHASES.includes(p));
+        if (customPhases.length > 0) {
+            console.log(t('flow.phases.customPhaseNote', lang, { phases: customPhases.join(', ') }));
+        }
+        console.log(t('flow.phases.hint', lang));
     });
     // flow stage — 阶段管理子命令组
     const stageCmd = flow
@@ -291,10 +398,18 @@ export function registerFlowCommand(program) {
     // flow stage add <stageId>
     stageCmd
         .command('add')
-        .description('新增流水线阶段')
-        .argument('<stageId>', '阶段 ID（如 v4.3）')
+        .description('新增流水线阶段（仅注册 flow.json，不建目录；通常应使用 openfeel plan stage add）')
+        .argument('<stageId>', '阶段 ID（如 v1.1.2-stage-41）')
         .action((stageId) => {
-        const lang = getCliLang(process.cwd());
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
+        // 非法 stageId 统一报错 + 建议名（op-002 校验底座）
+        const v = validateStageId(stageId);
+        if (!v.ok) {
+            console.error(t('common.stageIdInvalidTmpl', lang, { input: stageId }));
+            console.error(t('common.stageIdSuggestTmpl', lang, { suggest: suggestStageId(projectPath, stageId) }));
+            process.exit(1);
+        }
         const mgr = createManager();
         if (!mgr.isLoaded()) {
             console.error(t('common.errorNoInit', lang));
@@ -306,26 +421,153 @@ export function registerFlowCommand(program) {
             console.log(t('flow.stage.addedTmpl', lang, { stage: stageId }));
         }
         catch (err) {
-            // 并发冲突：本次未写入 flow.json，输出可重试提示并退出码 2（R3.2）
+            // addStage 错误统一处理（并发写冲突 / 目录冲突 / 其他），与 stage create 共用单点（T42）
+            handleAddStageError(err, lang);
+        }
+    });
+    // flow stage remove <stageId> [--force] [--dry-run] [--purge]
+    stageCmd
+        .command('remove <stageId>')
+        .description('移除流水线阶段（安全校验；默认仅注销 flow.json，不删目录）')
+        .option('--force', '越过安全校验（ops 非空 / 当前活跃阶段 / 被其它阶段依赖）')
+        .option('--dry-run', '仅预览，不写盘')
+        .option('--purge', '同时删除 plan/{series}/{stageDir}/ 目录（非 TTY 须配 --force）')
+        .action(async (stageId, options) => {
+        const lang = getCliLang(process.cwd());
+        const mgr = createManager();
+        if (!mgr.isLoaded()) {
+            console.error(t('common.errorNoInit', lang));
+            process.exit(1);
+        }
+        const data = mgr.getData();
+        // REV-007：命令层归一化（短名 → 全名），与 stage set / ops list / op-012 advance 同范式
+        const stageArg = normalizeStageId(stageId) ?? stageId;
+        if (!data?.stages[stageArg]) {
+            console.error(t('flow.stage.remove.notFoundTmpl', lang, { stage: stageArg }));
+            process.exit(1);
+            return;
+        }
+        // --dry-run：复用 checkRemovable 做安全校验，失败同样 exit 1（REV-005），并呈现引用者（REV-004）
+        if (options.dryRun) {
+            const info = mgr.checkRemovable(stageArg, { force: options.force });
+            console.log(t('flow.stage.remove.dryRunTitle', lang));
+            console.log(`  ` + t('common.stage', lang) + `: ${stageArg}`);
+            console.log(`  ops: ${info.opCount}`);
+            console.log(`  current: ${data.pipeline.current.stage}${info.isCurrent ? ' ←' : ''}`);
+            console.log(`  ` + t('flow.stage.remove.dryRunReferencing', lang) + `: ` +
+                (info.referencing.length > 0 ? info.referencing.join(', ') : t('common.none', lang)));
+            if (!info.ok) {
+                console.error(t('common.errorTmpl', lang, { msg: info.reason ?? '' }));
+                process.exit(1);
+                return;
+            }
+            console.log(t('flow.stage.remove.dryRunOk', lang));
+            return;
+        }
+        // --purge 非 TTY 守卫
+        if (options.purge && !options.force && !process.stdout.isTTY) {
+            console.error(t('flow.stage.remove.purgeNeedForce', lang));
+            process.exit(1);
+            return;
+        }
+        try {
+            // --purge TTY 二次确认（--force 跳过）
+            if (options.purge && !options.force) {
+                const { confirm } = await import('@inquirer/prompts');
+                const ok = await confirm({ message: t('flow.stage.remove.purgeConfirm', lang), default: false });
+                if (!ok) {
+                    console.log(t('common.cancelled', lang));
+                    return;
+                }
+            }
+            // 事务顺序（REV-009）：先注销内存注册 → save() 落盘成功 → 再删目录。
+            // save() 失败则不会到达目录删除，杜绝「目录已删但注册仍在」的中间态。
+            const { purgeTarget } = mgr.removeStage(stageArg, { force: options.force, purge: options.purge });
+            mgr.save();
+            if (purgeTarget) {
+                rmSync(purgeTarget, { recursive: true, force: true });
+                console.log(t('flow.stage.remove.purgedTmpl', lang));
+            }
+            console.log(t('flow.stage.remove.okTmpl', lang, { stage: stageArg }));
+        }
+        catch (err) {
+            // 并发写冲突：统一单点（i18n 文案 + 退出码 2）；其余走通用错误
             if (isFlowConcurrentError(err)) {
-                console.error(`[并发冲突] flow.json 已被其它进程修改（期望 revision=${err.expectedRevision}，磁盘=${err.actualRevision}）。`);
-                console.error('本次修改未写入。请重新执行该命令重试。');
-                process.exit(2);
+                handleConcurrentConflict(err, lang);
             }
             const msg = err instanceof Error ? err.message : String(err);
             console.error(t('common.errorTmpl', lang, { msg }));
             process.exit(1);
         }
     });
+    // flow stage set <stageId> [--deps <ids...>]
+    stageCmd
+        .command('set <stageId>')
+        .description('设置阶段依赖（覆盖写入；未指定 --deps 视为清空）')
+        .option('--deps <ids...>', '依赖阶段 ID 列表（空格或逗号分隔；含变长参数，建议置于命令末尾）')
+        .action((stageId, options) => {
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
+        // 非法 stageId 统一报错 + 建议名
+        const v = validateStageId(stageId);
+        if (!v.ok) {
+            console.error(t('common.stageIdInvalidTmpl', lang, { input: stageId }));
+            console.error(t('common.stageIdSuggestTmpl', lang, { suggest: suggestStageId(projectPath, stageId) }));
+            process.exit(1);
+        }
+        const mgr = createManager();
+        if (!mgr.isLoaded()) {
+            console.error(t('common.errorNoInit', lang));
+            process.exit(1);
+        }
+        const data = mgr.getData();
+        // 兼容 --deps a,b 与 --deps a b：逐项按逗号再切分、去空（与 plan stage add 对齐）
+        const deps = (options.deps ?? [])
+            .flatMap((d) => d.split(','))
+            .map((s) => s.trim())
+            .filter(Boolean);
+        // 悬空依赖：命令层强制校验（核心层仅 warn），非法一律 exit 1 且不写盘
+        const known = new Set(Object.keys(data.stages).map((k) => normalizeStageId(k) ?? k));
+        const invalid = deps.filter((d) => !known.has(normalizeStageId(d) ?? d));
+        if (invalid.length > 0) {
+            console.error(t('stage.set.depsDanglingTmpl', lang, { deps: invalid.join(', ') }));
+            process.exit(1);
+            return;
+        }
+        // 目标阶段必须存在
+        const target = normalizeStageId(stageId) ?? stageId;
+        if (!data.stages[target]) {
+            console.error(t('common.stageIdInvalidTmpl', lang, { input: stageId }));
+            process.exit(1);
+            return;
+        }
+        try {
+            mgr.setStageDeps(stageId, deps);
+        }
+        catch (err) {
+            if (isFlowConcurrentError(err)) {
+                handleConcurrentConflict(err, lang);
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(t('common.errorTmpl', lang, { msg }));
+            process.exit(1);
+            return;
+        }
+        console.log(t('stage.set.depsOkTmpl', lang, {
+            stage: target,
+            deps: deps.length > 0 ? deps.join(', ') : t('common.none', lang),
+        }));
+    });
     // flow advance --stage <id> --to <phase> [--op <id>] [--force]
     flow
         .command('advance')
         .description('推进流水线阶段')
         .option('--op <id>', '操作 ID（如 stage-01.op-001），仅用于日志/展示')
-        .requiredOption('--to <phase>', '目标阶段（如 exec_running）')
+        .requiredOption('--to <phase>', '目标阶段（如 exec_running）。合法 phase 与转移表：openfeel flow phases')
         .option('--stage <id>', '阶段 ID（如 stage-03），必须指定')
         .option('--force', '强制执行（跳过非法 phase 校验和阶段跳跃检查，但不可绕过 REV 阻塞检查）')
         .option('--dry-run', '仅验证不执行修改（预览输出）。与 --force 组合时跳过校验但仍不执行修改')
+        .option('--quiet', '静默非错误输出（成功确认与 Git 警告均不打印）')
         .action((options) => {
         const lang = getCliLang(process.cwd());
         // 自定义 --stage 必选校验（提供中文错误提示）
@@ -338,12 +580,19 @@ export function registerFlowCommand(program) {
             console.error(t('common.errorNoInit', lang));
             process.exit(1);
         }
+        // REV-005：命令层归一化（短名 → 全名），与 plan.ts / flow.ts 其它 stage 解析点同范式
+        const stageArg = normalizeStageId(options.stage) ?? options.stage;
         // 自动修复 phase/status 不一致（在 validate() 前执行）
         if (options.stage) {
-            const repairResult = mgr.autoRepairInconsistency(options.stage);
+            // B1 修复：dry-run 走预览模式（不写内存/不写盘），仅在非 dry-run 时 save()
+            const repairResult = mgr.autoRepairInconsistency(stageArg, { dryRun: options.dryRun });
             if (repairResult.fixed) {
-                console.log(t('flow.advance.autoRepaired', lang) + `: ${repairResult.detail}`);
-                mgr.save();
+                console.log(options.dryRun
+                    ? t('flow.advance.autoRepairPreview', lang) + `: ${repairResult.detail}`
+                    : t('flow.advance.autoRepaired', lang) + `: ${repairResult.detail}`);
+                if (!options.dryRun) {
+                    mgr.save();
+                }
             }
         }
         const { valid, errors, warnings } = mgr.validate();
@@ -371,15 +620,32 @@ export function registerFlowCommand(program) {
                 process.exit(1);
             }
         }
-        // 阶段跳跃保护：基于 stage phase 检查当前 phase 到目标 phase 是否存在直接路径
+        // 阶段路径解析（B5-1）：非 --force 时求「当前 phase → to」的唯一可达路径
+        // - 唯一路径（含单步）→ 沿路径逐步推进；单步时与既有行为完全一致
+        // - 无路径 / 多义 / 超深 → 拒绝（exit 1 + 可达目标；保留既有跳转诊断）
+        // - 已在 to → no-op 成功
+        let phasePath = [options.to];
         if (!options.force) {
-            const phaseResult = PipelinePhaseSchema.safeParse(options.to);
-            if (phaseResult.success && !mgr.hasTransition(options.to, options.stage)) {
-                // 获取当前 phase 和合法目标列表（增强诊断信息）
+            const pathResult = mgr.findPhasePath(stageArg, options.to);
+            if (pathResult.reason === 'no-path' || pathResult.reason === 'ambiguous' || pathResult.reason === 'depth-exceeded') {
                 const data = mgr.getData();
-                const currentPhase = data?.stages[options.stage || '']?.phase ?? t('common.unknown', lang);
-                const availableTargets = mgr.getAvailablePhases(options.stage);
-                console.error(t('flow.advance.errorPhaseJumpTmpl', lang, { stage: options.stage || '', to: options.to }));
+                const currentPhase = data?.stages[stageArg]?.phase ?? t('common.unknown', lang);
+                const availableTargets = mgr.getAvailablePhases(stageArg);
+                if (pathResult.reason === 'ambiguous') {
+                    console.error(t('flow.advance.ambiguousTmpl', lang));
+                }
+                else if (pathResult.reason === 'depth-exceeded') {
+                    console.error(t('flow.advance.depthExceededTmpl', lang, { max: String(PHASE_PATH_MAX_DEPTH) }));
+                }
+                else {
+                    console.error(t('flow.advance.noPathTmpl', lang, {
+                        from: currentPhase,
+                        to: options.to,
+                        targets: availableTargets.length > 0 ? `[${availableTargets.join(', ')}]` : t('common.none', lang),
+                    }));
+                }
+                // 保留既有跳转诊断（可达目标）——与现状一致
+                console.error(t('flow.advance.errorPhaseJumpTmpl', lang, { stage: stageArg, to: options.to }));
                 console.error(t('flow.advance.currentPhaseTmpl', lang, { phase: currentPhase }));
                 if (availableTargets.length > 0) {
                     console.error(t('flow.advance.availableTargets', lang) + `: [${availableTargets.join(', ')}]`);
@@ -389,83 +655,132 @@ export function registerFlowCommand(program) {
                 }
                 console.error(t('flow.advance.hintUseForce', lang));
                 process.exit(1);
+                return;
             }
+            if (pathResult.reason === 'already-at-target') {
+                // 已在目标 phase → no-op 成功
+                if (!options.quiet) {
+                    console.log(t('flow.advance.alreadyAtTargetTmpl', lang, { stage: stageArg, to: options.to }));
+                }
+                return;
+            }
+            phasePath = pathResult.path;
         }
-        // 安全提示：跳过审查直接 done
+        // 安全提示：跳过审查直接 done（保持既有条件）
         const SKIP_WARN_PHASES = ['exec_running', 'review_pending'];
         if (options.to === 'done' && options.stage) {
-            const stage = (mgr.getData()?.stages || {})[options.stage];
+            const stage = (mgr.getData()?.stages || {})[stageArg];
             if (stage && SKIP_WARN_PHASES.includes(stage.phase)) {
                 console.warn(t('flow.advance.warnSkipReview', lang));
             }
         }
-        // REV 闭环（命令层兜底）：推进到 done 时检查 blocking REV
+        // REV 闭环（命令层兜底）：推进到 done 时检查 blocking REV（单步入口；多步循环每步后另复检，B5-3）
         if (options.to === 'done' && options.stage) {
-            const allReviews = mgr.getReviewItems();
-            const stageReviews = allReviews.filter((r) => r.op.startsWith(options.stage) || r.op === options.stage);
-            const blockingOpen = stageReviews.filter((r) => r.blocking !== false && r.status === 'open');
+            const blockingOpen = assertNoBlockingOpenRev(mgr, stageArg, lang);
             if (blockingOpen.length > 0) {
-                console.warn(`[!] 检测到 ${blockingOpen.length} 个未解决的阻塞 REV：`);
-                for (const rev of blockingOpen) {
-                    console.warn(`    ${rev.id}: ${rev.title} (priority=${rev.priority})`);
-                }
                 if (options.force) {
-                    console.warn('[!] --force 已指定，但 REV 安全检查不可绕过。拒绝推进。');
+                    console.warn(t('flow.advance.forceRevRefused', lang));
                 }
-                console.error('错误：blocking REV 未解决前禁止推进到 done。');
-                console.error('请先解决上述 REV 或通过 flow review resolve 标记为非阻塞。');
+                console.error(t('flow.advance.blockingRevRefused', lang));
+                console.error(t('flow.advance.blockingRevHint', lang));
                 process.exit(1);
+                return;
             }
         }
-        // --dry-run：仅验证合法性，不实际修改 flow.json
+        // 起始 phase（供多步逐步输出）；REV-005/REV-006：以归一化后的 stageArg 索引
+        const startPhase = mgr.getData()?.stages[stageArg]?.phase ?? t('common.unknown', lang);
+        // --dry-run：仅验证合法性，不实际修改 flow.json（B5-2：多步时打印完整路径）
         if (options.dryRun) {
-            const data = mgr.getData();
-            const fromPhase = data?.stages[options.stage]?.phase ?? t('common.unknown', lang);
-            const toPhase = options.to;
             if (options.force) {
                 console.warn(t('flow.advance.dryRunForceWarn', lang));
             }
             console.log(t('flow.advance.dryRunTitle', lang));
-            console.log(`  ` + t('common.stage', lang) + `: ${options.stage}`);
-            console.log(`  ` + t('flow.advance.dryRunFrom', lang) + `: ${fromPhase}`);
-            console.log(`  ` + t('flow.advance.dryRunTo', lang) + `: ${toPhase}`);
+            console.log(`  ` + t('common.stage', lang) + `: ${stageArg}`);
+            console.log(`  ` + t('flow.advance.dryRunFrom', lang) + `: ${startPhase}`);
+            console.log(`  ` + t('flow.advance.dryRunTo', lang) + `: ${options.to}`);
+            if (phasePath.length > 1) {
+                const fullPath = [startPhase, ...phasePath].join(t('flow.advance.pathArrow', lang));
+                console.log(`  ` + t('flow.advance.pathTitle', lang) + ` ${fullPath}`);
+            }
             console.log('');
             console.log(t('flow.advance.dryRunOk', lang));
             return;
         }
-        let archived = false;
-        try {
-            archived = mgr.advanceStagePhase(options.stage, options.to, 'cli');
+        // 逐步推进（B5-2 / A3）：唯一路径 → 依次调用 advanceStagePhase（保留每步校验/日志/checkpoint）
+        // 中间态不回滚（A3）；失败 → 输出「已完成 / 失败点 / 剩余路径」+ exit 1
+        const totalSteps = phasePath.length;
+        let archivedAny = false;
+        for (let i = 0; i < totalSteps; i++) {
+            const next = phasePath[i];
+            let archived = false;
+            try {
+                archived = mgr.advanceStagePhase(stageArg, next, 'cli');
+            }
+            catch (err) {
+                if (totalSteps > 1) {
+                    const remaining = phasePath.slice(i).join(t('flow.advance.pathArrow', lang));
+                    const doneTo = i > 0 ? phasePath[i - 1] : t('common.none', lang);
+                    console.error(t('flow.advance.partialFailTmpl', lang, { done: doneTo, failed: next, remaining }));
+                }
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(t('common.errorTmpl', lang, { msg }));
+                process.exit(1);
+                return;
+            }
+            archivedAny = archivedAny || archived;
+            mgr.save();
+            // 归档 commit 必须在 flow.json save 之后执行，确保 commit 包含本次 phase 变更
+            if (archived) {
+                mgr.autoCommitOnDone(stageArg);
+            }
+            // 多步时逐步输出（单步保持既有静默，不新增输出）
+            if (totalSteps > 1 && !options.quiet) {
+                console.log(t('flow.advance.stepOkTmpl', lang, {
+                    stage: stageArg,
+                    from: i > 0 ? phasePath[i - 1] : startPhase,
+                    to: next,
+                }));
+            }
+            // B5-3（REV-52-001）：多步路径每步完成后复检 blocking open REV（至少进入 done 前一次）
+            // 等价论证：addAutoFixReview 强制 status='resolved'（恒非 blocking open）且 advance 路径不创建 review，
+            // 故此复检为**防御性加固**（防未来语义漂移）。
+            if (totalSteps > 1) {
+                const blockingOpen = assertNoBlockingOpenRev(mgr, stageArg, lang);
+                if (blockingOpen.length > 0) {
+                    const remainingPath = phasePath.slice(i + 1);
+                    console.error(t('flow.advance.blockedByRevTmpl', lang, {
+                        revs: blockingOpen.map((r) => r.id).join(', '),
+                        remaining: remainingPath.length > 0 ? remainingPath.join(t('flow.advance.pathArrow', lang)) : t('common.none', lang),
+                    }));
+                    process.exit(1);
+                    return;
+                }
+            }
         }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            console.error(t('common.errorTmpl', lang, { msg }));
-            process.exit(1);
+        // 成功确认（单步与多步统一）；--quiet 完全静默
+        if (!options.quiet) {
+            console.log(t('flow.advance.okTmpl', lang, { stage: stageArg, to: options.to }));
         }
-        mgr.save();
-        // 归档 commit 必须在 flow.json save 之后执行，确保 commit 包含本次 phase 变更
-        if (archived) {
-            mgr.autoCommitOnDone(options.stage);
+        // git 脏区检查（安全网）：默认仅 --to done 时提示；--quiet / 非 done → 完全跳过（含跳过 git 子进程）
+        if (!options.quiet && (options.to === 'done' || archivedAny)) {
+            try {
+                const gitStatus = execSync('git status --porcelain', {
+                    cwd: process.cwd(),
+                    encoding: 'utf-8',
+                    timeout: 5000,
+                }).trim();
+                if (gitStatus) {
+                    console.warn(t('flow.advance.gitDirtyBoxTop', lang));
+                    console.warn(t('flow.advance.gitDirtyBoxMsg', lang));
+                    console.warn(t('flow.advance.gitDirtyBoxHint', lang));
+                    console.warn(t('flow.advance.gitDirtyBoxBottom', lang));
+                }
+            }
+            catch {
+                // git 不可用（无 .git 目录或 git 未安装）时静默跳过
+            }
         }
-        console.log(t('flow.advance.okTmpl', lang, { stage: options.stage || '', to: options.to }));
-        // git 脏区检查（安全网）：openfeel-executor 未提交时输出醒目警告
-        try {
-            const gitStatus = execSync('git status --porcelain', {
-                cwd: process.cwd(),
-                encoding: 'utf-8',
-                timeout: 5000,
-            }).trim();
-            if (gitStatus) {
-                console.warn('[!] ╔════════════════════════════════════════╗');
-                console.warn('[!] ║  ⚠ Git 脏区警告：存在未提交的变更     ║');
-                console.warn('[!] ║  请确认 Executor 已完成 git commit    ║');
-                console.warn('[!] ╚════════════════════════════════════════╝');
-            }
-        }
-        catch {
-            // git 不可用（无 .git 目录或 git 未安装）时静默跳过
-        }
-        if (options.op) {
+        if (options.op && !options.quiet) {
             console.log(t('flow.advance.opLabelTmpl', lang, { op: options.op }));
         }
     });
@@ -486,6 +801,15 @@ export function registerFlowCommand(program) {
             console.error(t('flow.attempt.errorInvalidResult', lang));
             process.exit(1);
         }
+        // B4-5（A1 第 5 条）/ REV-52-002：draft op 拒绝记录执行结果（命令层守卫；核心层 recordAttempt 另有兜底）
+        if (mgr.getOpState(options.op) === 'draft') {
+            const dotIdx = options.op.lastIndexOf('.');
+            const stageId = dotIdx >= 0 ? options.op.substring(0, dotIdx) : '';
+            const localOpId = dotIdx >= 0 ? options.op.substring(dotIdx + 1) : options.op;
+            console.error(t('flow.attempt.draftRefusedTmpl', lang, { stage: stageId, opId: localOpId }));
+            process.exit(1);
+            return;
+        }
         const outcome = mgr.recordAttempt(options.op, options.result);
         mgr.save();
         if (options.result === 'pass') {
@@ -501,6 +825,92 @@ export function registerFlowCommand(program) {
             mgr.save();
             console.log(t('flow.attempt.autoReplan', lang));
         }
+        // N4-2：输出当前指针（只读，与 flow current 同源；attempt 后 current.op 已由 syncCurrentOp 同步）
+        const cur = mgr.getData()?.pipeline.current;
+        if (cur && cur.stage) {
+            if (cur.op) {
+                console.log(t('flow.attempt.currentOpTmpl', lang, { stage: cur.stage, op: cur.op }));
+            }
+            else {
+                console.log(t('flow.attempt.currentOpEmptyTmpl', lang, { stage: cur.stage }));
+            }
+        }
+    });
+    // flow ops list [--stage <id>] [--json] — B3-1：操作方案视图（状态 + 模板填充度 + draft 分组）
+    const opsCmd = flow
+        .command('ops')
+        .description('操作方案视图');
+    opsCmd
+        .command('list')
+        .description('列出操作方案（含状态与模板填充度）')
+        .option('--stage <id>', '仅列出指定阶段')
+        .option('--json', 'Output as JSON')
+        .action((options) => {
+        const lang = getCliLang(process.cwd());
+        const mgr = createManager();
+        if (!mgr.isLoaded()) {
+            if (options.json) {
+                console.log(JSON.stringify({ schemaVersion: 1, ops: [] }));
+                return;
+            }
+            console.log(t('common.noInit', lang));
+            return;
+        }
+        const filterStage = options.stage ? (normalizeStageId(options.stage) ?? options.stage) : undefined;
+        const data = mgr.getData();
+        const items = [];
+        for (const [stageId, stage] of Object.entries(data.stages)) {
+            if (filterStage && stageId !== filterStage) {
+                continue;
+            }
+            const opsMap = stage.ops && typeof stage.ops === 'object' && !Array.isArray(stage.ops) ? stage.ops : {};
+            for (const [opId, op] of Object.entries(opsMap)) {
+                // 填充度：复用 flow-manager 的单一标记判定。
+                // 已知边界（stage-54 E1-补 / A9）：content 为 null（op 文件缺失 / 命名不含前缀 / 目录不可读）时视为 filled，
+                // 与 health 的「null 跳过不报」为同向漏检（非分叉）；现行数据短名命中故不可复现，
+                // 不扩展 detectFillState 返回域与 --json 契约。
+                const content = mgr.readOpTemplate(stageId, opId);
+                const fill = content === null ? 'filled' : detectFillState(content);
+                items.push({
+                    stage: stageId,
+                    opId,
+                    title: op.title ?? '',
+                    state: op.state ?? '',
+                    fill,
+                });
+            }
+        }
+        if (options.json) {
+            // 复用 op-001 口径：顶层对象 + schemaVersion:1
+            const ops = items.map((it) => ({
+                stage: it.stage,
+                opId: it.opId,
+                title: it.title,
+                state: it.state,
+                fill: it.fill,
+                ...(it.fill === 'empty' ? { warning: t('flow.ops.emptyWarningTmpl', lang, { opId: it.opId }) } : {}),
+            }));
+            console.log(JSON.stringify({ schemaVersion: 1, ops }, null, 2));
+            return;
+        }
+        console.log(t('flow.ops.title', lang));
+        const published = items.filter((i) => i.state !== 'draft');
+        const drafts = items.filter((i) => i.state === 'draft');
+        const printGroup = (label, list) => {
+            if (list.length === 0) {
+                return;
+            }
+            console.log(label);
+            for (const it of list) {
+                console.log(`  ${it.stage}.${it.opId} [${it.state}] (${it.fill}) ${it.title}`);
+                // 空模板 warning（draft 亦提示，引导 publish 前先填充）
+                if (it.fill === 'empty') {
+                    console.log(t('flow.ops.emptyWarningTmpl', lang, { opId: it.opId }));
+                }
+            }
+        };
+        printGroup(t('flow.ops.groupActive', lang), published);
+        printGroup(t('flow.ops.groupDraft', lang), drafts);
     });
     // flow log [--last <n>]
     flow
@@ -545,60 +955,49 @@ export function registerFlowCommand(program) {
         .option('--blocking [boolean]', '是否阻塞流水线（默认 true）', 'true')
         .action((options) => {
         const lang = getCliLang(process.cwd());
-        const mgr = createManager();
-        if (!mgr.isLoaded()) {
-            console.error(t('common.errorNoInit', lang));
-            process.exit(1);
-        }
-        // 自动生成 REV ID（基于已有审查条目数量递增）
-        const existingReviews = mgr.getReviewItems();
-        const revId = `REV-${String(existingReviews.length + 1).padStart(3, '0')}`;
-        const reviewItem = {
-            id: revId,
-            op: options.op,
-            status: 'open',
-            priority: 'medium',
+        // 单点实现：解析 / 校验 / REV ID 分配 / 写入均由 addReviewEntry 统一处理（T37/R4）
+        const blocking = options.blocking !== undefined
+            ? !(options.blocking === 'false' || options.blocking === false)
+            : true;
+        const result = addReviewEntry(process.cwd(), {
+            opId: options.op,
             title: options.title || t('flow.review.detail', lang) + `: ${options.op}`,
-            filed_by: 'cli',
-            filed_at: new Date().toISOString(),
-            canAutoFix: !!options.autoFix,
+            priority: 'medium',
             autoFixDetail: options.autoFix,
-            blocking: options.blocking !== undefined ? (options.blocking === 'false' || options.blocking === false ? false : true) : true,
-        };
-        if (options.autoFix) {
-            // opId 格式校验（来自 REV-011：命令层校验，避免无效 opId 穿透到 addAutoFixReview）
-            const dotIdx = options.op.lastIndexOf('.');
-            if (dotIdx === -1) {
-                console.error(t('common.invalidOpId', lang));
-                process.exit(1);
+            blocking,
+        });
+        if (result.error) {
+            // 错误路径：按错误码分流 i18n 文案（单点返回 code，命令层只负责呈现）
+            switch (result.error.code) {
+                case 'notLoaded':
+                    console.error(t('common.errorNoInit', lang));
+                    break;
+                case 'invalidOpId':
+                    console.error(t('common.invalidOpId', lang));
+                    break;
+                case 'stageNotFound':
+                    console.error(t('flow.review.errorStageNotFoundTmpl', lang, { opId: result.error.opId, stage: result.error.stage }));
+                    break;
+                case 'opNotFound':
+                    console.error(t('flow.review.errorOpNotFoundTmpl', lang, { opId: result.error.opId, op: result.error.op, stage: result.error.stage }));
+                    break;
+                case 'invalidPriority':
+                    console.error(t('flow.review.errorInvalidPriorityTmpl', lang, { priority: result.error.priority }));
+                    break;
             }
-            const stageId = options.op.substring(0, dotIdx);
-            const opLocalId = options.op.substring(dotIdx + 1);
-            // 校验 stage 是否存在于 flow.json
-            const data = mgr.getData();
-            if (!data || !data.stages[stageId]) {
-                console.error(t('flow.review.errorStageNotFoundTmpl', lang, { opId: options.op, stage: stageId }));
-                process.exit(1);
-            }
-            // 校验 op 是否存在于对应 stage 中
-            if (!data.stages[stageId].ops[opLocalId]) {
-                console.error(t('flow.review.errorOpNotFoundTmpl', lang, { opId: options.op, op: opLocalId, stage: stageId }));
-                process.exit(1);
-            }
-            // 自动修复路径：记录 REV 条目（状态直接 resolved），跳过 review_failed → scheme_pending
-            mgr.addAutoFixReview(reviewItem, options.op);
-            mgr.save();
-            const blockingLabel = reviewItem.blocking !== false ? t('flow.review.labelBlocking', lang) : t('flow.review.labelNonBlocking', lang);
-            console.log(t('flow.review.addedAutoFixTmpl', lang, { label: blockingLabel, revId }));
+            process.exit(1);
+            return;
+        }
+        const review = result.review;
+        const blockingLabel = review.blocking !== false ? t('flow.review.labelBlocking', lang) : t('flow.review.labelNonBlocking', lang);
+        if (options.autoFix) {
+            console.log(t('flow.review.addedAutoFixTmpl', lang, { label: blockingLabel, revId: review.id }));
             console.log(`  ` + t('common.op', lang) + `: ${options.op}`);
             console.log(`  ` + t('flow.review.detail', lang) + `: ${options.autoFix}`);
             console.log(t('flow.review.autoFixPhase', lang));
         }
         else {
-            mgr.addReview(reviewItem);
-            mgr.save();
-            const blockingLabel = reviewItem.blocking !== false ? t('flow.review.labelBlocking', lang) : t('flow.review.labelNonBlocking', lang);
-            console.log(t('flow.review.addedTmpl', lang, { label: blockingLabel, revId, op: options.op }) + (options.title ? ` — ${options.title}` : ''));
+            console.log(t('flow.review.addedTmpl', lang, { label: blockingLabel, revId: review.id, op: options.op }) + (options.title ? ` — ${options.title}` : ''));
         }
     });
     // flow review resolve <rev-id>
@@ -623,6 +1022,86 @@ export function registerFlowCommand(program) {
             process.exit(1);
         }
     });
+    // flow review update <rev-id> [--priority] [--title] [--blocking]
+    reviewCmd
+        .command('update <rev-id>')
+        .description('更新审查条目字段（至少提供一个选项）')
+        .option('--priority <level>', '优先级（high/medium/low）')
+        .option('--title <text>', '审查标题')
+        .option('--blocking <true|false>', '是否阻塞流水线（true/false）')
+        .action((revId, options) => {
+        const lang = getCliLang(process.cwd());
+        const mgr = createManager();
+        if (!mgr.isLoaded()) {
+            console.error(t('common.errorNoInit', lang));
+            process.exit(1);
+        }
+        const patch = {};
+        let hasField = false;
+        if (options.priority !== undefined) {
+            // 枚举校验：非法优先级 exit 1
+            if (options.priority !== 'high' && options.priority !== 'medium' && options.priority !== 'low') {
+                console.error(t('flow.review.errorInvalidPriorityTmpl', lang, { priority: options.priority }));
+                process.exit(1);
+                return;
+            }
+            patch.priority = options.priority;
+            hasField = true;
+        }
+        if (options.title !== undefined) {
+            patch.title = options.title;
+            hasField = true;
+        }
+        if (options.blocking !== undefined) {
+            // 布尔解析：非法值 exit 1
+            if (options.blocking !== 'true' && options.blocking !== 'false') {
+                console.error(t('flow.review.invalidBlockingTmpl', lang, { value: options.blocking }));
+                process.exit(1);
+                return;
+            }
+            patch.blocking = options.blocking === 'true';
+            hasField = true;
+        }
+        // 无字段可更新：exit 1
+        if (!hasField) {
+            console.error(t('flow.review.updateNoFieldTmpl', lang));
+            process.exit(1);
+            return;
+        }
+        const ok = mgr.updateReview(revId, patch);
+        if (!ok) {
+            console.error(t('flow.review.notFoundTmpl', lang, { revId }));
+            process.exit(1);
+            return;
+        }
+        console.log(t('flow.review.updateOkTmpl', lang, { revId }));
+    });
+    // flow review remove <rev-id>
+    reviewCmd
+        .command('remove <rev-id>')
+        .description('删除审查条目（留审计日志；打印被删条目标题）')
+        .action((revId) => {
+        const lang = getCliLang(process.cwd());
+        const mgr = createManager();
+        if (!mgr.isLoaded()) {
+            console.error(t('common.errorNoInit', lang));
+            process.exit(1);
+        }
+        // 先取标题供追溯（删除后不可得）
+        const item = mgr.getReviewItems().find((r) => r.id === revId);
+        if (!item) {
+            console.error(t('flow.review.notFoundTmpl', lang, { revId }));
+            process.exit(1);
+            return;
+        }
+        const ok = mgr.removeReview(revId);
+        if (!ok) {
+            console.error(t('flow.review.notFoundTmpl', lang, { revId }));
+            process.exit(1);
+            return;
+        }
+        console.log(t('flow.review.removeOkTmpl', lang, { revId, title: item.title }));
+    });
     // flow retry --op <id>
     flow
         .command('retry')
@@ -647,9 +1126,11 @@ export function registerFlowCommand(program) {
             console.error(t('common.invalidOpId', lang));
             process.exit(1);
         }
-        const stageId = options.op.substring(0, dotIdx);
+        const rawStageId = options.op.substring(0, dotIdx);
         const opLocalId = options.op.substring(dotIdx + 1);
-        const stage = data.stages[stageId];
+        // REV-007：短名前缀归一化（与 op-012 advance 同范式）+ 双键回退（归一化键优先）
+        const stageId = normalizeStageId(rawStageId) ?? rawStageId;
+        const stage = data.stages[stageId] ?? data.stages[rawStageId];
         if (!stage) {
             console.error(t('flow.retry.errorStageNotFoundTmpl', lang, { stage: stageId }));
             process.exit(1);
@@ -673,9 +1154,11 @@ export function registerFlowCommand(program) {
         .description('自动检测并修复 flow.json 中的常见问题')
         .option('--dry-run', '仅检测不修复')
         .option('--backup', '修复前备份为 .bak')
+        .option('--prune-orphans', '清理键孤儿（flow.json 中已注册但 ops/ 无文件的 op 键；不删除文件）')
         .action((options) => {
         const lang = getCliLang(process.cwd());
-        const mgr = new FlowManager(process.cwd());
+        // 复用统一构造入口 createManager()，避免第二处 new FlowManager（T13）
+        const mgr = createManager();
         // --backup 选项：修复前手动备份
         if (options.backup) {
             const fp = resolve(process.cwd(), '.openfeel', 'flow.json');
@@ -687,7 +1170,7 @@ export function registerFlowCommand(program) {
                 console.log(t('flow.repair.noBackup', lang));
             }
         }
-        const result = mgr.repair(options.dryRun ?? false);
+        const result = mgr.repair(options.dryRun ?? false, { pruneOrphans: options.pruneOrphans ?? false });
         if (options.dryRun) {
             console.log(t('flow.repair.dryRunTitle', lang));
         }
@@ -723,6 +1206,29 @@ export function registerFlowCommand(program) {
             console.log('   openfeel flow migrate');
             console.log('   ' + t('flow.repair.migrationPreview', lang));
         }
+        // N1-2：孤儿 op 对账报告（A2：默认只报告，不删任何条目）
+        const orphans = result.orphans;
+        if (orphans && orphans.keyOrphans.length + orphans.fileOrphans.length > 0) {
+            console.log('\n' + t('flow.repair.orphansTitle', lang));
+            if (orphans.keyOrphans.length > 0) {
+                console.log(t('flow.repair.orphanKeyTmpl', lang, {
+                    items: orphans.keyOrphans.map((o) => `${o.stage}.${o.opId}`).join(', '),
+                }));
+            }
+            if (orphans.fileOrphans.length > 0) {
+                // L7-1：文件孤儿只读统计（条数 + 前 5 条清单 + 说明）；按 A6 不提供清理入口
+                console.log(t('flow.repair.fileOrphanTitle', lang) + ` ${orphans.fileOrphans.length}`);
+                const sample = orphans.fileOrphans.slice(0, 5).map((o) => `${o.stage}.${o.opId}`).join(', ');
+                console.log(t('flow.repair.orphanFileTmpl', lang, {
+                    items: sample + (orphans.fileOrphans.length > 5 ? ' …' : ''),
+                }));
+                console.log(t('flow.repair.fileOrphanNote', lang));
+            }
+            // --prune-orphans：仅清理 keyOrphans（正式执行才输出）
+            if (options.pruneOrphans && !options.dryRun && orphans.keyOrphans.length > 0) {
+                console.log(t('flow.repair.pruneOkTmpl', lang, { n: String(orphans.keyOrphans.length) }));
+            }
+        }
     });
     // flow migrate [--dry-run] [--no-backup]
     flow
@@ -830,9 +1336,65 @@ export function registerFlowCommand(program) {
         .command('health')
         .description('全面健康检查 flow.json / 跨文件一致性 / 僵尸状态 / config.yaml 等')
         .option('--quick', '仅检查关键项（phase/current 合法性，跳过其他检查）')
+        .option('--json', 'Output as JSON')
+        .option('--fix', 'Reconcile status.md "Status" field against flow.json (that field only)')
+        .option('--dry-run', 'Preview only (combine with --fix); nothing is written')
         .action((options) => {
         const lang = getCliLang(process.cwd());
         const mgr = createManager();
+        // B2-2：--fix 状态对账（仅回写 status.md「状态」字段；--dry-run 预览不写盘）
+        let reconciled;
+        if (options.fix) {
+            try {
+                reconciled = mgr.reconcileStatusMd({ dryRun: options.dryRun });
+            }
+            catch (err) {
+                // 写盘失败 → 明确错误 + 非 0 退出
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(t('common.errorTmpl', lang, { msg }));
+                process.exit(1);
+                return;
+            }
+        }
+        // B1-3：--json 分支纯 JSON 单文档；退出码语义不变（有 fail → 非 0）
+        if (options.json) {
+            const report = mgr.getHealthReport(options.quick ?? false);
+            const payload = { schemaVersion: 1, ok: report.ok, items: report.items };
+            // 与 op-001 的 health --json 合并字段（--fix 时追加 reconciled）
+            if (reconciled) {
+                payload.reconciled = reconciled;
+            }
+            console.log(JSON.stringify(payload, null, 2));
+            if (!report.ok) {
+                process.exit(1);
+            }
+            return;
+        }
+        // 人类可读：先打印对账结果（仅 --fix 时）
+        if (reconciled) {
+            console.log(t('flow.health.fixTitle', lang));
+            for (const item of reconciled) {
+                console.log(t('flow.health.fixItemTmpl', lang, {
+                    stage: item.stage,
+                    from: item.from || '-',
+                    to: item.to,
+                    result: item.result,
+                }));
+            }
+            if (options.dryRun) {
+                console.log(t('flow.health.fixDryRunNote', lang));
+            }
+            else {
+                const applied = reconciled.filter((i) => i.result === 'applied').length;
+                console.log(t('flow.health.fixAppliedTmpl', lang, { n: String(applied) }));
+            }
+            const skipped = reconciled.filter((i) => i.result === 'skipped-not-found').length;
+            if (skipped > 0) {
+                console.log(t('flow.health.fixSkippedTmpl', lang, { n: String(skipped) }));
+            }
+            console.log(t('flow.health.fixOnlyStatusNote', lang));
+            console.log('');
+        }
         console.log(t('flow.health.title', lang) + '\n');
         const result = mgr.healthCheck(options.quick ?? false);
         // 图标映射
@@ -913,6 +1475,12 @@ export function registerFlowCommand(program) {
         .description('交互式流水线向导，逐步推进阶段')
         .action(async () => {
         const lang = getCliLang(process.cwd());
+        // 非 TTY 守卫：脚本/CI 中不渲染 ANSI 交互，输出等价指引并非 0 退出（T39）
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            console.error(t('flow.wizard.nonTtyHint', lang));
+            process.exitCode = 1;
+            return;
+        }
         const mgr = createManager();
         if (!mgr.isLoaded()) {
             console.log(t('common.noInit', lang));
@@ -1056,16 +1624,14 @@ export function registerFlowCommand(program) {
             }
         }
         catch (err) {
-            // 并发冲突：本次未写入 flow.json，输出可重试提示并退出码 2（R3.2）
+            // 并发写冲突：统一单点（i18n 文案 + 退出码 2）
             if (isFlowConcurrentError(err)) {
-                console.error(`[并发冲突] flow.json 已被其它进程修改（期望 revision=${err.expectedRevision}，磁盘=${err.actualRevision}）。`);
-                console.error('本次修改未写入。请重新执行该命令重试。');
-                process.exit(2);
-            }
-            // 非 TTY 环境或用户中断等异常
-            if (err instanceof Error) {
-                console.error(t('common.errorTmpl', lang, { msg: err.message }));
+                handleConcurrentConflict(err, lang);
             }
+            // 失败：统一错误模板 + 非 0 退出（T39）
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(t('common.errorTmpl', lang, { msg }));
+            process.exitCode = 1;
         }
     });
 }
@@ -1073,6 +1639,33 @@ export function registerFlowCommand(program) {
 function createManager() {
     return new FlowManager(process.cwd());
 }
+/**
+ * 断言不存在阻塞中的 open REV（REV 闭环兜底，B5-3 / REV-52-001）。
+ * 命中 → 打印列出并返回命中的 REV 列表（调用方决定退出码与文案）；无命中 → 空数组。
+ * 单步 advance 与多步循环共用（禁止双实现）。
+ * @param mgr FlowManager 实例
+ * @param stage 阶段 ID（可选；未提供时返回空）
+ * @param lang 语言标识（保留参数，供后续 i18n 化）
+ */
+function assertNoBlockingOpenRev(mgr, stage, lang) {
+    if (!stage) {
+        return [];
+    }
+    // REV-007：补 `.` 分隔符（与 core flow-manager.ts 的 stageId + '.' 范式一致），避免 stageId 前缀重叠误拦
+    const stageReviews = mgr.getReviewItems().filter((r) => r.op === stage || r.op.startsWith(stage + '.'));
+    const blockingOpen = stageReviews.filter((r) => r.blocking !== false && r.status === 'open');
+    if (blockingOpen.length > 0) {
+        console.warn(t('flow.advance.revBlockedTitleTmpl', lang, { n: String(blockingOpen.length) }));
+        for (const rev of blockingOpen) {
+            console.warn(t('flow.advance.revBlockedItemTmpl', lang, {
+                id: rev.id,
+                title: rev.title,
+                priority: rev.priority,
+            }));
+        }
+    }
+    return blockingOpen;
+}
 /** 格式化毫秒时长为人类可读形式 */
 function formatDuration(ms) {
     if (ms <= 0) {
@@ -1091,4 +1684,100 @@ function formatDuration(ms) {
     }
     return `${minutes}m ${seconds}s`;
 }
+/**
+ * 归一化 stage.ops 为 [opId, state] 映射（类型守卫：跳过 null/undefined/数组）。
+ * 供 flow status/overview 的 --json 结构化输出共用。
+ */
+function collectOpStates(stage) {
+    const opsMap = stage.ops && typeof stage.ops === 'object' && !Array.isArray(stage.ops)
+        ? stage.ops
+        : {};
+    const result = {};
+    for (const [opId, op] of Object.entries(opsMap)) {
+        result[opId] = op?.state ?? '';
+    }
+    return result;
+}
+/**
+ * 构建 `flow status --json` 的结构化输出（B1-1）。
+ * 顶层对象 + schemaVersion:1；stages 为数组，ops 为 opId→state 映射；counts 为阶段计数。
+ */
+function buildStatusJson(mgr) {
+    const data = mgr.getData();
+    if (!data) {
+        return {
+            schemaVersion: 1,
+            pipeline: { phase: '', current: { stage: '', op: '' } },
+            stages: [],
+            counts: { total: 0, done: 0, active: 0 },
+        };
+    }
+    const stages = Object.entries(data.stages).map(([id, stage]) => ({
+        id,
+        phase: stage.phase,
+        status: stage.status,
+        deps: stage.deps ?? [],
+        ops: collectOpStates(stage),
+    }));
+    const total = stages.length;
+    const done = stages.filter((s) => s.phase === 'done').length;
+    return {
+        schemaVersion: 1,
+        pipeline: {
+            phase: data.pipeline.phase,
+            current: { stage: data.pipeline.current.stage, op: data.pipeline.current.op },
+        },
+        stages,
+        counts: { total, done, active: total - done },
+    };
+}
+/**
+ * 构建 `flow overview --json` 的结构化输出（B1-5）。
+ * 顶层对象 + schemaVersion:1；含阶段计数、审查统计、健康统计、日志数等。
+ */
+function buildOverviewJson(mgr) {
+    const data = mgr.getData();
+    const phase = mgr.getPhase();
+    const summary = mgr.getSummary();
+    const health = mgr.healthCheck(true); // quick mode（与人类可读分支一致）
+    const stages = data
+        ? Object.entries(data.stages).map(([id, stage]) => {
+            const ops = collectOpStates(stage);
+            const states = Object.values(ops);
+            return {
+                id,
+                phase: stage.phase,
+                status: stage.status,
+                opsTotal: states.length,
+                opsDone: states.filter((s) => s === 'done').length,
+            };
+        })
+        : [];
+    const reviews = data?.reviews ?? [];
+    const openReviews = reviews.filter((r) => r.status === 'open');
+    return {
+        schemaVersion: 1,
+        phase: phase ?? '',
+        current: {
+            stage: data?.pipeline.current.stage ?? '',
+            op: data?.pipeline.current.op ?? '',
+        },
+        summary,
+        stages,
+        reviews: {
+            open: openReviews.length,
+            blockingOpen: openReviews.filter((r) => r.blocking !== false).length,
+            nonBlockingOpen: openReviews.filter((r) => r.blocking === false).length,
+            resolved: reviews.filter((r) => r.status === 'resolved').length,
+            closed: reviews.filter((r) => r.status === 'closed').length,
+        },
+        health: {
+            ok: health.ok,
+            pass: health.items.filter((i) => i.status === 'pass').length,
+            warn: health.items.filter((i) => i.status === 'warn').length,
+            fail: health.items.filter((i) => i.status === 'fail').length,
+        },
+        logs: data?.log.length ?? 0,
+    };
+}
 //# sourceMappingURL=flow.js.map