openmatrix 0.2.6 → 0.2.7

package/dist/cli/commands/check.d.ts

@@ -1,2 +1,27 @@
 import { Command } from 'commander';
+import { type UpgradeSuggestion, type ProjectType, type DetectionResult, type UpgradeCategory } from '../../orchestrator/upgrade-detector.js';
 export declare const checkCommand: Command;
+/**
+ * 显示项目基本信息
+ */
+export declare function displayProjectInfo(projectName: string, projectType: ProjectType, timestamp: string): void;
+/**
+ * 显示检测摘要统计
+ */
+export declare function displaySummary(summary: DetectionResult['summary']): void;
+/**
+ * 获取类别标签映射
+ */
+export declare function getCategoryLabels(): Record<UpgradeCategory, string>;
+/**
+ * 按优先级分组显示建议
+ */
+export declare function displaySuggestionsByPriority(suggestions: UpgradeSuggestion[]): void;
+/**
+ * 显示单个优先级组的建议
+ */
+export declare function displayPriorityGroup(items: UpgradeSuggestion[], label: string, color: (text: string) => string, icon: string, maxDisplay?: number): void;
+/**
+ * 显示操作提示
+ */
+export declare function displayHints(): void;

package/dist/cli/commands/check.js

@@ -37,6 +37,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkCommand = void 0;
+exports.displayProjectInfo = displayProjectInfo;
+exports.displaySummary = displaySummary;
+exports.getCategoryLabels = getCategoryLabels;
+exports.displaySuggestionsByPriority = displaySuggestionsByPriority;
+exports.displayPriorityGroup = displayPriorityGroup;
+exports.displayHints = displayHints;
 // src/cli/commands/check.ts
 const commander_1 = require("commander");
 const upgrade_detector_js_1 = require("../../orchestrator/upgrade-detector.js");
