openfeel 1.2.1 → 1.2.3

package/dist/core/fs/file-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../../src/core/fs/file-lock.ts"],"names":[],"mappings":"AA6BA,iBAAiB;AACjB,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,iBAAiB;AACjB,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAe;AACf,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AASD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AA8CD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,CAAC,EACX,OAAO,GAAE,eAAoB,GAC5B,CAAC,CA2DH"}
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../../src/core/fs/file-lock.ts"],"names":[],"mappings":"AA6BA,iBAAiB;AACjB,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,iBAAiB;AACjB,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAe;AACf,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,YAAY;AACZ,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AASD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAOD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU/E;AAyCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,CAAC,EACX,OAAO,GAAE,eAAoB,GAC5B,CAAC,CAgEH"}

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":"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,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,MAAM,EACJ,SAAS,GAAG,uBAAuB,EACnC,OAAO,GAAG,qBAAqB,EAC/B,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"}
+{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../../../src/core/fs/file-lock.ts"],"names":[],"mappings":"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"}

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,UAyBpB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAgTlB,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,UA0SlB,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"}
+{"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)' },
@@ -51,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' },
@@ -568,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)' },
@@ -588,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' },
@@ -595,7 +620,7 @@ 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, reviewTier } 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)' },
+    '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)' },
@@ -604,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)' },
@@ -630,7 +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 = derived from the workflow mode; the tier trims review gates only when declared explicitly, and cannot bypass the REV block check)' },
+    '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)' },
@@ -641,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)' },
@@ -673,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)' },
@@ -686,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)' },
@@ -706,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' },
@@ -725,6 +757,7 @@ 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)' },
@@ -743,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' },
@@ -757,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' },