openmatrix 0.2.1 → 0.2.3

package/dist/cli/commands/auto.js

@@ -151,26 +151,40 @@ exports.autoCommand = new commander_1.Command('auto')
         console.log(`\n📋 任务: ${parsedTask.title}`);
         console.log(`   目标: ${parsedTask.goals.join(', ')}`);
     }
+    // 获取质量配置（在 breakdown 之前，因为需要传入）
+    const qualityConfig = index_js_1.QUALITY_PRESETS[qualityLevel];
     // 拆解任务
     if (!options.json) {
         console.log('\n🔧 拆解任务...');
     }
     const planner = new task_planner_js_1.TaskPlanner();
-    const subTasks = planner.breakdown(parsedTask, {});
-    // 创建任务到状态管理器
+    const subTasks = planner.breakdown(parsedTask, {}, qualityConfig);
+    // 创建任务到状态管理器，并建立 ID 映射
+    // TaskPlanner 生成的 taskId 和 StateManager 创建的 id 不同，
+    // 需要映射后才能正确设置 dependencies
+    const taskIdMap = new Map();
     for (const subTask of subTasks) {
-        await stateManager.createTask({
+        const created = await stateManager.createTask({
             title: subTask.title,
             description: subTask.description,
             priority: subTask.priority,
             timeout: subTask.estimatedComplexity === 'high' ? 300000 :
                 subTask.estimatedComplexity === 'medium' ? 180000 : 120000,
-            dependencies: subTask.dependencies,
+            dependencies: [],
             assignedAgent: subTask.assignedAgent
         });
+        taskIdMap.set(subTask.taskId, created.id);
+    }
+    // 映射并更新依赖关系
+    for (const subTask of subTasks) {
+        const actualId = taskIdMap.get(subTask.taskId);
+        const resolvedDeps = subTask.dependencies
+            .map(dep => taskIdMap.get(dep))
+            .filter((id) => id !== undefined);
+        if (resolvedDeps.length > 0) {
+            await stateManager.updateTask(actualId, { dependencies: resolvedDeps });
+        }
     }
-    // 获取质量配置
-    const qualityConfig = index_js_1.QUALITY_PRESETS[qualityLevel];
     // auto 模式: 空审批点数组 = bypass permissions
     const approvalPoints = [];
     // 更新状态

package/dist/cli/commands/complete.js

@@ -58,7 +58,7 @@ exports.completeCommand = new commander_1.Command('complete')
     const task = await stateManager.getTask(taskId);
     if (!task) {
         console.log(JSON.stringify({ error: `任务 ${taskId} 不存在` }));
-        process.exit(1);
+        return;
     }
     const isSuccess = !options.failed;
     const now = new Date().toISOString();

package/dist/cli/commands/meeting.js

@@ -282,6 +282,5 @@ exports.meetingCommand = new commander_1.Command('meeting')
     }
     catch (error) {
         console.error('❌ 处理失败:', error instanceof Error ? error.message : error);
-        process.exit(1);
     }
 });

package/dist/cli/commands/start.js

@@ -59,6 +59,7 @@ exports.startCommand = new commander_1.Command('start')
     .option('--docs <level>', '文档级别 (full|basic|minimal|none)')
     .option('--tasks-json <json>', 'AI 已拆分的任务 JSON (跳过自动解析)')
     .option('--e2e-tests', '启用 E2E 测试')
