openfeel 1.1.6 → 1.2.0

package/dist/commands/flow.js

@@ -3,11 +3,18 @@ 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 { validateStageId, suggestStageId, normalizeStageId } from '../core/plan/path.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 { addReviewEntry } from '../core/view/entry.js';
 import { handleAddStageError, handleConcurrentConflict } from './shared/errors.js';
 import { t, getCliLang } from '../core/i18n.js';
+import { ARCHIVE_SCHEMA_VERSION } from '../core/flow-archive/archive-file.js';
+import { listArchivableCandidates, listBlockingOpenRevsForVersion, splitForArchive } from '../core/flow-archive/grouping.js';
+import { normalizeArchiveVersion, writeArchiveFile, addArchivedVersion, applyArchivePipelineDisposition, listArchiveVersions, readArchiveFile } from '../core/flow-archive/archive-ops.js';
+import { archiveHealthItems } from '../core/flow-archive/archive-health.js';
+import { requirementHealthItems } from '../core/req/aggregate.js'; // 需求对账项（stage-83 T3）
 export function registerFlowCommand(program) {
     const flow = program
         .command('flow')
@@ -341,22 +348,58 @@ export function registerFlowCommand(program) {
         .command('phases')
         .description('列出全部合法 phase 及其流转映射（自描述）')
         .option('--json', 'Output { phases, transitions, advanceAccepted, schemaVersion } as JSON')
+        .option('--mode <mode>', '显式指定工作流模式（full | fast；缺省经 --stage / 当前阶段派生）')
+        .option('--stage <id>', '按指定阶段的模式展示转移表（缺省 = 当前阶段）')
         .action((options) => {
-        const lang = getCliLang(process.cwd());
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
         const mgr = createManager();
-        const phases = mgr.getPipelinePhases();
-        const transitions = mgr.getPipelineTransitions();
-        // 运行时 vs 内置默认 transitions 差异（T19：使漂移可见，不补组合键）
-        const defaults = mgr.getDefaultTransitions();
+        // ① --mode 显式值域校验（schema 派生；非法 → exit 1，不进入只读取值）
+        let explicitMode;
+        if (options.mode !== undefined) {
+            const allowed = getConfigFieldLegalValues('workflow_mode') ?? [];
+            if (!allowed.includes(options.mode)) {
+                console.error(t('stage.set.invalidValueTmpl', lang, { field: '工作流模式', value: options.mode, allowed: allowed.join(', ') }));
+                process.exit(1);
+                return;
+            }
+            explicitMode = options.mode;
+        }
+        // ② --stage 校验（格式 + 存在性）：先于任何只读取值
+        let stageArg;
+        if (options.stage !== undefined) {
+            const v = validateStageId(options.stage);
+            if (!v.ok) {
+                console.error(t('common.stageIdInvalidTmpl', lang, { input: options.stage }));
+                console.error(t('common.stageIdSuggestTmpl', lang, { suggest: suggestStageId(projectPath, options.stage) }));
+                process.exit(1);
+                return;
+            }
+            stageArg = normalizeStageId(options.stage) ?? options.stage;
+            const known = new Set(Object.keys(mgr.isLoaded() ? mgr.getData().stages : {}).map((k) => normalizeStageId(k) ?? k));
+            if (!known.has(stageArg) && !findStageStatusPath(projectPath, stageArg)) {
+                console.error(t('common.stageIdInvalidTmpl', lang, { input: options.stage }));
+                console.error(t('common.stageIdSuggestTmpl', lang, { suggest: suggestStageId(projectPath, options.stage) }));
+                process.exit(1);
+                return;
+            }
+        }
+        // ③ 单点派生：显式 --mode 优先，否则经 --stage / 当前阶段级联解析
+        const resolved = mgr.resolveStageWorkflowMode(stageArg);
+        const derivedMode = explicitMode ?? resolved.value;
+        // ④ 显式传 mode（消除无参调用；访问器默认形参保留）
+        const transitions = mgr.getPipelineTransitions(derivedMode);
+        // 运行时 vs 内置默认 transitions 差异（T19：使漂移可见，不补组合键；同模式对比）
+        const defaults = mgr.getDefaultTransitions(derivedMode);
         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 };
+        const phases = mgr.getPipelinePhases();
         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));
+            // 既有三字段（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));
             return;
         }
         console.log(t('flow.phases.title', lang));
