openfeel 1.2.1 → 1.2.4

package/dist/commands/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/errors.d.ts

@@ -1,22 +1,73 @@
+import { type CliErrorCode, type CliErrorKind } from '../../core/errors.js';
 /**
  * 并发写冲突退出码（与 cli/index.ts EXIT_CONCURRENT 同值）。
  * 此处独立定义以避免命令层 → cli 的循环依赖。
  */
 export declare const EXIT_CONCURRENT = 2;
+/** 新错误 envelope（stdout 单文档；`detail` 无值恒为 `null`） */
+export interface ErrorEnvelope {
+    schemaVersion: 1;
+    error: {
+        code: CliErrorCode;
+        kind: CliErrorKind;
+        message: string;
+        detail: unknown;
+    };
+}
+/** 错误出口入参 */
+export interface FailCliInput {
+    /** 稳定错误码（kind / exitCode 由码表推导） */
+    code: CliErrorCode;
+    /** 本地化主文案（JSON envelope.message / 非 JSON 缺省 stderr 行） */
+    message: string;
+    /** 可定位字段；缺省 null */
+    detail?: unknown;
+    /** 非 JSON 模式逐行 stderr（缺省 [message]）；用于逐字保持既有文案 */
+    stderrLines?: string[];
+}
+/** 仅向 stdout 输出 envelope（不退出、不改退出码） */
+export declare function emitErrorEnvelope(input: FailCliInput): void;
 /**
- * 并发写冲突统一处理：输出唯一 i18n 文案并退出码 2（不返回）。
+ * 统一错误出口：JSON 模式输出 envelope；非 JSON 模式逐行 stderr。
+ * 输出在退出之前完成（避免 Windows 管道下 stdout 被截断）。
+ * JSON 模式仅置 `process.exitCode` 后返回，由调用方 `return`（REV-95-007.1）；
+ * 非 JSON 模式保持既有即时退出语义（0/1/2 语义零改动）。
+ * @param input 错误出口入参
+ */
+export declare function failCli(input: FailCliInput): void;
+/**
+ * 预期拒绝出口：断言码表 kind 为 refusal 后委托 failCli。
+ * internal 码误入本出口属编程错误，按内部错误处理（不静默降级）。
+ * @param input 错误出口入参
+ */
+export declare function failRefusal(input: FailCliInput): void;
+/**
+ * 内部错误出口（INTERNAL_ERROR / exit 3）。
+ * @param err 原始异常（detail 缺省取 {name,message[,stack]}）
+ * @param options 可覆盖主文案 / stderr 行 / detail
+ */
+export declare function failInternal(err: unknown, options?: {
+    message?: string;
+    stderrLines?: string[];
+    detail?: unknown;
+}): void;
+/**
+ * 并发写冲突统一处理：输出唯一 i18n 文案并置退出码 2。
+ * JSON 模式输出 FLOW_CONCURRENT_CONFLICT envelope（kind=refusal）后置码返回（由调用方 return）；
+ * 非 JSON 分支逐字不变（console.error + 即时 process.exit(2)）。
  * @param err 并发写冲突错误（含 expectedRevision / actualRevision）
  * @param lang 语言标识
  */
 export declare function handleConcurrentConflict(err: {
     expectedRevision: number;
     actualRevision: number;
-}, lang: string): never;
+}, lang: string): void;
 /**
  * addStage 失败统一处理（T42）：并发写冲突 / 阶段目录冲突 / 其他错误三类分流。
- * `stage create` 与 `flow stage add` 共用，保证两入口输出一致（不返回）。
+ * `stage create` 与 `flow stage add` 共用，保证两入口输出一致。
+ * JSON 并发分支置码返回（调用方须立即 return）；其余分支保持即时退出。
  * @param err 捕获到的错误
  * @param lang 语言标识
  */
-export declare function handleAddStageError(err: unknown, lang: string): never;
+export declare function handleAddStageError(err: unknown, lang: string): void;
 //# sourceMappingURL=errors.d.ts.map

