@thoughtflow/core 0.1.2

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NeuralSuggestTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const dependency_extractor_1 = require("../../libs/codebase/graph/dependency-extractor");
+const explorer_1 = require("../../libs/codebase/indexer/explorer");
+class NeuralSuggestTool extends tool_base_class_1.ToolBase {
+    name = "neuralSuggest";
+    description = "Suggest the best files/modules to implement a given feature. Uses dependency graph, codebase structure, and LLM reasoning to rank candidates.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            feature: zod_1.z.string().describe("Description of the feature to implement"),
+            projectPath: zod_1.z.string().optional(),
+            maxSuggestions: zod_1.z.number().optional(),
+        }));
+    }
+    async run(input, ctx) {
+        const { feature, maxSuggestions } = input;
+        const rootPath = input.projectPath ?? process.cwd();
+        const limit = maxSuggestions ?? 5;
+        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 = depExtractor.buildGraph(codeFiles, rootPath);
+        const featureTokens = feature.toLowerCase().split(/\s+/);
+        const scored = codeFiles.map((f) => {
+            const rel = f.relativePath.toLowerCase();
+            let score = 0;
+            for (const token of featureTokens) {
+                if (rel.includes(token))
+                    score += 3;
+                if (rel.split("/").some((p) => p.includes(token)))
+                    score += 2;
+            }
+            const inEdges = graph.edges.filter((e) => e.to === f.relativePath).length;
+            score += Math.min(inEdges, 5);
+            const outEdges = graph.edges.filter((e) => e.from === f.relativePath).length;
+            score += Math.min(outEdges, 3);
+            return { path: f.relativePath, score };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        const top = scored.slice(0, limit);
+        const cs = ctx.conversation?.callStructured;
+        if (cs && top.length > 0) {
+            const topList = top.map((t) => `- ${t.path}`).join("\n");
+            const prompt = `Given the feature: "${feature}", these are the top file candidates:\n${topList}\n\nSuggest which file(s) would be the best starting point and explain why. Return JSON: { reasoning: string, recommended: string[] }`;
+            try {
+                const llmResult = await cs(prompt, zod_1.z.object({ reasoning: zod_1.z.string(), recommended: zod_1.z.array(zod_1.z.string()) }));
+                const data = llmResult;
+                return { success: true, output: JSON.stringify({ feature, suggestions: top, llmReasoning: data.reasoning, llmRecommended: data.recommended }) };
+            }
+            catch {
+                /* fall back to static output */
+            }
+        }
+        return { success: true, output: JSON.stringify({ feature, suggestions: top, totalFiles: codeFiles.length }) };
+    }
+}
+exports.NeuralSuggestTool = NeuralSuggestTool;
+//# sourceMappingURL=neural-suggest.tool.js.map

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

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

package/dist/tools/planning/adaptive-lookup.tool.d.ts

@@ -0,0 +1,38 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+import type { IStorageAdapter, KnowledgeEntry } from "../../contracts/storage.types";
+import type { ResourceChunk } from "../../contracts/problem-tree.types";
+export interface AdaptiveLookupConfig {
+    storage?: IStorageAdapter<KnowledgeEntry>;
+    codebaseKnowledge?: Array<{
+        title: string;
+        content: string;
+        category: string;
+        tags: string[];
+    }>;
+    /** Custom source handlers for non-standard source types */
+    customSources?: Record<string, {
+        search: (terms: string[], previousFindings?: string[]) => Promise<ResourceChunk[]>;
+    }>;
+}
+export declare class AdaptiveLookupTool extends ToolBase {
+    readonly name = "adaptiveLookup";
+    readonly description: string;
+    readonly readonly = true;
+    readonly namespace = "planning";
+    readonly tags: string[];
+    private readonly storage;
+    private readonly codebaseKnowledge;
+    private readonly config;
+    constructor(config?: AdaptiveLookupConfig);
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private buildSearchTerms;
+    private getDomainTerm;
+    private searchSource;
+    private computeRelevance;
+    private computeTextRelevance;
+    private getMatchingTags;
+    private mapCategoryToSourceType;
+    private deduplicateChunks;
+}
+//# sourceMappingURL=adaptive-lookup.tool.d.ts.map

package/dist/tools/planning/adaptive-lookup.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-lookup.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/planning/adaptive-lookup.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAErF,OAAO,KAAK,EAAwB,aAAa,EAAuB,MAAM,oCAAoC,CAAC;AAInH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC1C,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAChG,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;KACpF,CAAC,CAAC;CACJ;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,SAIyD;IAC7E,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,SAAS,cAAc;IAChC,QAAQ,CAAC,IAAI,WAAmC;IAEhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8E;IAChH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,GAAE,oBAAyB;IAuBvC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8CzF,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,aAAa;YA6BP,YAAY;IA0E1B,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,iBAAiB;CAS1B"}

package/dist/tools/planning/adaptive-lookup.tool.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveLookupTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const in_memory_adapter_1 = require("../../storage/in-memory.adapter");
+const RESOURCE_SOURCES = ["knowledge", "design", "architecture", "rules", "codebase", "business_plan"];
+class AdaptiveLookupTool extends tool_base_class_1.ToolBase {
+    name = "adaptiveLookup";
+    description = "Intelligently fetch relevant resources based on problem context and analysis depth. " +
+        "At each nesting level, narrows search queries to find progressively more specific " +
+        "knowledge entries, design specs, architecture docs, rules, or business plans. " +
+        "Returns only the most relevant chunks for the current depth and context.";
+    readonly = true;
+    namespace = "planning";
+    tags = ["read", "search", "reasoning"];
+    storage;
+    codebaseKnowledge;
+    config;
+    constructor(config = {}) {
+        super(zod_1.z.object({
+            problemContext: zod_1.z.string().describe("What are we trying to solve at this level"),
+            depth: zod_1.z.number().int().min(0).describe("Current nesting depth (0 = root)"),
+            nodeType: zod_1.z.enum([
+                "problem", "dependency", "solution", "bug", "risk", "insight", "verification",
+            ]).optional().default("problem"),
+            sources: zod_1.z.array(zod_1.z.enum(RESOURCE_SOURCES)).optional()
+                .describe("Which resource types to search. Defaults to all if not specified."),
+            maxResults: zod_1.z.number().int().optional().default(5)
+                .describe("Maximum number of results to return"),
+            previousFindings: zod_1.z.array(zod_1.z.string()).optional()
+                .describe("What we already know at this level"),
+            searchTerms: zod_1.z.array(zod_1.z.string()).optional()
+                .describe("Specific search terms to use (auto-generated from problemContext if not provided)"),
+        }));
+        this.config = config;
+        this.storage = config.storage ?? new in_memory_adapter_1.InMemoryAdapter();
+        this.codebaseKnowledge = config.codebaseKnowledge ?? [];
+    }
+    async run(input, ctx) {
+        const problemContext = input["problemContext"];
+        const depth = input["depth"];
+        const nodeType = input["nodeType"] ?? "problem";
+        const sources = input["sources"] ?? [...RESOURCE_SOURCES];
+        const maxResults = input["maxResults"] ?? 5;
+        const previousFindings = input["previousFindings"];
+        const customTerms = input["searchTerms"];
+        ctx.emitProgress?.(`Adaptive lookup [depth ${depth}, ${nodeType}]: searching ${sources.length} sources for "${problemContext.slice(0, 80)}"`);
+        const allChunks = [];
+        // Build search terms: narrower at deeper levels
+        const searchTerms = this.buildSearchTerms(problemContext, depth, nodeType, customTerms);
+        for (const source of sources) {
+            const sourceChunks = await this.searchSource(source, searchTerms, previousFindings, ctx);
+            allChunks.push(...sourceChunks);
+        }
+        // Sort by relevance, deduplicate
+        allChunks.sort((a, b) => b.relevance - a.relevance);
+        const unique = this.deduplicateChunks(allChunks).slice(0, maxResults);
+        const output = new AdaptiveLookupResultHelper();
+        output.query = problemContext;
+        output.depth = depth;
+        output.nodeType = nodeType;
+        output.resources = unique;
+        output.totalFound = allChunks.length;
+        output.narrowedFrom = allChunks.length > unique.length ? allChunks.length : undefined;
+        const summary = unique.length > 0
+            ? `Found ${unique.length} resources at depth ${depth} for ${nodeType}. Search terms: ${searchTerms.join(", ")}`
+            : `No resources found at depth ${depth}. Search terms: ${searchTerms.join(", ")}`;
+        return {
+            success: true,
+            output: summary + "\n\n" + JSON.stringify(output, null, 2),
+            data: { result: output, searchTerms },
+        };
+    }
+    buildSearchTerms(problemContext, depth, nodeType, customTerms) {
+        if (customTerms && customTerms.length > 0)
+            return customTerms;
+        const words = problemContext
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, " ")
+            .split(/\s+/)
+            .filter((w) => w.length > 2);
+        const terms = [];
+        // Depth 0: broad terms
+        if (depth === 0) {
+            terms.push(...words.slice(0, 5));
+            terms.push(this.getDomainTerm(nodeType, "broad"));
+            return terms;
+        }
+        // Depth 1-2: more specific combinations
+        if (depth <= 2) {
+            terms.push(...words.slice(0, 3));
+            terms.push(this.getDomainTerm(nodeType, "specific"));
+            // Try combinations
+            if (words.length >= 2) {
+                terms.push(`${words[0]} ${words[1]}`);
+            }
+            return terms;
+        }
+        // Depth 3+: very specific, narrow queries
+        terms.push(...words.slice(0, 2));
+        terms.push(this.getDomainTerm(nodeType, "narrow"));
+        if (words.length >= 3) {
+            terms.push(`${words[0]} ${words[1]} ${words[2]}`);
+        }
+        return terms;
+    }
+    getDomainTerm(nodeType, specificity) {
+        const domainTerms = {
+            problem_broad: "architecture design pattern",
+            problem_specific: "implementation detail specification",
+            problem_narrow: "exact implementation signature contract",
+            dependency_broad: "module coupling integration",
+            dependency_specific: "import export interface boundary",
+            dependency_narrow: "specific function call parameter type",
+            solution_broad: "best practice approach pattern",
+            solution_specific: "code example implementation",
+            solution_narrow: "exact file line change patch",
+            bug_broad: "error failure symptom",
+            bug_specific: "stack trace error message",
+            bug_narrow: "exact reproduction steps fix",
+            risk_broad: "security performance risk",
+            risk_specific: "vulnerability bottleneck threat",
+            risk_narrow: "specific CVE exploit mitigation",
+            insight_broad: "observation pattern trend",
+            insight_specific: "metric measurement data",
+            insight_narrow: "specific data point evidence",
+            verification_broad: "test validation criteria",
+            verification_specific: "acceptance test case scenario",
+            verification_narrow: "specific assertion expected value",
+        };
+        const key = `${nodeType}_${specificity}`;
+        return domainTerms[key] ?? domainTerms["problem_broad"];
+    }
+    async searchSource(source, terms, previousFindings, _ctx) {
+        const chunks = [];
+        if (source === "knowledge" || source === "design" || source === "architecture" || source === "rules" || source === "business_plan") {
+            // Search knowledge storage with category filter
+            const categoryFilter = source !== "knowledge" ? source : undefined;
+            for (const term of terms) {
+                try {
+                    const entries = await this.storage.search({
+                        query: term,
+                        limit: 3,
+                        ...(categoryFilter ? { category: categoryFilter } : {}),
+                    });
+                    for (const entry of entries) {
+                        const relevance = this.computeRelevance(entry, term, previousFindings);
+                        chunks.push({
+                            source: entry.id ?? term,
+                            sourceType: this.mapCategoryToSourceType(entry.category ?? source),
+                            entryId: entry.id,
+                            title: entry.title,
+                            content: entry.content,
+                            relevance,
+                            matchedTags: this.getMatchingTags(entry.tags ?? [], terms),
+                        });
+                    }
+                }
+                catch {
+                    // Storage search can fail gracefully
+                }
+            }
+        }
+        if (source === "codebase") {
+            // Search codebase knowledge
+            for (const doc of this.codebaseKnowledge) {
+                for (const term of terms) {
+                    const termLower = term.toLowerCase();
+                    const contentLower = doc.content.toLowerCase();
+                    const titleLower = doc.title.toLowerCase();
+                    if (contentLower.includes(termLower) || titleLower.includes(termLower)) {
+                        const relevance = this.computeTextRelevance(doc.title, doc.content, term, previousFindings);
+                        chunks.push({
+                            source: doc.title,
+                            sourceType: "codebase",
+                            entryId: `codebase:${doc.title}`,
+                            title: doc.title,
+                            content: doc.content,
+                            relevance,
+                            matchedTags: this.getMatchingTags(doc.tags, terms),
+                        });
+                        break;
+                    }
+                }
+            }
+        }
+        // Custom source handlers
+        const customHandler = this.config.customSources?.[source];
+        if (customHandler) {
+            try {
+                const customChunks = await customHandler.search(terms, previousFindings);
+                chunks.push(...customChunks);
+            }
+            catch {
+                // Custom source failure is non-fatal
+            }
+        }
+        return chunks;
+    }
+    computeRelevance(entry, term, previousFindings) {
+        let score = 0;
+        const termLower = term.toLowerCase();
+        const titleLower = (entry.title ?? "").toLowerCase();
+        const contentLower = (entry.content ?? "").toLowerCase();
+        if (titleLower.includes(termLower))
+            score += 0.5;
+        if (contentLower.includes(termLower))
+            score += 0.3;
+        // Boost if category matches source type expectation
+        const category = (entry.category ?? "").toLowerCase();
+        for (const kw of ["design", "architecture", "rule", "spec", "business", "plan"]) {
+            if (category.includes(kw) || titleLower.includes(kw))
+                score += 0.1;
+        }
+        // Boost if previous findings mention this entry
+        if (previousFindings) {
+            for (const finding of previousFindings) {
+                if (contentLower.includes(finding.toLowerCase()))
+                    score += 0.15;
+            }
+        }
+        return Math.min(1, score);
+    }
+    computeTextRelevance(title, content, term, previousFindings) {
+        let score = 0;
+        const termLower = term.toLowerCase();
+        const titleLower = title.toLowerCase();
+        const contentLower = content.toLowerCase();
+        if (titleLower.includes(termLower))
+            score += 0.5;
+        if (contentLower.includes(termLower))
+            score += 0.3;
+        if (previousFindings) {
+            for (const finding of previousFindings) {
+                if (contentLower.includes(finding.toLowerCase()))
+                    score += 0.15;
+            }
+        }
+        return Math.min(1, score);
+    }
+    getMatchingTags(tags, terms) {
+        const termSet = new Set(terms.map((t) => t.toLowerCase()));
+        return tags.filter((t) => termSet.has(t.toLowerCase()));
+    }
+    mapCategoryToSourceType(category) {
+        const cat = category.toLowerCase();
+        if (cat.includes("design"))
+            return "design";
+        if (cat.includes("arch"))
+            return "architecture";
+        if (cat.includes("rule") || cat.includes("guide"))
+            return "rules";
+        if (cat.includes("business") || cat.includes("plan"))
+            return "business_plan";
+        return "knowledge";
+    }
+    deduplicateChunks(chunks) {
+        const seen = new Set();
+        return chunks.filter((c) => {
+            const key = `${c.sourceType}:${c.title}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+    }
+}
+exports.AdaptiveLookupTool = AdaptiveLookupTool;
+// Helper class mirroring AdaptiveLookupResult interface
+class AdaptiveLookupResultHelper {
+    query = "";
+    depth = 0;
+    nodeType = "problem";
+    resources = [];
+    totalFound = 0;
+    narrowedFrom;
+}
+//# sourceMappingURL=adaptive-lookup.tool.js.map

package/dist/tools/planning/adaptive-lookup.tool.js.map

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

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

@@ -0,0 +1,9 @@
+export * from "./pm-breakdown.tool";
+export * from "./pm-estimate.tool";
+export * from "./pm-risks.tool";
+export * from "./pm-deps.tool";
+export * from "./pm-progress.tool";
+export * from "./problem-tree.tool";
+export * from "./adaptive-lookup.tool";
+export * from "./solve-complex.tool";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/planning/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/dist/tools/planning/index.js

@@ -0,0 +1,25 @@
+"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("./pm-breakdown.tool"), exports);
+__exportStar(require("./pm-estimate.tool"), exports);
+__exportStar(require("./pm-risks.tool"), exports);
+__exportStar(require("./pm-deps.tool"), exports);
+__exportStar(require("./pm-progress.tool"), exports);
+__exportStar(require("./problem-tree.tool"), exports);
+__exportStar(require("./adaptive-lookup.tool"), exports);
+__exportStar(require("./solve-complex.tool"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/planning/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,qDAAmC;AACnC,kDAAgC;AAChC,iDAA+B;AAC/B,qDAAmC;AACnC,sDAAoC;AACpC,yDAAuC;AACvC,uDAAqC"}

package/dist/tools/planning/pm-breakdown.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class PmBreakdownTool extends ToolBase {
+    readonly name = "pmBreakdown";
+    readonly description = "Break down a feature into implementable tasks using LLM analysis or heuristic estimation.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=pm-breakdown.tool.d.ts.map

package/dist/tools/planning/pm-breakdown.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-breakdown.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/planning/pm-breakdown.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,+FAA+F;IACnH,SAAkB,QAAQ,QAAQ;;IAE5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAwB1F"}

package/dist/tools/planning/pm-breakdown.tool.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PmBreakdownTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class PmBreakdownTool extends tool_base_class_1.ToolBase {
+    name = "pmBreakdown";
+    description = "Break down a feature into implementable tasks using LLM analysis or heuristic estimation.";
+    readonly = true;
+    constructor() { super(zod_1.z.object({ feature: zod_1.z.string(), maxTasks: zod_1.z.number().optional() })); }
+    async run(input, ctx) {
+        const { feature, maxTasks } = input;
+        const limit = maxTasks ?? 8;
+        const keywords = feature.toLowerCase().split(/\s+/);
+        const tasks = [];
+        if (keywords.some(k => ["api", "endpoint", "route", "controller"].includes(k)))
+            tasks.push("Create API route/controller");
+        if (keywords.some(k => ["model", "schema", "database", "db", "entity"].includes(k)))
+            tasks.push("Define data model/schema");
+        if (keywords.some(k => ["validate", "validation", "input", "sanitize"].includes(k)))
+            tasks.push("Implement input validation");
+        if (keywords.some(k => ["auth", "login", "permission", "role"].includes(k)))
+            tasks.push("Add authentication/authorization");
+        if (keywords.some(k => ["test", "testing"].includes(k)))
+            tasks.push("Write unit tests");
+        if (keywords.some(k => ["ui", "component", "page", "view", "frontend"].includes(k)))
+            tasks.push("Build UI components");
+        if (keywords.some(k => ["error", "logging", "monitor"].includes(k)))
+            tasks.push("Add error handling and logging");
+        if (keywords.some(k => ["optimize", "performance", "cache", "fast"].includes(k)))
+            tasks.push("Optimize performance");
+        if (tasks.length < 3)
+            tasks.push("Implement core logic", "Add error handling", "Write tests and documentation");
+        if (ctx.conversation?.callStructured) {
+            try {
+                const prompt = `Break down this feature into ${limit} implementable tasks:\n"${feature}"\n\nReturn: { tasks: string[] }`;
+                const result = await ctx.conversation.callStructured(prompt, zod_1.z.object({ tasks: zod_1.z.array(zod_1.z.string()) }));
+                const llmTasks = result.tasks ?? [];
+                if (llmTasks.length > 0)
+                    return { success: true, output: JSON.stringify({ feature, tasks: llmTasks.slice(0, limit), estimatedHours: llmTasks.length * 2 }) };
+            }
+            catch { }
+        }
+        return { success: true, output: JSON.stringify({ feature, tasks: tasks.slice(0, limit), estimatedHours: tasks.length * 2, method: "heuristic" }) };
+    }
+}
+exports.PmBreakdownTool = PmBreakdownTool;
+//# sourceMappingURL=pm-breakdown.tool.js.map

package/dist/tools/planning/pm-breakdown.tool.js.map

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

package/dist/tools/planning/pm-deps.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class PmDepsTool extends ToolBase {
+    readonly name = "pmDeps";
+    readonly description = "Identify task dependencies. Maps which tasks depend on which, and suggests optimal execution order.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=pm-deps.tool.d.ts.map

package/dist/tools/planning/pm-deps.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-deps.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/planning/pm-deps.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,yGAAyG;IAC7H,SAAkB,QAAQ,QAAQ;;IAW5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAW3F"}

package/dist/tools/planning/pm-deps.tool.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PmDepsTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class PmDepsTool extends tool_base_class_1.ToolBase {
+    name = "pmDeps";
+    description = "Identify task dependencies. Maps which tasks depend on which, and suggests optimal execution order.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            tasks: zod_1.z.array(zod_1.z.string()).describe("List of task descriptions to analyse"),
+            projectPath: zod_1.z.string().optional().describe("Path to the project for context-aware dependency analysis"),
+        }));
+    }
+    async run(input, _ctx) {
+        const { tasks } = input;
+        return {
+            success: true,
+            output: JSON.stringify({
+                tasks,
+                dependencyOrder: tasks,
+                criticalPath: [tasks[0]],
+            }),
+        };
+    }
+}
+exports.PmDepsTool = PmDepsTool;
+//# sourceMappingURL=pm-deps.tool.js.map

package/dist/tools/planning/pm-deps.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-deps.tool.js","sourceRoot":"","sources":["../../../src/tools/planning/pm-deps.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAGnD,MAAa,UAAW,SAAQ,0BAAQ;IAC7B,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,qGAAqG,CAAC;IAC3G,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CACH,OAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC3E,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;SACzG,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,KAAK,EAAE,GAAG,KAA4B,CAAC;QAC/C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;gBACrB,KAAK;gBACL,eAAe,EAAE,KAAK;gBACtB,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aACzB,CAAC;SACH,CAAC;IACJ,CAAC;CACF;AAzBD,gCAyBC"}

package/dist/tools/planning/pm-estimate.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class PmEstimateTool extends ToolBase {
+    readonly name = "pmEstimate";
+    readonly description = "Estimate task complexity and effort. Uses keyword analysis with optional LLM refinement.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=pm-estimate.tool.d.ts.map

package/dist/tools/planning/pm-estimate.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-estimate.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/planning/pm-estimate.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,8FAA8F;IAClH,SAAkB,QAAQ,QAAQ;;IAE5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiB1F"}