@@ -365,6 +408,9 @@ export function registerFlowCommand(program) {
             console.log(`  - ${p}`);
         }
         console.log('');
+        // 模式分节行（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));
         console.log(t('flow.phases.transitionsLabel', lang) + ':');
         for (const [key, targets] of Object.entries(transitions)) {
             console.log(`  ${key} → [${targets.join(', ')}]`);
@@ -391,6 +437,62 @@ export function registerFlowCommand(program) {
         }
         console.log(t('flow.phases.hint', lang));
     });
+    // flow mode — 当前工作流模式与来源（只读）
+    flow
+        .command('mode')
+        .description('显示当前工作流模式与来源（只读）')
+        .option('--stage <id>', '目标阶段（缺省 = 当前阶段）')
+        .option('--json', 'Output as JSON')
+        .action((options) => {
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
+        const mgr = createManager();
+        let key;
+        if (options.stage !== undefined) {
+            const v = validateStageId(options.stage);
+            if (!v.ok) {
+                console.error(t('common.stageIdInvalidTmpl', lang, { input: options.stage }));
+                console.error(t('common.stageIdSuggestTmpl', lang, { suggest: suggestStageId(projectPath, options.stage) }));
+                process.exit(1);
+                return;
+            }
+            key = normalizeStageId(options.stage) ?? options.stage;
+            // 存在性：已注册（flow.json）或有 status.md；二者皆无 → exit 1（防 typo 静默落 config 层）
+            const known = new Set(Object.keys(mgr.isLoaded() ? mgr.getData().stages : {}).map((k) => normalizeStageId(k) ?? k));
+            if (!known.has(key) && !findStageStatusPath(projectPath, key)) {
+                console.error(t('common.stageIdInvalidTmpl', lang, { input: options.stage }));
+                console.error(t('common.stageIdSuggestTmpl', lang, { suggest: suggestStageId(projectPath, options.stage) }));
+                process.exit(1);
+                return;
+            }
+        }
+        else {
+            // 缺省 = 当前阶段；无 current 时 undefined（级联仍可解析 config/builtin）
+            key = mgr.getData()?.pipeline?.current?.stage || undefined;
+        }
+        // 唯一解析入口（禁第二套来源判定）
+        const resolved = mgr.resolveStageWorkflowMode(key);
+        const modes = {
+            full: mgr.getPipelineTransitions('full'),
+            fast: mgr.getPipelineTransitions('fast'),
+        };
+        if (options.json) {
+            // 未初始化亦保纯 JSON 单文档（stage 空串 + 无 stage 域级联解析值）
+            console.log(JSON.stringify({ schemaVersion: 1, stage: key ?? '', mode: resolved.value, source: resolved.source, modes }, null, 2));
+            return;
+        }
+        if (!mgr.isLoaded()) {
+            console.log(t('common.noInit', lang));
+            return;
+        }
+        console.log(t('flow.mode.lineTmpl', lang, { mode: resolved.value, source: resolved.source }));
+        // 阶段 phase 已知时补可达目标行（同源 getAvailablePhases）
+        const phase = key ? mgr.getData()?.stages[key]?.phase : undefined;
+        if (key && phase) {
+            console.log(t('flow.mode.targetsLabel', lang, { stage: key, phase, targets: mgr.getAvailablePhases(key).join(', ') }));
+        }
+        // 只读保证：不 save()、不 appendLog、不写任何文件
+    });
     // flow stage — 阶段管理子命令组
     const stageCmd = flow
         .command('stage')
@@ -528,7 +630,12 @@ export function registerFlowCommand(program) {
             .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));
