openmatrix 0.2.4 → 0.2.6

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

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const debugCommand: Command;

package/dist/cli/commands/debug.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debugCommand = void 0;
+// src/cli/commands/debug.ts
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const debug_manager_js_1 = require("../../orchestrator/debug-manager.js");
+exports.debugCommand = new commander_1.Command('debug')
+    .description('系统化调试 - 诊断并修复问题')
+    .argument('[description]', '问题描述')
+    .option('--task <taskId>', '调试指定的失败任务')
+    .option('--diagnose-only', '仅诊断，不执行修复')
+    .option('--json', '输出 JSON 格式')
+    .option('--list', '列出最近的调试会话')
+    .action(async (description, options) => {
+    const basePath = process.cwd();
+    const omPath = `${basePath}/.openmatrix`;
+    // 初始化 .openmatrix 目录（如果不存在）
+    if (!fs.existsSync(omPath)) {
+        console.log('❌ .openmatrix 目录不存在，请先运行: openmatrix start --init-only');
+        return;
+    }
+    const debugManager = new debug_manager_js_1.DebugManager(omPath);
+    // 列出最近的调试会话
+    if (options.list) {
+        const sessions = debugManager.listRecent();
+        if (sessions.length === 0) {
+            console.log('📋 没有调试记录');
+            return;
+        }
+        console.log('📋 最近的调试会话:\n');
+        sessions.forEach(s => {
+            console.log(`  ${s.id}  ${s.status}  ${s.description}`);
+            console.log(`       ${s.createdAt}`);
+        });
+        return;
+    }
+    // 如果没有描述也没有任务 ID，提示用户
+    if (!description && !options.task) {
+        console.log('🔍 系统化调试 - 诊断并修复问题\n');
+        console.log('用法:');
+        console.log('  openmatrix debug <问题描述>           描述问题开始调试');
+        console.log('  openmatrix debug --task TASK-XXX       调试指定失败任务');
+        console.log('  openmatrix debug --diagnose-only       仅诊断不修复');
+        console.log('  openmatrix debug --list                列出最近调试记录');
+        console.log('  openmatrix debug --json                输出 JSON 格式\n');
+        console.log('示例:');
+        console.log('  openmatrix debug "API 返回 500 错误"');
+        console.log('  openmatrix debug --task TASK-003');
+        console.log('  openmatrix debug "测试失败" --diagnose-only');
+        return;
+    }
+    // 初始化调试会话
+    const result = await debugManager.initialize({
+        description,
+        taskId: options.task,
+        diagnoseOnly: options.diagnoseOnly
+    });
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    // 展示诊断信息
+    console.log('\n🔍 调试会话已初始化');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log(`会话 ID:    ${result.sessionId}`);
+    console.log(`状态:       ${result.status}`);
+    console.log(`问题类型:   ${result.problemType}`);
+    console.log(`问题描述:   ${result.report.description}`);
+    if (result.report.relatedTaskId) {
+        console.log(`关联任务:   ${result.report.relatedTaskId}`);
+    }
+    if (result.report.errorInfo?.message) {
+        console.log(`错误信息:   ${result.report.errorInfo.message}`);
+    }
+    if (result.report.relatedFiles && result.report.relatedFiles.length > 0) {
+        console.log(`相关文件:   ${result.report.relatedFiles.join(', ')}`);
+    }
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('\n💡 下一步:');
+    console.log('   使用 /om:debug 进入系统化调试流程');
+    console.log('   或使用 openmatrix debug --list 查看所有调试记录');
+});

package/dist/cli/index.js

@@ -51,6 +51,7 @@ const check_gitignore_js_1 = require("./commands/check-gitignore.js");
 const analyze_js_1 = require("./commands/analyze.js");
 const brainstorm_js_1 = require("./commands/brainstorm.js");
 const research_js_1 = require("./commands/research.js");
+const debug_js_1 = require("./commands/debug.js");
 const complete_js_1 = require("./commands/complete.js");
 const step_js_1 = require("./commands/step.js");
 // 读取 package.json 版本
@@ -85,5 +86,6 @@ program.addCommand(check_gitignore_js_1.checkGitignoreCommand);
 program.addCommand(analyze_js_1.analyzeCommand);
 program.addCommand(brainstorm_js_1.brainstormCommand);
 program.addCommand(research_js_1.researchCommand);
