openfeel 1.2.3 → 1.2.4

package/dist/core/archive/merge.js

@@ -8,14 +8,32 @@ import { existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { atomicWriteFileSync } from '../fs/atomic-write.js';
 import { initKnowledgeBase, addKnowledgeEntry } from '../workspace/knowledge.js';
+/**
+ * 归档文件已存在错误（A1 数据安全保护）。
+ * 在解析到阶段后、任何写盘之前抛出，保证拒绝路径零写盘。
+ */
+export class ArchiveExistsError extends Error {
+    /** 用户输入的阶段名原值 */
+    stage;
+    /** 本次命令的目标归档文件绝对路径 */
+    archivePath;
+    constructor(stage, archivePath) {
+        super(`归档文件已存在：${archivePath}`);
+        this.name = 'ArchiveExistsError';
+        this.stage = stage;
+        this.archivePath = archivePath;
+    }
+}
 /**
  * 归档指定阶段
  * 汇总阶段产出、生成 Markdown 摘要、提取知识条目并写入归档文件
  * @param projectPath 项目路径
  * @param stageName 阶段名称（如 stage-06）
+ * @param options.force 显式覆盖已有归档文件（仅绕过文件覆盖保护）
  * @returns ArchiveResult，若 flow.json 未加载或阶段不存在则返回 null
+ * @throws ArchiveExistsError 目标归档文件已存在且未显式 force（零写盘）
  */
-export function archiveStage(projectPath, stageName) {
+export function archiveStage(projectPath, stageName, options) {
     const mgr = new FlowManager(projectPath);
     // 若 flow.json 未加载，返回 null
     if (!mgr.isLoaded()) {
@@ -33,6 +51,13 @@ export function archiveStage(projectPath, stageName) {
     if (!stage) {
         return null;
     }
+    // A1 数据安全：目标文件存在性检查必须位于任何写盘（mkdir / 归档文件 / flow.json / KB）之前。
+    // 保护为归档文件级：目标文件名由本次输入原值派生，别名（短名/全名）派生不同文件、互不触发。
+    const logDir = join(projectPath, '.openfeel', 'log');
+    const archivePath = join(logDir, `archive-${stageName}.md`);
+    if (existsSync(archivePath) && options?.force !== true) {
+        throw new ArchiveExistsError(stageName, archivePath);
+    }
     // 统计该阶段所有 ops
     const ops = Object.values(stage.ops);
     const opsCount = ops.length;
@@ -82,13 +107,11 @@ ${reviewRows}
     const knowledgeExtracts = relatedReviews
         .filter((r) => r.status === 'closed' || r.status === 'resolved')
         .map((r) => `[${r.id}] ${r.title}`);
-    // 确保 .openfeel/log/ 目录存在
-    const logDir = join(projectPath, '.openfeel', 'log');
+    // 确保 .openfeel/log/ 目录存在（仅在通过覆盖保护后才会执行）
     if (!existsSync(logDir)) {
         mkdirSync(logDir, { recursive: true });
     }
     // 写入归档摘要文件（每阶段唯一，不加锁；flow 同步走 mgr.save()）
-    const archivePath = join(logDir, `archive-${stageName}.md`);
     atomicWriteFileSync(archivePath, summary);
     // 追加归档日志到 flow.json
     mgr.appendLog({

package/dist/core/archive/merge.js.map

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

package/dist/core/config.js

@@ -349,7 +349,7 @@ const CONFIG_TEMPLATE_ZH = `# .openfeel/config.yaml
 # 本文件为所有阶段提供默认值，status.md 可覆盖
 
 meta:
-  version: 1.2.3
+  version: 1.2.4
   project: OpenFeel
   tech_stack: TypeScript
 
@@ -405,7 +405,7 @@ const CONFIG_TEMPLATE_EN = `# .openfeel/config.yaml
 # This file provides defaults for all stages; status.md can override
 
 meta:
-  version: 1.2.3
+  version: 1.2.4
   project: OpenFeel
   tech_stack: TypeScript
 

package/dist/core/errors.d.ts

@@ -2,7 +2,7 @@
  * CLI 稳定错误码表（v1.2.2-stage-95 op-002）
  *
  * 职责：提供 `code → kind → exitCode` 的**单一权威**映射，供命令层与测试共用。
- * 契约：`docs/json-contract.md` §3（12 行，逐行同源）；本文件为唯一实现来源，命令层不得硬编码 kind / exitCode。
+ * 契约：`docs/json-contract.md` §3（13 行，逐行同源）；本文件为唯一实现来源，命令层不得硬编码 kind / exitCode。
  * 边界：仅定义分类，不承担输出控制（envelope / stderr 归 `src/commands/shared/errors.ts`）。
  */
 /** 错误分类：预期拒绝 / 内部故障（分类权威；退出码为冗余信号） */
@@ -16,7 +16,7 @@ export interface CliErrorSpec {
     exitCode: CliExitCode;
 }
 /**
- * 12 个稳定错误码（kind 与 exitCode 内嵌，禁止命令层自行推导）。
+ * 13 个稳定错误码（kind 与 exitCode 内嵌，禁止命令层自行推导）。
  * 顺序与 `docs/json-contract.md` §3 逐行一致。
  */
 export declare const CLI_ERROR_CODES: {
@@ -80,10 +80,15 @@ export declare const CLI_ERROR_CODES: {
         readonly kind: "refusal";
         readonly exitCode: 1;
     };
+    readonly ARCHIVE_EXISTS: {
+        readonly code: "ARCHIVE_EXISTS";
+        readonly kind: "refusal";
+        readonly exitCode: 1;
+    };
 };
 /** 稳定错误码联合类型（由码表键派生，防字符串漂移） */
 export type CliErrorCode = keyof typeof CLI_ERROR_CODES;
-/** 有序 12 行映射表（顺序与契约文档 §3 逐行一致，供测试逐行断言） */
+/** 有序 13 行映射表（顺序与契约文档 §3 逐行一致，供测试逐行断言） */
 export declare const CLI_ERROR_TABLE: readonly CliErrorSpec[];
 /**
  * 按 code 取错误规格（kind / exitCode 的唯一读取入口）。

package/dist/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExC,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAclB,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,eAAe,CAAC;AAExD,0CAA0C;AAC1C,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAalD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExC,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBlB,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,eAAe,CAAC;AAExD,0CAA0C;AAC1C,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAclD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE1D"}

package/dist/core/errors.js

@@ -2,11 +2,11 @@
  * CLI 稳定错误码表（v1.2.2-stage-95 op-002）
  *
  * 职责：提供 `code → kind → exitCode` 的**单一权威**映射，供命令层与测试共用。
- * 契约：`docs/json-contract.md` §3（12 行，逐行同源）；本文件为唯一实现来源，命令层不得硬编码 kind / exitCode。
+ * 契约：`docs/json-contract.md` §3（13 行，逐行同源）；本文件为唯一实现来源，命令层不得硬编码 kind / exitCode。
  * 边界：仅定义分类，不承担输出控制（envelope / stderr 归 `src/commands/shared/errors.ts`）。
  */
 /**
- * 12 个稳定错误码（kind 与 exitCode 内嵌，禁止命令层自行推导）。
+ * 13 个稳定错误码（kind 与 exitCode 内嵌，禁止命令层自行推导）。
  * 顺序与 `docs/json-contract.md` §3 逐行一致。
  */
 export const CLI_ERROR_CODES = {
@@ -23,8 +23,10 @@ export const CLI_ERROR_CODES = {
     INTERNAL_ERROR: { code: 'INTERNAL_ERROR', kind: 'internal', exitCode: 3 },
     // stage-97 预留：archive <stage> --json 失败（本阶段不实现，仅登记映射）
     ARCHIVE_FAILED: { code: 'ARCHIVE_FAILED', kind: 'refusal', exitCode: 1 },
+    // v1.2.4 A1：目标归档文件已存在且未显式 --force（零写盘拒绝）
+    ARCHIVE_EXISTS: { code: 'ARCHIVE_EXISTS', kind: 'refusal', exitCode: 1 },
 };
-/** 有序 12 行映射表（顺序与契约文档 §3 逐行一致，供测试逐行断言） */
+/** 有序 13 行映射表（顺序与契约文档 §3 逐行一致，供测试逐行断言） */
 export const CLI_ERROR_TABLE = [
     CLI_ERROR_CODES.NO_INIT,
     CLI_ERROR_CODES.INVALID_ARGUMENT,
@@ -38,6 +40,7 @@ export const CLI_ERROR_TABLE = [
     CLI_ERROR_CODES.FLOW_CONCURRENT_CONFLICT,
     CLI_ERROR_CODES.INTERNAL_ERROR,
     CLI_ERROR_CODES.ARCHIVE_FAILED,
+    CLI_ERROR_CODES.ARCHIVE_EXISTS,
 ];
 /**
  * 按 code 取错误规格（kind / exitCode 的唯一读取入口）。

package/dist/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1D,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5E,eAAe,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1E,wBAAwB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5F,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpF,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5E,qBAAqB,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IACtF,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;IACrF,iBAAiB,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9E,wBAAwB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5F,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;IACzE,sDAAsD;IACtD,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;CAChE,CAAC;AAKX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,eAAe,CAAC,OAAO;IACvB,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,eAAe;IAC/B,eAAe,CAAC,wBAAwB;IACxC,eAAe,CAAC,oBAAoB;IACpC,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,qBAAqB;IACrC,eAAe,CAAC,oBAAoB;IACpC,eAAe,CAAC,iBAAiB;IACjC,eAAe,CAAC,wBAAwB;IACxC,eAAe,CAAC,cAAc;IAC9B,eAAe,CAAC,cAAc;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;AACnD,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1D,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5E,eAAe,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1E,wBAAwB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5F,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpF,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5E,qBAAqB,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IACtF,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;IACrF,iBAAiB,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9E,wBAAwB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5F,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;IACzE,sDAAsD;IACtD,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;IACxE,yCAAyC;IACzC,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE;CAChE,CAAC;AAKX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,eAAe,CAAC,OAAO;IACvB,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,eAAe;IAC/B,eAAe,CAAC,wBAAwB;IACxC,eAAe,CAAC,oBAAoB;IACpC,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,qBAAqB;IACrC,eAAe,CAAC,oBAAoB;IACpC,eAAe,CAAC,iBAAiB;IACjC,eAAe,CAAC,wBAAwB;IACxC,eAAe,CAAC,cAAc;IAC9B,eAAe,CAAC,cAAc;IAC9B,eAAe,CAAC,cAAc;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;AACnD,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,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"}
+{"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,UAQrB,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,UAclB,CAAC;AAGF,eAAO,MAAM,IAAI,EAAE,UAoUlB,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

@@ -549,6 +549,7 @@ export const knowledge = {
 /* ==================== archive ==================== */
 export const archive = {
     'errorArchiveFailedTmpl': { key: 'archive.errorArchiveFailedTmpl', zh: '', en: 'Error: Archive failed, please confirm stage "{stage}" exists and flow.json is initialized.' },
+    'errorArchiveExistsTmpl': { key: 'archive.errorArchiveExistsTmpl', zh: '', en: 'Error: the archive file for stage "{stage}" already exists ({path}); pass --force to overwrite explicitly.' },
     'okTmpl': { key: 'archive.okTmpl', zh: '', en: '✓ Stage archived: {stage}' },
     'opsCount': { key: 'archive.opsCount', zh: '', en: 'Ops' },
     'reviewsCount': { key: 'archive.reviewsCount', zh: '', en: 'Review Entries' },
@@ -581,6 +582,7 @@ export const lint = {
     'kb.okTmpl': { key: 'lint.kb.okTmpl', zh: '', en: '✅ No stale references (checked {n} reference(s))' },
     'kb.staleTmpl': { key: 'lint.kb.staleTmpl', zh: '', en: '❌ Found {n} stale reference(s)' },
     'kb.staleItemTmpl': { key: 'lint.kb.staleItemTmpl', zh: '', en: '  {file} L{line}: "{ref}" → file not found' },
+    'kb.issueTmpl': { key: 'lint.kb.issueTmpl', zh: '', en: 'L{line}: "{ref}" → file not found' },
 };
 /* ==================== help ==================== */
 export const help = {
@@ -684,6 +686,7 @@ export const help = {
     'flow.review.remove.argrev-id': { key: 'help.flow.review.remove.argrev-id', zh: '', en: 'Review entry ID (e.g. REV-001)' },
     'flow.retry': { key: 'help.flow.retry', zh: '', en: 'Query operation retry status' },
     'flow.retry.op': { key: 'help.flow.retry.op', zh: '', en: 'Operation ID (e.g. stage-01.op-001)' },
+    'flow.retry.json': { key: 'help.flow.retry.json', zh: '', en: 'Output { schemaVersion, op, attempts, maxAttempts, exhausted, state } as JSON' },
     'flow.repair': { key: 'help.flow.repair', zh: '', en: 'Auto-detect and fix common issues in flow.json' },
     'flow.repair.dryRun': { key: 'help.flow.repair.dryRun', zh: '', en: 'Detect only, do not fix' },
     'flow.repair.backup': { key: 'help.flow.repair.backup', zh: '', en: 'Backup as .bak before repair' },
@@ -715,6 +718,7 @@ export const help = {
     '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.get.all': { key: 'help.config.get.all', zh: '', en: 'Read all project defaults at once (four keys; cannot combine with --global or a key)' },
     '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)' },
@@ -729,6 +733,7 @@ export const help = {
     'plan.stage.add.argname': { key: 'help.plan.stage.add.argname', zh: '', en: 'Stage ID (e.g. stage-01 or v1.0.0-stage-01)' },
     'plan.stage.add.tasks': { key: 'help.plan.stage.add.tasks', zh: '', en: 'Initial task list (space- or comma-separated, written to status.md)' },
     'plan.stage.list': { key: 'help.plan.stage.list', zh: '', en: 'List all work stages' },
+    'plan.stage.list.json': { key: 'help.plan.stage.list.json', zh: '', en: 'Output { schemaVersion, stages: [{ id, phase, status, deps, workflowMode, opsTotal, opsDone }], count } as JSON' },
     'plan.scheme': { key: 'help.plan.scheme', zh: '', en: 'Operation scheme management' },
     'plan.scheme.create': { key: 'help.plan.scheme.create', zh: '', en: 'Create operation scheme' },
     'plan.scheme.create.argstage': { key: 'help.plan.scheme.create.argstage', zh: '', en: 'Stage ID (e.g. stage-01 or v1.0.0-stage-01)' },
@@ -804,11 +809,13 @@ export const help = {
     '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' },
+    'archive.force': { key: 'help.archive.force', zh: '', en: 'Explicitly overwrite an existing archive file (refused by default with zero writes)' },
     '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' },
     'roadmap.show': { key: 'help.roadmap.show', zh: '', en: 'Show roadmap content (list all if no version)' },
     'roadmap.show.argversion': { key: 'help.roadmap.show.argversion', zh: '', en: 'Version number (optional)' },
+    'roadmap.show.json': { key: 'help.roadmap.show.json', zh: '', en: 'Output { schemaVersion, version, milestones: [{ title, theme, stage, deliverable }] } as JSON' },
     'instructions': { key: 'help.instructions', zh: '', en: 'Generate structured instructions (XML or JSON) for an artifact' },
     'instructions.argartifactId': { key: 'help.instructions.argartifactId', zh: '', en: 'Target artifact ID (e.g. proposal, implementation)' },
     'instructions.change': { key: 'help.instructions.change', zh: '', en: 'Change name (e.g. feat-login)' },
@@ -816,7 +823,9 @@ export const help = {
     'instructions.schema': { key: 'help.instructions.schema', zh: '', en: 'Schema name (default spec-driven)' },
     'lint': { key: 'help.lint', zh: '', en: 'Project health checks (i18n key consistency, kb reference validity)' },
     'lint.i18n': { key: 'help.lint.i18n', zh: '', en: 'Validate i18n key consistency (empty values / zh-CN-only / en-only keys)' },
+    'lint.i18n.json': { key: 'help.lint.i18n.json', zh: '', en: 'Output { schemaVersion, target, ok, issues: [{ path, message }] } as JSON' },
     'lint.kb': { key: 'help.lint.kb', zh: '', en: 'Detect stale file references in .openfeel/kb/' },
+    'lint.kb.json': { key: 'help.lint.kb.json', zh: '', en: 'Output { schemaVersion, target, ok, issues: [{ path, message }] } as JSON' },
     // migrate (legacy layout migration)
     'migrate': { key: 'help.migrate', zh: '', en: 'Legacy layout migration (detect/backup/migrate/rollback existing project legacy layout)' },
     'migrate.dryRun': { key: 'help.migrate.dryRun', zh: '', en: 'Detect and preview only, do not write' },
@@ -832,8 +841,10 @@ export const help = {
     'model.set.force': { key: 'help.model.set.force', zh: '', en: 'Confirm modifying the framework default (required for --scope default in non-TTY)' },
     'model.get': { key: 'help.model.get', zh: '', en: 'Read the model of a given agent' },
     'model.get.scope': { key: 'help.model.get.scope', zh: '', en: 'Scope (omit to show effective value)' },
+    'model.get.json': { key: 'help.model.get.json', zh: '', en: 'Output { schemaVersion, scope, agent, provider, model, source } as JSON' },
     'model.list': { key: 'help.model.list', zh: '', en: 'List models of all agents' },
     'model.list.scope': { key: 'help.model.list.scope', zh: '', en: 'Scope (omit to show effective value)' },
+    'model.list.json': { key: 'help.model.list.json', zh: '', en: 'Output { schemaVersion, scope, agents: [{ agent, provider, model, source }] } as JSON' },
     // req (requirement flow command group)
     'req': { key: 'help.req', zh: '', en: 'Requirement management (add/list/show/claim/release/set/link/advance/board/next)' },
     'req.add': { key: 'help.req.add', zh: '', en: 'Create a requirement (auto ID; body skeleton under .openfeel/requirements/)' },