@spool-lab/core 0.4.1 → 0.4.20

package/dist/doctor/checks/config.js

@@ -0,0 +1,123 @@
+import { existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { SPOOL_DIR } from '../../db/db.js';
+const FILES = [
+    {
+        id: 'config.agents',
+        filename: 'agents.json',
+        required: false,
+        validate: parsed => {
+            if (parsed === null || typeof parsed !== 'object')
+                return 'expected JSON object';
+            return null;
+        },
+    },
+    {
+        id: 'config.ui',
+        filename: 'ui.json',
+        required: false,
+        validate: parsed => {
+            if (parsed === null || typeof parsed !== 'object')
+                return 'expected JSON object';
+            return null;
+        },
+    },
+    {
+        id: 'config.registry-cache',
+        filename: 'registry-cache.json',
+        required: false,
+    },
+];
+export const configChecks = FILES.map(file => ({
+    id: file.id,
+    category: 'config',
+    title: file.filename,
+    run: () => checkConfigFile(file),
+}));
+function checkConfigFile(file) {
+    const path = join(SPOOL_DIR, file.filename);
+    const base = {
+        id: file.id,
+        category: 'config',
+        title: file.filename,
+    };
+    if (!existsSync(path)) {
+        return {
+            ...base,
+            severity: file.required ? 'error' : 'ok',
+            message: file.required ? `Missing at ${path}` : 'not present (optional)',
+            details: { path },
+        };
+    }
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        return {
+            ...base,
+            severity: 'error',
+            message: `Cannot read: ${err.message}`,
+            details: { path },
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        return {
+            ...base,
+            severity: 'error',
+            message: `Invalid JSON: ${err.message}`,
+            details: { path, bytes: raw.length },
+            fix: {
+                description: `Back up corrupt ${file.filename} and reset to {}`,
+                destructive: true,
+                apply: () => resetConfigFile(path),
+            },
+        };
+    }
+    if (file.validate) {
+        const err = file.validate(parsed);
+        if (err) {
+            return {
+                ...base,
+                severity: 'error',
+                message: `Schema error: ${err}`,
+                details: { path },
+                fix: {
+                    description: `Back up malformed ${file.filename} and reset to {}`,
+                    destructive: true,
+                    apply: () => resetConfigFile(path),
+                },
+            };
+        }
+    }
+    return {
+        ...base,
+        severity: 'ok',
+        message: `valid (${humanBytes(raw.length)})`,
+        details: { path, bytes: raw.length },
+    };
+}
+function resetConfigFile(path) {
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const backup = `${path}.bak.${ts}`;
+    try {
+        renameSync(path, backup);
+    }
+    catch (err) {
+        return { ok: false, message: `Could not back up: ${err.message}` };
+    }
+    writeFileSync(path, '{}\n', 'utf8');
+    return { ok: true, message: `Reset; previous contents at ${backup}` };
+}
+function humanBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / 1024 / 1024).toFixed(1)} MB`;
+}
+//# sourceMappingURL=config.js.map

package/dist/doctor/checks/config.js.map

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

package/dist/doctor/checks/db.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+export declare const dbChecks: Check[];
+//# sourceMappingURL=db.d.ts.map

package/dist/doctor/checks/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/db.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAA8B,MAAM,aAAa,CAAA;AAOpE,eAAO,MAAM,QAAQ,EAAE,KAAK,EAmI3B,CAAA"}

package/dist/doctor/checks/db.js

@@ -0,0 +1,225 @@
+import Database from 'better-sqlite3';
+import { existsSync, statSync } from 'node:fs';
+import { DB_PATH } from '../../db/db.js';
+import { probeSqlite } from '../preflight.js';
+const WAL_PATH = `${DB_PATH}-wal`;
+const WAL_WARN_RATIO = 0.5;
+const WAL_WARN_MIN_BYTES = 16 * 1024 * 1024;
+const VACUUM_HINT_RATIO = 0.25;
+export const dbChecks = [
+    {
+        id: 'db.exists',
+        category: 'db',
+        title: 'Database file',
+        run: () => {
+            if (!existsSync(DB_PATH)) {
+                return {
+                    id: 'db.exists', category: 'db', title: 'Database file',
+                    severity: 'warn',
+                    message: `Not found at ${DB_PATH} — run \`spool sync\` to create it`,
+                    details: { path: DB_PATH },
+                };
+            }
+            const size = statSync(DB_PATH).size;
+            return {
+                id: 'db.exists', category: 'db', title: 'Database file',
+                severity: 'ok',
+                message: `${humanBytes(size)} at ${DB_PATH}`,
+                details: { path: DB_PATH, sizeBytes: size },
+            };
+        },
+    },
+    {
+        id: 'db.integrity',
+        category: 'db',
+        title: 'Database integrity',
+        run: () => withReadonlyDb('db.integrity', 'Database integrity', db => {
+            const rows = db.pragma('integrity_check');
+            const messages = rows.map(r => r.integrity_check);
+            if (messages.length === 1 && messages[0] === 'ok') {
+                return { severity: 'ok', message: 'integrity_check passed' };
+            }
+            return {
+                severity: 'error',
+                message: `integrity_check reported ${messages.length} problem(s)`,
+                details: { problems: messages.slice(0, 20) },
+            };
+        }),
+    },
+    {
+        id: 'db.foreign-keys',
+        category: 'db',
+        title: 'Foreign key consistency',
+        run: () => withReadonlyDb('db.foreign-keys', 'Foreign key consistency', db => {
+            const rows = db.pragma('foreign_key_check');
+            if (rows.length === 0) {
+                return { severity: 'ok', message: 'foreign_key_check passed' };
+            }
+            const byTable = new Map();
+            for (const r of rows)
+                byTable.set(r.table, (byTable.get(r.table) ?? 0) + 1);
+            const summary = Array.from(byTable.entries())
+                .map(([t, n]) => `${t}: ${n}`).join(', ');
+            const fix = {
+                description: `Delete ${rows.length} orphaned row(s) (${summary})`,
+                destructive: false,
+                apply: () => applyForeignKeyCleanup(rows),
+            };
+            return {
+                severity: 'error',
+                message: `${rows.length} orphan row(s) — ${summary}`,
+                details: { violations: rows.slice(0, 50) },
+                fix,
+            };
+        }),
+    },
+    {
+        id: 'db.wal-size',
+        category: 'db',
+        title: 'WAL size',
+        run: () => {
+            if (!existsSync(DB_PATH)) {
+                return skipped('db.wal-size', 'WAL size');
+            }
+            const dbSize = statSync(DB_PATH).size;
+            let walSize = 0;
+            try {
+                walSize = statSync(WAL_PATH).size;
+            }
+            catch { /* WAL file optional */ }
+            const ratio = dbSize > 0 ? walSize / dbSize : 0;
+            const oversized = walSize >= WAL_WARN_MIN_BYTES && ratio >= WAL_WARN_RATIO;
+            if (!oversized) {
+                return {
+                    id: 'db.wal-size', category: 'db', title: 'WAL size',
+                    severity: 'ok',
+                    message: walSize === 0 ? 'WAL empty' : `${humanBytes(walSize)} (${(ratio * 100).toFixed(0)}% of db)`,
+                    details: { walBytes: walSize, dbBytes: dbSize },
+                };
+            }
+            return {
+                id: 'db.wal-size', category: 'db', title: 'WAL size',
+                severity: 'warn',
+                message: `WAL is ${humanBytes(walSize)} (${(ratio * 100).toFixed(0)}% of db)`,
+                details: { walBytes: walSize, dbBytes: dbSize },
+                fix: {
+                    description: 'Checkpoint the WAL into the main database',
+                    destructive: false,
+                    apply: () => applyWalCheckpoint(),
+                },
+            };
+        },
+    },
+    {
+        id: 'db.vacuum-hint',
+        category: 'db',
+        title: 'Free-page ratio',
+        run: () => withReadonlyDb('db.vacuum-hint', 'Free-page ratio', db => {
+            const free = db.pragma('freelist_count')[0]?.freelist_count ?? 0;
+            const total = db.pragma('page_count')[0]?.page_count ?? 0;
+            const ratio = total > 0 ? free / total : 0;
+            const hint = total > 0 && ratio >= VACUUM_HINT_RATIO;
+            if (!hint) {
+                return {
+                    severity: 'ok',
+                    message: total === 0 ? 'empty db' : `${(ratio * 100).toFixed(1)}% free pages`,
+                    details: { freePages: free, totalPages: total },
+                };
+            }
+            return {
+                severity: 'warn',
+                message: `${(ratio * 100).toFixed(1)}% of pages are free — vacuum will reclaim space`,
+                details: { freePages: free, totalPages: total },
+                fix: {
+                    description: 'Run VACUUM to compact the database',
+                    destructive: false,
+                    apply: () => applyVacuum(),
+                },
+            };
+        }),
+    },
+];
+function withReadonlyDb(id, title, fn) {
+    const sqlite = probeSqlite();
+    if (!sqlite.ok) {
+        return { id, category: 'db', title, severity: 'warn', message: 'skipped — see `native.sqlite`' };
+    }
+    if (!existsSync(DB_PATH))
+        return skipped(id, title);
+    const db = new Database(DB_PATH, { readonly: true, fileMustExist: true });
+    try {
+        const out = fn(db);
+        return { id, category: 'db', title, ...out };
+    }
+    finally {
+        db.close();
+    }
+}
+function skipped(id, title) {
+    return {
+        id, category: 'db', title,
+        severity: 'ok',
+        message: 'skipped — no database',
+    };
+}
+function applyForeignKeyCleanup(violations) {
+    const db = new Database(DB_PATH);
+    try {
+        db.pragma('foreign_keys = OFF');
+        const grouped = new Map();
+        for (const v of violations) {
+            const arr = grouped.get(v.table) ?? [];
+            arr.push(v.rowid);
+            grouped.set(v.table, arr);
+        }
+        const tx = db.transaction(() => {
+            for (const [table, rowids] of grouped) {
+                const stmt = db.prepare(`DELETE FROM "${table.replace(/"/g, '""')}" WHERE rowid = ?`);
+                for (const rid of rowids)
+                    stmt.run(rid);
+            }
+        });
+        tx();
+        return { ok: true, message: `Removed ${violations.length} orphan row(s)` };
+    }
+    finally {
+        db.close();
+    }
+}
+function applyWalCheckpoint() {
+    const db = new Database(DB_PATH);
+    try {
+        const result = db.pragma('wal_checkpoint(TRUNCATE)');
+        const r = result[0];
+        if (!r)
+            return { ok: true, message: 'WAL checkpointed' };
+        if (r.busy)
+            return { ok: false, message: 'WAL checkpoint reported busy — close other Spool processes and retry' };
+        return { ok: true, message: `Checkpointed ${r.checkpointed}/${r.log} frames` };
+    }
+    finally {
+        db.close();
+    }
+}
+function applyVacuum() {
+    const db = new Database(DB_PATH);
+    try {
+        const before = statSync(DB_PATH).size;
+        db.exec('VACUUM');
+        const after = statSync(DB_PATH).size;
+        return { ok: true, message: `Reclaimed ${humanBytes(Math.max(before - after, 0))}` };
+    }
+    finally {
+        db.close();
+    }
+}
+function humanBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    if (n < 1024 * 1024 * 1024)
+        return `${(n / 1024 / 1024).toFixed(1)} MB`;
+    return `${(n / 1024 / 1024 / 1024).toFixed(1)} GB`;
+}
+//# sourceMappingURL=db.js.map

