@bubstack/moe-memory 0.1.0

package/dist/paths.js

@@ -0,0 +1,258 @@
+/** Path resolution for transcript archives, indexes, and journals. */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** Project-local journal directory name. */
+export const JOURNAL_DIR_NAME = ".moe-journal";
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+/**
+ * Get the Claude Code configuration directory.
+ * Supports CLAUDE_CONFIG_DIR for multiple profiles.
+ * Falls back to ~/.claude when not set.
+ */
+export function getClaudeDir() {
+    return process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+}
+/**
+ * Get the Codex configuration directory.
+ * Supports CODEX_HOME for alternate profiles.
+ * Falls back to ~/.codex when not set.
+ */
+export function getCodexDir() {
+    return process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
+}
+/**
+ * Get all directories where supported harnesses store conversation files.
+ * Checks Claude Code legacy (projects/) and current (transcripts/) locations,
+ * plus Codex sessions.
+ * Returns only directories that exist.
+ */
+export function getConversationSourceDirs() {
+    const testDir = process.env.TEST_PROJECTS_DIR;
+    if (testDir)
+        return [testDir];
+    const claudeDir = getClaudeDir();
+    const codexDir = getCodexDir();
+    return [
+        path.join(claudeDir, "projects"),
+        path.join(claudeDir, "transcripts"),
+        path.join(codexDir, "sessions"),
+    ].filter((d) => fs.existsSync(d));
+}
+/**
+ * Recursively find all .jsonl files under a directory.
+ * Returns paths relative to the given directory.
+ *
+ * `excludedDirNames` skips any subdirectory whose name matches an entry in
+ * the set, at any depth. Top-level project skipping at the caller is the
+ * usual case; this parameter handles nested directories like `subagents/`
+ * inside session UUIDs (#80).
+ */
+export function findJsonlFiles(dir, excludedDirNames) {
+    const results = [];
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+                results.push(entry.name);
+            }
+            else if (entry.isDirectory()) {
+                if (excludedDirNames?.has(entry.name))
+                    continue;
+                const subDir = path.join(dir, entry.name);
+                for (const f of findJsonlFiles(subDir, excludedDirNames)) {
+                    results.push(path.join(entry.name, f));
+                }
+            }
+        }
+    }
+    catch {
+        // Directory might not be readable
+    }
+    return results;
+}
+/**
+ * Get this package's data directory: archive, index, model cache, logs, locks
+ * and the user-global journal all live under it.
+ *
+ * Precedence:
+ * 1. MOE_MEMORY_CONFIG_DIR — this package's dir directly (also the test seam)
+ * 2. MOE_DATA_DIR/memory   — the shared cross-package Moe data root
+ * 3. XDG_CONFIG_HOME/moe/memory
+ * 4. ~/.config/moe/memory  (default)
+ */
+export function getMemoryDataDir() {
+    let dir;
+    if (process.env.MOE_MEMORY_CONFIG_DIR) {
+        dir = process.env.MOE_MEMORY_CONFIG_DIR;
+    }
+    else if (process.env.MOE_DATA_DIR) {
+        dir = path.join(process.env.MOE_DATA_DIR, "memory");
+    }
+    else {
+        const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+        if (xdgConfigHome) {
+            dir = path.join(xdgConfigHome, "moe", "memory");
+        }
+        else {
+            dir = path.join(os.homedir(), ".config", "moe", "memory");
+        }
+    }
+    return ensureDir(dir);
+}
+/**
+ * Get conversation archive directory
+ */
+export function getArchiveDir() {
+    // Allow test override
+    if (process.env.TEST_ARCHIVE_DIR) {
+        return ensureDir(process.env.TEST_ARCHIVE_DIR);
+    }
+    return ensureDir(path.join(getMemoryDataDir(), "conversation-archive"));
+}
+/**
+ * Get conversation index directory
+ */
+export function getIndexDir() {
+    return ensureDir(path.join(getMemoryDataDir(), "conversation-index"));
+}
+/**
+ * Where transformers.js caches the ONNX model.
+ *
+ * Upstream never set `env.cacheDir`, so the first `initEmbeddings()` fetched
+ * the model into whatever transformers.js defaults to — which under pnpm is a
+ * path inside the content-addressed store, shared across the workspace and
+ * possibly read-only in a container. Pinning it here keeps the download in one
+ * writable place that moves with `MOE_MEMORY_CONFIG_DIR`, which is what makes
+ * the encoder-dependent test project reproducible.
+ */
+export function getModelCacheDir() {
+    if (process.env.MOE_MEMORY_MODEL_CACHE_DIR) {
+        return ensureDir(process.env.MOE_MEMORY_MODEL_CACHE_DIR);
+    }
+    return ensureDir(path.join(getMemoryDataDir(), "models"));
+}
+/**
+ * Get database path. Both record types live in this one file.
+ */
+export function getDbPath() {
+    // Allow test override with direct DB path
+    const override = process.env.MOE_MEMORY_DB_PATH || process.env.TEST_DB_PATH;
+    if (override)
+        return override;
+    return path.join(getIndexDir(), "db.sqlite");
+}
+/**
+ * Get exclude config path
+ */
+export function getExcludeConfigPath() {
+    return path.join(getIndexDir(), "exclude.txt");
+}
+/**
+ * Get list of projects to exclude from indexing
+ * Configurable via env var or config file
+ */
+export function getExcludedProjects() {
+    // Check env variable first
+    if (process.env.CONVERSATION_SEARCH_EXCLUDE_PROJECTS) {
+        return process.env.CONVERSATION_SEARCH_EXCLUDE_PROJECTS.split(",").map((p) => p.trim());
+    }
+    // Check for config file
+    const configPath = getExcludeConfigPath();
+    if (fs.existsSync(configPath)) {
+        const content = fs.readFileSync(configPath, "utf-8");
+        return content
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith("#"));
+    }
+    // Default: no exclusions
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Journal paths
+// ---------------------------------------------------------------------------
+/** Read the journal-path override. */
+function journalPathOverride() {
+    return process.env.MOE_MEMORY_JOURNAL_PATH;
+}
+/**
+ * Resolve a writable directory for journal storage.
+ *
+ * The override wins outright, then cwd (unless cwd is a system root), then
+ * HOME, USERPROFILE, and the temp directories.
+ *
+ * @param subdirectory subdirectory name (e.g. `.moe-journal`)
+ * @param includeCurrentDirectory whether to consider the current working directory
+ */
+export function resolveJournalPath(subdirectory = JOURNAL_DIR_NAME, includeCurrentDirectory = true) {
+    const override = journalPathOverride();
+    if (override)
+        return override;
+    const possiblePaths = [];
+    // Try current working directory only if requested and it's reasonable
+    if (includeCurrentDirectory) {
+        try {
+            const cwd = process.cwd();
+            // Don't use root directories or other system directories
+            if (cwd !== "/" && cwd !== "C:\\" && cwd !== "/System" && cwd !== "/usr") {
+                possiblePaths.push(path.join(cwd, subdirectory));
+            }
+        }
+        catch {
+            // Ignore errors getting cwd
+        }
+    }
+    // Try home directories (cross-platform)
+    if (process.env.HOME) {
+        possiblePaths.push(path.join(process.env.HOME, subdirectory));
+    }
+    if (process.env.USERPROFILE) {
+        possiblePaths.push(path.join(process.env.USERPROFILE, subdirectory));
+    }
+    // Try temp directories as last resort
+    possiblePaths.push(path.join("/tmp", subdirectory));
+    if (process.env.TEMP) {
+        possiblePaths.push(path.join(process.env.TEMP, subdirectory));
+    }
+    if (process.env.TMP) {
+        possiblePaths.push(path.join(process.env.TMP, subdirectory));
+    }
+    return possiblePaths[0] ?? path.join("/tmp", subdirectory);
+}
+/**
+ * Project-local journal directory: `<project>/.moe-journal`.
+ * Per-project journals are a feature, not an accident — they are the half of
+ * the journal that belongs to the codebase you are in.
+ */
+export function resolveProjectJournalPath() {
+    return resolveJournalPath(JOURNAL_DIR_NAME, true);
+}
+/**
+ * User-global journal directory.
+ *
+ * It lives at `<data dir>/journal`, alongside the conversation archive and
+ * index. `MOE_MEMORY_JOURNAL_PATH` overrides it.
+ */
+export function resolveUserJournalPath() {
+    const override = journalPathOverride();
+    if (override)
+        return override;
+    return path.join(getMemoryDataDir(), "journal");
+}
+/**
+ * The journal roots to read, resolved and de-duplicated.
+ */
+export function journalRoots() {
+    const roots = [path.resolve(resolveProjectJournalPath()), path.resolve(resolveUserJournalPath())];
+    return [...new Set(roots)];
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/search-cli.d.ts

@@ -0,0 +1,3 @@
+/** `moe-memory search` — conversation search from the terminal. */
+export declare function runSearch(args: string[]): Promise<number>;
+//# sourceMappingURL=search-cli.d.ts.map

package/dist/search-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-cli.d.ts","sourceRoot":"","sources":["../src/search-cli.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAkDnE,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyF/D"}

package/dist/search-cli.js

@@ -0,0 +1,138 @@
+/** `moe-memory search` — conversation search from the terminal. */
+import { formatMultiConceptResults, formatResults, searchConversations, searchMultipleConcepts, } from "./search.js";
+const HELP = `
+Usage: moe-memory search [OPTIONS] <query>
+
+Search indexed conversations using semantic similarity or exact text matching.
+For journal entries, use \`moe-memory journal search\`.
+
+MODES:
+  (default)      Combined vector + text search
+  --vector       Vector similarity only (semantic)
+  --text         Exact string matching only (for git SHAs, error codes)
+
+OPTIONS:
+  --after DATE          Only conversations after YYYY-MM-DD
+  --before DATE         Only conversations before YYYY-MM-DD
+  --project NAME        Filter by project name (exact match)
+  --session-id ID       Filter by session ID (exact match)
+  --git-branch BRANCH   Filter by git branch name (exact match)
+  --limit N             Max results (default: 10)
+  --help, -h            Show this help
+
+EXAMPLES:
+  # Semantic search
+  moe-memory search "React Router authentication errors"
+
+  # Find exact string
+  moe-memory search --text "a1b2c3d4e5f6"
+
+  # Time filtering
+  moe-memory search --after 2025-09-01 "refactoring"
+
+  # Filter to one project
+  moe-memory search --project my-app "auth flow"
+
+  # Filter to one git branch
+  moe-memory search --git-branch feature/login "validation"
+
+  # Multi-concept search (AND - all concepts must match)
+  moe-memory search "React Router" "authentication" "JWT"
+`;
+export async function runSearch(args) {
+    let mode = "both";
+    let after;
+    let before;
+    let project;
+    let sessionId;
+    let gitBranch;
+    let limit = 10;
+    const queries = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            console.log(HELP);
+            return 0;
+        }
+        if (arg === "--vector") {
+            mode = "vector";
+        }
+        else if (arg === "--text") {
+            mode = "text";
+        }
+        else if (arg === "--both") {
+            mode = "both";
+        }
+        else if (arg === "--after") {
+            after = args[++i];
+        }
+        else if (arg === "--before") {
+            before = args[++i];
+        }
+        else if (arg === "--project") {
+            project = args[++i];
+        }
+        else if (arg === "--session-id") {
+            sessionId = args[++i];
+        }
+        else if (arg === "--git-branch") {
+            gitBranch = args[++i];
+        }
+        else if (arg === "--limit") {
+            const raw = args[++i];
+            const parsed = raw === undefined ? Number.NaN : Number.parseInt(raw, 10);
+            // An empty or non-numeric --limit used to become NaN and silently break
+            // the query. Reject it instead.
+            if (!Number.isFinite(parsed) || parsed < 1) {
+                console.error(`Invalid --limit value: ${raw ?? "(missing)"}`);
+                return 1;
+            }
+            limit = parsed;
+        }
+        else if (arg !== undefined) {
+            // All non-flag args are query terms
+            queries.push(arg);
+        }
+    }
+    if (queries.length === 0) {
+        console.error("Usage: moe-memory search [OPTIONS] <query> [query2] [query3]...");
+        console.error("Try: moe-memory search --help");
+        return 1;
+    }
+    try {
+        // Multi-concept search if multiple queries provided
+        if (queries.length > 1) {
+            const options = {
+                limit,
+                after,
+                before,
+                project,
+                session_id: sessionId,
+                git_branch: gitBranch,
+            };
+            const results = await searchMultipleConcepts(queries, options);
+            console.log(await formatMultiConceptResults(results, queries));
+            return 0;
+        }
+        const options = {
+            mode,
+            limit,
+            after,
+            before,
+            project,
+            session_id: sessionId,
+            git_branch: gitBranch,
+        };
+        const first = queries[0];
+        if (first === undefined)
+            return 1;
+        const results = await searchConversations(first, options);
+        console.log(await formatResults(results));
+        return 0;
+    }
+    catch (error) {
+        console.error("Error searching:", error);
+        return 1;
+    }
+}
+//# sourceMappingURL=search-cli.js.map

