@thoughtflow/codebase 0.2.0

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

@@ -0,0 +1,205 @@
+"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.NeuralDebugTool = 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"));
+const path = __importStar(require("node:path"));
+const DebugResultSchema = zod_1.z.object({
+    errorType: zod_1.z.string(),
+    rootCause: zod_1.z.string(),
+    suggestedFix: zod_1.z.string(),
+    codeFixExample: zod_1.z.string().optional(),
+    affectedFiles: zod_1.z.array(zod_1.z.string()),
+    confidence: zod_1.z.enum(["high", "medium", "low"]),
+});
+class NeuralDebugTool extends core_1.ToolBase {
+    name = "neuralDebug";
+    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 = true;
+    constructor() {
+        super(zod_1.z.object({
+            error: zod_1.z.string().describe("Stack trace or error message"),
+            projectPath: zod_1.z.string().optional(),
+            maxFrames: zod_1.z.number().optional().describe("Max stack frames to analyze"),
+        }));
+    }
+    async run(input, ctx) {
+        const { error, maxFrames } = input;
+        const rootPath = input.projectPath ?? process.cwd();
+        const max = maxFrames ?? 5;
+        const frames = this.parseStackTrace(error, rootPath);
+        const relevantFrames = frames.slice(0, max);
+        const analysis = [];
+        for (const frame of relevantFrames) {
+            const absolutePath = path.join(rootPath, frame.file);
+            if (!fs.existsSync(absolutePath))
+                continue;
+            const content = fs.readFileSync(absolutePath, "utf8");
+            const lines = content.split("\n");
+            const start = Math.max(0, frame.line - 10);
+            const end = Math.min(lines.length, frame.line + 10);
+            const context = lines.slice(start, end)
+                .map((l, i) => `${start + i + 1}: ${l}`)
+                .join("\n");
+            const suggestions = this.staticAnalyzeContext(lines, frame.line, frame.message);
+            analysis.push({ file: frame.file, line: frame.line, column: frame.column, context, suggestions });
+        }
+        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 affectedFiles = new Set();
+        for (const frame of relevantFrames) {
+            affectedFiles.add(frame.file);
+            const dependents = graph.edges.filter((e) => e.to === frame.file);
+            for (const dep of dependents.slice(0, 5)) {
+                affectedFiles.add(dep.from);
+            }
+        }
+        const callStructured = ctx.conversation?.callStructured;
+        if (!callStructured) {
+            return {
+                success: true,
+                output: JSON.stringify({
+                    error: error.split("\n")[0],
+                    framesAnalyzed: analysis.length,
+                    totalFrames: frames.length,
+                    affectedFiles: Array.from(affectedFiles).slice(0, 15),
+                    analysis,
+                    llmUsed: false,
+                }),
+            };
+        }
+        const codeContext = analysis
+            .map((a) => `=== ${a.file}:${a.line} ===\n${a.context}`)
+            .join("\n\n")
+            .slice(0, 8000);
+        const prompt = `You are an expert software debugger. Analyze the stack trace and source code context, then provide a structured root cause analysis, a concrete suggested fix with code example, and list of affected files.
+
+ERROR:
+${error}
+
+RELEVANT SOURCE CODE:
+${codeContext}
+
+STATIC ANALYSIS HINTS:
+${analysis.map((a) => `- ${a.file}:${a.line}: ${a.suggestions.join("; ")}`).join("\n")}`;
+        try {
+            const result = await callStructured(prompt, DebugResultSchema);
+            return {
+                success: true,
+                output: JSON.stringify({
+                    ...result,
+                    stackFrames: frames.length,
+                    relevantFiles: relevantFrames.map((f) => f.file),
+                    affectedFiles: Array.from(affectedFiles).slice(0, 15),
+                    filesAnalyzed: analysis.length,
+                    llmUsed: true,
+                }),
+            };
+        }
+        catch {
+            return {
+                success: true,
+                output: JSON.stringify({
+                    error: error.split("\n")[0],
+                    stackFrames: frames.length,
+                    relevantFiles: relevantFrames.map((f) => f.file),
+                    affectedFiles: Array.from(affectedFiles).slice(0, 15),
+                    analysis,
+                    llmUsed: false,
+                }),
+            };
+        }
+    }
+    parseStackTrace(error, rootPath) {
+        const frames = [];
+        const lines = error.split("\n");
+        const message = lines[0];
+        const patterns = [
+            /at\s+(?:async\s+)?(?:\S+\s+)?\(?(.+?):(\d+):(\d+)\)?/g,
+            /at\s+(.+?):(\d+):(\d+)/g,
+        ];
+        for (const line of lines) {
+            for (const pattern of patterns) {
+                pattern.lastIndex = 0;
+                let match;
+                while ((match = pattern.exec(line)) !== null) {
+                    const file = match[1].replace(/^file:\/\//, "");
+                    const lineNum = parseInt(match[2], 10);
+                    const col = match[3] ? parseInt(match[3], 10) : undefined;
+                    if (file.includes("node_modules") || file.includes("node:"))
+                        continue;
+                    const relative = file.startsWith(rootPath)
+                        ? path.relative(rootPath, file)
+                        : file;
+                    frames.push({ file: relative, line: lineNum, column: col, message });
+                }
+            }
+        }
+        return frames;
+    }
+    staticAnalyzeContext(lines, lineNum, errorMsg) {
+        const suggestions = [];
+        const targetLine = lines[lineNum - 1] ?? "";
+        if (targetLine.trim().startsWith("//") || targetLine.trim().startsWith("/*")) {
+            suggestions.push("Error on a comment line — check preceding/succeeding code");
+        }
+        if (targetLine.includes("undefined") || targetLine.includes("null")) {
+            suggestions.push("Possible null/undefined access — add null check or optional chaining");
+        }
+        if (targetLine.includes(".map(") || targetLine.includes(".filter(") || targetLine.includes(".find(")) {
+            suggestions.push("Array method may be called on undefined — ensure array is initialized");
+        }
+        if (targetLine.includes("await")) {
+            suggestions.push("Async operation — verify error handling with try/catch or .catch()");
+        }
+        if (targetLine.includes("import")) {
+            suggestions.push("Import resolution error — check file path, extension, and module existence");
+        }
+        if (suggestions.length === 0) {
+            suggestions.push("Review the surrounding context for variable initialization and error handling");
+        }
+        return suggestions;
+    }
+}
+exports.NeuralDebugTool = NeuralDebugTool;
+//# sourceMappingURL=neural-debug.tool.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { ToolBase, ToolContext, ToolExecutionResult } from "@thoughtflow/core";
+export declare class NeuralExplainTool extends ToolBase {
+    readonly name = "neuralExplain";
+    readonly description = "Explain any code snippet, function, or file in natural language. Uses LLM to provide clear, educational explanations of what the code does, its purpose, and how it works.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=neural-explain.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neural-explain.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/neural-explain.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI/E,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,gLAAgL;IACpM,SAAkB,QAAQ,QAAQ;;IAU5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAgD1F"}

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

@@ -0,0 +1,100 @@
+"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.NeuralExplainTool = void 0;
+const zod_1 = require("zod");
+const core_1 = require("@thoughtflow/core");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class NeuralExplainTool extends core_1.ToolBase {
+    name = "neuralExplain";
+    description = "Explain any code snippet, function, or file in natural language. Uses LLM to provide clear, educational explanations of what the code does, its purpose, and how it works.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            target: zod_1.z.string().describe("File path, function name, or code snippet to explain"),
+            detail: zod_1.z.enum(["brief", "detailed", "tutorial"]).optional().describe("Level of detail (default: detailed)"),
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, ctx) {
+        const { target, detail } = input;
+        const rootPath = input.projectPath ?? process.cwd();
+        const level = detail ?? "detailed";
+        let codeToExplain = target;
+        const fullPath = path.join(rootPath, target);
+        try {
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
+                codeToExplain = fs.readFileSync(fullPath, "utf8").slice(0, 8000);
+            }
+        }
+        catch {
+            /* use target as-is */
+        }
+        const callStructured = ctx.conversation?.callStructured;
+        if (!callStructured) {
+            return {
+                success: true,
+                output: JSON.stringify({
+                    explanation: "LLM not available — raw code provided for manual review",
+                    code: codeToExplain.slice(0, 500),
+                    level,
+                }),
+            };
+        }
+        const prompt = level === "brief"
+            ? `Explain this code in 1-2 sentences:\n\n\`\`\`\n${codeToExplain}\n\`\`\``
+            : level === "tutorial"
+                ? `Explain this code as a step-by-step tutorial for beginners. Cover what it does, why each part exists, and how each piece works together:\n\n\`\`\`\n${codeToExplain}\n\`\`\``
+                : `Explain this code in detail — what it does, its purpose, key design decisions, and how it fits into the larger system. Cover the logic flow, data transformations, and any notable patterns:\n\n\`\`\`\n${codeToExplain}\n\`\`\``;
+        try {
+            const result = await callStructured(prompt, zod_1.z.object({ explanation: zod_1.z.string() }));
+            const data = result;
+            return { success: true, output: data.explanation ?? "No explanation generated" };
+        }
+        catch (err) {
+            return {
+                success: true,
+                output: JSON.stringify({
+                    explanation: `Failed to generate explanation: ${err instanceof Error ? err.message : "Unknown error"}`,
+                    code: codeToExplain.slice(0, 500),
+                    level,
+                }),
+            };
+        }
+    }
+}
+exports.NeuralExplainTool = NeuralExplainTool;
+//# sourceMappingURL=neural-explain.tool.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { ToolBase, ToolContext, ToolExecutionResult } from "@thoughtflow/core";
+export declare class NeuralOptimizeTool extends ToolBase {
+    readonly name = "neuralOptimize";
+    readonly description = "AI-powered performance optimization. Combines static pattern detection (N+1 queries, sync-in-async, missing memoization) with LLM semantic analysis of hot-path inefficiencies. Provides concrete fix suggestions with estimated impact.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=neural-optimize.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neural-optimize.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/neural-optimize.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAa/E,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,8OAA8O;IAClQ,SAAkB,QAAQ,QAAQ;;IAS5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAkE1F"}

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

