openfeel 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liuary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,140 @@
+# OpenFeel — AI Agent Development Process Governance CLI
+
+[中文](README.zh-CN.md) | [Changelog](CHANGELOG.md) | [Getting Started](docs/GETTING_STARTED.md)
+
+OpenFeel is a TypeScript CLI tool for end-to-end process governance in AI Agent development. Core philosophy: **"Slim prompts, process in tools"** — agents understand workflows by reading `flow.json` state, not long text documents.
+
+## What Problem Does It Solve
+
+Common pain points in AI Agent project development:
+- **Chaotic process**: Agent scheduling relies on ad-hoc coordination without a unified mechanism
+- **Untrackable state**: Unclear who is doing what, progress, or blockers
+- **Scattered outputs**: Plans, code, reviews, and tests spread across places without a single entry point
+- **Lost experience**: Knowledge vanishes after each session, starting from scratch every time
+
+OpenFeel provides automated pipeline governance — agents obtain current state and next instructions from `flow.json` rather than reading lengthy documents.
+
+## Installation
+
+```bash
+npm install -g openfeel
+```
+
+Requires: Node.js ≥ 20
+
+## Quick Start
+
+```bash
+# 1. Initialize project workspace
+openfeel init ./my-project
+
+# 2. Create a version roadmap
+openfeel roadmap create v1.0
+
+# 3. Add a work stage
+openfeel plan stage add stage-01
+
+# 4. Create an operation scheme
+openfeel plan scheme create stage-01 "Implement core features"
+
+# 5. View pipeline status
+openfeel flow status
+```
+
+## Command Reference
+
+| Command | Purpose |
+|---------|---------|
+| `openfeel init [path]` | Initialize project workspace |
+| `openfeel flow` | Pipeline state management (status / current / advance / overview) |
+| `openfeel roadmap` | Version roadmap management (create / show) |
+| `openfeel plan` | Stage and scheme management (stage add/list, scheme create/list) |
+| `openfeel lint` | Quality gate checks (i18n key symmetry / kb stale references) |
+| `openfeel config` | Configuration management (get / set / list, supports --global) |
+| `openfeel knowledge` | Knowledge base management (list / search) |
+| `openfeel archive <stage>` | Stage archiving with knowledge extraction |
+| `openfeel update` | Update Agent definitions and Skill files |
+
+Details: [docs/commands.md](docs/commands.md)
+
+## Core Concepts
+
+### Feel Agent (Orchestrator)
+
+Feel is the command center, receiving user intent and dispatching downstream Agents to execute tasks.
+
+### 9-Agent System
+
+| Agent | Role | Description |
+|-------|------|-------------|
+| Feel | Orchestrator | Global scheduling and decisions |
+| Planner | Planner | Roadmap and stage planning |
+| Schemer | Schemer | Fine-grained operation plans |
+| Executor | Executor | Code implementation |
+| Reviewer | Reviewer | Cross-model code review |
+| Feel Tester | Tester | Formal test acceptance |
+| Utility | Utility Agent | Mechanical file operations |
+| Vision | Vision Agent | Multimodal visual analysis |
+| Archiver | Archiver | Operation archiving and knowledge extraction |
+
+### Three-Tier Planning
+
+```
+Roadmap
+  └── Stage
+        └── Op（operation）— the finest execution unit
+```
+
+### flow.json — Pipeline State Core
+
+`.openfeel/flow.json` is the single source of truth, recording all stages, operations, reviews, and logs. Agents read it for context and write back state after execution.
+
+### /opfx: Skill Mapping
+
+| Skill | Purpose |
+|-------|---------|
+| `/opfx:flow` | Pipeline status query & advancement |
+| `/opfx:plan` | Plan formulation |
+| `/opfx:scheme` | Scheme formulation |
+| `/opfx:code` | Code execution |
+| `/opfx:view` | Code review |
+| `/opfx:test` | Test acceptance |
+| `/opfx:archive` | Stage archiving |
+| `/opfx:kb` | Knowledge base operations |
+
+## Architecture
+
+```
+CLI Layer (Commander)
+  ├── init / update
+  ├── flow         ← FlowManager (state machine core)
+  ├── roadmap      ← Roadmap module
+  ├── plan         ← Stage / Scheme module
+  ├── lint         ← Quality gates (i18n + kb)
+  ├── config       ← Configuration management
+  ├── knowledge    ← Knowledge base module
+  ├── archive      ← Archiving module
+  └── view         ← Review item module
+
+Core Layer
+  ├── FlowManager — Pipeline state read/write, advance, retry, log
+  ├── config — Config file I/O (incl. global profile)
+  ├── schema — Zod Schema validation engine
+  ├── plan/ — Three-tier planning (roadmap / stage / scheme)
+  ├── artifact-graph/ — Dependency graph & instruction generation
+  ├── view/ — Review item CRUD
+  ├── archive/ — Archive consolidation
+  └── workspace/ — Directory structure & knowledge base
+```
+
+## Development
+
+```bash
+npm install        # Install dependencies
+npm run build      # Compile TypeScript
+npm test           # Run tests (395 cases)
+```
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,17 @@
+# OpenFeel — AI Agent 开发流程治理 CLI
+
+[English](README.en.md) | [更新日志](CHANGELOG.md)
+
+OpenFeel 是一个 TypeScript CLI 工具，为 AI Agent 开发提供端到端的流程治理。核心理念：**「提示词瘦身，流程入工具」** —— Agent 不靠读长文本理解流程，而是通过 `flow.json` 获取当前状态和下一步指令。
+
+---
+
+## 快速开始
+
+```bash
+npm install -g openfeel        # 安装（Node ≥ 20）
+openfeel init ./my-project     # 初始化项目
+openfeel flow status           # 查看流水线
+```
+
+完整中文文档：[README.zh-CN.md](README.zh-CN.md)

