@bubstack/moe-memory 0.1.0

package/dist/types.js

@@ -0,0 +1,32 @@
+/**
+ * The two record types.
+ *
+ * A **conversation exchange** is harvested: sync copies a transcript out of
+ * `~/.claude/projects` or `~/.codex/sessions` and the indexer derives rows from
+ * it. Nobody chose to write it down.
+ *
+ * A **journal entry** is deliberate: the model called `process_thoughts` and a
+ * markdown file was written. It is authored content with different privacy
+ * properties — a project entry belongs to the codebase, a user entry belongs to
+ * the person.
+ *
+ * They share one encoder and one SQLite file and nothing else. Distinct tables,
+ * distinct MCP tools, distinct result types. This file is where that boundary
+ * is stated.
+ *
+ * Reconciliation note: private-journal-mcp's own `types.ts` was entirely dead —
+ * `JournalEntry`, `ServerConfig` and `ProcessThoughtsRequest` had zero importers
+ * anywhere in its src or tests, while its live journal shape was retyped inline
+ * in four places. The names below are re-established as the single declaration
+ * those four sites now share.
+ */
+/** The rendered `## Heading` for each thought category, in entry order. */
+export const JOURNAL_SECTION_HEADINGS = [
+    ["reflections", "Reflections"],
+    ["observations", "Observations"],
+    ["project_notes", "Project Notes"],
+    ["user_context", "User Context"],
+    ["technical_insights", "Technical Insights"],
+    ["world_knowledge", "World Knowledge"],
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA4FH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAmD;IACtF,CAAC,aAAa,EAAE,aAAa,CAAC;IAC9B,CAAC,cAAc,EAAE,cAAc,CAAC;IAChC,CAAC,eAAe,EAAE,eAAe,CAAC;IAClC,CAAC,cAAc,EAAE,cAAc,CAAC;IAChC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAC5C,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CACvC,CAAC"}

package/dist/verify.d.ts

@@ -0,0 +1,30 @@
+export interface VerificationResult {
+    missing: Array<{
+        path: string;
+        reason: string;
+    }>;
+    orphaned: Array<{
+        uuid: string;
+        path: string;
+    }>;
+    outdated: Array<{
+        path: string;
+        fileTime: number;
+        dbTime: number;
+    }>;
+    corrupted: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+export declare function verifyIndex(): Promise<VerificationResult>;
+export interface RepairOptions {
+    /**
+     * Skip AI summary generation. Mirrors `moe-memory index --no-summaries`, which
+     * every other indexing entry point already had; `repair` did not, so its only
+     * code path required live Claude auth.
+     */
+    noSummaries?: boolean | undefined;
+}
+export declare function repairIndex(issues: VerificationResult, options?: RepairOptions): Promise<void>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA2G/D;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Ff"}

package/dist/verify.js

@@ -0,0 +1,174 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getAllExchanges, getFileLastIndexed, initDatabase } from "./db.js";
+import { parseConversation } from "./parser.js";
+import { findJsonlFiles, getArchiveDir, getExcludedProjects } from "./paths.js";
+import { isErroredSentinel } from "./summary-sentinel.js";
+export async function verifyIndex() {
+    const result = {
+        missing: [],
+        orphaned: [],
+        outdated: [],
+        corrupted: [],
+    };
+    const archiveDir = getArchiveDir();
+    // Track all files we find
+    const foundFiles = new Set();
+    // Find all conversation files
+    if (!fs.existsSync(archiveDir)) {
+        return result;
+    }
+    // Initialize database once for all checks
+    const db = initDatabase();
+    const projects = fs.readdirSync(archiveDir);
+    const excludedProjects = getExcludedProjects();
+    const excludedDirSet = new Set(excludedProjects);
+    let totalChecked = 0;
+    for (const project of projects) {
+        if (excludedProjects.includes(project)) {
+            console.log(`\nSkipping excluded project: ${project}`);
+            continue;
+        }
+        const projectPath = path.join(archiveDir, project);
+        const stat = fs.statSync(projectPath);
+        if (!stat.isDirectory())
+            continue;
+        const files = findJsonlFiles(projectPath, excludedDirSet);
+        for (const file of files) {
+            totalChecked++;
+            if (totalChecked % 100 === 0) {
+                console.log(`  Checked ${totalChecked} conversations...`);
+            }
+            const conversationPath = path.join(projectPath, file);
+            foundFiles.add(conversationPath);
+            const summaryPath = conversationPath.replace(".jsonl", "-summary.txt");
+            // Check for missing or errored summary. An error sentinel (#96) means a
+            // previous summarization failed — verify treats it as "missing" so repair
+            // re-attempts it rather than reporting the conversation as healthy.
+            if (!fs.existsSync(summaryPath)) {
+                result.missing.push({ path: conversationPath, reason: "No summary file" });
+                continue;
+            }
+            if (isErroredSentinel(fs.readFileSync(summaryPath, "utf-8"))) {
+                result.missing.push({
+                    path: conversationPath,
+                    reason: "Previous summarization failed (error sentinel)",
+                });
+                continue;
+            }
+            // Check if file is outdated (modified after last_indexed)
+            const lastIndexed = getFileLastIndexed(db, conversationPath);
+            if (lastIndexed !== null) {
+                const fileStat = fs.statSync(conversationPath);
+                if (fileStat.mtimeMs > lastIndexed) {
+                    result.outdated.push({
+                        path: conversationPath,
+                        fileTime: fileStat.mtimeMs,
+                        dbTime: lastIndexed,
+                    });
+                }
+            }
+            // Try parsing to detect corruption
+            try {
+                await parseConversation(conversationPath, project, conversationPath);
+            }
+            catch (error) {
+                result.corrupted.push({
+                    path: conversationPath,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    console.log(`Verified ${totalChecked} conversations.`);
+    // Check for orphaned database entries
+    const dbExchanges = getAllExchanges(db);
+    db.close();
+    for (const exchange of dbExchanges) {
+        if (!foundFiles.has(exchange.archivePath)) {
+            result.orphaned.push({
+                uuid: exchange.id,
+                path: exchange.archivePath,
+            });
+        }
+    }
+    return result;
+}
+export async function repairIndex(issues, options = {}) {
+    console.log("Repairing index...");
+    // To avoid circular dependencies, we import the indexer functions dynamically
+    const { initDatabase, insertExchange, deleteExchange } = await import("./db.js");
+    const { parseConversation } = await import("./parser.js");
+    const { initEmbeddings, generateExchangeEmbedding } = await import("./embeddings.js");
+    const { summarizeConversation } = await import("./summarizer.js");
+    const { formatErrorSentinel } = await import("./summary-sentinel.js");
+    const db = initDatabase();
+    await initEmbeddings();
+    // Remove orphaned entries first
+    for (const orphan of issues.orphaned) {
+        console.log(`Removing orphaned entry: ${orphan.uuid}`);
+        deleteExchange(db, orphan.uuid);
+    }
+    // Re-index missing and outdated conversations
+    const toReindex = [...issues.missing.map((m) => m.path), ...issues.outdated.map((o) => o.path)];
+    for (const conversationPath of toReindex) {
+        console.log(`Re-indexing: ${conversationPath}`);
+        try {
+            // Extract project name from path
+            const archiveDir = getArchiveDir();
+            const relativePath = conversationPath.replace(archiveDir + path.sep, "");
+            const project = relativePath.split(path.sep)[0] ?? "unknown";
+            // Parse conversation
+            const exchanges = await parseConversation(conversationPath, project, conversationPath);
+            if (exchanges.length === 0) {
+                console.log(`  Skipped (no exchanges)`);
+                continue;
+            }
+            // Generate/update summary.
+            //
+            // A summarizer failure no longer aborts the re-index. Upstream this whole
+            // block was one try/catch, so a transient API error meant the exchanges
+            // were never indexed either — which made repair the one indexing path that
+            // could not run without live Claude auth. It now writes the same error
+            // sentinel the indexer and sync write (#96) and carries on.
+            const summaryPath = conversationPath.replace(".jsonl", "-summary.txt");
+            if (options.noSummaries) {
+                console.log("  Skipping summary (--no-summaries)");
+            }
+            else {
+                try {
+                    const summary = await summarizeConversation(exchanges);
+                    fs.writeFileSync(summaryPath, summary, "utf-8");
+                    console.log(`  Created summary: ${summary.split(/\s+/).length} words`);
+                }
+                catch (error) {
+                    try {
+                        fs.writeFileSync(summaryPath, formatErrorSentinel(error), "utf-8");
+                    }
+                    catch { }
+                    console.log(`  Summary failed, continuing with index: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            // Index exchanges
+            for (const exchange of exchanges) {
+                const toolNames = exchange.toolCalls?.map((tc) => tc.toolName);
+                const embedding = await generateExchangeEmbedding(exchange.userMessage, exchange.assistantMessage, toolNames);
+                insertExchange(db, exchange, embedding, toolNames);
+            }
+            console.log(`  Indexed ${exchanges.length} exchanges`);
+        }
+        catch (error) {
+            console.error(`Failed to re-index ${conversationPath}:`, error);
+        }
+    }
+    db.close();
+    // Report corrupted files (manual intervention needed)
+    if (issues.corrupted.length > 0) {
+        console.log("\n⚠️  Corrupted files (manual review needed):");
+        for (const c of issues.corrupted) {
+            console.log(`  ${c.path}: ${c.error}`);
+        }
+    }
+    console.log("✅ Repair complete.");
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The package version, reported to MCP clients and to `moe-memory --version`.
+ *
+ * Upstream this file was GENERATED by `scripts/generate-version.js`, wired in
+ * through npm's `prebuild` and `pretest` lifecycle hooks, and gitignored — so it
+ * was absent from the pinned snapshot and a fresh checkout could neither
+ * typecheck nor test until the generator had run. Under turbo and `tsc -b` there
+ * is no npm lifecycle hook to hang a generator on, so it is a checked-in
+ * constant instead. `test/version-consistency.test.ts` asserts it equals
+ * package.json, which is the invariant the generator existed to guarantee.
+ */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,13 @@
+/**
+ * The package version, reported to MCP clients and to `moe-memory --version`.
+ *
+ * Upstream this file was GENERATED by `scripts/generate-version.js`, wired in
+ * through npm's `prebuild` and `pretest` lifecycle hooks, and gitignored — so it
+ * was absent from the pinned snapshot and a fresh checkout could neither
+ * typecheck nor test until the generator had run. Under turbo and `tsc -b` there
+ * is no npm lifecycle hook to hang a generator on, so it is a checked-in
+ * constant instead. `test/version-consistency.test.ts` asserts it equals
+ * package.json, which is the invariant the generator existed to guarantee.
+ */
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/dist/cli.js\" sync --background"
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@bubstack/moe-memory",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Semantic recall over past sessions and journal entries. One MCP server.",
+  "license": "MIT",
+  "author": {
+    "name": "Zak Keown",
+    "email": "zak.keown@outlook.com"
+  },
+  "homepage": "https://gitlab.com/moe-ai/moe",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/moe-ai/moe.git"
+  },
+  "keywords": [
+    "claude-code",
+    "codex",
+    "conversations",
+    "journal",
+    "search",
+    "semantic-search",
+    "embeddings"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "moe-memory": "./dist/cli.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "agents",
+    "hooks",
+    "prompts",
+    "skills",
+    ".mcp.json"
+  ],
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.126",
+    "@huggingface/transformers": "^4.2.0",
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "better-sqlite3": "^12.4.1",
+    "marked": "^16.4.0",
+    "proper-lockfile": "^4.1.2",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "zod": "^4.4.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^24.7.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc -b && node ../../scripts/copy-license.mjs MIT dist/LICENSE",
+    "typecheck": "tsc -b --pretty && tsc -p tsconfig.tests.json --pretty",
+    "test": "vitest run --project unit",
+    "test:model": "vitest run --project model",
+    "test:claude-e2e": "node test/manual/claude-e2e.js",
+    "test:codex-e2e": "node test/manual/codex-e2e.js",
+    "lint": "biome check ."
+  }
+}

package/prompts/search-agent.md

@@ -0,0 +1,160 @@
+# Conversation Search Agent
+
+You are searching historical Claude Code and Codex conversations for relevant context.
+
+**Your task:**
+1. Search conversations for: {TOPIC}
+2. Read the top 2-5 most relevant results
+3. Synthesize key findings (max 1000 words)
+4. Return synthesis + source pointers (so main agent can dig deeper)
+
+## Search Query
+
+{SEARCH_QUERY}
+
+## What to Look For
+
+{FOCUS_AREAS}
+
+Example focus areas:
+- What was the problem or question?
+- What solution was chosen and why?
+- What alternatives were considered and rejected?
+- Any gotchas, edge cases, or lessons learned?
+- Relevant code patterns, APIs, or approaches used
+- Architectural decisions and rationale
+
+## How to Search
+
+Use the MCP tool `search_conversations`:
+```
+mcp__plugin_moe-memory_moe-memory__search_conversations
+  query: "{SEARCH_QUERY}"
+  mode: "both"  # or "vector" (default) or "text"
+  limit: 10
+```
+
+This returns:
+- Project name and date
+- Conversation summary (AI-generated)
+- Matched exchange with similarity score
+- File path and line numbers
+
+Read the full conversations for top 2-5 results using `read_conversation` to get complete context.
+
+## Output Format
+
+**Required structure:**
+
+### Summary
+[Synthesize findings in 200-1000 words. Adapt structure to what you found:
+- Quick answer? 1-2 paragraphs.
+- Complex topic? Use sections (Context/Solution/Rationale/Lessons/Code).
+- Multiple approaches? Compare and contrast.
+- Historical evolution? Show progression chronologically.
+
+Focus on actionable insights for the current task.]
+
+### Sources
+[List ALL conversations examined, in order of relevance:]
+
+**1. [project-name, YYYY-MM-DD]** - X% match
+Conversation summary: [One sentence - what was this conversation about?]
+File: ~/.config/moe/memory/conversation-archive/.../uuid.jsonl:start-end
+Status: [Read in detail | Reviewed summary only | Skimmed]
+
+**2. [project-name, YYYY-MM-DD]** - X% match
+Conversation summary: ...
+File: ...
+Status: ...
+
+[Continue for all examined sources...]
+
+### For Follow-Up
+
+Main agent can:
+- Ask you to dig deeper into specific source (#1, #2, etc.)
+- Ask you to read adjacent exchanges in a conversation
+- Ask you to search with refined query
+- Read sources directly (discouraged - risks context bloat)
+
+## Critical Rules
+
+**DO:**
+- Search using the provided query
+- Read full conversations for top results
+- Synthesize into actionable insights (200-1000 words)
+- Include ALL sources with metadata (project, date, summary, file, status)
+- Focus on what will help the current task
+- Include specific details (function names, error messages, line numbers)
+
+**DO NOT:**
+- Include raw conversation excerpts (synthesize instead)
+- Paste full file contents
+- Add meta-commentary ("I searched and found...")
+- Exceed 1000 words in Summary section
+- Return search results verbatim
+
+## Example Output
+
+```
+### Summary
+
+developer needed to handle authentication errors in React Router 7 data loaders
+without crashing the app. The solution uses RR7's errorElement + useRouteError()
+to catch 401s and redirect to login.
+
+**Key implementation:**
+Protected route wrapper catches loader errors, checks error.status === 401.
+If 401, redirects to /login with return URL. Otherwise shows error boundary.
+
+**Why this works:**
+Loaders can't use hooks (tried useNavigate, failed). Throwing redirect()
+bypasses error handling. Final approach lets errors bubble to errorElement
+where component context is available.
+
+**Critical gotchas:**
+- Test with expired tokens, not just missing tokens
+- Error boundaries need unique keys per route or won't reset
+- Always include return URL in redirect
+- Loaders execute before components, no hook access
+
+**Code pattern:**
+```typescript
+// In loader
+if (!response.ok) throw { status: response.status, message: 'Failed' };
+
+// In ErrorBoundary
+const error = useRouteError();
+if (error.status === 401) navigate('/login?return=' + location.pathname);
+```
+
+### Sources
+
+**1. [react-router-7-starter, 2024-09-17]** - 92% match
+Conversation summary: Built authentication system with JWT, implemented protected routes
+File: ~/.config/moe/memory/conversation-archive/react-router-7-starter/19df92b9.jsonl:145-289
+Status: Read in detail (multiple exchanges on error handling evolution)
+
+**2. [react-router-docs-reading, 2024-09-10]** - 78% match
+Conversation summary: Read RR7 docs, discussed new loader patterns and errorElement
+File: ~/.config/moe/memory/conversation-archive/react-router-docs-reading/a3c871f2.jsonl:56-98
+Status: Reviewed summary only (confirmed errorElement usage)
+
+**3. [auth-debugging, 2024-09-18]** - 73% match
+Conversation summary: Fixed token expiration handling and error boundary reset issues
+File: ~/.config/moe/memory/conversation-archive/react-router-7-starter/7b2e8d91.jsonl:201-345
+Status: Read in detail (discovered gotchas about keys and expired tokens)
+
+### For Follow-Up
+
+Main agent can ask me to:
+- Dig deeper into source #1 (full error handling evolution)
+- Read adjacent exchanges in #3 (more debugging context)
+- Search for "React Router error boundary patterns" more broadly
+```
+
+This output:
+- Synthesis: ~350 words (actionable, specific)
+- Sources: Full metadata for 3 conversations
+- Enables iteration without context bloat