openmatrix 0.2.26 → 0.2.27

package/dist/cli/commands/start.js

@@ -206,8 +206,23 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
         if (jsonStr.startsWith('@')) {
             const filePath = jsonStr.slice(1);
             // 如果是相对路径，转换为绝对路径
-            const resolvedPath = path.isAbsolute(filePath) ? filePath : path.join(basePath, filePath);
-            jsonStr = await fs.readFile(resolvedPath, 'utf-8');
+            let resolvedPath = path.isAbsolute(filePath) ? filePath : path.join(basePath, filePath);
+            // 特殊处理：如果文件名是 tasks-input.json 且不带路径，尝试从 runId 目录读取
+            if (filePath === 'tasks-input.json' || filePath.endsWith('/tasks-input.json')) {
+                // 先尝试从 runId 目录读取
+                const state = await stateManager.getState();
+                const runIdPath = path.join(omPath, state.runId, 'tasks-input.json');
+                try {
+                    jsonStr = await fs.readFile(runIdPath, 'utf-8');
+                }
+                catch {
+                    // 如果 runId 目录不存在，尝试原有路径
+                    jsonStr = await fs.readFile(resolvedPath, 'utf-8');
+                }
+            }
+            else {
+                jsonStr = await fs.readFile(resolvedPath, 'utf-8');
+            }
         }
         tasksInput = JSON.parse(jsonStr);
     }
@@ -241,18 +256,14 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
             console.log(`🔬 已加载研究领域: ${researchContext.domain}`);
         }
     }
-    // 读取独立的技术方案文档（plan.md）
+    // 读取独立的技术方案文档（从当前 runId 目录）
     let planContent;