package/dist/commands/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/errors.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EACzD,IAAI,EAAE,MAAM,GACX,KAAK,CAMP;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAcrE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/errors.ts"],"names":[],"mappings":"AASA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG7F;;;GAGG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE;QACL,IAAI,EAAE,YAAY,CAAC;QACnB,IAAI,EAAE,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAa3D;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAajD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAWrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACvE,IAAI,CAeN;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EACzD,IAAI,EAAE,MAAM,GACX,IAAI,CAqBN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBpE"}

package/dist/commands/shared/errors.js

@@ -1,29 +1,125 @@
 /**
- * 命令层共享错误处理（stage-50 op-004）
- * 收敛「并发写冲突」与「addStage 失败」两类逐行复制逻辑到单点（T38 / T42）。
+ * 命令层共享错误处理（stage-50 op-004；stage-95 op-002 扩展错误封装）
+ *
+ * 收敛「并发写冲突」与「addStage 失败」两类逐行复制逻辑到单点（T38 / T42）；
+ * 新增 JSON 模式统一错误出口（envelope / failCli / failRefusal / failInternal），
+ * kind 与 exitCode 一律经 `src/core/errors.ts` 的单一映射表读取。
  */
 import { isFlowConcurrentError, StageDirConflictError } from '../../core/flow-manager.js';
-import { t } from '../../core/i18n.js';
+import { getCliLang, t } from '../../core/i18n.js';
+import { getCliErrorSpec } from '../../core/errors.js';
+import { emitJson, isJsonMode } from './json-output.js';
 /**
  * 并发写冲突退出码（与 cli/index.ts EXIT_CONCURRENT 同值）。
  * 此处独立定义以避免命令层 → cli 的循环依赖。
  */
 export const EXIT_CONCURRENT = 2;