+program.addCommand(debug_js_1.debugCommand);
 // 默认帮助
 program.parse();

package/dist/orchestrator/context-collector.d.ts

@@ -0,0 +1,23 @@
+export interface DebugContext {
+    state?: Record<string, unknown>;
+    task?: Record<string, unknown>;
+    logs?: string;
+    errorStack?: string;
+    projectFiles?: string[];
+    envInfo?: Record<string, unknown>;
+    configFiles?: string[];
+    cliLogs?: string;
+    systemState?: Record<string, unknown>;
+}
+/**
+ * 根据问题类型收集上下文信息
+ */
+export declare class ContextCollector {
+    private basePath;
+    constructor(basePath: string);
+    collectForTaskFailure(taskId: string): Promise<DebugContext>;
+    collectForProjectBug(): Promise<DebugContext>;
+    collectForEnvironment(): Promise<DebugContext>;
+    collectForSystemBug(): Promise<DebugContext>;
+    private scanFiles;
+}

package/dist/orchestrator/context-collector.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextCollector = void 0;
+// src/orchestrator/context-collector.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 根据问题类型收集上下文信息
+ */
+class ContextCollector {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async collectForTaskFailure(taskId) {
+        const context = {};
+        // 读取全局状态
+        const statePath = path.join(this.basePath, 'state.json');
+        if (fs.existsSync(statePath)) {
+            try {
+                context.state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+            }
+            catch { /* ignore */ }
+        }
+        // 读取任务文件
+        const taskPath = path.join(this.basePath, 'tasks', `${taskId}.json`);
+        if (fs.existsSync(taskPath)) {
+            try {
+                context.task = JSON.parse(fs.readFileSync(taskPath, 'utf-8'));
+            }
+            catch { /* ignore */ }
+        }
+        // 读取日志
+        const logPath = path.join(this.basePath, 'logs');
+        if (fs.existsSync(logPath)) {
+            try {
+                const files = fs.readdirSync(logPath);
+                const logs = files
+                    .filter(f => f.endsWith('.log') || f.includes(taskId))
+                    .map(f => fs.readFileSync(path.join(logPath, f), 'utf-8'))
+                    .join('\n---\n');
+                if (logs)
+                    context.logs = logs;
+            }
+            catch { /* ignore */ }
+        }
+        return context;
+    }
+    async collectForProjectBug() {
+        const context = {};
+        // 扫描项目关键文件
+        const projectRoot = path.resolve(this.basePath, '..');
+        const scanDirs = ['src', 'lib', 'app', 'server', 'api', 'controllers', 'routes'];
+        const projectFiles = [];
+        for (const dir of scanDirs) {
+            const fullPath = path.join(projectRoot, dir);
+            if (fs.existsSync(fullPath)) {
+                const files = this.scanFiles(fullPath, ['.ts', '.js', '.tsx', '.jsx'], 2);
+                projectFiles.push(...files);
+            }
+        }
+        if (projectFiles.length > 0) {
+            context.projectFiles = projectFiles.slice(0, 50);
+        }
+        return context;
+    }
+    async collectForEnvironment() {
+        const context = {};
+        // 收集环境信息
+        const envInfo = {
+            nodeVersion: process.version,
+            platform: process.platform,
+            cwd: process.cwd(),
+            envVars: Object.keys(process.env).slice(0, 20)
+        };
+        context.envInfo = envInfo;
+        // 扫描配置文件
+        const projectRoot = path.resolve(this.basePath, '..');
+        const configFiles = [
+            'package.json',
+            'tsconfig.json',
+            '.env',
+            '.env.local',
+            'config.json',
+            'webpack.config.js',
+            'vite.config.ts',
+            '.openmatrix/state.json'
+        ];
+        const found = [];
+        for (const file of configFiles) {
+            const fullPath = path.join(projectRoot, file);
+            if (fs.existsSync(fullPath)) {
+                found.push(file);
+            }
+        }
+        if (found.length > 0) {
+            context.configFiles = found;
+        }
+        return context;
+    }
+    async collectForSystemBug() {
+        const context = {};
+        // 读取系统状态
+        const statePath = path.join(this.basePath, 'state.json');
+        if (fs.existsSync(statePath)) {
+            try {
+                context.systemState = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+            }
+            catch { /* ignore */ }
+        }
+        return context;
+    }
+    scanFiles(dir, extensions, maxDepth, currentDepth = 0) {
+        if (currentDepth > maxDepth)
+            return [];
+        const results = [];
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (!entry.name.startsWith('.') && entry.name !== 'node_modules') {
+                        results.push(...this.scanFiles(fullPath, extensions, maxDepth, currentDepth + 1));
+                    }
+                }
+                else if (extensions.some(ext => entry.name.endsWith(ext))) {
+                    results.push(fullPath.replace(process.cwd() + path.sep, ''));
+                }
+            }
+        }
+        catch { /* ignore */ }
+        return results;
+    }
+}
+exports.ContextCollector = ContextCollector;