package/README.zh-CN.md

@@ -0,0 +1,140 @@
+# OpenFeel — AI Agent 开发流程治理 CLI
+
+[English](README.en.md) | [更新日志](CHANGELOG.md) | [入门指南](docs/GETTING_STARTED.md)
+
+OpenFeel 是一个 TypeScript CLI 工具，为 AI Agent 开发提供端到端的流程治理。
+
+## 解决什么问题
+
+在 AI Agent 项目开发中，常见的痛点：
+- **流程混乱**：Agent 之间的调度靠"口口相传"，缺乏统一协调机制
+- **状态不可追踪**：不知道当前谁在干什么、进展如何、卡在哪里
+- **产出不可管理**：方案、代码、审查、测试散落各处，没有统一入口
+- **经验无法沉淀**：每次会话结束经验就丢失，下次从头再来
+
+OpenFeel 将「提示词瘦身，流程入工具」——Agent 不靠读长文本理解流程，而是通过 `flow.json` 获取当前状态和下一步指令，实现开发流水线的自动化治理。
+
+## 安装
+
+```bash
+npm install -g openfeel
+```
+
+要求：Node.js ≥ 20
+
+## 快速开始
+
+```bash
+# 1. 初始化项目工作区
+openfeel init ./my-project
+
+# 2. 创建分期大纲
+openfeel roadmap create v1.0
+
+# 3. 添加工作阶段
+openfeel plan stage add stage-01
+
+# 4. 创建操作方案
+openfeel plan scheme create stage-01 "实现核心功能"
+
+# 5. 查看流水线状态
+openfeel flow status
+```
+
+## 命令参考
+
+| 命令 | 用途 |
+|------|------|
+| `openfeel init [path]` | 初始化项目工作区，创建 `.openfeel/` 目录结构和配置文件 |
+| `openfeel flow` | 流水线状态管理（status / current / advance / overview） |
+| `openfeel roadmap` | 分期大纲管理（create / show） |
+| `openfeel plan` | 工作阶段与操作方案管理（stage add/list、scheme create/list） |
+| `openfeel lint` | 质量门禁检查（i18n 键对称性 / kb 过期引用） |
+| `openfeel config` | 配置管理（get / set / list，支持 --global） |
+| `openfeel knowledge` | 知识库管理（list / search） |
+| `openfeel archive <stage>` | 阶段归档，汇总产出、生成摘要、提取知识 |
+| `openfeel update` | 更新 Agent 定义和 Skill 文件到目标平台 |
+
+详细参数见：[docs/commands.md](docs/commands.md)
+
+## 核心概念
+
+### Feel Agent（总统领）
+
+Feel 是整个流程的调度中心，负责接收用户意图并调度下游 Agent 执行具体任务。
+
+### 9 Agent 体系
+
+| Agent | 角色 | 说明 |
+|-------|------|------|
+| Feel | 总统领 | 全局调度与决策 |
+| Planner | 计划官 | 制定分期大纲和工作阶段 |
+| Schemer | 方案官 | 制定细粒度操作方案 |
+| Executor | 执行官 | 按方案编码实现 |
+| Reviewer | 审查官 | 交叉审查代码 |
+| Feel Tester | 测试官 | 正式测试验收 |
+| 事务官 | 事务官 | 文件机械操作 |
+| Vision | 视觉官 | 多模态视觉分析 |
+| Archiver | 归档官 | 归档操作记录与知识提取 |
+
+### 三层计划体系
+
+```
+Roadmap（分期大纲）
+  └── Stage（工作阶段）
+        └── Op（操作方案）—— 最细粒度执行单元
+```
+
+### flow.json — 流水线状态核心
+
+`.openfeel/flow.json` 是项目流水线的唯一真相源，记录所有阶段、操作、审查条目和日志。Agent 通过读取它获取上下文，执行完毕后写回状态。
+
+### /opfx: 技能映射
+
+| Skill | 用途 |
+|-------|------|
+| `/opfx:flow` | 流水线状态查询与推进 |
+| `/opfx:plan` | 制定分期大纲和工作阶段 |
+| `/opfx:scheme` | 制定细粒度操作方案 |
+| `/opfx:code` | 按方案编码实现 |
+| `/opfx:view` | 代码审查 |
+| `/opfx:test` | 测试验收 |
+| `/opfx:archive` | 归档操作记录 |
+| `/opfx:kb` | 知识库操作 |
+
+## 架构
+
+```
+CLI 层（Commander）
+  ├── init / update
+  ├── flow         ← FlowManager（状态机核心）
+  ├── roadmap      ← Roadmap 模块
+  ├── plan         ← Stage / Scheme 模块
+  ├── lint         ← 质量门禁（i18n + kb）
+  ├── config       ← 配置管理
+  ├── knowledge    ← 知识库模块
+  ├── archive      ← 归档模块
+  └── view         ← 审查条目模块
+
+Core 层
+  ├── FlowManager — 流水线状态读写、推进、重试、日志
+  ├── config — 配置文件读写（含全局 profile）
+  ├── schema — Zod Schema 验证引擎
+  ├── plan/ — 三层计划（roadmap / stage / scheme）
+  ├── artifact-graph/ — 依赖图与指令生成
+  ├── view/ — 审查条目 CRUD
+  ├── archive/ — 归档合并
+  └── workspace/ — 目录结构和知识库
+```
+
+## 开发
+
+```bash
+npm install        # 安装依赖
+npm run build      # 编译 TypeScript
+npm test           # 运行测试（395 用例）
+```
+
+## 许可
+
+[MIT](LICENSE)