@@ -117,13 +123,43 @@ exports.checkCommand = new commander_1.Command('check')
  */
 function displayResult(result) {
     const { projectType, projectName, suggestions, summary } = result;
+    displayProjectInfo(projectName, projectType, result.timestamp);
+    displaySummary(summary);
+    if (suggestions.length === 0) {
+        console.log(chalk_1.default.green('✅ 未发现问题，项目状态良好！\n'));
+        return;
+    }
+    displaySuggestionsByPriority(suggestions);
+    displayHints();
+}
+/**
+ * 显示项目基本信息
+ */
+function displayProjectInfo(projectName, projectType, timestamp) {
     console.log(chalk_1.default.bold(`📦 项目: ${projectName}`));
     console.log(`   类型: ${formatProjectType(projectType)}`);
-    console.log(`   扫描时间: ${new Date(result.timestamp).toLocaleString()}\n`);
-    // 摘要
+    console.log(`   扫描时间: ${new Date(timestamp).toLocaleString()}\n`);
+}
+/**
+ * 显示检测摘要统计
+ */
+function displaySummary(summary) {
     console.log(chalk_1.default.bold('📊 检测摘要'));
     console.log('━'.repeat(42));
-    const categoryLabels = {
+    const categoryLabels = getCategoryLabels();
+    for (const [cat, count] of Object.entries(summary.byCategory)) {
+        if (count > 0) {
+            console.log(`   ${categoryLabels[cat]}: ${chalk_1.default.yellow(count)}`);
+        }
+    }
+    console.log(`\n   总计: ${chalk_1.default.bold(summary.total)} 个建议`);
+    console.log(`   可自动修复: ${chalk_1.default.green(summary.autoFixable)} 个\n`);
+}
+/**
+ * 获取类别标签映射
+ */
+function getCategoryLabels() {
+    return {
         bug: '🐛 代码缺陷',
         quality: '🔧 代码质量',
         capability: '📦 缺失能力',
@@ -135,53 +171,42 @@ function displayResult(result) {
         skill: '⚡ Skill 问题',
         agent: '🧠 Agent 配置'
     };
-    for (const [cat, count] of Object.entries(summary.byCategory)) {
-        if (count > 0) {
-            console.log(`   ${categoryLabels[cat]}: ${chalk_1.default.yellow(count)}`);
-        }
-    }
-    console.log(`\n   总计: ${chalk_1.default.bold(summary.total)} 个建议`);
-    console.log(`   可自动修复: ${chalk_1.default.green(summary.autoFixable)} 个\n`);
-    if (suggestions.length === 0) {
-        console.log(chalk_1.default.green('✅ 未发现问题，项目状态良好！\n'));
-        return;
-    }
-    // 详细建议
+}
+/**
+ * 按优先级分组显示建议
+ */
+function displaySuggestionsByPriority(suggestions) {
     console.log(chalk_1.default.bold('📋 改进建议'));
     console.log('━'.repeat(42) + '\n');
-    // 按优先级分组
-    const critical = suggestions.filter(s => s.priority === 'critical');
-    const high = suggestions.filter(s => s.priority === 'high');
-    const medium = suggestions.filter(s => s.priority === 'medium');
-    const low = suggestions.filter(s => s.priority === 'low');
-    if (critical.length > 0) {
-        console.log(chalk_1.default.red.bold('🚨 关键问题:\n'));
-        for (const s of critical) {
-            displaySuggestion(s);
+    const groups = [
+        { items: suggestions.filter(s => s.priority === 'critical'), label: '关键问题', color: chalk_1.default.red.bold, icon: '🚨' },
+        { items: suggestions.filter(s => s.priority === 'high'), label: '高优先级', color: chalk_1.default.yellow.bold, icon: '⚠️' },
+        { items: suggestions.filter(s => s.priority === 'medium'), label: '中优先级', color: chalk_1.default.blue.bold, icon: '📋' },
+        { items: suggestions.filter(s => s.priority === 'low'), label: '低优先级', color: chalk_1.default.gray.bold, icon: '💡', maxDisplay: 10 },
+    ];
+    for (const group of groups) {
+        if (group.items.length > 0) {
+            displayPriorityGroup(group.items, group.label, group.color, group.icon, group.maxDisplay);
         }
     }
-    if (high.length > 0) {
-        console.log(chalk_1.default.yellow.bold('⚠️ 高优先级:\n'));
-        for (const s of high) {
-            displaySuggestion(s);
-        }
+}
+/**
+ * 显示单个优先级组的建议
+ */
+function displayPriorityGroup(items, label, color, icon, maxDisplay) {
+    const displayItems = maxDisplay ? items.slice(0, maxDisplay) : items;
+    console.log(color(`${icon} ${label}:\n`));
+    for (const s of displayItems) {
+        displaySuggestion(s);
     }
-    if (medium.length > 0) {
-        console.log(chalk_1.default.blue.bold('📋 中优先级:\n'));
-        for (const s of medium) {
-            displaySuggestion(s);
-        }
+    if (maxDisplay && items.length > maxDisplay) {
+        console.log(chalk_1.default.gray(`   ... 还有 ${items.length - maxDisplay} 个低优先级建议\n`));
     }
-    if (low.length > 0) {
-        console.log(chalk_1.default.gray.bold('💡 低优先级:\n'));
-        for (const s of low.slice(0, 10)) { // 限制显示
-            displaySuggestion(s);
-        }
-        if (low.length > 10) {
-            console.log(chalk_1.default.gray(`   ... 还有 ${low.length - 10} 个低优先级建议\n`));
-        }
-    }
-    // 提示
+}
+/**
+ * 显示操作提示
+ */
+function displayHints() {
     console.log(chalk_1.default.gray('━'.repeat(42)));
     console.log(chalk_1.default.gray('💡 提示:'));
     console.log(chalk_1.default.gray('   --interactive  交互式选择改进项'));

package/dist/cli/commands/install-skills.js

@@ -62,7 +62,7 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
     }
     catch (err) {
         console.error('❌ Cannot create directory:', commandsDir);
-        console.error('   Error:', err.message);
+        console.error('   Error:', err instanceof Error ? err.message : String(err));
         process.exit(1);
     }
     // Get skill files (excluding om.md and openmatrix.md which are handled separately)
@@ -92,7 +92,7 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
             installed++;
         }
         catch (err) {
-            console.log(`  ❌ Failed: ${file} (${err.message})`);
+            console.log(`  ❌ Failed: ${file} (${err instanceof Error ? err.message : String(err)})`);
             failed++;
         }
     });
@@ -112,7 +112,7 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
             }
         }
         catch (err) {
-            console.log(`  ❌ Failed: om.md (${err.message})`);
+            console.log(`  ❌ Failed: om.md (${err instanceof Error ? err.message : String(err)})`);
             failed++;
         }
     }
@@ -132,7 +132,7 @@ exports.installSkillsCommand = new commander_1.Command('install-skills')
             }
         }
         catch (err) {
-            console.log(`  ❌ Failed: openmatrix.md (${err.message})`);
+            console.log(`  ❌ Failed: openmatrix.md (${err instanceof Error ? err.message : String(err)})`);
             failed++;
         }
     }

