openmatrix 0.2.15 → 0.2.17

package/dist/types/index.d.ts

@@ -204,7 +204,7 @@ export interface ApprovalOption {
     label: string;
 }
 export type MeetingStatus = 'pending' | 'in_progress' | 'resolved' | 'cancelled';
-export type MeetingType = 'blocking' | 'decision' | 'review' | 'planning';
+export type MeetingType = 'blocking' | 'decision' | 'review' | 'planning' | 'ambiguity';
 export interface Meeting {
     id: string;
     type: MeetingType;
@@ -219,6 +219,10 @@ export interface Meeting {
     createdAt: string;
     startedAt?: string;
     resolvedAt?: string;
+    /** 歧义报告 (仅 type 为 'ambiguity' 时使用) */
+    ambiguityReport?: AmbiguityReport;
+    /** 建议的问题列表 (用于歧义处理) */
+    suggestedQuestions?: string[];
 }
 export interface ParsedTask {
     title: string;
@@ -311,3 +315,192 @@ export interface DebugSession {
     updatedAt: string;
     completedAt?: string;
 }
+/**
+ * 歧义类型
+ * - requirement: 需求歧义 (需求描述不清晰、存在多种解读)
+ * - technical: 技术歧义 (技术方案选择、实现方式不明确)
+ * - dependency: 依赖歧义 (依赖项版本、接口契约不明确)
+ * - acceptance: 验收歧义 (验收标准不清晰、无法验证)
+ * - test_result: 测试结果歧义 (测试结果不一致、无法判断)
+ */
+export type AmbiguityType = 'requirement' | 'technical' | 'dependency' | 'acceptance' | 'test_result';
+/**
+ * 歧义严重程度
+ * - critical: 严重歧义，必须立即解决，否则任务无法继续
+ * - high: 高优先级歧义，影响核心功能，应尽快解决
+ * - medium: 中等优先级歧义，影响非核心功能，可稍后解决
+ * - low: 低优先级歧义，影响较小，可在后续处理
+ */
+export type AmbiguitySeverity = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * 歧义项 - 描述单个歧义点
+ */
+export interface AmbiguityItem {
+    /** 歧义唯一标识 */
+    id: string;
+    /** 歧义类型 */
+    type: AmbiguityType;
+    /** 严重程度 */
+    severity: AmbiguitySeverity;
+    /** 歧义描述 */
+    description: string;
+    /** 影响范围 */
+    impactScope: string[];
+    /** 可能的解决方案 */
+    possibleSolutions?: string[];
+    /** 相关文件 */
+    relatedFiles?: string[];
+    /** 相关任务 ID */
+    relatedTaskIds?: string[];
+}
+/**
+ * 歧义报告 - Agent 输出的歧义检测结果
+ */
+export interface AmbiguityReport {
+    /** 报告唯一标识 */
+    id: string;
+    /** 关联的任务 ID */
+    taskId: string;
+    /** 检测阶段: 'pre_execution' 执行前 | 'during_execution' 执行中 */
+    detectionPhase: 'pre_execution' | 'during_execution';
+    /** 检测到的歧义列表 */
+    ambiguities: AmbiguityItem[];
+    /** 是否存在歧义 */
+    hasAmbiguity: boolean;
+    /** 最高严重程度 (用于快速判断) */
+    maxSeverity?: AmbiguitySeverity;
+    /** 检测时间 */
+    detectedAt: string;
+    /** 建议的处理策略 */
+    suggestedStrategy?: 'ask_immediate' | 'write_meeting' | 'continue';
+    /** 建议的问题列表 (用于 AskUserQuestion) */
+    suggestedQuestions?: string[];
+}
+/**
+ * 构建工具类型
+ */
+export type BuildToolType = 'npm' | 'yarn' | 'pnpm' | 'make' | 'docker' | 'gradle' | 'maven' | 'cargo' | 'go' | 'pip' | 'poetry' | 'nuget' | 'msbuild' | 'webpack' | 'vite' | 'esbuild' | 'rollup' | 'turbo' | 'bazel' | 'unknown';
+/**
+ * 构建工具信息
+ */
+export interface BuildTool {
+    /** 工具类型 */
+    type: BuildToolType;
+    /** 可用命令列表 */
+    commands: string[];
+    /** 配置文件路径 */
+    configFile?: string;
+    /** 是否为默认构建工具 */
+    isDefault?: boolean;
+    /** 工具版本 */
+    version?: string;
+}
+/**
+ * 部署方式
+ */
+export type DeployMethod = 'docker' | 'docker-compose' | 'kubernetes' | 'helm' | 'npm' | 'make' | 'script' | 'github-pages' | 'vercel' | 'netlify' | 'aws' | 'gcp' | 'azure' | 'heroku' | 'unknown';
+/**
+ * 部署选项
+ */
+export interface DeployOption {
+    /** 部署方式 */
+    method: DeployMethod;
+    /** 部署命令 */
+    command?: string;
+    /** 配置文件路径 */
+    configFile?: string;
+    /** 部署环境 */
+    environment?: 'development' | 'staging' | 'production';
+    /** 是否推荐 */
+    recommended?: boolean;
+    /** 描述信息 */
+    description?: string;
+}
+/**
+ * CI 平台类型
+ */
+export type CIPlatform = 'github-actions' | 'gitlab-ci' | 'jenkins' | 'circleci' | 'travis-ci' | 'azure-pipelines' | 'bitbucket-pipelines' | 'drone' | 'teamcity' | 'unknown';
+/**
+ * CI 配置信息
+ */
+export interface CIConfig {
+    /** CI 平台 */
+    platform: CIPlatform;
+    /** 配置文件列表 */
+    configFiles: string[];
+    /** 可用的 workflow 名称 */
+    workflows?: string[];
+    /** 触发条件 */
+    triggers?: string[];
+}
+/**
+ * 开发命令信息
+ */
+export interface DevCommands {
+    /** 安装/设置命令 */
+    setup: string[];
+    /** 构建命令 */
+    build: string[];
+    /** 测试命令 */
+    test: string[];
+    /** 开发/调试命令 */
+    dev: string[];
+    /** 启动命令 */
+    start: string[];
+    /** 清理命令 */
+    clean?: string[];
+    /** Lint 命令 */
+    lint?: string[];
+    /** 格式化命令 */
+    format?: string[];
+}
+/**
+ * 项目环境检测结果
+ */
+export interface EnvironmentInfo {
+    /** 项目名称 */
+    projectName: string;
+    /** 项目类型 */
+    projectType: ProjectType;
+    /** 项目根目录 */
+    projectRoot: string;
+    /** 检测时间 */
+    timestamp: string;
+    /** 构建工具列表 */
+    buildTools: BuildTool[];
+    /** CI 配置 */
+    ciConfig?: CIConfig;
+    /** 部署选项 */
+    deployOptions: DeployOption[];
+    /** 开发命令 */
+    devCommands: DevCommands;
+    /** 检测摘要 */
+    summary: {
+        /** 是否有构建工具 */
+        hasBuildTool: boolean;
+        /** 是否有 CI 配置 */
+        hasCIConfig: boolean;
+        /** 是否有部署选项 */
+        hasDeployOption: boolean;
+        /** 构建工具数量 */
+        buildToolCount: number;
+        /** 部署选项数量 */
+        deployOptionCount: number;
+    };
+}
+/**
+ * 项目类型 (复用 UpgradeDetector 中的定义)
+ * 注意：如果 UpgradeDetector 的 ProjectType 发生变化，这里需要同步
+ */
+export type ProjectType = 'openmatrix' | 'ai-project' | 'nodejs' | 'typescript' | 'python' | 'go' | 'rust' | 'java' | 'csharp' | 'cpp' | 'php' | 'dart' | 'ruby' | 'swift' | 'kotlin' | 'scala' | 'flutter' | 'react' | 'vue' | 'angular' | 'nextjs' | 'nuxt' | 'svelte' | 'unknown';
+/**
+ * 环境检测器配置
+ */
+export interface EnvironmentDetectorConfig {
+    /** 扫描目录 */
+    scanDirs: string[];
+    /** 排除目录 */
+    excludeDirs: string[];
+    /** 最大建议数量 */
+    maxDeployOptions?: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmatrix",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "AI Agent task orchestration system with Claude Code Skills integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -51,6 +51,7 @@
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^8.58.1",
     "@typescript-eslint/parser": "^8.58.1",
+    "@vitest/coverage-v8": "^1.6.1",
     "eslint": "^10.2.0",
     "vitest": "^1.6.0"
   },

package/skills/auto.md

@@ -154,7 +154,7 @@ openmatrix complete TASK-XXX --success       # 标记完成 + 更新统计（含
 # 提交验证（防止 commit 静默失败）:
 git status --porcelain                        # 检查是否有未提交的文件
 # 如果有未提交文件 → 必须手动提交:
-git add -A && git commit -m "feat(TASK-XXX): 任务标题"
+git add . && git commit -m "feat(TASK-XXX): 任务标题"
 
 openmatrix step --json                       # 获取下一个任务 + 检查是否全部完成
 ```
@@ -167,7 +167,68 @@ openmatrix step --json                       # 获取下一个任务 + 检查是
 4. 如果返回 `status: "blocked"` → 有阻塞任务需要处理
 </LOOP-ENFORCEMENT>
 
-对 `subagentTasks` 列表中的每个任务，**必须使用 Agent 工具**（禁止用 gsd-executor 或其他技能替代）:
+#### 6.1 歧义检测机制（全自动模式）
+
+**Agent 输出中可能包含歧义报告（JSON 格式）:**
+
+当 Agent 输出包含以下标记时，表示检测到歧义：
+```
+<AMBIGUITY_REPORT>
+{
+  "ambiguities": [
+    {
+      "type": "missing_info" | "conflicting_req" | "unclear_scope" | "tech_choice" | "edge_case",
+      "severity": "critical" | "high" | "medium" | "low",
+      "description": "歧义描述",
+      "suggestions": ["建议1", "建议2"]
+    }
+  ],
+  "overallSeverity": "critical" | "high" | "medium" | "low"
+}
+</AMBIGUITY_REPORT>
+```
+
+**5 种歧义类型说明：**
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `missing_info` | 缺失关键信息 | "未指定数据库类型" |
+| `conflicting_req` | 需求冲突 | "既要高性能又要低成本" |
+| `unclear_scope` | 范围不清晰 | "是否包含历史数据处理？" |
+| `tech_choice` | 技术选型歧义 | "用 REST 还是 GraphQL？" |
+| `edge_case` | 边界情况未定义 | "超过限制时如何处理？" |
+
+#### 6.2 歧义处理策略（全自动模式）
+
+**在 `/om:auto` 全自动模式下，所有歧义都写入 Meeting 继续执行，不中断流程：**
+
+| 严重程度 | 处理方式 |
+|---------|---------|
+| **Critical** | Meeting + 继续执行其他任务 |
+| **High** | Meeting + 继续执行其他任务 |
+| **Medium** | Meeting + 继续执行其他任务 |
+| **Low** | Meeting + 继续执行其他任务 |
+
+**全自动模式特点：**
+- ❌ **不使用 AskUserQuestion** — 全自动执行，零人工干预
+- ✅ **所有歧义写入 Meeting** — 执行完成后统一展示
+- ✅ **继续执行其他任务** — 最大化并行度，无阻塞等待
+
+**Meeting 处理流程：**
+```bash
+# 检测到歧义时，写入 Meeting 记录并继续执行
+openmatrix meeting --create --task TASK-XXX --reason "歧义: ${description}" --severity ${overallSeverity}
+
+# 继续执行下一个任务
+openmatrix step --json
+```
+
+**执行完成后提示用户：**
+```
+⚠️ 检测到 N 个歧义记录，请使用 `/om:meeting` 统一处理
+```
+
+#### 6.3 执行 Agent 任务
 
 ```typescript
 Agent({
@@ -246,7 +307,7 @@ openmatrix step --json
 Agent-1 完成 → 写入 context.md → Agent-2 读取 Agent-1 的上下文 → 写入 context.md → ...
 ```
 ```bash
-git add -A && git commit -m "$(cat <<'EOF'
+git add . && git commit -m "$(cat <<'EOF'
 feat: 任务标题
 
 改动点1

package/skills/debug.md

@@ -352,50 +352,130 @@ ${suggestedFix}
 2. 提交修复（如果文件有变更）
 3. 进入 Step 9 验证
 
-## Step 9: 验证修复
+## Step 9: 自动验证修复（循环机制）
 
-**根据问题类型选择验证方式：**
+**⛔ 自动验证流程 - 无需用户手动确认**
 
-| 问题类型 | 验证方式 |
+验证自动判断结果，失败时自动循环回修复步骤，直到通过或达到最大重试次数。
+
+### 9.1 执行验证命令（自动判断结果）
+
+根据问题类型执行验证：
+
+| 问题类型 | 验证命令 |
 |---------|---------|
-| task_failure | 重新运行失败任务或相关测试 |
-| project_bug | 运行相关测试或构建 |
+| task_failure | `npm test -- --run 2>&1` |
+| project_bug | `npm run build 2>&1` |
 | system_bug | 验证 CLI 功能 |
-| environment | 检查依赖安装状态 |
+| environment | `npm ls --depth=0 2>&1` |
+
+**自动判断验证结果：**
 
-**任务失败：**
 ```bash
-# 运行相关测试
-npm test -- --run 2>&1 | tail -20
+# 执行验证并捕获退出码
+VERIFY_RESULT=0
+npm test -- --run > /tmp/verify-output.txt 2>&1 || VERIFY_RESULT=1
+
+if [ $VERIFY_RESULT -eq 0 ]; then
+  echo "✅ 验证自动判定: 通过"
+else
+  echo "❌ 验证自动判定: 未通过"
+  cat /tmp/verify-output.txt | tail -30  # 展示失败详情
+fi
 ```
 
-**项目 bug：**
-```bash
-npm run build 2>&1 | tail -10
+### 9.2 验证失败自动循环（无需用户确认）
+
+**验证失败时自动处理：**
+
+```
+验证失败 → 重试计数 +1 → 检查重试次数 → 
+  ├─ < 3 次 → 自动回到 Step 8 重新修复（带新信息）
+  └─ >= 3 次 → 暂停，质疑架构，进入 Step 10
 ```
 
-**环境：**
-```bash
-npm ls --depth=0 2>&1 | tail -20
+**重试计数器更新：**
+- Skill 内部维护 `retryCount` 变量
+- 每次验证失败 +1
+- 验证通过后重置为 0
+
+### 9.3 自动循环回修复步骤
+
+**< 3 次验证失败 → 自动调用 Agent 重新修复：**
+
+```typescript
+// 自动重新修复，无需用户确认
+Agent({
+  subagent_type: "general-purpose",
+  description: `重新修复 (第 ${retryCount + 1} 次)`,
+  prompt: `根据验证失败结果重新分析并修复。
+
+## 铁律
+1. 只实施单一修复（不要做额外改动）
+2. 每次只改一个变量
+3. 不在诊断不清的情况下盲目尝试
+
+## 上次修复结果
+${previousFixSummary}
+
+## 验证失败详情
+${verifyFailureOutput}
+
+## 新分析
+- 上次修复为什么没生效？
+- 是否遗漏了某个根因？
+- 是否有其他影响因素？
+
+## 任务
+1. 重新分析验证失败原因
+2. 实施新的修复方案
+3. 确保修改范围最小化
+
+## 禁止行为
+❌ 重复上次失败的修复
+❌ 同时修复多个问题
+❌ 进行额外的重构`,
+  run_in_background: false
+})
 ```
 
-**验证结果判断：**
-- 测试全通过 / 构建成功 → 验证通过
-- 仍有失败 / 构建失败 → 验证未通过
+### 9.4 达到最大重试次数（>= 3 次）
 
-AskUserQuestion: `header: "验证结果"`, `multiSelect: false`
-**question:** 修复验证通过了吗？
+**输出警告并暂停：**
+
+```
+⚠️ 已尝试 3 次以上修复，验证仍未通过
+
+这可能指示架构问题：
+- 每次修复在其他地方产生新症状
+- 修复需要"大规模重构"
+- 根因分析不够深入
+
+建议：暂停并质疑根本问题，与用户讨论是否需要架构重构。
+```
+
+**此时进入 Step 10，输出 Debug Report 并询问用户下一步。**
+
+AskUserQuestion: `header: "架构问题"`, `multiSelect: false`
+**question:** 已尝试 3 次修复仍未通过，可能存在架构问题。下一步？
 
 | label | description |
 |-------|-------------|
-| 通过 | 修复成功，记录报告 |
-| 未通过 | 修复未生效，重新分析 |
-| 部分通过 | 部分修复，继续诊断 |
+| 深入重新诊断 | 从 Step 3 重新开始完整诊断 |
+| 架构重构讨论 | 讨论是否需要架构层面的改动 |
+| 接受当前状态 | 记录修复尝试，结束调试 |
+
+### 9.5 验证通过
 
-**如果验证未通过：**
-- 重试计数 +1
-- **< 3 次** → 回到 Step 3（带着新信息重新分析）
-- **>= 3 次** → 输出"已尝试 3 次以上修复，建议暂停并质疑架构"，进入 Step 10
+**验证通过 → 自动进入 Step 10**
+
+```
+✅ 验证通过
+
+修复成功，自动进入报告阶段。
+```
+
+无需用户确认，直接继续。
 
 ## Step 10: 写入 Debug Report
 
@@ -440,7 +520,7 @@ ${lessons}
 ```bash
 git status --porcelain
 # 如果有未提交文件：
-git add -A && git commit -m "$(cat <<'EOF'
+git add . && git commit -m "$(cat <<'EOF'
 fix: 修复 bug - 问题描述
 
 根因: ...
@@ -490,23 +570,72 @@ Step 7: AskUserQuestion 选择修复策略
     ↓
 Step 8: 实施修复
     ↓
-Step 9: 验证修复结果
-    ├─ 未通过 (< 3次) → 回到 Step 3
-    ├─ 未通过 (>= 3次) → Step 10
-    └─ 通过 ↓
+Step 9: ⛔ 自动验证修复（无需用户确认）
+    ├─ 执行验证命令 → 自动判断结果
+    ├─ 验证通过 → 自动进入 Step 10 ✅
+    └─ 验证失败 → 自动循环处理
+        ├─ < 3 次 → 自动回到 Step 8 重新修复
+        └─ >= 3 次 → 暂停，质疑架构，Step 10 ⚠️
 Step 10: 写入 Debug Report
 ```
 
+## 自动验证循环流程（Step 9 详细）
+
+```
+┌─────────────────────────────────────────┐
+│         Step 8: 实施修复                 │
+└─────────────────────┬───────────────────┘
+                      ↓
+┌─────────────────────────────────────────┐
+│     Step 9: 执行验证命令                 │
+│   (npm test / npm build / etc.)        │
+└─────────────────────┬───────────────────┘
+                      ↓
+              ┌───────┴───────┐
+              │ 自动判断结果   │
+              └───────┬───────┘
+        ┌─────────────┴─────────────┐
+        │                           │
+    退出码=0                    退出码≠0
+    (验证通过)                  (验证失败)
+        │                           │
+        ↓                           ↓
+┌───────────────┐          ┌───────────────────┐
+│ ✅ 进入 Step 10│          │ retryCount + 1    │
+└───────────────┘          └───────┬───────────┘
+                                    ↓
+                           ┌────────┴────────┐
+                           │ 检查重试次数     │
+                           └───────┬─────────┘
+                     ┌─────────────┴─────────────┐
+                     │                           │
+                 < 3 次                       >= 3 次
+                     │                           │
+                     ↓                           ↓
+           ┌─────────────────┐       ┌───────────────────┐
+           │ ⚡ 自动回到 Step 8 │       │ ⚠️ 暂停，质疑架构 │
+           │ (带验证失败信息)  │       │ 进入 Step 10      │
+           └─────────────────┘       └───────────────────┘
+```
+
 ## 铁律
 
 **不做根因调查，不许提修复方案**
 
+**验证失败自动循环，无需用户手动确认**
+
+**最大重试 3 次，超过必须暂停质疑架构**
+
 ## 红线
 
 - 3 次修复失败 → 暂停，质疑架构
 - 不修改未关联的文件
 - 单一修复原则
 - 修复前必须有验证方法
+- **验证必须自动判断，不得依赖用户手动确认**
+- **验证失败自动循环，不得跳过或手动绕过**
+- **达到 3 次重试必须暂停，不得继续修复**
+- 修复前必须有验证方法
 
 ## 红旗警告 - 停止并回归流程
 
@@ -522,8 +651,11 @@ Step 10: 写入 Debug Report
 - 提出解决方案前没有追踪数据流
 - **"再试一次修复"（已经试过 2+ 次）**
 - 每次修复揭示新地方的问题
+- **"验证失败，让用户确认一下吧" → 应自动循环**
+- **"重试超过 3 次了，继续试试" → 必须暂停质疑架构**
+- **"跳过自动验证，手动确认就行" → 必须执行自动验证**
 
-**所有这些意味着：停止。回到 Step 3。**
+**所有这些意味着：停止。回到 Step 3 或执行自动验证循环。**
 
 ## 常见借口 vs 真实情况
 
@@ -537,6 +669,9 @@ Step 10: 写入 Debug Report
 | "参考文档太长，我按模式改改" | 一知半解必然有 bug。完整阅读。 |
 | "我看到问题了，直接修吧" | 看到症状 ≠ 理解根因。 |
 | "再试一次修复"（失败 2+ 次后） | 3+ 次失败 = 架构问题。质疑模式，不要继续修。 |
+| "验证失败让用户确认" | 自动验证循环无需用户干预。执行自动流程。 |
+| "重试超过 3 次继续修" | 达到最大重试必须暂停。质疑架构。 |
+| "手动确认验证结果" | 必须使用自动验证判断。退出码决定一切。 |
 
 ## 3+ 次修复失败：质疑架构