package/bin/openfeel.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+// OpenFeel CLI 入口 — 加载并启动 Commander 程序
+// 无参数时进入 REPL 交互模式，有参数时正常 CLI 模式
+import { program, applyHelpI18n, startRepl } from '../dist/cli/index.js';
+
+const args = process.argv.slice(2);
+// 在 parse 前注入翻译，此时命令树已就绪
+applyHelpI18n(program);
+if (args.length === 0) {
+  startRepl(program);
+} else {
+  program.parse();
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OpenFeel CLI 程序定义
+ * 基于 Commander 构建命令行入口，静态导入并注册所有命令模块。
+ * 新增命令只需在 src/commands/ 下创建模块并在本文件末尾追加 import + register 调用。
+ */
+import { Command } from 'commander';
+declare const program: Command;
+export declare function applyHelpI18n(program: Command): void;
+export { program };
+export { startRepl } from './repl.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAwC9B,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsEpD;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,119 @@
+/**
+ * OpenFeel CLI 程序定义
+ * 基于 Commander 构建命令行入口，静态导入并注册所有命令模块。
+ * 新增命令只需在 src/commands/ 下创建模块并在本文件末尾追加 import + register 调用。
+ */
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { t, getCliLang } from '../core/i18n.js';
+// 读取 package.json 获取版本号
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+// 创建主程序
+const program = new Command();
+program
+    .name('openfeel')
+    .description('AI Agent 开发流程治理 CLI 工具')
+    .version(pkg.version, '-v, --version', '输出版本号');
+// ── 静态导入命令模块（新增命令在此追加） ──
+import { registerInitCommand } from '../commands/init.js';
+import { registerFlowCommand } from '../commands/flow.js';
+import { registerPlanCommand } from '../commands/plan.js';
+import { registerViewCommand } from '../commands/view.js';
+import { registerArchiveCommand } from '../commands/archive.js';
+import { registerRoadmapCommand } from '../commands/roadmap.js';
+import { registerInstructionsCommand } from '../commands/instructions.js';
+import { registerUpdateCommand } from '../commands/update.js';
+import { registerKnowledgeCommand } from '../commands/knowledge.js';
+import { registerStageCommand } from '../commands/stage.js';
+import { registerProjectCommand } from '../commands/project.js';
+import { registerConfigCommand } from '../commands/config.js';
+import { registerLintCommand } from '../commands/lint.js';
+registerInitCommand(program);
+registerFlowCommand(program);
+registerPlanCommand(program);
+registerViewCommand(program);
+registerArchiveCommand(program);
+registerRoadmapCommand(program);
+registerInstructionsCommand(program);
+registerUpdateCommand(program);
+registerKnowledgeCommand(program);
+registerStageCommand(program);
+registerProjectCommand(program);
+registerConfigCommand(program);
+registerLintCommand(program);
+// ── --help 国际化注入 ──
+// 在所有命令注册完成后，遍历 Commander 命令树，
+// 将 .description() 和 .option() 的硬编码文本替换为当前语言对应的翻译。
+export function applyHelpI18n(program) {
+    const lang = getCliLang(process.cwd());
+    /**
+     * 将 kebab-case 或 --prefixed 字符串转为 camelCase。
+     * 例: '--auto-fix' → 'autoFix', 'no-backup' → 'noBackup'
+     */
+    function toCamelCase(flag) {
+        return flag
+            .replace(/^--?/, '')
+            .replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    }
+    /**
+     * 递归遍历 Commander 命令树，替换描述文本。
+     */
+    function walkCmd(cmd, path) {
+        const keyPrefix = 'help.' + path.join('.');
+        // 替换当前命令的 description（仅当已有描述文本时才查找替换）
+        if (cmd.description()) {
+            const descKey = keyPrefix;
+            const descTranslated = t(descKey, lang);
+            if (descTranslated !== descKey) {
+                cmd.description(descTranslated);
+            }
+        }
+        // 替换当前命令的 option 描述
+        for (const opt of cmd.options) {
+            // 跳过 Commander 自动生成的 --no- 选项（negate 标记为 true）
+            if (opt.negate)
+                continue;
+            // 跳过无长/短选项的内部 option
+            const flag = opt.long || opt.short;
+            if (!flag)
+                continue;
+            const optName = toCamelCase(flag);
+            const optKey = `${keyPrefix}.${optName}`;
+            const optTranslated = t(optKey, lang);
+            if (optTranslated !== optKey) {
+                opt.description = optTranslated;
+            }
+        }
+        // 递归处理子命令
+        for (const sub of cmd.commands) {
+            walkCmd(sub, [...path, sub.name()]);
+        }
+    }
+    // 处理根程序（openfeel）的描述和选项
+    const rootKey = 'help.' + program.name();
+    const rootTranslated = t(rootKey, lang);
+    if (rootTranslated !== rootKey) {
+        program.description(rootTranslated);
+    }
+    for (const opt of program.options) {
+        if (opt.negate)
+            continue;
+        const flag = opt.long || opt.short;
+        if (!flag)
+            continue;
+        const optName = toCamelCase(flag);
+        const optKey = `help.${program.name()}.${optName}`;
+        const optTranslated = t(optKey, lang);
+        if (optTranslated !== optKey) {
+            opt.description = optTranslated;
+        }
+    }
+    // 子命令路径从命令名开始（不含 root），与 help 域 key 命名对齐
+    for (const sub of program.commands) {
+        walkCmd(sub, [sub.name()]);
+    }
+}
+export { program };
+export { startRepl } from './repl.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/repl.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+/**
+ * 启动交互式 REPL 模式
+ * 在 REPL 中通过 exitOverride 禁用 Commander 默认的 process.exit 行为，
+ * 转而捕获 CommanderError 异常，确保 REPL 会话不被意外终止。
+ *
+ * @param program - Commander Command 实例（已注册所有子命令）
+ */
+export declare function startRepl(program: Command): void;
+//# sourceMappingURL=repl.d.ts.map

package/dist/cli/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/cli/repl.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwEhD"}

package/dist/cli/repl.js

@@ -0,0 +1,74 @@
+/**
+ * OpenFeel REPL 交互模式
+ * 使用 Node.js readline 模块实现交互式命令行界面，
+ * 将用户输入转发给 Commander 解析执行。
+ */
+import * as readline from 'node:readline';
+/**
+ * 启动交互式 REPL 模式
+ * 在 REPL 中通过 exitOverride 禁用 Commander 默认的 process.exit 行为，
+ * 转而捕获 CommanderError 异常，确保 REPL 会话不被意外终止。
+ *
+ * @param program - Commander Command 实例（已注册所有子命令）
+ */
+export function startRepl(program) {
+    // 禁用 Commander 默认的 process.exit() 行为
+    // 改为抛出 CommanderError，由 REPL 捕获处理
+    program.exitOverride();
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: 'openfeel> ',
+    });
+    console.log('OpenFeel REPL 交互模式 (输入 exit 退出, help 查看命令)');
+    rl.prompt();
+    rl.on('line', (line) => {
+        const trimmed = line.trim();
+        // 空行直接继续
+        if (!trimmed) {
+            rl.prompt();
+            return;
+        }
+        // 退出命令
+        if (trimmed === 'exit' || trimmed === 'quit') {
+            console.log('再见！');
+            rl.close();
+            process.exit(0);
+        }
+        // 帮助命令
+        if (trimmed === 'help') {
+            console.log('可用命令：init, flow, plan, scheme, view, archive, roadmap, knowledge, instructions, update, help, exit');
+            rl.prompt();
+            return;
+        }
+        // 将输入拆分为 argv 格式传给 Commander parse
+        // 注意：不使用 process.argv[0]/[1]（Windows 下 node 路径含空格会导致误解析）
+        // 用固定占位符替代，Commander 仅用于 help 文本显示
+        try {
+            const args = trimmed.split(/\s+/);
+            program.parse(['node', 'openfeel', ...args]);
+        }
+        catch (err) {
+            // 捕获 CommanderError（包括 exitOverride 抛出的和 --help 触发的）
+            // 忽略它们以保持 REPL 运行
+            if (err &&
+                typeof err === 'object' &&
+                'code' in err &&
+                err.code === 'commander.helpDisplayed') {
+                // --help 输出已完成，仅忽略
+            }
+            else if (err &&
+                typeof err === 'object' &&
+                'code' in err &&
+                err.code === 'commander.help') {
+                // help 被触发
+            }
+            // 其他错误静默忽略，保持 REPL 存活
+        }
+        rl.prompt();
+    });
+    rl.on('close', () => {
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=repl.js.map

package/dist/cli/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../../src/cli/repl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAG1C;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,qCAAqC;IACrC,kCAAkC;IAClC,OAAO,CAAC,YAAY,EAAE,CAAC;IAEvB,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,YAAY;KACrB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,EAAE,CAAC,MAAM,EAAE,CAAC;IAEZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,SAAS;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,OAAO;QACP,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO;QACP,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CACT,oGAAoG,CACrG,CAAC;YACF,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,yDAAyD;QACzD,mCAAmC;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,qDAAqD;YACrD,kBAAkB;YAClB,IACE,GAAG;gBACH,OAAO,GAAG,KAAK,QAAQ;gBACvB,MAAM,IAAI,GAAG;gBACZ,GAAwB,CAAC,IAAI,KAAK,yBAAyB,EAC5D,CAAC;gBACD,mBAAmB;YACrB,CAAC;iBAAM,IACL,GAAG;gBACH,OAAO,GAAG,KAAK,QAAQ;gBACvB,MAAM,IAAI,GAAG;gBACZ,GAAwB,CAAC,IAAI,KAAK,gBAAgB,EACnD,CAAC;gBACD,WAAW;YACb,CAAC;YACD,sBAAsB;QACxB,CAAC;QAED,EAAE,CAAC,MAAM,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/archive.d.ts

@@ -0,0 +1,7 @@
+/**
+ * archive 命令注册
+ * openfeel archive <stage>  — 阶段归档（Archiver 操作）
+ */
+import { Command } from 'commander';
+export declare function registerArchiveCommand(program: Command): void;
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoC7D"}

package/dist/commands/archive.js

@@ -0,0 +1,38 @@
+import { archiveStage } from '../core/archive/merge.js';
+import { join } from 'node:path';
+import { t, getCliLang } from '../core/i18n.js';
+export function registerArchiveCommand(program) {
+    program
+        .command('archive')
+        .description('归档指定阶段（汇总产出、生成摘要、提取知识）')
+        .argument('<stage>', '阶段名称（如 stage-06）')
+        .action((stage) => {
+        const lang = getCliLang(process.cwd());
+        try {
+            const result = archiveStage(process.cwd(), stage);
+            if (!result) {
+                console.error(t('archive.errorArchiveFailedTmpl', lang, { stage }));
+                process.exit(1);
+            }
+            // 输出归档结果
+            console.log(t('archive.okTmpl', lang, { stage }));
+            console.log(`  ${t('archive.opsCount', lang)}: ${result.opsCount}`);
+            console.log(`  ${t('archive.reviewsCount', lang)}: ${result.reviewsCount}`);
+            // 输出知识提取列表（如有）
+            if (result.knowledgeExtracts.length > 0) {
+                console.log(`  ${t('archive.knowledgeExtracts', lang)}:`);
+                for (const entry of result.knowledgeExtracts) {
+                    console.log(`    - ${entry}`);
+                }
+            }
+            // 输出归档文件路径
+            const archivePath = join(process.cwd(), '.openfeel', 'log', `archive-${stage}.md`);
+            console.log(`  ${t('archive.archivePath', lang)}: ${archivePath}`);
+        }
+        catch (err) {
+            console.error(t('common.errorTmpl', lang, { msg: err instanceof Error ? err.message : String(err) }));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wBAAwB,CAAC;SACrC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;SACvC,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;YAElD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,gCAAgC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,SAAS;YACT,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,kBAAkB,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,sBAAsB,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAE5E,eAAe;YACf,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,2BAA2B,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;oBAC7C,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,WAAW;YACX,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,KAAK,KAAK,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,qBAAqB,EAAE,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACtG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * config 命令注册
+ * openfeel config get-lang        — 显示全局默认语言
+ * openfeel config set-lang <v>    — 修改全局默认语言
+ * openfeel config list-projects   — 列出项目路径→语言映射
+ * openfeel config get [key] [--global] — 读取项目/全局配置项
+ * openfeel config set <key> <value> [--global] — 写入项目/全局配置项
+ */
+import { Command } from 'commander';
+/**
+ * 注册 config 命令组到主程序
+ * @param program Commander 主程序实例
+ */
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuDpC;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgK5D"}