@thoughtflow/codebase 0.2.0

package/dist/tools/neural/comparative-analysis.tool.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComparativeAnalysisTool = void 0;
+const zod_1 = require("zod");
+const core_1 = require("@thoughtflow/core");
+const ComparativeResultSchema = zod_1.z.object({
+    overallCompliance: zod_1.z.number().min(0).max(1),
+    sections: zod_1.z.array(zod_1.z.object({
+        section: zod_1.z.string(),
+        status: zod_1.z.enum(["compliant", "partial", "non_compliant", "not_applicable"]),
+        details: zod_1.z.string(),
+        evidenceRefs: zod_1.z.array(zod_1.z.string()).optional(),
+    })),
+    discrepancies: zod_1.z.array(zod_1.z.object({
+        section: zod_1.z.string(),
+        expected: zod_1.z.string(),
+        actual: zod_1.z.string(),
+        severity: zod_1.z.enum(["low", "medium", "high", "critical"]),
+        fix: zod_1.z.string(),
+    })),
+    additionalWarnings: zod_1.z.array(zod_1.z.object({
+        title: zod_1.z.string(),
+        description: zod_1.z.string(),
+        severity: zod_1.z.enum(["low", "medium", "high"]),
+        relatedRule: zod_1.z.string().optional(),
+        suggestion: zod_1.z.string(),
+    })),
+    additionalCritical: zod_1.z.array(zod_1.z.object({
+        title: zod_1.z.string(),
+        description: zod_1.z.string(),
+        impact: zod_1.z.string(),
+        blocking: zod_1.z.boolean(),
+        relatedRule: zod_1.z.string().optional(),
+        suggestedFix: zod_1.z.string(),
+    })),
+    summary: zod_1.z.string(),
+});
+class ComparativeAnalysisTool extends core_1.ToolBase {
+    config;
+    name = "comparativeAnalysis";
+    description = "Compare actual state (code, files, screenshots) against expected state (design specs, rules, guidelines). " +
+        "Detects discrepancies, compliance issues, and suggests fixes. " +
+        "Returns structured output with: target (what was checked), additionalWarnings (non-critical issues), " +
+        "additionalCritical (blocking issues), designCompliance (per-section status), diffDesign (expected vs actual). " +
+        "Use this when you need to verify implementation against design specifications or coding rules.";
+    readonly = true;
+    namespace = "neural";
+    tags = ["analysis", "compare", "verify"];
+    constructor(config = {}) {
+        super(zod_1.z.object({
+            actualState: zod_1.z.string().describe("What currently exists — file content, code snippet, or description of current state"),
+            expectedState: zod_1.z.string().describe("What should exist — design spec, rules, acceptance criteria, or expected behavior"),
+            context: zod_1.z.array(zod_1.z.string()).optional().describe("Additional context documents (architecture docs, related files, etc.)"),
+            checkSections: zod_1.z.array(zod_1.z.string()).optional().describe("Specific sections/aspects to compare (e.g. ['colors', 'spacing', 'routing', 'auth'])"),
+            strictMode: zod_1.z.boolean().optional().default(false).describe("If true, flags even minor deviations as warnings"),
+        }));
+        this.config = config;
+    }
+    async run(input, ctx) {
+        const actualState = input["actualState"];
+        const expectedState = input["expectedState"];
+        const context = input["context"];
+        const checkSections = input["checkSections"];
+        const strictMode = input["strictMode"] ?? false;
+        ctx.emitProgress?.("Starting comparative analysis...");
+        const callStructured = ctx.conversation?.callStructured;
+        if (callStructured) {
+            try {
+                ctx.emitProgress?.("Running LLM-powered comparison...");
+                const result = await callStructured(this.buildLLMPrompt(actualState, expectedState, context, checkSections, strictMode), ComparativeResultSchema);
+                ctx.emitProgress?.("Comparison complete", {
+                    compliance: result.overallCompliance,
+                    discrepancies: result.discrepancies.length,
+                    warnings: result.additionalWarnings.length,
+                    criticals: result.additionalCritical.length,
+                });
+                return {
+                    success: true,
+                    output: JSON.stringify(this.formatOutput(result), null, 2),
+                    data: { result },
+                };
+            }
+            catch (err) {
+                ctx.emitProgress?.(`LLM comparison failed: ${String(err)}`);
+            }
+        }
+        // Fallback: keyword-based comparison
+        ctx.emitProgress?.("Running heuristic comparison...");
+        const heuristic = this.heuristicCompare(actualState, expectedState, checkSections, strictMode);
+        return {
+            success: true,
+            output: JSON.stringify(heuristic, null, 2),
+            data: { result: heuristic },
+        };
+    }
+    buildLLMPrompt(actual, expected, context, sections, strictMode) {
+        const t = this.config.truncation ?? {};
+        const actualChars = t.actualMaxChars ?? 3000;
+        const expectedChars = t.expectedMaxChars ?? 3000;
+        const ctxChars = t.contextMaxChars ?? 2000;
+        const parts = [];
+        parts.push(this.config.personaPrompt ??
+            "You are a design compliance auditor. Compare the ACTUAL implementation against the EXPECTED specification.");
+        parts.push(`\n## ACTUAL State (what currently exists)\n${actual.slice(0, actualChars)}`);
+        parts.push(`\n## EXPECTED State (what should exist)\n${expected.slice(0, expectedChars)}`);
+        if (context && context.length > 0) {
+            parts.push(`\n## Additional Context\n${context.join("\n\n").slice(0, ctxChars)}`);
+        }
+        parts.push("\n## Instructions");
+        if (sections && sections.length > 0) {
+            parts.push(`Check these specific sections: ${sections.join(", ")}`);
+        }
+        parts.push(strictMode
+            ? "STRICT MODE: Flag every deviation, even minor spacing/color differences."
+            : "Balanced mode: Focus on functional and design-breaking issues. Minor style deviations are warnings.");
+        parts.push(``);
+        parts.push("Return structured JSON with:");
+        parts.push("- overallCompliance (0-1, where 1 = perfect match)");
+        parts.push("- sections: per-section compliance status");
+        parts.push("- discrepancies: expected vs actual with severity and suggested fix");
+        parts.push("- additionalWarnings: non-critical issues found beyond the immediate scope");
+        parts.push("- additionalCritical: blocking or severe issues");
+        parts.push("- summary: concise human-readable verdict");
+        return parts.join("\n");
+    }
+    heuristicCompare(actual, expected, sections, strictMode) {
+        const discrepancies = [];
+        const warnings = [];
+        const criticals = [];
+        const sectionResults = [];
+        const checkList = sections ?? ["overall"];
+        const actualLower = actual.toLowerCase();
+        const expectedLower = expected.toLowerCase();
+        // Check for common issues
+        for (const section of checkList) {
+            const sectionLower = section.toLowerCase();
+            // Color-related checks
+            if (sectionLower.includes("color") || sectionLower.includes("style") || sectionLower.includes("css")) {
+                const expectedColors = expectedLower.match(/#[0-9a-f]{3,6}|rgb\([^)]+\)|red|blue|green|white|black/g);
+                const actualColors = actualLower.match(/#[0-9a-f]{3,6}|rgb\([^)]+\)|red|blue|green|white|black/g);
+                if (expectedColors && actualColors) {
+                    for (const ec of expectedColors) {
+                        if (!actualColors.includes(ec)) {
+                            discrepancies.push({
+                                section,
+                                expected: `Color should include ${ec}`,
+                                actual: `Color ${ec} not found in implementation`,
+                                severity: strictMode ? "medium" : "low",
+                                fix: `Add color ${ec} as specified`,
+                            });
+                        }
+                    }
+                }
+                sectionResults.push({ section, status: discrepancies.length === 0 ? "compliant" : "partial", details: `${discrepancies.length} color mismatches`, evidenceRefs: [] });
+            }
+            // Navigation/routing checks
+            if (sectionLower.includes("nav") || sectionLower.includes("rout") || sectionLower.includes("link")) {
+                const hasNavActual = /<nav|navigation|navigate|route|link/i.test(actual);
+                if (!hasNavActual) {
+                    discrepancies.push({
+                        section,
+                        expected: `Navigation structure should be present`,
+                        actual: "No navigation pattern detected",
+                        severity: "high",
+                        fix: "Implement navigation as specified",
+                    });
+                }
+                sectionResults.push({ section, status: hasNavActual ? "compliant" : "non_compliant", details: "Navigation check", evidenceRefs: [] });
+            }
+            // Default section
+            // Always run default comparison for sections that aren't specifically handled
+            {
+                // Basic content comparison
+                const expectedKeywords = expectedLower.split(/\s+/).filter((w) => w.length > 3).slice(0, 10);
+                const missingKeywords = expectedKeywords.filter((kw) => !actualLower.includes(kw));
+                if (missingKeywords.length > 3) {
+                    discrepancies.push({
+                        section,
+                        expected: `Should contain: ${missingKeywords.join(", ")}`,
+                        actual: "Keywords not found in implementation",
+                        severity: "medium",
+                        fix: "Ensure implementation includes expected content",
+                    });
+                }
+                sectionResults.push({
+                    section,
+                    status: missingKeywords.length === 0 ? "compliant" : missingKeywords.length <= 3 ? "partial" : "non_compliant",
+                    details: `${missingKeywords.length}/${expectedKeywords.length} keywords missing`,
+                    evidenceRefs: [],
+                });
+            }
+        }
+        // Always check for common cross-cutting concerns
+        const crossChecks = this.config.crossCuttingChecks ?? [
+            { keyword: "test", severity: "medium", title: "Testing not detected in implementation", suggestion: "Add unit and integration tests" },
+            { keyword: "error", severity: "medium", title: "Error handling may be missing", suggestion: "Add error handling and user feedback" },
+        ];
+        for (const check of crossChecks) {
+            if (!actualLower.includes(check.keyword) && expectedLower.includes(check.keyword)) {
+                warnings.push({
+                    sourceNodeId: "",
+                    title: check.title,
+                    description: `Expected specification mentions ${check.keyword}, not detected in implementation`,
+                    severity: check.severity,
+                    suggestion: check.suggestion,
+                });
+            }
+        }
+        const penalty = this.config.scoringWeights?.penaltyPerDiscrepancy ?? 0.15;
+        return {
+            overallCompliance: discrepancies.length === 0 ? 1 : Math.max(0, 1 - discrepancies.length * penalty),
+            sections: sectionResults,
+            discrepancies,
+            additionalWarnings: warnings,
+            additionalCritical: criticals,
+            summary: discrepancies.length === 0
+                ? "Implementation appears compliant with specification"
+                : `${discrepancies.length} discrepancy(s) found, ${warnings.length} warning(s)`,
+        };
+    }
+    formatOutput(result) {
+        return {
+            target: "Comparative analysis between expected and actual state",
+            designCompliance: {
+                overallScore: result.overallCompliance,
+                sections: result.sections,
+                discrepancies: result.discrepancies,
+            },
+            additionalWarnings: result.additionalWarnings,
+            additionalCritical: result.additionalCritical,
+            diffDesign: result.discrepancies.map((d) => ({
+                section: d.section,
+                diff: `Expected: ${d.expected}\nActual: ${d.actual}\nFix: ${d.fix}`,
+                severity: d.severity,
+            })),
+            summary: result.summary,
+        };
+    }
+}
+exports.ComparativeAnalysisTool = ComparativeAnalysisTool;
+//# sourceMappingURL=comparative-analysis.tool.js.map

package/dist/tools/neural/comparative-analysis.tool.js.map

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

package/dist/tools/neural/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./neural-explain.tool";
+export * from "./neural-suggest.tool";
+export * from "./neural-review.tool";
+export * from "./neural-debug.tool";
+export * from "./neural-security.tool";
+export * from "./neural-smells.tool";
+export * from "./neural-deadcode.tool";
+export * from "./neural-similar.tool";
+export * from "./neural-pattern.tool";
+export * from "./neural-optimize.tool";
+export * from "./comparative-analysis.tool";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/neural/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC"}

package/dist/tools/neural/index.js

@@ -0,0 +1,28 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./neural-explain.tool"), exports);
+__exportStar(require("./neural-suggest.tool"), exports);
+__exportStar(require("./neural-review.tool"), exports);
+__exportStar(require("./neural-debug.tool"), exports);
+__exportStar(require("./neural-security.tool"), exports);
+__exportStar(require("./neural-smells.tool"), exports);
+__exportStar(require("./neural-deadcode.tool"), exports);
+__exportStar(require("./neural-similar.tool"), exports);
+__exportStar(require("./neural-pattern.tool"), exports);
+__exportStar(require("./neural-optimize.tool"), exports);
+__exportStar(require("./comparative-analysis.tool"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/neural/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/neural/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AACrC,sDAAoC;AACpC,yDAAuC;AACvC,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,wDAAsC;AACtC,yDAAuC;AACvC,8DAA4C"}

package/dist/tools/neural/neural-deadcode.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase, ToolContext, ToolExecutionResult } from "@thoughtflow/core";
+export declare class NeuralDeadcodeTool extends ToolBase {
+    readonly name = "neuralDeadcode";
+    readonly description = "Detect dead code: unused exports, unreachable functions, unused variables, and orphaned files using dependency graph analysis with LLM-guided false-positive filtering for uncertain cases.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private extractExports;
+}
+//# sourceMappingURL=neural-deadcode.tool.d.ts.map

package/dist/tools/neural/neural-deadcode.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural-deadcode.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/neural-deadcode.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAK/E,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,iMAAiM;IACrN,SAAkB,QAAQ,QAAQ;;IAU5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuEzF,OAAO,CAAC,cAAc;CAcvB"}

package/dist/tools/neural/neural-deadcode.tool.js

@@ -0,0 +1,133 @@
+"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.NeuralDeadcodeTool = void 0;
+const zod_1 = require("zod");
+const core_1 = require("@thoughtflow/core");
+const dependency_extractor_1 = require("../../libs/codebase/graph/dependency-extractor");
+const explorer_1 = require("../../libs/codebase/indexer/explorer");
+const fs = __importStar(require("node:fs"));
+class NeuralDeadcodeTool extends core_1.ToolBase {
+    name = "neuralDeadcode";
+    description = "Detect dead code: unused exports, unreachable functions, unused variables, and orphaned files using dependency graph analysis with LLM-guided false-positive filtering for uncertain cases.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            projectPath: zod_1.z.string().optional(),
+            threshold: zod_1.z.number().optional().describe("Min lines of dead code to report a file"),
+            llmVerify: zod_1.z.boolean().optional().describe("Use LLM to verify uncertain cases"),
+        }));
+    }
+    async run(input, ctx) {
+        const rootPath = input.projectPath ?? process.cwd();
+        const threshold = input.threshold ?? 3;
+        const llmVerify = input.llmVerify ?? false;
+        const explorer = new explorer_1.CodebaseExplorer();
+        const files = explorer.explore({ rootPath });
+        const codeFiles = files.filter((f) => f.classification === "source-code")
+            .map((f) => ({ relativePath: f.relativePath, absolutePath: f.absolutePath }));
+        const depExtractor = new dependency_extractor_1.DependencyExtractor();
+        const graph = await depExtractor.buildGraph(codeFiles, rootPath);
+        const usedFiles = new Set();
+        for (const edge of graph.edges) {
+            usedFiles.add(edge.to);
+        }
+        const deadExports = [];
+        const unreachableFiles = [];
+        for (const file of codeFiles) {
+            const content = fs.readFileSync(file.absolutePath, "utf8");
+            const exports = this.extractExports(content, file.relativePath);
+            const hasIncoming = graph.edges.some((e) => e.to === file.relativePath);
+            const isEntry = file.relativePath.match(/(index|main|app|server|cli)\.ts$/);
+            if (!hasIncoming && !isEntry && file.relativePath.includes("/")) {
+                unreachableFiles.push(file.relativePath);
+            }
+            for (const exp of exports) {
+                let used = false;
+                for (const edge of graph.edges) {
+                    if (edge.symbols?.includes(exp.symbol)) {
+                        used = true;
+                        break;
+                    }
+                }
+                if (!used && !exp.symbol.startsWith("_") && !exp.symbol.startsWith("I")) {
+                    deadExports.push({ ...exp, confidence: "high" });
+                }
+            }
+        }
+        if (llmVerify && unreachableFiles.length > 0 && ctx.conversation) {
+            const prompt = `These files appear to have no imports from other project files. Are any of them entry points, referenced dynamically (e.g., loaded by string path, used in config files, routing tables, or build scripts), or otherwise used indirectly?\n\n${unreachableFiles.slice(0, 10).join("\n")}\n\nReturn: { falsePositives: string[] } listing only files that are genuinely in use.`;
+            try {
+                const result = await ctx.conversation.callStructured(prompt, zod_1.z.object({ falsePositives: zod_1.z.array(zod_1.z.string()) }));
+                const fps = new Set(result.falsePositives ?? []);
+                const filtered = unreachableFiles.filter((f) => !fps.has(f));
+                return {
+                    success: true,
+                    output: JSON.stringify({
+                        summary: { totalFiles: codeFiles.length, deadExports: deadExports.length, unreachableFiles: filtered.length, falsePositivesRemoved: fps.size },
+                        deadExports: deadExports.slice(0, 50),
+                        unreachableFiles: filtered,
+                    }),
+                };
+            }
+            catch {
+            }
+        }
+        return {
+            success: true,
+            output: JSON.stringify({
+                summary: { totalFiles: codeFiles.length, deadExports: deadExports.length, unreachableFiles: unreachableFiles.length },
+                deadExports: deadExports.slice(0, 50),
+                unreachableFiles: unreachableFiles.slice(0, 20),
+            }),
+        };
+    }
+    extractExports(content, filePath) {
+        const exports = [];
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const match = lines[i].match(/(?:export\s+(?:async\s+)?(?:function|class|const|let|var|interface|type|enum)\s+(\w+))|(?:export\s*\{\s*([^}]+)\s*\})/);
+            if (match) {
+                const name = match[1] || match[2];
+                if (name) {
+                    exports.push({ file: filePath, symbol: name, type: "export", line: i + 1 });
+                }
+            }
+        }
+        return exports;
+    }
+}
+exports.NeuralDeadcodeTool = NeuralDeadcodeTool;
+//# sourceMappingURL=neural-deadcode.tool.js.map

