tenbrains 2.1.0

package/dist/db/database.d.ts

@@ -0,0 +1,27 @@
+import { DatabaseSync } from "node:sqlite";
+export type IdPrefix = "post" | "ana" | "acc" | "snap" | "bm" | "sug" | "trk";
+/** Sortable, prefixed id: <prefix>_<base36 time><random hex>. */
+export declare function newId(prefix: IdPrefix): string;
+export declare function nowIso(): string;
+export interface OpenDbOptions {
+    path: string;
+    /** When true, only opens if the schema already exists (no migrations run). */
+    readonly?: boolean;
+}
+/**
+ * Thin wrapper over Node's built-in SQLite. Owns connection lifecycle, pragmas,
+ * and migration. The raw handle is exposed for the repositories layer.
+ */
+export declare class Database {
+    readonly handle: DatabaseSync;
+    readonly path: string;
+    private constructor();
+    static open(options: OpenDbOptions): Database;
+    schemaVersion(): number;
+    /** Row counts per table, for `db stats`. */
+    stats(): Record<string, number>;
+    /** Run a function inside a transaction, rolling back on any thrown error. */
+    transaction<T>(fn: () => T): T;
+    close(): void;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/db/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9E,iEAAiE;AACjE,wBAAgB,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAI9C;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ;IAuB7C,aAAa,IAAI,MAAM;IAOvB,4CAA4C;IAC5C,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAmB/B,6EAA6E;IAC7E,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAY9B,KAAK,IAAI,IAAI;CAGd"}

package/dist/db/database.js

@@ -0,0 +1,90 @@
+import { randomBytes } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { CliError } from "../core/errors.js";
+import { runMigrations } from "./migrations.js";
+/** Sortable, prefixed id: <prefix>_<base36 time><random hex>. */
+export function newId(prefix) {
+    const time = Date.now().toString(36).padStart(9, "0");
+    const rand = randomBytes(5).toString("hex");
+    return `${prefix}_${time}${rand}`;
+}
+export function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * Thin wrapper over Node's built-in SQLite. Owns connection lifecycle, pragmas,
+ * and migration. The raw handle is exposed for the repositories layer.
+ */
+export class Database {
+    handle;
+    path;
+    constructor(handle, dbPath) {
+        this.handle = handle;
+        this.path = dbPath;
+    }
+    static open(options) {
+        const dbPath = options.path;
+        if (dbPath !== ":memory:") {
+            mkdirSync(path.dirname(dbPath), { recursive: true });
+        }
+        let handle;
+        try {
+            handle = new DatabaseSync(dbPath);
+        }
+        catch (error) {
+            throw new CliError("CONFIG_ERROR", `Failed to open database at ${dbPath}`, { cause: error });
+        }
+        handle.exec("PRAGMA foreign_keys = ON");
+        if (dbPath !== ":memory:") {
+            handle.exec("PRAGMA journal_mode = WAL");
+            handle.exec("PRAGMA busy_timeout = 5000");
+        }
+        const db = new Database(handle, dbPath);
+        if (!options.readonly) {
+            runMigrations(handle);
+        }
+        return db;
+    }
+    schemaVersion() {
+        const row = this.handle.prepare("PRAGMA user_version").get();
+        return row?.user_version ?? 0;
+    }
+    /** Row counts per table, for `db stats`. */
+    stats() {
+        const tables = [
+            "posts",
+            "analyses",
+            "accounts",
+            "takeaway_snapshots",
+            "bookmarks",
+            "suggestions",
+            "learning_tracks",
+            "track_progress",
+        ];
+        const out = {};
+        for (const table of tables) {
+            const row = this.handle.prepare(`SELECT COUNT(*) AS n FROM ${table}`).get();
+            out[table] = row.n;
+        }
+        return out;
+    }
+    /** Run a function inside a transaction, rolling back on any thrown error. */
+    transaction(fn) {
+        this.handle.exec("BEGIN");
+        try {
+            const result = fn();
+            this.handle.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            this.handle.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    close() {
+        this.handle.close();
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/db/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhD,iEAAiE;AACjE,MAAM,UAAU,KAAK,CAAC,MAAgB;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,GAAG,MAAM,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAQD;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACV,MAAM,CAAe;IACrB,IAAI,CAAS;IAEtB,YAAoB,MAAoB,EAAE,MAAc;QACtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAsB;QAChC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;QAC5B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,MAAoB,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,8BAA8B,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,aAAa,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,aAAa;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAE7C,CAAC;QACd,OAAO,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACH,MAAM,MAAM,GAAG;YACb,OAAO;YACP,UAAU;YACV,UAAU;YACV,oBAAoB;YACpB,WAAW;YACX,aAAa;YACb,iBAAiB;YACjB,gBAAgB;SACjB,CAAC;QACF,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC,GAAG,EAAmB,CAAC;YAC7F,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,6EAA6E;IAC7E,WAAW,CAAI,EAAW;QACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/db/fts.d.ts

@@ -0,0 +1,12 @@
+import type { DatabaseSync } from "node:sqlite";
+/**
+ * Rebuild the `search_fts` index from the source tables. The doc-text
+ * expressions here define the *current* index shape; the frozen copies in the
+ * `fts5-search-index` migration were snapshotted from this file. Keep changes
+ * here (plus a new migration updating the triggers) — never edit the old
+ * migration.
+ */
+export declare function rebuildSearchIndex(db: DatabaseSync): {
+    indexed: number;
+};
+//# sourceMappingURL=fts.d.ts.map

package/dist/db/fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../src/db/fts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAiCxE"}

package/dist/db/fts.js

@@ -0,0 +1,42 @@
+/**
+ * Rebuild the `search_fts` index from the source tables. The doc-text
+ * expressions here define the *current* index shape; the frozen copies in the
+ * `fts5-search-index` migration were snapshotted from this file. Keep changes
+ * here (plus a new migration updating the triggers) — never edit the old
+ * migration.
+ */
+export function rebuildSearchIndex(db) {
+    db.exec(/* sql */ `
+    DELETE FROM search_fts;
+
+    INSERT INTO search_fts (type, ref_id, title, body)
+    SELECT 'analysis', a.id, a.topic,
+      COALESCE(p.text, '') || ' ' || a.topic || ' ' || a.summary || ' ' || a.intent || ' ' ||
+      COALESCE((
+        SELECT group_concat(json_extract(j.value, '$.name') || ' ' ||
+                            COALESCE(json_extract(j.value, '$.whyItMattersInTweet'), ''), ' ')
+        FROM json_each(a.concepts_json) j
+      ), '')
+    FROM analyses a LEFT JOIN posts p ON p.id = a.post_id;
+
+    INSERT INTO search_fts (type, ref_id, title, body)
+    SELECT 'takeaway', s.id, '@' || COALESCE(acc.username, 'account'),
+      COALESCE(acc.username, '') || ' ' || s.summary || ' ' ||
+      COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(s.takeaways_json) j), '')
+    FROM takeaway_snapshots s LEFT JOIN accounts acc ON acc.id = s.account_id;
+
+    INSERT INTO search_fts (type, ref_id, title, body)
+    SELECT 'bookmark', b.id,
+      CASE WHEN json_array_length(b.tags_json) > 0
+           THEN '#' || json_extract(b.tags_json, '$[0]')
+           ELSE COALESCE(p.author_username, 'bookmark')
+      END,
+      COALESCE(p.text, '') || ' ' ||
+      COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(b.tags_json) j), '') || ' ' ||
+      COALESCE(b.note, '')
+    FROM bookmarks b LEFT JOIN posts p ON p.id = b.post_id;
+  `);
+    const row = db.prepare("SELECT COUNT(*) AS n FROM search_fts").get();
+    return { indexed: row.n };
+}
+//# sourceMappingURL=fts.js.map

package/dist/db/fts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.js","sourceRoot":"","sources":["../../src/db/fts.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAgB;IACjD,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BjB,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAAmB,CAAC;IACtF,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC"}

package/dist/db/migrations.d.ts

@@ -0,0 +1,20 @@
+import type { DatabaseSync } from "node:sqlite";
+export interface Migration {
+    version: number;
+    name: string;
+    up: string;
+}
+/**
+ * Ordered, append-only schema migrations. The applied version is tracked with
+ * SQLite's built-in `PRAGMA user_version`, so no bookkeeping table is needed.
+ * Never edit an existing migration's SQL — add a new one.
+ */
+export declare const MIGRATIONS: Migration[];
+export declare function currentSchemaVersion(): number;
+/** Apply any migrations newer than the database's current user_version. */
+export declare function runMigrations(db: DatabaseSync): {
+    from: number;
+    to: number;
+    applied: string[];
+};
+//# sourceMappingURL=migrations.d.ts.map

package/dist/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAiNjC,CAAC;AAEF,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB/F"}

package/dist/db/migrations.js

@@ -0,0 +1,243 @@
+/**
+ * Ordered, append-only schema migrations. The applied version is tracked with
+ * SQLite's built-in `PRAGMA user_version`, so no bookkeeping table is needed.
+ * Never edit an existing migration's SQL — add a new one.
+ */
+export const MIGRATIONS = [
+    {
+        version: 1,
+        name: "initial-schema",
+        up: /* sql */ `
+      CREATE TABLE posts (
+        id              TEXT PRIMARY KEY,
+        external_id     TEXT UNIQUE,
+        url             TEXT,
+        author_username TEXT,
+        author_name     TEXT,
+        text            TEXT NOT NULL,
+        posted_at       TEXT,
+        raw_json        TEXT,
+        created_at      TEXT NOT NULL
+      );
+      CREATE INDEX idx_posts_author ON posts(author_username);
+      CREATE INDEX idx_posts_created ON posts(created_at);
+
+      CREATE TABLE analyses (
+        id            TEXT PRIMARY KEY,
+        post_id       TEXT NOT NULL REFERENCES posts(id) ON DELETE CASCADE,
+        provider      TEXT NOT NULL,
+        model         TEXT NOT NULL,
+        topic         TEXT NOT NULL,
+        summary       TEXT NOT NULL,
+        intent        TEXT NOT NULL,
+        concepts_json TEXT NOT NULL,
+        mock          INTEGER NOT NULL DEFAULT 0,
+        created_at    TEXT NOT NULL
+      );
+      CREATE INDEX idx_analyses_post ON analyses(post_id);
+      CREATE INDEX idx_analyses_created ON analyses(created_at);
+
+      CREATE TABLE accounts (
+        id                TEXT PRIMARY KEY,
+        username          TEXT NOT NULL UNIQUE,
+        name              TEXT,
+        followed_at       TEXT NOT NULL,
+        last_refreshed_at TEXT
+      );
+
+      CREATE TABLE takeaway_snapshots (
+        id                   TEXT PRIMARY KEY,
+        account_id           TEXT NOT NULL REFERENCES accounts(id) ON DELETE CASCADE,
+        provider             TEXT NOT NULL,
+        model                TEXT NOT NULL,
+        summary              TEXT NOT NULL,
+        takeaways_json       TEXT NOT NULL,
+        source_post_ids_json TEXT NOT NULL,
+        post_count           INTEGER NOT NULL,
+        mock                 INTEGER NOT NULL DEFAULT 0,
+        created_at           TEXT NOT NULL
+      );
+      CREATE INDEX idx_snapshots_account ON takeaway_snapshots(account_id, created_at);
+
+      CREATE TABLE bookmarks (
+        id         TEXT PRIMARY KEY,
+        post_id    TEXT NOT NULL UNIQUE REFERENCES posts(id) ON DELETE CASCADE,
+        tags_json  TEXT NOT NULL DEFAULT '[]',
+        note       TEXT,
+        source     TEXT NOT NULL DEFAULT 'cli',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE suggestions (
+        id         TEXT PRIMARY KEY,
+        post_id    TEXT NOT NULL UNIQUE REFERENCES posts(id) ON DELETE CASCADE,
+        reason     TEXT NOT NULL,
+        score      REAL NOT NULL DEFAULT 0,
+        status     TEXT NOT NULL DEFAULT 'pending',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+      CREATE INDEX idx_suggestions_status ON suggestions(status, score);
+
+      CREATE TABLE learning_tracks (
+        id              TEXT PRIMARY KEY,
+        analysis_id     TEXT NOT NULL REFERENCES analyses(id) ON DELETE CASCADE,
+        minutes_per_day INTEGER NOT NULL,
+        ratings_json    TEXT NOT NULL,
+        days_json       TEXT NOT NULL,
+        created_at      TEXT NOT NULL
+      );
+      CREATE INDEX idx_tracks_analysis ON learning_tracks(analysis_id);
+    `,
+    },
+    {
+        version: 2,
+        name: "fts5-search-index",
+        // One FTS5 table indexes every searchable record (analyses, takeaway
+        // snapshots, bookmarks) as a (title, body) document, kept in sync by
+        // triggers on the source tables so no application write path can forget
+        // it. Porter stemming makes "embedding" match "embeddings". The doc-text
+        // expressions are mirrored in src/db/fts.ts (`rebuildSearchIndex`) — keep
+        // future changes there, this migration is frozen.
+        up: /* sql */ `
+      CREATE VIRTUAL TABLE search_fts USING fts5(
+        type UNINDEXED,
+        ref_id UNINDEXED,
+        title,
+        body,
+        tokenize = 'porter unicode61 remove_diacritics 2'
+      );
+
+      CREATE TRIGGER trg_fts_analysis_ai AFTER INSERT ON analyses BEGIN
+        INSERT INTO search_fts (type, ref_id, title, body)
+        VALUES (
+          'analysis', NEW.id, NEW.topic,
+          COALESCE((SELECT text FROM posts WHERE id = NEW.post_id), '') || ' ' ||
+          NEW.topic || ' ' || NEW.summary || ' ' || NEW.intent || ' ' ||
+          COALESCE((
+            SELECT group_concat(json_extract(j.value, '$.name') || ' ' ||
+                                COALESCE(json_extract(j.value, '$.whyItMattersInTweet'), ''), ' ')
+            FROM json_each(NEW.concepts_json) j
+          ), '')
+        );
+      END;
+      CREATE TRIGGER trg_fts_analysis_ad AFTER DELETE ON analyses BEGIN
+        DELETE FROM search_fts WHERE type = 'analysis' AND ref_id = OLD.id;
+      END;
+
+      CREATE TRIGGER trg_fts_snapshot_ai AFTER INSERT ON takeaway_snapshots BEGIN
+        INSERT INTO search_fts (type, ref_id, title, body)
+        VALUES (
+          'takeaway', NEW.id,
+          '@' || COALESCE((SELECT username FROM accounts WHERE id = NEW.account_id), 'account'),
+          COALESCE((SELECT username FROM accounts WHERE id = NEW.account_id), '') || ' ' ||
+          NEW.summary || ' ' ||
+          COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(NEW.takeaways_json) j), '')
+        );
+      END;
+      CREATE TRIGGER trg_fts_snapshot_ad AFTER DELETE ON takeaway_snapshots BEGIN
+        DELETE FROM search_fts WHERE type = 'takeaway' AND ref_id = OLD.id;
+      END;
+
+      CREATE TRIGGER trg_fts_bookmark_ai AFTER INSERT ON bookmarks BEGIN
+        INSERT INTO search_fts (type, ref_id, title, body)
+        VALUES (
+          'bookmark', NEW.id,
+          CASE WHEN json_array_length(NEW.tags_json) > 0
+               THEN '#' || json_extract(NEW.tags_json, '$[0]')
+               ELSE COALESCE((SELECT author_username FROM posts WHERE id = NEW.post_id), 'bookmark')
+          END,
+          COALESCE((SELECT text FROM posts WHERE id = NEW.post_id), '') || ' ' ||
+          COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(NEW.tags_json) j), '') || ' ' ||
+          COALESCE(NEW.note, '')
+        );
+      END;
+      CREATE TRIGGER trg_fts_bookmark_au AFTER UPDATE ON bookmarks BEGIN
+        DELETE FROM search_fts WHERE type = 'bookmark' AND ref_id = OLD.id;
+        INSERT INTO search_fts (type, ref_id, title, body)
+        VALUES (
+          'bookmark', NEW.id,
+          CASE WHEN json_array_length(NEW.tags_json) > 0
+               THEN '#' || json_extract(NEW.tags_json, '$[0]')
+               ELSE COALESCE((SELECT author_username FROM posts WHERE id = NEW.post_id), 'bookmark')
+          END,
+          COALESCE((SELECT text FROM posts WHERE id = NEW.post_id), '') || ' ' ||
+          COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(NEW.tags_json) j), '') || ' ' ||
+          COALESCE(NEW.note, '')
+        );
+      END;
+      CREATE TRIGGER trg_fts_bookmark_ad AFTER DELETE ON bookmarks BEGIN
+        DELETE FROM search_fts WHERE type = 'bookmark' AND ref_id = OLD.id;
+      END;
+
+      INSERT INTO search_fts (type, ref_id, title, body)
+      SELECT 'analysis', a.id, a.topic,
+        COALESCE(p.text, '') || ' ' || a.topic || ' ' || a.summary || ' ' || a.intent || ' ' ||
+        COALESCE((
+          SELECT group_concat(json_extract(j.value, '$.name') || ' ' ||
+                              COALESCE(json_extract(j.value, '$.whyItMattersInTweet'), ''), ' ')
+          FROM json_each(a.concepts_json) j
+        ), '')
+      FROM analyses a LEFT JOIN posts p ON p.id = a.post_id;
+
+      INSERT INTO search_fts (type, ref_id, title, body)
+      SELECT 'takeaway', s.id, '@' || COALESCE(acc.username, 'account'),
+        COALESCE(acc.username, '') || ' ' || s.summary || ' ' ||
+        COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(s.takeaways_json) j), '')
+      FROM takeaway_snapshots s LEFT JOIN accounts acc ON acc.id = s.account_id;
+
+      INSERT INTO search_fts (type, ref_id, title, body)
+      SELECT 'bookmark', b.id,
+        CASE WHEN json_array_length(b.tags_json) > 0
+             THEN '#' || json_extract(b.tags_json, '$[0]')
+             ELSE COALESCE(p.author_username, 'bookmark')
+        END,
+        COALESCE(p.text, '') || ' ' ||
+        COALESCE((SELECT group_concat(j.value, ' ') FROM json_each(b.tags_json) j), '') || ' ' ||
+        COALESCE(b.note, '')
+      FROM bookmarks b LEFT JOIN posts p ON p.id = b.post_id;
+    `,
+    },
+    {
+        version: 3,
+        name: "track-progress",
+        up: /* sql */ `
+      CREATE TABLE track_progress (
+        track_id     TEXT NOT NULL REFERENCES learning_tracks(id) ON DELETE CASCADE,
+        day          INTEGER NOT NULL,
+        notes        TEXT,
+        completed_at TEXT NOT NULL,
+        PRIMARY KEY (track_id, day)
+      ) WITHOUT ROWID;
+    `,
+    },
+];
+export function currentSchemaVersion() {
+    return MIGRATIONS.reduce((max, m) => Math.max(max, m.version), 0);
+}
+/** Apply any migrations newer than the database's current user_version. */
+export function runMigrations(db) {
+    const row = db.prepare("PRAGMA user_version").get();
+    const from = row?.user_version ?? 0;
+    const applied = [];
+    for (const migration of MIGRATIONS) {
+        if (migration.version <= from) {
+            continue;
+        }
+        db.exec("BEGIN");
+        try {
+            db.exec(migration.up);
+            db.exec(`PRAGMA user_version = ${migration.version}`);
+            db.exec("COMMIT");
+            applied.push(migration.name);
+        }
+        catch (error) {
+            db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    const to = currentSchemaVersion();
+    return { from, to, applied };
+}
+//# sourceMappingURL=migrations.js.map

package/dist/db/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,gBAAgB;QACtB,EAAE,EAAE,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkFb;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,mBAAmB;QACzB,qEAAqE;QACrE,qEAAqE;QACrE,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,kDAAkD;QAClD,EAAE,EAAE,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiGb;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,gBAAgB;QACtB,EAAE,EAAE,SAAS,CAAC;;;;;;;;KAQb;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oBAAoB;IAClC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,EAAgB;IAC5C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAA0C,CAAC;IAC5F,MAAM,IAAI,GAAG,GAAG,EAAE,YAAY,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACtB,EAAE,CAAC,IAAI,CAAC,yBAAyB,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YACtD,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAClC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/db/repositories.d.ts

@@ -0,0 +1,130 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { Account, Analysis, Bookmark, Concept, ConceptRating, LearningDay, LearningTrack, Post, Suggestion, SuggestionStatus, TakeawaySnapshot, TrackDayProgress } from "../domain/types.js";
+import { type Database } from "./database.js";
+export interface NewPost {
+    text: string;
+    externalId?: string | undefined;
+    url?: string | undefined;
+    authorUsername?: string | undefined;
+    authorName?: string | undefined;
+    postedAt?: string | undefined;
+    raw?: unknown;
+}
+export declare class PostsRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(data: NewPost): Post;
+    /** Insert, or return the existing post when externalId already present. */
+    ingest(data: NewPost): {
+        post: Post;
+        deduped: boolean;
+    };
+    findById(id: string): Post | null;
+    findByExternalId(externalId: string): Post | null;
+    list(limit: number, offset: number): Post[];
+    all(): Post[];
+}
+export declare class AnalysesRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(data: {
+        postId: string;
+        provider: string;
+        model: string;
+        topic: string;
+        summary: string;
+        intent: string;
+        concepts: Concept[];
+        mock: boolean;
+    }): Analysis;
+    findById(id: string): Analysis | null;
+    latestForPost(postId: string): Analysis | null;
+    list(limit: number, offset: number, author?: string): Analysis[];
+    all(): Analysis[];
+}
+export declare class AccountsRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(username: string, name?: string): Account;
+    findById(id: string): Account | null;
+    findByUsername(username: string): Account | null;
+    list(): Account[];
+    touch(id: string): void;
+    delete(id: string): void;
+}
+export declare class SnapshotsRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(data: {
+        accountId: string;
+        provider: string;
+        model: string;
+        summary: string;
+        takeaways: string[];
+        sourcePostIds: string[];
+        mock: boolean;
+    }): TakeawaySnapshot;
+    findById(id: string): TakeawaySnapshot | null;
+    latestByAccount(accountId: string): TakeawaySnapshot | null;
+    listByAccount(accountId: string, limit: number): TakeawaySnapshot[];
+    all(): TakeawaySnapshot[];
+}
+export declare class BookmarksRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(data: {
+        postId: string;
+        tags: string[];
+        note?: string;
+        source: string;
+    }): Bookmark;
+    findById(id: string): Bookmark | null;
+    findByPostId(postId: string): Bookmark | null;
+    list(limit: number, offset: number): Bookmark[];
+    all(): Bookmark[];
+    updateTags(id: string, tags: string[]): Bookmark;
+    delete(id: string): void;
+}
+export declare class SuggestionsRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    /** Insert a pending suggestion or refresh score/reason if one exists for the post. */
+    upsert(data: {
+        postId: string;
+        reason: string;
+        score: number;
+    }): Suggestion;
+    findById(id: string): Suggestion | null;
+    findByPostId(postId: string): Suggestion | null;
+    list(status: SuggestionStatus | "all", limit: number): Suggestion[];
+    setStatus(id: string, status: SuggestionStatus): Suggestion;
+}
+export declare class TracksRepo {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(data: {
+        analysisId: string;
+        minutesPerDay: number;
+        ratings: ConceptRating[];
+        days: LearningDay[];
+    }): LearningTrack;
+    findById(id: string): LearningTrack | null;
+    list(limit: number, analysisId?: string): LearningTrack[];
+    progressFor(trackId: string): TrackDayProgress[];
+    /** Record a day as done. Caller guards against duplicates (PK would throw). */
+    markDone(trackId: string, day: number, notes?: string): LearningTrack;
+}
+/** Facade exposing every repository over a single Database. */
+export declare class Store {
+    readonly database: Database;
+    readonly posts: PostsRepo;
+    readonly analyses: AnalysesRepo;
+    readonly accounts: AccountsRepo;
+    readonly snapshots: SnapshotsRepo;
+    readonly bookmarks: BookmarksRepo;
+    readonly suggestions: SuggestionsRepo;
+    readonly tracks: TracksRepo;
+    constructor(database: Database);
+    transaction<T>(fn: () => T): T;
+}
+//# sourceMappingURL=repositories.d.ts.map

package/dist/db/repositories.d.ts.map

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