@grant-vine/wunderkind 0.3.0 → 0.4.0

package/dist/memory/index.js

@@ -0,0 +1,183 @@
+import path from "node:path";
+import { homedir } from "node:os";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { parse } from "jsonc-parser";
+import { zip as fflateZip, unzip as fflateUnzip, strToU8, strFromU8 } from "fflate";
+import { FileAdapter } from "./adapters/file.js";
+import { Mem0Adapter } from "./adapters/mem0.js";
+import { SqliteAdapter } from "./adapters/sqlite.js";
+import { StubAdapter } from "./adapters/stub.js";
+import { VectorAdapter } from "./adapters/vector.js";
+import { generateSlug } from "./format.js";
+import { deriveProjectSlug } from "./slug.js";
+async function loadAdapter(projectDir) {
+    const legacyConfigPath = path.join(projectDir, "wunderkind.config.jsonc");
+    const projectConfigPath = path.join(projectDir, ".wunderkind", "wunderkind.config.jsonc");
+    const globalConfigPath = path.join(homedir(), ".wunderkind", "wunderkind.config.jsonc");
+    if (existsSync(legacyConfigPath)) {
+        throw new Error("Legacy config found at project root. Move it to .wunderkind/wunderkind.config.jsonc");
+    }
+    let config = {};
+    try {
+        config = { ...config, ...parse(await readFile(globalConfigPath, "utf-8")) };
+    }
+    catch { /* no global config */ }
+    try {
+        config = { ...config, ...parse(await readFile(projectConfigPath, "utf-8")) };
+    }
+    catch { /* no project config */ }
+    const projectSlug = deriveProjectSlug(projectDir);
+    const adapter = config.memoryAdapter ?? "file";
+    if (adapter === "file")
+        return new FileAdapter(projectDir);
+    if (adapter === "sqlite") {
+        return new SqliteAdapter(path.join(projectDir, ".wunderkind", "memory.db"));
+    }
+    if (adapter === "mem0") {
+        return new Mem0Adapter({
+            url: config.mem0Url ?? "http://localhost:8000",
+            projectSlug,
+            ...(config.mem0LlmProvider ? { llmProvider: config.mem0LlmProvider } : {}),
+            ...(config.mem0LlmModel ? { llmModel: config.mem0LlmModel } : {}),
+            ...(config.mem0LlmBaseUrl ? { llmBaseUrl: config.mem0LlmBaseUrl } : {}),
+            ...(config.mem0EmbedProvider ? { embedProvider: config.mem0EmbedProvider } : {}),
+            ...(config.mem0EmbedModel ? { embedModel: config.mem0EmbedModel } : {}),
+            ...(config.mem0EmbedDims ? { embedDims: config.mem0EmbedDims } : {}),
+            ...(config.mem0EmbedBaseUrl ? { embedBaseUrl: config.mem0EmbedBaseUrl } : {}),
+            ...(config.mem0VectorStore ? { vectorStore: config.mem0VectorStore } : {}),
+            ...(config.mem0VectorStoreHost ? { vectorStoreHost: config.mem0VectorStoreHost } : {}),
+            ...(config.mem0VectorStorePort ? { vectorStorePort: config.mem0VectorStorePort } : {}),
+            ...(config.mem0VectorStoreCollection ? { vectorStoreCollection: config.mem0VectorStoreCollection } : {}),
+        });
+    }
+    if (adapter === "vector") {
+        return new VectorAdapter({
+            qdrantUrl: config.qdrantUrl ?? "http://localhost:6333",
+            model: config.vectorEmbedModel ?? "Xenova/all-MiniLM-L6-v2",
+            vectorSize: config.vectorSize ?? 384,
+            collectionName: config.vectorCollection ?? "wunderkind-memories",
+            projectSlug,
+            ...(config.vectorCacheDir ? { cacheDir: config.vectorCacheDir } : {}),
+        });
+    }
+    return new StubAdapter();
+}
+export async function takeNote(projectDir, agent, note, options) {
+    const adapter = await loadAdapter(projectDir);
+    const entry = {
+        agent,
+        slug: options?.slug ?? generateSlug(note),
+        content: note,
+        createdAt: Date.now(),
+        pinned: options?.pin ?? false,
+        metadata: {},
+    };
+    return adapter.write(agent, entry);
+}
+export async function searchMemories(projectDir, agent, query) {
+    const adapter = await loadAdapter(projectDir);
+    return adapter.search(agent, query);
+}
+export async function countMemories(projectDir, agent) {
+    const adapter = await loadAdapter(projectDir);
+    return adapter.count(agent);
+}
+export async function analyzeStaleMemories(projectDir, agent) {
+    const adapter = await loadAdapter(projectDir);
+    return adapter.analyzeStale(agent);
+}
+export async function pruneMemories(projectDir, agent, idsToRemove) {
+    const adapter = await loadAdapter(projectDir);
+    return adapter.prune(agent, idsToRemove);
+}
+export async function memoryStatus(projectDir) {
+    const adapter = await loadAdapter(projectDir);
+    return adapter.status();
+}
+export async function exportMemories(projectDir, outputPath) {
+    const adapter = await loadAdapter(projectDir);
+    const agents = await adapter.listAgents();
+    const allEntries = [];
+    const fileMap = {};
+    for (const agent of agents) {
+        const entries = await adapter.read(agent);
+        allEntries.push(...entries);
+        const agentContent = entries
+            .map((entry) => `## [${entry.slug}]\n\nid: ${entry.id}\n\n${entry.content}\n\n---\n`)
+            .join("\n");
+        fileMap[`agents/${agent}.md`] = strToU8(agentContent);
+    }
+    const projectSlug = deriveProjectSlug(projectDir);
+    const manifest = {
+        version: "1",
+        exportedAt: Date.now(),
+        projectSlug,
+        adapter: "file",
+        agents,
+        totalEntries: allEntries.length,
+    };
+    fileMap["manifest.json"] = strToU8(JSON.stringify(manifest, null, 2));
+    fileMap["entries.json"] = strToU8(JSON.stringify(allEntries));
+    const zipBytes = await new Promise((resolve, reject) => {
+        fflateZip(fileMap, { level: 6 }, (err, data) => {
+            if (err)
+                reject(err);
+            else
+                resolve(data);
+        });
+    });
+    const finalPath = outputPath ?? path.join(projectDir, ".wunderkind", "exports", `${Date.now()}.zip`);
+    await mkdir(path.dirname(finalPath), { recursive: true });
+    await writeFile(finalPath, zipBytes);
+    return finalPath;
+}
+export async function importMemories(projectDir, zipPath, strategy) {
+    const zipBytes = new Uint8Array(await readFile(zipPath));
+    const files = await new Promise((resolve, reject) => {
+        fflateUnzip(zipBytes, (err, data) => {
+            if (err)
+                reject(err);
+            else
+                resolve(data);
+        });
+    });
+    const entriesRaw = files["entries.json"];
+    if (!entriesRaw)
+        throw new Error("Invalid zip: missing entries.json");
+    const allEntries = JSON.parse(strFromU8(entriesRaw));
+    const adapter = await loadAdapter(projectDir);
+    let imported = 0;
+    let skipped = 0;
+    const uniqueAgents = Array.from(new Set(allEntries.map((e) => e.agent)));
+    if (strategy === "overwrite") {
+        for (const agent of uniqueAgents) {
+            await adapter.deleteAll(agent);
+        }
+        for (const entry of allEntries) {
+            const { id: _id, ...rest } = entry;
+            await adapter.write(entry.agent, rest);
+            imported += 1;
+        }
+    }
+    else {
+        const existingSlugs = new Map();
+        for (const agent of uniqueAgents) {
+            const existing = await adapter.read(agent);
+            existingSlugs.set(agent, new Set(existing.map((e) => e.slug)));
+        }
+        for (const entry of allEntries) {
+            const agentSlugs = existingSlugs.get(entry.agent);
+            if (agentSlugs?.has(entry.slug)) {
+                skipped += 1;
+            }
+            else {
+                const { id: _id, ...rest } = entry;
+                await adapter.write(entry.agent, rest);
+                imported += 1;
+            }
+        }
+    }
+    return { imported, skipped };
+}
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

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