package/dist/cli/commands/report.d.ts

@@ -1,2 +1,25 @@
 import { Command } from 'commander';
+import type { GlobalState, Task, Approval } from '../../types/index.js';
 export declare const reportCommand: Command;
+export interface TaskStats {
+    total: number;
+    completed: number;
+    failed: number;
+    inProgress: number;
+    pending: number;
+    blocked: number;
+}
+export interface EfficiencyData {
+    totalDuration: number;
+    agentCalls: number;
+    retryCount: number;
+    parallelism: number;
+    targetParallelism: number;
+}
+export interface ReportOptions {
+    format: string;
+    output?: string;
+    efficiency?: boolean;
+    graph?: boolean;
+}
+export declare function generateMarkdownReport(state: GlobalState, tasks: Task[], approvals: Approval[], stats: TaskStats, efficiency: EfficiencyData, options: ReportOptions): string;

package/dist/cli/commands/report.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.reportCommand = void 0;
+exports.generateMarkdownReport = generateMarkdownReport;
 // src/cli/commands/report.ts
 const commander_1 = require("commander");
 const state_manager_js_1 = require("../../storage/state-manager.js");

package/dist/cli/commands/status.d.ts

@@ -1,2 +1,10 @@
 import { Command } from 'commander';
 export declare const statusCommand: Command;
+/**
+ * 格式化状态显示
+ */
+export declare function formatStatus(status: string): string;
+/**
+ * 获取状态颜色函数
+ */
+export declare function getStatusColor(status: string): (text: string) => string;

package/dist/cli/commands/status.js

@@ -37,6 +37,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.statusCommand = void 0;
+exports.formatStatus = formatStatus;
+exports.getStatusColor = getStatusColor;
 const commander_1 = require("commander");
 const state_manager_js_1 = require("../../storage/state-manager.js");
 const progress_reporter_js_1 = require("../../utils/progress-reporter.js");
@@ -197,29 +199,28 @@ async function runWatchMode(manager, reporter, options) {
  * 格式化状态显示
  */
 function formatStatus(status) {
-    const colors = {
-        initialized: 'gray',
-        running: 'green',
-        paused: 'yellow',
-        completed: 'green',
-        failed: 'red'
+    const colorMap = {
+        initialized: chalk_1.default.gray,
+        running: chalk_1.default.green,
+        paused: chalk_1.default.yellow,
+        completed: chalk_1.default.green,
+        failed: chalk_1.default.red
     };
-    const color = colors[status] || 'white';
-    return chalk_1.default[color](status);
+    const colorFn = colorMap[status] || chalk_1.default.white;
+    return colorFn(status);
 }
 /**
  * 获取状态颜色函数
  */
 function getStatusColor(status) {
-    const colors = {
-        completed: 'green',
-        in_progress: 'blue',
-        failed: 'red',
-        blocked: 'red',
-        pending: 'gray',
-        verify: 'yellow',
-        accept: 'cyan'
+    const colorMap = {
+        completed: chalk_1.default.green,
+        in_progress: chalk_1.default.blue,
+        failed: chalk_1.default.red,
+        blocked: chalk_1.default.red,
+        pending: chalk_1.default.gray,
+        verify: chalk_1.default.yellow,
+        accept: chalk_1.default.cyan
     };
-    const color = colors[status] || 'white';
-    return chalk_1.default[color];
+    return colorMap[status] || chalk_1.default.white;
 }

package/dist/orchestrator/phase-executor.js

@@ -251,6 +251,12 @@ ${task.acceptanceCriteria?.map((c, i) => `${i + 1}. ${c}`).join('\n') || '根据
 ## 验证
 运行 \`npm test\` 确认测试失败 (这是正确的!)
 
+## ⚠️ Git 提交规范
+
+**禁止执行 \`git commit\`**
+
+所有代码提交必须通过 \`openmatrix complete\` 命令统一执行。测试文件创建完成后，只需返回结果摘要，**不要执行 git commit**。
+
 ## 输出格式
 \`\`\`
 TDD_TESTS_CREATED
@@ -379,6 +385,17 @@ ${task.acceptanceCriteria.map((c, i) => `${i + 1}. [ ] ${c}`).join('\n')}`);
 - [ ] 代码风格一致
 - [ ] 验收标准全部满足
 ${isTDDMode ? '- [ ] 所有测试通过 (GREEN)' : ''}
+
+## ⚠️ Git 提交规范
+
+**禁止执行 \`git commit\`**
+
+所有代码提交必须通过 \`openmatrix complete\` 命令统一执行，该命令会：
+1. 使用正确的任务标题 (当前任务: ${task.title})
+2. 自动生成规范的提交信息
+3. 避免产生重复或无意义的提交
+
+如果代码变更已完成，只需返回结果摘要，**不要执行 git commit**。
 `);
         return parts.join('\n');
     }
@@ -659,6 +676,7 @@ Fix Required:
 - **不要伪造通过结果**
 - 如果项目没有某个脚本，标记为 "⏭️ Skipped" 而非 "❌ Failed"
 - 所有检查结果必须基于实际命令输出
+- **禁止执行 \`git commit\`** — 所有提交统一通过 \`openmatrix complete\` 执行
 
 ## 🔧 配置检查 (可选但推荐)
 检查以下常见配置问题:
@@ -792,6 +810,9 @@ ACCEPT_FAILED
 失败原因:
 1. [原因]
 \`\`\`
+
+## ⚠️ Git 提交规范
+**禁止执行 \`git commit\`** — 所有提交统一通过 \`openmatrix complete\` 执行，确保使用正确的任务标题。
 `);
         return parts.join('\n');
     }

