opensquid 0.5.395

package/dist/rag/backends/claude_auto_memory.js

@@ -0,0 +1,152 @@
+/**
+ * claude-auto-memory RAG backend: wraps Claude Code's own auto-memory
+ * directory (`~/.claude/projects/<slug>/memory/`) as a `RagBackend`.
+ *
+ * This is the strategic adapter — opensquid sits on TOP of Claude Code's
+ * auto-memory storage rather than competing with it. Users who already
+ * rely on Claude's per-project memory get opensquid's runtime + workflow
+ * + wedge gate without migrating data. `embed()` is a no-op because the
+ * adapter does not own the embedding pipeline (Claude Code's own
+ * vectorizer, if any, is opaque); `recall()` is naive substring search
+ * over the directory's `.md` files for Phase 1. Phase 2+ may upgrade to
+ * semantic recall if Anthropic exposes the auto-memory vectorizer.
+ *
+ * `MEMORY.md` is treated as an index (Claude Code maintains it) and
+ * excluded from recall hits — including it would surface index-summary
+ * matches as if they were lessons.
+ *
+ * Path containment is enforced on `storeLesson`: a `lesson.id` containing
+ * `..` segments must NOT escape the resolved memory dir. We resolve the
+ * target file, take its `relative` path from the resolved dir, and reject
+ * any result that starts with `..` (or contains a `..` segment). This is
+ * the only write surface the adapter exposes, so this check is the only
+ * traversal gate needed.
+ *
+ * `CLAUDE_PROJECT_DIR` is required at init — there is no sensible default.
+ * Cross-project leak (resolving to another project's memory) is prevented
+ * by failing loudly when the env var is unset, rather than guessing.
+ *
+ * Imports from: node:fs/promises, node:os, node:path, ../types.js.
+ * Imported by: src/rag/backend_factory.ts.
+ */
+import { mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises';
+import * as os from 'node:os';
+import { basename, join, relative, resolve } from 'node:path';
+import { UserAuthoredImmunityError } from '../types.js';
+/**
+ * Resolve the Claude Code auto-memory dir for the current project.
+ *
+ * Slug convention (matches Claude Code's own scheme observed at
+ * `~/.claude/projects/`): replace every `/` in the absolute project path
+ * with `-`. e.g. `/Users/slee/projects/loop` → `-Users-slee-projects-loop`.
+ *
+ * Throws if `CLAUDE_PROJECT_DIR` is unset — better to fail at init than
+ * silently write into a wrong-project memory dir or the current shell's
+ * cwd.
+ */
+export function projectMemoryDir() {
+    const projectDir = process.env.CLAUDE_PROJECT_DIR;
+    if (projectDir === undefined || projectDir === '') {
+        throw new Error('claude_auto_memory requires CLAUDE_PROJECT_DIR');
+    }
+    const slug = projectDir.replaceAll('/', '-');
+    // Namespace import (not named) so tests can `vi.spyOn(os, 'homedir')`
+    // and have the override take effect — a named import binds the
+    // function value at module load time and ignores later mutations.
+    return join(os.homedir(), '.claude', 'projects', slug, 'memory');
+}
+/**
+ * Assert that `file` resolves to a path inside `dir`. Defends against
+ * `lesson.id` values like `../../../etc/passwd` that would otherwise
+ * cause `storeLesson` to write outside the resolved memory dir.
+ *
+ * `resolve()` collapses `..` segments; `relative()` then tells us
+ * whether the result climbed out (`..` prefix) or stayed inside.
+ */
+function assertInDir(file, dir) {
+    const resolvedDir = resolve(dir);
+    const resolvedFile = resolve(file);
+    const rel = relative(resolvedDir, resolvedFile);
+    if (rel === '' || rel.startsWith('..') || rel.split(/[\\/]/).includes('..')) {
+        throw new Error(`claude_auto_memory: path traversal blocked: ${file}`);
+    }
+}
+export function claudeAutoMemoryBackend() {
+    let dir = '';
+    return {
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async init() {
+            // Resolve only; do not create. Claude Code creates the directory
+            // on its first auto-memory write. If we created it eagerly we'd
+            // litter `~/.claude/projects/` with empty dirs for any path the
+            // user happens to invoke opensquid from.
+            dir = projectMemoryDir();
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async embed() {
+            return null;
+        },
+        // `_scope` satisfies the RagBackend contract but is unused: this backend reads `projectMemoryDir()`
+        // (the CURRENT project's auto-memory dir), so isolation is inherent in the directory — no
+        // cross-project store to filter (T-memory-scope-isolation: documented out-of-scope backend).
+        async recall(query, k, _scope) {
+            // ENOENT → no memory yet for this project. Return [] rather than
+            // throwing so a fresh project doesn't blow up on first recall.
+            const files = await readdir(dir).catch(() => []);
+            const mds = files.filter((f) => f.endsWith('.md') && f !== 'MEMORY.md');
+            const lowered = query.toLowerCase();
+            const hits = [];
+            for (const f of mds) {
+                const content = await readFile(join(dir, f), 'utf8');
+                if (content.toLowerCase().includes(lowered)) {
+                    hits.push({
+                        lesson: {
+                            id: basename(f, '.md'),
+                            content,
+                            tags: [],
+                            source: f,
+                            author: 'user',
+                            createdAt: '',
+                        },
+                        score: 1,
+                        source: 'lexical',
+                    });
+                }
+                if (hits.length >= k)
+                    break;
+            }
+            return hits;
+        },
+        async storeLesson(lesson) {
+            await mkdir(dir, { recursive: true });
+            const target = join(dir, `${lesson.id}.md`);
+            // Reject any `lesson.id` that escapes the resolved memory dir.
+            assertInDir(target, dir);
+            const frontmatter = [
+                `---`,
+                `id: ${lesson.id}`,
+                `source: ${lesson.source}`,
+                `author: ${lesson.author}`,
+                `createdAt: ${lesson.createdAt}`,
+                `tags: [${lesson.tags.join(', ')}]`,
+                `---`,
+                ``,
+                lesson.content,
+            ].join('\n');
+            await writeFile(target, frontmatter, 'utf8');
+        },
+        async deleteLesson(id, delOpts) {
+            const target = join(dir, `${id}.md`);
+            assertInDir(target, dir); // reject a lesson.id escaping the resolved memory dir
+            const exists = await readFile(target, 'utf8').then(() => true, () => false);
+            if (!exists)
+                return { deleted: false, forced: false };
+            // Claude auto-memories are user-authored → eviction-immune; explicit force required.
+            if (!(delOpts?.force ?? false))
+                throw new UserAuthoredImmunityError(id);
+            await rm(target, { force: true });
+            return { deleted: true, forced: true };
+        },
+    };
+}
+//# sourceMappingURL=claude_auto_memory.js.map

package/dist/rag/backends/claude_auto_memory.js.map

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

package/dist/rag/backends/libsql_lexical.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fallback RAG backend: libsql + FTS5 only, no embedding.
+ *
+ * Used when Ollama is unavailable (no model pulled, network down, user opted
+ * out). `embed()` always returns `null`, `recall()` is keyword-only via
+ * SQLite FTS5 with the `unicode61` tokenizer. The same `lessons` /
+ * `lessons_fts` schema as `libsql-qwen3` so the two backends can share a
+ * dbUrl when the fallback wrapper swaps mid-session (Task 1.11) — the
+ * vector column on the qwen3 schema is simply ignored here.
+ *
+ * Self-contained FTS5 (not `content='lessons'` external-content) for the
+ * same reason as `libsql_qwen3.ts`: external-content needs mirroring
+ * triggers we don't have. We pay O(N) duplicate text storage to keep the
+ * write path a flat two-statement INSERT.
+ *
+ * FTS5 input sanitization here is the simple strip — drop `"` and `*` and
+ * trim, then pass the rest verbatim. That gives the user normal phrase
+ * search ("foo bar" matches docs containing both, in order) while
+ * preventing the two FTS5 syntax tokens that most easily produce
+ * `SqliteError: fts5: syntax error`. The qwen3 backend uses a stricter
+ * tokens-OR'd scheme because hybrid recall lives or dies on the lexical
+ * leg not raising; here the user asked for lexical-only, so we honor more
+ * of their query intent (preserving casing, stopwords, ordering hints).
+ *
+ * Imports from: @libsql/client, ../types.js.
+ * Imported by: src/rag/backend_factory.ts.
+ */
+import type { RagBackend } from '../types.js';
+export interface LibsqlLexicalOpts {
+    dbUrl: string;
+}
+export declare function libsqlLexicalBackend(opts: LibsqlLexicalOpts): RagBackend;
+//# sourceMappingURL=libsql_lexical.d.ts.map

package/dist/rag/backends/libsql_lexical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql_lexical.d.ts","sourceRoot":"","sources":["../../../src/rag/backends/libsql_lexical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAoC,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CA4GxE"}

package/dist/rag/backends/libsql_lexical.js

@@ -0,0 +1,164 @@
+/**
+ * Fallback RAG backend: libsql + FTS5 only, no embedding.
+ *
+ * Used when Ollama is unavailable (no model pulled, network down, user opted
+ * out). `embed()` always returns `null`, `recall()` is keyword-only via
+ * SQLite FTS5 with the `unicode61` tokenizer. The same `lessons` /
+ * `lessons_fts` schema as `libsql-qwen3` so the two backends can share a
+ * dbUrl when the fallback wrapper swaps mid-session (Task 1.11) — the
+ * vector column on the qwen3 schema is simply ignored here.
+ *
+ * Self-contained FTS5 (not `content='lessons'` external-content) for the
+ * same reason as `libsql_qwen3.ts`: external-content needs mirroring
+ * triggers we don't have. We pay O(N) duplicate text storage to keep the
+ * write path a flat two-statement INSERT.
+ *
+ * FTS5 input sanitization here is the simple strip — drop `"` and `*` and
+ * trim, then pass the rest verbatim. That gives the user normal phrase
+ * search ("foo bar" matches docs containing both, in order) while
+ * preventing the two FTS5 syntax tokens that most easily produce
+ * `SqliteError: fts5: syntax error`. The qwen3 backend uses a stricter
+ * tokens-OR'd scheme because hybrid recall lives or dies on the lexical
+ * leg not raising; here the user asked for lexical-only, so we honor more
+ * of their query intent (preserving casing, stopwords, ordering hints).
+ *
+ * Imports from: @libsql/client, ../types.js.
+ * Imported by: src/rag/backend_factory.ts.
+ */
+import { createClient } from '@libsql/client';
+import { inScope, UserAuthoredImmunityError } from '../types.js';
+export function libsqlLexicalBackend(opts) {
+    let client = null;
+    return {
+        async init() {
+            client = createClient({ url: opts.dbUrl });
+            // CREATE TABLE IF NOT EXISTS makes this safe to call on a db that
+            // libsql-qwen3 already initialized — the existing `embedding` column
+            // is just unused here, never read, never written.
+            await client.execute(`
+        CREATE TABLE IF NOT EXISTS lessons (
+          id TEXT PRIMARY KEY,
+          content TEXT NOT NULL,
+          tags TEXT NOT NULL,
+          source TEXT NOT NULL,
+          author TEXT NOT NULL,
+          created_at TEXT NOT NULL,
+          tier TEXT NOT NULL DEFAULT 'shared',
+          namespace TEXT
+        );
+      `);
+            // Additive scope columns for a pre-existing (qwen3-initialized) table. Idempotent.
+            for (const ddl of [
+                `ALTER TABLE lessons ADD COLUMN tier TEXT NOT NULL DEFAULT 'shared'`,
+                `ALTER TABLE lessons ADD COLUMN namespace TEXT`,
+            ]) {
+                try {
+                    await client.execute(ddl);
+                }
+                catch {
+                    /* already migrated */
+                }
+            }
+            await client.execute(`
+        CREATE VIRTUAL TABLE IF NOT EXISTS lessons_fts
+        USING fts5(id UNINDEXED, content, tags, source, tokenize='unicode61');
+      `);
+        },
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async embed() {
+            return null;
+        },
+        async recall(query, k, scope) {
+            if (!client)
+                throw new Error('libsql-lexical: not initialized');
+            const safe = sanitizeFts(query);
+            if (!safe)
+                return [];
+            try {
+                const rs = await client.execute({
+                    sql: `SELECT l.id, l.content, l.tags, l.source, l.author, l.created_at, l.tier, l.namespace
+                FROM lessons_fts f JOIN lessons l ON l.id = f.id
+                WHERE lessons_fts MATCH ? AND (l.tier = 'shared' OR l.namespace = ?)
+                LIMIT ?`,
+                    args: [safe, scope.namespace, k],
+                });
+                return rs.rows
+                    .map((r, i) => ({
+                    lesson: rowToLesson(r),
+                    score: 1 / (i + 1),
+                    source: 'lexical',
+                }))
+                    .filter((h) => inScope(h.lesson.tier, h.lesson.namespace, scope));
+            }
+            catch {
+                // Malformed FTS5 expression (rare, since we sanitize) — return [].
+                return [];
+            }
+        },
+        async storeLesson(lesson) {
+            if (!client)
+                throw new Error('libsql-lexical: not initialized');
+            const tagsJson = JSON.stringify(lesson.tags);
+            await client.execute({
+                sql: `INSERT INTO lessons (id, content, tags, source, author, created_at, tier, namespace)
+              VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+                args: [
+                    lesson.id,
+                    lesson.content,
+                    tagsJson,
+                    lesson.source,
+                    lesson.author,
+                    lesson.createdAt,
+                    (lesson.tier ?? 'shared'),
+                    lesson.namespace ?? null,
+                ],
+            });
+            // Mirror into FTS5 — separate statement, not a trigger, to stay
+            // portable across libsql builds (same rationale as libsql-qwen3).
+            await client.execute({
+                sql: `INSERT INTO lessons_fts (id, content, tags, source) VALUES (?, ?, ?, ?)`,
+                args: [lesson.id, lesson.content, tagsJson, lesson.source],
+            });
+        },
+        async deleteLesson(id, delOpts) {
+            if (!client)
+                throw new Error('libsql-lexical: not initialized');
+            const found = await client.execute({
+                sql: `SELECT author FROM lessons WHERE id = ?`,
+                args: [id],
+            });
+            if (found.rows.length === 0)
+                return { deleted: false, forced: false };
+            const isUser = found.rows[0]?.author === 'user';
+            const force = delOpts?.force ?? false;
+            if (isUser && !force)
+                throw new UserAuthoredImmunityError(id);
+            await client.execute({ sql: `DELETE FROM lessons WHERE id = ?`, args: [id] });
+            await client.execute({ sql: `DELETE FROM lessons_fts WHERE id = ?`, args: [id] });
+            return { deleted: true, forced: isUser && force };
+        },
+    };
+}
+// Strip the two FTS5 syntax tokens most likely to be in casual queries.
+// Anything left is parsed by FTS5 as a phrase / column-filter / operator
+// expression — that is the contract the user gets for lexical-only mode.
+function sanitizeFts(query) {
+    return query.replace(/["*]/g, ' ').trim();
+}
+function s(r, key) {
+    const v = r[key];
+    return typeof v === 'string' ? v : '';
+}
+function rowToLesson(r) {
+    return {
+        id: s(r, 'id'),
+        content: s(r, 'content'),
+        tags: JSON.parse(s(r, 'tags') || '[]'),
+        source: s(r, 'source'),
+        author: s(r, 'author') === 'user' ? 'user' : 'agent',
+        createdAt: s(r, 'created_at'),
+        tier: s(r, 'tier') === 'project' ? 'project' : 'shared',
+        namespace: typeof r.namespace === 'string' ? r.namespace : null,
+    };
+}
+//# sourceMappingURL=libsql_lexical.js.map

package/dist/rag/backends/libsql_lexical.js.map

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

package/dist/rag/backends/libsql_qwen3.d.ts

@@ -0,0 +1,8 @@
+import type { RagBackend } from '../types.js';
+export interface LibsqlQwen3Opts {
+    dbUrl: string;
+    ollamaUrl: string;
+    embedderModel?: string;
+}
+export declare function libsqlQwen3Backend(opts: LibsqlQwen3Opts): RagBackend;
+//# sourceMappingURL=libsql_qwen3.d.ts.map

package/dist/rag/backends/libsql_qwen3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql_qwen3.d.ts","sourceRoot":"","sources":["../../../src/rag/backends/libsql_qwen3.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAQpE"}

package/dist/rag/backends/libsql_qwen3.js

@@ -0,0 +1,23 @@
+/**
+ * `libsql-qwen3` backend = the generalized libSQL store (`libsql_store.ts`) wired with the
+ * Ollama-Qwen3 embedder. T-STORE-FOUNDATION-LIBSQL extracted the embedder + the shared backend
+ * body into `libsql_store.ts` + `embedders/ollama_qwen3.ts`; this file preserves the original
+ * `libsqlQwen3Backend(opts)` signature so `backend_factory.ts` + existing tests are unchanged.
+ * Behavior is identical: the `embedderUp` degraded latch now lives in the embedder instance
+ * (created once per backend), so it is still shared across recall + storeLesson.
+ *
+ * Imports from: ../embedders/ollama_qwen3.js, ./libsql_store.js, ../types.js.
+ * Imported by: src/rag/backend_factory.ts.
+ */
+import { ollamaQwen3Embedder } from '../embedders/ollama_qwen3.js';
+import { libsqlStoreBackend } from './libsql_store.js';
+export function libsqlQwen3Backend(opts) {
+    return libsqlStoreBackend({
+        dbUrl: opts.dbUrl,
+        embedder: ollamaQwen3Embedder({
+            ollamaUrl: opts.ollamaUrl,
+            ...(opts.embedderModel === undefined ? {} : { model: opts.embedderModel }),
+        }),
+    });
+}
+//# sourceMappingURL=libsql_qwen3.js.map

package/dist/rag/backends/libsql_qwen3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql_qwen3.js","sourceRoot":"","sources":["../../../src/rag/backends/libsql_qwen3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAUvD,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,OAAO,kBAAkB,CAAC;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,mBAAmB,CAAC;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SAC3E,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/rag/backends/libsql_store.d.ts

@@ -0,0 +1,28 @@
+import type { Embedder } from '../embedders/types.js';
+import type { RagBackend } from '../types.js';
+export interface LibsqlStoreOpts {
+    dbUrl: string;
+    embedder: Embedder;
+    /**
+     * Optional per-file source-of-truth dir (T-STORE-PERFILE-SOURCE). When set, `storeLesson`
+     * writes `<sourceDir>/<id>.md` (the git-versionable truth) before upserting the DB index, and
+     * `rebuildLibsqlIndex` can reconstruct the index from it. When unset, the backend is DB-only
+     * (unchanged behavior — e.g. `:memory:` + the `libsql-qwen3` path).
+     */
+    sourceDir?: string;
+}
+export declare function libsqlStoreBackend(opts: LibsqlStoreOpts): RagBackend;
+/**
+ * Rebuild the libSQL index from the per-file source-of-truth (the files are authoritative; the
+ * DB is disposable). Drops + recreates the index tables first so records deleted from the source
+ * don't linger, then re-indexes every record. Idempotent — a crash mid-rebuild is recovered by
+ * re-running it (the source is never touched). Cold-path maintenance op (e.g. after a git
+ * pull/merge of the source); for file-backed `dbUrl`s, not `:memory:`.
+ */
+export declare function rebuildLibsqlIndex(opts: {
+    dbUrl: string;
+    embedder: Embedder;
+    sourceDir: string;
+}): Promise<number>;
+export declare function ftsEscape(query: string): string;
+//# sourceMappingURL=libsql_store.d.ts.map

package/dist/rag/backends/libsql_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql_store.d.ts","sourceRoot":"","sources":["../../../src/rag/backends/libsql_store.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAoC,UAAU,EAAa,MAAM,aAAa,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAgLpE;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAKD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C"}