memkin 0.4.0

package/dist/store/timeline.js

@@ -0,0 +1,173 @@
+import { compactSourceRef } from "../core/source-ref.js";
+const DEFAULT_TIMELINE_LIMIT = 20;
+const MAX_TIMELINE_LIMIT = 100;
+function clampLimit(limit) {
+    if (!Number.isFinite(limit) || (limit ?? 0) <= 0)
+        return DEFAULT_TIMELINE_LIMIT;
+    return Math.min(Math.floor(limit), MAX_TIMELINE_LIMIT);
+}
+function asArray(value) {
+    if (value === undefined)
+        return undefined;
+    return Array.isArray(value) ? value : [value];
+}
+function sourceJson() {
+    return `COALESCE(te.provenance, p.frontmatter->'source', p.frontmatter->'first_seen')`;
+}
+function sourceField(field) {
+    return `COALESCE(te.provenance->>'${field}', p.frontmatter->'source'->>'${field}', p.frontmatter->'first_seen'->>'${field}')`;
+}
+function isDateOnly(value) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(value);
+}
+function parseProvenance(value) {
+    if (!value)
+        return undefined;
+    if (typeof value === "string") {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return value;
+}
+function addFeedFilters(conditions, params, opts) {
+    if (opts?.query) {
+        params.push(`%${opts.query}%`);
+        conditions.push(`(te.summary ILIKE $${params.length} OR te.detail ILIKE $${params.length} OR p.title ILIKE $${params.length})`);
+    }
+    const addArrayCondition = (field) => {
+        const values = asArray(opts?.[field]);
+        if (!values || values.length === 0)
+            return;
+        params.push(values);
+        conditions.push(`${sourceField(field)} = ANY($${params.length}::text[])`);
+    };
+    addArrayCondition("platform");
+    addArrayCondition("source_type");
+    if (opts?.channel) {
+        params.push(opts.channel);
+        conditions.push(`${sourceField("channel")} = $${params.length}`);
+    }
+    if (opts?.channel_name) {
+        params.push(opts.channel_name);
+        conditions.push(`${sourceField("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()}->'participants', '[]'::jsonb)) AS participant
+        WHERE participant->>'name' = ${param} OR participant->>'id' = ${param}
+      )
+      OR ${sourceJson()}->'author'->>'name' = ${param}
+      OR ${sourceJson()}->'author'->>'id' = ${param}
+    )`);
+    }
+    if (opts?.type && opts.type.length > 0) {
+        params.push(opts.type);
+        conditions.push(`p.type = ANY($${params.length}::text[])`);
+    }
+    if (opts?.exclude_types && opts.exclude_types.length > 0) {
+        params.push(opts.exclude_types);
+        conditions.push(`p.type != ALL($${params.length}::text[])`);
+    }
+    if (opts?.from) {
+        params.push(opts.from);
+        conditions.push(`te.date::timestamptz >= $${params.length}::timestamptz`);
+    }
+    if (opts?.to) {
+        params.push(opts.to);
+        if (isDateOnly(opts.to)) {
+            conditions.push(`te.date::timestamptz < ($${params.length}::date + interval '1 day')`);
+        }
+        else {
+            conditions.push(`te.date::timestamptz <= $${params.length}::timestamptz`);
+        }
+    }
+}
+export class TimelineStore {
+    pg;
+    constructor(pg) {
+        this.pg = pg;
+    }
+    async addEntry(pageSlug, entry) {
+        const result = await this.pg.query(`INSERT INTO timeline_entries (page_id, date, summary, detail, source, provenance)
+       SELECT id, $2, $3, $4, $5, $6 FROM pages WHERE slug = $1
+       ON CONFLICT (page_id, date, summary) DO UPDATE SET
+         detail = EXCLUDED.detail,
+         source = EXCLUDED.source,
+         provenance = COALESCE(EXCLUDED.provenance, timeline_entries.provenance)
+       RETURNING id`, [
+            pageSlug,
+            entry.date,
+            entry.summary,
+            entry.detail ?? "",
+            entry.source ?? "",
+            entry.provenance ? JSON.stringify(compactSourceRef(entry.provenance)) : null,
+        ]);
+        if (result.rows.length === 0) {
+            throw new Error(`Page not found: ${pageSlug}`);
+        }
+    }
+    async getTimeline(pageSlug) {
+        const result = await this.pg.query(`SELECT te.* FROM timeline_entries te
+       JOIN pages p ON p.id = te.page_id
+       WHERE p.slug = $1
+       ORDER BY te.date DESC`, [pageSlug]);
+        return result.rows.map((row) => ({
+            ...row,
+            provenance: parseProvenance(row.provenance ?? null),
+        }));
+    }
+    async feed(opts) {
+        const conditions = [];
+        const params = [];
+        addFeedFilters(conditions, params, opts);
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const limit = clampLimit(opts?.limit);
+        params.push(limit);
+        const result = await this.pg.query(`SELECT
+         p.slug,
+         p.title,
+         p.type,
+         te.summary,
+         COALESCE(NULLIF(te.detail, ''), LEFT(p.compiled_truth, 200)) AS snippet,
+         te.date AS time,
+         ${sourceJson()} AS provenance
+       FROM timeline_entries te
+       JOIN pages p ON p.id = te.page_id
+       ${whereClause}
+       ORDER BY te.date DESC, te.created_at DESC
+       LIMIT $${params.length}`, params);
+        return result.rows.map((row) => ({
+            slug: row.slug,
+            title: row.title,
+            type: row.type,
+            summary: row.summary,
+            snippet: row.snippet,
+            time: row.time,
+            provenance: parseProvenance(row.provenance),
+        }));
+    }
+    async getAllTimelineGrouped() {
+        const result = await this.pg.query(`SELECT te.*, p.slug AS slug FROM timeline_entries te
+       JOIN pages p ON p.id = te.page_id
+       ORDER BY p.slug, te.date DESC`);
+        const grouped = new Map();
+        for (const row of result.rows) {
+            const { slug, ...entry } = row;
+            const list = grouped.get(slug);
+            if (list)
+                list.push(entry);
+            else
+                grouped.set(slug, [entry]);
+        }
+        return grouped;
+    }
+}
+//# sourceMappingURL=timeline.js.map

package/dist/store/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../src/store/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA2CzD,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,SAAS,UAAU,CAAC,KAAyB;IAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAe,CAAC,EAAE,kBAAkB,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,OAAO,CAAC,KAAoC;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,+EAA+E,CAAC;AACzF,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,6BAA6B,KAAK,iCAAiC,KAAK,qCAAqC,KAAK,IAAI,CAAC;AAChI,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,eAAe,CAAC,KAAgC;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAc,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CACrB,UAAoB,EACpB,MAAiB,EACjB,IAAwC;IAExC,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAC/B,UAAU,CAAC,IAAI,CACb,sBAAsB,MAAM,CAAC,MAAM,wBAAwB,MAAM,CAAC,MAAM,sBAAsB,MAAM,CAAC,MAAM,GAAG,CAC/G,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,CAAC,KAAiC,EAAE,EAAE;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC3C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;IAC5E,CAAC,CAAC;IAEF,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC9B,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAEjC,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,IAAI,EAAE,YAAY,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/B,UAAU,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,UAAU,CAAC,IAAI,CAAC;;;6CAGyB,UAAU,EAAE;uCAClB,KAAK,4BAA4B,KAAK;;WAElE,UAAU,EAAE,yBAAyB,KAAK;WAC1C,UAAU,EAAE,uBAAuB,KAAK;MAC7C,CAAC,CAAC;IACN,CAAC;IAED,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,MAAM,4BAA4B,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,EAAW;QAAX,OAAE,GAAF,EAAE,CAAS;IAAG,CAAC;IAEnC,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,KAMC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC;;;;;;oBAMc,EACd;YACE,QAAQ;YACR,KAAK,CAAC,IAAI;YACV,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,MAAM,IAAI,EAAE;YAClB,KAAK,CAAC,MAAM,IAAI,EAAE;YAClB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;SAC7E,CACF,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC;;;6BAGuB,EACvB,CAAC,QAAQ,CAAC,CACX,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,GAAG;YACN,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC;SACpD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAwC;QACjD,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC;;;;;;;WAOK,UAAU,EAAE;;;SAGd,WAAW;;gBAEJ,MAAM,CAAC,MAAM,EAAE,EACzB,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;SAC5C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC;;qCAE+B,CAChC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;QACnD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,GAAG,CAAC;YAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAsB,CAAC,CAAC;;gBACvC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAsB,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/store/trgm-search.d.ts

@@ -0,0 +1,13 @@
+/** Split a query into terms on whitespace; drop empties. Intra-term chars (e.g. "gpt-4") are kept. */
+export declare function splitTerms(query: string): string[];
+/** Escape ILIKE wildcards for use with `ESCAPE '\'`. Order matters: backslash first. */
+export declare function escapeIlikeTerm(term: string): string;
+/**
+ * Build an AND-of-OR `ILIKE` fragment for trigram substring recall across `columns`.
+ * Pushes one `%term%` param per term into `params` (continuing from its current length)
+ * and returns the SQL fragment, or null if there are no terms.
+ */
+export declare function buildTrgmConditions(terms: string[], columns: string[], params: unknown[]): string | null;
+/** Case-insensitive snippet around the first matching term, wrapping the match in `**…**`. */
+export declare function buildSnippet(text: string, terms: string[], window?: number): string;
+//# sourceMappingURL=trgm-search.d.ts.map

package/dist/store/trgm-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trgm-search.d.ts","sourceRoot":"","sources":["../../src/store/trgm-search.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAElD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,OAAO,EAAE,GAChB,MAAM,GAAG,IAAI,CAUf;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,SAAK,GAAG,MAAM,CAsB/E"}

package/dist/store/trgm-search.js

@@ -0,0 +1,53 @@
+/** Split a query into terms on whitespace; drop empties. Intra-term chars (e.g. "gpt-4") are kept. */
+export function splitTerms(query) {
+    return query.trim().split(/\s+/).filter(Boolean);
+}
+/** Escape ILIKE wildcards for use with `ESCAPE '\'`. Order matters: backslash first. */
+export function escapeIlikeTerm(term) {
+    return term.replace(/\\/g, "\\\\").replace(/%/g, "\\%").replace(/_/g, "\\_");
+}
+/**
+ * Build an AND-of-OR `ILIKE` fragment for trigram substring recall across `columns`.
+ * Pushes one `%term%` param per term into `params` (continuing from its current length)
+ * and returns the SQL fragment, or null if there are no terms.
+ */
+export function buildTrgmConditions(terms, columns, params) {
+    if (terms.length === 0)
+        return null;
+    const groups = [];
+    for (const term of terms) {
+        params.push(`%${escapeIlikeTerm(term)}%`);
+        const idx = params.length;
+        const ors = columns.map((c) => `${c} ILIKE $${idx} ESCAPE '\\'`);
+        groups.push(`(${ors.join(" OR ")})`);
+    }
+    return groups.join(" AND ");
+}
+/** Case-insensitive snippet around the first matching term, wrapping the match in `**…**`. */
+export function buildSnippet(text, terms, window = 40) {
+    if (!text)
+        return "";
+    const lower = text.toLowerCase();
+    let pos = -1;
+    let matchLen = 0;
+    for (const term of terms) {
+        if (!term)
+            continue;
+        const i = lower.indexOf(term.toLowerCase());
+        if (i !== -1 && (pos === -1 || i < pos)) {
+            pos = i;
+            matchLen = term.length;
+        }
+    }
+    if (pos === -1)
+        return text.slice(0, window * 2);
+    const start = Math.max(0, pos - window);
+    const end = Math.min(text.length, pos + matchLen + window);
+    const prefix = start > 0 ? "…" : "";
+    const suffix = end < text.length ? "…" : "";
+    const before = text.slice(start, pos);
+    const match = text.slice(pos, pos + matchLen);
+    const after = text.slice(pos + matchLen, end);
+    return `${prefix}${before}**${match}**${after}${suffix}`;
+}
+//# sourceMappingURL=trgm-search.js.map

package/dist/store/trgm-search.js.map

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

package/dist/store/wikilink.d.ts

@@ -0,0 +1,17 @@
+import type { LinkType } from "../core/types.js";
+export interface ParsedWikiLink {
+    to: string;
+    type: LinkType;
+}
+/**
+ * Parse wikilinks out of text (Spec 10 §4). Zero-LLM, rule-based.
+ *
+ *   [[slug]]          -> { to: slug, type: "mentions" }
+ *   [[rel:slug]]      -> { to: slug, type: rel }   (rel must be a LinkType)
+ *   [[unknown:slug]]  -> { to: slug, type: "custom" }
+ *
+ * Whitespace inside the brackets (and around the rel separator) is trimmed.
+ * Empty/malformed entries (no slug) are skipped. Results are deduped on to+type.
+ */
+export declare function parseWikiLinks(text: string): ParsedWikiLink[];
+//# sourceMappingURL=wikilink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wikilink.d.ts","sourceRoot":"","sources":["../../src/store/wikilink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAsBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CA8B7D"}

package/dist/store/wikilink.js

@@ -0,0 +1,58 @@
+const LINK_TYPES = new Set([
+    "works_on",
+    "works_at",
+    "reports_to",
+    "collaborates",
+    "depends_on",
+    "mentions",
+    "approves",
+    "uses",
+    // Spec 11 playbook hierarchy/sequence rels — keep in sync with LinkType union.
+    "part_of",
+    "precedes",
+    "next",
+    "escalates_to",
+    "custom",
+]);
+// Matches [[ ... ]] capturing the inner text.
+const WIKILINK_RE = /\[\[([^\]]+)\]\]/g;
+/**
+ * Parse wikilinks out of text (Spec 10 §4). Zero-LLM, rule-based.
+ *
+ *   [[slug]]          -> { to: slug, type: "mentions" }
+ *   [[rel:slug]]      -> { to: slug, type: rel }   (rel must be a LinkType)
+ *   [[unknown:slug]]  -> { to: slug, type: "custom" }
+ *
+ * Whitespace inside the brackets (and around the rel separator) is trimmed.
+ * Empty/malformed entries (no slug) are skipped. Results are deduped on to+type.
+ */
+export function parseWikiLinks(text) {
+    const out = [];
+    const seen = new Set();
+    for (const match of text.matchAll(WIKILINK_RE)) {
+        const inner = match[1].trim();
+        if (!inner)
+            continue;
+        let to;
+        let type;
+        const colonIdx = inner.indexOf(":");
+        if (colonIdx === -1) {
+            to = inner;
+            type = "mentions";
+        }
+        else {
+            const rawRel = inner.slice(0, colonIdx).trim();
+            to = inner.slice(colonIdx + 1).trim();
+            type = LINK_TYPES.has(rawRel) ? rawRel : "custom";
+        }
+        if (!to)
+            continue;
+        const key = `${to}\u0000${type}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push({ to, type });
+    }
+    return out;
+}
+//# sourceMappingURL=wikilink.js.map

package/dist/store/wikilink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilink.js","sourceRoot":"","sources":["../../src/store/wikilink.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,GAAwB,IAAI,GAAG,CAAW;IACxD,UAAU;IACV,UAAU;IACV,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,UAAU;IACV,UAAU;IACV,MAAM;IACN,+EAA+E;IAC/E,SAAS;IACT,UAAU;IACV,MAAM;IACN,cAAc;IACd,QAAQ;CACT,CAAC,CAAC;AAEH,8CAA8C;AAC9C,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,IAAI,EAAU,CAAC;QACf,IAAI,IAAc,CAAC;QAEnB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,EAAE,GAAG,KAAK,CAAC;YACX,IAAI,GAAG,UAAU,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,EAAE;YAAE,SAAS;QAElB,MAAM,GAAG,GAAG,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/sync/obsidian.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Obsidian vault bidirectional sync.
+ *
+ * Implements `memkin export --vault <path>` and `memkin import --vault <path>`.
+ * See spec: docs/specs/memkin-2026-06-04-obsidian-sync.md (v7).
+ */
+import type { ChunkStore } from "../store/chunks.js";
+import type { Database } from "../store/database.js";
+import type { GraphStore, LinkRow } from "../store/graph.js";
+import type { Page, PageStore } from "../store/pages.js";
+import type { TagStore } from "../store/tags.js";
+import type { TimelineEntry, TimelineStore } from "../store/timeline.js";
+/**
+ * Serialize a Page into Obsidian-compatible markdown.
+ *
+ * Fixes applied:
+ *   H1: explicit fields written AFTER `...page.frontmatter` so they cannot be
+ *       clobbered by user-supplied frontmatter that happens to share a key.
+ *   M1: `updated_at` is NOT written to frontmatter — it would change every export
+ *       even when content is identical, defeating incremental sync.
+ *   N3: rebuild `## Aliases` body section from `frontmatter.aliases` each time
+ *       (frontmatter is the single source of truth; the body section is derived).
+ */
+export declare function serializePage(page: Page, tags: string[], links: LinkRow[], timeline: TimelineEntry[], userEdited: boolean): string;
+/**
+ * Strip `## Aliases\n\n- ...` section if it appears at the start of body.
+ *
+ * Only matches at body start so that mid-body Aliases-like headings stay intact.
+ */
+export declare function stripAliasesSection(body: string): string;
+export interface SplitBodyResult {
+    mainBody: string;
+    related: string;
+    timeline: string;
+    orderError: boolean;
+}
+/**
+ * Split body into three sections by HTML comment markers.
+ *
+ * Fixes:
+ *   M3: detect marker order reversal (timeline before related) and signal error.
+ */
+export declare function splitBody(body: string): SplitBodyResult;
+/** Validate slug: Unicode-safe + Windows reserved + length (H3 + L6). */
+export declare function isValidSlug(slug: string): boolean;
+/** Convert a file path (relative to vault root) to slug. */
+export declare function slugifyPath(relativePath: string): string;
+/** Extract all wikilink targets from text, stripping display suffix. */
+export declare function extractWikilinks(text: string): string[];
+export interface ParseVaultFileResult {
+    slug: string;
+    cleanMarkdown: string;
+    tags: string[];
+    links: string[];
+}
+/**
+ * Parse a vault markdown file into the pieces needed for putPage / addTag / addLink.
+ *
+ * Fixes:
+ *   H2-incomplete: filter links by type — only obsidian and bare strings are
+ *                  taken as user-editable; pipeline-managed types (works_on,
+ *                  collaborates, etc.) are ignored here so they cannot be
+ *                  duplicated as obsidian-type edges on round-trip.
+ *   H4: inject user_edited=true into cleanMarkdown so putPage persists the lock.
+ *   M3: throw if body marker order is reversed.
+ *   M7: timeline section is NOT parsed (export-only).
+ *   L4: body `## Aliases` section is not interpreted — only frontmatter is.
+ */
+export declare function parseVaultFile(content: string, relativePath: string): ParseVaultFileResult;
+export interface ManifestPageEntry {
+    file_hash: string;
+    db_content_hash_at_last_sync: string;
+    last_synced_at: string;
+    last_synced_op: "export" | "import";
+    user_edited: boolean;
+}
+export interface SyncManifest {
+    version: number;
+    last_sync_at: string;
+    last_sync_op: "export" | "import";
+    pages: Record<string, ManifestPageEntry>;
+}
+/** Load the sync manifest from a vault. Returns null if missing or invalid. */
+export declare function loadManifest(vaultPath: string): Promise<SyncManifest | null>;
+/**
+ * Atomically write the sync manifest (M8 + N2).
+ *
+ * Procedure:
+ *   1. open(tmpPath, "w") → write JSON → handle.sync() → handle.close()
+ *   2. rename(tmpPath, targetPath) — POSIX atomic
+ *   3. On error: close handle if open, unlink tmp
+ *
+ * Note: Node `fs.fsync()` takes a file descriptor, not a path. We use
+ * `FileHandle.sync()` which is the FileHandle API's wrapper around fsync(fd).
+ */
+export declare function saveManifest(vaultPath: string, manifest: SyncManifest): Promise<void>;
+export interface SyncStores {
+    db: Database;
+    pages: PageStore;
+    graph: GraphStore;
+    tags: TagStore;
+    timeline: TimelineStore;
+    chunks: ChunkStore;
+}
+export interface ExportOpts {
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface ExportResult {
+    written: number;
+    skipped: number;
+    errors: Array<{
+        slug: string;
+        reason: string;
+    }>;
+}
+export interface ImportOpts {
+    force?: boolean;
+    dryRun?: boolean;
+    strictConflict?: boolean;
+}
+export interface ImportResult {
+    imported: number;
+    skipped: number;
+    errors: Array<{
+        file: string;
+        reason: string;
+    }>;
+    warnings: Array<{
+        slug: string;
+        reason: string;
+    }>;
+}
+export declare function exportToVault(stores: SyncStores, vaultPath: string, opts?: ExportOpts): Promise<ExportResult>;
+export declare function importFromVault(stores: SyncStores, vaultPath: string, opts?: ImportOpts): Promise<ImportResult>;
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/sync/obsidian.d.ts.map

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