openfeel 1.2.0 → 1.2.3

package/dist/core/fs/file-lock.js

@@ -38,6 +38,25 @@ export function globalLockPath(name) {
 function sleepSync(ms) {
     Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 }
+/**
+ * 测试专用默认值解析（REV-98-006①；非公开 CLI 契约）。
+ * 仅当 `OPENFEEL_TEST_MODE=1` 时读取 env（gate off 时零副作用）；
+ * `Number(raw)` 且为正整数才生效，非法/缺失一律回落既有默认。
+ * 必须在函数体内读取 env（不得提为模块级常量），保证子进程 E2E 可注入。
+ * @param envKey 测试 env 键名
+ * @param fallback 生产默认值
+ */
+export function resolveTestLockDefault(envKey, fallback) {
+    if (process.env.OPENFEEL_TEST_MODE !== '1') {
+        return fallback;
+    }
+    const raw = process.env[envKey];
+    if (raw === undefined || raw === '') {
+        return fallback;
+    }
+    const n = Number(raw);
+    return Number.isInteger(n) && n > 0 ? n : fallback;
+}
 /** 读取锁文件内容；读取/解析失败返回 null */
 function readLockInfo(lockPath) {
     try {
@@ -88,7 +107,14 @@ function tryReclaimStale(lockPath, staleMs) {
  * @throws 超过 timeoutMs 仍无法获取锁时抛出；fn 自身抛错原样透传
  */
 export function withFileLock(lockPath, fn, options = {}) {
-    const { timeoutMs = LOCK_TIMEOUT_MS_DEFAULT, staleMs = LOCK_STALE_MS_DEFAULT, initialBackoffMs = LOCK_INITIAL_BACKOFF_MS_DEFAULT, maxBackoffMs = LOCK_MAX_BACKOFF_MS_DEFAULT, } = options;
+    // 显式 options > 测试 env seam（仅 OPENFEEL_TEST_MODE=1 生效）> 生产默认常量
+    const timeoutMs = options.timeoutMs === undefined
+        ? resolveTestLockDefault('OPENFEEL_TEST_LOCK_TIMEOUT_MS', LOCK_TIMEOUT_MS_DEFAULT)
+        : options.timeoutMs;
+    const staleMs = options.staleMs === undefined
+        ? resolveTestLockDefault('OPENFEEL_TEST_LOCK_STALE_MS', LOCK_STALE_MS_DEFAULT)
+        : options.staleMs;
+    const { initialBackoffMs = LOCK_INITIAL_BACKOFF_MS_DEFAULT, maxBackoffMs = LOCK_MAX_BACKOFF_MS_DEFAULT, } = options;
     mkdirSync(dirname(lockPath), { recursive: true });
     const token = randomBytes(8).toString('hex');
     const deadline = Date.now() + timeoutMs;

package/dist/core/fs/file-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../../../src/core/fs/file-lock.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../../../src/core/fs/file-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,SAAS,EACT,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,iBAAiB;AACjB,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAC5C,wCAAwC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,iBAAiB;AACjB,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAClD,eAAe;AACf,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAqB/C,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,IAAY;IAC/D,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,iDAAiD;IACjD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,+BAA+B;AAC/B,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,QAAgB;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED,6BAA6B;AAC7B,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAa,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,OAAe;IACxD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,WAAW;IAC3B,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC,CAAC,MAAM;IACtB,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,QAAQ,UAAU,OAAO,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACvF,IAAI,CAAC;QACH,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,iBAAiB;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,UAAU,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,EAAW,EACX,UAA2B,EAAE;IAE7B,8DAA8D;IAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS;QAC/C,CAAC,CAAC,sBAAsB,CAAC,+BAA+B,EAAE,uBAAuB,CAAC;QAClF,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS;QAC3C,CAAC,CAAC,sBAAsB,CAAC,6BAA6B,EAAE,qBAAqB,CAAC;QAC9E,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACpB,MAAM,EACJ,gBAAgB,GAAG,+BAA+B,EAClD,YAAY,GAAG,2BAA2B,GAC3C,GAAG,OAAO,CAAC;IAEZ,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,IAAI,OAAO,GAAG,gBAAgB,CAAC;IAE/B,YAAY;IACZ,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc;YACnD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAa,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC;gBACrE,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;oBAAS,CAAC;gBACT,SAAS,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,OAAO;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,GAAG,CAAC,CAAC,eAAe;YAC5B,CAAC;QACH,CAAC;QAED,eAAe;QACf,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEnC,OAAO;QACP,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,OAAO,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,2BAA2B;QAC3B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC/C,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,MAAM,CAAC,CAAC;QACpD,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,yCAAyC;QACzC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,IAAI,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/i18n-data/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/core/i18n-data/en.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,MAAM,EAAE,UAwBpB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UA2SlB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAyBlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UAiCpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA8CrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAgCnB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAoClB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,UAiCvB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAOrB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAAe,CAAC;AAGtC,eAAO,MAAM,IAAI,EAAE,UAMlB,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,UAAe,CAAC;AAG3C,eAAO,MAAM,IAAI,EAAE,UAalB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAkSlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UA+BpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA4BrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAqBnB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAenB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UASrB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAMlB,CAAC;AAGF,eAAO,MAAM,GAAG,EAAE,UAwDjB,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAsBlE,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/core/i18n-data/en.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,MAAM,EAAE,UA6BpB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAmUlB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAyBlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UAiCpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA8CrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAgCnB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAoClB,CAAC;AAGF,eAAO,MAAM,SAAS,EAAE,UAiCvB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAOrB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAAe,CAAC;AAGtC,eAAO,MAAM,IAAI,EAAE,UAMlB,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,UAAe,CAAC;AAG3C,eAAO,MAAM,IAAI,EAAE,UAalB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UA2TlB,CAAC;AAGF,eAAO,MAAM,MAAM,EAAE,UA+BpB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UA4BrB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAqBnB,CAAC;AAGF,eAAO,MAAM,KAAK,EAAE,UAenB,CAAC;AAGF,eAAO,MAAM,OAAO,EAAE,UAUrB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAMlB,CAAC;AAGF,eAAO,MAAM,GAAG,EAAE,UA6EjB,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAsBlE,CAAC"}

package/dist/core/i18n-data/en.js

@@ -2,6 +2,10 @@
 export const common = {
     error: { key: 'common.error', zh: '', en: 'Error' },
     errorTmpl: { key: 'common.errorTmpl', zh: '', en: 'Error: {msg}' },
+    invalidArgumentTmpl: { key: 'common.invalidArgumentTmpl', zh: '', en: 'Invalid argument or usage: {detail}' },
+    projectNotFoundTmpl: { key: 'common.projectNotFoundTmpl', zh: '', en: 'Project path does not exist or is not a directory: {path}' },
+    projectMissingValueTmpl: { key: 'common.projectMissingValueTmpl', zh: '', en: '--project requires a path value' },
+    projectConflictTmpl: { key: 'common.projectConflictTmpl', zh: '', en: '--project was given multiple times with different resolved paths: {values}' },
     concurrentConflict: { key: 'common.concurrentConflict', zh: '', en: '[concurrent conflict] flow.json was modified by another process (expected revision={expected}, on-disk={actual}); this change was not written, please retry.' },
     ok: { key: 'common.ok', zh: '', en: '✓' },
     none: { key: 'common.none', zh: '', en: '(none)' },
@@ -23,6 +27,7 @@ export const common = {
     stageIdInvalidTmpl: { key: 'common.stageIdInvalidTmpl', zh: '', en: '{input} → invalid stage ID (expected stage-NN or vX.Y.Z-stage-NN)' },
     stageIdSuggestTmpl: { key: 'common.stageIdSuggestTmpl', zh: '', en: 'Suggested name: {suggest}' },
     stageDirConflictTmpl: { key: 'common.stageDirConflictTmpl', zh: '', en: 'Stage dir conflict: {stage} and {other} map to the same directory' },
+    generalOnlyRequirement: { key: 'common.generalOnlyRequirement', zh: '', en: 'general (General Mode) is valid at the requirement level only — not supported at stage / deployment level; use fast / full for stages.' },
 };
 /* ==================== flow ==================== */
 export const flow = {
@@ -50,6 +55,24 @@ export const flow = {
     'status.lastUpdated': { key: 'flow.status.lastUpdated', zh: '', en: 'Last Updated' },
     'status.recoveryTitle': { key: 'flow.status.recoveryTitle', zh: '', en: '── Cross-Session Recovery Info ──' },
     'status.recoveryMoreTmpl': { key: 'flow.status.recoveryMoreTmpl', zh: '', en: '... {n} more items' },
+    // flow next (dispatch decision, read-only)
+    'next.title': { key: 'flow.next.title', zh: '', en: 'Pipeline next step (read-only)' },
+    'next.stageLabel': { key: 'flow.next.stageLabel', zh: '', en: 'Stage' },
+    'next.phaseLabel': { key: 'flow.next.phaseLabel', zh: '', en: 'Phase' },
+    'next.responsibleAgentLabel': { key: 'flow.next.responsibleAgentLabel', zh: '', en: 'Responsible agent' },
+    'next.workflowModeLabel': { key: 'flow.next.workflowModeLabel', zh: '', en: 'Workflow mode' },
+    'next.displayTierLabel': { key: 'flow.next.displayTierLabel', zh: '', en: 'Display review tier' },
+    'next.effectiveTierLabel': { key: 'flow.next.effectiveTierLabel', zh: '', en: 'Effective review tier' },
+    'next.legalNextPhasesLabel': { key: 'flow.next.legalNextPhasesLabel', zh: '', en: 'Legal next phases' },
+    'next.suggestedCommandLabel': { key: 'flow.next.suggestedCommandLabel', zh: '', en: 'Suggested command' },
+    'next.guardsLabel': { key: 'flow.next.guardsLabel', zh: '', en: 'Guards' },
+    'next.blockingReviewsLabel': { key: 'flow.next.blockingReviewsLabel', zh: '', en: 'Blocking reviews' },
+    'next.blockingReviewItemTmpl': { key: 'flow.next.blockingReviewItemTmpl', zh: '', en: '{id}: {title} (priority {priority}, op {op})' },
+    'next.guardNoActiveStage': { key: 'flow.next.guardNoActiveStage', zh: '', en: 'No active stage (pipeline.current.stage is empty or the stage record is missing): Feel decides the next step' },
+    'next.guardAutoAdvanceDisabled': { key: 'flow.next.guardAutoAdvanceDisabled', zh: '', en: 'Auto-advance is disabled (auto_advance=disabled): ask the user before advancing' },
+    'next.guardBlockingReviewsTmpl': { key: 'flow.next.guardBlockingReviewsTmpl', zh: '', en: '{n} blocking open REV(s) present: resolve before advancing to done' },
+    'next.guardNoLegalTargets': { key: 'flow.next.guardNoLegalTargets', zh: '', en: 'No legal next phase from the current phase (consider --force, adjusting workflow mode, or checking the transition table)' },
+    'next.guardTierDiffTmpl': { key: 'flow.next.guardTierDiffTmpl', zh: '', en: 'Display tier {display} ≠ effective tier {effective} (flow advance defaults to {effective})' },
     'overview.title': { key: 'flow.overview.title', zh: '', en: 'OpenFeel Pipeline Overview' },
     'overview.currentStatus': { key: 'flow.overview.currentStatus', zh: '', en: '📍 Current Status' },
     'overview.stagesOverview': { key: 'flow.overview.stagesOverview', zh: '', en: '📋 Stages Overview' },
@@ -87,6 +110,8 @@ export const flow = {
     'phases.transitionsDiffExtra': { key: 'flow.phases.transitionsDiffExtra', zh: '', en: 'extra keys {keys}' },
     'phases.transitionsDiffChanged': { key: 'flow.phases.transitionsDiffChanged', zh: '', en: 'differing targets {keys}' },
     'phases.modeHint': { key: 'flow.phases.modeHint', zh: '', en: 'Hint: inspect mode source / switch mode: openfeel flow mode [--stage <id>]' },
+    'phases.tierLineTmpl': { key: 'flow.phases.tierLineTmpl', zh: '', en: 'Review tier: {tier} (derived from mode {mode})' },
+    'phases.tierHint': { key: 'flow.phases.tierHint', zh: '', en: 'Hint: the review tier only trims review gates (full / lean / skip); to declare explicitly: openfeel flow advance --review-tier <tier>' },
     'mode.lineTmpl': { key: 'flow.mode.lineTmpl', zh: '', en: 'Workflow mode: {mode}  [source: {source}]' },
     'mode.targetsLabel': { key: 'flow.mode.targetsLabel', zh: '', en: 'Reachable targets ({stage} · {phase}): {targets}' },
     'archive.doneTmpl': { key: 'flow.archive.doneTmpl', zh: '', en: 'Archived {version}: stages {stages} / reviews {reviews} / log {log}' },
@@ -146,13 +171,16 @@ export const flow = {
     'advance.dryRunTitle': { key: 'flow.advance.dryRunTitle', zh: '', en: '═══ Dry-run Preview ═══' },
     'advance.dryRunFrom': { key: 'flow.advance.dryRunFrom', zh: '', en: 'Current phase' },
     'advance.dryRunTo': { key: 'flow.advance.dryRunTo', zh: '', en: 'Target phase' },
+    'advance.dryRunTierTmpl': { key: 'flow.advance.dryRunTierTmpl', zh: '', en: 'Review tier: {tier} (waived gates: {gates})' },
+    'advance.warnTierTmpl': { key: 'flow.advance.warnTierTmpl', zh: '', en: "[!] Review tier '{tier}': this advance waives review gate(s) {gates} (the code review gate is always kept)" },
     'advance.dryRunOk': { key: 'flow.advance.dryRunOk', zh: '', en: '✓ Validation passed. No changes were made to flow.json. Remove --dry-run to execute.' },
     'advance.pathTitle': { key: 'flow.advance.pathTitle', zh: '', en: 'Advance path:' },
     'advance.pathArrow': { key: 'flow.advance.pathArrow', zh: '', en: ' → ' },
     'advance.stepOkTmpl': { key: 'flow.advance.stepOkTmpl', zh: '', en: 'Advanced: {stage} {from} → {to}' },
     'advance.ambiguousTmpl': { key: 'flow.advance.ambiguousTmpl', zh: '', en: 'Multiple equivalent paths; refused. Specify --to step by step' },
     'advance.noPathTmpl': { key: 'flow.advance.noPathTmpl', zh: '', en: 'Cannot reach {to} from {from}; reachable targets: {targets}' },
-    'advance.depthExceededTmpl': { key: 'flow.advance.depthExceededTmpl', zh: '', en: 'Path depth exceeds limit ({max}); refused' },
+    'advance.generalNoPipeline': { key: 'flow.advance.generalNoPipeline', zh: '', en: 'Error: stage "{stage}" uses workflow mode general (no pipeline) — no legal transition targets; to advance, explicitly upgrade to fast / full first.' },
+    'advance.depthExceededTmpl': { key: 'flow.advance.depthExceededTmpl', zh: '', en: 'Path depth exceeds limit ({max}); refused (the target may be unreachable under the current review tier)' },
     'advance.partialFailTmpl': { key: 'flow.advance.partialFailTmpl', zh: '', en: 'Completed up to {done}; failed at {failed}; remaining path: {remaining}' },
     'advance.blockedByRevTmpl': { key: 'flow.advance.blockedByRevTmpl', zh: '', en: 'Blocking review entries found; stopped: {revs}; remaining path: {remaining}' },
     'advance.alreadyAtTargetTmpl': { key: 'flow.advance.alreadyAtTargetTmpl', zh: '', en: 'Already at target: {stage} → {to} (no-op)' },
@@ -562,6 +590,7 @@ export const help = {
     'global.logFile': { key: 'help.global.logFile', zh: '', en: 'Runtime log file path (default ~/.openfeel/cli/logs/openfeel-YYYY-MM-DD.log)' },
     'global.noLog': { key: 'help.global.noLog', zh: '', en: 'Disable runtime log (also via OPENFEEL_LOG=0 / OPENFEEL_NO_LOG=1)' },
     'global.debug': { key: 'help.global.debug', zh: '', en: 'Record debug-level logs (default: info/warn/error only)' },
+    'global.project': { key: 'help.global.project', zh: '', en: 'Project root path (equivalent to running in that directory; defaults to the current directory)' },
     'openfeel.version': { key: 'help.openfeel.version', zh: '', en: 'Output version number' },
     'init': { key: 'help.init', zh: '', en: 'Initialize project workspace, create .openfeel/ directory structure and config files' },
     'init.demo': { key: 'help.init.demo', zh: '', en: 'Create demo project skeleton (NumKit style)' },
@@ -582,6 +611,8 @@ export const help = {
     'flow.status.verbose': { key: 'help.flow.status.verbose', zh: '', en: 'Enhanced output: config cascade, recent changes, downstream agent readiness' },
     'flow.status.lines': { key: 'help.flow.status.lines', zh: '', en: 'Number of recent status changes (default 5)' },
     'flow.status.json': { key: 'help.flow.status.json', zh: '', en: 'Output as JSON (machine-readable, single JSON document)' },
+    'flow.next': { key: 'help.flow.next', zh: '', en: 'Show dispatch decision for the current stage (responsible agent / legal next phases / suggested command / guards / blocking reviews; read-only)' },
+    'flow.next.json': { key: 'help.flow.next.json', zh: '', en: 'Output { schemaVersion, stage, phase, phaseLabel, responsibleAgent, workflowMode, reviewTier, effectiveReviewTier, legalNextPhases, suggestedCommand, guards, blockingReviews } as JSON' },
     'flow.overview': { key: 'help.flow.overview', zh: '', en: 'Full status visualization (openfeel flow overview backend)' },
     'flow.overview.json': { key: 'help.flow.overview.json', zh: '', en: 'Output as JSON' },
     'flow.current': { key: 'help.flow.current', zh: '', en: 'Show current stage and operation' },
@@ -589,8 +620,8 @@ export const help = {
     'flow.metrics': { key: 'help.flow.metrics', zh: '', en: 'Show Agent performance metrics' },
     'flow.metrics.json': { key: 'help.flow.metrics.json', zh: '', en: 'Output as JSON' },
     'flow.phases': { key: 'help.flow.phases', zh: '', en: 'List all valid phases and transitions (self-describing)' },
-    'flow.phases.json': { key: 'help.flow.phases.json', zh: '', en: 'Output { phases, transitions, advanceAccepted, transitionsDiff, schemaVersion, workflowMode } as JSON (advanceAccepted = the built-in 15 phases accepted by flow advance; transitionsDiff = diff report between runtime and built-in default transitions; workflowMode = the workflow mode used for this view)' },
-    'flow.phases.mode': { key: 'help.flow.phases.mode', zh: '', en: 'Explicit workflow mode (full | fast; default derived from --stage / current stage)' },
+    'flow.phases.json': { key: 'help.flow.phases.json', zh: '', en: 'Output { phases, transitions, advanceAccepted, transitionsDiff, schemaVersion, workflowMode, reviewTier, displayReviewTier, effectiveReviewTier } as JSON (advanceAccepted = the built-in 15 phases accepted by flow advance; transitionsDiff = diff report between runtime and built-in default transitions; workflowMode = the workflow mode used for this view; reviewTier = the review tier derived from that mode, kept as a display-tier compatibility alias; displayReviewTier = the display tier (same value as reviewTier); effectiveReviewTier = the default effective tier for flow advance, always full)' },
+    'flow.phases.mode': { key: 'help.flow.phases.mode', zh: '', en: 'Explicit workflow mode (full | fast | general; default derived from --stage / current stage)' },
     'flow.phases.stage': { key: 'help.flow.phases.stage', zh: '', en: "Show the transition table for the given stage's mode (default: current stage)" },
     'flow.mode': { key: 'help.flow.mode', zh: '', en: 'Show current workflow mode and its source (read-only)' },
     'flow.mode.stage': { key: 'help.flow.mode.stage', zh: '', en: 'Target stage (default: current stage)' },
@@ -598,7 +629,7 @@ export const help = {
     'flow.archive': { key: 'help.flow.archive', zh: '', en: 'Archive flow.json slices by version (archives completed history by version prefix; separate from top-level openfeel archive [stage summaries])' },
     'flow.archive.argversion': { key: 'help.flow.archive.argversion', zh: '', en: 'Version (e.g. v1.1.7; the leading v may be omitted)' },
     'flow.archive.dryRun': { key: 'help.flow.archive.dryRun', zh: '', en: 'Preview only (the gate is still checked; zero writes)' },
-    'flow.archive.json': { key: 'help.flow.archive.json', zh: '', en: 'Output { schemaVersion, version, stages, reviews, log, dryRun } as JSON' },
+    'flow.archive.json': { key: 'help.flow.archive.json', zh: '', en: 'Output { schemaVersion, version, stages, reviews, log, dryRun, eligible, unfinishedStages, blockingReviews } as JSON' },
     'flow.archive.list': { key: 'help.flow.archive.list', zh: '', en: 'List archived versions and their counts (read-only; engine lexicographic order)' },
     'flow.archive.list.json': { key: 'help.flow.archive.list.json', zh: '', en: 'Output { schemaVersion, versions: [{version, counts}] } as JSON' },
     'flow.archive.show': { key: 'help.flow.archive.show', zh: '', en: 'Show a given archived version (read-only; human output = counts + stage overview)' },
@@ -624,6 +655,7 @@ export const help = {
     'flow.advance.stage': { key: 'help.flow.advance.stage', zh: '', en: 'Stage ID (e.g. stage-03), required' },
     'flow.advance.force': { key: 'help.flow.advance.force', zh: '', en: 'Force execution (skip invalid phase check and phase jump check, but not REV block check)' },
     'flow.advance.dryRun': { key: 'help.flow.advance.dryRun', zh: '', en: 'Validate only without modifying (preview output). When combined with --force, skips validation but still does not modify' },
+    'flow.advance.reviewTier': { key: 'help.flow.advance.reviewTier', zh: '', en: 'Review tier (full / lean / skip; default = full (zero pruning); the tier trims review gates only when declared explicitly, and cannot bypass the REV block check)' },
     'flow.advance.quiet': { key: 'help.flow.advance.quiet', zh: '', en: 'Silence non-error output (no success confirmation or Git warning)' },
     'flow.attempt': { key: 'help.flow.attempt', zh: '', en: 'Record operation execution result' },
     'flow.attempt.op': { key: 'help.flow.attempt.op', zh: '', en: 'Operation ID (e.g. stage-01.op-001)' },
@@ -634,6 +666,7 @@ export const help = {
     'flow.ops.list.json': { key: 'help.flow.ops.list.json', zh: '', en: 'Output as JSON' },
     'flow.log': { key: 'help.flow.log', zh: '', en: 'Show recent operation logs' },
     'flow.log.last': { key: 'help.flow.log.last', zh: '', en: 'Show last n entries (default 10)' },
+    'flow.log.json': { key: 'help.flow.log.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'flow.review': { key: 'help.flow.review', zh: '', en: 'Manage review entries' },
     'flow.review.add': { key: 'help.flow.review.add', zh: '', en: 'Add review entry' },
     'flow.review.add.op': { key: 'help.flow.review.add.op', zh: '', en: 'Operation ID (e.g. stage-01.op-001)' },
@@ -666,12 +699,14 @@ export const help = {
     'flow.checkpoint': { key: 'help.flow.checkpoint', zh: '', en: 'Checkpoint snapshot management (auto-saves flow.json snapshots on phase advance)' },
     'flow.checkpoint.list': { key: 'help.flow.checkpoint.list', zh: '', en: 'List all (or stage-filtered) checkpoint snapshots' },
     'flow.checkpoint.list.argstage': { key: 'help.flow.checkpoint.list.argstage', zh: '', en: 'Stage ID (optional), e.g. v5.3-stage-01' },
+    'flow.checkpoint.list.json': { key: 'help.flow.checkpoint.list.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'flow.checkpoint.restore': { key: 'help.flow.checkpoint.restore', zh: '', en: 'Restore flow.json from a checkpoint snapshot (overwrites current file, requires --force)' },
     'flow.checkpoint.restore.argcheckpoint-file': { key: 'help.flow.checkpoint.restore.argcheckpoint-file', zh: '', en: 'Checkpoint file name (e.g. v5.3-stage-01-20260807T162300-exec_running.json)' },
     'flow.checkpoint.restore.force': { key: 'help.flow.checkpoint.restore.force', zh: '', en: 'Confirm restore operation (overwrites current flow.json)' },
     'flow.checkpoint.restore.stage': { key: 'help.flow.checkpoint.restore.stage', zh: '', en: 'Restore only the given stage subtree (selective; default full overwrite)' },
     'flow.checkpoint.restore.dryRun': { key: 'help.flow.checkpoint.restore.dryRun', zh: '', en: 'Preview differences only; nothing is written' },
     'flow.recover': { key: 'help.flow.recover', zh: '', en: 'Cross-session context recovery: pipeline status, blockers, and pending tasks' },
+    'flow.recover.json': { key: 'help.flow.recover.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'flow.wizard': { key: 'help.flow.wizard', zh: '', en: 'Interactive pipeline wizard, advance stage by stage' },
     'config.get-lang': { key: 'help.config.get-lang', zh: '', en: 'Show global default language' },
     'config.set-lang': { key: 'help.config.set-lang', zh: '', en: 'Change global default language (zh-CN or en)' },
@@ -679,11 +714,14 @@ export const help = {
     'config': { key: 'help.config', zh: '', en: 'View or modify project config' },
     'config.get': { key: 'help.config.get', zh: '', en: 'Read a config value (project config; --global reads global profile; keys accept defaults.X, equivalent to X)' },
     'config.get.global': { key: 'help.config.get.global', zh: '', en: 'Operate on global profile (~/.config/openfeel/profile.yaml)' },
+    'config.get.json': { key: 'help.config.get.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'config.set': { key: 'help.config.set', zh: '', en: 'Set a config value (project config; --global writes global profile; keys accept defaults.X, equivalent to X)' },
     'config.set.global': { key: 'help.config.set.global', zh: '', en: 'Operate on global profile (~/.config/openfeel/profile.yaml)' },
     'config.effective': { key: 'help.config.effective', zh: '', en: 'Show effective config values and their source (status.md > config.yaml > profile.yaml > builtin)' },
+    'config.effective.json': { key: 'help.config.effective.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'project': { key: 'help.project', zh: '', en: 'Project management and overview' },
     'project.overview': { key: 'help.project.overview', zh: '', en: 'Scan project structure in real-time, output structured overview' },
+    'project.overview.json': { key: 'help.project.overview.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'plan': { key: 'help.plan', zh: '', en: 'Plan management' },
     'plan.stage': { key: 'help.plan.stage', zh: '', en: 'Work stage management' },
     'plan.stage.add': { key: 'help.plan.stage.add', zh: '', en: 'Add a work stage (full entry: creates dir + overview/status + registers flow.json)' },
@@ -699,6 +737,7 @@ export const help = {
     'plan.scheme.create.fromTasks': { key: 'help.plan.scheme.create.fromTasks', zh: '', en: 'Mechanically generate ops/op-NNN.md skeletons + ops/deps.yaml placeholder from the stage task table (no Agent involved)' },
     'plan.scheme.list': { key: 'help.plan.scheme.list', zh: '', en: 'List operation schemes (optionally filter by stage)' },
     'plan.scheme.list.argstage': { key: 'help.plan.scheme.list.argstage', zh: '', en: 'Stage name (optional)' },
+    'plan.scheme.list.json': { key: 'help.plan.scheme.list.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'plan.scheme.remove': { key: 'help.plan.scheme.remove', zh: '', en: 'Remove an operation scheme (deregisters the flow.json key only; does not delete the op template file)' },
     'plan.scheme.remove.force': { key: 'help.plan.scheme.remove.force', zh: '', en: 'Bypass protection (op done / has checkpoint progress)' },
     'plan.scheme.remove.dryRun': { key: 'help.plan.scheme.remove.dryRun', zh: '', en: 'Preview only, do not write' },
@@ -718,12 +757,13 @@ export const help = {
     'stage': { key: 'help.stage', zh: '', en: 'Work stage status management (status.md atomic operations)' },
     'stage.status': { key: 'help.stage.status', zh: '', en: 'View stage status (list all stages when no arg)' },
     'stage.status.argstageId': { key: 'help.stage.status.argstageId', zh: '', en: 'Stage ID (e.g. v4-stage-04)' },
+    'stage.status.json': { key: 'help.stage.status.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'stage.set': { key: 'help.stage.set', zh: '', en: 'Set stage status field (atomic update, preserve rest)' },
     'stage.set.argstageId': { key: 'help.stage.set.argstageId', zh: '', en: 'Stage ID (e.g. v4-stage-04)' },
     'stage.set.status': { key: 'help.stage.set.status', zh: '', en: 'Status value (coarse-grained: planned/review_failed/review_passed/testing/archiving/done)' },
     'stage.set.execMode': { key: 'help.stage.set.execMode', zh: '', en: 'Execution mode (manual | auto)' },
     'stage.set.autoAdvance': { key: 'help.stage.set.autoAdvance', zh: '', en: 'Auto advance (enabled | disabled)' },
-    'stage.set.workflowMode': { key: 'help.stage.set.workflowMode', zh: '', en: 'Workflow mode (full | fast)' },
+    'stage.set.workflowMode': { key: 'help.stage.set.workflowMode', zh: '', en: 'Workflow mode (full | fast | general)' },
     'stage.set.reviewAgent': { key: 'help.stage.set.reviewAgent', zh: '', en: 'Current responsible agent (e.g. openfeel-executor)' },
     'stage.task': { key: 'help.stage.task', zh: '', en: 'Check/uncheck a task checkbox, or append a task' },
     'stage.task.argstageId': { key: 'help.stage.task.argstageId', zh: '', en: 'Stage ID (e.g. v4-stage-04)' },
@@ -736,12 +776,14 @@ export const help = {
     'view': { key: 'help.view', zh: '', en: 'Review entry management' },
     'view.list': { key: 'help.view.list', zh: '', en: 'List review entries' },
     'view.list.op': { key: 'help.view.list.op', zh: '', en: 'Filter by operation ID' },
+    'view.list.json': { key: 'help.view.list.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'view.note': { key: 'help.view.note', zh: '', en: 'Use `openfeel flow review add|update|remove` to add/modify/remove review entries' },
     'view.accept': { key: 'help.view.accept', zh: '', en: 'Accept review entry (mark as closed)' },
     'view.accept.argrev-id': { key: 'help.view.accept.argrev-id', zh: '', en: 'Review entry ID (e.g. REV-001)' },
     'knowledge': { key: 'help.knowledge', zh: '', en: 'Knowledge base management' },
     'knowledge.list': { key: 'help.knowledge.list', zh: '', en: 'List knowledge entries' },
     'knowledge.list.type': { key: 'help.knowledge.list.type', zh: '', en: 'Filter by category' },
+    'knowledge.list.json': { key: 'help.knowledge.list.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'knowledge.add': { key: 'help.knowledge.add', zh: '', en: 'Add knowledge entry' },
     'knowledge.add.argcategory': { key: 'help.knowledge.add.argcategory', zh: '', en: 'Category (architecture | patterns | troubleshooting | setup)' },
     'knowledge.add.argtitle': { key: 'help.knowledge.add.argtitle', zh: '', en: 'Entry title' },
@@ -750,14 +792,18 @@ export const help = {
     'knowledge.search.argquery': { key: 'help.knowledge.search.argquery', zh: '', en: 'Search query' },
     'knowledge.search.limit': { key: 'help.knowledge.search.limit', zh: '', en: 'Max results (default 10)' },
     'knowledge.search.offset': { key: 'help.knowledge.search.offset', zh: '', en: 'Result offset (default 0)' },
+    'knowledge.search.json': { key: 'help.knowledge.search.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'knowledge.index': { key: 'help.knowledge.index', zh: '', en: 'Show knowledge base index overview' },
+    'knowledge.index.json': { key: 'help.knowledge.index.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'knowledge.dedup': { key: 'help.knowledge.dedup', zh: '', en: 'Find similar knowledge entries (read-only suggestions; does not modify kb)' },
     'knowledge.dedup.argcontent': { key: 'help.knowledge.dedup.argcontent', zh: '', en: 'Content to archive (read from stdin if omitted)' },
     'knowledge.dedup.project': { key: 'help.knowledge.dedup.project', zh: '', en: 'Target project root (defaults to current directory)' },
     'knowledge.dedup.category': { key: 'help.knowledge.dedup.category', zh: '', en: 'Check only the given category (architecture|patterns|troubleshooting|setup)' },
     'knowledge.dedup.threshold': { key: 'help.knowledge.dedup.threshold', zh: '', en: 'Similarity threshold 0–1 (default 0.8)' },
+    'knowledge.dedup.json': { key: 'help.knowledge.dedup.json', zh: '', en: 'Output as JSON (single JSON document with schemaVersion)' },
     'archive': { key: 'help.archive', zh: '', en: 'Archive stage (summarize output, generate summary, extract knowledge)' },
     'archive.argstage': { key: 'help.archive.argstage', zh: '', en: 'Stage name (e.g. stage-06)' },
+    'archive.json': { key: 'help.archive.json', zh: '', en: 'Output { schemaVersion, stage, archivePath, opsCount, reviewsCount, knowledgeExtracts } as JSON' },
     'roadmap': { key: 'help.roadmap', zh: '', en: 'Roadmap management' },
     'roadmap.create': { key: 'help.roadmap.create', zh: '', en: 'Create roadmap (version number like 1.0, 2.0)' },
     'roadmap.create.argversion': { key: 'help.roadmap.create.argversion', zh: '', en: 'Version number' },
@@ -794,6 +840,7 @@ export const help = {
     'req.add.argtitle': { key: 'help.req.add.argtitle', zh: '', en: 'Requirement title' },
     'req.add.targetVersion': { key: 'help.req.add.targetVersion', zh: '', en: 'Target version (e.g. v1.3.0)' },
     'req.add.priority': { key: 'help.req.add.priority', zh: '', en: 'Priority (P0/P1/P2)' },
+    'req.add.workflowMode': { key: 'help.req.add.workflowMode', zh: '', en: 'Workflow mode (full / fast / general; unset by default)' },
     'req.list': { key: 'help.req.list', zh: '', en: 'List requirements (filter by status/version/owner)' },
     'req.list.status': { key: 'help.req.list.status', zh: '', en: 'Filter by status (draft/scheduled/in_progress/done/blocked/cancelled/rejected)' },
     'req.list.targetVersion': { key: 'help.req.list.targetVersion', zh: '', en: 'Filter by target version' },
@@ -801,7 +848,7 @@ export const help = {
     'req.list.json': { key: 'help.req.list.json', zh: '', en: 'Output JSON { schemaVersion, requirements }' },
     'req.show': { key: 'help.req.show', zh: '', en: 'Show requirement detail (linked stages as raw read-only list)' },
     'req.show.argid': { key: 'help.req.show.argid', zh: '', en: 'Requirement ID (e.g. REQ-001)' },
-    'req.show.json': { key: 'help.req.show.json', zh: '', en: 'Output JSON { schemaVersion, requirement, stages }' },
+    'req.show.json': { key: 'help.req.show.json', zh: '', en: 'Output JSON { schemaVersion, requirement, stages, parent, children }' },
     // req (write commands)
     'req.claim': { key: 'help.req.claim', zh: '', en: 'Claim a requirement (occupancy checked; rejected if claimed by another)' },
     'req.claim.argid': { key: 'help.req.claim.argid', zh: '', en: 'Requirement ID (e.g. REQ-001)' },
@@ -814,11 +861,12 @@ export const help = {
     'req.set.title': { key: 'help.req.set.title', zh: '', en: 'New title' },
     'req.set.targetVersion': { key: 'help.req.set.targetVersion', zh: '', en: 'New target version' },
     'req.set.priority': { key: 'help.req.set.priority', zh: '', en: 'New priority (P0/P1/P2)' },
+    'req.set.workflowMode': { key: 'help.req.set.workflowMode', zh: '', en: 'New workflow mode (full / fast / general; general requires no linked stages)' },
     'req.link': { key: 'help.req.link', zh: '', en: 'Link a requirement to a stage / unlink (exactly one of --requirement or --unlink)' },
     'req.link.stage': { key: 'help.req.link.stage', zh: '', en: 'Stage ID (stage-NN or vX.Y.Z-stage-NN; short name resolves in the v1.0.0 series)' },
     'req.link.requirement': { key: 'help.req.link.requirement', zh: '', en: 'Requirement ID (to link; exclusive with --unlink)' },
     'req.link.unlink': { key: 'help.req.link.unlink', zh: '', en: 'Unlink the requirement from the stage' },
-    'req.advance': { key: 'help.req.advance', zh: '', en: 'Advance requirement status (legality by engine transition table; done requires all linked stages done)' },
+    'req.advance': { key: 'help.req.advance', zh: '', en: 'Advance requirement status (legality by engine transition table; done: non-general requirements require all linked stages done)' },
     'req.advance.argid': { key: 'help.req.advance.argid', zh: '', en: 'Requirement ID (e.g. REQ-001)' },
     'req.advance.to': { key: 'help.req.advance.to', zh: '', en: 'Target status (legality checked by engine)' },
     'req.board': { key: 'help.req.board', zh: '', en: 'Requirement board (grouped by status; 7 fixed groups)' },
@@ -827,6 +875,11 @@ export const help = {
     'req.next': { key: 'help.req.next', zh: '', en: 'Recommend the next claimable requirement (scheduled & unclaimed; by target version ascending)' },
     'req.next.owner': { key: 'help.req.next.owner', zh: '', en: 'Owner perspective (include their claimed scheduled requirements)' },
     'req.next.json': { key: 'help.req.next.json', zh: '', en: 'Output JSON { schemaVersion, requirement }' },
+    'req.next.limit': { key: 'help.req.next.limit', zh: '', en: 'Max number of candidates (integer >= 1; default 1)' },
+    'req.split': { key: 'help.req.split', zh: '', en: 'Split a requirement into child requirements (split = publish; children start as scheduled)' },
+    'req.split.argid': { key: 'help.req.split.argid', zh: '', en: 'Requirement ID (e.g. REQ-001)' },
+    'req.split.into': { key: 'help.req.split.into', zh: '', en: 'Child requirement title (repeatable; at least one)' },
+    'req.split.json': { key: 'help.req.split.json', zh: '', en: 'Output JSON { schemaVersion, parent, children }' },
 };
 /* ==================== config ==================== */
 export const config = {
@@ -941,6 +994,7 @@ export const metrics = {
     'summary.totalRetries': { key: 'metrics.summary.totalRetries', zh: '', en: '  Total retries: {n}' },
     'summary.totalDuration': { key: 'metrics.summary.totalDuration', zh: '', en: '  Total duration: {n}ms' },
     'summary.avgDuration': { key: 'metrics.summary.avgDuration', zh: '', en: '  Avg duration: {n}ms' },
+    'summary.caliberNote': { key: 'metrics.summary.caliberNote', zh: '', en: 'Note: durations are phase windows (including cross-session idle/wait), not pure agent execution time.' },
 };
 /* ==================== repl domain: interactive mode (T40) ==================== */
 export const repl = {
@@ -984,13 +1038,15 @@ export const req = {
     // req set
     'set.doneTmpl': { key: 'req.set.doneTmpl', zh: '', en: 'Updated {id}' },
     'set.noopTmpl': { key: 'req.set.noopTmpl', zh: '', en: '{id} unchanged (no-op)' },
-    'set.noFieldsTmpl': { key: 'req.set.noFieldsTmpl', zh: '', en: 'No fields provided; pass at least one of --status / --title / --target-version / --priority' },
+    'set.noFieldsTmpl': { key: 'req.set.noFieldsTmpl', zh: '', en: 'No fields provided; pass at least one of --status / --title / --target-version / --priority / --workflow-mode' },
+    'set.modeSyncedTmpl': { key: 'req.set.modeSyncedTmpl', zh: '', en: 'Workflow mode {mode} dispatched to {count} linked stage(s)' },
     // req link
     'link.doneTmpl': { key: 'req.link.doneTmpl', zh: '', en: 'Linked {stage} to {id}' },
     'link.unlinkDoneTmpl': { key: 'req.link.unlinkDoneTmpl', zh: '', en: 'Unlinked requirement from {stage}' },
     'link.noopTmpl': { key: 'req.link.noopTmpl', zh: '', en: '{stage} link unchanged (no-op)' },
     'link.exclusiveTmpl': { key: 'req.link.exclusiveTmpl', zh: '', en: 'Provide exactly one of --requirement or --unlink' },
     'link.terminalTmpl': { key: 'req.link.terminalTmpl', zh: '', en: '{id} is in a terminal status ({status}); cannot link' },
+    'link.modeSyncedTmpl': { key: 'req.link.modeSyncedTmpl', zh: '', en: 'Requirement workflow mode {mode} dispatched to stage {stage} (status.md field + flow.json redundancy batched)' },
     // req advance
     'advance.doneTmpl': { key: 'req.advance.doneTmpl', zh: '', en: 'Advanced {id}: {from} -> {to}' },
     'advance.noopTmpl': { key: 'req.advance.noopTmpl', zh: '', en: '{id} is already {to} (no-op)' },
@@ -998,15 +1054,34 @@ export const req = {
     'err.stageNotFoundTmpl': { key: 'req.err.stageNotFoundTmpl', zh: '', en: 'Stage {stage} not found (not registered in flow.json stages)' },
     'err.alreadyClaimedTmpl': { key: 'req.err.alreadyClaimedTmpl', zh: '', en: '{id} is claimed by someone else; release first: openfeel req release {id}' },
     'err.alreadyLinkedTmpl': { key: 'req.err.alreadyLinkedTmpl', zh: '', en: '{stage} is already linked to another requirement; unlink first: openfeel req link --stage {stage} --unlink' },
-    'err.invalidFieldTmpl': { key: 'req.err.invalidFieldTmpl', zh: '', en: '{id} invalid field value (check --status / --title / --target-version / --priority)' },
+    'err.invalidFieldTmpl': { key: 'req.err.invalidFieldTmpl', zh: '', en: '{id} invalid field value (check --status / --title / --target-version / --priority / --workflow-mode)' },
     'err.invalidStatusTmpl': { key: 'req.err.invalidStatusTmpl', zh: '', en: '{id} target status {to} rejected (current {current}; allowed: {targets})' },
+    'err.doneGateTmpl': { key: 'req.err.doneGateTmpl', zh: '', en: '{id} target status done rejected (current {current}) — done requires all linked stages done; a requirement with no linked stages can use general mode for explicit completion' },
+    'err.generalModeConflictTmpl': { key: 'req.err.generalModeConflictTmpl', zh: '', en: '{id} has linked stages — general (no pipeline) requires a requirement without linked stages (unlink first, or use fast / full)' },
+    'err.generalTargetTmpl': { key: 'req.err.generalTargetTmpl', zh: '', en: '{id} uses workflow mode general (no pipeline) — stage linking is not allowed' },
     // req board
     'board.groupTmpl': { key: 'req.board.groupTmpl', zh: '', en: '{status} ({n})' },
     'board.itemTmpl': { key: 'req.board.itemTmpl', zh: '', en: '  - {id} {title}' },
+    'board.ownedSuffixTmpl': { key: 'req.board.ownedSuffixTmpl', zh: '', en: ' (claimed by {owner})' },
     // req next
     'next.foundTmpl': { key: 'req.next.foundTmpl', zh: '', en: 'Next: {id} [{status}] {title}' },
     'next.ownedSuffixTmpl': { key: 'req.next.ownedSuffixTmpl', zh: '', en: ' (claimed by {owner})' },
     'next.empty': { key: 'req.next.empty', zh: '', en: '(no claimable requirement)' },
+    'next.limitInvalidTmpl': { key: 'req.next.limitInvalidTmpl', zh: '', en: '{value} -> invalid --limit value (expected an integer >= 1)' },
+    'next.multiLabel': { key: 'req.next.multiLabel', zh: '', en: 'Claimable requirements ({n}):' },
+    'next.itemTmpl': { key: 'req.next.itemTmpl', zh: '', en: '  - {id} [{status}] {title}' },
+    // req split
+    'split.doneTmpl': { key: 'req.split.doneTmpl', zh: '', en: 'Split {id} -> {children} ({n} child requirements)' },
+    'split.childTmpl': { key: 'req.split.childTmpl', zh: '', en: '  - {id}: {title} (body: {path})' },
+    'split.noIntoTmpl': { key: 'req.split.noIntoTmpl', zh: '', en: 'No --into provided; give at least one child title (--into, repeatable)' },
+    'split.terminalTmpl': { key: 'req.split.terminalTmpl', zh: '', en: '{id} is in a terminal status ({status}); cannot split' },
+    'split.invalidFieldTmpl': { key: 'req.split.invalidFieldTmpl', zh: '', en: 'Invalid child value (title must not be empty)' },
+    // req show (parent / children)
+    'show.parentTmpl': { key: 'req.show.parentTmpl', zh: '', en: 'Parent: {parent}' },
+    'show.parentNone': { key: 'req.show.parentNone', zh: '', en: 'Parent: (none)' },
+    'show.childrenLabel': { key: 'req.show.childrenLabel', zh: '', en: 'Children:' },
+    'show.childItemTmpl': { key: 'req.show.childItemTmpl', zh: '', en: '  - {id} [{status}] {title}' },
+    'show.childrenNone': { key: 'req.show.childrenNone', zh: '', en: 'Children: (none)' },
 };
 /* ==================== 聚合导出 ==================== */
 export const allDomains = [