package/dist/orchestrator/debug-manager.d.ts

@@ -0,0 +1,52 @@
+import type { DebugSession, DiagnosisReport, ProblemType } from '../types/index.js';
+export interface DebugConfig {
+    description?: string;
+    taskId?: string;
+    diagnoseOnly?: boolean;
+}
+export interface DebugInitResult {
+    sessionId: string;
+    status: string;
+    problemType: ProblemType;
+    report: Partial<DiagnosisReport>;
+}
+/**
+ * 调试管理器 - 协调整个调试流程
+ */
+export declare class DebugManager {
+    private omPath;
+    private detector;
+    private collector;
+    private reporter;
+    constructor(omPath: string);
+    /**
+     * 初始化调试会话
+     */
+    initialize(config: DebugConfig): Promise<DebugInitResult>;
+    /**
+     * 获取会话
+     */
+    getSession(sessionId: string): DebugSession | null;
+    /**
+     * 更新会话
+     */
+    updateSession(sessionId: string, updates: Partial<DebugSession>): void;
+    /**
+     * 完成会话
+     */
+    completeSession(sessionId: string): Promise<string | null>;
+    /**
+     * 列出最近的调试会话
+     */
+    listRecent(): {
+        id: string;
+        status: string;
+        description: string;
+        createdAt: string;
+    }[];
+    private collectContext;
+    private getTaskError;
+    private saveSession;
+    private getSessionPath;
+    private generateSessionId;
+}

package/dist/orchestrator/debug-manager.js