-    const planPath = path.join(omPath, 'plan.md');
-    try {
-        planContent = await fs.readFile(planPath, 'utf-8');
-        if (!options.json) {
-            console.log(`📄 已加载技术方案: plan.md`);
-        }
-    }
-    catch {
-        // plan.md 不存在时继续（可能由 AI 后续生成或无 plan）
+    planContent = await stateManager.getPlan();
+    if (planContent && !options.json) {
+        console.log(`📄 已加载技术方案: plan.md`);
     }
+    // 转换为 string | undefined（供 TaskPlanner 使用）
+    const planContentForPlanner = planContent || undefined;
     // 构建 ParsedTask
     const parsedTask = {
         title: resolvedInput.title || tasksInput.title,
@@ -285,7 +296,7 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
     }
     // 使用 TaskPlanner 拆分（保持原有拆分逻辑）
     const planner = new task_planner_js_1.TaskPlanner();
-    const subTasks = planner.breakdown(parsedTask, extraAnswers, qualityConfig, planContent);
+    const subTasks = planner.breakdown(parsedTask, extraAnswers, qualityConfig, planContentForPlanner);
     // 创建任务到状态管理器，并建立 ID 映射
     // TaskPlanner 生成的 taskId 和 StateManager 创建的 id 不同，
     // 需要映射后才能正确设置 dependencies

package/dist/cli/commands/status.js

@@ -70,7 +70,19 @@ async function showStatus(manager, reporter, options) {
         const state = await manager.getState();
         const tasks = await manager.listTasks();
         if (options.json) {
-            console.log(JSON.stringify({ state, tasks }, null, 2));
+            // 添加文件状态字段
+            const hasPlan = await manager.hasPlan();
+            const hasTasksInput = await manager.hasTasksInput();
+            const hasResearchContext = await manager.hasResearchContext();
+            console.log(JSON.stringify({
+                state,
+                tasks,
+                files: {
+                    hasPlan,
+                    hasTasksInput,
+                    hasResearchContext
+                }
+            }, null, 2));
             return;
         }
         // Header

package/dist/storage/state-manager.d.ts

@@ -62,6 +62,114 @@ export declare class StateManager {
     updateApproval(approval: Approval): Promise<void>;
     getApprovalsByStatus(status: ApprovalStatus): Promise<Approval[]>;
     getAllApprovals(): Promise<Approval[]>;
+    /**
+     * 保存技术方案文档 (plan.md)
+     * 路径: .openmatrix/{runId}/plan.md
+     */
+    savePlan(content: string): Promise<void>;
+    /**
+     * 读取技术方案文档
+     * @returns plan.md 内容，不存在返回 null
+     */
+    getPlan(): Promise<string | null>;
+    /**
+     * 检查 plan.md 是否存在
+     */
+    hasPlan(): Promise<boolean>;
+    /**
+     * 保存任务输入元数据
+     * 路径: .openmatrix/{runId}/tasks-input.json
+     */
+    saveTasksInput(data: {
+        title: string;
+        description?: string;
+        goals: string[];
+        goalTypes?: string[];
+        goalComplexity?: ('low' | 'medium' | 'high')[];
+        constraints?: string[];
+        deliverables?: string[];
+        answers?: Record<string, string>;
+    }): Promise<void>;
+    /**
+     * 读取任务输入元数据
+     * @returns tasks-input.json 数据，不存在返回 null
+     */
+    getTasksInput(): Promise<{
+        title: string;
+        description?: string;
+        goals: string[];
+        goalTypes?: string[];
+        goalComplexity?: ('low' | 'medium' | 'high')[];
+        constraints?: string[];
+        deliverables?: string[];
+        answers?: Record<string, string>;
+    } | null>;
+    /**
+     * 检查 tasks-input.json 是否存在
+     */
+    hasTasksInput(): Promise<boolean>;
+    /**
+     * 保存研究会话
+     * 路径: .openmatrix/{runId}/research/session.json
+     */
+    saveResearchSession(session: Record<string, unknown>): Promise<void>;
+    /**
+     * 读取研究会话
+     */
+    getResearchSession(): Promise<Record<string, unknown> | null>;
+    /**
+     * 保存研究报告
+     */
+    saveResearchReport(content: string): Promise<void>;
+    /**
+     * 读取研究报告
+     */
+    getResearchReport(): Promise<string | null>;
+    /**
+     * 保存研究上下文 (供 start 使用)
+     */
+    saveResearchContext(context: {
+        topic: string;
+        domain: string;
+        goals?: string[];
+        constraints?: string[];
+        deliverables?: string[];
+        reportPath?: string;
+        knowledgePath?: string;
+    }): Promise<void>;
+    /**
+     * 读取研究上下文
+     */
+    getResearchContext(): Promise<{
+        topic: string;
+        domain: string;
+        goals?: string[];
+        constraints?: string[];
+        deliverables?: string[];
+        reportPath?: string;
+        knowledgePath?: string;
+    } | null>;
+    /**
+     * 检查研究上下文是否存在
+     */
+    hasResearchContext(): Promise<boolean>;
+    /**
+     * 保存知识条目
+     */
+    saveKnowledgeFinding(index: number, content: string): Promise<void>;
+    /**
+     * 保存头脑风暴会话
+     */
+    saveBrainstormSession(session: Record<string, unknown>): Promise<void>;
+    /**
+     * 读取头脑风暴会话
+     */
+    getBrainstormSession(): Promise<Record<string, unknown> | null>;
+    /**
+     * 迁移旧版本文件到 runId 目录
+     * 只在首次检测到旧文件时执行
+     */
+    migrateFromLegacy(): Promise<void>;
     saveMeeting(meeting: Meeting): Promise<void>;
     getMeeting(meetingId: string): Promise<Meeting | null>;
     getMeetingsByStatus(status: MeetingStatus): Promise<Meeting[]>;

package/dist/storage/state-manager.js

@@ -110,6 +110,8 @@ class StateManager {
                     retry_queue: existing.statistics?.retry_queue ?? 0
                 };
                 this.stateCache = existing;
+                // 迁移旧版本文件到 runId 目录
+                await this.migrateFromLegacy();
                 return;
             }
         }
@@ -151,12 +153,17 @@ class StateManager {
         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));
@@ -443,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.26",
+  "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>