+        // 已归档依赖（显式版本前缀 ∧ 版本 ∈ archived_versions）→ 视为已满足（同 plan.ts 单一口径；恒传原始 d）
+        const archivedOk = deps.filter((d) => !known.has(normalizeStageId(d) ?? d) && isArchivedVersionOf(d, data.meta?.archived_versions));
+        const invalid = deps.filter((d) => !known.has(normalizeStageId(d) ?? d) && !isArchivedVersionOf(d, data.meta?.archived_versions));
+        if (archivedOk.length > 0) {
+            console.log(t('stage.set.archivedDepsTmpl', lang, { deps: archivedOk.join(', ') }));
+        }
         if (invalid.length > 0) {
             console.error(t('stage.set.depsDanglingTmpl', lang, { deps: invalid.join(', ') }));
             process.exit(1);
@@ -611,7 +718,7 @@ export function registerFlowCommand(program) {
         .command('advance')
         .description('推进流水线阶段')
         .option('--op <id>', '操作 ID（如 stage-01.op-001），仅用于日志/展示')
-        .requiredOption('--to <phase>', '目标阶段（如 exec_running）。合法 phase 与转移表：openfeel flow phases')
+        .requiredOption('--to <phase>', '目标阶段（如 exec_running）。合法 phase 与转移表：openfeel flow phases；查看当前模式：openfeel flow mode')
         .option('--stage <id>', '阶段 ID（如 stage-03），必须指定')
         .option('--force', '强制执行（跳过非法 phase 校验和阶段跳跃检查，但不可绕过 REV 阻塞检查）')
         .option('--dry-run', '仅验证不执行修改（预览输出）。与 --force 组合时跳过校验但仍不执行修改')
@@ -1416,6 +1523,253 @@ export function registerFlowCommand(program) {
             process.exit(1);
         }
     });