@@ -0,0 +1,117 @@
+"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.NeuralOptimizeTool = void 0;
+const zod_1 = require("zod");
+const core_1 = require("@thoughtflow/core");
+const explorer_1 = require("../../libs/codebase/indexer/explorer");
+const fs = __importStar(require("node:fs"));
+const OptimizeSuggestionSchema = zod_1.z.object({
+    category: zod_1.z.string(),
+    severity: zod_1.z.enum(["high", "medium", "low"]),
+    message: zod_1.z.string(),
+    fix: zod_1.z.string(),
+    estimatedImpact: zod_1.z.string(),
+});
+class NeuralOptimizeTool extends core_1.ToolBase {
+    name = "neuralOptimize";
+    description = "AI-powered performance optimization. Combines static pattern detection (N+1 queries, sync-in-async, missing memoization) with LLM semantic analysis of hot-path inefficiencies. Provides concrete fix suggestions with estimated impact.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            target: zod_1.z.string().optional().describe("File path or leave empty for worst offenders"),
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, ctx) {
+        const rootPath = input.projectPath ?? process.cwd();
+        const target = input.target || undefined;
+        const explorer = new explorer_1.CodebaseExplorer();
+        const files = explorer.explore({ rootPath });
+        const scanFiles = target
+            ? files.filter((f) => f.relativePath.includes(target)).slice(0, 5)
+            : files.filter((f) => f.classification === "source-code").slice(0, 20);
+        const staticIssues = [];
+        for (const file of scanFiles) {
+            const content = fs.readFileSync(file.absolutePath, "utf8");
+            const lines = content.split("\n");
+            for (let i = 0; i < lines.length; i++) {
+                const surrounding = lines.slice(Math.max(0, i - 3), i + 3).join("\n");
+                if (lines[i].match(/\.findMany|\.findFirst|\.findUnique|\.query|\.execute/) && surrounding.match(/for\s*\(|forEach|\.map\s*\(/)) {
+                    staticIssues.push({ category: "n+1", severity: "high", file: file.relativePath, line: i + 1, message: "Database query inside loop — potential N+1 problem", fix: "Use batch query, eager loading (include), or DataLoader", estimatedImpact: "Can reduce DB calls from N to 1" });
+                }
+                if (lines[i].includes("await") && surrounding.match(/for\s*\(.*of/) && lines[i].match(/await\s+\w+/)) {
+                    staticIssues.push({ category: "sequential-async", severity: "medium", file: file.relativePath, line: i + 1, message: "Sequential awaits in loop — can parallelize", fix: "Use Promise.all() for independent async operations", estimatedImpact: "Can reduce total time by factor of N" });
+                }
+            }
+            if (content.match(/\.filter|\.sort|\.reduce/) && !content.includes("useMemo") && !content.includes("useCallback") && (file.relativePath.endsWith(".tsx") || file.relativePath.endsWith(".jsx"))) {
+                staticIssues.push({ category: "missing-memo", severity: "medium", file: file.relativePath, message: "Expensive computation in render without memoization", fix: "Wrap in useMemo/useCallback", estimatedImpact: "Can prevent unnecessary re-renders" });
+            }
+        }
+        const cs = ctx.conversation?.callStructured;
+        if (!cs) {
+            return { success: true, output: JSON.stringify({ filesScanned: scanFiles.length, issuesFound: staticIssues.length, issues: staticIssues }) };
+        }
+        const codeSnippets = scanFiles.filter((f) => {
+            const c = fs.readFileSync(f.absolutePath, "utf8");
+            return c.includes("await") || c.includes(".find") || c.includes(".map") || c.includes("for");
+        }).slice(0, 3).map((f) => {
+            const c = fs.readFileSync(f.absolutePath, "utf8").slice(0, 3000);
+            return `--- ${f.relativePath} ---\n${c}`;
+        }).join("\n\n");
+        if (!codeSnippets) {
+            return { success: true, output: JSON.stringify({ filesScanned: scanFiles.length, issuesFound: staticIssues.length, issues: staticIssues }) };
+        }
+        const prompt = `Analyze this code for performance optimization opportunities: N+1 queries, missing caching/memoization, unnecessary re-renders, expensive operations in hot paths, sync operations in async contexts, large dependency imports, unnecessary closures, unbatched state updates, premature materialization of large collections, missing lazy evaluation.\n\n${codeSnippets}\n\nReturn structured suggestions with severity and estimated impact.`;
+        try {
+            const result = await cs(prompt, zod_1.z.object({ suggestions: zod_1.z.array(OptimizeSuggestionSchema) }));
+            const llmIssues = (result.suggestions ?? []).map((s) => ({
+                category: s.category,
+                severity: s.severity,
+                file: target ?? "",
+                message: s.message,
+                fix: s.fix,
+                estimatedImpact: s.estimatedImpact,
+            }));
+            const allIssues = [...staticIssues, ...llmIssues];
+            return { success: true, output: JSON.stringify({ filesScanned: scanFiles.length, issuesFound: allIssues.length, issues: allIssues.slice(0, 20) }) };
+        }
+        catch {
+            return { success: true, output: JSON.stringify({ filesScanned: scanFiles.length, issuesFound: staticIssues.length, issues: staticIssues }) };
+        }
+    }
+}
+exports.NeuralOptimizeTool = NeuralOptimizeTool;
+//# sourceMappingURL=neural-optimize.tool.js.map

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

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

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

@@ -0,0 +1,10 @@
+import { ToolBase, ToolContext, ToolExecutionResult } from "@thoughtflow/core";
+export declare class NeuralPatternTool extends ToolBase {
+    readonly name = "neuralPattern";
+    readonly description = "Recognize design patterns used in the codebase using static analysis and LLM verification. Detects Singleton, Factory, Observer, Strategy, Decorator, Repository, Adapter, Builder, Command, Mediator, Chain of Responsibility, and more.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private detectPatterns;
+}
+//# sourceMappingURL=neural-pattern.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neural-pattern.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/neural-pattern.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI/E,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,+OAA+O;IACnQ,SAAkB,QAAQ,QAAQ;;IAU5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAyEzF,OAAO,CAAC,cAAc;CAiDvB"}