@thoughtflow/core 0.1.2

package/dist/tools/memory/memory-lessons.tool.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryLessonsTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const storage_1 = require("../../storage");
+class MemoryLessonsTool extends tool_base_class_1.ToolBase {
+    name = "memoryLessons";
+    description = "Store and recall lessons learned from completed tasks.";
+    readonly = false;
+    storage;
+    constructor(storage) {
+        super(zod_1.z.object({ lesson: zod_1.z.string().optional(), taskId: zod_1.z.string().optional(), context: zod_1.z.string().optional(), outcome: zod_1.z.string().optional(), action: zod_1.z.enum(["save", "recall", "list"]).optional() }));
+        this.storage = storage ?? new storage_1.InMemoryAdapter();
+    }
+    async run(input, _ctx) {
+        const { lesson, taskId, context, outcome, action } = input;
+        if (action === "save" && lesson) {
+            const entry = await this.storage.create({
+                lesson, taskId, context: context ?? "", outcome: outcome ?? "unknown",
+                tags: [], createdAt: new Date().toISOString(),
+            });
+            return { success: true, output: JSON.stringify({ saved: true, id: entry.id }) };
+        }
+        const lessons = await this.storage.list({});
+        return { success: true, output: JSON.stringify({ count: lessons.length, lessons: lessons.slice(0, 10) }) };
+    }
+}
+exports.MemoryLessonsTool = MemoryLessonsTool;
+//# sourceMappingURL=memory-lessons.tool.js.map

package/dist/tools/memory/memory-lessons.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lessons.tool.js","sourceRoot":"","sources":["../../../src/tools/memory/memory-lessons.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAEnD,2CAAgD;AAGhD,MAAa,iBAAkB,SAAQ,0BAAQ;IACpC,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,wDAAwD,CAAC;IAC9D,QAAQ,GAAG,KAAK,CAAC;IAC3B,OAAO,CAAgC;IAE/C,YAAY,OAAuC;QACjD,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QACzM,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,yBAAe,EAAgB,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAkG,CAAC;QACxJ,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,IAAI,SAAS;gBACrE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC9C,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7G,CAAC;CACF;AAvBD,8CAuBC"}