+/** 仅向 stdout 输出 envelope（不退出、不改退出码） */
+export function emitErrorEnvelope(input) {
+    const spec = getCliErrorSpec(input.code);
+    const doc = {
+        // 构造序保证 schemaVersion 为运行时首键（契约 §1.2）
+        schemaVersion: 1,
+        error: {
+            code: spec.code,
+            kind: spec.kind,
+            message: input.message,
+            detail: input.detail ?? null,
+        },
+    };
+    emitJson(doc);
+}
+/**
+ * 统一错误出口：JSON 模式输出 envelope；非 JSON 模式逐行 stderr。
+ * 输出在退出之前完成（避免 Windows 管道下 stdout 被截断）。
+ * JSON 模式仅置 `process.exitCode` 后返回，由调用方 `return`（REV-95-007.1）；
+ * 非 JSON 模式保持既有即时退出语义（0/1/2 语义零改动）。
+ * @param input 错误出口入参
+ */
+export function failCli(input) {
+    const spec = getCliErrorSpec(input.code);
+    if (isJsonMode()) {
+        emitErrorEnvelope(input);
+        process.exitCode = spec.exitCode;
+        return;
+    }
+    for (const line of input.stderrLines ?? [input.message]) {
+        console.error(line);
+    }
+    // 先置码后退出：兼容既有 `process.exitCode` 断言
+    process.exitCode = spec.exitCode;
+    process.exit(spec.exitCode);
+}
+/**
+ * 预期拒绝出口：断言码表 kind 为 refusal 后委托 failCli。
+ * internal 码误入本出口属编程错误，按内部错误处理（不静默降级）。
+ * @param input 错误出口入参
+ */
+export function failRefusal(input) {
+    const spec = getCliErrorSpec(input.code);
+    if (spec.kind !== 'refusal') {
+        failInternal(new Error(`failRefusal 收到非 refusal 错误码：${input.code}`), {
+            message: input.message,
+            stderrLines: input.stderrLines,
+            detail: input.detail,
+        });
+        return;
+    }
+    failCli(input);
+}
+/**
+ * 内部错误出口（INTERNAL_ERROR / exit 3）。
+ * @param err 原始异常（detail 缺省取 {name,message[,stack]}）
+ * @param options 可覆盖主文案 / stderr 行 / detail
+ */
+export function failInternal(err, options) {
+    const lang = getCliLang(process.cwd());
+    const msg = err instanceof Error ? err.message : String(err);
+    const defaultMessage = t('common.errorTmpl', lang, { msg });
+    const detail = options?.detail ?? (err instanceof Error
+        ? { name: err.name, message: err.message, stack: err.stack }
+        : { name: 'Error', message: String(err) });
+    failCli({
+        code: 'INTERNAL_ERROR',
+        message: options?.message ?? defaultMessage,
+        detail,
+        stderrLines: options?.stderrLines ?? [defaultMessage],
+    });
+}
 /**
- * 并发写冲突统一处理：输出唯一 i18n 文案并退出码 2（不返回）。
+ * 并发写冲突统一处理：输出唯一 i18n 文案并置退出码 2。
+ * JSON 模式输出 FLOW_CONCURRENT_CONFLICT envelope（kind=refusal）后置码返回（由调用方 return）；
+ * 非 JSON 分支逐字不变（console.error + 即时 process.exit(2)）。
  * @param err 并发写冲突错误（含 expectedRevision / actualRevision）
  * @param lang 语言标识
  */
 export function handleConcurrentConflict(err, lang) {
-    console.error(t('common.concurrentConflict', lang, {
-        expected: String(err.expectedRevision),
-        actual: String(err.actualRevision),
-    }));
-    process.exit(EXIT_CONCURRENT);
+    if (isJsonMode()) {
+        emitErrorEnvelope({
+            code: 'FLOW_CONCURRENT_CONFLICT',
+            message: t('common.concurrentConflict', lang, {
+                expected: String(err.expectedRevision),
+                actual: String(err.actualRevision),
+            }),
+            detail: { expectedRevision: err.expectedRevision, actualRevision: err.actualRevision },
+        });
+        process.exitCode = EXIT_CONCURRENT;
+        // JSON 模式仅置码返回（REV-95-009）：不调用 process.exit，避免 Windows 管道 stdout 截断；
+        // 调用方必须立即 return，禁止落入通用错误分支（二次输出 / exit 1）
+        return;
+    }
+    else {
+        console.error(t('common.concurrentConflict', lang, {
+            expected: String(err.expectedRevision),
+            actual: String(err.actualRevision),
+        }));
+        process.exit(EXIT_CONCURRENT);
+    }
 }
 /**
  * addStage 失败统一处理（T42）：并发写冲突 / 阶段目录冲突 / 其他错误三类分流。
- * `stage create` 与 `flow stage add` 共用，保证两入口输出一致（不返回）。
+ * `stage create` 与 `flow stage add` 共用，保证两入口输出一致。
+ * JSON 并发分支置码返回（调用方须立即 return）；其余分支保持即时退出。
  * @param err 捕获到的错误
  * @param lang 语言标识
  */
