openmatrix 0.2.5 → 0.2.7

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;
+}

package/dist/orchestrator/debug-reporter.js

@@ -0,0 +1,167 @@
+"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.DebugReporter = void 0;
+// src/orchestrator/debug-reporter.ts
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 生成和保存诊断报告
+ */
+class DebugReporter {
+    debugDir;
+    constructor(basePath) {
+        this.debugDir = path.join(basePath, 'debug');
+        this.ensureDir();
+    }
+    /**
+     * 生成诊断报告文件
+     */
+    async generateReport(session) {
+        const report = session.report;
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const fileName = `${report.id}-report-${timestamp}.md`;
+        const filePath = path.join(this.debugDir, fileName);
+        const content = this.formatReport(session);
+        fs.writeFileSync(filePath, content, 'utf-8');
+        return filePath;
+    }
+    /**
+     * 格式化报告内容为 Markdown
+     */
+    formatReport(session) {
+        const { report, fixResult, verifyResult } = session;
+        let md = `# Debug Report\n\n`;
+        md += `**会话 ID**: ${session.id}\n`;
+        md += `**日期**: ${session.createdAt}\n`;
+        md += `**状态**: ${session.status}\n`;
+        if (session.completedAt) {
+            md += `**完成时间**: ${session.completedAt}\n`;
+        }
+        md += `\n---\n\n`;
+        // 问题描述
+        md += `## 问题描述\n\n${report.description}\n\n`;
+        // 问题类型
+        md += `## 问题类型\n\n\`${report.problemType}\`\n\n`;
+        if (report.relatedTaskId) {
+            md += `**关联任务**: ${report.relatedTaskId}\n\n`;
+        }
+        // 诊断结果
+        md += `## 诊断结果\n\n`;
+        md += `### 根因\n\n${report.rootCause}\n\n`;
+        if (report.errorInfo) {
+            md += `### 错误信息\n\n`;
+            md += `\`\`\`\n${report.errorInfo.message}\n\`\`\`\n\n`;
+            if (report.errorInfo.stack) {
+                md += `### 错误栈\n\n\`\`\`\n${report.errorInfo.stack}\n\`\`\`\n\n`;
+            }
+        }
+        // 影响范围
+        if (report.impactScope.length > 0) {
+            md += `### 影响范围\n\n`;
+            report.impactScope.forEach((item) => { md += `- ${item}\n`; });
+            md += `\n`;
+        }
+        // 相关文件
+        if (report.relatedFiles && report.relatedFiles.length > 0) {
+            md += `### 相关文件\n\n`;
+            report.relatedFiles.forEach((file) => { md += `- \`${file}\`\n`; });
+            md += `\n`;
+        }
+        // 修复建议
+        md += `## 修复建议\n\n${report.suggestedFix}\n\n`;
+        // 修复操作
+        if (fixResult) {
+            md += `## 修复操作\n\n`;
+            if (fixResult.success) {
+                md += `✅ 修复成功\n\n`;
+            }
+            else {
+                md += `❌ 修复未完全生效\n\n`;
+            }
+            if (fixResult.modifiedFiles.length > 0) {
+                md += `### 修改文件\n\n`;
+                fixResult.modifiedFiles.forEach((file) => { md += `- \`${file}\`\n`; });
+                md += `\n`;
+            }
+            if (fixResult.operations.length > 0) {
+                md += `### 执行操作\n\n`;
+                fixResult.operations.forEach((op) => { md += `- ${op}\n`; });
+                md += `\n`;
+            }
+        }
+        // 验证结果
+        if (verifyResult) {
+            md += `## 验证结果\n\n`;
+            if (verifyResult.passed) {
+                md += `✅ 验证通过\n\n`;
+            }
+            else {
+                md += `❌ 验证未通过\n\n`;
+            }
+            md += `${verifyResult.details}\n\n`;
+        }
+        // 重试信息
+        if (session.retryCount > 0) {
+            md += `## 重试信息\n\n已尝试 ${session.retryCount} 次修复\n\n`;
+            if (session.retryCount >= 3) {
+                md += `⚠️ **已尝试 3 次以上修复，建议暂停并质疑架构**\n\n`;
+            }
+        }
+        return md;
+    }
+    /**
+     * 列出所有诊断报告
+     */
+    listReports() {
+        if (!fs.existsSync(this.debugDir))
+            return [];
+        const files = fs.readdirSync(this.debugDir)
+            .filter(f => f.endsWith('-report.md') || f.includes('-report-'))
+            .sort()
+            .reverse();
+        return files.map(f => ({
+            id: f.split('-')[0],
+            path: path.join(this.debugDir, f),
+            createdAt: f
+        }));
+    }
+    ensureDir() {
+        if (!fs.existsSync(this.debugDir)) {
+            fs.mkdirSync(this.debugDir, { recursive: true });
+        }
+    }
+}
+exports.DebugReporter = DebugReporter;

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/problem-detector.d.ts

@@ -0,0 +1,15 @@
+import type { ProblemType } from '../types/index.js';
+export interface ProblemDetectionConfig {
+    description?: string;
+    taskId?: string;
+    taskError?: string | null;
+}
+/**
+ * 判断问题类型的检测器
+ */
+export declare class ProblemDetector {
+    /**
+     * 根据配置判断问题类型
+     */
+    detect(config: ProblemDetectionConfig): Promise<ProblemType>;
+}

package/dist/orchestrator/problem-detector.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProblemDetector = void 0;
+/**
+ * 判断问题类型的检测器
+ */
+class ProblemDetector {
+    /**
+     * 根据配置判断问题类型
+     */
+    async detect(config) {
+        // 有任务 ID 且任务失败
+        if (config.taskId && config.taskError) {
+            return 'task_failure';
+        }
+        // 根据描述判断
+        if (config.description) {
+            const desc = config.description.toLowerCase();
+            // 环境相关关键词
+            const envKeywords = [
+                '依赖', '安装', '环境', '配置', 'npm install', 'node_modules',
+                'env', 'environment', 'dependency', 'install', 'config',
+                'path', '版本', 'version', '权限', 'permission'
+            ];
+            // 项目代码相关关键词
+            const projectKeywords = [
+                '接口', 'api', '函数', 'function', '返回', 'response',
+                '数据', 'data', '逻辑', 'logic', '页面', 'page',
+                '组件', 'component', '样式', 'style', '渲染', 'render'
+            ];
+            // 系统/OpenMatrix 相关关键词
+            const systemKeywords = [
+                'openmatrix', 'cli', '命令', 'command', '状态', 'state',
+                '任务', 'task', '编排', 'orchestrat', 'agent', '技能', 'skill'
+            ];
+            const hasEnvKeyword = envKeywords.some(kw => desc.includes(kw));
+            const hasProjectKeyword = projectKeywords.some(kw => desc.includes(kw));
+            const hasSystemKeyword = systemKeywords.some(kw => desc.includes(kw));
+            // 优先级：环境 > 项目 > 系统
+            if (hasEnvKeyword)
+                return 'environment';
+            if (hasProjectKeyword)
+                return 'project_bug';
+            if (hasSystemKeyword)
+                return 'system_bug';
+        }
+        // 默认：系统 bug
+        return 'system_bug';
+    }
+}
+exports.ProblemDetector = ProblemDetector;

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',