openmatrix 0.2.5 → 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/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/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/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;