@@ -31,6 +127,8 @@ export function handleAddStageError(err, lang) {
     // 并发写冲突：本次未写入 flow.json，输出可重试提示并退出码 2
     if (isFlowConcurrentError(err)) {
         handleConcurrentConflict(err, lang);
+        // JSON 模式仅置码返回 → 显式终止分流，避免落入下方通用错误分支（exit 1 二次输出）
+        return;
     }
     // 阶段目录冲突：按类型分流走 i18n 模板（cli/BUG-002 死键消除）
     if (err instanceof StageDirConflictError) {

package/dist/commands/shared/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/commands/shared/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAyD,EACzD,IAAY;IAEZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,2BAA2B,EAAE,IAAI,EAAE;QACjD,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACtC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;KACnC,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY,EAAE,IAAY;IAC5D,sCAAsC;IACtC,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,0CAA0C;IAC1C,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,6BAA6B,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,cAAc;IACd,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/commands/shared/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAwC,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAyBjC,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,GAAG,GAAkB;QACzB,sCAAsC;QACtC,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;SAC7B;KACF,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACjC,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,oCAAoC;IACpC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC7C,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,YAAY,CAAC,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE;YACnE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAY,EACZ,OAAwE;IAExE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,CAAC,CAAC,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAChC,GAAG,YAAY,KAAK;QAClB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;QAC5D,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAC5C,CAAC;IACF,OAAO,CAAC;QACN,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,cAAc;QAC3C,MAAM;QACN,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC,cAAc,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAyD,EACzD,IAAY;IAEZ,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,iBAAiB,CAAC;YAChB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,CAAC,CAAC,2BAA2B,EAAE,IAAI,EAAE;gBAC5C,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBACtC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;aACnC,CAAC;YACF,MAAM,EAAE,EAAE,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE;SACvF,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,eAAe,CAAC;QACnC,qEAAqE;QACrE,2CAA2C;QAC3C,OAAO;IACT,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,2BAA2B,EAAE,IAAI,EAAE;YACjD,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACtC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;SACnC,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY,EAAE,IAAY;IAC5D,sCAAsC;IACtC,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,kDAAkD;QAClD,OAAO;IACT,CAAC;IACD,0CAA0C;IAC1C,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,6BAA6B,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,cAAc;IACd,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/shared/json-output.d.ts

@@ -0,0 +1,60 @@
+/**
+ * JSON 输出契约助手（v1.2.2-stage-95）
+ *
+ * 职责：
+ *  - 单文档 JSON 契约的构造与输出（`schemaVersion` 恒为首键、值恒为 1）；
+ *  - 进程级 JSON 模式单点（由 runCli 预扫描后置位，命令层只读）；
+ *  - argv 单点扫描（`--json` / `--version|-v` / `--project`，跳过已知取值选项防误判）。
+ *
+ * 边界：本模块不承担错误封装（failCli / envelope 归错误层）；不改变任何人类输出。
+ */
+/** JSON 契约版本号（恒为 1；与单文档首键同值） */
+export declare const SCHEMA_VERSION = 1;
+/**
+ * 构造以 `schemaVersion` 为运行时首键的单文档。
+ * 运行时键序由对象字面量构造序决定，因此必须写成 `{ schemaVersion, ...doc }`；
+ * 禁止 `{ ...doc, schemaVersion }`（类型通过但首键违约，REV-95-004 / D-95-01）。
+ * @param doc 业务文档内容（字面量序保持）
+ * @returns 首键为 schemaVersion、值为 1 的新对象
+ */
+export declare function withSchemaVersion<T extends object>(doc: T): {
+    schemaVersion: 1;
+} & T;
+/** 输出单个 JSON 文档（2 空格缩进，stdout） */
+export declare function emitJson(doc: object): void;
+/** 设置进程级 JSON 模式（runCli 预扫描后置位） */
+export declare function setJsonMode(value: boolean): void;
+/** 读取进程级 JSON 模式（命令层只读） */
+export declare function isJsonMode(): boolean;
+/** 重置 JSON 模式（仅测试隔离用，非生产路径） */
+export declare function resetJsonModeForTest(): void;
+/**
+ * 已知「取值选项」名单：argv 扫描时跳过其下一个 token。
+ * 目的：避免把取值 token（如 `--title --json` 中的 `--json`）误判为开关。
+ * 覆盖实测全部取值选项（含 `--lines` / `-n`）。
+ */
+export declare const VALUE_OPTIONS: ReadonlySet<string>;
+/** argv 单点扫描结果 */
+export interface ArgvScanResult {
+    /** 是否存在 `--json` 开关（`--json=true` 不支持，Commander 原生拒绝） */
+    json: boolean;
+    /** 是否存在 `--version` / `-v` 开关 */
+    version: boolean;
+    /** `--project <v>` / `--project=<v>` 收集到的值（原始 token；路径解析归 project-option） */
+    projectValues: string[];
+    /** `--project` 缺值（下一 token 以 `-` 开头或已到末尾） */
+    projectMissingValue: boolean;
+}
+/**
+ * argv 单点扫描。
+ * 规则：遇 `--` 停止扫描；`--json` / `--version` / `-v` 置位；
+ * `--project` 收集值（缺值登记）；其余 `VALUE_OPTIONS` 成员跳过下一 token；
+ * 未知 `--x=v` 不吞下一 token。
+ * @param argv 命令行参数（不含 node 与脚本路径）
+ */
+export declare function scanArgv(argv: string[]): ArgvScanResult;
+/** 解析是否处于 `--json` 模式（argv 单点扫描） */
+export declare function resolveJsonMode(argv: string[]): boolean;
+/** 解析是否存在 `--version` / `-v` 开关（argv 单点扫描） */
+export declare function resolveVersionFlag(argv: string[]): boolean;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/commands/shared/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/json-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gCAAgC;AAChC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG;IAAE,aAAa,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAEpF;AAED,kCAAkC;AAClC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE1C;AAOD,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED,2BAA2B;AAC3B,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAwC5C,CAAC;AAEH,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6CAA6C;IAC7C,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,CAiDvD;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEvD;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAE1D"}

package/dist/commands/shared/json-output.js

@@ -0,0 +1,152 @@
+/**
+ * JSON 输出契约助手（v1.2.2-stage-95）
+ *
+ * 职责：
+ *  - 单文档 JSON 契约的构造与输出（`schemaVersion` 恒为首键、值恒为 1）；
+ *  - 进程级 JSON 模式单点（由 runCli 预扫描后置位，命令层只读）；
+ *  - argv 单点扫描（`--json` / `--version|-v` / `--project`，跳过已知取值选项防误判）。
+ *
+ * 边界：本模块不承担错误封装（failCli / envelope 归错误层）；不改变任何人类输出。
+ */
+/** JSON 契约版本号（恒为 1；与单文档首键同值） */
+export const SCHEMA_VERSION = 1;
+/**
+ * 构造以 `schemaVersion` 为运行时首键的单文档。
+ * 运行时键序由对象字面量构造序决定，因此必须写成 `{ schemaVersion, ...doc }`；
+ * 禁止 `{ ...doc, schemaVersion }`（类型通过但首键违约，REV-95-004 / D-95-01）。
+ * @param doc 业务文档内容（字面量序保持）
+ * @returns 首键为 schemaVersion、值为 1 的新对象
+ */
+export function withSchemaVersion(doc) {
+    return { schemaVersion: SCHEMA_VERSION, ...doc };
+}
+/** 输出单个 JSON 文档（2 空格缩进，stdout） */
+export function emitJson(doc) {
+    console.log(JSON.stringify(doc, null, 2));
+}
+// ── 进程级 JSON 模式单点 ──
+// runCli 在预扫描后置位；命令层只读。模块级状态保证「单进程单命令」前提下的单点判定。
+let jsonMode = false;
+/** 设置进程级 JSON 模式（runCli 预扫描后置位） */
+export function setJsonMode(value) {
+    jsonMode = value;
+}
+/** 读取进程级 JSON 模式（命令层只读） */
+export function isJsonMode() {
+    return jsonMode;
+}
+/** 重置 JSON 模式（仅测试隔离用，非生产路径） */
+export function resetJsonModeForTest() {
+    jsonMode = false;
+}
+/**
+ * 已知「取值选项」名单：argv 扫描时跳过其下一个 token。
+ * 目的：避免把取值 token（如 `--title --json` 中的 `--json`）误判为开关。
+ * 覆盖实测全部取值选项（含 `--lines` / `-n`）。
+ */
+export const VALUE_OPTIONS = new Set([
+    '--encoding',
+    '--log-file',
+    '--project',
+    '--title',
+    '--content',
+    '--last',
+    '--offset',
+    '--add',
+    '--auto-advance',
+    '--auto-fix',
+    '--blocking',
+    '--category',
+    '--change',
+    '--deps',
+    '--exec-mode',
+    '--into',
+    '--lang',
+    '--limit',
+    '--mode',
+    '--op',
+    '--owner',
+    '--priority',
+    '--requirement',
+    '--result',
+    '--review-agent',
+    '--review-tier',
+    '--schema',
+    '--scope',
+    '--stage',
+    '--status',
+    '--target-version',
+    '--tasks',
+    '--threshold',
+    '--to',
+    '--tools',
+    '--type',
+    '--workflow-mode',
+    '--lines',
+    '-n',
+]);
+/**
+ * argv 单点扫描。
+ * 规则：遇 `--` 停止扫描；`--json` / `--version` / `-v` 置位；
+ * `--project` 收集值（缺值登记）；其余 `VALUE_OPTIONS` 成员跳过下一 token；
+ * 未知 `--x=v` 不吞下一 token。
+ * @param argv 命令行参数（不含 node 与脚本路径）
+ */
+export function scanArgv(argv) {
+    let json = false;
+    let version = false;
+    let projectMissingValue = false;
+    const projectValues = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        // `--` 之后为位置参数，不再识别选项
+        if (token === '--') {
+            break;
+        }
+        if (token === '--json') {
+            json = true;
+            continue;
+        }
+        if (token === '--version' || token === '-v') {
+            version = true;
+            continue;
+        }
+        if (token === '--project') {
+            const next = argv[i + 1];
+            // 缺值（末尾或下一 token 形如选项）→ 登记，且不吞下一 token
+            if (next === undefined || next.startsWith('-')) {
+                projectMissingValue = true;
+                continue;
+            }
+            projectValues.push(next);
+            i += 1;
+            continue;
+        }
+        if (token.startsWith('--project=')) {
+            const value = token.slice('--project='.length);
+            if (value === '') {
+                projectMissingValue = true;
+            }
+            else {
+                projectValues.push(value);
+            }
+            continue;
+        }
+        // 已知取值选项：跳过其下一个 token（防 `--title --json` 误判）
+        if (VALUE_OPTIONS.has(token)) {
+            if (i + 1 < argv.length) {
+                i += 1;
+            }
+        }
+    }
+    return { json, version, projectValues, projectMissingValue };
+}
+/** 解析是否处于 `--json` 模式（argv 单点扫描） */
+export function resolveJsonMode(argv) {
+    return scanArgv(argv).json;
+}
+/** 解析是否存在 `--version` / `-v` 开关（argv 单点扫描） */
+export function resolveVersionFlag(argv) {
+    return scanArgv(argv).version;
+}
+//# sourceMappingURL=json-output.js.map

package/dist/commands/shared/json-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../../src/commands/shared/json-output.ts"],"names":[],"mappings":"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"}

package/dist/commands/stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/commands/stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyTpC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwR3D"}
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/commands/stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6VpC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8T3D"}

package/dist/commands/stage.js

@@ -5,10 +5,30 @@ import { withFileLock, projectLockPath } from '../core/fs/file-lock.js';
 import fastGlob from 'fast-glob';
 import { t, getCliLang } from '../core/i18n.js';
 import { FlowManager, STAGE_STATUS_VALUES } from '../core/flow-manager.js';
-import { handleAddStageError } from './shared/errors.js';
+import { failRefusal, handleAddStageError } from './shared/errors.js';
+import { withSchemaVersion, emitJson } from './shared/json-output.js';
 import { findStageStatusPath, planDirToStageId, parseStageId, validateStageId, suggestStageId, normalizeStageId } from '../core/plan/path.js';
 import { appendStatusTask } from '../core/plan/stage.js';
 import { getConfigFieldLegalValues } from '../core/config.js';
+/** 将 status.md 原始中文字段映射为规范化键（缺失 → null） */
+function buildCanonicalFields(raw) {
+    return {
+        execMode: raw['执行模式'] ?? null,
+        autoAdvance: raw['自动推进'] ?? null,
+        status: raw['状态'] ?? null,
+        reviewAgent: raw['当前责任 Agent'] ?? null,
+        previousReviewAgent: raw['上一责任 Agent'] ?? null,
+        updatedAt: raw['更新时间'] ?? null,
+        workflowMode: raw['工作模式'] ?? null,
+        raw,
+    };
+}
+/** 提取「## 阻塞 / 暂停原因」正文；无内容或「无」→ null */
+function extractBlockedReason(content) {
+    const m = content.match(/^## 阻塞 \/ 暂停原因\n\n(.+?)(?:\n##|\n*$)/ms);
+    const text = m?.[1]?.trim() ?? '';
+    return text === '' || text === '无' ? null : text;
+}
 /**
  * 根据 stageId 解析 status.md 文件路径
  * 三级回退：plan/{series}/ 精确 → plan 递归 → stages 兜底（委托 path.ts）
@@ -74,10 +94,12 @@ function parseTasks(content) {
     const taskRegex = /^(- \[([ x])\] 任务(\d+)[：:].*)$/gm;
     let match;
     while ((match = taskRegex.exec(content)) !== null) {
+        const descMatch = match[1].match(/任务\d+[：:]\s*(.*)/);
         tasks.push({
             number: parseInt(match[3], 10),
             done: match[2] === 'x',
             line: match[1],
+            description: descMatch ? descMatch[1] : match[1],
         });
     }
     return tasks;
@@ -157,10 +179,8 @@ function showStageStatus(statusPath, stageId) {
         console.log(t('stage.task.taskListTmpl', lang, { done: String(doneCount), total: String(tasks.length) }));
         for (const task of tasks) {
             const icon = task.done ? '✅' : '⬜';
-            // 提取任务描述（去掉 checkbox 和"任务{N}："前缀）
-            const descMatch = task.line.match(/任务\d+[：:]\s*(.*)/);
-            const desc = descMatch ? descMatch[1] : task.line;
-            console.log(`    ${icon} ` + t('stage.task.taskItemTmpl', lang, { number: String(task.number), desc }));
+            // 任务描述已在 parseTasks 内同源提取（人类输出逐字不变）
+            console.log(`    ${icon} ` + t('stage.task.taskItemTmpl', lang, { number: String(task.number), desc: task.description }));
         }
     }
     // 输出阻塞原因
@@ -249,12 +269,25 @@ export function registerStageCommand(program) {
         .command('status')
         .description('查看阶段状态（无参数时列出所有阶段）')
         .argument('[stageId]', '阶段 ID（如 v4-stage-04）')
-        .action((stageId) => {
+        .option('--json', t('help.stage.status.json', getCliLang(process.cwd())))
+        .action((stageId, options) => {
         const projectPath = process.cwd();
         const lang = getCliLang(projectPath);
         if (!stageId) {
             // 无参数：列出所有阶段
             const stages = listAllStages(projectPath);
+            // JSON 分支须为首行纯 JSON 单文档（statusPath 统一绝对路径）
+            if (options.json) {
+                emitJson(withSchemaVersion({
+                    stages: stages.map((s) => ({
+                        stageId: s.stageId,
+                        status: s.status,
+                        statusPath: resolve(projectPath, s.statusPath),
+                    })),
+                    count: stages.length,
+                }));
+                return;
+            }
             if (stages.length === 0) {
                 console.log(t('stage.status.noStages', lang));
                 return;
@@ -276,10 +309,33 @@ export function registerStageCommand(program) {
         // 有参数：显示指定阶段详细状态
         const statusPath = resolveStatusPath(projectPath, stageId);
         if (!statusPath) {
+            // JSON 模式：预期拒绝 envelope（失败 envelope 判定经 isJsonMode() 单点）
+            if (options.json) {
+                failRefusal({
+                    code: 'STAGE_NOT_FOUND',
+                    message: t('stage.errorStageNotFoundTmpl', lang, { stageId }),
+                    detail: { stageId, hint: t('stage.errorCheckStageId', lang) },
+                });
+                return;
+            }
             console.error(t('stage.errorStageNotFoundTmpl', lang, { stageId }));
             console.error(t('stage.errorCheckStageId', lang));
             process.exit(1);
         }
+        // JSON 分支：单文档输出（fields 7 规范键 + raw；tasks 精简三元组）
+        if (options.json) {
+            const content = readFileSync(statusPath, 'utf-8');
+            const fields = parseStatusFields(content);
+            const tasks = parseTasks(content);
+            emitJson(withSchemaVersion({
+                stageId,
+                statusPath,
+                fields: buildCanonicalFields(fields),
+                tasks: tasks.map(({ number, done, description }) => ({ number, done, description })),
+                blockedBy: extractBlockedReason(content),
+            }));
+            return;
+        }
         showStageStatus(statusPath, stageId);
     });
     // ═══ stage set <stageId> [--status|--exec-mode|--auto-advance|--review-agent] ═══