package/dist/memory/slug.d.ts

@@ -0,0 +1,2 @@
+export declare function deriveProjectSlug(projectDir: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/memory/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/memory/slug.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAwC5D"}

package/dist/memory/slug.js

@@ -0,0 +1,40 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+export function deriveProjectSlug(projectDir) {
+    let packageName;
+    try {
+        const content = readFileSync(path.join(projectDir, "package.json"), "utf8");
+        const pkg = JSON.parse(content);
+        if (typeof pkg.name === "string") {
+            packageName = pkg.name;
+        }
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            throw err;
+        }
+    }
+    if (packageName) {
+        const sanitised = packageName
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "-")
+            .replace(/-+/g, "-")
+            .replace(/^-|-$/g, "")
+            .slice(0, 63);
+        if (sanitised.length > 0) {
+            return sanitised;
+        }
+    }
+    const dirname = path.basename(projectDir);
+    const sanitised = dirname
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 63);
+    if (sanitised.length > 0) {
+        return sanitised;
+    }
+    return "wunderkind-project";
+}
+//# sourceMappingURL=slug.js.map

package/dist/memory/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/memory/slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,WAA+B,CAAA;IACnC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAA;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,WAAW,GAAG,GAAG,CAAC,IAAI,CAAA;QACxB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,WAAW;aAC1B,WAAW,EAAE;aACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;aAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAEf,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;IACzC,MAAM,SAAS,GAAG,OAAO;SACtB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEf,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,oBAAoB,CAAA;AAC7B,CAAC"}