package/dist/search-cli.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Conversation-exchange retrieval: sqlite-vec KNN, SQL LIKE, or both.
+ *
+ * This is the implementation that WON the reconciliation. private-journal-mcp's
+ * `search.ts` scanned every `.embedding` JSON sidecar into memory and scored it
+ * in JS; journal entries now get rows in the same store and are queried through
+ * journal/search.ts, which reuses `l2DistanceToCosineSimilarity` from here.
+ */
+import type { MultiConceptResult, SearchResult } from "./types.js";
+export interface SearchOptions {
+    limit?: number | undefined;
+    mode?: "vector" | "text" | "both" | undefined;
+    after?: string | undefined;
+    before?: string | undefined;
+    project?: string | undefined;
+    session_id?: string | undefined;
+    git_branch?: string | undefined;
+}
+/**
+ * Convert an L2 (Euclidean) distance between two unit-normalized vectors
+ * into a cosine similarity in [-1, 1].
+ *
+ * For unit vectors u, v:  ||u - v||^2 = 2 - 2 * cos(u, v)
+ * Therefore:               cos(u, v) = 1 - d^2 / 2
+ *
+ * ⚠️ Valid ONLY because src/embeddings.ts passes `normalize: true`. That coupling
+ * is invisible to the compiler: flip normalisation and every score here is
+ * silently wrong with no type error and no exception. Both record types share the
+ * encoder, so both share this constraint — journal/search.ts calls this function.
+ */
+export declare function l2DistanceToCosineSimilarity(distance: number): number;
+export declare function searchConversations(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+export declare function formatResults(results: SearchResult[]): Promise<string>;
+export declare function searchMultipleConcepts(concepts: string[], options?: Omit<SearchOptions, "mode">): Promise<MultiConceptResult[]>;
+export declare function formatMultiConceptResults(results: MultiConceptResult[], concepts: string[]): Promise<string>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAwB,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAmHD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrE;AAgBD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAyGzB;AAgDD,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C5E;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAM,GACxC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA8D/B;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,kBAAkB,EAAE,EAC7B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,MAAM,CAAC,CAyCjB"}