+    .option('--e2e-type <type>', 'E2E 测试类型 (web|visual)')
     .option('--research-context <path>', '研究上下文 JSON 路径 (来自 /om:research 的 context.json)')
     .action(async (input, options) => {
     const basePath = process.cwd();
@@ -266,15 +267,21 @@ async function handleTasksJson(options, stateManager, state, omPath, basePath) {
     if (tasksInput.e2eTests || options.e2eTests) {
         qualityConfig.e2eTests = true;
     }
+    // E2E 类型（通过 answers 传递给 TaskPlanner）
+    const extraAnswers = { ...(resolvedInput.answers || {}) };
+    // tasks-input.json 中的 e2eType 或 CLI 参数
+    const e2eTypeValue = tasksInput.e2eType || options.e2eType;
+    if (e2eTypeValue) {
+        extraAnswers.e2eType = e2eTypeValue;
+    }
     if (!options.json) {
         console.log(`\n📋 任务: ${parsedTask.title}`);
         console.log(`   目标: ${parsedTask.goals.join(', ')}`);
         console.log('\n🔧 拆解任务...');
     }
     // 使用 TaskPlanner 拆分（保持原有拆分逻辑）
-    const answers = resolvedInput.answers || {};
     const planner = new task_planner_js_1.TaskPlanner();
-    const subTasks = planner.breakdown(parsedTask, answers, qualityConfig, resolvedInput.plan);
+    const subTasks = planner.breakdown(parsedTask, extraAnswers, qualityConfig, resolvedInput.plan);
     // 创建任务到状态管理器，并建立 ID 映射
     // TaskPlanner 生成的 taskId 和 StateManager 创建的 id 不同，
     // 需要映射后才能正确设置 dependencies

package/dist/cli/commands/status.js

@@ -123,7 +123,6 @@ async function showStatus(manager, reporter, options) {
     }
     catch (error) {
         console.error(chalk_1.default.red('Error:'), error);
-        process.exit(1);
     }
 }
 /**

package/dist/orchestrator/ai-reviewer.d.ts

@@ -54,7 +54,7 @@ export declare class AIReviewer {
     /**
      * 解析 AI Review 结果
      */
-    parseReviewResult(output: string): ReviewReport;
+    parseReviewResult(taskId: string, output: string): ReviewReport;
     /**
      * 生成验收阶段提示词 (包含 AI Review)
      */

package/dist/orchestrator/ai-reviewer.js

@@ -171,7 +171,7 @@ AI_REVIEW_REJECTED
     /**
      * 解析 AI Review 结果
      */
-    parseReviewResult(output) {
+    parseReviewResult(taskId, output) {
         const lines = output.split('\n');
         const issues = [];
         const categories = [];
@@ -249,7 +249,7 @@ AI_REVIEW_REJECTED
         const summaryMatch = output.match(/## 总结\s*([\s\S]*?)(?=```|$)/);
         const summary = summaryMatch ? summaryMatch[1].trim() : '';
         return {
-            taskId: '',
+            taskId,
             overallStatus,
             categories,
             issues,

package/dist/orchestrator/answer-mapper.d.ts

@@ -21,4 +21,5 @@ export declare function extractTasksInputFields(answers: Record<string, string |
     quality?: string;
     mode?: string;
     e2eTests?: boolean;
+    e2eType?: string;
 };

package/dist/orchestrator/answer-mapper.js

@@ -98,11 +98,14 @@ function extractTasksInputFields(answers) {
     if (typeof mode === 'string') {
         result.mode = mode;
     }
-    // e2e_tests → e2eTests 布尔字段
+    // e2e_tests → e2eTests 布尔字段 + e2eType
     const e2e = answers['e2e_tests'] || answers['e2eTests'] || answers['E2E测试'];
     if (e2e !== undefined) {
         const e2eStr = Array.isArray(e2e) ? e2e[0] : e2e;
-        result.e2eTests = e2eStr === 'true' || e2eStr === '启用 E2E 测试' || e2eStr === '是';
+        result.e2eTests = e2eStr === 'functional' || e2eStr === 'visual' || e2eStr === 'true' || e2eStr === '启用 E2E 测试' || e2eStr === '是';
+        if (result.e2eTests && e2eStr === 'visual') {
+            result.e2eType = 'visual';
+        }
     }
     return result;
 }

package/dist/orchestrator/executor.js

@@ -318,7 +318,7 @@ class OrchestratorExecutor {
      * 处理 Review 结果：解析报告，如有 critical/major 问题则自动创建修复任务
      */
     async processReviewResult(taskId, output) {
-        const report = this.aiReviewer.parseReviewResult(output);
+        const report = this.aiReviewer.parseReviewResult(taskId, output);
         const task = await this.stateManager.getTask(taskId);
         if (!task)
             return {};
@@ -416,10 +416,16 @@ class OrchestratorExecutor {
      */
     async processRetries(failedTasks) {
         let retried = 0;
-        const maxRetries = this.stateManager.getState().then(s => s.config.maxRetries).catch(() => 3);
+        let limit;
+        try {
+            const state = await this.stateManager.getState();
+            limit = state.config.maxRetries;
+        }
+        catch {
+            limit = 3;
+        }
         for (const task of failedTasks) {
             const currentRetryCount = task.retryCount || 0;
-            const limit = await maxRetries;
             // 先检查是否还有重试次数，再决定是否加入队列
             if (currentRetryCount >= limit) {
                 console.log(`⚠️ 任务 ${task.id} 已达到最大重试次数 (${limit})，跳过重试`);

package/dist/orchestrator/interactive-question-generator.js

@@ -313,14 +313,15 @@ class InteractiveQuestionGenerator {
         // 7. E2E 测试
         questions.push({
             id: 'e2e_tests',
-            question: '是否启用端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）',
+            question: '是否需要端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）',
             type: 'single',
             required: false,
             category: 'quality',
             priority: 7,
             options: [
-                { key: 'true', label: '启用 E2E 测试', description: '使用 Playwright/Cypress 等框架进行端到端测试' },
-                { key: 'false', label: '不启用 (推荐)', description: '仅进行单元测试和集成测试，节省时间' }
+                { key: 'functional', label: '功能测试 (推荐)', description: '验证业务流程正确性，无需浏览器可视化，速度快' },
+                { key: 'visual', label: '视觉验证', description: '需要浏览器可视化验证，可检查页面样式和布局' },
+                { key: 'false', label: '不需要', description: '仅进行单元测试和集成测试，节省时间' }
             ]
         });
         // 8. 风险评估

package/dist/orchestrator/phase-executor.js

@@ -1097,7 +1097,8 @@ ACCEPT_FAILED
         // 判断是否通过
         const qc = this.qualityConfig;
         const testsPassed = result.tests.failed === 0;
-        const coverageOk = result.tests.coverage >= qc.minCoverage;
+        // 覆盖率 -1 表示未测量（regex 回退路径下未匹配到覆盖率时保持 -1）
+        const coverageOk = result.tests.coverage < 0 || result.tests.coverage >= qc.minCoverage;
         const lintOk = qc.strictLint ? result.lint.errors === 0 : true;
         const buildOk = result.build.success;
         const e2eOk = qc.e2eTests ? result.e2e.failed === 0 : true;

package/dist/orchestrator/state-machine.js

@@ -27,8 +27,8 @@ const TRANSITIONS = [
     { from: 'accept', to: 'failed', event: 'fail' },
     // failed → retry_queue
     { from: 'failed', to: 'retry_queue', event: 'retry' },
-    // retry_queue → pending (需重试次数未超限)
-    { from: 'retry_queue', to: 'pending', event: 'retry', condition: (task) => (task.retryCount || 0) < 10 },
+    // retry_queue → pending (安全上限 100，由 executor 层控制具体 maxRetries)
+    { from: 'retry_queue', to: 'pending', event: 'retry', condition: (task) => (task.retryCount || 0) < 100 },
     // any → pending (cancel and restart)
     { from: 'scheduled', to: 'pending', event: 'cancel' },
     { from: 'blocked', to: 'pending', event: 'cancel' },

package/dist/orchestrator/task-planner.d.ts

@@ -47,8 +47,8 @@ export interface UserAnswers {
     additionalContext?: Record<string, string | string[]>;
     /** 是否启用 E2E 测试 */
     e2eTests?: boolean;
-    /** E2E 测试类型 (web/mobile/gui) */
-    e2eType?: 'web' | 'mobile' | 'gui';
+    /** E2E 测试类型 (web/mobile/gui/visual) */
+    e2eType?: 'web' | 'mobile' | 'gui' | 'visual';
     /** 质量级别 */
     qualityLevel?: 'fast' | 'balanced' | 'strict';
 }

package/dist/orchestrator/task-planner.js

@@ -858,13 +858,15 @@ ${userContext.documentationLevel}
         const str = (v) => Array.isArray(v) ? v.join(', ') : v;
         const e2eAnswer = str(merged['E2E测试'] || merged['e2eTests'] || merged['e2e']);
         const e2eTypeAnswer = str(merged['E2E类型'] || merged['e2eType']);
+        const isE2EEnabled = e2eAnswer === 'true' || e2eAnswer === 'functional' || e2eAnswer === 'visual' || e2eAnswer === '✅ 启用 E2E 测试' || e2eAnswer === '是';
+        let e2eTypeValue = e2eAnswer === 'visual' ? 'visual' : e2eTypeAnswer === 'mobile' ? 'mobile' : e2eTypeAnswer === 'gui' ? 'gui' : 'web';
         return {
             objective: str(merged['目标'] || merged['objective']),
             techStack: this.parseArrayAnswer(str(merged['技术栈'] || merged['techStack']) || ''),
             testCoverage: str(merged['测试'] || merged['testCoverage']),
             documentationLevel: str(merged['文档'] || merged['documentationLevel']),
-            e2eTests: e2eAnswer === 'true' || e2eAnswer === '✅ 启用 E2E 测试' || e2eAnswer === '是',
-            e2eType: e2eTypeAnswer || 'web',
+            e2eTests: isE2EEnabled,
+            e2eType: e2eTypeValue,
             additionalContext: merged
         };
     }
@@ -940,8 +942,17 @@ ${devTaskId}
     }
     buildE2ETestDescription(e2eType, parsedTask, userContext) {
         const typeConfig = this.getE2ETypeConfig(e2eType);
+        const visualSection = e2eType === 'visual' ? `
+## 视觉验证要求
+1. **可视化运行**: 使用有头模式 (headed mode) 运行浏览器，可查看页面渲染
+2. **样式检查**: 验证页面布局、颜色、字体、间距等视觉元素
+3. **响应式测试**: 在不同视口下验证页面布局适配
+4. **交互验证**: 确保动画、过渡效果、hover 状态等交互正常
+5. **截图对比**: 关键页面应生成截图，便于人工审核
+` : '';
         return `## E2E 测试目标
 执行完整的端到端测试，验证关键用户流程
+${e2eType === 'visual' ? '（需可视化验证，检查页面样式和布局）' : ''}
 
 ## 应用类型
 ${typeConfig.description}
@@ -965,12 +976,12 @@ ${typeConfig.environments.map(e => `- ${e}`).join('\n')}
 3. **等待策略**: 使用合理的等待机制，避免硬编码延迟
 4. **数据隔离**: 测试数据独立，不影响其他测试
 5. **清理机制**: 测试后清理创建的数据
-
+${visualSection}
 ## 输出要求
 - E2E 测试文件 (tests/e2e/*.spec.ts)
 - 测试执行报告
 - 截图/录像 (失败时)
-- 测试覆盖率报告 (如有)
+${e2eType === 'visual' ? '- 关键页面截图 (用于视觉审核)\n' : ''}- 测试覆盖率报告 (如有)
 
 ## 运行命令
 \`\`\`bash
@@ -1003,6 +1014,12 @@ ${typeConfig.runCommand}
                 frameworks: ['Playwright for Electron', 'Spectron (Electron)', 'Robot Framework', 'PyAutoGUI'],
                 environments: ['Windows', 'macOS', 'Linux'],
                 runCommand: 'npm run test:e2e'
+            },
+            visual: {
+                description: 'Web 应用 (需可视化验证，检查页面样式和布局)',
+                frameworks: ['Playwright (headed mode，推荐)', 'Cypress (headed)', 'Playwright + Percy (视觉回归)', 'Playwright + Chromatic'],
+                environments: ['Chrome (headed)', '不同视口 (desktop/tablet/mobile)', '不同分辨率设备'],
+                runCommand: 'npx playwright test --headed --reporter=html,list'
             }
         };
         return configs[type];

package/dist/storage/state-manager.js

@@ -110,19 +110,19 @@ class StateManager {
             this.stateCache = initialState;
         }
         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
+                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;
         }

package/package.json

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

package/skills/start.md

@@ -165,12 +165,16 @@ AskUserQuestion: `header: "质量等级"`, `multiSelect: false`
 
 AskUserQuestion: `header: "E2E 测试"`, `multiSelect: false`
 
-**question:** 是否启用端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）
+**question:** 是否需要端到端 (E2E) 测试？（适用于 Web/Mobile/GUI 项目，耗时较长）
 
 | label | description |
 |-------|-------------|
-| `不启用 (推荐)` | 仅进行单元测试和集成测试，节省时间 |
-| `启用 E2E 测试` | 使用 Playwright/Cypress 等框架进行端到端测试 |
+| `功能测试 (推荐)` | 验证业务流程正确性，无需浏览器可视化，速度快 |
+| `视觉验证` | 需要浏览器可视化验证，可检查页面样式和布局 |
+| `不需要` | 仅进行单元测试和集成测试，节省时间 |
+
+> 功能测试是默认推荐，适用于大多数场景（API/逻辑/数据处理）。
+> 视觉验证适用于前端/移动端项目，需要检查 UI 样式、布局、交互效果。
 
 #### 4.3 执行模式（所有任务必选）
 
@@ -202,7 +206,7 @@ AskUserQuestion: `header: "执行模式"`, `multiSelect: false`
 📊 统计
   Goals: N 个（将生成 N个开发 + N个测试 + 审查）
   质量级别: xxx
-  E2E 测试: 启用/不启用
+  E2E 测试: 功能测试 / 视觉验证 / 不启用
 ```
 
 ### Step 6: AI 提取 goals + 生成 plan
@@ -242,11 +246,13 @@ AskUserQuestion: `header: "执行模式"`, `multiSelect: false`
   "goalTypes": ["development", "testing", "documentation"],
   "constraints": ["约束1"],
   "deliverables": ["src/xxx.ts"],
-  "plan": "## 技术方案\n1. ...\n2. ..."
+  "plan": "## 技术方案\n1. ...\n2. ...",
+  "e2eTests": true,
+  "e2eType": "visual"
 }
 ```
 
-> **注意**: `quality`、`mode`、`e2eTests` 不写入文件，由 Step 8 的 CLI 参数传递。
+> **注意**: `quality`、`mode` 通过 CLI 参数传递。`e2eTests` 和 `e2eType` 可写入 tasks-input.json 或通过 CLI 参数传递。
 > **goalTypes** 必须与 goals 数组长度一致，一一对应。
 > **研究上下文集成**: 如果检测到 `.openmatrix/research/context.json`，将研究的 goals/constraints/deliverables 作为基础，与 AI 提取的内容合并（去重后）。
 
@@ -264,11 +270,16 @@ openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality <质量等
 openmatrix start --tasks-json @.openmatrix/tasks-input.json --research-context @.openmatrix/research/context.json --quality <质量等级> --mode <执行模式> --json
 ```
 
-如果启用了 E2E 测试，加上 `--e2e-tests`：
+如果启用了 E2E 测试（功能测试），加上 `--e2e-tests`：
 ```bash
 openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality balanced --mode auto --e2e-tests --json
 ```
 
+如果选择了视觉验证，加上 `--e2e-tests --e2e-type visual`：
+```bash
+openmatrix start --tasks-json @.openmatrix/tasks-input.json --quality balanced --mode auto --e2e-tests --e2e-type visual --json
+```
+
 **非开发任务**（无质量等级）：
 ```bash
 openmatrix start --tasks-json @.openmatrix/tasks-input.json --mode <执行模式> --json