package/dist/tools/memory/memory-patterns.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult, IStorageAdapter } from "../../contracts";
+import { MemoryPattern } from "../../contracts/memory.types";
+export declare class MemoryPatternsTool extends ToolBase {
+    readonly name = "memoryPatterns";
+    readonly description = "Record and recall implementation patterns that worked well.";
+    readonly readonly = false;
+    private storage;
+    constructor(storage?: IStorageAdapter<MemoryPattern>);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=memory-patterns.tool.d.ts.map

package/dist/tools/memory/memory-patterns.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-patterns.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/memory-patterns.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,iEAAiE;IACrF,SAAkB,QAAQ,SAAS;IACnC,OAAO,CAAC,OAAO,CAAiC;gBAEpC,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC;IAK9C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAa3F"}

package/dist/tools/memory/memory-patterns.tool.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryPatternsTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const storage_1 = require("../../storage");
+class MemoryPatternsTool extends tool_base_class_1.ToolBase {
+    name = "memoryPatterns";
+    description = "Record and recall implementation patterns that worked well.";
+    readonly = false;
+    storage;
+    constructor(storage) {
+        super(zod_1.z.object({ pattern: zod_1.z.string().optional(), solution: zod_1.z.string().optional(), whenToUse: zod_1.z.string().optional(), tags: zod_1.z.array(zod_1.z.string()).optional(), action: zod_1.z.enum(["save", "search", "list"]).optional() }));
+        this.storage = storage ?? new storage_1.InMemoryAdapter();
+    }
+    async run(input, _ctx) {
+        const { pattern, solution, whenToUse, tags, action } = input;
+        if (action === "save" && pattern && solution) {
+            const entry = await this.storage.create({
+                pattern, solution, whenToUse: whenToUse ?? "", tags: tags ?? [],
+                successRate: 100, timesUsed: 1,
+                createdAt: new Date().toISOString(),
+            });
+            return { success: true, output: JSON.stringify({ saved: true, id: entry.id }) };
+        }
+        const patterns = await this.storage.list({});
+        return { success: true, output: JSON.stringify({ count: patterns.length, patterns: patterns.slice(0, 10) }) };
+    }
+}
+exports.MemoryPatternsTool = MemoryPatternsTool;
+//# sourceMappingURL=memory-patterns.tool.js.map

package/dist/tools/memory/memory-patterns.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-patterns.tool.js","sourceRoot":"","sources":["../../../src/tools/memory/memory-patterns.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAEnD,2CAAgD;AAGhD,MAAa,kBAAmB,SAAQ,0BAAQ;IACrC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,6DAA6D,CAAC;IACnE,QAAQ,GAAG,KAAK,CAAC;IAC3B,OAAO,CAAiC;IAEhD,YAAY,OAAwC;QAClD,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QACpN,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,yBAAe,EAAiB,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAsG,CAAC;QAC9J,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE;gBAC/D,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;gBAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAChH,CAAC;CACF;AAxBD,gDAwBC"}

package/dist/tools/memory/memory-recall.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult, IStorageAdapter } from "../../contracts";
+import { MemoryEntry } from "../../contracts/memory.types";
+export declare class MemoryRecallTool extends ToolBase {
+    readonly name = "memoryRecall";
+    readonly description = "Recall previously saved facts about the codebase. Search by keyword, category, or tags.";
+    readonly readonly = true;
+    private storage;
+    constructor(storage?: IStorageAdapter<MemoryEntry>);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=memory-recall.tool.d.ts.map

package/dist/tools/memory/memory-recall.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recall.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/memory-recall.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,6FAA6F;IACjH,SAAkB,QAAQ,QAAQ;IAClC,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC;IAK5C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAM3F"}

package/dist/tools/memory/memory-recall.tool.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryRecallTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const storage_1 = require("../../storage");
+class MemoryRecallTool extends tool_base_class_1.ToolBase {
+    name = "memoryRecall";
+    description = "Recall previously saved facts about the codebase. Search by keyword, category, or tags.";
+    readonly = true;
+    storage;
+    constructor(storage) {
+        super(zod_1.z.object({ query: zod_1.z.string().optional(), category: zod_1.z.string().optional(), limit: zod_1.z.number().optional() }));
+        this.storage = storage ?? new storage_1.InMemoryAdapter();
+    }
+    async run(input, _ctx) {
+        const { query, category, limit } = input;
+        const results = await this.storage.search({ query, category, limit: limit ?? 10 });
+        const facts = results.map(r => ({ id: r.id, fact: r.fact, category: r.category, tags: r.tags, createdAt: r.createdAt }));
+        return { success: true, output: JSON.stringify({ found: facts.length, facts }) };
+    }
+}
+exports.MemoryRecallTool = MemoryRecallTool;
+//# sourceMappingURL=memory-recall.tool.js.map

package/dist/tools/memory/memory-recall.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recall.tool.js","sourceRoot":"","sources":["../../../src/tools/memory/memory-recall.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAEnD,2CAAgD;AAGhD,MAAa,gBAAiB,SAAQ,0BAAQ;IACnC,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,yFAAyF,CAAC;IAC/F,QAAQ,GAAG,IAAI,CAAC;IAC1B,OAAO,CAA+B;IAE9C,YAAY,OAAsC;QAChD,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QACjH,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,yBAAe,EAAe,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAA8D,CAAC;QAClG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACzH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACnF,CAAC;CACF;AAjBD,4CAiBC"}

package/dist/tools/memory/memory-save.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult, IStorageAdapter } from "../../contracts";
+import { MemoryEntry } from "../../contracts/memory.types";
+export declare class MemorySaveTool extends ToolBase {
+    readonly name = "memorySave";
+    readonly description = "Persist a fact or insight about the codebase for future recall.";
+    readonly readonly = false;
+    private storage;
+    constructor(storage?: IStorageAdapter<MemoryEntry>);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=memory-save.tool.d.ts.map

package/dist/tools/memory/memory-save.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-save.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/memory-save.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,qEAAqE;IACzF,SAAkB,QAAQ,SAAS;IACnC,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC;IAK5C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAU3F"}

package/dist/tools/memory/memory-save.tool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemorySaveTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const storage_1 = require("../../storage");
+class MemorySaveTool extends tool_base_class_1.ToolBase {
+    name = "memorySave";
+    description = "Persist a fact or insight about the codebase for future recall.";
+    readonly = false;
+    storage;
+    constructor(storage) {
+        super(zod_1.z.object({ fact: zod_1.z.string(), category: zod_1.z.string().optional(), tags: zod_1.z.array(zod_1.z.string()).optional() }));
+        this.storage = storage ?? new storage_1.InMemoryAdapter();
+    }
+    async run(input, _ctx) {
+        const { fact, category, tags } = input;
+        const entry = await this.storage.create({
+            fact, category: category ?? "general", tags: tags ?? [],
+            confidence: 100, source: "user",
+            createdAt: new Date().toISOString(), updatedAt: new Date().toISOString(),
+            accessCount: 0, lastAccessedAt: new Date().toISOString(),
+        });
+        return { success: true, output: JSON.stringify({ saved: true, id: entry.id, fact: fact.slice(0, 100), category: entry.category }) };
+    }
+}
+exports.MemorySaveTool = MemorySaveTool;
+//# sourceMappingURL=memory-save.tool.js.map

package/dist/tools/memory/memory-save.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-save.tool.js","sourceRoot":"","sources":["../../../src/tools/memory/memory-save.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAEnD,2CAAgD;AAGhD,MAAa,cAAe,SAAQ,0BAAQ;IACjC,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,iEAAiE,CAAC;IACvE,QAAQ,GAAG,KAAK,CAAC;IAC3B,OAAO,CAA+B;IAE9C,YAAY,OAAsC;QAChD,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7G,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,yBAAe,EAAe,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAA6D,CAAC;QAC/F,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACtC,IAAI,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE;YACvD,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACxE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACzD,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;IACtI,CAAC;CACF;AArBD,wCAqBC"}

package/dist/tools/neural/comparative-analysis.tool.d.ts

@@ -0,0 +1,38 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export interface ComparativeAnalysisConfig {
+    /** Custom persona prompt for LLM-powered comparison */
+    personaPrompt?: string;
+    /** Scoring weights for compliance calculation */
+    scoringWeights?: {
+        penaltyPerDiscrepancy?: number;
+        criticalMultiplier?: number;
+    };
+    /** Char limits for state/content truncation */
+    truncation?: {
+        actualMaxChars?: number;
+        expectedMaxChars?: number;
+        contextMaxChars?: number;
+    };
+    /** Custom cross-cutting checks to run after comparison */
+    crossCuttingChecks?: Array<{
+        keyword: string;
+        severity: "low" | "medium" | "high";
+        title: string;
+        suggestion: string;
+    }>;
+}
+export declare class ComparativeAnalysisTool extends ToolBase {
+    private readonly config;
+    readonly name = "comparativeAnalysis";
+    readonly description: string;
+    readonly readonly = true;
+    readonly namespace = "neural";
+    readonly tags: string[];
+    constructor(config?: ComparativeAnalysisConfig);
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private buildLLMPrompt;
+    private heuristicCompare;
+    private formatOutput;
+}
+//# sourceMappingURL=comparative-analysis.tool.d.ts.map

package/dist/tools/neural/comparative-analysis.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparative-analysis.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/neural/comparative-analysis.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,cAAc,CAAC,EAAE;QACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,+CAA+C;IAC/C,UAAU,CAAC,EAAE;QACX,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,KAAK,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAmCD,qBAAa,uBAAwB,SAAQ,QAAQ;IAYvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXnC,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,WAAW,SAK+E;IACnG,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,SAAS,YAAY;IAC9B,QAAQ,CAAC,IAAI,WAAqC;gBAErB,MAAM,GAAE,yBAA8B;IAsB7D,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4CzF,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,gBAAgB;IA4GxB,OAAO,CAAC,YAAY;CAkBrB"}

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 tool_base_class_1 = require("../base/tool-base.class");
+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 tool_base_class_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,11 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+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,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKnE,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"}