openfeel 1.2.0 → 1.2.1

package/dist/commands/flow.js

@@ -1,12 +1,13 @@
 import { execSync } from 'node:child_process';
 import { existsSync, copyFileSync, readFileSync, rmSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { FlowManager, isFlowConcurrentError, normalizeAgentName, detectFillState, PHASE_PATH_MAX_DEPTH } from '../core/flow-manager.js';
-import { PipelinePhaseSchema, PIPELINE_PHASES } from '../core/pipeline-schema.js';
+import { FlowManager, isFlowConcurrentError, normalizeAgentName, detectFillState, MODE_DERIVED_TIER, PHASE_PATH_MAX_DEPTH } from '../core/flow-manager.js';
+import { PipelinePhaseSchema, PIPELINE_PHASES, REVIEW_TIERS, TIER_PRUNED_PHASES } from '../core/pipeline-schema.js';
 import { validateStageId, suggestStageId, normalizeStageId, findStageStatusPath, isArchivedVersionOf } from '../core/plan/path.js';
 import { getConfigFieldLegalValues, setConfigValue } from '../core/config.js';
 import { parse as parseYaml } from 'yaml';
-import { MetricsStore } from '../core/metrics.js';
+import { MetricsStore, PHASE_AGENT_MAP } from '../core/metrics.js';
+import { runtimeLog } from '../core/runtime-log.js';
 import { addReviewEntry } from '../core/view/entry.js';
 import { handleAddStageError, handleConcurrentConflict } from './shared/errors.js';
 import { t, getCliLang } from '../core/i18n.js';
@@ -348,7 +349,7 @@ export function registerFlowCommand(program) {
         .command('phases')
         .description('列出全部合法 phase 及其流转映射（自描述）')
         .option('--json', 'Output { phases, transitions, advanceAccepted, schemaVersion } as JSON')
-        .option('--mode <mode>', '显式指定工作流模式（full | fast；缺省经 --stage / 当前阶段派生）')
+        .option('--mode <mode>', '显式指定工作流模式（full | fast | general；缺省经 --stage / 当前阶段派生）')
         .option('--stage <id>', '按指定阶段的模式展示转移表（缺省 = 当前阶段）')
         .action((options) => {
         const projectPath = process.cwd();
@@ -399,7 +400,8 @@ export function registerFlowCommand(program) {
         if (options.json) {
             // advanceAccepted = 内置 15 phase（flow advance 的推进白名单），与 phases（运行时存在视图，可含自定义）显式区分
             // 既有三字段（phases/transitions/advanceAccepted）+ transitionsDiff 逐字保留；schemaVersion 与 workflowMode 追加于末位（B1-6 / stage-75 op-002）
-            console.log(JSON.stringify({ schemaVersion: 1, phases, transitions, advanceAccepted: [...PIPELINE_PHASES], transitionsDiff, workflowMode: derivedMode }, null, 2));
+            // reviewTier 再追加于末位（stage-92 op-001；既有 6 键逐字保留、顺序不变）
+            console.log(JSON.stringify({ schemaVersion: 1, phases, transitions, advanceAccepted: [...PIPELINE_PHASES], transitionsDiff, workflowMode: derivedMode, reviewTier: MODE_DERIVED_TIER[derivedMode] }, null, 2));
             return;
         }
         console.log(t('flow.phases.title', lang));
@@ -411,6 +413,9 @@ export function registerFlowCommand(program) {
         // 模式分节行（stage-75 op-002：模式 + 来源 + 查看指引）
         console.log(t('flow.mode.lineTmpl', lang, { mode: derivedMode, source: explicitMode ? '--mode' : resolved.source }));
         console.log(t('flow.phases.modeHint', lang));
+        // 审查档位分节行（stage-92 op-001：档位 + 来源（模式派生）+ 查看指引；档位仅由模式**派生展示**，不改变推进语义）
+        console.log(t('flow.phases.tierLineTmpl', lang, { tier: MODE_DERIVED_TIER[derivedMode], mode: derivedMode }));
+        console.log(t('flow.phases.tierHint', lang));
         console.log(t('flow.phases.transitionsLabel', lang) + ':');
         for (const [key, targets] of Object.entries(transitions)) {
             console.log(`  ${key} → [${targets.join(', ')}]`);
@@ -475,6 +480,7 @@ export function registerFlowCommand(program) {
         const modes = {
             full: mgr.getPipelineTransitions('full'),
             fast: mgr.getPipelineTransitions('fast'),
+            general: mgr.getPipelineTransitions('general'),
         };
         if (options.json) {
             // 未初始化亦保纯 JSON 单文档（stage 空串 + 无 stage 域级联解析值）
@@ -722,6 +728,7 @@ export function registerFlowCommand(program) {
         .option('--stage <id>', '阶段 ID（如 stage-03），必须指定')
         .option('--force', '强制执行（跳过非法 phase 校验和阶段跳跃检查，但不可绕过 REV 阻塞检查）')
         .option('--dry-run', '仅验证不执行修改（预览输出）。与 --force 组合时跳过校验但仍不执行修改')
+        .option('--review-tier <tier>', '审查档位（full / lean / skip；缺省=按模式派生；仅显式声明时裁剪审查关，不可绕过 REV 阻塞检查）')
         .option('--quiet', '静默非错误输出（成功确认与 Git 警告均不打印）')
         .action((options) => {
         const lang = getCliLang(process.cwd());
@@ -730,6 +737,19 @@ export function registerFlowCommand(program) {
             console.error(t('flow.advance.errorNoStage', lang));
             process.exit(1);
         }
+        // 审查档位值域校验（stage-92 op-001；fail-fast 且**先于任何取值 / 路径解析 / autoRepair 写盘**）
+        // 复用 stage.set.invalidValueTmpl（与 flow phases --mode 同款，零新增键）；非法 → exit 1 零写盘
+        let explicitTier;
+        if (options.reviewTier !== undefined) {
+            if (!REVIEW_TIERS.includes(options.reviewTier)) {
+                console.error(t('stage.set.invalidValueTmpl', lang, { field: '审查档位', value: options.reviewTier, allowed: REVIEW_TIERS.join(', ') }));
+                process.exit(1);
+                return;
+            }
+            explicitTier = options.reviewTier;
+        }
+        // 生效档位：显式声明 ?? full（**不传 = 零裁剪**；派生档仅用于 `flow phases` 展示与提示，不改变推进语义）
+        const effTier = explicitTier ?? 'full';
         const mgr = createManager();
         if (!mgr.isLoaded()) {
             console.error(t('common.errorNoInit', lang));
@@ -781,11 +801,11 @@ export function registerFlowCommand(program) {
         // - 已在 to → no-op 成功
         let phasePath = [options.to];
         if (!options.force) {
-            const pathResult = mgr.findPhasePath(stageArg, options.to);
+            const pathResult = mgr.findPhasePath(stageArg, options.to, effTier);
             if (pathResult.reason === 'no-path' || pathResult.reason === 'ambiguous' || pathResult.reason === 'depth-exceeded') {
                 const data = mgr.getData();
                 const currentPhase = data?.stages[stageArg]?.phase ?? t('common.unknown', lang);
-                const availableTargets = mgr.getAvailablePhases(stageArg);
+                const availableTargets = mgr.getAvailablePhases(stageArg, effTier);
                 if (pathResult.reason === 'ambiguous') {
                     console.error(t('flow.advance.ambiguousTmpl', lang));
                 }
@@ -793,6 +813,12 @@ export function registerFlowCommand(program) {
                     console.error(t('flow.advance.depthExceededTmpl', lang, { max: String(PHASE_PATH_MAX_DEPTH) }));
                 }
                 else {
+                    // general（无流水线）→ 显式错误引导（防御路径：常规写路径不产生 general 阶段态；REV-90-005 / D-90-3）
+                    if (mgr.resolveStageWorkflowMode(stageArg).value === 'general') {
+                        console.error(t('flow.advance.generalNoPipeline', lang, { stage: stageArg }));
+                        process.exit(1);
+                        return;
+                    }
                     console.error(t('flow.advance.noPathTmpl', lang, {
                         from: currentPhase,
                         to: options.to,
@@ -829,6 +855,14 @@ export function registerFlowCommand(program) {
                 console.warn(t('flow.advance.warnSkipReview', lang));
             }
         }
+        // 审查档位协同警告（stage-92 op-001 / D-92-4）：**仅显式声明**非全量档位时输出一行
+        // 非阻断（退出码不变）；`--review-tier full` 与缺省不告警 ⟹ 既有流程零输出回归
+        if (explicitTier === 'lean' || explicitTier === 'skip') {
+            console.warn(t('flow.advance.warnTierTmpl', lang, {
+                tier: explicitTier,
+                gates: TIER_PRUNED_PHASES[explicitTier].join(', '),
+            }));
+        }
         // REV 闭环（命令层兜底）：推进到 done 时检查 blocking REV（单步入口；多步循环每步后另复检，B5-3）
         if (options.to === 'done' && options.stage) {
             const blockingOpen = assertNoBlockingOpenRev(mgr, stageArg, lang);
@@ -853,6 +887,13 @@ export function registerFlowCommand(program) {
             console.log(`  ` + t('common.stage', lang) + `: ${stageArg}`);
             console.log(`  ` + t('flow.advance.dryRunFrom', lang) + `: ${startPhase}`);
             console.log(`  ` + t('flow.advance.dryRunTo', lang) + `: ${options.to}`);
+            // 审查档位行（stage-92 op-001）：仅显式声明时追加（缺省零输出回归）；档位为空裁剪时 gates 显示「(无)」
+            if (explicitTier !== undefined) {
+                console.log(`  ` + t('flow.advance.dryRunTierTmpl', lang, {
+                    tier: explicitTier,
+                    gates: TIER_PRUNED_PHASES[explicitTier].join(', ') || t('common.none', lang),
+                }));
+            }
             if (phasePath.length > 1) {
                 const fullPath = [startPhase, ...phasePath].join(t('flow.advance.pathArrow', lang));
                 console.log(`  ` + t('flow.advance.pathTitle', lang) + ` ${fullPath}`);
@@ -863,13 +904,19 @@ export function registerFlowCommand(program) {
         }
         // 逐步推进（B5-2 / A3）：唯一路径 → 依次调用 advanceStagePhase（保留每步校验/日志/checkpoint）
         // 中间态不回滚（A3）；失败 → 输出「已完成 / 失败点 / 剩余路径」+ exit 1
+        // T1：recordRun 接线（命令层；--dry-run 已于上方提前 return——天然排除）
+        const metricsStore = MetricsStore.getInstance();
+        metricsStore.load(); // 读盘合并（防 save 覆盖历史记录）；幂等
+        const logLenBefore = mgr.getData()?.log.length ?? 0; // 基线回扫上界（排除本次写入；REV-86-002）
+        let metricsRecorded = false;
+        let prevStepDoneMs = 0; // 多步时上一步完成时刻（i>0 的窗口基线）
         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');
+                archived = mgr.advanceStagePhase(stageArg, next, 'cli', explicitTier ? { reviewTier: explicitTier } : undefined);
             }
             catch (err) {
                 if (totalSteps > 1) {
@@ -884,6 +931,21 @@ export function registerFlowCommand(program) {
             }
             archivedAny = archivedAny || archived;
             mgr.save();
+            // T1：对刚退出的 fromPhase 记一条 run（窗口 = 进入该 phase 的转换 → 本次退出）
+            const exitedPhase = i > 0 ? phasePath[i - 1] : startPhase;
+            const agentName = PHASE_AGENT_MAP[exitedPhase];
+            if (agentName) {
+                const baseMs = i > 0 ? prevStepDoneMs : findPhaseEnteredAtMs(mgr, stageArg, exitedPhase, logLenBefore);
+                if (baseMs !== null && baseMs > 0) {
+                    metricsStore.recordRun(agentName, Date.now() - baseMs, 'success', 0);
+                    metricsRecorded = true;
+                }
+                else {
+                    // 无基线 → 跳过不记（不写 0 值污染 avg）；debug 留痕（默认关，不扰输出）
+                    runtimeLog('debug', 'metrics skip (no baseline): stage=' + stageArg + ' phase=' + exitedPhase);
+                }
+            }
+            prevStepDoneMs = Date.now();
             // 归档 commit 必须在 flow.json save 之后执行，确保 commit 包含本次 phase 变更
             if (archived) {
                 mgr.autoCommitOnDone(stageArg);
@@ -912,6 +974,10 @@ export function registerFlowCommand(program) {
                 }
             }
         }
+        // T1：仅本命令内有记录时落盘一次（低并发非关键路径；推进失败提前 exit 则不 save）
+        if (metricsRecorded) {
+            metricsStore.save();
+        }
         // 成功确认（单步与多步统一）；--quiet 完全静默
         if (!options.quiet) {
             console.log(t('flow.advance.okTmpl', lang, { stage: stageArg, to: options.to }));
@@ -2152,6 +2218,38 @@ function hasExplicitProjectDefault(projectPath, key) {
         return false;
     }
 }
+/**
+ * 求「进入 fromPhase 的那次转换」的时间戳（T1 duration 基线；REV-86-002 口径）。
+ * 回扫范围 [0, logLenBefore)——本次命令写入之前的存量条目（天然排除本次新写入）；
+ * 按 detail.to === fromPhase 匹配 advance/reset 转换条目；plan_pending 无转换条目时兜底 register_stage；
+ * 无基线返回 null（调用方跳过不记——不写 0 值）。
+ */
+function findPhaseEnteredAtMs(mgr, stageArg, fromPhase, logLenBefore) {
+    const log = mgr.getData()?.log ?? [];
+    const upper = Math.min(logLenBefore, log.length);
+    for (let k = upper - 1; k >= 0; k--) {
+        const e = log[k];
+        if (e.action !== 'advance_stage_phase' && e.action !== 'reset_stage_phase') {
+            continue;
+        }
+        if (e.detail.stageName !== stageArg || e.detail.to !== fromPhase) {
+            continue;
+        }
+        const ms = Date.parse(e.time);
+        return Number.isNaN(ms) ? null : ms;
+    }
+    if (fromPhase === 'plan_pending') {
+        for (let k = upper - 1; k >= 0; k--) {
+            const e = log[k];
+            if (e.action !== 'register_stage' || e.detail.stageName !== stageArg) {
+                continue;
+            }
+            const ms = Date.parse(e.time);
+            return Number.isNaN(ms) ? null : ms;
+        }
+    }
+    return null;
+}
 /** 创建 FlowManager 实例（使用当前工作目录） */
 function createManager() {
     return new FlowManager(process.cwd());