package/dist/memory/tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "@opencode-ai/plugin/dist/tool.js";
+export declare function createMemoryTools(): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/memory/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/memory/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,kCAAkC,CAAA;AASnF,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyFlE"}

package/dist/memory/tools.js

@@ -0,0 +1,84 @@
+import { tool } from "@opencode-ai/plugin/dist/tool.js";
+import { analyzeStaleMemories, countMemories, pruneMemories, searchMemories, takeNote, } from "./index.js";
+export function createMemoryTools() {
+    return {
+        wunderkind_take_note: tool({
+            description: "Save a note to your persistent memory. Use this to remember project-specific facts, decisions, patterns, and preferences for future sessions.",
+            args: {
+                note: tool.schema.string().describe("The content to remember"),
+                slug: tool.schema
+                    .string()
+                    .optional()
+                    .describe("Short identifier slug (auto-generated if omitted)"),
+                pin: tool.schema
+                    .boolean()
+                    .optional()
+                    .describe("Pin this memory so it is never pruned by reduce_noise"),
+            },
+            async execute(args, context) {
+                const options = {};
+                if (args.slug !== undefined)
+                    options.slug = args.slug;
+                if (args.pin !== undefined)
+                    options.pin = args.pin;
+                const entry = await takeNote(context.directory, context.agent, args.note, options);
+                return `Memory saved [${entry.slug}] (id: ${entry.id})`;
+            },
+        }),
+        wunderkind_search_memories: tool({
+            description: "Search your persistent memory for relevant past knowledge. Returns the most relevant memories for your query.",
+            args: {
+                query: tool.schema.string().describe("What to search for"),
+            },
+            async execute(args, context) {
+                const results = await searchMemories(context.directory, context.agent, args.query);
+                if (results.length === 0)
+                    return "No memories found matching your query.";
+                return results
+                    .map((e) => `[${e.slug}] ${e.content}${e.pinned ? " (pinned)" : ""}`)
+                    .join("\n\n");
+            },
+        }),
+        wunderkind_count_memories: tool({
+            description: "Get a count and summary of your persistent memories.",
+            args: {},
+            async execute(_args, context) {
+                const stats = await countMemories(context.directory, context.agent);
+                if (stats.total === 0)
+                    return "No memories stored yet.";
+                const oldest = stats.oldest > 0 ? new Date(stats.oldest).toISOString().split("T")[0] : "—";
+                const newest = stats.newest > 0 ? new Date(stats.newest).toISOString().split("T")[0] : "—";
+                return `Total: ${stats.total} | Pinned: ${stats.pinned} | Oldest: ${oldest} | Newest: ${newest}`;
+            },
+        }),
+        wunderkind_reduce_noise: tool({
+            description: "Analyze your memories for stale entries. Without confirm=true, shows what would be removed. With confirm=true, removes the stale entries.",
+            args: {
+                confirm: tool.schema
+                    .boolean()
+                    .optional()
+                    .describe("Set to true to actually remove stale memories. Omit or false to preview only."),
+            },
+            async execute(args, context) {
+                const analysis = await analyzeStaleMemories(context.directory, context.agent);
+                if (analysis.stale === 0) {
+                    return `All ${analysis.toKeep.length} memories are current. Nothing to prune.`;
+                }
+                const preview = analysis.toDrop
+                    .map((e) => `  - [${e.slug}] ${e.content.slice(0, 80)}...`)
+                    .join("\n");
+                if (!args.confirm) {
+                    return [
+                        `Found ${analysis.stale} stale memories to remove (${analysis.pinned} pinned, ${analysis.recent} recent kept):`,
+                        preview,
+                        "",
+                        "Call wunderkind_reduce_noise with confirm=true to proceed.",
+                    ].join("\n");
+                }
+                const removed = await pruneMemories(context.directory, context.agent, analysis.toDrop.map((e) => e.id));
+                return `Pruned ${removed} memories. Kept ${analysis.toKeep.length} (${analysis.pinned} pinned, ${analysis.recent} recent).`;
+            },
+        }),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/memory/tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grant-vine/wunderkind",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Wunderkind — a generic oh-my-opencode addon package with specialist agents for any software product team",
   "type": "module",
   "main": "dist/index.js",
@@ -26,13 +26,20 @@
   "scripts": {
     "build": "tsc && bun run dist/build-agents.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "test": "bun test tests/unit/",
+    "test:contract": "bun test tests/",
+    "bench": "bun run tests/perf/adapter-benchmark.ts"
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",
+    "@huggingface/transformers": "^3.8.1",
     "@opencode-ai/plugin": "^1.2.18",
+    "@qdrant/js-client-rest": "^1.17.0",
     "commander": "^13.1.0",
+    "fflate": "^0.8.2",
     "jsonc-parser": "^3.3.1",
+    "mem0ai": "^2.2.4",
     "oh-my-opencode": "^3.10.0",
     "picocolors": "^1.1.1"
   },
@@ -52,5 +59,8 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/grant-vine/wunderkind"
-  }
+  },
+  "trustedDependencies": [
+    "onnxruntime-node"
+  ]
 }

