@hongmaple0820/med-scale-research-os 0.43.0

package/dist/guardrails/detectors.js

@@ -0,0 +1,332 @@
+// SCALE Engine — 5 种懒惰检测器
+// 设计参考：docs/03-CORE-MODULES.md §3.5
+import { createHash } from 'node:crypto';
+const hashArgs = (args) => createHash('md5').update(JSON.stringify(args)).digest('hex').slice(0, 8);
+// 1. 暴力重试检测
+export class BruteRetryDetector {
+    constructor() {
+        this.name = 'brute-retry';
+        this.windowMs = 3 * 60 * 1000;
+        this.threshold = 3;
+    }
+    async check(input, ctx) {
+        const key = `${input.sessionId}:${input.tool}:${hashArgs(input.args)}`;
+        const history = ctx.cache.get(key) ?? [];
+        const recent = history.filter((t) => Date.now() - t < this.windowMs);
+        recent.push(Date.now());
+        ctx.cache.set(key, recent);
+        if (recent.length >= this.threshold) {
+            ctx.eventBus.emit('behavior.brute_retry', { tool: input.tool, count: recent.length }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: `检测到「暴力重试」：${input.tool} 在 ${this.windowMs / 60000} 分钟内已运行 ${recent.length} 次。请换策略，并说明你这次的新假设是什么。`,
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 2. 工具闲置检测
+export class IdleToolDetector {
+    constructor() {
+        this.name = 'idle-tool';
+    }
+    async check(input, ctx) {
+        if (!['Edit', 'Write', 'MultiEdit'].includes(input.tool))
+            return { triggered: false };
+        const recent = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.failed', 'tool.completed'],
+            limit: 10,
+        });
+        const failureIdx = recent.findIndex((e) => e.type === 'tool.failed');
+        if (failureIdx < 0)
+            return { triggered: false };
+        const after = recent.slice(0, failureIdx);
+        const investigation = ['Read', 'Grep', 'WebSearch', 'Bash'];
+        const hasInv = after.some((e) => investigation.includes(e.payload.tool));
+        if (!hasInv) {
+            ctx.eventBus.emit('behavior.idle_tool', { tool: input.tool }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'warn',
+                reason: '检测到「工具闲置」：上次工具失败后未读任何文件/日志就直接改代码。请先 Read 相关文件或 Bash 看错误日志。',
+                suggestion: 'Read failing test output OR Grep for similar patterns',
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 3. 忙碌假象（来回反复修改同一文件）
+export class BusyLoopDetector {
+    constructor() {
+        this.name = 'busy-loop';
+    }
+    async check(input, ctx) {
+        if (input.tool !== 'Edit')
+            return { triggered: false };
+        const file = input.args.file_path;
+        if (!file)
+            return { triggered: false };
+        const edits = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => {
+                const p = e.payload;
+                return p.tool === 'Edit' && p.args.file_path === file;
+            },
+            limit: 5,
+        });
+        if (edits.length < 4)
+            return { triggered: false };
+        const seen = new Set();
+        let cycle = false;
+        for (const e of edits) {
+            const p = e.payload;
+            const oldH = createHash('md5').update(p.args.old_string ?? '').digest('hex').slice(0, 8);
+            const newH = createHash('md5').update(p.args.new_string ?? '').digest('hex').slice(0, 8);
+            if (seen.has(`${newH}:${oldH}`)) {
+                cycle = true;
+                break;
+            }
+            seen.add(`${oldH}:${newH}`);
+        }
+        if (cycle) {
+            ctx.eventBus.emit('behavior.busy_loop', { file }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: `检测到「忙碌假象」：你在 ${file} 反复来回修改。停下来——这次修改是否产生新信息？没有 = 换思路。`,
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 4. 声称完成但未验证（Harness Engineering 增强）
+// 文章启发："CI 通过但测试 0/0 是无效的"
+export class PrematureDoneDetector {
+    constructor() {
+        this.name = 'premature-done';
+    }
+    async check(input, ctx) {
+        const edits = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => ['Edit', 'Write', 'MultiEdit'].includes(e.payload.tool),
+        });
+        if (edits.length === 0)
+            return { triggered: false };
+        // Harness: 检查验证命令是否运行
+        const verifications = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => {
+                const p = e.payload;
+                return p.tool === 'Bash' && /test|lint|build|typecheck/i.test(p.args.command ?? '');
+            },
+        });
+        // 情况1：完全未验证
+        if (verifications.length === 0) {
+            ctx.eventBus.emit('behavior.premature_done', { reason: 'no_verification' }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: '检测到「声称完成但未验证」：本会话修改了代码，但未运行任何 test/lint/build。请先运行验证命令。',
+                suggestion: 'pnpm test && pnpm lint && pnpm build',
+            };
+        }
+        // 情况2：验证在编辑之前（文章：Premature Victory Declaration）
+        const lastVerify = verifications[0];
+        const lastEdit = edits[0];
+        if (lastVerify.timestamp < lastEdit.timestamp) {
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: '修改了代码但最后一次验证是修改之前运行的。请重新运行验证。',
+            };
+        }
+        // 情况3：Harness 新增 - 检查测试结果是否真正通过
+        // 文章启发：Agent 可能认为 "SUCCESS" 就通过，但实际测试 0/0
+        const testCmd = verifications.find(e => {
+            const p = e.payload;
+            return /test/i.test(p.args.command ?? '');
+        });
+        if (testCmd) {
+            const output = testCmd.payload.output ?? '';
+            // 检测测试 0/0 异常
+            if (/tests?\s*(0|no\s*tests?)/i.test(output) || /passed:\s*0/i.test(output)) {
+                ctx.eventBus.emit('behavior.premature_done', { reason: 'empty_tests' }, { sessionId: input.sessionId });
+                return {
+                    triggered: true,
+                    severity: 'block',
+                    reason: '检测到「测试为空」：运行了测试命令但测试数为 0。请确保测试文件存在且被正确执行。',
+                    suggestion: '检查测试文件是否存在，或添加测试用例',
+                };
+            }
+            // 检测失败测试
+            if (/failed:\s*[1-9]/i.test(output) || /FAIL/i.test(output)) {
+                ctx.eventBus.emit('behavior.premature_done', { reason: 'tests_failed' }, { sessionId: input.sessionId });
+                return {
+                    triggered: true,
+                    severity: 'block',
+                    reason: '检测到「测试失败」：存在失败的测试，不能声称完成。',
+                    suggestion: '修复失败的测试后重新运行',
+                };
+            }
+        }
+        // 情况4：Harness 新增 - 检查编译是否通过
+        const buildCmd = verifications.find(e => {
+            const p = e.payload;
+            return /build|compile|tsc/i.test(p.args.command ?? '');
+        });
+        if (buildCmd) {
+            const exitCode = buildCmd.payload.exitCode ?? 0;
+            if (exitCode !== 0) {
+                ctx.eventBus.emit('behavior.premature_done', { reason: 'build_failed' }, { sessionId: input.sessionId });
+                return {
+                    triggered: true,
+                    severity: 'block',
+                    reason: '检测到「编译失败」：build 命令返回非零退出码。',
+                    suggestion: '修复编译错误后重新构建',
+                };
+            }
+        }
+        return { triggered: false };
+    }
+}
+// 5. 甩锅检测
+export class BlameShiftDetector {
+    constructor() {
+        this.name = 'blame-shift';
+        this.patterns = [
+            /可能是环境问题/i,
+            /建议你?手动/i,
+            /maybe (an?|the) (environment|version|setup)/i,
+            /not sure why/i,
+            /unable to (determine|figure out|resolve)/i,
+        ];
+    }
+    async check(input, ctx) {
+        const text = input.output ?? '';
+        if (!this.patterns.some((p) => p.test(text)))
+            return { triggered: false };
+        const verifications = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => e.payload.tool === 'Bash',
+            limit: 5,
+        });
+        if (verifications.length < 2) {
+            ctx.eventBus.emit('behavior.blame_shift', { sessionId: input.sessionId }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'warn',
+                reason: '检测到「甩锅」迹象：你说"可能是环境问题"但未做足够验证。至少：\n1. 验证版本 2. 验证依赖 3. 重现问题。\n证据齐了再下结论。',
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 6. 被动等待检测（Stop Hook专用）
+// 修完表面问题就停，未泛化检查
+export class PassiveWaitDetector {
+    constructor() {
+        this.name = 'passive-wait';
+    }
+    async check(input, ctx) {
+        // 检查是否有修改操作
+        const edits = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => ['Edit', 'Write', 'MultiEdit'].includes(e.payload.tool),
+        });
+        if (edits.length === 0)
+            return { triggered: false };
+        // 检查是否有泛化检查行为
+        // 泛化检查包括：搜索同类问题、检查上下游、添加检查规则
+        const generalizationPatterns = [
+            /同类|similar|same pattern/i,
+            /上下游|upstream|downstream/i,
+            /检查.*规则|rule|hook/i,
+            /泛化|generalize/i,
+        ];
+        // 检查 Read/Grep/Bash 是否包含泛化关键词
+        const reads = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => ['Read', 'Grep', 'Bash'].includes(e.payload.tool),
+            limit: 20,
+        });
+        const hasGeneralization = reads.some(e => {
+            const p = e.payload;
+            const content = `${p.args?.pattern ?? ''} ${p.args?.command ?? ''} ${p.args?.file_path ?? ''}`;
+            return generalizationPatterns.some(pat => pat.test(content));
+        });
+        if (!hasGeneralization) {
+            ctx.eventBus.emit('behavior.passive_wait', { edits: edits.length }, { sessionId: input.sessionId });
+            return {
+                triggered: true,
+                severity: 'block',
+                reason: '检测到「被动等待」：修完问题后未做泛化检查。\n必须检查：\n1. 同模块有无同类问题\n2. 上下游是否受影响\n3. 能否添加检查防止复发',
+                suggestion: 'Grep 类似模式 OR Read 相关模块 OR 添加检测规则',
+            };
+        }
+        return { triggered: false };
+    }
+}
+// 7. 同文件连续修改检测（忙碌假象增强版）
+// 连续修改同一文件 >= 3次且无新信息
+export class SameFileEditDetector {
+    constructor() {
+        this.name = 'same-file-edit';
+        this.threshold = 3;
+    }
+    async check(input, ctx) {
+        if (input.tool !== 'Edit')
+            return { triggered: false };
+        const file = input.args.file_path;
+        if (!file)
+            return { triggered: false };
+        // 获取最近对该文件的编辑
+        const edits = await ctx.eventBus.query({
+            sessionId: input.sessionId,
+            types: ['tool.completed'],
+            filter: (e) => {
+                const p = e.payload;
+                return p.tool === 'Edit' && p.args.file_path === file;
+            },
+            limit: 10,
+        });
+        // 连续修改同一文件 >= 3次
+        if (edits.length >= this.threshold) {
+            // 检查是否有中间穿插其他操作（表示有新信息）
+            const allOps = await ctx.eventBus.query({
+                sessionId: input.sessionId,
+                types: ['tool.completed'],
+                limit: 15,
+            });
+            // 找出该文件编辑的时间窗口
+            const editTimestamps = edits.map(e => e.timestamp).sort((a, b) => b - a);
+            const startWindow = editTimestamps[editTimestamps.length - 1];
+            const endWindow = editTimestamps[0];
+            // 检查时间窗口内是否有 Read/Grep（表示有新信息输入）
+            const hasNewInfo = allOps.some(e => {
+                if (e.timestamp < startWindow || e.timestamp > endWindow)
+                    return false;
+                const p = e.payload;
+                return ['Read', 'Grep', 'WebSearch', 'WebFetch'].includes(p.tool);
+            });
+            if (!hasNewInfo) {
+                ctx.eventBus.emit('behavior.same_file_edit', { file, count: edits.length }, { sessionId: input.sessionId });
+                return {
+                    triggered: true,
+                    severity: 'block',
+                    reason: `检测到「同文件连续修改」：${file} 已修改 ${edits.length} 次且无新信息输入。\n停下来问自己：这次修改是否产生新信息？没有 = 换思路。`,
+                    suggestion: 'Read 相关文件 OR Grep 类似模式 OR /clear 清空上下文',
+                };
+            }
+        }
+        return { triggered: false };
+    }
+}
+//# sourceMappingURL=detectors.js.map

package/dist/guardrails/detectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.js","sourceRoot":"","sources":["../../src/guardrails/detectors.ts"],"names":[],"mappings":"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"}

package/dist/guardrails/roles.d.ts

@@ -0,0 +1,4 @@
+import type { RoleDefinition } from '../artifact/types.js';
+export declare const ROLES: Record<string, RoleDefinition>;
+export declare function getRole(name: string): RoleDefinition | undefined;
+export declare function listRoles(): string[];

package/dist/guardrails/roles.js

@@ -0,0 +1,54 @@
+// SCALE Engine — Role 定义
+// 设计参考：docs/03-CORE-MODULES.md §3.5 "Role 权限网关"
+export const ROLES = {
+    Explorer: {
+        name: 'Explorer',
+        canCreateArtifacts: ['Insight'],
+        canReadArtifacts: ['Need', 'Spec', 'Insight'],
+        allowedTools: ['Read', 'Grep', 'Glob', 'WebSearch', 'WebFetch'],
+        deniedTools: ['Edit', 'Write', 'Bash'],
+        requiresUpstream: [],
+    },
+    SpecWriter: {
+        name: 'SpecWriter',
+        canCreateArtifacts: ['Spec'],
+        canModifyArtifacts: [{ type: 'Spec', statuses: ['DRAFT', 'REVIEWING'] }],
+        allowedTools: ['Read', 'Write', 'WebSearch'],
+        requiresUpstream: [{ type: 'Need' }],
+    },
+    Planner: {
+        name: 'Planner',
+        canCreateArtifacts: ['Plan', 'TestPlan', 'Task'],
+        allowedTools: ['Read', 'Grep', 'WebSearch', 'Write'],
+        requiresUpstream: [{ type: 'Spec', status: 'FROZEN' }],
+    },
+    Implementer: {
+        name: 'Implementer',
+        canCreateArtifacts: ['Change'],
+        allowedTools: ['Read', 'Grep', 'Glob', 'Edit', 'Write', 'Bash', 'MultiEdit'],
+        requiresUpstream: [{ type: 'Task', status: 'READY' }],
+        mustRunAfterEdit: ['lint', 'typecheck'],
+    },
+    Verifier: {
+        name: 'Verifier',
+        canCreateArtifacts: ['Evidence', 'Defect'],
+        allowedTools: ['Read', 'Bash', 'Grep'],
+        deniedTools: ['Edit', 'Write'],
+    },
+    Releaser: {
+        name: 'Releaser',
+        canCreateArtifacts: ['Release'],
+        allowedTools: ['Read', 'Bash'],
+        requiresUpstream: [
+            { type: 'Defect', allMatch: 'CLOSED' },
+            { type: 'Evidence', allMatch: 'PASS' },
+        ],
+    },
+};
+export function getRole(name) {
+    return ROLES[name];
+}
+export function listRoles() {
+    return Object.keys(ROLES);
+}
+//# sourceMappingURL=roles.js.map

package/dist/guardrails/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/guardrails/roles.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,gDAAgD;AAIhD,MAAM,CAAC,MAAM,KAAK,GAAmC;IACnD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC,SAAS,CAAC;QAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;QAC7C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC;QAC/D,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACtC,gBAAgB,EAAE,EAAE;KACrB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,kBAAkB,EAAE,CAAC,MAAM,CAAC;QAC5B,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;QACxE,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;QAC5C,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACrC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC;QAChD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC;QACpD,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;KACvD;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,kBAAkB,EAAE,CAAC,QAAQ,CAAC;QAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC;QAC5E,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACrD,gBAAgB,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;KACxC;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC1C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QACtC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC/B;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,kBAAkB,EAAE,CAAC,SAAS,CAAC;QAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE;YAChB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;YACtC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;SACvC;KACF;CACF,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC"}

package/dist/hooks/BugPatternDetector.d.ts

@@ -0,0 +1,36 @@
+export type FixPattern = 'error-handling' | 'null-safety' | 'guard-clause' | 'wrong-value' | 'wrong-reference' | 'logic-fix' | 'operator-fix' | 'missing-import' | 'async-fix' | 'type-fix' | 'return-value' | 'refactor';
+export interface BugDetection {
+    pattern: FixPattern;
+    confidence: number;
+    summary: string;
+    file: string;
+    oldSnippet: string;
+    newSnippet: string;
+    detectedAt: string;
+}
+export interface BugRecord {
+    id: string;
+    timestamp: string;
+    file: string;
+    pattern: FixPattern;
+    summary: string;
+    oldSnippet: string;
+    newSnippet: string;
+    occurrences: number;
+}
+export declare class BugPatternDetector {
+    detect(oldString: string, newString: string, filePath: string): BugDetection | null;
+    private checkErrorHandling;
+    private checkNullSafety;
+    private checkGuardClause;
+    private checkMissingImport;
+    private checkAsyncFix;
+    private checkTypeFix;
+    private checkOperatorFix;
+    private checkLogicFix;
+    private checkReturnValue;
+    private checkWrongValue;
+    private checkWrongReference;
+    private checkRefactor;
+    private summarize;
+}

package/dist/hooks/BugPatternDetector.js

@@ -0,0 +1,207 @@
+// SCALE Engine — Bug Pattern Detector
+// Analyzes Edit operations to auto-detect bug fix patterns.
+// Inspired by OpenWolf's detectFixPattern().
+export class BugPatternDetector {
+    detect(oldString, newString, filePath) {
+        if (!oldString || !newString)
+            return null;
+        if (oldString === newString)
+            return null;
+        // Order matters: more specific patterns first. On tie, first match wins.
+        const patterns = [
+            { pattern: 'missing-import', check: () => this.checkMissingImport(oldString, newString) },
+            { pattern: 'error-handling', check: () => this.checkErrorHandling(oldString, newString) },
+            { pattern: 'async-fix', check: () => this.checkAsyncFix(oldString, newString) },
+            { pattern: 'operator-fix', check: () => this.checkOperatorFix(oldString, newString) },
+            { pattern: 'null-safety', check: () => this.checkNullSafety(oldString, newString) },
+            { pattern: 'guard-clause', check: () => this.checkGuardClause(oldString, newString) },
+            { pattern: 'type-fix', check: () => this.checkTypeFix(oldString, newString, filePath) },
+            { pattern: 'logic-fix', check: () => this.checkLogicFix(oldString, newString) },
+            { pattern: 'return-value', check: () => this.checkReturnValue(oldString, newString) },
+            { pattern: 'wrong-value', check: () => this.checkWrongValue(oldString, newString) },
+            { pattern: 'refactor', check: () => this.checkRefactor(oldString, newString) },
+            // wrong-reference is the most generic — checked last
+            { pattern: 'wrong-reference', check: () => this.checkWrongReference(oldString, newString) },
+        ];
+        let best = null;
+        for (const p of patterns) {
+            const confidence = p.check();
+            if (confidence > 0 && (!best || confidence > best.confidence)) {
+                best = { pattern: p.pattern, confidence };
+            }
+        }
+        if (!best || best.confidence < 0.3)
+            return null;
+        return {
+            pattern: best.pattern,
+            confidence: best.confidence,
+            summary: this.summarize(best.pattern, oldString, newString),
+            file: filePath,
+            oldSnippet: oldString.slice(0, 200),
+            newSnippet: newString.slice(0, 200),
+            detectedAt: new Date().toISOString(),
+        };
+    }
+    checkErrorHandling(oldStr, newStr) {
+        const oldHasCatch = /catch\s*\(/.test(oldStr) || /try\s*\{/.test(oldStr);
+        const newHasCatch = /catch\s*\(/.test(newStr) || /try\s*\{/.test(newStr);
+        if (!oldHasCatch && newHasCatch)
+            return 0.9;
+        const oldHasThrow = /throw\s+/.test(oldStr);
+        const newHasThrow = /throw\s+/.test(newStr);
+        if (!oldHasThrow && newHasThrow)
+            return 0.8;
+        return 0;
+    }
+    checkNullSafety(oldStr, newStr) {
+        const newHasOptional = /\?\./.test(newStr) && !/\?\./.test(oldStr);
+        if (newHasOptional)
+            return 0.9;
+        const newHasNullish = /\?\?/.test(newStr) && !/\?\?/.test(oldStr);
+        if (newHasNullish)
+            return 0.8;
+        const newHasNullCheck = (/!=\s*null/.test(newStr) || /!==\s*null/.test(newStr) || /!==\s*undefined/.test(newStr)) &&
+            !(/!=\s*null/.test(oldStr) || /!==\s*null/.test(oldStr));
+        if (newHasNullCheck)
+            return 0.7;
+        return 0;
+    }
+    checkGuardClause(oldStr, newStr) {
+        // Guard clauses check for null/undefined/empty/invalid at function start
+        const guardPattern = /if\s*\(\s*(!?\w+|!?\w+[\?\.\[][^)]*)\s*\)\s*(return|throw)\s+/;
+        const newHasGuard = guardPattern.test(newStr) && !guardPattern.test(oldStr);
+        if (newHasGuard) {
+            // Higher confidence if checking null/undefined/empty
+            const isNullCheck = /null|undefined|empty|!/.test(newStr.match(guardPattern)?.[1] || '');
+            return isNullCheck ? 0.8 : 0.65;
+        }
+        return 0;
+    }
+    checkMissingImport(oldStr, newStr) {
+        const oldImports = (oldStr.match(/^import\s+/gm) || []).length;
+        const newImports = (newStr.match(/^import\s+/gm) || []).length;
+        if (newImports > oldImports)
+            return 0.85;
+        const newHasRequire = /require\s*\(/.test(newStr) && !/require\s*\(/.test(oldStr);
+        if (newHasRequire)
+            return 0.7;
+        return 0;
+    }
+    checkAsyncFix(oldStr, newStr) {
+        const addedAwait = /\bawait\b/.test(newStr) && !/\bawait\b/.test(oldStr);
+        if (addedAwait)
+            return 0.85;
+        const addedAsync = /\basync\b/.test(newStr) && !/\basync\b/.test(oldStr);
+        if (addedAsync)
+            return 0.7;
+        return 0;
+    }
+    checkTypeFix(oldStr, newStr, filePath) {
+        if (!/\.(ts|tsx)$/.test(filePath))
+            return 0;
+        const newHasType = /:\s*(string|number|boolean|any|unknown|never|void|Record|Partial|Required|Pick|Omit|Promise|Array)\b/.test(newStr) &&
+            !(/:\s*(string|number|boolean|any|unknown|never|void|Record|Partial|Required|Pick|Omit|Promise|Array)\b/.test(oldStr));
+        if (newHasType)
+            return 0.8;
+        const removedAny = /:\s*any\b/.test(oldStr) && !/:\s*any\b/.test(newStr);
+        if (removedAny)
+            return 0.85;
+        return 0;
+    }
+    checkOperatorFix(oldStr, newStr) {
+        const ops = [
+            ['===', '=='], ['!==', '!='], ['>=', '>'], ['<=', '<'],
+        ];
+        for (const [strict, loose] of ops) {
+            if (oldStr.includes(loose) && newStr.includes(strict) && !oldStr.includes(strict))
+                return 0.9;
+            if (oldStr.includes(strict) && newStr.includes(loose) && !oldStr.includes(loose))
+                return 0.6;
+        }
+        return 0;
+    }
+    checkLogicFix(oldStr, newStr) {
+        const oldHasCondition = /if\s*\(|&&|\|\||switch\s*\(/.test(oldStr);
+        const newHasCondition = /if\s*\(|&&|\|\||switch\s*\(/.test(newStr);
+        if (oldHasCondition && newHasCondition) {
+            const oldLines = oldStr.split('\n').filter(l => l.trim());
+            const newLines = newStr.split('\n').filter(l => l.trim());
+            if (oldLines.length <= 3 && newLines.length <= 3 && oldStr !== newStr)
+                return 0.6;
+        }
+        const flippedAndOr = (oldStr.includes('&&') && newStr.includes('||')) ||
+            (oldStr.includes('||') && newStr.includes('&&'));
+        if (flippedAndOr)
+            return 0.7;
+        const negated = (oldStr.includes('!') && !newStr.includes('!')) ||
+            (!oldStr.includes('!') && newStr.includes('!'));
+        if (negated && oldStr.replace(/!/g, '') === newStr.replace(/!/g, ''))
+            return 0.85;
+        return 0;
+    }
+    checkReturnValue(oldStr, newStr) {
+        const oldReturn = oldStr.match(/return\s+(.+)/)?.[1]?.trim();
+        const newReturn = newStr.match(/return\s+(.+)/)?.[1]?.trim();
+        if (oldReturn && newReturn && oldReturn !== newReturn) {
+            if (oldStr.split('\n').length <= 3 && newStr.split('\n').length <= 3)
+                return 0.7;
+        }
+        return 0;
+    }
+    checkWrongValue(oldStr, newStr) {
+        const oldLines = oldStr.split('\n').filter(l => l.trim());
+        const newLines = newStr.split('\n').filter(l => l.trim());
+        if (oldLines.length === 1 && newLines.length === 1 && oldStr !== newStr) {
+            const oldStrings = oldStr.match(/["'`][^"'`]+["'`]/g) || [];
+            const newStrings = newStr.match(/["'`][^"'`]+["'`]/g) || [];
+            if (oldStrings.length > 0 && newStrings.length > 0 && oldStrings[0] !== newStrings[0])
+                return 0.75;
+            const oldNums = oldStr.match(/\b\d+\b/g) || [];
+            const newNums = newStr.match(/\b\d+\b/g) || [];
+            if (oldNums.length > 0 && newNums.length > 0 && oldNums[0] !== newNums[0])
+                return 0.75;
+        }
+        return 0;
+    }
+    checkWrongReference(oldStr, newStr) {
+        const oldLines = oldStr.split('\n').filter(l => l.trim());
+        const newLines = newStr.split('\n').filter(l => l.trim());
+        if (oldLines.length === 1 && newLines.length === 1 && oldStr !== newStr) {
+            const oldIdents = oldStr.match(/\b[a-zA-Z_]\w*\b/g) ?? [];
+            const newIdents = newStr.match(/\b[a-zA-Z_]\w*\b/g) ?? [];
+            const diff = oldIdents.filter(i => !newIdents.includes(i));
+            const added = newIdents.filter(i => !oldIdents.includes(i));
+            if (diff.length === 1 && added.length === 1)
+                return 0.65;
+        }
+        return 0;
+    }
+    checkRefactor(oldStr, newStr) {
+        const oldLen = oldStr.length;
+        const newLen = newStr.length;
+        if (oldLen < 30 || newLen < 30)
+            return 0;
+        const ratio = Math.min(oldLen, newLen) / Math.max(oldLen, newLen);
+        if (ratio < 0.6)
+            return 0.7;
+        return 0;
+    }
+    summarize(pattern, oldStr, newStr) {
+        switch (pattern) {
+            case 'error-handling': return 'Added error handling (try/catch or throw)';
+            case 'null-safety': return 'Added null/undefined safety checks';
+            case 'guard-clause': return 'Added guard clause for early return/throw';
+            case 'missing-import': return 'Added missing import/require';
+            case 'async-fix': return 'Added async/await';
+            case 'type-fix': return 'Improved TypeScript type annotations';
+            case 'operator-fix': return 'Fixed comparison operator';
+            case 'logic-fix': return 'Fixed logic condition';
+            case 'return-value': return 'Changed return value';
+            case 'wrong-value': return 'Fixed incorrect value';
+            case 'wrong-reference': return 'Fixed incorrect identifier reference';
+            case 'refactor': return 'Major refactor (>30% diff)';
+            default: return 'Code fix detected';
+        }
+    }
+}
+//# sourceMappingURL=BugPatternDetector.js.map