openmatrix 0.2.24 → 0.2.26

package/dist/storage/file-store.d.ts

@@ -22,6 +22,14 @@ export declare class FileStore {
     exists(path: string): Promise<boolean>;
     listFiles(dir: string): Promise<string[]>;
     listDirs(dir: string): Promise<string[]>;
+    /**
+     * 递归删除目录
+     */
+    removeDir(dir: string): Promise<void>;
+    /**
+     * 删除文件
+     */
+    removeFile(filePath: string): Promise<void>;
     /**
      * 同步写入 JSON 文件
      */

package/dist/storage/file-store.js

@@ -108,6 +108,36 @@ class FileStore {
             return [];
         }
     }
+    /**
+     * 递归删除目录
+     */
+    async removeDir(dir) {
+        const fullPath = (0, path_1.join)(this.basePath, dir);
+        try {
+            await (0, promises_1.rm)(fullPath, { recursive: true, force: true });
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
+    /**
+     * 删除文件
+     */
+    async removeFile(filePath) {
+        const fullPath = (0, path_1.join)(this.basePath, filePath);
+        try {
+            await (0, promises_1.unlink)(fullPath);
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
     // ============ 同步方法（用于构造器等场景）============
     /**
      * 同步写入 JSON 文件

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

@@ -1,6 +1,8 @@
 import type { GlobalState, Task, Approval, ApprovalStatus, Meeting, MeetingStatus } from '../types/index.js';
 export declare class StateManager {
+    private rootStore;
     private store;
+    private basePath;
     private stateCache;
     private lockDepth;
     constructor(basePath: string);
@@ -18,6 +20,11 @@ export declare class StateManager {
      */
     private tryCleanStaleLock;
     initialize(): Promise<void>;
+    /**
+     * 重置状态 — 清理旧运行数据，为新运行做准备
+     * 删除旧 runId 目录，生成新 runId，更新 current.json
+     */
+    reset(): Promise<void>;
     getState(): Promise<GlobalState>;
     updateState(updates: Partial<GlobalState>): Promise<void>;
     createTask(input: {

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,101 @@ 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;
+                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.removeFile('context.md');
+        // 创建新运行
+        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 +264,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 +281,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 +305,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);
                 }

package/dist/test/generator.js

@@ -143,10 +143,25 @@ function generateTestContent(source, config) {
     // 导入语句
     const importPath = source.path.replace(/\.(ts|tsx)$/, '').replace(/\.(js|jsx)$/, '');
     const imports = generateImports(source.exports, importPath, usesTypeScript);
+    // 需要生命周期钩子的文件类型
+    const needsLifecycle = ['service', 'util', 'api', 'module'].includes(source.fileType);
+    // 需要 vi 导入的测试类型（使用 Mock 验证副作用）
+    const needsViImport = ['service', 'util', 'api', 'component', 'module'].includes(source.fileType);
     // 测试块
     const testBlocks = source.exports.map(exp => generateTestBlock(exp, framework, usesDescribeIt, source.fileType));
     // 组装内容
-    const content = `${imports}\n\n${testBlocks.join('\n\n')}\n`;
+    const content = `${needsViImport ? `import { vi } from 'vitest';\n` : ''}${imports}
+${needsLifecycle ? `
+beforeEach(() => {
+  vi.clearAllMocks();
+});
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+` : ''}
+${testBlocks.join('\n\n')}
+`;
     return content;
 }
 /**
@@ -193,13 +208,15 @@ function generateBusinessTestCases(exportName, fileType) {
                     name: 'should return valid result on successful execution',
                     arrange: `// Arrange - 准备有效的输入参数
     const params = { id: 'test-id', data: {} };
-    const mockDependencies = {};`,
+    const spy = vi.spyOn({ ${exportName} }, '${exportName}');`,
                     act: `// Act - 执行服务方法
     const result = await ${exportName}(params);`,
                     assert: [
                         'expect(result).toBeDefined();',
                         'expect(result).toHaveProperty(\'data\');',
-                        'expect(result.error).toBeUndefined();'
+                        'expect(result.error).toBeUndefined();',
+                        `expect(spy).toHaveBeenCalledWith(params);`,
+                        'expect(spy).toHaveBeenCalledTimes(1);'
                     ]
                 },
                 {
@@ -239,12 +256,15 @@ function generateBusinessTestCases(exportName, fileType) {
                     name: 'should process valid input correctly',
                     arrange: `// Arrange - 准备有效输入
     const input = 'test-value';
-    const expected = 'expected-result';`,
+    const expected = 'expected-result';
+    const spy = vi.spyOn({ ${exportName} }, '${exportName}');`,
                     act: `// Act
     const result = ${exportName}(input);`,
                     assert: [
                         'expect(result).toBeDefined();',
-                        'expect(typeof result).toBe(\'string\');'
+                        'expect(typeof result).toBe(\'string\');',
+                        `expect(spy).toHaveBeenCalledWith(input);`,
+                        'expect(spy).toHaveBeenCalledTimes(1);'
                     ]
                 },
                 {
@@ -333,19 +353,25 @@ function generateBusinessTestCases(exportName, fileType) {
                 {
                     name: 'should return success response for valid request',
                     arrange: `// Arrange - 准备有效的 API 请求参数
-    const request = { method: \'GET\', path: \'/api/test\' };`,
+    const request = { method: \'GET\', path: \'/api/test\' };
+    const mockResponse = { status: 200, data: { id: 1 } };
+    const spy = vi.spyOn({ ${exportName} }, '${exportName}').mockResolvedValue(mockResponse);`,
                     act: `// Act - 执行 API 调用
     const response = await ${exportName}(request);`,
                     assert: [
                         'expect(response).toBeDefined();',
                         'expect(response.status).toBe(200);',
-                        'expect(response.data).toBeDefined();'
+                        'expect(response.data).toBeDefined();',
+                        `expect(spy).toHaveBeenCalledWith(request);`,
+                        'expect(spy).toHaveBeenCalledTimes(1);'
                     ]
                 },
                 {
                     name: 'should handle 404 not found',
                     arrange: `// Arrange - 准备不存在的资源请求
-    const request = { method: \'GET\', path: \'/api/nonexistent\' };`,
+    const request = { method: \'GET\', path: \'/api/nonexistent\' };
+    const mockResponse = { status: 404, error: \'Not Found\' };
+    vi.spyOn({ ${exportName} }, '${exportName}').mockResolvedValue(mockResponse);`,
                     act: `// Act - 请求不存在的资源
     const response = await ${exportName}(request);`,
                     assert: [
@@ -356,7 +382,9 @@ function generateBusinessTestCases(exportName, fileType) {
                 {
                     name: 'should handle invalid request body',
                     arrange: `// Arrange - 准备无效的请求体
-    const request = { method: \'POST\', path: \'/api/test\', body: null };`,
+    const request = { method: \'POST\', path: \'/api/test\', body: null };
+    const mockResponse = { status: 400, error: \'invalid request\' };
+    vi.spyOn({ ${exportName} }, '${exportName}').mockResolvedValue(mockResponse);`,
                     act: `// Act - 发送无效请求
     const response = await ${exportName}(request);`,
                     assert: [
@@ -368,10 +396,10 @@ function generateBusinessTestCases(exportName, fileType) {
                     name: 'should handle network errors gracefully',
                     arrange: `// Arrange - 模拟网络错误
     const request = { method: \'GET\', path: \'/api/error\' };
-    // Mock network failure`,
+    vi.spyOn({ ${exportName} }, '${exportName}').mockRejectedValue(new Error('Network Error'));`,
                     act: `// Act - 处理错误响应`,
                     assert: [
-                        `await expect(${exportName}(request)).resolves.toBeDefined();`,
+                        `await expect(${exportName}(request)).rejects.toThrow('Network Error');`,
                         '// 应该返回错误对象而非抛出异常'
                     ]
                 }

package/dist/types/index.d.ts

@@ -228,8 +228,10 @@ export interface ParsedTask {
     title: string;
     description: string;
     goals: string[];
-    /** 每个 goal 的类型标注 (由 AI 在提取时标注)，与 goals 数组一一对应 */
+    /** 每个 goal 的类型标注 (AI 必填)，与 goals 数组一一对应 */
     goalTypes?: GoalType[];
+    /** 每个 goal 的复杂度标注 (AI 必填)，与 goals 数组一一对应 */
+    goalComplexity?: ('low' | 'medium' | 'high')[];
     constraints: string[];
     deliverables: string[];
     rawContent: string;

package/package.json

@@ -1,61 +1,61 @@
-{
-  "name": "openmatrix",
-  "version": "0.2.24",
-  "description": "AI Agent task orchestration system with Claude Code Skills integration",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "openmatrix": "dist/cli/index.js"
-  },
-  "files": [
-    "dist",
-    "skills",
-    "scripts",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/cli/index.ts",
-    "test": "vitest",
-    "lint": "eslint src --ext .ts",
-    "typecheck": "tsc --noEmit",
-    "postinstall": "node scripts/install-skills.js"
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "ai-agent",
-    "task-orchestration",
-    "automation",
-    "multi-agent"
-  ],
-  "author": "",
-  "license": "MIT",
-  "type": "commonjs",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/bigfish1913/openmatrix.git"
-  },
-  "homepage": "https://github.com/bigfish1913/openmatrix#readme",
-  "bugs": {
-    "url": "https://github.com/bigfish1913/openmatrix/issues"
-  },
-  "dependencies": {
-    "chalk": "^5.6.2",
-    "chokidar": "^5.0.0",
-    "commander": "^14.0.3",
-    "winston": "^3.19.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.58.1",
-    "@typescript-eslint/parser": "^8.58.1",
-    "@vitest/coverage-v8": "^1.6.1",
-    "eslint": "^10.2.0",
-    "typescript": "^5.3.3",
-    "vitest": "^1.6.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "openmatrix",
+  "version": "0.2.26",
+  "description": "AI Agent task orchestration system with Claude Code Skills integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openmatrix": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "scripts",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node scripts/install-skills.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai-agent",
+    "task-orchestration",
+    "automation",
+    "multi-agent"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bigfish1913/openmatrix.git"
+  },
+  "homepage": "https://github.com/bigfish1913/openmatrix#readme",
+  "bugs": {
+    "url": "https://github.com/bigfish1913/openmatrix/issues"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "winston": "^3.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
+    "@vitest/coverage-v8": "^1.6.1",
+    "eslint": "^10.2.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}