package/skills/memory-manager/SKILL.md

@@ -0,0 +1,48 @@
+# Memory Manager — Wunderkind
+
+You have access to four persistent memory tools. Use them to build project knowledge over time.
+
+## Tools
+
+### `wunderkind_take_note`
+Save a fact, decision, or pattern to your persistent memory.
+- `note` (required): what to remember
+- `slug` (optional): short identifier
+- `pin` (optional): true = never auto-pruned
+
+Use when you learn something project-specific: a convention, a constraint, a team decision, a recurring pattern.
+
+### `wunderkind_search_memories`
+Find past knowledge relevant to your current task.
+- `query` (required): what to look for
+
+Use at the start of a task to check what you already know about the domain.
+
+### `wunderkind_count_memories`
+Get a summary of your stored memories (count, oldest, newest, pinned count).
+
+Use to understand the state of your memory before deciding to prune.
+
+### `wunderkind_reduce_noise`
+Analyze and optionally prune stale memories.
+- `confirm` (optional): false = preview only (default), true = actually prune
+
+Memories older than 30 days that are not pinned are considered stale. Always preview first, then ask the user before confirming.
+
+## When to Use Memory
+
+- **Start of task**: call `wunderkind_search_memories` with the task domain to surface relevant past knowledge
+- **After learning**: call `wunderkind_take_note` to preserve new project facts
+- **Pin important facts**: security policies, architectural decisions, hard constraints → use `pin: true`
+- **Periodic housekeeping**: run `wunderkind_reduce_noise` to review what can be dropped
+
+## Memory Lifecycle
+
+1. Agent learns a project fact
+2. Calls `wunderkind_take_note` → saved to `.wunderkind/memory/<agent>.md` (or DB if configured)
+3. Next session: calls `wunderkind_search_memories` → retrieves relevant knowledge
+4. Over time: calls `wunderkind_reduce_noise` → surfaces stale entries → user confirms pruning
+
+## Adapter Transparency
+
+The memory system is adapter-agnostic. The configured adapter (`file`, `sqlite`, or `mem0`) is set in `wunderkind.config.jsonc`. You do not need to know which adapter is active — the tools behave identically.