package/dist/orchestrator/upgrade-detector.js

@@ -37,6 +37,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpgradeDetector = exports.DEFAULT_DETECTOR_CONFIG = void 0;
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
+/**
+ * 已知的绝对路径前缀模式，用于检测代码中的硬编码路径
+ * 涵盖 Windows 盘符 (C:\, D:\ 等)、Unix 家目录 (/home/, /Users/) 和常见系统路径
+ */
+const HARDCODED_PATH_PATTERNS = [
+    /[A-Za-z]:\\/, // Windows 盘符路径 (C:\, D:\ 等)
+    /\/home\/[a-zA-Z_]/, // Linux 家目录
+    /\/Users\/[a-zA-Z_]/, // macOS 家目录
+    /\/var\/[a-zA-Z_]/, // Linux 系统路径
+    /\/etc\//, // Unix 配置路径
+    /\/tmp\//, // Unix 临时路径
+    /\/opt\//, // Unix 可选软件路径
+    /\\Users\\[a-zA-Z_]/, // Windows 风格的 macOS 路径引用
+];
 /**
  * 默认配置
  */
@@ -301,7 +315,7 @@ class UpgradeDetector {
             const content = await fs.readFile(file, 'utf-8');
             const lines = content.split('\n');
             lines.forEach((line, index) => {
-                // TODO 检测
+                // 待办标记检测
                 const todoMatch = line.match(/\/\/\s*TODO(?:\(([^)]+)\))?:?\s*(.+)/i);
                 if (todoMatch) {
                     suggestions.push(this.createSuggestion({
@@ -316,7 +330,7 @@ class UpgradeDetector {
                         effort: 'small'
                     }));
                 }
-                // FIXME 检测
+                // 待修复标记检测
                 const fixmeMatch = line.match(/\/\/\s*FIXME(?:\(([^)]+)\))?:?\s*(.+)/i);
                 if (fixmeMatch) {
                     suggestions.push(this.createSuggestion({
@@ -331,18 +345,21 @@ class UpgradeDetector {
                         effort: 'medium'
                     }));
                 }
-                // HACK 检测
-                const hackMatch = line.match(/\/\/\s*HACK:?\s*(.+)/i);
+                // 临时方案标记检测
+                const hackMatch = line.match(/\/\/\s*HACK(?:\(([^)]+)\))?:?\s*(.+)/i);
                 if (hackMatch) {
+                    const hackPriority = hackMatch[1] === 'critical' ? 'critical'
+                        : hackMatch[1] === 'high' ? 'high'
+                            : 'medium';
                     suggestions.push(this.createSuggestion({
                         category: 'bug',
-                        priority: 'medium',
-                        title: `临时方案: ${hackMatch[1]}`,
-                        description: `发现 HACK 标记，表示使用了临时解决方案`,
+                        priority: hackPriority,
+                        title: `临时方案: ${hackMatch[2]}`,
+                        description: `发现 HACK 标记，表示使用了临时解决方案: ${hackMatch[2]}`,
                         location: { file: this.getRelativePath(file), line: index + 1 },
-                        suggestion: `替换为正式实现`,
+                        suggestion: `将临时方案替换为正式实现: ${hackMatch[2]}`,
                         autoFixable: false,
-                        impact: '技术债务累积',
+                        impact: '技术债务累积，可能影响长期可维护性',
                         effort: 'medium'
                     }));
                 }
@@ -407,8 +424,8 @@ class UpgradeDetector {
                         }));
                     }
                 }