package/dist/doctor/checks/db.js.map

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

package/dist/doctor/checks/env.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+export declare const envChecks: Check[];
+//# sourceMappingURL=env.d.ts.map

package/dist/doctor/checks/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/env.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAA;AAKrD,eAAO,MAAM,SAAS,EAAE,KAAK,EA0D5B,CAAA"}

package/dist/doctor/checks/env.js

@@ -0,0 +1,70 @@
+import { accessSync, constants, mkdirSync, statfsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { SPOOL_DIR } from '../../db/db.js';
+const MIN_NODE_MAJOR = 20;
+const MIN_FREE_BYTES = 1 * 1024 * 1024 * 1024; // 1 GB
+export const envChecks = [
+    {
+        id: 'env.node-version',
+        category: 'env',
+        title: 'Node.js version',
+        run: () => {
+            const v = process.versions.node;
+            const major = Number(v.split('.')[0]);
+            if (Number.isNaN(major)) {
+                return mk('env.node-version', 'Node.js version', 'warn', `Could not parse Node version (${v})`, { version: v });
+            }
+            if (major < MIN_NODE_MAJOR) {
+                return mk('env.node-version', 'Node.js version', 'error', `Node ${v} is below the minimum supported (≥${MIN_NODE_MAJOR})`, { version: v, minMajor: MIN_NODE_MAJOR });
+            }
+            return mk('env.node-version', 'Node.js version', 'ok', v, { version: v });
+        },
+    },
+    {
+        id: 'env.spool-dir',
+        category: 'env',
+        title: 'Spool home directory',
+        run: () => {
+            const dir = SPOOL_DIR;
+            const overrideActive = process.env['SPOOL_DATA_DIR'] !== undefined;
+            const defaultDir = `${homedir()}/.spool`;
+            try {
+                mkdirSync(dir, { recursive: true });
+                accessSync(dir, constants.W_OK);
+                return mk('env.spool-dir', 'Spool home directory', 'ok', dir, { path: dir, overrideActive, defaultDir });
+            }
+            catch (err) {
+                return mk('env.spool-dir', 'Spool home directory', 'error', `Cannot write to ${dir}: ${err.message}`, { path: dir, overrideActive, defaultDir });
+            }
+        },
+    },
+    {
+        id: 'env.disk-space',
+        category: 'env',
+        title: 'Disk space',
+        run: () => {
+            try {
+                const stat = statfsSync(SPOOL_DIR);
+                const free = Number(stat.bavail) * Number(stat.bsize);
+                const ok = free >= MIN_FREE_BYTES;
+                return mk('env.disk-space', 'Disk space', ok ? 'ok' : 'warn', `${humanBytes(free)} free on ${SPOOL_DIR}`, { freeBytes: free, minFreeBytes: MIN_FREE_BYTES });
+            }
+            catch (err) {
+                return mk('env.disk-space', 'Disk space', 'warn', `Could not stat filesystem: ${err.message}`);
+            }
+        },
+    },
+];
+function mk(id, title, severity, message, details) {
+    return { id, category: 'env', title, severity, message, ...(details ? { details } : {}) };
+}
+function humanBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    if (n < 1024 * 1024 * 1024)
+        return `${(n / 1024 / 1024).toFixed(1)} MB`;
+    return `${(n / 1024 / 1024 / 1024).toFixed(1)} GB`;
+}
+//# sourceMappingURL=env.js.map

package/dist/doctor/checks/env.js.map

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

package/dist/doctor/checks/index.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+export declare const allChecks: Check[];
+//# sourceMappingURL=index.d.ts.map

package/dist/doctor/checks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAOxC,eAAO,MAAM,SAAS,EAAE,KAAK,EAM5B,CAAA"}

package/dist/doctor/checks/index.js

@@ -0,0 +1,13 @@
+import { envChecks } from './env.js';
+import { nativeChecks } from './native.js';
+import { versionChecks } from './versions.js';
+import { dbChecks } from './db.js';
+import { configChecks } from './config.js';
+export const allChecks = [
+    ...envChecks,
+    ...nativeChecks,
+    ...versionChecks,
+    ...dbChecks,
+    ...configChecks,
+];
+//# sourceMappingURL=index.js.map

package/dist/doctor/checks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/checks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,QAAQ;IACX,GAAG,YAAY;CAChB,CAAA"}

package/dist/doctor/checks/native.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+export declare const nativeChecks: Check[];
+//# sourceMappingURL=native.d.ts.map

package/dist/doctor/checks/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAA;AAGrD,eAAO,MAAM,YAAY,EAAE,KAAK,EA2B/B,CAAA"}

package/dist/doctor/checks/native.js

@@ -0,0 +1,42 @@
+import { probeSqlite } from '../preflight.js';
+export const nativeChecks = [
+    {
+        id: 'native.sqlite',
+        category: 'native',
+        title: 'better-sqlite3 native module',
+        run: () => {
+            const status = probeSqlite();
+            if (status.ok) {
+                return {
+                    id: 'native.sqlite',
+                    category: 'native',
+                    title: 'better-sqlite3 native module',
+                    severity: 'ok',
+                    message: `loaded (Node ${process.version})`,
+                    details: { node: process.version },
+                };
+            }
+            return {
+                id: 'native.sqlite',
+                category: 'native',
+                title: 'better-sqlite3 native module',
+                severity: 'error',
+                message: summarizeAbiError(status.error),
+                details: { error: status.error.message, node: process.version },
+            };
+        },
+    },
+];
+function summarizeAbiError(err) {
+    const msg = err.message;
+    const abiMatch = msg.match(/NODE_MODULE_VERSION (\d+)[\s\S]*?NODE_MODULE_VERSION (\d+)/);
+    if (abiMatch) {
+        const compiled = abiMatch[1];
+        const wanted = abiMatch[2];
+        return (`Node ABI mismatch (compiled for v${compiled}, this Node wants v${wanted}). ` +
+            `Reinstall the CLI: \`npm i -g @spool-lab/cli\``);
+    }
+    const oneLine = msg.split('\n')[0] ?? msg;
+    return `Failed to load: ${oneLine}`;
+}
+//# sourceMappingURL=native.js.map

package/dist/doctor/checks/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../src/doctor/checks/native.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,8BAA8B;QACrC,GAAG,EAAE,GAAgB,EAAE;YACrB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAA;YAC5B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO;oBACL,EAAE,EAAE,eAAe;oBACnB,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,8BAA8B;oBACrC,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,gBAAgB,OAAO,CAAC,OAAO,GAAG;oBAC3C,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;iBACnC,CAAA;YACH,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,eAAe;gBACnB,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,8BAA8B;gBACrC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC;gBACxC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;aAChE,CAAA;QACH,CAAC;KACF;CACF,CAAA;AAED,SAAS,iBAAiB,CAAC,GAAU;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAA;IACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAA;IACxF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,CACL,oCAAoC,QAAQ,sBAAsB,MAAM,KAAK;YAC7E,gDAAgD,CACjD,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IACzC,OAAO,mBAAmB,OAAO,EAAE,CAAA;AACrC,CAAC"}

package/dist/doctor/checks/versions.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from '../types.js';
+export declare const versionChecks: Check[];
+//# sourceMappingURL=versions.d.ts.map

package/dist/doctor/checks/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/versions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAA;AAErD,eAAO,MAAM,aAAa,EAAE,KAAK,EA6EhC,CAAA"}

package/dist/doctor/checks/versions.js