+    // flow archive <version> — flow.json 版本分片归档（裁定 O2；与顶层 openfeel archive〔阶段摘要〕职责分离，裁定 O3）
+    const archiveCmd = flow
+        .command('archive')
+        .description('flow.json 版本分片归档（按版本号归档已收官历史）')
+        .argument('<version>', '版本号（如 v1.1.7；前缀 v 可省略）')
+        .option('--dry-run', '仅预览（判据门照常校验；零写盘）')
+        .option('--json', '以 JSON 输出 (machine-readable, single JSON document)')
+        .action((versionInput, options) => {
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
+        const mgr = createManager();
+        // --json 失败出口统一：纯 JSON 单文档 + exit 1（不混人类文案、不走 stderr）
+        const failJson = (payload) => {
+            console.log(JSON.stringify({ schemaVersion: 1, ...payload }, null, 2));
+            process.exitCode = 1;
+        };
+        if (!mgr.isLoaded()) {
+            if (options.json) {
+                failJson({ error: 'no-init' });
+                return;
+            }
+            console.error(t('common.errorNoInit', lang));
+            process.exitCode = 1;
+            return;
+        }
+        // 版本归一（REV-79-004）：去 v 再加 v；非法 → exit 1 零写盘
+        const version = normalizeArchiveVersion(versionInput);
+        if (!version) {
+            if (options.json) {
+                failJson({ error: 'invalid-version', input: versionInput });
+                return;
+            }
+            console.error(t('flow.archive.invalidVersionTmpl', lang, { input: versionInput }));
+            process.exitCode = 1;
+            return;
+        }
+        const data = mgr.getData();
+        // 版本存在性门（前置；REV-79-001）：无候选（不存在/已归档）→ 拒绝零写盘；覆盖写仅限活跃集仍含该版本条目
+        const candidate = listArchivableCandidates(data).find((c) => c.version === version);
+        if (!candidate) {
+            if (options.json) {
+                failJson({ error: 'version-not-active', version });
+                return;
+            }
+            console.error(t('flow.archive.versionNotActiveTmpl', lang, { version }));
+            process.exitCode = 1;
+            return;
+        }
+        // 判据门：全 done（candidate.allDone 空集守卫）+ 无 blocking open REV（全仓唯一谓词，REV-79-002）
+        const notDone = candidate.stages.filter((id) => data.stages[id]?.phase !== 'done');
+        const blockingOpen = listBlockingOpenRevsForVersion(data, version);
+        if (!candidate.allDone || blockingOpen.length > 0) {
+            if (options.json) {
+                failJson({ error: 'gate-rejected', version, notDone, blockingOpen: blockingOpen.map((r) => r.id) });
+                return;
+            }
+            if (notDone.length > 0) {
+                console.error(t('flow.archive.gateNotDoneTitleTmpl', lang, { version, n: String(notDone.length) }));
+                for (const id of notDone) {
+                    console.error(t('flow.archive.gateItemTmpl', lang, { item: id + ' [' + (data.stages[id]?.phase ?? '') + ']' }));
+                }
+            }
+            if (blockingOpen.length > 0) {
+                console.error(t('flow.archive.gateBlockingRevTitleTmpl', lang, { version, n: String(blockingOpen.length) }));
+                for (const r of blockingOpen) {
+                    console.error(t('flow.archive.gateItemTmpl', lang, { item: r.id + ': ' + r.title + ' (priority=' + r.priority + ')' }));
+                }
+            }
+            console.error(t('flow.archive.gateRejected', lang));
+            process.exitCode = 1;
+            return;
+        }
+        // 切分（纯函数；禁命令层第二套解析/切分）
+        const { archive, remainder } = splitForArchive(data, version);
+        const counts = archive.counts;
+        // 装配（REV-79-009）：SplitResult.archive 不含 schemaVersion / archived_at
+        const file = { ...archive, schemaVersion: ARCHIVE_SCHEMA_VERSION, archived_at: new Date().toISOString() };
+        // --dry-run：纯内存推演（不写归档文件 / 不 addArchivedVersion / 不 appendLog / 不 save）——四写盘点零触碰
+        if (options.dryRun) {
+            // 深拷 pipeline（REV-79-015）：处置 helper 会就地改 current/phase，预览不得污染 live data
+            const previewData = {
+                ...data,
+                stages: remainder.stages,
+                reviews: remainder.reviews,
+                log: remainder.log,
+                pipeline: { ...data.pipeline, current: { ...data.pipeline.current } },
+            };
+            const preview = applyArchivePipelineDisposition(previewData, version);
+            if (options.json) {
+                console.log(JSON.stringify({ schemaVersion: 1, version, stages: counts.stages, reviews: counts.reviews, log: counts.log, dryRun: true }, null, 2));
+                return;
+            }
+            console.log(t('flow.archive.previewTmpl', lang, { version, stages: String(counts.stages), reviews: String(counts.reviews), log: String(counts.log) }));
+            console.log(t('flow.archive.pipelineTmpl', lang, {
+                current: preview.currentCleared ? t('common.none', lang) : (previewData.pipeline.current.stage || t('common.none', lang)),
+                phase: preview.phase,
+            }));
+            console.log(t('flow.archive.previewNoWrite', lang));
+            return;
+        }
+        // ① 先写归档文件（新增；独立锁 flow-archive，与 flow 锁不嵌套）
+        try {
+            writeArchiveFile(projectPath, file);
+        }
+        catch (err) {
+            // 写盘失败（REV-79-013）：内存未改动（移除/索引/审计均在其后），无需回滚；exit 1 零 flow.json 变更
+            if (options.json) {
+                failJson({ error: 'archive-write-failed', version });
+                return;
+            }
+            console.error(t('common.errorTmpl', lang, { msg: err instanceof Error ? err.message : String(err) }));
+            process.exitCode = 1;
+            return;
+        }
+        // ② 内存移除（stages / reviews / log 三段）
+        data.stages = remainder.stages;
+        data.reviews = remainder.reviews;
+        data.log = remainder.log;
+        // ③ 索引（幂等去重；纯内存）
+        const added = addArchivedVersion(data, version);
+        // ④ pipeline 处置（纯内存；空集 → active，与 flow-manager.ts:1495-1496 守卫同效）
+        const disposed = applyArchivePipelineDisposition(data, version);
+        // ⑤ 审计（须晚于 ②，记录在归档后 flow.json——不混入被归档段）
+        mgr.appendLog({ time: '', agent: 'cli', action: 'archive_flow_version', detail: { version, stages: counts.stages, reviews: counts.reviews, log: counts.log } });
+        // ⑥ 后 save()（顺序不变量：归档文件写成功之前不改 flow.json）
+        try {
+            mgr.save();
+        }
+        catch (err) {
+            if (isFlowConcurrentError(err)) {
+                handleConcurrentConflict(err, lang); // exit 2（归档文件已落盘；重跑幂等收敛）
+                return;
+            }
+            console.error(t('common.errorTmpl', lang, { msg: err instanceof Error ? err.message : String(err) }));
+            process.exitCode = 1;
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify({ schemaVersion: 1, version, stages: counts.stages, reviews: counts.reviews, log: counts.log, dryRun: false }, null, 2));
+            return;
+        }
+        if (added) {
+            console.log(t('flow.archive.doneTmpl', lang, { version, stages: String(counts.stages), reviews: String(counts.reviews), log: String(counts.log) }));
+        }
+        else {
+            console.log(t('flow.archive.rearchivedTmpl', lang, { version }));
+        }
+        console.log(t('flow.archive.pipelineTmpl', lang, {
+            current: disposed.currentCleared ? t('common.none', lang) : (data.pipeline.current.stage || t('common.none', lang)),
+            phase: disposed.phase,
+        }));
+    });
+    // flow archive list — 列出已归档版本及计数（只读；引擎字典序）
+    archiveCmd
+        .command('list')
+        .description('列出已归档版本及计数（只读）')
+        .option('--json', '以 JSON 输出 (machine-readable, single JSON document)')
+        .action((options, command) => {
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
+        // 父命令 archive 亦声明 --json，Commander 派发子命令前会先由父命令消费该标志
+        // → 合并父级 opts（否则 `flow archive list --json` 的 --json 不可达；REV-79-018）
+        const json = options.json === true || command.parent?.opts().json === true;
+        // 引擎字典序（零命令层第二套排序）；逐文件 counts 经读侧复用（损坏 → null）
+        const rows = listArchiveVersions(projectPath).map((v) => ({
+            version: v,
+            counts: readArchiveFile(projectPath, v)?.counts ?? null,
+        }));
+        if (json) {
+            console.log(JSON.stringify({ schemaVersion: 1, versions: rows }, null, 2));
+            return;
+        }
+        if (rows.length === 0) {
+            console.log(t('flow.archive.list.empty', lang));
+            return;
+        }
+        console.log(t('flow.archive.list.title', lang));
+        for (const r of rows) {
+            if (r.counts) {
+                console.log(t('flow.archive.list.itemTmpl', lang, {
+                    version: r.version, stages: String(r.counts.stages), reviews: String(r.counts.reviews), log: String(r.counts.log),
+                }));
+            }
+            else {
+                console.log(t('flow.archive.list.unreadableTmpl', lang, { version: r.version }));
+            }
+        }
+        // 只读保证：不 save()、不 appendLog、不读 flow.json
+    });
+    // flow archive show <version> — 查看指定归档版本（只读）
+    archiveCmd
+        .command('show')
+        .description('查看指定归档版本（只读）')
+        .argument('<version>', '版本号（如 v1.1.7；前缀 v 可省略）')
+        .option('--json', '以 JSON 输出（全量，含 log / reviews）')
+        .action((versionInput, options, command) => {
+        const projectPath = process.cwd();
+        const lang = getCliLang(projectPath);
+        // 同 list：合并父级 --json（REV-79-018）
+        const json = options.json === true || command.parent?.opts().json === true;
+        const available = listArchiveVersions(projectPath);
+        // 版本归一（前缀兼容）：非法 → exit 1 零写盘
+        const version = normalizeArchiveVersion(versionInput);
+        if (!version) {
+            if (json) {
+                console.log(JSON.stringify({ schemaVersion: 1, error: 'invalid-version', input: versionInput, available }, null, 2));
+                process.exitCode = 1;
+                return;
+            }
+            console.error(t('flow.archive.invalidVersionTmpl', lang, { input: versionInput }));
+            process.exitCode = 1;
+            return;
+        }
+        const file = readArchiveFile(projectPath, version);
+        if (!file) {
+            if (json) {
+                console.log(JSON.stringify({ schemaVersion: 1, error: 'not-found', version, available }, null, 2));
+                process.exitCode = 1;
+                return;
+            }
+            console.error(t('flow.archive.show.notFoundTmpl', lang, {
+                version, versions: available.length > 0 ? available.join(', ') : t('common.none', lang),
+            }));
+            process.exitCode = 1;
+            return;
+        }
+        // --json = 全量载荷（ArchiveFile 原文自带 schemaVersion:1，含 log / reviews）——显式请求才取全量（REV-79-003）
+        if (json) {
+            console.log(JSON.stringify(file, null, 2));
+            return;
+        }
+        console.log(t('flow.archive.show.titleTmpl', lang, { version, at: typeof file.archived_at === 'string' ? file.archived_at : '' }));
+        console.log(t('flow.archive.show.countsTmpl', lang, {
+            stages: String(file.counts.stages), reviews: String(file.counts.reviews), log: String(file.counts.log),
+        }));
+        console.log(t('flow.archive.show.stagesLabel', lang));
+        const entries = Object.entries(file.stages ?? {});
+        if (entries.length === 0) {
+            console.log(t('common.noData', lang));
+        }
+        else {
+            for (const [id, stage] of entries) {
+                console.log(t('flow.archive.show.stageLineTmpl', lang, { stage: id, phase: stage?.phase ?? '' }));
+            }
+        }
+        console.log(t('flow.archive.show.fullHint', lang));
+    });
     // flow health [--quick]
     flow
         .command('health')
