@justfortytwo/memory 0.1.0

package/dist/gate-approval-store.js

@@ -0,0 +1,114 @@
+// memory's implementation of gate's host-integration seam.
+//
+// @justfortytwo/gate (the safety gate) defines the ApprovalStore + AuditLogger
+// interfaces but ships only standalone in-memory / JSONL stores. This is the
+// RICHER, durable backing the gate's `decide()` accepts via opts.store / opts.audit:
+// a transactional store + audit trail on memory's own SQLite db (tables created by
+// migration 003_approvals).
+//
+// Dependency direction is ONE-WAY: memory -> gate (we import gate's TYPES; gate
+// never imports memory). No cycle. gate is a peerDependency of memory.
+import { randomUUID } from 'node:crypto';
+function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * Fail-closed transition guard (same invariant as gate's stock stores): only a
+ * pending call may be approved/denied, and an approval may be revoked (-> denied)
+ * before it is consumed. Terminal states (executed/denied/expired) are immutable,
+ * so a decision can never resurrect a spent or denied one-shot.
+ */
+function canDecide(current, next) {
+    if (current === 'pending')
+        return true;
+    if (current === 'approved' && next === 'denied')
+        return true;
+    return false;
+}
+function toApproval(r) {
+    return {
+        id: r.id,
+        tool: r.tool,
+        target: r.target,
+        payload: JSON.parse(r.payload),
+        tier: r.tier,
+        tool_use_id: r.tool_use_id,
+        session_id: r.session_id,
+        status: r.status,
+        created_at: r.created_at,
+        updated_at: r.updated_at,
+    };
+}
+/**
+ * SQLite-backed ApprovalStore + AuditLogger for the gate. Pass an instance
+ * to gate's `decide(manifest, ctx, { store, audit })` so staged one-shots and the
+ * audit trail live in memory's durable db instead of the gate's JSONL default.
+ */
+export class GateApprovalStore {
+    h;
+    constructor(h) {
+        this.h = h;
+    }
+    async addPending(input) {
+        const id = `pa_${randomUUID()}`;
+        const ts = nowIso();
+        // Upsert keyed on tool_use_id: a re-request replaces the prior (terminal) row
+        // with a fresh pending one, so there is exactly one staged row per tool_use_id
+        // and "most recent wins" is deterministic (no fragile timestamp/uuid tie-break).
+        this.h.raw
+            .prepare(`INSERT INTO approvals
+           (id, tool, target, payload, tier, tool_use_id, session_id, status, decided_by, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, 'pending', NULL, ?, ?)
+         ON CONFLICT(tool_use_id) DO UPDATE SET
+           id = excluded.id, tool = excluded.tool, target = excluded.target,
+           payload = excluded.payload, tier = excluded.tier, session_id = excluded.session_id,
+           status = 'pending', decided_by = NULL,
+           created_at = excluded.created_at, updated_at = excluded.updated_at`)
+            .run(id, input.tool, input.target, JSON.stringify(input.payload ?? {}), input.tier, input.tool_use_id, input.session_id ?? null, ts, ts);
+        return id;
+    }
+    async getByToolUseId(toolUseId) {
+        // tool_use_id is UNIQUE (one staged row each), so this is unambiguous.
+        const row = this.h.raw
+            .prepare(`SELECT * FROM approvals WHERE tool_use_id = ? LIMIT 1`)
+            .get(toolUseId);
+        return row ? toApproval(row) : undefined;
+    }
+    async markExecutedByToolUseId(toolUseId) {
+        // Atomic compare-and-set approved -> executed: succeeds exactly once.
+        const txn = this.h.raw.transaction(() => {
+            const info = this.h.raw
+                .prepare(`UPDATE approvals SET status = 'executed', updated_at = ?
+            WHERE tool_use_id = ? AND status = 'approved'`)
+                .run(nowIso(), toolUseId);
+            return info.changes > 0;
+        });
+        return txn();
+    }
+    async setDecisionByToolUseId(toolUseId, status, by) {
+        const txn = this.h.raw.transaction(() => {
+            const row = this.h.raw
+                .prepare(`SELECT id, status FROM approvals WHERE tool_use_id = ? LIMIT 1`)
+                .get(toolUseId);
+            if (!row || !canDecide(row.status, status))
+                return false;
+            this.h.raw
+                .prepare(`UPDATE approvals SET status = ?, decided_by = ?, updated_at = ? WHERE id = ?`)
+                .run(status, by ?? null, nowIso(), row.id);
+            return true;
+        });
+        return txn();
+    }
+    async list() {
+        const rows = this.h.raw
+            .prepare(`SELECT * FROM approvals ORDER BY created_at ASC, id ASC`)
+            .all();
+        return rows.map(toApproval);
+    }
+    async log(entry) {
+        this.h.raw
+            .prepare(`INSERT INTO audit_log (actor, kind, content, approval_status, meta) VALUES (?, ?, ?, ?, ?)`)
+            .run(entry.actor, entry.kind, entry.content, entry.approval_status ?? null, JSON.stringify(entry.meta ?? {}));
+    }
+}
+//# sourceMappingURL=gate-approval-store.js.map

package/dist/gate-approval-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+export * from './contract.js';
+export * from './embedder.js';
+export { openDb, type DbHandles, EMBED_DIM } from './db.js';
+export { runMigrations } from './migrate.js';
+export { store, query, recall, recallDocs, lexical, reindex, exportRange, reembed, type MemoryInput, type MemoryRow, type RecallRow, type QueryOpts, type DocRecallRow, type ReindexResult, } from './memory.js';
+export { enrich, enrichFromTurn, type EnrichmentCandidate, type EnrichmentResult } from './enrichment.js';
+export { toolDefinitions } from './tools.js';
+export { GateApprovalStore } from './gate-approval-store.js';
+/**
+ * Boot the MCP server over stdio. Kept behind an entrypoint guard so that
+ * IMPORTING this package as a library (e.g. the installer calling
+ * `runMigrations`/`openDb`) does NOT open a DB, run migrations, or connect a
+ * transport. Only running the `fortytwo-memory` bin directly starts the server.
+ */
+export declare function startServer(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { mkdirSync, realpathSync } from 'node:fs';
+import { openDb } from './db.js';
+import { runMigrations } from './migrate.js';
+import { FakeEmbedder, OllamaEmbedder } from './embedder.js';
+import { toolDefinitions } from './tools.js';
+import { callTool } from './dispatch.js';
+import { MEMORY_SERVER_ID } from './contract.js';
+// Public surface re-exports so consumers can `import { ... } from '@justfortytwo/memory'`.
+export * from './contract.js';
+export * from './embedder.js';
+export { openDb, EMBED_DIM } from './db.js';
+export { runMigrations } from './migrate.js';
+export { store, query, recall, recallDocs, lexical, reindex, exportRange, reembed, } from './memory.js';
+export { enrich, enrichFromTurn } from './enrichment.js';
+export { toolDefinitions } from './tools.js';
+// memory's implementation of gate's ApprovalStore + AuditLogger seam (memory -> gate).
+export { GateApprovalStore } from './gate-approval-store.js';
+/**
+ * Boot the MCP server over stdio. Kept behind an entrypoint guard so that
+ * IMPORTING this package as a library (e.g. the installer calling
+ * `runMigrations`/`openDb`) does NOT open a DB, run migrations, or connect a
+ * transport. Only running the `fortytwo-memory` bin directly starts the server.
+ */
+export async function startServer() {
+    // Standalone, persona-agnostic: DB_PATH (env) or ./memory.db. No repo-root coupling.
+    const DB_PATH = process.env.DB_PATH ? resolve(process.env.DB_PATH) : resolve('memory.db');
+    // EMBED_MODEL present → real Ollama embedder; absent → deterministic FakeEmbedder
+    // (lets the server boot with zero infra for tests / first-run smoke checks).
+    const embedder = process.env.EMBED_MODEL
+        ? new OllamaEmbedder(process.env.EMBED_MODEL, process.env.OLLAMA_BASE_URL)
+        : new FakeEmbedder();
+    mkdirSync(dirname(DB_PATH), { recursive: true });
+    const h = openDb(DB_PATH);
+    await runMigrations(h.k);
+    const server = new Server({ name: MEMORY_SERVER_ID, version: '0.1.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: toolDefinitions(),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args = {} } = req.params;
+        const result = await callTool(h, embedder, name, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Run the server only when invoked directly as the `fortytwo-memory` bin.
+// Realpath comparison so the npm bin symlink resolves to this module.
+function invokedAsBin() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        return realpathSync(argv1) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (invokedAsBin()) {
+    startServer().catch((err) => {
+        process.stderr.write(`fortytwo-memory: ${err?.stack ?? err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,74 @@
+import type { DbHandles } from './db.js';
+import type { Embedder } from './embedder.js';
+/** A memory to write. `content` is required; everything else is provenance. */
+export interface MemoryInput {
+    content: string;
+    /** Where this came from, e.g. "owner", "web", "tool:foo". Free-form. */
+    source?: string;
+    /** How it was observed, e.g. "stated", "inferred", "imported". Free-form. */
+    observed?: string;
+    /** ISO date the memory pertains to. Defaults to today (UTC) at write time. */
+    date?: string;
+    /** Free-form tags for filtering. */
+    tags?: string[];
+    /** Arbitrary structured provenance. Stored as JSON. */
+    meta?: Record<string, unknown>;
+    /**
+     * If set, this memory SUPERSEDES the referenced memory id. The prior row is
+     * kept (history is never silently destroyed) but flagged superseded.
+     * See enrichment.ts for the dedupe/supersede design.
+     */
+    supersedes?: number | null;
+}
+export interface MemoryRow {
+    id: number;
+    ts: string;
+    content: string;
+    source: string | null;
+    observed: string | null;
+    date: string | null;
+    tags: string;
+    meta: string;
+    superseded_by: number | null;
+}
+/** Atomic insert of the relational row + its embedding (raw transaction). */
+export declare function store(h: DbHandles, embedder: Embedder, m: MemoryInput): Promise<number>;
+export interface QueryOpts {
+    source?: string;
+    observed?: string;
+    tag?: string;
+    since?: string;
+    until?: string;
+    /** When false, superseded rows are excluded (default: true — only live rows). */
+    liveOnly?: boolean;
+    limit?: number;
+}
+export declare function query(h: DbHandles, opts?: QueryOpts): Promise<MemoryRow[]>;
+export interface RecallRow extends MemoryRow {
+    distance: number;
+}
+/** Semantic top-k recall over the memory store by meaning. */
+export declare function recall(h: DbHandles, embedder: Embedder, text: string, k?: number): Promise<RecallRow[]>;
+/** Full-text keyword search over the memory store (FTS5). */
+export declare function lexical(h: DbHandles, text: string, k?: number): MemoryRow[];
+export interface ReindexResult {
+    indexed: number;
+    removed: number;
+}
+/**
+ * Self-heal the doc recall index from a directory of markdown files. Hashes
+ * content to skip unchanged files; removes index rows for files that vanished.
+ * Generic version of the original assistant's curated-doc reindex (no curated-corpus assumptions).
+ */
+export declare function reindex(h: DbHandles, embedder: Embedder, root: string): Promise<ReindexResult>;
+export interface DocRecallRow {
+    file_path: string;
+    distance: number;
+    preview: string;
+}
+/** Semantic top-k recall over reindexed markdown (the doc_vec index). */
+export declare function recallDocs(h: DbHandles, embedder: Embedder, text: string, k?: number): Promise<DocRecallRow[]>;
+/** Render a date range of memories to markdown (for debugging/export). */
+export declare function exportRange(h: DbHandles, since: string, until: string): Promise<string>;
+/** Re-embed a stored memory's content (e.g. after an embedder/model change). */
+export declare function reembed(h: DbHandles, embedder: Embedder, id: number): Promise<boolean>;

package/dist/memory.js

@@ -0,0 +1,179 @@
+import { createHash } from 'node:crypto';
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { vecToBuffer } from './embedder.js';
+function todayUtc() {
+    return new Date().toISOString().slice(0, 10);
+}
+/** Atomic insert of the relational row + its embedding (raw transaction). */
+export async function store(h, embedder, m) {
+    const vec = vecToBuffer(await embedder.embed(m.content));
+    const ins = h.raw.prepare(`INSERT INTO memories (content, source, observed, date, tags, meta)
+     VALUES (?, ?, ?, ?, ?, ?)`);
+    const insVec = h.raw.prepare('INSERT INTO memory_vec (rowid, embedding) VALUES (?, ?)');
+    const markSuperseded = h.raw.prepare('UPDATE memories SET superseded_by = ? WHERE id = ?');
+    const txn = h.raw.transaction(() => {
+        const info = ins.run(m.content, m.source ?? null, m.observed ?? null, m.date ?? todayUtc(), JSON.stringify(m.tags ?? []), JSON.stringify(m.meta ?? {}));
+        // vec0's xUpdate only accepts a 64-bit INTEGER binding; better-sqlite3
+        // promotes BigInt to SQLITE_INTEGER, while a plain Number fails vec0's
+        // "only integers allowed" check. Bind as BigInt; return as Number.
+        const id = Number(info.lastInsertRowid);
+        insVec.run(BigInt(id), vec);
+        // SUPERSEDE: keep history, link the old row forward (never a silent overwrite).
+        if (m.supersedes != null)
+            markSuperseded.run(id, m.supersedes);
+        return id;
+    });
+    return txn();
+}
+export async function query(h, opts = {}) {
+    let q = h.k('memories').select('*');
+    if (opts.source)
+        q = q.where('source', opts.source);
+    if (opts.observed)
+        q = q.where('observed', opts.observed);
+    if (opts.tag)
+        q = q.where('tags', 'like', `%"${opts.tag}"%`);
+    if (opts.since)
+        q = q.where('ts', '>=', opts.since);
+    if (opts.until)
+        q = q.where('ts', '<=', opts.until);
+    if (opts.liveOnly !== false)
+        q = q.whereNull('superseded_by');
+    return q.orderBy('ts', 'desc').limit(opts.limit ?? 50);
+}
+/** Semantic top-k recall over the memory store by meaning. */
+export async function recall(h, embedder, text, k = 5) {
+    const qv = vecToBuffer(await embedder.embed(text));
+    // sqlite-vec's vec0 module needs the KNN size constraint at prepare time.
+    // `LIMIT ?` is only visible to vec0's xBestIndex on SQLite >= 3.41, so we
+    // use the portable `k = ?` form in the WHERE clause instead.
+    const stmt = h.raw.prepare(`SELECT m.*, v.distance
+       FROM memory_vec v
+       JOIN memories m ON m.id = v.rowid
+      WHERE v.embedding MATCH ? AND k = ?
+        AND m.superseded_by IS NULL
+      ORDER BY v.distance`);
+    return stmt.all(qv, k);
+}
+/** Full-text keyword search over the memory store (FTS5). */
+export function lexical(h, text, k = 50) {
+    const stmt = h.raw.prepare(`SELECT m.*
+       FROM memory_fts f
+       JOIN memories m ON m.id = f.rowid
+      WHERE memory_fts MATCH ?
+        AND m.superseded_by IS NULL
+      ORDER BY rank
+      LIMIT ?`);
+    // FTS5 MATCH treats spaces as AND; quote each token defensively.
+    const safe = text.split(/\s+/).filter(Boolean).map((t) => `"${t.replace(/"/g, '""')}"`).join(' ');
+    return stmt.all(safe, k);
+}
+function sha256(s) {
+    return createHash('sha256').update(s).digest('hex');
+}
+function listMarkdown(root) {
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root)
+        .filter((f) => f.endsWith('.md'))
+        .map((f) => `${root}/${f}`);
+}
+/**
+ * Self-heal the doc recall index from a directory of markdown files. Hashes
+ * content to skip unchanged files; removes index rows for files that vanished.
+ * Generic version of the original assistant's curated-doc reindex (no curated-corpus assumptions).
+ */
+export async function reindex(h, embedder, root) {
+    const files = listMarkdown(root);
+    const currentPaths = new Set(files);
+    const selIndexed = h.raw.prepare('SELECT id, file_path FROM index_state');
+    const selState = h.raw.prepare('SELECT id, sha256 FROM index_state WHERE file_path = ?');
+    const insState = h.raw.prepare('INSERT INTO index_state (file_path, sha256) VALUES (?, ?)');
+    const updState = h.raw.prepare("UPDATE index_state SET sha256 = ?, embedded_at = datetime('now') WHERE id = ?");
+    const delState = h.raw.prepare('DELETE FROM index_state WHERE id = ?');
+    const delVec = h.raw.prepare('DELETE FROM doc_vec WHERE rowid = ?');
+    const insVec = h.raw.prepare('INSERT INTO doc_vec (rowid, embedding) VALUES (?, ?)');
+    let indexed = 0;
+    let removed = 0;
+    for (const row of selIndexed.all()) {
+        if (currentPaths.has(row.file_path))
+            continue;
+        const t = h.raw.transaction(() => {
+            delVec.run(BigInt(row.id));
+            delState.run(row.id);
+        });
+        t();
+        removed++;
+    }
+    for (const path of files) {
+        const content = readFileSync(path, 'utf8');
+        const hash = sha256(content);
+        const existing = selState.get(path);
+        if (existing && existing.sha256 === hash)
+            continue;
+        const vec = vecToBuffer(await embedder.embed(content));
+        const t = h.raw.transaction(() => {
+            let id;
+            if (existing) {
+                id = existing.id;
+                updState.run(hash, id);
+                delVec.run(BigInt(id));
+            }
+            else {
+                const info = insState.run(path, hash);
+                id = Number(info.lastInsertRowid);
+            }
+            // vec0's xUpdate only accepts a 64-bit INTEGER binding. Bind as BigInt.
+            insVec.run(BigInt(id), vec);
+        });
+        t();
+        indexed++;
+    }
+    return { indexed, removed };
+}
+/** Semantic top-k recall over reindexed markdown (the doc_vec index). */
+export async function recallDocs(h, embedder, text, k = 5) {
+    const qv = vecToBuffer(await embedder.embed(text));
+    const stmt = h.raw.prepare(`SELECT s.file_path, v.distance
+       FROM doc_vec v
+       JOIN index_state s ON s.id = v.rowid
+      WHERE v.embedding MATCH ? AND k = ?
+      ORDER BY v.distance`);
+    const rows = stmt.all(qv, k);
+    return rows.map((r) => {
+        let preview = '';
+        try {
+            preview = readFileSync(r.file_path, 'utf8').slice(0, 200);
+        }
+        catch { /* removed since indexing */ }
+        return { file_path: r.file_path, distance: r.distance, preview };
+    });
+}
+/** Render a date range of memories to markdown (for debugging/export). */
+export async function exportRange(h, since, until) {
+    const rows = await h.k('memories')
+        .whereBetween('ts', [`${since} 00:00:00`, `${until} 23:59:59`])
+        .orderBy('ts', 'asc');
+    if (rows.length === 0)
+        return `# Memories — ${since}..${until}\n\n_(no entries)_\n`;
+    const body = rows
+        .map((r) => `### ${r.ts}${r.source ? ` · ${r.source}` : ''}${r.observed ? `/${r.observed}` : ''}\n\n${r.content}\n`)
+        .join('\n');
+    return `# Memories — ${since}..${until}\n\n${body}`;
+}
+/** Re-embed a stored memory's content (e.g. after an embedder/model change). */
+export async function reembed(h, embedder, id) {
+    const row = await h.k('memories').select('content').where({ id }).first();
+    if (!row)
+        return false;
+    const vec = vecToBuffer(await embedder.embed(row.content));
+    const delVec = h.raw.prepare('DELETE FROM memory_vec WHERE rowid = ?');
+    const insVec = h.raw.prepare('INSERT INTO memory_vec (rowid, embedding) VALUES (?, ?)');
+    const txn = h.raw.transaction(() => {
+        delVec.run(BigInt(id));
+        insVec.run(BigInt(id), vec);
+    });
+    txn();
+    return true;
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/migrate.d.ts

@@ -0,0 +1,2 @@
+import type { Knex } from 'knex';
+export declare function runMigrations(k: Knex): Promise<void>;

package/dist/migrate.js

@@ -0,0 +1,40 @@
+import { openDb } from './db.js';
+import { resolve } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import * as m001 from './migrations/001_init.js';
+import * as m002 from './migrations/002_fts.js';
+import * as m003 from './migrations/003_approvals.js';
+// Static import list — deterministic under both vitest (resolves .js → .ts) and
+// the built server (dist/migrations/*.js). No knex CLI, no dynamic-import path
+// fragility.
+const MIGRATIONS = [
+    { name: '001_init', up: m001.up, down: m001.down },
+    { name: '002_fts', up: m002.up, down: m002.down },
+    { name: '003_approvals', up: m003.up, down: m003.down },
+];
+export async function runMigrations(k) {
+    await k.raw(`CREATE TABLE IF NOT EXISTS _migration_state (
+       name text primary key,
+       applied_at text not null default (datetime('now'))
+     )`);
+    const rows = (await k.raw('SELECT name FROM _migration_state'));
+    const done = new Set((Array.isArray(rows) ? rows : []).map((r) => r.name));
+    for (const m of MIGRATIONS) {
+        if (done.has(m.name))
+            continue;
+        await m.up(k);
+        await k.raw('INSERT INTO _migration_state (name) VALUES (?)', [m.name]);
+    }
+}
+// `npm run migrate` entry point: open the DB at DB_PATH and apply migrations.
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const dbPath = process.env.DB_PATH ? resolve(process.env.DB_PATH) : resolve('memory.db');
+    mkdirSync(dirname(dbPath), { recursive: true });
+    const h = openDb(dbPath);
+    await runMigrations(h.k);
+    await h.k.destroy();
+    // eslint-disable-next-line no-console
+    console.error(`[memory] migrations applied to ${dbPath}`);
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,yBAAyB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,+BAA+B,CAAC;AAItD,gFAAgF;AAChF,+EAA+E;AAC/E,aAAa;AACb,MAAM,UAAU,GAAwC;IACtD,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;IAClD,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;IACjD,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;CACxD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,CAAO;IACzC,MAAM,CAAC,CAAC,GAAG,CACT;;;OAGG,CACJ,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAA4B,CAAC;IAC3F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/B,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACd,MAAM,CAAC,CAAC,GAAG,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzF,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpB,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/migrations/001_init.d.ts

@@ -0,0 +1,3 @@
+import type { Knex } from 'knex';
+export declare function up(k: Knex): Promise<void>;
+export declare function down(k: Knex): Promise<void>;

package/dist/migrations/001_init.js

@@ -0,0 +1,40 @@
+// Generic memory store. Stripped from the original assistant's 001_init: the journal_entries
+// channel/direction/actor/approval_status columns, the `entities` table, and
+// the registry_pending / registry_reminders tables (all original-assistant orchestration).
+//
+// The vec0 tables (memory_vec, doc_vec) are created on the raw sqlite-vec
+// handle in db.ts — NOT here — because Knex's connection does not load the
+// sqlite-vec extension. FTS5 (compiled into SQLite) is a migration (002_fts).
+export async function up(k) {
+    await k.schema
+        .createTable('memories', (t) => {
+        t.increments('id').primary();
+        t.datetime('ts', { useTz: false }).notNullable().defaultTo(k.fn.now());
+        t.text('content').notNullable();
+        t.string('source').nullable(); // free-form provenance: owner | web | tool:foo
+        t.string('observed').nullable(); // free-form: stated | inferred | imported
+        t.string('date').nullable(); // ISO date the memory pertains to
+        t.text('tags').notNullable().defaultTo('[]');
+        t.text('meta').notNullable().defaultTo('{}');
+        // SUPERSEDE: links a stale row forward to the row that replaced it.
+        // History is never destroyed — superseded rows remain queryable.
+        t.integer('superseded_by').nullable();
+        t.index(['ts']);
+        t.index(['source']);
+        t.index(['observed']);
+        t.index(['date']);
+        t.index(['superseded_by']);
+    })
+        .createTable('index_state', (t) => {
+        t.increments('id').primary();
+        t.string('file_path').notNullable().unique();
+        t.string('sha256').notNullable();
+        t.datetime('embedded_at', { useTz: false }).notNullable().defaultTo(k.fn.now());
+    });
+}
+export async function down(k) {
+    await k.schema
+        .dropTableIfExists('index_state')
+        .dropTableIfExists('memories');
+}
+//# sourceMappingURL=001_init.js.map

package/dist/migrations/001_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"001_init.js","sourceRoot":"","sources":["../../src/migrations/001_init.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,6EAA6E;AAC7E,2FAA2F;AAC3F,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,CAAO;IAC9B,MAAM,CAAC,CAAC,MAAM;SACX,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;QAC7B,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAG,+CAA+C;QAChF,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,0CAA0C;QAC3E,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAK,kCAAkC;QACnE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7C,oEAAoE;QACpE,iEAAiE;QACjE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC;QACtC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAChB,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC;SACD,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;QAChC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC;QAC7C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,CAAO;IAChC,MAAM,CAAC,CAAC,MAAM;SACX,iBAAiB,CAAC,aAAa,CAAC;SAChC,iBAAiB,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC"}

package/dist/migrations/002_fts.d.ts

@@ -0,0 +1,3 @@
+import type { Knex } from 'knex';
+export declare function up(k: Knex): Promise<void>;
+export declare function down(k: Knex): Promise<void>;

package/dist/migrations/002_fts.js

@@ -0,0 +1,26 @@
+// SQLite-only (FTS5 is built in). The triggers keep memory_fts in sync with the
+// `memories` content column. Generic rename of the original assistant's journal_fts (003_fts).
+export async function up(k) {
+    if (k.client.config.client !== 'better-sqlite3')
+        return;
+    await k.raw(`CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(content, content='memories', content_rowid='id')`);
+    await k.raw(`CREATE TRIGGER IF NOT EXISTS memory_ai AFTER INSERT ON memories BEGIN
+    INSERT INTO memory_fts(rowid, content) VALUES (new.id, new.content);
+  END`);
+    await k.raw(`CREATE TRIGGER IF NOT EXISTS memory_ad AFTER DELETE ON memories BEGIN
+    INSERT INTO memory_fts(memory_fts, rowid, content) VALUES('delete', old.id, old.content);
+  END`);
+    await k.raw(`CREATE TRIGGER IF NOT EXISTS memory_au AFTER UPDATE ON memories BEGIN
+    INSERT INTO memory_fts(memory_fts, rowid, content) VALUES('delete', old.id, old.content);
+    INSERT INTO memory_fts(rowid, content) VALUES (new.id, new.content);
+  END`);
+}
+export async function down(k) {
+    if (k.client.config.client !== 'better-sqlite3')
+        return;
+    await k.raw('DROP TRIGGER IF EXISTS memory_au');
+    await k.raw('DROP TRIGGER IF EXISTS memory_ad');
+    await k.raw('DROP TRIGGER IF EXISTS memory_ai');
+    await k.raw('DROP TABLE IF EXISTS memory_fts');
+}
+//# sourceMappingURL=002_fts.js.map

package/dist/migrations/002_fts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"002_fts.js","sourceRoot":"","sources":["../../src/migrations/002_fts.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,CAAO;IAC9B,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO;IACxD,MAAM,CAAC,CAAC,GAAG,CAAC,2GAA2G,CAAC,CAAC;IACzH,MAAM,CAAC,CAAC,GAAG,CAAC;;MAER,CAAC,CAAC;IACN,MAAM,CAAC,CAAC,GAAG,CAAC;;MAER,CAAC,CAAC;IACN,MAAM,CAAC,CAAC,GAAG,CAAC;;;MAGR,CAAC,CAAC;AACR,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,CAAO;IAChC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO;IACxD,MAAM,CAAC,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,MAAM,CAAC,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,MAAM,CAAC,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,MAAM,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AACjD,CAAC"}

package/dist/migrations/003_approvals.d.ts

@@ -0,0 +1,3 @@
+import type { Knex } from 'knex';
+export declare function up(k: Knex): Promise<void>;
+export declare function down(k: Knex): Promise<void>;