-                // console.log 检测 (生产代码)
-                if (line.includes('console.log') && !file.includes('test') && !file.includes('spec')) {
+                // console.log 检测 (生产代码，排除 CLI 命令文件)
+                if (line.includes('console.log') && !file.includes('test') && !file.includes('spec') && !file.includes('commands/')) {
                     suggestions.push(this.createSuggestion({
                         category: 'quality',
                         priority: 'low',
@@ -683,7 +700,10 @@ class UpgradeDetector {
             // 检测硬编码字符串
             lines.forEach((line, index) => {
                 // 硬编码路径
-                if (line.includes('C:\\') || line.includes('/home/') || line.includes('/Users/')) {
+                if (HARDCODED_PATH_PATTERNS.some(pattern => pattern.test(line))) {
+                    const relPath = this.getRelativePath(file);
+                    if (relPath.includes('upgrade-detector'))
+                        return;
                     if (!line.includes('example') && !line.includes('test')) {
                         suggestions.push(this.createSuggestion({
                             category: 'common',

package/dist/storage/file-store.js

@@ -48,7 +48,8 @@ class FileStore {
         }
         catch (error) {
             // 只隐藏"文件不存在"错误，其他错误（权限、磁盘等）抛出以便调用者处理
-            if (error.code === 'ENOENT' || error.code === 'EISDIR') {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT' || nodeError.code === 'EISDIR') {
                 return null;
             }
             throw error;
@@ -64,7 +65,8 @@ class FileStore {
             return await (0, promises_1.readFile)(fullPath, 'utf-8');
         }
         catch (error) {
-            if (error.code === 'ENOENT' || error.code === 'EISDIR') {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT' || nodeError.code === 'EISDIR') {
                 return null;
             }
             throw error;
@@ -126,7 +128,8 @@ class FileStore {
             return JSON.parse(content);
         }
         catch (error) {
-            if (error.code === 'ENOENT' || error.code === 'EISDIR') {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT' || nodeError.code === 'EISDIR') {
                 return null;
             }
             throw error;

package/dist/utils/logger.d.ts

@@ -42,10 +42,10 @@ export declare function initLoggerWithRunId(runId: string, omPath?: string): voi
  * 便捷方法: 直接记录日志
  */
 export declare const logger: {
-    info: (message: string, meta?: any) => winston.Logger;
-    error: (message: string, meta?: any) => winston.Logger;
-    warn: (message: string, meta?: any) => winston.Logger;
-    debug: (message: string, meta?: any) => winston.Logger;
+    info: (message: string, meta?: Record<string, unknown>) => winston.Logger;
+    error: (message: string, meta?: Record<string, unknown>) => winston.Logger;
+    warn: (message: string, meta?: Record<string, unknown>) => winston.Logger;
+    debug: (message: string, meta?: Record<string, unknown>) => winston.Logger;
     structured: {
         info: (operation: string, message: string, meta?: Record<string, unknown>, omPath?: string) => void;
         error: (operation: string, message: string, meta?: Record<string, unknown>, omPath?: string) => void;

package/package.json

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

package/skills/auto.md

@@ -173,7 +173,7 @@ openmatrix step --json                       # 获取下一个任务 + 检查是
 Agent({
   subagent_type: task.subagent_type,
   description: task.description,
-  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议",
+  prompt: task.prompt + "\n\n⚠️ 完成后请输出简短摘要（不超过3行）：\n1. 关键决策\n2. 创建/修改的文件\n3. 对后续任务的建议\n\n🚫 **禁止执行 git commit** — 所有提交统一通过 openmatrix complete 执行，确保使用正确的任务标题。",
   isolation: task.isolation,
   run_in_background: true
 })
@@ -182,6 +182,8 @@ Agent({
 > ⚠️ **必须使用原生 Agent 工具** — 禁止调用 gsd-executor、superpowers 或任何其他编排技能。
 >
 > **上下文节省**: 使用 `run_in_background: true` 后台执行，Agent 完成后仅返回简短摘要，大幅节省主会话上下文。
+>
+> 🚫 **Agent 内部禁止 git commit** — 所有提交必须通过 `openmatrix complete` 执行，否则会产生无意义提交。
 
 每个 Agent 完成后:
 1. **保存 Agent 上下文** — 将执行结果摘要写入 `.openmatrix/tasks/TASK-XXX/context.md`，格式如下: