brainhub-mcp 0.1.0

package/dist/setup/backfill-service.js

@@ -0,0 +1,47 @@
+function result(state) {
+    return {
+        sessions: state.sessions,
+        bytes: state.bytes,
+        confirmed: state.decision === "accepted",
+        uploaded: state.uploaded,
+        completed: state.completedAt !== null,
+    };
+}
+export class BackfillService {
+    dependencies;
+    #now;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+        this.#now = dependencies.now ?? (() => new Date().toISOString());
+    }
+    async run() {
+        let state = this.dependencies.state.getBackfillState();
+        if (state?.completedAt)
+            return result(state);
+        if (!state) {
+            const summary = await this.dependencies.inspect();
+            this.dependencies.report(summary);
+            const accepted = summary.sessions === 0 || (await this.dependencies.confirm(summary));
+            this.dependencies.state.recordBackfillDecision({
+                decision: accepted ? "accepted" : "declined",
+                ...summary,
+                decidedAt: this.#now(),
+            });
+            state = this.dependencies.state.getBackfillState();
+            if (!state)
+                throw new Error("Backfill decision was not persisted");
+        }
+        if (state.decision === "declined")
+            return result(state);
+        const uploaded = await this.dependencies.upload();
+        this.dependencies.state.recordBackfillUpload({
+            ...uploaded,
+            recordedAt: this.#now(),
+        });
+        const updated = this.dependencies.state.getBackfillState();
+        if (!updated)
+            throw new Error("Backfill upload result was not persisted");
+        return result(updated);
+    }
+}
+//# sourceMappingURL=backfill-service.js.map

package/dist/setup/backfill-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill-service.js","sourceRoot":"","sources":["../../src/setup/backfill-service.ts"],"names":[],"mappings":"AAgCA,SAAS,MAAM,CAAC,KAAoB;IAClC,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,QAAQ,KAAK,UAAU;QACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,eAAe;IAGL;IAFZ,IAAI,CAAe;IAE5B,YAAqB,YAAkC;QAAlC,iBAAY,GAAZ,YAAY,CAAsB;QACrD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACvD,IAAI,KAAK,EAAE,WAAW;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,sBAAsB,CAAC;gBAC7C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;gBAC5C,GAAG,OAAO;gBACV,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;aACvB,CAAC,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,oBAAoB,CAAC;YAC3C,GAAG,QAAQ;YACX,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE;SACxB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3D,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/setup/setup-service.d.ts

@@ -0,0 +1,65 @@
+import type { ClientName } from "../clients/registry.js";
+import type { BackfillResult } from "./backfill-service.js";
+export type { BackfillSummary } from "./backfill-service.js";
+export interface SetupProgress {
+    type: "model-progress" | "backfill-summary";
+    percent?: number;
+    file?: string;
+    sessions?: number;
+    bytes?: number;
+}
+type ClientStatuses = Record<ClientName, {
+    available: boolean;
+    registered: boolean;
+}>;
+export interface SetupDependencies {
+    platform: NodeJS.Platform;
+    ensureConfig(): Promise<void>;
+    connectGoogle(): Promise<{
+        email: string;
+    }>;
+    prepareModel(progress: (value: {
+        percent?: number;
+        file?: string;
+    }) => void): Promise<void>;
+    runBackfill(): Promise<BackfillResult>;
+    inspectClients(): Promise<ClientStatuses>;
+    registerClient(client: ClientName): Promise<void>;
+    installScheduler(options: {
+        portrait: boolean;
+    }): Promise<void>;
+    inspectObsidian(): Promise<{
+        configured: boolean;
+        path?: string;
+    }>;
+    report(progress: SetupProgress): void;
+}
+export interface SetupOutput {
+    account: {
+        email: string;
+    };
+    model: {
+        ready: boolean;
+    };
+    backfill: BackfillResult;
+    clients: {
+        registered: ClientName[];
+        skipped: ClientName[];
+    };
+    scheduler: {
+        installed: boolean;
+    };
+    obsidian: {
+        configured: boolean;
+        path?: string;
+    };
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export declare class SetupService {
+    readonly dependencies: SetupDependencies;
+    constructor(dependencies: SetupDependencies);
+    run(): Promise<SetupOutput>;
+}

package/dist/setup/setup-service.js

@@ -0,0 +1,90 @@
+import { BrainHubError } from "../domain/errors.js";
+function message(error) {
+    return error instanceof Error ? error.message : "Unknown setup error";
+}
+export class SetupService {
+    dependencies;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async run() {
+        if (this.dependencies.platform !== "darwin") {
+            throw new BrainHubError("PLATFORM_UNSUPPORTED", "BrainHub MCP v1 supports macOS only");
+        }
+        const warnings = [];
+        await this.dependencies.ensureConfig();
+        const account = await this.dependencies.connectGoogle();
+        let modelReady = true;
+        try {
+            await this.dependencies.prepareModel((progress) => this.dependencies.report({ type: "model-progress", ...progress }));
+        }
+        catch (error) {
+            modelReady = false;
+            warnings.push({
+                code: "MODEL_DOWNLOAD_FAILED",
+                message: message(error),
+            });
+        }
+        const backfill = await this.dependencies.runBackfill();
+        if (backfill.confirmed && !backfill.completed) {
+            warnings.push({
+                code: "BACKFILL_INCOMPLETE",
+                message: "History backfill has retryable uploads remaining",
+            });
+        }
+        const statuses = await this.dependencies.inspectClients();
+        const registered = [];
+        const skipped = [];
+        for (const client of ["claude", "codex", "grok"]) {
+            const status = statuses[client];
+            if (!status.available || status.registered) {
+                skipped.push(client);
+                continue;
+            }
+            try {
+                await this.dependencies.registerClient(client);
+                registered.push(client);
+            }
+            catch (error) {
+                warnings.push({
+                    code: "CLIENT_REGISTRATION_FAILED",
+                    message: `${client}: ${message(error)}`,
+                });
+            }
+        }
+        let obsidian;
+        try {
+            obsidian = await this.dependencies.inspectObsidian();
+        }
+        catch (error) {
+            obsidian = { configured: false };
+            warnings.push({
+                code: "OBSIDIAN_DISCOVERY_FAILED",
+                message: message(error),
+            });
+        }
+        let schedulerInstalled = true;
+        try {
+            await this.dependencies.installScheduler({
+                portrait: obsidian.configured,
+            });
+        }
+        catch (error) {
+            schedulerInstalled = false;
+            warnings.push({
+                code: "SCHEDULER_INSTALL_FAILED",
+                message: message(error),
+            });
+        }
+        return {
+            account,
+            model: { ready: modelReady },
+            backfill,
+            clients: { registered, skipped },
+            scheduler: { installed: schedulerInstalled },
+            obsidian,
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=setup-service.js.map

package/dist/setup/setup-service.js.map

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

package/dist/setup/uninstall-service.d.ts

@@ -0,0 +1,34 @@
+import type { ClientName } from "../clients/registry.js";
+type ClientStatuses = Record<ClientName, {
+    available: boolean;
+    registered: boolean;
+}>;
+interface UninstallDependencies {
+    platform: NodeJS.Platform;
+    inspectClients(): Promise<ClientStatuses>;
+    unregisterClient(client: ClientName): Promise<void>;
+    uninstallScheduler(): Promise<void>;
+    revokeGoogle(): Promise<boolean>;
+    clearKeychain(): Promise<void>;
+    removeLocalState(): Promise<void>;
+}
+export interface UninstallOutput {
+    uninstalled: boolean;
+    clients: ClientName[];
+    oauthRevoked: boolean;
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export declare function brainHubDataDirectory(accountStateFile: string): string;
+export declare function localCleanupTargets(accountStateFile: string, modelCache: string): {
+    dataDirectory: string;
+    modelCache: string;
+};
+export declare class UninstallService {
+    readonly dependencies: UninstallDependencies;
+    constructor(dependencies: UninstallDependencies);
+    run(): Promise<UninstallOutput>;
+}
+export {};

package/dist/setup/uninstall-service.js

@@ -0,0 +1,91 @@
+import { dirname } from "node:path";
+import { BrainHubError } from "../domain/errors.js";
+export function brainHubDataDirectory(accountStateFile) {
+    return dirname(dirname(dirname(accountStateFile)));
+}
+export function localCleanupTargets(accountStateFile, modelCache) {
+    return {
+        dataDirectory: brainHubDataDirectory(accountStateFile),
+        modelCache,
+    };
+}
+function message(error) {
+    return error instanceof Error ? error.message : "Unknown uninstall error";
+}
+export class UninstallService {
+    dependencies;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async run() {
+        if (this.dependencies.platform !== "darwin") {
+            throw new BrainHubError("PLATFORM_UNSUPPORTED", "BrainHub MCP v1 supports macOS only");
+        }
+        const warnings = [];
+        const removedClients = [];
+        try {
+            const statuses = await this.dependencies.inspectClients();
+            for (const client of ["claude", "codex", "grok"]) {
+                if (!statuses[client].registered)
+                    continue;
+                try {
+                    await this.dependencies.unregisterClient(client);
+                    removedClients.push(client);
+                }
+                catch (error) {
+                    warnings.push({
+                        code: "CLIENT_UNINSTALL_FAILED",
+                        message: `${client}: ${message(error)}`,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            warnings.push({
+                code: "CLIENT_STATUS_FAILED",
+                message: message(error),
+            });
+        }
+        try {
+            await this.dependencies.uninstallScheduler();
+        }
+        catch (error) {
+            warnings.push({
+                code: "SCHEDULER_UNINSTALL_FAILED",
+                message: message(error),
+            });
+        }
+        let oauthRevoked = false;
+        try {
+            oauthRevoked = await this.dependencies.revokeGoogle();
+        }
+        catch (error) {
+            warnings.push({
+                code: "OAUTH_REVOCATION_FAILED",
+                message: message(error),
+            });
+        }
+        let localCleanupComplete = true;
+        try {
+            await this.dependencies.clearKeychain();
+        }
+        catch (error) {
+            localCleanupComplete = false;
+            warnings.push({ code: "KEYCHAIN_CLEAR_FAILED", message: message(error) });
+        }
+        try {
+            await this.dependencies.removeLocalState();
+        }
+        catch (error) {
+            localCleanupComplete = false;
+            warnings.push({ code: "LOCAL_CLEANUP_FAILED", message: message(error) });
+        }
+        return {
+            uninstalled: localCleanupComplete,
+            clients: removedClients,
+            oauthRevoked,
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=uninstall-service.js.map

package/dist/setup/uninstall-service.js.map

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

package/dist/state/sqlite-store.d.ts

@@ -0,0 +1,19 @@
+import type { BackfillDecisionInput, BackfillState, BackfillUploadInput, DeviceState, PendingSession, SessionState, StateStore } from "./store.js";
+export declare class SqliteStateStore implements StateStore {
+    #private;
+    constructor(path: string, options?: {
+        legacyPath?: string;
+    });
+    getOrCreateDevice(name: string): DeviceState;
+    markPending(session: PendingSession): boolean;
+    markFailed(conversationKey: string, errorCode: string, retryable: boolean): void;
+    markUploaded(conversationKey: string, driveFileId: string, uploadedAt: string): void;
+    getSession(conversationKey: string): SessionState | null;
+    listPending(limit: number): SessionState[];
+    getDiscoveryWatermark(source: SessionState["source"]): string | null;
+    setDiscoveryWatermark(source: SessionState["source"], scannedAt: string): void;
+    getBackfillState(): BackfillState | null;
+    recordBackfillDecision(input: BackfillDecisionInput): void;
+    recordBackfillUpload(input: BackfillUploadInput): void;
+    close(): void;
+}

package/dist/state/sqlite-store.js

@@ -0,0 +1,299 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import Database from "better-sqlite3";
+function mapSession(row) {
+    return {
+        conversationKey: row.conversation_key,
+        source: row.source,
+        conversationId: row.conversation_id,
+        sourcePath: row.source_path,
+        sourceUpdatedAt: row.source_updated_at,
+        contentSha256: row.content_sha256,
+        status: row.status,
+        attempts: row.attempts,
+        retryable: row.retryable === 1,
+        driveFileId: row.drive_file_id,
+        uploadedAt: row.uploaded_at,
+        lastErrorCode: row.last_error_code,
+    };
+}
+export class SqliteStateStore {
+    #database;
+    constructor(path, options = {}) {
+        mkdirSync(dirname(path), { recursive: true });
+        this.#database = new Database(path);
+        this.#database.pragma("journal_mode = WAL");
+        this.#database.pragma("foreign_keys = ON");
+        this.#migrate();
+        if (options.legacyPath)
+            this.#migrateLegacy(options.legacyPath, path);
+    }
+    #migrate() {
+        this.#database.exec(`
+      CREATE TABLE IF NOT EXISTS device (
+        singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
+        id TEXT NOT NULL,
+        name TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS sessions (
+        conversation_key TEXT PRIMARY KEY,
+        source TEXT NOT NULL,
+        conversation_id TEXT NOT NULL,
+        source_path TEXT NOT NULL,
+        source_updated_at TEXT NOT NULL,
+        content_sha256 TEXT NOT NULL,
+        status TEXT NOT NULL CHECK (status IN ('pending', 'uploaded', 'failed')),
+        attempts INTEGER NOT NULL DEFAULT 0,
+        retryable INTEGER NOT NULL DEFAULT 1,
+        drive_file_id TEXT,
+        uploaded_at TEXT,
+        last_error_code TEXT
+      );
+      CREATE INDEX IF NOT EXISTS sessions_pending
+        ON sessions(status, retryable, source_updated_at);
+      CREATE TABLE IF NOT EXISTS discovery_watermarks (
+        source TEXT PRIMARY KEY,
+        scanned_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS state_migrations (
+        name TEXT PRIMARY KEY,
+        applied_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS setup_backfill (
+        singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
+        decision TEXT NOT NULL CHECK (decision IN ('accepted', 'declined')),
+        sessions INTEGER NOT NULL,
+        bytes INTEGER NOT NULL,
+        uploaded INTEGER NOT NULL DEFAULT 0,
+        decided_at TEXT NOT NULL,
+        completed_at TEXT
+      );
+    `);
+    }
+    #migrateLegacy(legacyPath, currentPath) {
+        const migration = "legacy-account-state-v1";
+        const sourceClaim = `${migration}-claimed`;
+        if (resolve(legacyPath) === resolve(currentPath) ||
+            !existsSync(legacyPath)) {
+            return;
+        }
+        this.#database.prepare("ATTACH DATABASE ? AS legacy_state").run(legacyPath);
+        try {
+            const requiredTables = ["device", "sessions", "discovery_watermarks"];
+            const available = new Set(this.#database
+                .prepare("SELECT name FROM legacy_state.sqlite_master WHERE type = 'table'")
+                .all().map((row) => row.name));
+            if (!requiredTables.every((table) => available.has(table)))
+                return;
+            this.#database.exec(`
+        CREATE TABLE IF NOT EXISTS legacy_state.state_migrations (
+          name TEXT PRIMARY KEY,
+          applied_at TEXT NOT NULL
+        );
+      `);
+            const targetAlreadyMigrated = Boolean(this.#database
+                .prepare("SELECT 1 FROM state_migrations WHERE name = ?")
+                .get(migration));
+            if (targetAlreadyMigrated) {
+                this.#database
+                    .prepare("INSERT OR IGNORE INTO legacy_state.state_migrations(name, applied_at) VALUES (?, ?)")
+                    .run(sourceClaim, new Date().toISOString());
+                return;
+            }
+            this.#database.transaction(() => {
+                const claimed = this.#database
+                    .prepare("INSERT OR IGNORE INTO legacy_state.state_migrations(name, applied_at) VALUES (?, ?)")
+                    .run(sourceClaim, new Date().toISOString());
+                if (claimed.changes === 0)
+                    return;
+                this.#database.exec(`
+          INSERT OR REPLACE INTO device(singleton, id, name, created_at)
+          SELECT singleton, id, name, created_at FROM legacy_state.device;
+
+          INSERT OR IGNORE INTO sessions(
+            conversation_key, source, conversation_id, source_path,
+            source_updated_at, content_sha256, status, attempts, retryable,
+            drive_file_id, uploaded_at, last_error_code
+          )
+          SELECT
+            conversation_key, source, conversation_id, source_path,
+            source_updated_at, content_sha256, status, attempts, retryable,
+            drive_file_id, uploaded_at, last_error_code
+          FROM legacy_state.sessions;
+
+          INSERT INTO discovery_watermarks(source, scanned_at)
+          SELECT source, scanned_at FROM legacy_state.discovery_watermarks
+          WHERE true
+          ON CONFLICT(source) DO UPDATE SET scanned_at =
+            MIN(discovery_watermarks.scanned_at, excluded.scanned_at);
+        `);
+                this.#database
+                    .prepare("INSERT INTO state_migrations(name, applied_at) VALUES (?, ?)")
+                    .run(migration, new Date().toISOString());
+            })();
+        }
+        finally {
+            this.#database.exec("DETACH DATABASE legacy_state");
+        }
+    }
+    getOrCreateDevice(name) {
+        const existing = this.#database
+            .prepare("SELECT id, name, created_at AS createdAt FROM device WHERE singleton = 1")
+            .get();
+        if (existing) {
+            if (existing.name !== name) {
+                this.#database
+                    .prepare("UPDATE device SET name = ? WHERE singleton = 1")
+                    .run(name);
+            }
+            return { ...existing, name };
+        }
+        const device = {
+            id: randomUUID(),
+            name,
+            createdAt: new Date().toISOString(),
+        };
+        this.#database
+            .prepare("INSERT INTO device(singleton, id, name, created_at) VALUES (1, ?, ?, ?)")
+            .run(device.id, device.name, device.createdAt);
+        return device;
+    }
+    markPending(session) {
+        const current = this.getSession(session.conversationKey);
+        if (current?.status === "uploaded" &&
+            current.contentSha256 === session.contentSha256) {
+            return false;
+        }
+        this.#database
+            .prepare(`
+        INSERT INTO sessions(
+          conversation_key, source, conversation_id, source_path,
+          source_updated_at, content_sha256, status, attempts, retryable
+        ) VALUES (?, ?, ?, ?, ?, ?, 'pending', 0, 1)
+        ON CONFLICT(conversation_key) DO UPDATE SET
+          source = excluded.source,
+          conversation_id = excluded.conversation_id,
+          source_path = excluded.source_path,
+          source_updated_at = excluded.source_updated_at,
+          content_sha256 = excluded.content_sha256,
+          status = 'pending',
+          attempts = CASE
+            WHEN sessions.content_sha256 = excluded.content_sha256 THEN sessions.attempts
+            ELSE 0
+          END,
+          retryable = 1,
+          drive_file_id = CASE
+            WHEN sessions.content_sha256 = excluded.content_sha256 THEN sessions.drive_file_id
+            ELSE NULL
+          END,
+          uploaded_at = CASE
+            WHEN sessions.content_sha256 = excluded.content_sha256 THEN sessions.uploaded_at
+            ELSE NULL
+          END,
+          last_error_code = NULL
+      `)
+            .run(session.conversationKey, session.source, session.conversationId, session.sourcePath, session.sourceUpdatedAt, session.contentSha256);
+        return true;
+    }
+    markFailed(conversationKey, errorCode, retryable) {
+        this.#database
+            .prepare(`
+        UPDATE sessions
+        SET status = 'failed', attempts = attempts + 1,
+            retryable = ?, last_error_code = ?
+        WHERE conversation_key = ?
+      `)
+            .run(retryable ? 1 : 0, errorCode, conversationKey);
+    }
+    markUploaded(conversationKey, driveFileId, uploadedAt) {
+        this.#database
+            .prepare(`
+        UPDATE sessions
+        SET status = 'uploaded', retryable = 0, drive_file_id = ?,
+            uploaded_at = ?, last_error_code = NULL
+        WHERE conversation_key = ?
+      `)
+            .run(driveFileId, uploadedAt, conversationKey);
+    }
+    getSession(conversationKey) {
+        const row = this.#database
+            .prepare("SELECT * FROM sessions WHERE conversation_key = ?")
+            .get(conversationKey);
+        return row ? mapSession(row) : null;
+    }
+    listPending(limit) {
+        const rows = this.#database
+            .prepare(`
+        SELECT * FROM sessions
+        WHERE status = 'pending' OR (status = 'failed' AND retryable = 1)
+        ORDER BY source_updated_at, conversation_key
+        LIMIT ?
+      `)
+            .all(limit);
+        return rows.map(mapSession);
+    }
+    getDiscoveryWatermark(source) {
+        const row = this.#database
+            .prepare("SELECT scanned_at AS scannedAt FROM discovery_watermarks WHERE source = ?")
+            .get(source);
+        return row?.scannedAt ?? null;
+    }
+    setDiscoveryWatermark(source, scannedAt) {
+        this.#database
+            .prepare(`
+        INSERT INTO discovery_watermarks(source, scanned_at) VALUES (?, ?)
+        ON CONFLICT(source) DO UPDATE SET scanned_at = excluded.scanned_at
+      `)
+            .run(source, scannedAt);
+    }
+    getBackfillState() {
+        const row = this.#database
+            .prepare(`
+          SELECT decision, sessions, bytes, uploaded,
+                 decided_at AS decidedAt, completed_at AS completedAt
+          FROM setup_backfill WHERE singleton = 1
+        `)
+            .get();
+        return row ?? null;
+    }
+    recordBackfillDecision(input) {
+        this.#database.transaction(() => {
+            const inserted = this.#database
+                .prepare(`
+            INSERT OR IGNORE INTO setup_backfill(
+              singleton, decision, sessions, bytes, uploaded,
+              decided_at, completed_at
+            ) VALUES (1, ?, ?, ?, 0, ?, ?)
+          `)
+                .run(input.decision, input.sessions, input.bytes, input.decidedAt, input.decision === "declined" ? input.decidedAt : null);
+            if (inserted.changes === 0 || input.decision !== "declined")
+                return;
+            const watermark = this.#database.prepare(`
+        INSERT INTO discovery_watermarks(source, scanned_at) VALUES (?, ?)
+        ON CONFLICT(source) DO UPDATE SET scanned_at = excluded.scanned_at
+      `);
+            for (const source of ["claude-code", "codex", "grok-build"]) {
+                watermark.run(source, input.decidedAt);
+            }
+        })();
+    }
+    recordBackfillUpload(input) {
+        const updated = this.#database
+            .prepare(`
+          UPDATE setup_backfill
+          SET uploaded = uploaded + ?,
+              completed_at = CASE WHEN ? = 0 THEN ? ELSE completed_at END
+          WHERE singleton = 1 AND decision = 'accepted'
+        `)
+            .run(input.uploaded, input.pending, input.recordedAt);
+        if (updated.changes === 0) {
+            throw new Error("Accepted backfill decision is required before upload");
+        }
+    }
+    close() {
+        this.#database.close();
+    }
+}
+//# sourceMappingURL=sqlite-store.js.map