memkin 0.4.0

package/dist/store/search.js

@@ -0,0 +1,312 @@
+import { rewriteQuery } from "./query-rewrite.js";
+import { buildSnippet, buildTrgmConditions, splitTerms } from "./trgm-search.js";
+const RRF_K = 60;
+const COMPILED_TRUTH_BOOST = 2.0;
+const BACKLINK_BOOST_FACTOR = 0.05;
+const FRESHNESS_HALF_LIFE_DAYS = 90;
+const FRESHNESS_BOOST_FACTOR = 0.3;
+const TIER_WEIGHTS = { hot: 1.0, warm: 0.8, cold: 0.6 };
+const DEFAULT_SEARCH_LIMIT = 20;
+const MAX_SEARCH_LIMIT = 50;
+/**
+ * Compute freshness multiplier using exponential decay.
+ * Returns 1.0 for missing timestamps (no effect).
+ * Exported for unit testing.
+ */
+export function freshnessMultiplier(updatedAt) {
+    if (!updatedAt)
+        return 1.0;
+    // Clamp to >=0 so future timestamps (clock skew, calendar events) cap at the boost ceiling
+    // instead of producing exp(-negative) > 1 which exceeds the intended 1.3 limit.
+    const ageDays = Math.max(0, (Date.now() - new Date(updatedAt).getTime()) / (1000 * 60 * 60 * 24));
+    return 1 + FRESHNESS_BOOST_FACTOR * Math.exp(-ageDays / FRESHNESS_HALF_LIFE_DAYS);
+}
+function clampLimit(limit, defaultLimit = DEFAULT_SEARCH_LIMIT) {
+    if (!Number.isFinite(limit) || (limit ?? 0) <= 0)
+        return defaultLimit;
+    return Math.min(Math.floor(limit), MAX_SEARCH_LIMIT);
+}
+function candidateLimit(limit) {
+    return Math.min(MAX_SEARCH_LIMIT, Math.max(DEFAULT_SEARCH_LIMIT, limit * 3));
+}
+function asArray(value) {
+    if (value === undefined)
+        return undefined;
+    return Array.isArray(value) ? value : [value];
+}
+function isDateOnly(value) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(value);
+}
+function sourceField(alias, field) {
+    return `COALESCE(${alias}.frontmatter->'source'->>'${field}', ${alias}.frontmatter->'first_seen'->>'${field}')`;
+}
+function sourceJson(alias) {
+    return `COALESCE(${alias}.frontmatter->'source', ${alias}.frontmatter->'first_seen')`;
+}
+function addMemoryFilterConditions(conditions, params, opts, pageAlias = "p") {
+    const addArrayCondition = (field) => {
+        const values = asArray(opts?.[field]);
+        if (!values || values.length === 0)
+            return;
+        params.push(values);
+        conditions.push(`${sourceField(pageAlias, field)} = ANY($${params.length}::text[])`);
+    };
+    addArrayCondition("platform");
+    addArrayCondition("source_type");
+    if (opts?.channel) {
+        params.push(opts.channel);
+        conditions.push(`${sourceField(pageAlias, "channel")} = $${params.length}`);
+    }
+    if (opts?.channel_name) {
+        params.push(opts.channel_name);
+        conditions.push(`${sourceField(pageAlias, "channel_name")} = $${params.length}`);
+    }
+    if (opts?.participant) {
+        params.push(opts.participant);
+        const param = `$${params.length}`;
+        conditions.push(`(
+      EXISTS (
+        SELECT 1
+        FROM jsonb_array_elements(COALESCE(${sourceJson(pageAlias)}->'participants', '[]'::jsonb)) AS participant
+        WHERE participant->>'name' = ${param} OR participant->>'id' = ${param}
+      )
+      OR ${sourceJson(pageAlias)}->'author'->>'name' = ${param}
+      OR ${sourceJson(pageAlias)}->'author'->>'id' = ${param}
+    )`);
+    }
+    if (opts?.type && opts.type.length > 0) {
+        params.push(opts.type);
+        conditions.push(`${pageAlias}.type = ANY($${params.length}::text[])`);
+    }
+    if (opts?.exclude_types && opts.exclude_types.length > 0) {
+        params.push(opts.exclude_types);
+        conditions.push(`${pageAlias}.type != ALL($${params.length}::text[])`);
+    }
+    if (opts?.from) {
+        params.push(opts.from);
+        conditions.push(`COALESCE(${sourceField(pageAlias, "timestamp")}, ${pageAlias}.created_at::text)::timestamptz >= $${params.length}::timestamptz`);
+    }
+    if (opts?.to) {
+        params.push(opts.to);
+        if (isDateOnly(opts.to)) {
+            conditions.push(`COALESCE(${sourceField(pageAlias, "timestamp")}, ${pageAlias}.created_at::text)::timestamptz < ($${params.length}::date + interval '1 day')`);
+        }
+        else {
+            conditions.push(`COALESCE(${sourceField(pageAlias, "timestamp")}, ${pageAlias}.created_at::text)::timestamptz <= $${params.length}::timestamptz`);
+        }
+    }
+}
+function parseProvenance(value) {
+    if (!value)
+        return undefined;
+    if (typeof value === "string") {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return value;
+}
+export class SearchEngine {
+    pg;
+    embedText;
+    poolByPageDefault;
+    llmRewrite;
+    synonyms;
+    llm;
+    constructor(pg, opts) {
+        this.pg = pg;
+        this.embedText = opts?.embedText;
+        // Spec 10: best-chunk pooling defaults on; config can flip it back off.
+        this.poolByPageDefault = opts?.search?.pool_by_page ?? true;
+        this.llmRewrite = opts?.search?.llm_rewrite ?? false;
+        this.synonyms = opts?.search?.synonyms;
+        this.llm = opts?.llm;
+    }
+    /**
+     * Spec 10 §5: rule-based query rewrite (synonym expansion, stopword filter,
+     * whitespace normalize) before retrieval; optional LLM rewrite only when
+     * search.llm_rewrite is true AND a provider is configured. Recall-only.
+     */
+    async rewrite(query) {
+        if (this.llmRewrite && this.llm) {
+            return rewriteQuery(query, {
+                synonyms: this.synonyms,
+                llm: { enabled: true, provider: this.llm },
+            });
+        }
+        return rewriteQuery(query, { synonyms: this.synonyms });
+    }
+    async search(query, opts) {
+        const limit = clampLimit(opts?.limit);
+        const terms = splitTerms(query);
+        if (terms.length === 0)
+            return [];
+        const params = [query.trim()]; // $1: similarity() ranking input
+        const trgm = buildTrgmConditions(terms, ["p.title", "p.compiled_truth"], params);
+        if (!trgm)
+            return [];
+        const conditions = [trgm];
+        addMemoryFilterConditions(conditions, params, opts, "p");
+        params.push(limit);
+        const result = await this.pg.query(`SELECT
+         p.slug,
+         p.title,
+         p.type,
+         GREATEST(similarity(p.title, $1), similarity(p.compiled_truth, $1)) AS page_rank,
+         p.compiled_truth AS body,
+         ${sourceJson("p")} AS provenance
+       FROM pages p
+       WHERE ${conditions.join(" AND ")}
+       ORDER BY page_rank DESC, p.updated_at DESC, p.slug ASC
+       LIMIT $${params.length}`, params);
+        return result.rows.map((row) => {
+            const snippet = buildSnippet(row.body, terms);
+            return {
+                slug: row.slug,
+                title: row.title,
+                type: row.type,
+                snippet,
+                score: Number(row.page_rank),
+                highlights: snippet ? [snippet] : [],
+                provenance: parseProvenance(row.provenance),
+            };
+        });
+    }
+    async query(query, opts) {
+        const limit = clampLimit(opts?.limit);
+        // Spec 10: per-call opt overrides config default (which itself defaults to true).
+        const poolByPage = opts?.poolByPage ?? this.poolByPageDefault;
+        // Spec 10 §5: rewrite for recall (rule-based; optional LLM). Falls back to the
+        // original query if rewriting produces nothing usable.
+        const effectiveQuery = (await this.rewrite(query)) || query;
+        const [ftsResults, vectorResults] = await Promise.all([
+            this.ftsChunkSearch(effectiveQuery, opts, candidateLimit(limit)),
+            this.vectorSearch(effectiveQuery, opts, candidateLimit(limit)),
+        ]);
+        const scoreMap = new Map();
+        const addRanked = (results) => {
+            for (let rank = 0; rank < results.length; rank++) {
+                const r = results[rank];
+                const rrfScore = 1 / (RRF_K + rank + 1);
+                const existing = scoreMap.get(r.slug);
+                // best-chunk pooling: max of strongest single chunk; default: accumulate (sum).
+                const newScore = poolByPage
+                    ? Math.max(existing?.score ?? 0, rrfScore)
+                    : (existing?.score ?? 0) + rrfScore;
+                if (!existing || newScore > existing.score) {
+                    scoreMap.set(r.slug, {
+                        slug: r.slug,
+                        title: r.title,
+                        type: r.type,
+                        snippet: existing?.snippet || r.snippet,
+                        score: newScore,
+                        chunk_source: r.chunk_source,
+                        updated_at: r.updated_at,
+                        provenance: parseProvenance(r.provenance),
+                    });
+                }
+                else {
+                    existing.score = newScore;
+                }
+            }
+        };
+        addRanked(ftsResults);
+        addRanked(vectorResults);
+        for (const entry of scoreMap.values()) {
+            if (entry.chunk_source === "compiled_truth") {
+                entry.score *= COMPILED_TRUTH_BOOST;
+            }
+        }
+        // Tier weighting: batch-fetch tier for all scored slugs in one query
+        const slugs = [...scoreMap.keys()];
+        if (slugs.length > 0) {
+            const tierRows = await this.pg.query(`SELECT slug, tier FROM pages WHERE slug = ANY($1::text[])`, [slugs]);
+            const tierMap = new Map(tierRows.rows.map((r) => [r.slug, r.tier]));
+            for (const entry of scoreMap.values()) {
+                const tier = tierMap.get(entry.slug) ?? "hot";
+                entry.score *= TIER_WEIGHTS[tier] ?? 1.0;
+            }
+        }
+        if (slugs.length > 0) {
+            for (const slug of slugs) {
+                const bl = await this.pg.query(`SELECT COUNT(*) AS cnt FROM links l JOIN pages p ON p.id = l.to_page_id WHERE p.slug = $1`, [slug]);
+                const backlinkCount = Number(bl.rows[0]?.cnt ?? 0);
+                if (backlinkCount > 0) {
+                    const entry = scoreMap.get(slug);
+                    if (entry) {
+                        entry.score *= 1 + BACKLINK_BOOST_FACTOR * Math.log(1 + backlinkCount);
+                    }
+                }
+            }
+        }
+        // Apply freshness boost
+        for (const entry of scoreMap.values()) {
+            entry.score *= freshnessMultiplier(entry.updated_at);
+        }
+        let results = [...scoreMap.values()].sort((a, b) => b.score - a.score);
+        // Post-filter by type and exclude_types
+        if (opts?.type && opts.type.length > 0) {
+            const typeSet = new Set(opts.type);
+            results = results.filter((r) => typeSet.has(r.type));
+        }
+        if (opts?.exclude_types && opts.exclude_types.length > 0) {
+            const excludeSet = new Set(opts.exclude_types);
+            results = results.filter((r) => !excludeSet.has(r.type));
+        }
+        return results.slice(0, limit).map(({ chunk_source: _, updated_at: __, snippet, ...rest }) => ({
+            ...rest,
+            snippet,
+            highlights: snippet ? [snippet] : [],
+        }));
+    }
+    async ftsChunkSearch(query, opts, limit = MAX_SEARCH_LIMIT) {
+        const terms = splitTerms(query);
+        if (terms.length === 0)
+            return [];
+        const params = [query.trim()]; // $1: similarity() ranking input
+        const trgm = buildTrgmConditions(terms, ["cc.chunk_text"], params);
+        if (!trgm)
+            return [];
+        const conditions = [trgm];
+        addMemoryFilterConditions(conditions, params, opts, "p");
+        params.push(limit);
+        const result = await this.pg.query(`SELECT p.slug, p.title, p.type, cc.chunk_source, p.updated_at,
+         similarity(cc.chunk_text, $1) AS chunk_rank,
+         cc.chunk_text AS chunk_text,
+         ${sourceJson("p")} AS provenance
+       FROM content_chunks cc JOIN pages p ON p.id = cc.page_id
+       WHERE ${conditions.join(" AND ")}
+       ORDER BY chunk_rank DESC, p.updated_at DESC NULLS LAST, p.slug ASC
+       LIMIT $${params.length}`, params);
+        return result.rows.map((r) => ({
+            slug: r.slug,
+            title: r.title,
+            type: r.type,
+            snippet: buildSnippet(r.chunk_text, terms),
+            chunk_source: r.chunk_source,
+            updated_at: r.updated_at,
+            provenance: r.provenance,
+        }));
+    }
+    async vectorSearch(query, opts, limit = MAX_SEARCH_LIMIT) {
+        if (!this.embedText)
+            return [];
+        const queryVec = await this.embedText(query);
+        const vecStr = `[${queryVec.join(",")}]`;
+        const conditions = ["cc.embedding IS NOT NULL"];
+        const params = [vecStr];
+        addMemoryFilterConditions(conditions, params, opts, "p");
+        params.push(limit);
+        const result = await this.pg.query(`SELECT p.slug, p.title, p.type, cc.chunk_source, p.updated_at,
+         cc.chunk_text AS snippet, 1 - (cc.embedding <=> $1::vector) AS cosine_sim,
+         ${sourceJson("p")} AS provenance
+       FROM content_chunks cc JOIN pages p ON p.id = cc.page_id
+       WHERE ${conditions.join(" AND ")}
+       ORDER BY cc.embedding <=> $1::vector LIMIT $${params.length}`, params);
+        return result.rows;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/store/search.js.map

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

package/dist/store/sequence-sync.d.ts

@@ -0,0 +1,22 @@
+import type { SqlConn } from "./sql-executor.js";
+export interface SequenceDesync {
+    table: string;
+    /** Backing sequence relation, as reported by pg_get_serial_sequence. */
+    sequence: string;
+    maxId: number;
+    /** What nextval would have returned before repair (≤ maxId ⇒ collision). */
+    nextValue: number;
+}
+/**
+ * Report every SERIAL id sequence whose next value would collide with an
+ * existing row. Read-only; missing tables are skipped so this is safe to run
+ * against a not-yet-initialized database (doctor).
+ */
+export declare function detectIdSequenceDesync(conn: SqlConn): Promise<SequenceDesync[]>;
+/**
+ * Repair every desynced sequence so nextval returns MAX(id)+1. Idempotent and
+ * strictly forward-moving: healthy sequences are never touched. Returns the
+ * repairs performed (empty when the store is healthy).
+ */
+export declare function resyncIdSequences(conn: SqlConn): Promise<SequenceDesync[]>;
+//# sourceMappingURL=sequence-sync.d.ts.map

package/dist/store/sequence-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-sync.d.ts","sourceRoot":"","sources":["../../src/store/sequence-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA0BrF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAOhF"}

package/dist/store/sequence-sync.js

@@ -0,0 +1,46 @@
+// Tables from schema.sql whose `id` is SERIAL. An id-preserving import/restore
+// (explicit-id INSERTs with no setval) leaves the backing sequence behind
+// MAX(id); nextval then returns an already-used id and every new-row INSERT
+// dies on the table's pkey — the slug-targeted ON CONFLICT cannot arbitrate a
+// pkey collision. Each failed INSERT still consumes a sequence value, so the
+// symptom is "fails N times, then self-heals", which is why it goes unnoticed.
+const SERIAL_ID_TABLES = ["pages", "content_chunks", "links", "tags", "timeline_entries"];
+/**
+ * Report every SERIAL id sequence whose next value would collide with an
+ * existing row. Read-only; missing tables are skipped so this is safe to run
+ * against a not-yet-initialized database (doctor).
+ */
+export async function detectIdSequenceDesync(conn) {
+    const out = [];
+    for (const table of SERIAL_ID_TABLES) {
+        const seqRes = await conn.query("SELECT pg_get_serial_sequence(t.oid::regclass::text, 'id') AS seq FROM pg_class t WHERE t.oid = to_regclass($1)", [table]);
+        const sequence = seqRes.rows[0]?.seq;
+        if (!sequence)
+            continue; // table absent or id is not serial-backed
+        const stateRes = await conn.query(`SELECT last_value, is_called FROM ${sequence}`);
+        const maxRes = await conn.query(`SELECT MAX(id) AS max_id FROM ${table}`);
+        const maxId = maxRes.rows[0]?.max_id ?? 0;
+        if (maxId === 0)
+            continue; // empty table — nothing to collide with
+        const lastValue = Number(stateRes.rows[0].last_value);
+        const nextValue = stateRes.rows[0].is_called ? lastValue + 1 : lastValue;
+        if (maxId >= nextValue) {
+            out.push({ table, sequence, maxId, nextValue });
+        }
+    }
+    return out;
+}
+/**
+ * Repair every desynced sequence so nextval returns MAX(id)+1. Idempotent and
+ * strictly forward-moving: healthy sequences are never touched. Returns the
+ * repairs performed (empty when the store is healthy).
+ */
+export async function resyncIdSequences(conn) {
+    const desynced = await detectIdSequenceDesync(conn);
+    for (const d of desynced) {
+        // setval(..., false): next nextval returns exactly maxId + 1.
+        await conn.query("SELECT setval($1::regclass, $2, false)", [d.sequence, d.maxId + 1]);
+    }
+    return desynced;
+}
+//# sourceMappingURL=sequence-sync.js.map

package/dist/store/sequence-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-sync.js","sourceRoot":"","sources":["../../src/store/sequence-sync.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,CAAU,CAAC;AAWnG;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAa;IACxD,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,iHAAiH,EACjH,CAAC,KAAK,CAAC,CACR,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,SAAS,CAAC,0CAA0C;QAEnE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,qCAAqC,QAAQ,EAAE,CAChD,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,iCAAiC,KAAK,EAAE,CACzC,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,CAAC;YAAE,SAAS,CAAC,wCAAwC;QAEnE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAa;IACnD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,8DAA8D;QAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/store/sql-executor.d.ts

@@ -0,0 +1,17 @@
+/** 查询面：13 个生产类的 .query / 偶尔 .exec 都走它；transaction/bootstrap 回调也用它。 */
+export interface SqlConn {
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+    }>;
+    exec(sql: string): Promise<void>;
+}
+export interface SqlExecutor extends SqlConn {
+    /** 原子多步（merge / put_page）。回调内全部用 tx，不要混用外层 conn。 */
+    transaction<T>(fn: (tx: SqlConn) => Promise<T>): Promise<T>;
+    /** 单连接 + 引擎锁内跑 schema/迁移/dims；Postgres 用 advisory lock，PGLite 用 data-dir 锁。 */
+    bootstrap(fn: (conn: SqlConn) => Promise<void>): Promise<void>;
+    close(): Promise<void>;
+}
+/** Postgres advisory lock 的固定 key（任意稳定 bigint）。 */
+export declare const MEMKIN_LOCK_KEY = 469853105969n;
+//# sourceMappingURL=sql-executor.d.ts.map

package/dist/store/sql-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-executor.d.ts","sourceRoot":"","sources":["../../src/store/sql-executor.ts"],"names":[],"mappings":"AACA,sEAAsE;AACtE,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,oDAAoD;IACpD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,+EAA+E;IAC/E,SAAS,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,mDAAmD;AACnD,eAAO,MAAM,eAAe,gBAAgB,CAAC"}

package/dist/store/sql-executor.js

@@ -0,0 +1,3 @@
+/** Postgres advisory lock 的固定 key（任意稳定 bigint）。 */
+export const MEMKIN_LOCK_KEY = 0x6d656d6f31n; // "memo1"
+//# sourceMappingURL=sql-executor.js.map

package/dist/store/sql-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-executor.js","sourceRoot":"","sources":["../../src/store/sql-executor.ts"],"names":[],"mappings":"AAeA,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,UAAU"}

package/dist/store/store-meta.d.ts

@@ -0,0 +1,10 @@
+import type { SqlConn } from "./sql-executor.js";
+export interface EmbeddingFingerprint {
+    provider: string;
+    model: string;
+    dimensions: number;
+}
+export declare function readMeta(conn: SqlConn, key: string): Promise<string | null>;
+export declare function writeMeta(conn: SqlConn, key: string, value: string): Promise<void>;
+export declare function fingerprintString(fp: EmbeddingFingerprint): string;
+//# sourceMappingURL=store-meta.d.ts.map

package/dist/store/store-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-meta.d.ts","sourceRoot":"","sources":["../../src/store/store-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKjF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,oBAAoB,GAAG,MAAM,CAElE"}

package/dist/store/store-meta.js

@@ -0,0 +1,13 @@
+export async function readMeta(conn, key) {
+    const r = await conn.query("SELECT value FROM memkin_meta WHERE key = $1", [
+        key,
+    ]);
+    return r.rows[0]?.value ?? null;
+}
+export async function writeMeta(conn, key, value) {
+    await conn.query("INSERT INTO memkin_meta (key, value) VALUES ($1,$2) ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value", [key, value]);
+}
+export function fingerprintString(fp) {
+    return `${fp.provider}:${fp.model}:${fp.dimensions}`;
+}
+//# sourceMappingURL=store-meta.js.map

package/dist/store/store-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-meta.js","sourceRoot":"","sources":["../../src/store/store-meta.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAa,EAAE,GAAW;IACvD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAoB,8CAA8C,EAAE;QAC5F,GAAG;KACJ,CAAC,CAAC;IACH,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAa,EAAE,GAAW,EAAE,KAAa;IACvE,MAAM,IAAI,CAAC,KAAK,CACd,4GAA4G,EAC5G,CAAC,GAAG,EAAE,KAAK,CAAC,CACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAwB;IACxD,OAAO,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;AACvD,CAAC"}

package/dist/store/tags.d.ts

@@ -0,0 +1,10 @@
+import type { SqlConn } from "./sql-executor.js";
+export declare class TagStore {
+    private pg;
+    constructor(pg: SqlConn);
+    addTag(slug: string, tag: string): Promise<void>;
+    removeTag(slug: string, tag: string): Promise<void>;
+    getTags(slug: string): Promise<string[]>;
+    getAllTagsGrouped(): Promise<Map<string, string[]>>;
+}
+//# sourceMappingURL=tags.d.ts.map

package/dist/store/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/store/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUjD,qBAAa,QAAQ;IACP,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO;IAEzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQxC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAY1D"}

package/dist/store/tags.js

@@ -0,0 +1,35 @@
+export class TagStore {
+    pg;
+    constructor(pg) {
+        this.pg = pg;
+    }
+    async addTag(slug, tag) {
+        const result = await this.pg.query(`INSERT INTO tags (page_id, tag)
+       SELECT id, $2 FROM pages WHERE slug = $1
+       ON CONFLICT (page_id, tag) DO UPDATE SET tag = EXCLUDED.tag
+       RETURNING id`, [slug, tag]);
+        if (result.rows.length === 0) {
+            throw new Error(`Page not found: ${slug}`);
+        }
+    }
+    async removeTag(slug, tag) {
+        await this.pg.query(`DELETE FROM tags WHERE page_id = (SELECT id FROM pages WHERE slug = $1) AND tag = $2`, [slug, tag]);
+    }
+    async getTags(slug) {
+        const result = await this.pg.query(`SELECT t.tag FROM tags t JOIN pages p ON p.id = t.page_id WHERE p.slug = $1 ORDER BY t.tag`, [slug]);
+        return result.rows.map((r) => r.tag);
+    }
+    async getAllTagsGrouped() {
+        const result = await this.pg.query(`SELECT p.slug, t.tag FROM tags t JOIN pages p ON p.id = t.page_id ORDER BY p.slug, t.tag`);
+        const grouped = new Map();
+        for (const row of result.rows) {
+            const list = grouped.get(row.slug);
+            if (list)
+                list.push(row.tag);
+            else
+                grouped.set(row.slug, [row.tag]);
+        }
+        return grouped;
+    }
+}
+//# sourceMappingURL=tags.js.map

package/dist/store/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/store/tags.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,QAAQ;IACC;IAApB,YAAoB,EAAW;QAAX,OAAE,GAAF,EAAE,CAAS;IAAG,CAAC;IAEnC,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,GAAW;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC;;;oBAGc,EACd,CAAC,IAAI,EAAE,GAAG,CAAC,CACZ,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,GAAW;QACvC,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CACjB,sFAAsF,EACtF,CAAC,IAAI,EAAE,GAAG,CAAC,CACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC,4FAA4F,EAC5F,CAAC,IAAI,CAAC,CACP,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC,0FAA0F,CAC3F,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;gBACxB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/store/timeline.d.ts

@@ -0,0 +1,38 @@
+import type { MemoryFilter, SourceRef } from "../core/types.js";
+import type { SqlConn } from "./sql-executor.js";
+export interface TimelineEntry {
+    id: number;
+    page_id: number;
+    date: string;
+    summary: string;
+    detail: string;
+    source: string;
+    provenance?: SourceRef;
+    created_at: string;
+}
+export interface TimelineFeedEntry {
+    slug: string;
+    title: string;
+    type: string;
+    summary: string;
+    snippet: string;
+    time: string;
+    provenance?: SourceRef;
+}
+export declare class TimelineStore {
+    private pg;
+    constructor(pg: SqlConn);
+    addEntry(pageSlug: string, entry: {
+        date: string;
+        summary: string;
+        detail?: string;
+        source?: string;
+        provenance?: SourceRef;
+    }): Promise<void>;
+    getTimeline(pageSlug: string): Promise<TimelineEntry[]>;
+    feed(opts?: MemoryFilter & {
+        query?: string;
+    }): Promise<TimelineFeedEntry[]>;
+    getAllTimelineGrouped(): Promise<Map<string, TimelineEntry[]>>;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/dist/store/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/store/timeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAgID,qBAAa,aAAa;IACZ,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,OAAO;IAEzB,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,SAAS,CAAC;KACxB,GACA,OAAO,CAAC,IAAI,CAAC;IAuBV,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAcvD,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAqC5E,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAerE"}