openmatrix 0.2.25 → 0.2.27

package/dist/storage/state-manager.js

@@ -13,11 +13,16 @@ const DEFAULT_CONFIG = {
     model: 'claude-sonnet-4-6'
 };
 class StateManager {
+    rootStore;
     store;
+    basePath;
     stateCache = null;
-    lockDepth = 0; // 可重入：同一进程内嵌套调用不阻塞
+    lockDepth = 0;
     constructor(basePath) {
-        this.store = new file_store_js_1.FileStore(basePath);
+        this.basePath = basePath;
+        this.rootStore = new file_store_js_1.FileStore(basePath);
+        // store will be set in initialize() or reset() to point to {basePath}/{runId}/
+        this.store = this.rootStore;
     }
     /**
      * 跨进程文件锁 — 防止多个 openmatrix CLI 进程同时读写 state.json
@@ -84,49 +89,108 @@ class StateManager {
         }
     }
     async initialize() {
-        const existing = await this.store.readJson('state.json');
-        if (!existing) {
-            const initialState = {
-                version: '1.0',
-                runId: this.generateRunId(),
-                status: 'initialized',
-                currentPhase: 'planning',
-                startedAt: new Date().toISOString(),
-                config: DEFAULT_CONFIG,
-                statistics: {
-                    totalTasks: 0,
-                    completed: 0,
-                    inProgress: 0,
-                    failed: 0,
-                    pending: 0,
-                    scheduled: 0,
-                    blocked: 0,
-                    waiting: 0,
-                    verify: 0,
-                    accept: 0,
-                    retry_queue: 0
-                }
-            };
-            await this.store.writeJson('state.json', initialState);
-            this.stateCache = initialState;
+        // 读取根索引，确定当前 runId
+        const current = await this.rootStore.readJson('current.json');
+        if (current?.runId) {
+            // 切换 store 到当前运行目录
+            this.store = new file_store_js_1.FileStore((0, path_1.join)(this.basePath, current.runId));
+            const existing = await this.store.readJson('state.json');
+            if (existing) {
+                existing.statistics = {
+                    totalTasks: existing.statistics?.totalTasks ?? 0,
+                    completed: existing.statistics?.completed ?? 0,
+                    inProgress: existing.statistics?.inProgress ?? 0,
+                    failed: existing.statistics?.failed ?? 0,
+                    pending: existing.statistics?.pending ?? 0,
+                    scheduled: existing.statistics?.scheduled ?? 0,
+                    blocked: existing.statistics?.blocked ?? 0,
+                    waiting: existing.statistics?.waiting ?? 0,
+                    verify: existing.statistics?.verify ?? 0,
+                    accept: existing.statistics?.accept ?? 0,
+                    retry_queue: existing.statistics?.retry_queue ?? 0
+                };
+                this.stateCache = existing;
+                // 迁移旧版本文件到 runId 目录
+                await this.migrateFromLegacy();
+                return;
+            }
         }
-        else {
-            // 合并旧状态的统计字段（兼容旧版本，statistics 可能不存在）
-            existing.statistics = {
-                totalTasks: existing.statistics?.totalTasks ?? 0,
-                completed: existing.statistics?.completed ?? 0,
-                inProgress: existing.statistics?.inProgress ?? 0,
-                failed: existing.statistics?.failed ?? 0,
-                pending: existing.statistics?.pending ?? 0,
-                scheduled: existing.statistics?.scheduled ?? 0,
-                blocked: existing.statistics?.blocked ?? 0,
-                waiting: existing.statistics?.waiting ?? 0,
-                verify: existing.statistics?.verify ?? 0,
-                accept: existing.statistics?.accept ?? 0,
-                retry_queue: existing.statistics?.retry_queue ?? 0
-            };
-            this.stateCache = existing;
+        // 没有 current.json 或 state.json 不存在 — 创建新运行
+        const runId = this.generateRunId();
+        this.store = new file_store_js_1.FileStore((0, path_1.join)(this.basePath, runId));
+        await this.rootStore.writeJson('current.json', { runId });
+        const initialState = {
+            version: '1.0',
+            runId,
+            status: 'initialized',
+            currentPhase: 'planning',
+            startedAt: new Date().toISOString(),
+            config: DEFAULT_CONFIG,
+            statistics: {
+                totalTasks: 0,
+                completed: 0,
+                inProgress: 0,
+                failed: 0,
+                pending: 0,
+                scheduled: 0,
+                blocked: 0,
+                waiting: 0,
+                verify: 0,
+                accept: 0,
+                retry_queue: 0
+            }
+        };
+        await this.store.writeJson('state.json', initialState);
+        this.stateCache = initialState;
+    }
+    /**
+     * 重置状态 — 清理旧运行数据，为新运行做准备
+     * 删除旧 runId 目录，生成新 runId，更新 current.json
+     */
+    async reset() {
+        // 清理旧 runId 目录
+        const oldRunId = this.stateCache?.runId;
+        if (oldRunId) {
+            await this.rootStore.removeDir(oldRunId);
         }
+        // 兼容旧版本的目录和文件（根目录）
+        await this.rootStore.removeDir('tasks');
+        await this.rootStore.removeDir('approvals');
+        await this.rootStore.removeDir('meetings');
+        await this.rootStore.removeDir('runs');
+        await this.rootStore.removeDir('research');
+        await this.rootStore.removeDir('brainstorm');
+        await this.rootStore.removeFile('context.md');
+        await this.rootStore.removeFile('plan.md');
+        await this.rootStore.removeFile('tasks-input.json');
+        await this.rootStore.removeFile('state.json');
+        // 创建新运行
+        const runId = this.generateRunId();
+        this.store = new file_store_js_1.FileStore((0, path_1.join)(this.basePath, runId));
+        await this.rootStore.writeJson('current.json', { runId });
+        const freshState = {
+            version: '1.0',
+            runId,
+            status: 'initialized',
+            currentPhase: 'planning',
+            startedAt: new Date().toISOString(),
+            config: DEFAULT_CONFIG,
+            statistics: {
+                totalTasks: 0,
+                completed: 0,
+                inProgress: 0,
+                failed: 0,
+                pending: 0,
+                scheduled: 0,
+                blocked: 0,
+                waiting: 0,
+                verify: 0,
+                accept: 0,
+                retry_queue: 0
+            }
+        };
+        await this.store.writeJson('state.json', freshState);
+        this.stateCache = freshState;
     }
     async getState() {
         if (!this.stateCache) {
@@ -207,7 +271,6 @@ class StateManager {
         });
     }
     async getTask(taskId) {
-        // Try subdirectory structure first, fall back to flat file
         let task = await this.store.readJson(`tasks/${taskId}/task.json`);
         if (!task) {
             task = await this.store.readJson(`tasks/${taskId}.json`);
@@ -225,7 +288,7 @@ class StateManager {
                 ...updates,
                 updatedAt: new Date().toISOString()
             };
-            // Always write to subdirectory structure
+            // Always write to current run directory
             await this.store.writeJson(`tasks/${taskId}/task.json`, updatedTask);
             // Update statistics if status changed
             if (updates.status && updates.status !== oldStatus) {
@@ -249,7 +312,6 @@ class StateManager {
                 continue;
             const task = await this.store.readJson(`tasks/${file}`);
             if (task) {
-                // Avoid duplicate if already found in subdirectory
                 if (!tasks.some(t => t.id === task.id)) {
                     tasks.push(task);
                 }
@@ -388,6 +450,167 @@ class StateManager {
         }
         return approvals.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
     }
+    // ============ Plan Methods ============
+    /**
+     * 保存技术方案文档 (plan.md)
+     * 路径: .openmatrix/{runId}/plan.md
+     */
+    async savePlan(content) {
+        await this.store.writeMarkdown('plan.md', content);
+    }
+    /**
+     * 读取技术方案文档
+     * @returns plan.md 内容，不存在返回 null
+     */
+    async getPlan() {
+        return await this.store.readMarkdown('plan.md');
+    }
+    /**
+     * 检查 plan.md 是否存在
+     */
+    async hasPlan() {
+        return await this.store.exists('plan.md');
+    }
+    // ============ TasksInput Methods ============
+    /**
+     * 保存任务输入元数据
+     * 路径: .openmatrix/{runId}/tasks-input.json
+     */
+    async saveTasksInput(data) {
+        await this.store.writeJson('tasks-input.json', data);
+    }
+    /**
+     * 读取任务输入元数据
+     * @returns tasks-input.json 数据，不存在返回 null
+     */
+    async getTasksInput() {
+        return await this.store.readJson('tasks-input.json');
+    }
+    /**
+     * 检查 tasks-input.json 是否存在
+     */
+    async hasTasksInput() {
+        return await this.store.exists('tasks-input.json');
+    }
+    // ============ Research Methods ============
+    /**
+     * 保存研究会话
+     * 路径: .openmatrix/{runId}/research/session.json
+     */
+    async saveResearchSession(session) {
+        await this.store.ensureDir('research');
+        await this.store.writeJson('research/session.json', session);
+    }
+    /**
+     * 读取研究会话
+     */
+    async getResearchSession() {
+        return await this.store.readJson('research/session.json');
+    }
+    /**
+     * 保存研究报告
+     */
+    async saveResearchReport(content) {
+        await this.store.ensureDir('research');
+        await this.store.writeMarkdown('research/RESEARCH.md', content);
+    }
+    /**
+     * 读取研究报告
+     */
+    async getResearchReport() {
+        return await this.store.readMarkdown('research/RESEARCH.md');
+    }
+    /**
+     * 保存研究上下文 (供 start 使用)
+     */
+    async saveResearchContext(context) {
+        await this.store.ensureDir('research');
+        await this.store.writeJson('research/context.json', context);
+    }
+    /**
+     * 读取研究上下文
+     */
+    async getResearchContext() {
+        return await this.store.readJson('research/context.json');
+    }
+    /**
+     * 检查研究上下文是否存在
+     */
+    async hasResearchContext() {
+        return await this.store.exists('research/context.json');
+    }
+    /**
+     * 保存知识条目
+     */
+    async saveKnowledgeFinding(index, content) {
+        await this.store.ensureDir('research/knowledge');
+        await this.store.writeMarkdown(`research/knowledge/finding-${index}.md`, content);
+    }
+    // ============ Brainstorm Methods ============
+    /**
+     * 保存头脑风暴会话
+     */
+    async saveBrainstormSession(session) {
+        await this.store.ensureDir('brainstorm');
+        await this.store.writeJson('brainstorm/session.json', session);
+    }
+    /**
+     * 读取头脑风暴会话
+     */
+    async getBrainstormSession() {
+        return await this.store.readJson('brainstorm/session.json');
+    }
+    // ============ Legacy Migration Methods ============
+    /**
+     * 迁移旧版本文件到 runId 目录
+     * 只在首次检测到旧文件时执行
+     */
+    async migrateFromLegacy() {
+        // Check if migration already done
+        if (await this.store.exists('plan.md')) {
+            return; // Already migrated
+        }
+        // Move plan.md from root to runId
+        const rootPlan = await this.rootStore.readMarkdown('plan.md');
+        if (rootPlan) {
+            await this.store.writeMarkdown('plan.md', rootPlan);
+            await this.rootStore.removeFile('plan.md');
+        }
+        // Move tasks-input.json from root to runId
+        const rootTasksInput = await this.rootStore.readJson('tasks-input.json');
+        if (rootTasksInput) {
+            await this.store.writeJson('tasks-input.json', rootTasksInput);
+            await this.rootStore.removeFile('tasks-input.json');
+        }
+        // Move research directory from root to runId
+        const rootResearchSession = await this.rootStore.readJson('research/session.json');
+        if (rootResearchSession) {
+            await this.store.ensureDir('research/knowledge');
+            // Copy session.json
+            if (rootResearchSession) {
+                await this.store.writeJson('research/session.json', rootResearchSession);
+            }
+            // Copy context.json
+            const rootContext = await this.rootStore.readJson('research/context.json');
+            if (rootContext) {
+                await this.store.writeJson('research/context.json', rootContext);
+            }
+            // Copy RESEARCH.md
+            const rootReport = await this.rootStore.readMarkdown('research/RESEARCH.md');
+            if (rootReport) {
+                await this.store.writeMarkdown('research/RESEARCH.md', rootReport);
+            }
+            // Remove old directory
+            await this.rootStore.removeDir('research');
+        }
+        // Move brainstorm directory from root to runId
+        const rootBrainstormSession = await this.rootStore.readJson('brainstorm/session.json');
+        if (rootBrainstormSession) {
+            await this.store.ensureDir('brainstorm');
+            await this.store.writeJson('brainstorm/session.json', rootBrainstormSession);
+            await this.rootStore.removeDir('brainstorm');
+        }
+    }
     // ============ Meeting Methods ============
     async saveMeeting(meeting) {
         await this.store.writeJson(`meetings/${meeting.id}.json`, meeting);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/approve.md

@@ -35,7 +35,7 @@ description: "Use when handling pending approvals including plan review, merge c
 </INTENT-JUDGMENT>
 
 <NO-OTHER-SKILLS>
-执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
 </NO-OTHER-SKILLS>
 
 <objective>

package/skills/auto.md

@@ -37,14 +37,9 @@ description: "Use when the user wants fully automated task execution with zero m
 </INTENT-JUDGMENT>
 
 <NO-OTHER-SKILLS>
-**绝对禁止**调用以下任何技能或工具：
-- gsd-executor、gsd:* 等 GSD 相关技能
-- superpowers:* 等 superpowers 相关技能
-- 任何其他任务编排相关的 Agent 或工具
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
 
-**Step 5 只能使用 Agent 工具** — 直接调用 Agent，不通过任何中间层。
-
-违规调用将导致执行失败。
+**Step 5 使用 Agent 工具执行子任务。**
 
 **相关技能**: `/om:brainstorm` (需求探索) | `/om:plan` (方案生成) | `/om:start` (交互式执行) | `/om:status` (状态查看) | `/om:report` (报告)
 </NO-OTHER-SKILLS>
@@ -80,6 +75,22 @@ Step 5:  逐个执行 subagentTasks（调用 Agent 工具）            ← 只
 **执行时不要请求用户确认任何操作。**
 </BYPASS-MODE>
 
+<RED-FLAGS>
+## 红旗警告 - 停止并检查
+
+这些想法意味着你在找借口：
+
+| 想法 | 真相 |
+|-----|------|
+| "全自动不需要检查" | 全自动更需要状态持久化 |
+| "跳过 CLI 调用更快" | CLI 是唯一正确的入口 |
+| "我不需要验证状态" | 上下文压缩会丢失状态 |
+| "直接用 Bash 写代码" | 业务代码必须通过 Agent |
+| "忘记任务顺序没关系" | 用 `openmatrix step` 重新获取 |
+| "这个歧义不重要" | 所有歧义都写入 Meeting |
+
+</RED-FLAGS>
+
 <objective>
 全自动执行任务。读取已有的 plan.md + tasks-input.json，通过 CLI 拆分任务，然后通过 Agent 逐个执行。无交互、无审批、无中断。
 
@@ -101,11 +112,21 @@ openmatrix start --init-only
 
 ### Step 2: 验证前置条件
 
-**检查 plan.md 和 tasks-input.json 是否已存在：**
+**先获取当前 runId：**
+```bash
+cat .openmatrix/current.json 2>/dev/null || echo '{"runId":"run-default"}'
+```
 
+**检查 plan.md 和 tasks-input.json 是否已存在（使用 runId）：**
+
+```bash
+cat .openmatrix/${runId}/tasks-input.json 2>/dev/null || echo "NOT_FOUND"
+cat .openmatrix/${runId}/plan.md 2>/dev/null || echo "NOT_FOUND"
+```
+
+**或通过 CLI 检查（推荐）：**
 ```bash
-cat .openmatrix/tasks-input.json 2>/dev/null || echo "NOT_FOUND"
-cat .openmatrix/plan.md 2>/dev/null || echo "NOT_FOUND"
+openmatrix status --json | jq '.files'
 ```
 
 | 情况 | 处理方式 |
@@ -119,15 +140,17 @@ cat .openmatrix/plan.md 2>/dev/null || echo "NOT_FOUND"
 
 ### Step 3: 调用 CLI 创建任务 ⚠️ 不可跳过
 
+**CLI 自动从当前 runId 目录读取 tasks-input.json 和 plan.md。**
+
 **这是最关键的步骤。必须执行以下命令，不能跳过：**
 
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality <质量等级> --mode auto --json
+openmatrix start --tasks-json @tasks-input.json --quality <质量等级> --mode auto --json
 ```
 
 如果启用了 E2E 测试，加上 `--e2e-tests`：
 ```bash
-openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality strict --mode auto --e2e-tests --json
+openmatrix start --tasks-json @tasks-input.json --quality strict --mode auto --e2e-tests --json
 ```
 
 此命令会:
@@ -346,8 +369,10 @@ auto 和 start 在同一位置，区别在于：
 - **auto**: 零交互，不询问任何问题，无审批节点，质量通过 --quality 指定
 
 前置条件（同 start）：
-- `.openmatrix/plan.md` — 技术方案（由 /om:plan 生成）
-- `.openmatrix/tasks-input.json` — 结构化元数据（由 /om:plan 生成）
+- `.openmatrix/{runId}/plan.md` — 技术方案（由 /om:plan 生成）
+- `.openmatrix/{runId}/tasks-input.json` — 结构化元数据（由 /om:plan 生成）
+
+CLI 自动通过 `current.json` 定位当前 runId。
 
 如果前置条件不满足，自动调用 /om:plan 生成。
 

package/skills/brainstorm.md

@@ -36,11 +36,7 @@ description: "Use when the user wants to explore requirements, design alternativ
 </INTENT-JUDGMENT>
 
 <NO-OTHER-SKILLS>
-**绝对禁止**调用以下技能（OpenMatrix 完全替代它们）:
-- ❌ superpowers:brainstorming → 你已经在 om:brainstorm 中了
-- ❌ superpowers:* → 全部被 OpenMatrix 替代
-- ❌ gsd:* → 全部被 OpenMatrix 替代
-- ❌ 任何其他任务编排相关的技能
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
 
 **相关技能**: `/om:research` (领域调研) | `/om:plan` (方案生成) | `/om:start` (任务执行) | `/om:auto` (全自动)
 </NO-OTHER-SKILLS>

package/skills/check.md

@@ -4,7 +4,7 @@ description: 自动检测项目可改进点并提供升级建议，用户确认
 ---
 
 <NO-OTHER-SKILLS>
-执行此技能时，不得调用 superpowers、gsd 或其他任务编排相关的技能。OpenMatrix 独立运行，不依赖外部任务编排系统。
+本 skill 与其他任务编排技能功能重叠，请勿同时使用。
 </NO-OTHER-SKILLS>
 
 <objective>