@@ -1427,6 +1781,15 @@ export function registerFlowCommand(program) {
         .action((options) => {
         const lang = getCliLang(process.cwd());
         const mgr = createManager();
+        const quick = options.quick ?? false;
+        // 归档一致性检查项（T2）：warn-only；--quick 跳过；flow.json 未加载 → 跳过（与既有检查降级一致）
+        const archiveItems = !quick && mgr.isLoaded()
+            ? archiveHealthItems({ projectPath: process.cwd(), data: mgr.getData() })
+            : [];
+        // 需求对账检查项（stage-83 T3）：warn-only（悬空关联 / done 漂移）；--quick 跳过；未加载 → 跳过
+        const reqItems = !quick && mgr.isLoaded()
+            ? requirementHealthItems({ data: mgr.getData(), lang })
+            : [];
         // B2-2：--fix 状态对账（仅回写 status.md「状态」字段；--dry-run 预览不写盘）
         let reconciled;
         if (options.fix) {
@@ -1443,8 +1806,14 @@ export function registerFlowCommand(program) {
         }
         // 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 };
+            const report = mgr.getHealthReport(quick);
+            // 合并追加归档一致性项（warn-only，恒无 fail → ok / 退出码不变）
+            const items = [
+                ...report.items,
+                ...archiveItems.map((i) => ({ name: i.section, status: i.status, detail: i.message })),
+                ...reqItems.map((i) => ({ name: i.section, status: i.status, detail: i.message })),
+            ];
+            const payload = { schemaVersion: 1, ok: report.ok, items };
             // 与 op-001 的 health --json 合并字段（--fix 时追加 reconciled）
             if (reconciled) {
                 payload.reconciled = reconciled;
@@ -1481,7 +1850,7 @@ export function registerFlowCommand(program) {
             console.log('');
         }
         console.log(t('flow.health.title', lang) + '\n');
-        const result = mgr.healthCheck(options.quick ?? false);
+        const result = mgr.healthCheck(quick);
         // 图标映射
         const icon = (status) => {
             if (status === 'pass')
@@ -1490,7 +1859,8 @@ export function registerFlowCommand(program) {
                 return '⚠️ ';
             return '❌';
         };
-        for (const item of result.items) {
+        // 合并追加归档一致性项（warn-only；--quick 时 archiveItems 恒空）
+        for (const item of [...result.items, ...archiveItems, ...reqItems]) {
             console.log(`${icon(item.status)} ${item.section}: ${item.message}`);
         }
         console.log('');
@@ -1641,6 +2011,32 @@ export function registerFlowCommand(program) {
                     console.log(t('flow.wizard.unavailable', lang));
                     return;
                 }
+                // stage-75 T4：首次选型 + 项目级记忆（TTY + 阶段无字段 + 项目未显式设默认 → 询问一次）
+                {
+                    const modeResolved = mgr.resolveStageWorkflowMode(currentStage);
+                    const stageHasField = modeResolved.source === 'status.md';
+                    const projectHasDefault = hasExplicitProjectDefault(process.cwd(), 'workflow_mode');
+                    if (shouldPromptWorkflowMode(stageHasField, projectHasDefault) === 'prompt') {
+                        const chosen = (await select({
+                            message: t('flow.wizard.modePrompt', lang),
+                            choices: [
+                                { name: t('flow.wizard.modeFull', lang), value: 'full' },
+                                { name: t('flow.wizard.modeFast', lang), value: 'fast' },
+                            ],
+                        }));
+                        const statusPath = findStageStatusPath(process.cwd(), currentStage);
+                        if (statusPath) {
+                            const r = mgr.insertStatusField(statusPath, currentStage, '工作流模式', chosen);
+                            if (r === 'no-anchor') {
+                                // 错误路径：手工破坏文件（骨架必含锚点）→ 警告而非阻断（D5）
+                                console.error(t('stage.set.noAnchorTmpl', lang, { stageId: currentStage, field: '工作流模式' }));
+                            }
+                        }
+                        // 记忆写入仅 defaults.workflow_mode（增量写、保注释），不覆盖其它 defaults 键
+                        setConfigValue(process.cwd(), 'workflow_mode', chosen);
+                        console.log(t('flow.wizard.modeRememberedTmpl', lang, { mode: chosen }));
+                    }
+                }
                 const stagePhase = data.stages[currentStage].phase;
                 // 显示当前状态
                 console.log('\n' + t('flow.wizard.statusHeader', lang));
@@ -1720,6 +2116,42 @@ export function registerFlowCommand(program) {
         }
     });
 }
+/**
+ * 「是否询问工作流模式」决策矩阵（stage-75 T4，D4）。
+ * 仅当阶段 status.md 无「工作流模式」字段 **且** 项目 config.yaml 未显式设 `defaults.workflow_mode` 时询问；
+ * 其余 3 态（有字段 / 有项目默认 / 两者皆有）一律 skip（保持既有推进流不变）。
+ * @param stageHasField 阶段 status.md 是否已有「工作流模式」字段
+ * @param projectHasDefault 项目 config.yaml 是否**显式**设过 `defaults.workflow_mode`
+ */
+export function shouldPromptWorkflowMode(stageHasField, projectHasDefault) {
+    return !stageHasField && !projectHasDefault ? 'prompt' : 'skip';
+}
+/**
+ * 项目 config.yaml 是否**显式**声明了 `defaults.{key}`（stage-75 T4，D3）。
+ * 必须**裸读 YAML**：`getConfigValue` 经 `ConfigDefaultsSchema` 逐键 `.default()` 填充，
+ * 缺失键亦返回 schema 默认值（实测恒 `fast`），无法区分「设过」与「未设」。
+ * 文件缺失 / 解析失败 / 无 defaults 块 / 非对象 → false（视为未显式设置）。
+ * @param projectPath 项目根路径
+ * @param key defaults 下的配置键（如 workflow_mode）
+ */
+function hasExplicitProjectDefault(projectPath, key) {
+    try {
+        const configPath = resolve(projectPath, '.openfeel', 'config.yaml');
+        if (!existsSync(configPath)) {
+            return false;
+        }
+        const raw = parseYaml(readFileSync(configPath, 'utf-8'));
+        const defaults = raw?.defaults;
+        if (!defaults || typeof defaults !== 'object') {
+            return false;
+        }
+        return Object.prototype.hasOwnProperty.call(defaults, key);
+    }
+    catch {
+        // 错误路径：YAML 解析失败 → 视为未显式设置（不阻断向导）
+        return false;
+    }
+}
 /** 创建 FlowManager 实例（使用当前工作目录） */
 function createManager() {
     return new FlowManager(process.cwd());