@@ -0,0 +1,79 @@
+import Database from 'better-sqlite3';
+import { existsSync } from 'node:fs';
+import { DB_PATH, LATEST_SCHEMA_VERSION, getDB } from '../../db/db.js';
+import { probeSqlite } from '../preflight.js';
+export const versionChecks = [
+    {
+        id: 'versions.schema-compat',
+        category: 'versions',
+        title: 'Database schema compatibility',
+        run: () => {
+            const sqlite = probeSqlite();
+            if (!sqlite.ok) {
+                return {
+                    id: 'versions.schema-compat',
+                    category: 'versions',
+                    title: 'Database schema compatibility',
+                    severity: 'warn',
+                    message: 'skipped — see `native.sqlite`',
+                };
+            }
+            if (!existsSync(DB_PATH)) {
+                return {
+                    id: 'versions.schema-compat',
+                    category: 'versions',
+                    title: 'Database schema compatibility',
+                    severity: 'ok',
+                    message: `No database yet — schema will be created at v${LATEST_SCHEMA_VERSION} on first sync`,
+                    details: { expected: LATEST_SCHEMA_VERSION },
+                };
+            }
+            const db = new Database(DB_PATH, { readonly: true, fileMustExist: true });
+            try {
+                const row = db.pragma('user_version');
+                const current = row[0]?.user_version ?? 0;
+                if (current === LATEST_SCHEMA_VERSION) {
+                    return {
+                        id: 'versions.schema-compat',
+                        category: 'versions',
+                        title: 'Database schema compatibility',
+                        severity: 'ok',
+                        message: `v${current}`,
+                        details: { current, expected: LATEST_SCHEMA_VERSION },
+                    };
+                }
+                if (current < LATEST_SCHEMA_VERSION) {
+                    return {
+                        id: 'versions.schema-compat',
+                        category: 'versions',
+                        title: 'Database schema compatibility',
+                        severity: 'error',
+                        message: `DB is at v${current}, CLI expects v${LATEST_SCHEMA_VERSION}`,
+                        details: { current, expected: LATEST_SCHEMA_VERSION },
+                        fix: {
+                            description: `Migrate database from v${current} to v${LATEST_SCHEMA_VERSION}`,
+                            destructive: false,
+                            apply: () => {
+                                getDB();
+                                return { ok: true, message: `Migrated to v${LATEST_SCHEMA_VERSION}` };
+                            },
+                        },
+                    };
+                }
+                return {
+                    id: 'versions.schema-compat',
+                    category: 'versions',
+                    title: 'Database schema compatibility',
+                    severity: 'error',
+                    message: `DB is at v${current} but this CLI only knows up to v${LATEST_SCHEMA_VERSION}. ` +
+                        `Upgrade the CLI (npm i -g @spool-lab/cli).`,
+                    details: { current, expected: LATEST_SCHEMA_VERSION },
+                };
+            }
+            finally {
+                db.close();
+            }
+        },
+    },
+];
+//# sourceMappingURL=versions.js.map

package/dist/doctor/checks/versions.js.map

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

package/dist/doctor/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export { runChecks, listChecks } from './runner.js';
+//# sourceMappingURL=index.d.ts.map