@@ -0,0 +1,214 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugManager = void 0;
+// src/orchestrator/debug-manager.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const problem_detector_js_1 = require("./problem-detector.js");
+const context_collector_js_1 = require("./context-collector.js");
+const debug_reporter_js_1 = require("./debug-reporter.js");
+/**
+ * 调试管理器 - 协调整个调试流程
+ */
+class DebugManager {
+    omPath;
+    detector;
+    collector;
+    reporter;
+    constructor(omPath) {
+        this.omPath = omPath;
+        this.detector = new problem_detector_js_1.ProblemDetector();
+        this.collector = new context_collector_js_1.ContextCollector(omPath);
+        this.reporter = new debug_reporter_js_1.DebugReporter(omPath);
+    }
+    /**
+     * 初始化调试会话
+     */
+    async initialize(config) {
+        // 如果有任务 ID，尝试读取任务信息
+        let taskError = null;
+        if (config.taskId) {
+            taskError = await this.getTaskError(config.taskId);
+        }
+        // 判断问题类型
+        const problemType = await this.detector.detect({
+            description: config.description,
+            taskId: config.taskId,
+            taskError
+        });
+        // 收集上下文
+        const context = await this.collectContext(problemType, config);
+        // 创建会话
+        const sessionId = this.generateSessionId();
+        const session = {
+            id: sessionId,
+            status: config.diagnoseOnly ? 'initialized' : 'diagnosing',
+            report: {
+                id: sessionId,
+                problemType,
+                trigger: config.taskId ? 'auto' : 'explicit',
+                description: config.description || `调试任务 ${config.taskId}`,
+                relatedTaskId: config.taskId,
+                errorInfo: taskError ? {
+                    message: taskError,
+                    timestamp: new Date().toISOString()
+                } : undefined,
+                relatedFiles: context.projectFiles || [],
+                rootCause: '', // 由 Skill 阶段 Agent 填充
+                impactScope: [],
+                suggestedFix: '', // 由 Skill 阶段 Agent 填充
+                diagnosedAt: new Date().toISOString()
+            },
+            retryCount: 0,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString()
+        };
+        // 持久化会话
+        this.saveSession(session);
+        return {
+            sessionId,
+            status: session.status,
+            problemType,
+            report: {
+                description: session.report.description,
+                relatedTaskId: session.report.relatedTaskId,
+                relatedFiles: session.report.relatedFiles,
+                errorInfo: session.report.errorInfo
+            }
+        };
+    }
+    /**
+     * 获取会话
+     */
+    getSession(sessionId) {
+        const sessionPath = this.getSessionPath(sessionId);
+        if (!fs.existsSync(sessionPath))
+            return null;
+        try {
+            return JSON.parse(fs.readFileSync(sessionPath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 更新会话
+     */
+    updateSession(sessionId, updates) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            return;
+        Object.assign(session, updates, { updatedAt: new Date().toISOString() });
+        this.saveSession(session);
+    }
+    /**
+     * 完成会话
+     */
+    async completeSession(sessionId) {
+        const session = this.getSession(sessionId);
+        if (!session)
+            return null;
+        session.status = 'completed';
+        session.completedAt = new Date().toISOString();
+        this.saveSession(session);
+        return await this.reporter.generateReport(session);
+    }
+    /**
+     * 列出最近的调试会话
+     */
+    listRecent() {
+        const debugDir = path.join(this.omPath, 'debug');
+        if (!fs.existsSync(debugDir))
+            return [];
+        const files = fs.readdirSync(debugDir)
+            .filter(f => f.endsWith('.json') && f.startsWith('DEBUG-'))
+            .sort()
+            .reverse()
+            .slice(0, 10);
+        return files.map(f => {
+            const session = JSON.parse(fs.readFileSync(path.join(debugDir, f), 'utf-8'));
+            return {
+                id: session.id,
+                status: session.status,
+                description: session.report.description,
+                createdAt: session.createdAt
+            };
+        });
+    }
+    async collectContext(problemType, config) {
+        switch (problemType) {
+            case 'task_failure':
+                return config.taskId ? await this.collector.collectForTaskFailure(config.taskId) : {};
+            case 'project_bug':
+                return await this.collector.collectForProjectBug();
+            case 'environment':
+                return await this.collector.collectForEnvironment();
+            case 'system_bug':
+                return await this.collector.collectForSystemBug();
+            default:
+                return {};
+        }
+    }
+    async getTaskError(taskId) {
+        const taskPath = path.join(this.omPath, 'tasks', `${taskId}.json`);
+        if (!fs.existsSync(taskPath))
+            return null;
+        try {
+            const task = JSON.parse(fs.readFileSync(taskPath, 'utf-8'));
+            return task.error || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    saveSession(session) {
+        const debugDir = path.join(this.omPath, 'debug');
+        if (!fs.existsSync(debugDir)) {
+            fs.mkdirSync(debugDir, { recursive: true });
+        }
+        const sessionPath = this.getSessionPath(session.id);
+        fs.writeFileSync(sessionPath, JSON.stringify(session, null, 2), 'utf-8');
+    }
+    getSessionPath(sessionId) {
+        return path.join(this.omPath, 'debug', `${sessionId}.json`);
+    }
+    generateSessionId() {
+        const timestamp = Date.now().toString(36).toUpperCase();
+        const random = Math.random().toString(36).substring(2, 5).toUpperCase();
+        return `DEBUG-${timestamp}${random}`;
+    }
+}
+exports.DebugManager = DebugManager;

package/dist/orchestrator/debug-reporter.d.ts

@@ -0,0 +1,25 @@
+import type { DebugSession } from '../types/index.js';
+/**
+ * 生成和保存诊断报告
+ */
+export declare class DebugReporter {
+    private debugDir;
+    constructor(basePath: string);
+    /**
+     * 生成诊断报告文件
+     */
+    generateReport(session: DebugSession): Promise<string>;
+    /**
+     * 格式化报告内容为 Markdown
+     */
+    private formatReport;
+    /**
+     * 列出所有诊断报告
+     */
+    listReports(): {
+        id: string;
+        path: string;
+        createdAt: string;
+    }[];
+    private ensureDir;
+}