skein-cli 0.1.0-alpha.1

package/dist/memory/sinks/claude-mem.js

@@ -0,0 +1,100 @@
+import { promises as fs } from 'node:fs';
+import { createRequire } from 'node:module';
+import { createHash } from 'node:crypto';
+import { dirname } from 'node:path';
+import { ensureDir } from '../../util/fs.js';
+import { redactText } from '../../redactor/index.js';
+import { claudeMemDbPath } from '../sources/claude-mem.js';
+const requireSqlite = createRequire(import.meta.url);
+let cachedSqlite;
+function loadSqlite() {
+    if (!cachedSqlite) {
+        cachedSqlite = requireSqlite('node:sqlite');
+    }
+    return cachedSqlite;
+}
+const OBSERVATIONS_SCHEMA = `
+CREATE TABLE IF NOT EXISTS observations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  memory_session_id TEXT NOT NULL,
+  project TEXT NOT NULL,
+  text TEXT,
+  type TEXT NOT NULL,
+  title TEXT,
+  facts TEXT,
+  narrative TEXT,
+  files_modified TEXT,
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+  content_hash TEXT,
+  agent_type TEXT,
+  agent_id TEXT,
+  metadata TEXT
+);
+CREATE UNIQUE INDEX IF NOT EXISTS ux_observations_session_hash
+  ON observations(memory_session_id, content_hash);
+`;
+export async function importIntoClaudeMem(memories, opts) {
+    const dbPath = claudeMemDbPath({
+        homeDir: opts.homeDir,
+        ...(opts.dataDir ? { dataDir: opts.dataDir } : {}),
+    });
+    let exists = true;
+    try {
+        await fs.access(dbPath);
+    }
+    catch {
+        exists = false;
+    }
+    if (!exists) {
+        if (!opts.createIfMissing) {
+            throw new Error(`claude-mem db not found at ${dbPath} (pass --create-if-missing to allow Skein to seed it)`);
+        }
+        await ensureDir(dirname(dbPath));
+    }
+    const { DatabaseSync } = loadSqlite();
+    const db = new DatabaseSync(dbPath);
+    let inserted = 0;
+    let skipped = 0;
+    try {
+        db.exec(OBSERVATIONS_SCHEMA);
+        db.exec('BEGIN');
+        const insert = db.prepare(`INSERT OR IGNORE INTO observations
+       (memory_session_id, project, text, type, title, facts, narrative,
+        files_modified, created_at, created_at_epoch, content_hash,
+        agent_type, agent_id, metadata)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        for (const memory of memories) {
+            const redacted = redactText(memory.fact).text;
+            const project = memory.project ?? 'global';
+            const sessionId = `skein-${memory.tool}`;
+            const contentHash = createHash('sha256')
+                .update(`${project}:${redacted}`)
+                .digest('hex')
+                .slice(0, 32);
+            const title = redacted.split('\n')[0]?.slice(0, 80) ?? '';
+            const createdAt = memory.updatedAt;
+            const createdAtEpoch = Date.parse(createdAt) || 0;
+            const result = insert.run(sessionId, project, redacted, memory.tags[0] ?? 'skein-import', title, JSON.stringify([]), '', JSON.stringify([]), createdAt, createdAtEpoch, contentHash, 'skein', memory.id, JSON.stringify({ tags: memory.tags, provenance: memory.provenance }));
+            if (result.changes > 0)
+                inserted += 1;
+            else
+                skipped += 1;
+        }
+        db.exec('COMMIT');
+    }
+    catch (err) {
+        try {
+            db.exec('ROLLBACK');
+        }
+        catch {
+            // already not in a tx
+        }
+        throw err;
+    }
+    finally {
+        db.close();
+    }
+    return { inserted, skipped, path: dbPath };
+}
+//# sourceMappingURL=claude-mem.js.map

package/dist/memory/sinks/claude-mem.js.map

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

package/dist/memory/sinks/codex.d.ts

@@ -0,0 +1,12 @@
+import type { Memory } from '../../schema/memory.js';
+export interface CodexSinkOptions {
+    homeDir: string;
+    dbPath?: string;
+    createIfMissing?: boolean;
+}
+export interface CodexImportResult {
+    inserted: number;
+    skipped: number;
+    path: string;
+}
+export declare function importIntoCodex(memories: Memory[], opts: CodexSinkOptions): Promise<CodexImportResult>;

package/dist/memory/sinks/codex.js

@@ -0,0 +1,82 @@
+import { promises as fs } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { ensureDir } from '../../util/fs.js';
+import { redactText } from '../../redactor/index.js';
+const requireSqlite = createRequire(import.meta.url);
+let cachedSqlite;
+function loadSqlite() {
+    if (!cachedSqlite) {
+        cachedSqlite = requireSqlite('node:sqlite');
+    }
+    return cachedSqlite;
+}
+const STAGE1_SCHEMA = `
+CREATE TABLE IF NOT EXISTS stage1_outputs (
+  thread_id TEXT PRIMARY KEY,
+  source_updated_at INTEGER NOT NULL,
+  raw_memory TEXT NOT NULL,
+  rollout_summary TEXT NOT NULL,
+  rollout_slug TEXT,
+  generated_at INTEGER NOT NULL,
+  usage_count INTEGER,
+  last_usage INTEGER,
+  selected_for_phase2 INTEGER NOT NULL DEFAULT 0,
+  selected_for_phase2_source_updated_at INTEGER
+);
+`;
+export async function importIntoCodex(memories, opts) {
+    const dbPath = opts.dbPath ?? join(opts.homeDir, '.codex', 'memories_1.sqlite');
+    let exists = true;
+    try {
+        await fs.access(dbPath);
+    }
+    catch {
+        exists = false;
+    }
+    if (!exists) {
+        if (!opts.createIfMissing) {
+            throw new Error(`Codex memories db not found at ${dbPath} (pass --create-if-missing to allow Skein to seed it)`);
+        }
+        await ensureDir(dirname(dbPath));
+    }
+    const { DatabaseSync } = loadSqlite();
+    const db = new DatabaseSync(dbPath);
+    let inserted = 0;
+    let skipped = 0;
+    try {
+        db.exec(STAGE1_SCHEMA);
+        db.exec('BEGIN');
+        const insert = db.prepare(`INSERT OR IGNORE INTO stage1_outputs
+       (thread_id, source_updated_at, raw_memory, rollout_summary, rollout_slug,
+        generated_at, usage_count, last_usage, selected_for_phase2)
+       VALUES (?, ?, ?, ?, ?, ?, 0, NULL, 0)`);
+        for (const memory of memories) {
+            const fact = redactText(memory.fact).text;
+            const threadId = `skein-${memory.id}`;
+            const summary = fact.split('\n')[0]?.slice(0, 200) ?? '';
+            const slug = memory.tags[0] ?? null;
+            const generatedAt = Date.parse(memory.updatedAt) || Date.now();
+            const result = insert.run(threadId, generatedAt, fact, summary, slug, generatedAt);
+            if (result.changes > 0)
+                inserted += 1;
+            else
+                skipped += 1;
+        }
+        db.exec('COMMIT');
+    }
+    catch (err) {
+        try {
+            db.exec('ROLLBACK');
+        }
+        catch {
+            // already not in a tx
+        }
+        throw err;
+    }
+    finally {
+        db.close();
+    }
+    return { inserted, skipped, path: dbPath };
+}
+//# sourceMappingURL=codex.js.map

package/dist/memory/sinks/codex.js.map

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

package/dist/memory/sinks/context.d.ts

@@ -0,0 +1,21 @@
+import type { Memory } from '../../schema/memory.js';
+/**
+ * Context-mode replay for cloud-only memory targets (ChatGPT, Cursor,
+ * Claude Desktop). Renders a markdown brief the user pastes into the
+ * target's memory UI. Memories are grouped by scope so the user can
+ * paste selectively.
+ *
+ * Every fact passes through the redactor a second time before landing
+ * on disk — defense in depth in case the caller passed an unredacted
+ * IR row.
+ */
+export interface ContextReplayInput {
+    memories: Memory[];
+    targetTool: string;
+    outPath?: string;
+}
+export interface ContextReplayResult {
+    path: string;
+    bytesWritten: number;
+}
+export declare function renderContextBrief(input: ContextReplayInput): Promise<ContextReplayResult>;

package/dist/memory/sinks/context.js

@@ -0,0 +1,42 @@
+import { promises as fs } from 'node:fs';
+import { resolve } from 'node:path';
+import { redactText } from '../../redactor/index.js';
+export async function renderContextBrief(input) {
+    const path = resolve(input.outPath ?? `./.skein-memory-${input.targetTool}.md`);
+    const body = buildBody(input);
+    const redacted = redactText(body).text;
+    await fs.writeFile(path, redacted, 'utf8');
+    return { path, bytesWritten: Buffer.byteLength(redacted, 'utf8') };
+}
+function buildBody(input) {
+    const lines = [];
+    lines.push(`# Skein memory brief for ${input.targetTool}`, '');
+    lines.push(`Paste these into your ${input.targetTool} memory store. They are grouped by scope so you can paste selectively.`, '');
+    const globals = input.memories.filter(m => m.scope === 'global');
+    if (globals.length > 0) {
+        lines.push('## Global preferences', '');
+        for (const memory of globals)
+            lines.push(formatMemory(memory));
+        lines.push('');
+    }
+    const projects = new Map();
+    for (const memory of input.memories) {
+        if (memory.scope !== 'project' || !memory.project)
+            continue;
+        if (!projects.has(memory.project))
+            projects.set(memory.project, []);
+        projects.get(memory.project).push(memory);
+    }
+    for (const [project, list] of projects) {
+        lines.push(`## Project: ${project}`, '');
+        for (const memory of list)
+            lines.push(formatMemory(memory));
+        lines.push('');
+    }
+    return lines.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+function formatMemory(memory) {
+    const tags = memory.tags.length > 0 ? ` _(${memory.tags.join(', ')})_` : '';
+    return `- ${memory.fact}${tags}`;
+}
+//# sourceMappingURL=context.js.map

package/dist/memory/sinks/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/memory/sinks/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAyBpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAyB;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,mBAAmB,KAAK,CAAC,UAAU,KAAK,CAAC,CAAA;IAC/E,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;IACtC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC1C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAA;AACpE,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC,CAAA;IAC9D,KAAK,CAAC,IAAI,CACR,yBAAyB,KAAK,CAAC,UAAU,wEAAwE,EACjH,EAAE,CACH,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAA;IAChE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAA;QACvC,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;QAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAA;IAC5C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,SAAQ;QAC3D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QACnE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IACD,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;QACxC,KAAK,MAAM,MAAM,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AACpD,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3E,OAAO,KAAK,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAA;AAClC,CAAC"}

package/dist/memory/sources/chatgpt.d.ts

@@ -0,0 +1,22 @@
+import { Buffer } from 'node:buffer';
+import { type Memory } from '../../schema/memory.js';
+/**
+ * ChatGPT account-data export reader.
+ *
+ * The account-data export ZIP carries a `user.json` (and sometimes a
+ * `memories.json` or `chat.html` mirror) with the cross-conversation
+ * memories the ChatGPT web/desktop tier maintains. Schema varies between
+ * exports; we accept any of:
+ *
+ *   - `user.json` with `memories: [{ id?, content, created_at? }]`
+ *   - `user.json` with `assistant_memory: { entries: [...] }`
+ *   - top-level `memories.json` array
+ *
+ * One Skein Memory per entry. `id` (or a SHA-shape fallback) is the
+ * sourceKey.
+ */
+export interface ChatgptMemoryReaderOptions {
+    zipPath?: string;
+    zipBuffer?: Buffer;
+}
+export declare function readChatgptMemories(opts: ChatgptMemoryReaderOptions): Promise<Memory[]>;

package/dist/memory/sources/chatgpt.js

@@ -0,0 +1,98 @@
+import { memoryId } from '../../schema/memory.js';
+import { MEMORY_SCHEMA } from '../../version.js';
+import { findEntry, findEntriesByExt, parseZip, readZipFile, } from '../../conv/zip.js';
+export async function readChatgptMemories(opts) {
+    const entries = await loadEntries(opts);
+    const raw = locateMemoryRoot(entries);
+    if (!raw)
+        return [];
+    return raw.map(entryToMemory).filter((m) => m !== undefined);
+}
+async function loadEntries(opts) {
+    if (opts.zipBuffer)
+        return parseZip(opts.zipBuffer);
+    if (opts.zipPath)
+        return readZipFile(opts.zipPath);
+    throw new Error('readChatgptMemories: pass either zipBuffer or zipPath');
+}
+function locateMemoryRoot(entries) {
+    const dedicated = findEntry(entries, 'memories.json');
+    if (dedicated) {
+        const parsed = safeJson(dedicated.body.toString('utf8'));
+        if (Array.isArray(parsed))
+            return parsed;
+        if (parsed && Array.isArray(parsed.memories))
+            return parsed.memories;
+    }
+    const userJson = findEntry(entries, 'user.json');
+    if (userJson) {
+        const parsed = safeJson(userJson.body.toString('utf8'));
+        const memories = extractMemoryArray(parsed);
+        if (memories)
+            return memories;
+    }
+    for (const candidate of findEntriesByExt(entries, '.json')) {
+        const parsed = safeJson(candidate.body.toString('utf8'));
+        const memories = extractMemoryArray(parsed);
+        if (memories)
+            return memories;
+    }
+    return undefined;
+}
+function extractMemoryArray(parsed) {
+    if (!parsed || typeof parsed !== 'object')
+        return undefined;
+    const root = parsed;
+    if (Array.isArray(root['memories']))
+        return root['memories'];
+    const assistant = root['assistant_memory'];
+    if (assistant && typeof assistant === 'object') {
+        const entries = assistant['entries'];
+        if (Array.isArray(entries))
+            return entries;
+    }
+    return undefined;
+}
+function entryToMemory(entry, index) {
+    const fact = (entry.content ?? entry.text ?? entry.body ?? entry.memory ?? '').toString().trim();
+    if (!fact)
+        return undefined;
+    const sourceKey = entry.id ?? `idx-${index}`;
+    const addedAt = normalizeTs(entry.created_at);
+    const updatedAt = normalizeTs(entry.updated_at) ?? addedAt;
+    return {
+        schema: MEMORY_SCHEMA,
+        id: memoryId('chatgpt', sourceKey),
+        tool: 'chatgpt',
+        scope: 'global',
+        fact,
+        tags: ['chatgpt'],
+        provenance: {
+            sourceTool: 'chatgpt',
+            sourcePath: 'export.zip',
+            sourceKey,
+            capturedAt: new Date().toISOString(),
+        },
+        addedAt: addedAt ?? new Date().toISOString(),
+        updatedAt: updatedAt ?? new Date().toISOString(),
+    };
+}
+function normalizeTs(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw === 'number')
+        return new Date(raw * 1000).toISOString();
+    const parsed = Date.parse(raw);
+    if (Number.isNaN(parsed))
+        return undefined;
+    return new Date(parsed).toISOString();
+}
+function safeJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=chatgpt.js.map

package/dist/memory/sources/chatgpt.js.map

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

package/dist/memory/sources/claude-mem.d.ts

@@ -0,0 +1,8 @@
+import { type Memory } from '../../schema/memory.js';
+export interface ClaudeMemReaderOptions {
+    homeDir: string;
+    /** Override the claude-mem data dir (default: env or ~/.claude-mem). */
+    dataDir?: string;
+}
+export declare function claudeMemDbPath(opts: ClaudeMemReaderOptions): string;
+export declare function readClaudeMemMemories(opts: ClaudeMemReaderOptions): Promise<Memory[]>;

package/dist/memory/sources/claude-mem.js

@@ -0,0 +1,104 @@
+import { promises as fs } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { memoryId } from '../../schema/memory.js';
+import { MEMORY_SCHEMA } from '../../version.js';
+const requireSqlite = createRequire(import.meta.url);
+let cachedSqlite;
+function loadSqlite() {
+    if (!cachedSqlite) {
+        cachedSqlite = requireSqlite('node:sqlite');
+    }
+    return cachedSqlite;
+}
+export function claudeMemDbPath(opts) {
+    const dataDir = opts.dataDir ?? process.env['CLAUDE_MEM_DATA_DIR'] ?? join(opts.homeDir, '.claude-mem');
+    return join(dataDir, 'claude-mem.db');
+}
+export async function readClaudeMemMemories(opts) {
+    const dbPath = claudeMemDbPath(opts);
+    try {
+        await fs.access(dbPath);
+    }
+    catch {
+        return [];
+    }
+    const { DatabaseSync } = loadSqlite();
+    const db = new DatabaseSync(dbPath, { readonly: true });
+    try {
+        const rows = db
+            .prepare(`SELECT id, memory_session_id, project, type, title, text, narrative,
+                facts, concepts, files_modified, created_at, content_hash
+         FROM observations
+         ORDER BY created_at_epoch DESC`)
+            .all();
+        return rows.map(observationToMemory).filter((m) => m !== undefined);
+    }
+    finally {
+        db.close();
+    }
+}
+function observationToMemory(row) {
+    const fact = buildFact(row);
+    if (!fact)
+        return undefined;
+    const sourceKey = row.content_hash || `${row.memory_session_id}-${row.id}`;
+    const project = row.project ?? undefined;
+    const scope = project ? 'project' : 'global';
+    const filesModified = parseStringList(row.files_modified);
+    const tags = uniq([row.type, ...filesModified].filter(Boolean));
+    return {
+        schema: MEMORY_SCHEMA,
+        id: memoryId('claude-mem', sourceKey),
+        tool: 'claude-mem',
+        scope,
+        ...(project ? { project } : {}),
+        fact,
+        tags,
+        provenance: {
+            sourceTool: 'claude-mem',
+            sourcePath: '~/.claude-mem/claude-mem.db',
+            sourceKey,
+            capturedAt: new Date().toISOString(),
+        },
+        addedAt: row.created_at,
+        updatedAt: row.created_at,
+    };
+}
+function buildFact(row) {
+    const parts = [];
+    if (row.title)
+        parts.push(row.title);
+    if (row.text && row.text !== row.title)
+        parts.push(row.text);
+    else if (row.narrative)
+        parts.push(row.narrative);
+    const facts = parseStringList(row.facts);
+    if (facts.length > 0)
+        parts.push(facts.map(f => `- ${f}`).join('\n'));
+    const concepts = parseStringList(row.concepts);
+    if (concepts.length > 0)
+        parts.push(`Concepts: ${concepts.join(', ')}`);
+    const joined = parts.join('\n').trim();
+    return joined.length > 0 ? joined : undefined;
+}
+function parseStringList(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed.filter((v) => typeof v === 'string');
+    }
+    catch {
+        // fall through
+    }
+    return raw
+        .split(',')
+        .map(s => s.trim())
+        .filter(Boolean);
+}
+function uniq(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=claude-mem.js.map

package/dist/memory/sources/claude-mem.js.map

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

package/dist/memory/sources/codex.d.ts

@@ -0,0 +1,8 @@
+import { type Memory } from '../../schema/memory.js';
+export interface CodexMemoryReaderOptions {
+    homeDir: string;
+    /** Override the Codex memories sqlite path. */
+    dbPath?: string;
+}
+export declare function codexMemoryDbPath(opts: CodexMemoryReaderOptions): string;
+export declare function readCodexMemories(opts: CodexMemoryReaderOptions): Promise<Memory[]>;

package/dist/memory/sources/codex.js

@@ -0,0 +1,77 @@
+import { promises as fs } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { memoryId } from '../../schema/memory.js';
+import { MEMORY_SCHEMA } from '../../version.js';
+const requireSqlite = createRequire(import.meta.url);
+let cachedSqlite;
+function loadSqlite() {
+    if (!cachedSqlite) {
+        cachedSqlite = requireSqlite('node:sqlite');
+    }
+    return cachedSqlite;
+}
+export function codexMemoryDbPath(opts) {
+    return opts.dbPath ?? join(opts.homeDir, '.codex', 'memories_1.sqlite');
+}
+export async function readCodexMemories(opts) {
+    const dbPath = codexMemoryDbPath(opts);
+    try {
+        await fs.access(dbPath);
+    }
+    catch {
+        return [];
+    }
+    const { DatabaseSync } = loadSqlite();
+    const db = new DatabaseSync(dbPath, { readonly: true });
+    try {
+        const rows = db
+            .prepare(`SELECT thread_id, raw_memory, rollout_summary, rollout_slug,
+                generated_at, source_updated_at, usage_count
+         FROM stage1_outputs
+         ORDER BY source_updated_at DESC`)
+            .all();
+        return rows.map(stage1RowToMemory).filter((m) => m !== undefined);
+    }
+    finally {
+        db.close();
+    }
+}
+function stage1RowToMemory(row) {
+    const fact = buildFact(row);
+    if (!fact)
+        return undefined;
+    const tags = uniq(['codex', row.rollout_slug ?? ''].filter(Boolean));
+    const generatedAt = new Date(row.generated_at).toISOString();
+    const sourceUpdatedAt = new Date(row.source_updated_at).toISOString();
+    return {
+        schema: MEMORY_SCHEMA,
+        id: memoryId('codex', row.thread_id),
+        tool: 'codex',
+        scope: 'global',
+        fact,
+        tags,
+        provenance: {
+            sourceTool: 'codex',
+            sourcePath: '~/.codex/memories_1.sqlite',
+            sourceKey: row.thread_id,
+            capturedAt: new Date().toISOString(),
+        },
+        addedAt: generatedAt,
+        updatedAt: sourceUpdatedAt,
+    };
+}
+function buildFact(row) {
+    const summary = row.rollout_summary?.trim() ?? '';
+    const memoryBody = row.raw_memory?.trim() ?? '';
+    if (memoryBody) {
+        if (summary && summary !== memoryBody)
+            return `${summary}\n\n${memoryBody}`;
+        return memoryBody;
+    }
+    return summary || undefined;
+}
+function uniq(values) {
+    return [...new Set(values)];
+}
+//# sourceMappingURL=codex.js.map

package/dist/memory/sources/codex.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,19 @@
+import { type Memory } from '../schema/memory.js';
+export declare function memoryLogPath(): string;
+export interface MemoryWriteStats {
+    appended: number;
+    bytes: number;
+}
+export declare function appendMemories(memories: Memory[]): Promise<MemoryWriteStats>;
+/**
+ * Read the log and return the latest version of every Memory, keyed by id.
+ *
+ * Order is "as-seen" — the underlying file is append-only, so the order
+ * matches actual capture/import history. Callers re-sort as needed.
+ */
+export declare function readMemories(): Promise<Memory[]>;
+/**
+ * Check whether a Memory with the given id is already stored. Used by
+ * capture readers to avoid emitting JSONL noise for unchanged rows.
+ */
+export declare function hasMemory(id: string): Promise<boolean>;