@andre.li/memoark 0.3.1

package/dist/store/graph.d.ts

@@ -0,0 +1,53 @@
+import type { PGlite } from "@electric-sql/pglite";
+import type { SourceRef } from "../core/types.js";
+export interface LinkRow {
+    from_slug: string;
+    to_slug: string;
+    link_type: string;
+    context: string;
+    provenance?: SourceRef;
+}
+export interface EnrichedLinkRow extends LinkRow {
+    page: {
+        title: string;
+        type: string;
+        frontmatter: Record<string, unknown>;
+    };
+}
+export interface GraphNode {
+    slug: string;
+    title: string;
+    type: string;
+    depth: number;
+}
+export interface GraphEdge {
+    from_slug: string;
+    to_slug: string;
+    link_type: string;
+}
+export interface TraverseResult {
+    focus: {
+        slug: string;
+        title: string;
+        type: string;
+    };
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export declare class GraphStore {
+    private pg;
+    constructor(pg: PGlite);
+    addLink(fromSlug: string, toSlug: string, type: string, context?: string, provenance?: SourceRef, sourceHash?: string): Promise<void>;
+    removeLink(fromSlug: string, toSlug: string): Promise<void>;
+    getLinks(slug: string): Promise<LinkRow[]>;
+    getAllLinksGrouped(): Promise<Map<string, LinkRow[]>>;
+    getBacklinks(slug: string): Promise<LinkRow[]>;
+    getLinksEnriched(slug: string): Promise<EnrichedLinkRow[]>;
+    getLinksForSlugs(slugs: string[]): Promise<Map<string, LinkRow[]>>;
+    getBacklinksEnriched(slug: string): Promise<EnrichedLinkRow[]>;
+    traverse(slug: string, opts?: {
+        depth?: number;
+        direction?: "in" | "out" | "both";
+    }): Promise<TraverseResult>;
+}
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/store/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC7E;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAwBD,qBAAa,UAAU;IACT,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,MAAM;IAExB,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,SAAS,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAkBV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAY1C,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAiBrD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAY9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+B1D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAmBlE,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+B9D,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAA;KAAE,GAC3D,OAAO,CAAC,cAAc,CAAC;CAsF3B"}

package/dist/store/graph.js

@@ -0,0 +1,186 @@
+export class GraphStore {
+    pg;
+    constructor(pg) {
+        this.pg = pg;
+    }
+    async addLink(fromSlug, toSlug, type, context, provenance, sourceHash) {
+        await this.pg.query(`INSERT INTO links (from_page_id, to_page_id, link_type, context, provenance, source_hash)
+       SELECT f.id, t.id, $3, $4, $5, $6
+       FROM pages f, pages t
+       WHERE f.slug = $1 AND t.slug = $2
+       ON CONFLICT (from_page_id, to_page_id, link_type) DO UPDATE SET context = EXCLUDED.context`, [
+            fromSlug,
+            toSlug,
+            type,
+            context ?? "",
+            provenance ? JSON.stringify(provenance) : null,
+            sourceHash ?? null,
+        ]);
+    }
+    async removeLink(fromSlug, toSlug) {
+        await this.pg.query(`DELETE FROM links
+       WHERE from_page_id = (SELECT id FROM pages WHERE slug = $1)
+         AND to_page_id = (SELECT id FROM pages WHERE slug = $2)`, [fromSlug, toSlug]);
+    }
+    async getLinks(slug) {
+        const result = await this.pg.query(`SELECT pf.slug AS from_slug, pt.slug AS to_slug, l.link_type, l.context, l.provenance
+       FROM links l
+       JOIN pages pf ON pf.id = l.from_page_id
+       JOIN pages pt ON pt.id = l.to_page_id
+       WHERE pf.slug = $1`, [slug]);
+        return result.rows;
+    }
+    async getAllLinksGrouped() {
+        const result = await this.pg.query(`SELECT pf.slug AS from_slug, pt.slug AS to_slug, l.link_type, l.context, l.provenance
+       FROM links l
+       JOIN pages pf ON pf.id = l.from_page_id
+       JOIN pages pt ON pt.id = l.to_page_id
+       ORDER BY pf.slug, pt.slug`);
+        const grouped = new Map();
+        for (const row of result.rows) {
+            const list = grouped.get(row.from_slug);
+            if (list)
+                list.push(row);
+            else
+                grouped.set(row.from_slug, [row]);
+        }
+        return grouped;
+    }
+    async getBacklinks(slug) {
+        const result = await this.pg.query(`SELECT pf.slug AS from_slug, pt.slug AS to_slug, l.link_type, l.context, l.provenance
+       FROM links l
+       JOIN pages pf ON pf.id = l.from_page_id
+       JOIN pages pt ON pt.id = l.to_page_id
+       WHERE pt.slug = $1`, [slug]);
+        return result.rows;
+    }
+    async getLinksEnriched(slug) {
+        const result = await this.pg.query(`SELECT pf.slug AS from_slug, pt.slug AS to_slug, l.link_type, l.context, l.provenance,
+              pt.title AS page_title, pt.type AS page_type, pt.frontmatter AS page_frontmatter
+       FROM links l
+       JOIN pages pf ON pf.id = l.from_page_id
+       JOIN pages pt ON pt.id = l.to_page_id
+       WHERE pf.slug = $1`, [slug]);
+        return result.rows.map((r) => {
+            const frontmatter = typeof r.page_frontmatter === "string"
+                ? JSON.parse(r.page_frontmatter)
+                : r.page_frontmatter;
+            return {
+                from_slug: r.from_slug,
+                to_slug: r.to_slug,
+                link_type: r.link_type,
+                context: r.context,
+                provenance: r.provenance ? JSON.parse(r.provenance) : undefined,
+                page: {
+                    title: r.page_title,
+                    type: r.page_type,
+                    frontmatter: frontmatter ?? {},
+                },
+            };
+        });
+    }
+    async getLinksForSlugs(slugs) {
+        if (slugs.length === 0)
+            return new Map();
+        const result = await this.pg.query(`SELECT pf.slug AS from_slug, pt.slug AS to_slug, l.link_type, l.context, l.provenance
+       FROM links l
+       JOIN pages pf ON pf.id = l.from_page_id
+       JOIN pages pt ON pt.id = l.to_page_id
+       WHERE pf.slug = ANY($1::text[])`, [slugs]);
+        const map = new Map();
+        for (const row of result.rows) {
+            const existing = map.get(row.from_slug) ?? [];
+            existing.push(row);
+            map.set(row.from_slug, existing);
+        }
+        return map;
+    }
+    async getBacklinksEnriched(slug) {
+        const result = await this.pg.query(`SELECT pf.slug AS from_slug, pt.slug AS to_slug, l.link_type, l.context, l.provenance,
+              pf.title AS page_title, pf.type AS page_type, pf.frontmatter AS page_frontmatter
+       FROM links l
+       JOIN pages pf ON pf.id = l.from_page_id
+       JOIN pages pt ON pt.id = l.to_page_id
+       WHERE pt.slug = $1`, [slug]);
+        return result.rows.map((r) => {
+            const frontmatter = typeof r.page_frontmatter === "string"
+                ? JSON.parse(r.page_frontmatter)
+                : r.page_frontmatter;
+            return {
+                from_slug: r.from_slug,
+                to_slug: r.to_slug,
+                link_type: r.link_type,
+                context: r.context,
+                provenance: r.provenance ? JSON.parse(r.provenance) : undefined,
+                page: {
+                    title: r.page_title,
+                    type: r.page_type,
+                    frontmatter: frontmatter ?? {},
+                },
+            };
+        });
+    }
+    async traverse(slug, opts) {
+        const maxDepth = Math.min(opts?.depth ?? 5, 10);
+        const direction = opts?.direction ?? "out";
+        // Query focus node
+        const focusQuery = await this.pg.query("SELECT slug, title, type FROM pages WHERE slug = $1", [slug]);
+        if (focusQuery.rows.length === 0) {
+            return {
+                focus: { slug, title: slug, type: "unknown" },
+                nodes: [],
+                edges: [],
+            };
+        }
+        const focus = focusQuery.rows[0];
+        const visited = new Set();
+        const nodes = [];
+        const edges = [];
+        let frontier = [slug];
+        visited.add(slug);
+        for (let d = 1; d <= maxDepth && frontier.length > 0; d++) {
+            const nextFrontier = [];
+            for (const current of frontier) {
+                const neighbors = [];
+                if (direction === "out" || direction === "both") {
+                    const out = await this.pg.query(`SELECT pt.slug, l.link_type FROM links l JOIN pages pt ON pt.id = l.to_page_id
+             WHERE l.from_page_id = (SELECT id FROM pages WHERE slug = $1)`, [current]);
+                    neighbors.push(...out.rows.map((r) => ({ slug: r.slug, link_type: r.link_type })));
+                    edges.push(...out.rows.map((r) => ({
+                        from_slug: current,
+                        to_slug: r.slug,
+                        link_type: r.link_type,
+                    })));
+                }
+                if (direction === "in" || direction === "both") {
+                    const inc = await this.pg.query(`SELECT pf.slug, l.link_type FROM links l JOIN pages pf ON pf.id = l.from_page_id
+             WHERE l.to_page_id = (SELECT id FROM pages WHERE slug = $1)`, [current]);
+                    neighbors.push(...inc.rows.map((r) => ({ slug: r.slug, link_type: r.link_type })));
+                    edges.push(...inc.rows.map((r) => ({
+                        from_slug: r.slug,
+                        to_slug: current,
+                        link_type: r.link_type,
+                    })));
+                }
+                for (const n of neighbors) {
+                    if (!visited.has(n.slug)) {
+                        visited.add(n.slug);
+                        nextFrontier.push(n.slug);
+                        const page = await this.pg.query("SELECT slug, title, type FROM pages WHERE slug = $1", [n.slug]);
+                        if (page.rows.length > 0) {
+                            const p = page.rows[0];
+                            nodes.push({ slug: p.slug, title: p.title, type: p.type, depth: d });
+                        }
+                    }
+                }
+            }
+            frontier = nextFrontier;
+        }
+        return {
+            focus: { slug: focus.slug, title: focus.title, type: focus.type },
+            nodes,
+            edges,
+        };
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/store/graph.js.map

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

package/dist/store/migrations/index.d.ts

@@ -0,0 +1,9 @@
+import type { PGlite } from "@electric-sql/pglite";
+export interface Migration {
+    version: number;
+    name: string;
+    sql: string;
+}
+export declare const MIGRATIONS: Migration[];
+export declare function runMigrations(pg: PGlite): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/store/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAoDD,eAAO,MAAM,UAAU,EAAE,SAAS,EAIjC,CAAC;AAEF,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7D"}

package/dist/store/migrations/index.js

@@ -0,0 +1,68 @@
+// Migrations are inlined as string constants (not read from .sql files at runtime) so
+// they survive bundling: the tsc-built dist/, the `bun build --compile` single-file binary,
+// and `bun src/cli.ts` all behave identically with no filesystem asset to ship. Applied
+// migrations are immutable by definition, so there is no source-of-truth drift risk.
+//
+// Add new migrations here, in ascending version order. Never edit an already-released one.
+// Migration 001: lifecycle metadata + preference type promotion.
+// Adds halflife_days to pages (drives hot/warm/cold rotation), promotes the legacy
+// discovery-preference subtype to a first-class `preference` type, then backfills
+// halflife_days for existing signal pages by type.
+const M001_LIFECYCLE_COLUMNS = `
+ALTER TABLE pages ADD COLUMN IF NOT EXISTS halflife_days INTEGER;
+
+UPDATE pages SET type = 'preference' WHERE type = 'discovery-preference';
+
+UPDATE pages SET halflife_days = 90
+  WHERE type IN ('decision', 'task', 'preference') OR type LIKE 'discovery-%';
+UPDATE pages SET halflife_days = 365
+  WHERE type = 'knowledge';
+`;
+// Migration 002: backfill provenance/source_hash columns (signal fidelity) for databases
+// that ran migration 001 before schema.sql included them.
+const M002_PROVENANCE_COLUMNS = `
+ALTER TABLE links ADD COLUMN IF NOT EXISTS provenance JSONB;
+ALTER TABLE links ADD COLUMN IF NOT EXISTS source_hash TEXT;
+ALTER TABLE timeline_entries ADD COLUMN IF NOT EXISTS provenance JSONB;
+`;
+// Migration 003: lifecycle tier columns + indexes for pages and timeline_entries, and a
+// backfill of expires_at for existing hot pages that have a halflife.
+const M003_LIFECYCLE_TIER = `
+ALTER TABLE pages ADD COLUMN IF NOT EXISTS tier TEXT NOT NULL DEFAULT 'hot';
+ALTER TABLE pages ADD COLUMN IF NOT EXISTS expires_at TIMESTAMPTZ;
+ALTER TABLE pages ADD COLUMN IF NOT EXISTS consolidated_into INTEGER REFERENCES pages(id);
+
+CREATE INDEX IF NOT EXISTS idx_pages_tier ON pages (tier);
+CREATE INDEX IF NOT EXISTS idx_pages_expires_at ON pages (expires_at) WHERE expires_at IS NOT NULL;
+
+ALTER TABLE timeline_entries ADD COLUMN IF NOT EXISTS tier TEXT NOT NULL DEFAULT 'hot';
+ALTER TABLE timeline_entries ADD COLUMN IF NOT EXISTS expires_at TIMESTAMPTZ;
+
+UPDATE pages
+SET expires_at = created_at + (halflife_days * INTERVAL '1 day')
+WHERE tier = 'hot'
+  AND halflife_days IS NOT NULL
+  AND expires_at IS NULL;
+`;
+export const MIGRATIONS = [
+    { version: 1, name: "lifecycle_columns", sql: M001_LIFECYCLE_COLUMNS },
+    { version: 2, name: "provenance_columns", sql: M002_PROVENANCE_COLUMNS },
+    { version: 3, name: "lifecycle_tier", sql: M003_LIFECYCLE_TIER },
+];
+export async function runMigrations(pg) {
+    await pg.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version    INTEGER PRIMARY KEY,
+      applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    )
+  `);
+    const applied = await pg.query("SELECT version FROM schema_migrations");
+    const appliedVersions = new Set(applied.rows.map((r) => r.version));
+    for (const migration of MIGRATIONS) {
+        if (appliedVersions.has(migration.version))
+            continue;
+        await pg.exec(migration.sql);
+        await pg.query("INSERT INTO schema_migrations (version) VALUES ($1)", [migration.version]);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/store/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/migrations/index.ts"],"names":[],"mappings":"AAQA,sFAAsF;AACtF,4FAA4F;AAC5F,wFAAwF;AACxF,qFAAqF;AACrF,EAAE;AACF,2FAA2F;AAE3F,iEAAiE;AACjE,mFAAmF;AACnF,kFAAkF;AAClF,mDAAmD;AACnD,MAAM,sBAAsB,GAAG;;;;;;;;;CAS9B,CAAC;AAEF,yFAAyF;AACzF,0DAA0D;AAC1D,MAAM,uBAAuB,GAAG;;;;CAI/B,CAAC;AAEF,wFAAwF;AACxF,sEAAsE;AACtE,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;CAgB3B,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,sBAAsB,EAAE;IACtE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,EAAE,uBAAuB,EAAE;IACxE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,mBAAmB,EAAE;CACjE,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU;IAC5C,MAAM,EAAE,CAAC,IAAI,CAAC;;;;;GAKb,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,KAAK,CAAsB,uCAAuC,CAAC,CAAC;IAC7F,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,SAAS;QACrD,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,qDAAqD,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC"}

package/dist/store/pages.d.ts

@@ -0,0 +1,39 @@
+import type { PGlite } from "@electric-sql/pglite";
+export interface Page {
+    id: number;
+    slug: string;
+    type: string;
+    title: string;
+    compiled_truth: string;
+    frontmatter: Record<string, unknown>;
+    content_hash: string;
+    halflife_days: number | null;
+    tier: string;
+    expires_at: string | null;
+    consolidated_into: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface PutPageOptions {
+    halflife_days?: number | null;
+    expires_at?: Date | null;
+}
+export declare class PageStore {
+    private pg;
+    constructor(pg: PGlite);
+    putPage(slug: string, content: string, opts?: PutPageOptions): Promise<Page>;
+    getPage(slug: string): Promise<Page | null>;
+    deletePage(slug: string): Promise<void>;
+    listPages(opts?: {
+        type?: string;
+        exclude_types?: string[];
+        limit?: number;
+        sort?: string;
+        order?: string;
+    }): Promise<Page[]>;
+    listExpiredHot(): Promise<Page[]>;
+    updatePageTier(id: number, tier: string, consolidatedInto?: number | null): Promise<void>;
+    listPagesByTier(tier: string): Promise<Page[]>;
+    private rowToPage;
+}
+//# sourceMappingURL=pages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/store/pages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAwCD,qBAAa,SAAS;IACR,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,MAAM;IAExB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C5E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAK3C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,SAAS,CAAC,IAAI,CAAC,EAAE;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA8Cb,cAAc,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAWjC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAczF,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAQpD,OAAO,CAAC,SAAS;CAkBlB"}

package/dist/store/pages.js

@@ -0,0 +1,150 @@
+import { createHash } from "node:crypto";
+import { parse as parseYaml } from "yaml";
+function parseMarkdownWithFrontmatter(content) {
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!fmMatch) {
+        return { title: "", type: "unknown", compiled_truth: content.trim(), frontmatter: {} };
+    }
+    const fm = parseYaml(fmMatch[1]);
+    const body = fmMatch[2].trim();
+    const title = String(fm.title ?? "");
+    const type = String(fm.type ?? "unknown");
+    const { title: _t, type: _ty, ...rest } = fm;
+    return { title, type, compiled_truth: body, frontmatter: rest };
+}
+export class PageStore {
+    pg;
+    constructor(pg) {
+        this.pg = pg;
+    }
+    async putPage(slug, content, opts) {
+        const { title, type, compiled_truth, frontmatter } = parseMarkdownWithFrontmatter(content);
+        const contentHash = createHash("sha256").update(content).digest("hex");
+        const halflifeDays = opts?.halflife_days ?? null;
+        // Compute expires_at in TS to correctly handle the three-way distinction:
+        // - explicit Date: use that value
+        // - explicit null: store NULL (clear it)
+        // - undefined: auto-compute from halflife_days, or NULL if halflife_days is null
+        let expiresAt;
+        if (opts?.expires_at !== undefined) {
+            expiresAt = opts.expires_at; // Date or null, both stored as-is
+        }
+        else if (halflifeDays !== null) {
+            expiresAt = new Date(Date.now() + halflifeDays * 86_400_000);
+        }
+        else {
+            expiresAt = null;
+        }
+        const result = await this.pg.query(`INSERT INTO pages (slug, type, title, compiled_truth, frontmatter, content_hash, halflife_days, expires_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8::timestamptz)
+       ON CONFLICT (slug) DO UPDATE SET
+         type = EXCLUDED.type,
+         title = EXCLUDED.title,
+         compiled_truth = EXCLUDED.compiled_truth,
+         frontmatter = EXCLUDED.frontmatter,
+         content_hash = EXCLUDED.content_hash,
+         halflife_days = EXCLUDED.halflife_days,
+         updated_at = NOW()
+       RETURNING *`, [
+            slug,
+            type,
+            title,
+            compiled_truth,
+            JSON.stringify(frontmatter),
+            contentHash,
+            halflifeDays,
+            expiresAt,
+        ]);
+        return this.rowToPage(result.rows[0]);
+    }
+    async getPage(slug) {
+        const result = await this.pg.query("SELECT * FROM pages WHERE slug = $1", [slug]);
+        return result.rows.length > 0 ? this.rowToPage(result.rows[0]) : null;
+    }
+    async deletePage(slug) {
+        await this.pg.query("DELETE FROM pages WHERE slug = $1", [slug]);
+    }
+    async listPages(opts) {
+        const params = [];
+        const conditions = [];
+        if (opts?.type) {
+            conditions.push(`type = $${params.length + 1}`);
+            params.push(opts.type);
+        }
+        if (opts?.exclude_types && opts.exclude_types.length > 0) {
+            conditions.push(`type != ALL($${params.length + 1}::text[])`);
+            params.push(opts.exclude_types);
+        }
+        const whereClause = conditions.length > 0 ? ` WHERE ${conditions.join(" AND ")}` : "";
+        const sortDir = opts?.order === "asc" ? "ASC" : "DESC";
+        let sql;
+        if (opts?.sort === "backlinks") {
+            sql = `SELECT p.* FROM pages p
+        LEFT JOIN (
+          SELECT to_page_id, COUNT(*) AS cnt FROM links GROUP BY to_page_id
+        ) lc ON lc.to_page_id = p.id${whereClause}
+        ORDER BY COALESCE(lc.cnt, 0) ${sortDir}`;
+        }
+        else if (opts?.sort === "signal_time") {
+            sql = `SELECT * FROM pages${whereClause}
+        ORDER BY COALESCE(
+          frontmatter->'source'->>'timestamp',
+          frontmatter->'first_seen'->>'timestamp',
+          created_at::text
+        ) ${sortDir}`;
+        }
+        else {
+            const sortCol = ["updated_at", "created_at", "title"].includes(opts?.sort ?? "")
+                ? (opts?.sort ?? "updated_at")
+                : "updated_at";
+            sql = `SELECT * FROM pages${whereClause} ORDER BY ${sortCol} ${sortDir}`;
+        }
+        if (opts?.limit) {
+            sql += ` LIMIT $${params.length + 1}`;
+            params.push(opts.limit);
+        }
+        const result = await this.pg.query(sql, params);
+        return result.rows.map((r) => this.rowToPage(r));
+    }
+    async listExpiredHot() {
+        const result = await this.pg.query(`SELECT * FROM pages
+       WHERE tier = 'hot'
+         AND expires_at IS NOT NULL
+         AND expires_at < NOW()
+       ORDER BY expires_at`);
+        return result.rows.map((r) => this.rowToPage(r));
+    }
+    async updatePageTier(id, tier, consolidatedInto) {
+        if (consolidatedInto !== undefined) {
+            await this.pg.query(`UPDATE pages SET tier = $1, consolidated_into = $2, updated_at = NOW() WHERE id = $3`, [tier, consolidatedInto, id]);
+        }
+        else {
+            await this.pg.query(`UPDATE pages SET tier = $1, updated_at = NOW() WHERE id = $2`, [
+                tier,
+                id,
+            ]);
+        }
+    }
+    async listPagesByTier(tier) {
+        const result = await this.pg.query(`SELECT * FROM pages WHERE tier = $1 ORDER BY created_at`, [tier]);
+        return result.rows.map((r) => this.rowToPage(r));
+    }
+    rowToPage(row) {
+        return {
+            id: row.id,
+            slug: row.slug,
+            type: row.type,
+            title: row.title,
+            compiled_truth: row.compiled_truth,
+            frontmatter: typeof row.frontmatter === "string" ? JSON.parse(row.frontmatter) : row.frontmatter,
+            content_hash: row.content_hash,
+            halflife_days: row.halflife_days,
+            tier: row.tier ?? "hot",
+            expires_at: row.expires_at ?? null,
+            consolidated_into: row.consolidated_into ?? null,
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        };
+    }
+}
+//# sourceMappingURL=pages.js.map

package/dist/store/pages.js.map

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

package/dist/store/search.d.ts

@@ -0,0 +1,37 @@
+import type { PGlite } from "@electric-sql/pglite";
+export interface SearchResult {
+    slug: string;
+    title: string;
+    type: string;
+    snippet: string;
+    score: number;
+    highlights: string[];
+}
+export interface SearchFilterOpts {
+    limit?: number;
+    type?: string[];
+    from?: string;
+    to?: string;
+    platform?: string;
+    exclude_types?: string[];
+}
+interface SearchEngineOpts {
+    embedText?: (text: string) => Promise<number[]>;
+}
+/**
+ * Compute freshness multiplier using exponential decay.
+ * Returns 1.0 for missing timestamps (no effect).
+ * Exported for unit testing.
+ */
+export declare function freshnessMultiplier(updatedAt: string | null): number;
+export declare class SearchEngine {
+    private pg;
+    private embedText?;
+    constructor(pg: PGlite, opts?: SearchEngineOpts);
+    search(query: string, opts?: SearchFilterOpts): Promise<SearchResult[]>;
+    query(query: string, opts?: SearchFilterOpts): Promise<SearchResult[]>;
+    private ftsChunkSearch;
+    private vectorSearch;
+}
+export {};
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/store/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACjD;AA8BD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMpE;AAED,qBAAa,YAAY;IAIrB,OAAO,CAAC,EAAE;IAHZ,OAAO,CAAC,SAAS,CAAC,CAAsC;gBAG9C,EAAE,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,gBAAgB;IAKnB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmFvE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAkH9D,cAAc;YAiCd,YAAY;CAuB3B"}