package/dist/tools/neural/neural-deadcode.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural-deadcode.tool.js","sourceRoot":"","sources":["../../../src/tools/neural/neural-deadcode.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6BAAwB;AACxB,4CAA+E;AAC/E,yFAAqF;AACrF,mEAAwE;AACxE,4CAA8B;AAE9B,MAAa,kBAAmB,SAAQ,eAAQ;IACrC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,6LAA6L,CAAC;IACnM,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACpF,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SAChF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,GAAgB;QACxD,MAAM,QAAQ,GAAI,KAAK,CAAC,WAAsB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChE,MAAM,SAAS,GAAI,KAAK,CAAC,SAAoB,IAAI,CAAC,CAAC;QACnD,MAAM,SAAS,GAAI,KAAK,CAAC,SAAqB,IAAI,KAAK,CAAC;QAExD,MAAM,QAAQ,GAAG,IAAI,2BAAgB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,aAAa,CAAC;aACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAEhF,MAAM,YAAY,GAAG,IAAI,0CAAmB,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEjE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,WAAW,GAA4F,EAAE,CAAC;QAChH,MAAM,gBAAgB,GAAa,EAAE,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAEhE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC;YACxE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAC5E,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,IAAI,IAAI,GAAG,KAAK,CAAC;gBACjB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC/B,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBAAC,IAAI,GAAG,IAAI,CAAC;wBAAC,MAAM;oBAAC,CAAC;gBACjE,CAAC;gBACD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,SAAS,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACjE,MAAM,MAAM,GAAG,gPAAgP,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,wFAAwF,CAAC;YAEhY,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7D,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;wBACrB,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,CAAC,IAAI,EAAE;wBAC9I,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;wBACrC,gBAAgB,EAAE,QAAQ;qBAC3B,CAAC;iBACH,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;YACT,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;gBACrB,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,EAAE;gBACrH,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACrC,gBAAgB,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aAChD,CAAC;SACH,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,OAAe,EAAE,QAAgB;QACtD,MAAM,OAAO,GAAwE,EAAE,CAAC;QACxF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,uHAAuH,CAAC,CAAC;YACtJ,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAlGD,gDAkGC"}

package/dist/tools/neural/neural-debug.tool.d.ts

@@ -0,0 +1,11 @@
+import { ToolBase, ToolContext, ToolExecutionResult } from "@thoughtflow/core";
+export declare class NeuralDebugTool extends ToolBase {
+    readonly name = "neuralDebug";
+    readonly description = "Analyze a stack trace or error against the codebase to suggest a fix. Parses stack frames, finds relevant source files, extracts context, and uses LLM to propose solutions.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private parseStackTrace;
+    private staticAnalyzeContext;
+}
+//# sourceMappingURL=neural-debug.tool.d.ts.map

package/dist/tools/neural/neural-debug.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural-debug.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/neural-debug.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAiB/E,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,kLAAkL;IACtM,SAAkB,QAAQ,QAAQ;;IAU5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwGzF,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,oBAAoB;CA8B7B"}