localrag 0.1.0

package/dist/cli/commands/start.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startCommand = startCommand;
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const config_service_1 = require("../../config/config-service");
+const metadata_service_1 = require("../../metadata/metadata-service");
+const lancedb_repository_1 = require("../../db/lancedb-repository");
+const embedding_service_1 = require("../../embedding/embedding-service");
+const indexer_1 = require("../../indexer/indexer");
+const file_scanner_1 = require("../../scanner/file-scanner");
+const file_watcher_1 = require("../../watcher/file-watcher");
+/**
+ * `localrag start`
+ *
+ * Performs a startup scan to catch missed changes, then starts a persistent
+ * file watcher to keep the index up-to-date in real time.
+ */
+async function startCommand() {
+    const config = new config_service_1.ConfigService();
+    const folders = config.getWatchedFolders();
+    if (folders.length === 0) {
+        console.error(chalk_1.default.red('✗ No watched folders configured.'));
+        console.log(chalk_1.default.dim(`Run ${chalk_1.default.white('localrag init <folder>')} first.`));
+        process.exit(1);
+    }
+    // Initialise services
+    const repo = new lancedb_repository_1.LanceDbRepository();
+    await repo.initialize(config.getDbPath());
+    const metadata = new metadata_service_1.MetadataService(config);
+    const embedder = new embedding_service_1.EmbeddingService();
+    const indexer = new indexer_1.Indexer(config, repo, metadata, embedder);
+    // ── 1. Startup scan ────────────────────────────────────────────────────
+    console.log(chalk_1.default.cyan.bold('\n📂 localrag — starting up\n'));
+    console.log(`Watched folders:`);
+    folders.forEach(f => console.log(`  ${chalk_1.default.dim('•')} ${f}`));
+    console.log('');
+    const scanSpinner = (0, ora_1.default)({ text: 'Running startup scan…', spinner: 'dots' }).start();
+    const scanner = new file_scanner_1.FileScanner(metadata, indexer);
+    let scanErrors = 0;
+    await scanner.scan(folders, {
+        onProgress: (msg) => { scanSpinner.text = msg; },
+        onError: (_fp, err) => {
+            scanSpinner.warn(chalk_1.default.red(`Error: ${err.message}`));
+            scanSpinner.start();
+            scanErrors++;
+        },
+    });
+    scanSpinner.succeed('Startup scan complete.');
+    if (scanErrors > 0) {
+        console.log(chalk_1.default.yellow(`  ${scanErrors} file(s) had errors during scan.`));
+    }
+    // ── 2. Live watcher ────────────────────────────────────────────────────
+    console.log(chalk_1.default.cyan('\n👁  Watching for changes… (Ctrl+C to stop)\n'));
+    const watcher = new file_watcher_1.FileWatcher(indexer);
+    watcher.watch(folders, {
+        onAdd: (fp) => {
+            console.log(chalk_1.default.green(`+ ${path.basename(fp)}`) + chalk_1.default.dim(` — ${fp}`));
+        },
+        onChange: (fp) => {
+            console.log(chalk_1.default.yellow(`~ ${path.basename(fp)}`) + chalk_1.default.dim(` — ${fp}`));
+        },
+        onUnlink: (fp) => {
+            console.log(chalk_1.default.red(`- ${path.basename(fp)}`) + chalk_1.default.dim(` — ${fp}`));
+        },
+        onProgress: (msg) => {
+            console.log(chalk_1.default.dim(`  ${msg}`));
+        },
+        onError: (fp, err) => {
+            console.log(chalk_1.default.red(`  ✗ ${path.basename(fp)}: ${err.message}`));
+        },
+        onReady: () => {
+            console.log(chalk_1.default.dim('  Watcher ready — monitoring for filesystem changes.'));
+        },
+    });
+    // Keep the process alive until Ctrl+C
+    const shutdown = async () => {
+        console.log(chalk_1.default.dim('\nShutting down…'));
+        await watcher.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

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

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `localrag status`
+ *
+ * Displays a summary of the current index state:
+ * - Watched folders
+ * - Indexed file count
+ * - Total chunk count
+ * - Vector DB size on disk
+ * - Last indexing activity
+ */
+export declare function statusCommand(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAUA;;;;;;;;;GASG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA+DnD"}

package/dist/cli/commands/status.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusCommand = statusCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const config_service_1 = require("../../config/config-service");
+const metadata_service_1 = require("../../metadata/metadata-service");
+const lancedb_repository_1 = require("../../db/lancedb-repository");
+const BYTES_PER_MB = 1024 * 1024;
+/**
+ * `localrag status`
+ *
+ * Displays a summary of the current index state:
+ * - Watched folders
+ * - Indexed file count
+ * - Total chunk count
+ * - Vector DB size on disk
+ * - Last indexing activity
+ */
+async function statusCommand() {
+    const config = new config_service_1.ConfigService();
+    const folders = config.getWatchedFolders();
+    const repo = new lancedb_repository_1.LanceDbRepository();
+    const metadata = new metadata_service_1.MetadataService(config);
+    const spinner = (0, ora_1.default)({ text: 'Gathering stats…', spinner: 'dots' }).start();
+    let dbSizeMb = '—';
+    try {
+        await repo.initialize(config.getDbPath());
+        const bytes = await repo.getDbSizeBytes(config.getDbPath());
+        dbSizeMb = (bytes / BYTES_PER_MB).toFixed(2) + ' MB';
+    }
+    catch {
+        // DB may not exist yet
+    }
+    spinner.stop();
+    const docCount = metadata.getCount();
+    const chunkCount = metadata.getTotalChunkCount();
+    const lastActivity = metadata.getLastActivity() ?? config.getLastActivity() ?? 'Never';
+    // ── Display ─────────────────────────────────────────────────────────────
+    console.log('');
+    console.log(chalk_1.default.bold.cyan('  localrag — index status'));
+    console.log(chalk_1.default.dim('  ─────────────────────────────────────'));
+    console.log('');
+    // Watched folders
+    console.log(`  ${chalk_1.default.bold('Watched folders:')}  ${folders.length === 0 ? chalk_1.default.dim('none') : ''}`);
+    if (folders.length > 0) {
+        folders.forEach(f => {
+            console.log(`    ${chalk_1.default.dim('•')} ${f}`);
+        });
+    }
+    console.log('');
+    // Stats table
+    const rows = [
+        ['Indexed files', chalk_1.default.cyan(String(docCount))],
+        ['Total chunks', chalk_1.default.cyan(String(chunkCount))],
+        ['DB size', chalk_1.default.cyan(dbSizeMb)],
+        ['Last activity', formatDate(lastActivity)],
+    ];
+    rows.forEach(([label, value]) => {
+        console.log(`  ${chalk_1.default.bold(label.padEnd(18))} ${value}`);
+    });
+    console.log('');
+    if (folders.length === 0) {
+        console.log(chalk_1.default.dim(`  Run ${chalk_1.default.white('localrag init <folder>')} to get started.`));
+    }
+    else if (docCount === 0) {
+        console.log(chalk_1.default.dim(`  Run ${chalk_1.default.white('localrag start')} to index your documents.`));
+    }
+    else {
+        console.log(chalk_1.default.dim(`  Run ${chalk_1.default.white('localrag search "<query>"')} to search.`));
+    }
+    console.log('');
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+function formatDate(iso) {
+    if (iso === 'Never')
+        return chalk_1.default.dim('Never');
+    try {
+        const d = new Date(iso);
+        return chalk_1.default.white(d.toLocaleString());
+    }
+    catch {
+        return chalk_1.default.dim(iso);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const start_1 = require("./commands/start");
+const search_1 = require("./commands/search");
+const open_1 = require("./commands/open");
+const status_1 = require("./commands/status");
+const program = new commander_1.Command();
+program
+    .name('localrag')
+    .description('Local-first semantic document search — find your documents by meaning, not keywords.')
+    .version('0.1.0');
+// ── localrag init <folder> ─────────────────────────────────────────────────
+program
+    .command('init <folder>')
+    .description('Add a folder to the watch list and run an initial index.')
+    .action(async (folder) => {
+    await (0, init_1.initCommand)(folder).catch(fatal);
+});
+// ── localrag start ─────────────────────────────────────────────────────────
+program
+    .command('start')
+    .description('Start continuous background indexing (runs in the foreground).')
+    .action(async () => {
+    await (0, start_1.startCommand)().catch(fatal);
+});
+// ── localrag search "<query>" ──────────────────────────────────────────────
+program
+    .command('search <query>')
+    .description('Semantic search across all indexed documents.')
+    .option('-t, --top <n>', 'Number of results to return (default: 10)', '10')
+    .action(async (query, options) => {
+    await (0, search_1.searchCommand)(query, options).catch(fatal);
+});
+// ── localrag open <N> ──────────────────────────────────────────────────────
+program
+    .command('open <result-number>')
+    .description('Open the Nth result from the last search using the OS default app.')
+    .action(async (resultNumber) => {
+    await (0, open_1.openCommand)(resultNumber).catch(fatal);
+});
+// ── localrag status ────────────────────────────────────────────────────────
+program
+    .command('status')
+    .description('Show the current index status and statistics.')
+    .action(async () => {
+    await (0, status_1.statusCommand)().catch(fatal);
+});
+// ── Error handler ─────────────────────────────────────────────────────────
+function fatal(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`\n  ✗ Fatal error: ${msg}\n`);
+    process.exit(1);
+}
+// ── Parse ─────────────────────────────────────────────────────────────────
+program.parse(process.argv);
+if (process.argv.length < 3) {
+    program.help();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,0CAA8C;AAC9C,4CAAgD;AAChD,8CAAkD;AAClD,0CAA8C;AAC9C,8CAAkD;AAElD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,sFAAsF,CAAC;KACnG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,8EAA8E;AAC9E,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,0DAA0D,CAAC;KACvE,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;IAC/B,MAAM,IAAA,kBAAW,EAAC,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEL,8EAA8E;AAC9E,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,oBAAY,GAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL,8EAA8E;AAC9E,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,eAAe,EAAE,2CAA2C,EAAE,IAAI,CAAC;KAC1E,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAAyB,EAAE,EAAE;IACzD,MAAM,IAAA,sBAAa,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEL,8EAA8E;AAC9E,OAAO;KACJ,OAAO,CAAC,sBAAsB,CAAC;KAC/B,WAAW,CAAC,oEAAoE,CAAC;KACjF,MAAM,CAAC,KAAK,EAAE,YAAoB,EAAE,EAAE;IACrC,MAAM,IAAA,kBAAW,EAAC,YAAY,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,8EAA8E;AAC9E,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,sBAAa,GAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEL,6EAA6E;AAE7E,SAAS,KAAK,CAAC,GAAY;IACzB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,6EAA6E;AAE7E,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC5B,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,22 @@
+export interface localragConfig {
+    watchedFolders: string[];
+    dbPath: string;
+    lastActivity?: string;
+}
+export declare class ConfigService {
+    private config;
+    constructor();
+    private load;
+    getConfig(): localragConfig;
+    getDataDir(): string;
+    getDbPath(): string;
+    getDocumentsPath(): string;
+    getLastResultsPath(): string;
+    getStatsPath(): string;
+    getWatchedFolders(): string[];
+    addWatchedFolder(folder: string): boolean;
+    setLastActivity(isoString: string): void;
+    getLastActivity(): string | undefined;
+    private save;
+}
+//# sourceMappingURL=config-service.d.ts.map

package/dist/config/config-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.d.ts","sourceRoot":"","sources":["../../src/config/config-service.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;;IAM/B,OAAO,CAAC,IAAI;IAYZ,SAAS,IAAI,cAAc;IAI3B,UAAU,IAAI,MAAM;IAKpB,SAAS,IAAI,MAAM;IAMnB,gBAAgB,IAAI,MAAM;IAI1B,kBAAkB,IAAI,MAAM;IAI5B,YAAY,IAAI,MAAM;IAItB,iBAAiB,IAAI,MAAM,EAAE;IAI7B,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQzC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxC,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC,OAAO,CAAC,IAAI;CAIb"}

package/dist/config/config-service.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const DATA_DIR = path.join(os.homedir(), '.localrag');
+const CONFIG_PATH = path.join(DATA_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    watchedFolders: [],
+    dbPath: path.join(DATA_DIR, 'db'),
+};
+class ConfigService {
+    config;
+    constructor() {
+        this.config = this.load();
+    }
+    load() {
+        try {
+            if (fs.existsSync(CONFIG_PATH)) {
+                const raw = fs.readFileSync(CONFIG_PATH, 'utf-8');
+                return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+            }
+        }
+        catch {
+            // ignore parse errors — use defaults
+        }
+        return { ...DEFAULT_CONFIG };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getDataDir() {
+        fs.mkdirSync(DATA_DIR, { recursive: true });
+        return DATA_DIR;
+    }
+    getDbPath() {
+        const dbPath = this.config.dbPath;
+        fs.mkdirSync(dbPath, { recursive: true });
+        return dbPath;
+    }
+    getDocumentsPath() {
+        return path.join(DATA_DIR, 'documents.json');
+    }
+    getLastResultsPath() {
+        return path.join(DATA_DIR, 'last-results.json');
+    }
+    getStatsPath() {
+        return path.join(DATA_DIR, 'stats.json');
+    }
+    getWatchedFolders() {
+        return [...this.config.watchedFolders];
+    }
+    addWatchedFolder(folder) {
+        const abs = path.resolve(folder);
+        if (this.config.watchedFolders.includes(abs))
+            return false;
+        this.config.watchedFolders.push(abs);
+        this.save();
+        return true;
+    }
+    setLastActivity(isoString) {
+        this.config.lastActivity = isoString;
+        this.save();
+    }
+    getLastActivity() {
+        return this.config.lastActivity;
+    }
+    save() {
+        fs.mkdirSync(DATA_DIR, { recursive: true });
+        fs.writeFileSync(CONFIG_PATH, JSON.stringify(this.config, null, 2));
+    }
+}
+exports.ConfigService = ConfigService;
+//# sourceMappingURL=config-service.js.map

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

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

package/dist/db/lancedb-repository.d.ts

@@ -0,0 +1,28 @@
+export interface ChunkRecord {
+    id: string;
+    filePath: string;
+    page: number;
+    text: string;
+    vector: number[];
+}
+export interface SearchResult {
+    id: string;
+    filePath: string;
+    fileName: string;
+    page: number;
+    text: string;
+    score: number;
+}
+export declare class LanceDbRepository {
+    private db;
+    private chunksTable;
+    private initialized;
+    initialize(dbPath: string): Promise<void>;
+    private initChunksTable;
+    private ensureInit;
+    upsertChunks(chunks: ChunkRecord[]): Promise<void>;
+    deleteChunksByPath(filePath: string): Promise<void>;
+    vectorSearch(queryVector: number[], topK?: number): Promise<SearchResult[]>;
+    getDbSizeBytes(dbPath: string): Promise<number>;
+}
+//# sourceMappingURL=lancedb-repository.d.ts.map

package/dist/db/lancedb-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb-repository.d.ts","sourceRoot":"","sources":["../../src/db/lancedb-repository.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AASD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAsB;IAChC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,WAAW,CAAS;IAItB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAOjC,eAAe;IAoB7B,OAAO,CAAC,UAAU;IAQZ,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoBvE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAmBtD"}

package/dist/db/lancedb-repository.js

@@ -0,0 +1,132 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LanceDbRepository = void 0;
+const path = __importStar(require("path"));
+const lancedb = __importStar(require("vectordb"));
+// ── Constants ─────────────────────────────────────────────────────────────
+const VECTOR_DIM = 384; // all-MiniLM-L6-v2 output dimension
+const PLACEHOLDER_ID = '__localrag_init__';
+// ── Repository ────────────────────────────────────────────────────────────
+class LanceDbRepository {
+    db;
+    chunksTable;
+    initialized = false;
+    // ── Init ────────────────────────────────────────────────────────────────
+    async initialize(dbPath) {
+        if (this.initialized)
+            return;
+        this.db = await lancedb.connect(dbPath);
+        await this.initChunksTable();
+        this.initialized = true;
+    }
+    async initChunksTable() {
+        const names = await this.db.tableNames();
+        if (names.includes('chunks')) {
+            this.chunksTable = await this.db.openTable('chunks');
+        }
+        else {
+            // Create with a placeholder row to define schema
+            const placeholder = [
+                {
+                    id: PLACEHOLDER_ID,
+                    filePath: '',
+                    page: 0,
+                    text: '',
+                    vector: new Array(VECTOR_DIM).fill(0),
+                },
+            ];
+            this.chunksTable = await this.db.createTable('chunks', placeholder);
+            await this.chunksTable.delete(`id = '${PLACEHOLDER_ID}'`);
+        }
+    }
+    ensureInit() {
+        if (!this.initialized) {
+            throw new Error('LanceDbRepository: call initialize() before use');
+        }
+    }
+    // ── Write ops ───────────────────────────────────────────────────────────
+    async upsertChunks(chunks) {
+        this.ensureInit();
+        if (chunks.length === 0)
+            return;
+        await this.chunksTable.add(chunks);
+    }
+    async deleteChunksByPath(filePath) {
+        this.ensureInit();
+        const escaped = filePath.replace(/'/g, "''");
+        await this.chunksTable.delete(`"filePath" = '${escaped}'`);
+    }
+    // ── Read / Search ops ───────────────────────────────────────────────────
+    async vectorSearch(queryVector, topK = 10) {
+        this.ensureInit();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = await this.chunksTable
+            .search(queryVector)
+            .limit(topK)
+            .execute();
+        return raw.map(r => ({
+            id: String(r.id),
+            filePath: String(r.filePath),
+            fileName: path.basename(String(r.filePath)),
+            page: Number(r.page),
+            text: String(r.text),
+            // LanceDB returns _distance (lower = closer). Convert cosine distance → similarity score.
+            score: Math.max(0, 1 - Number(r._distance ?? 0)),
+        }));
+    }
+    async getDbSizeBytes(dbPath) {
+        const { readdirSync, statSync } = await Promise.resolve().then(() => __importStar(require('fs')));
+        let total = 0;
+        const walk = (dir) => {
+            try {
+                for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                    const full = path.join(dir, entry.name);
+                    if (entry.isDirectory())
+                        walk(full);
+                    else
+                        total += statSync(full).size;
+                }
+            }
+            catch {
+                // skip unreadable dirs
+            }
+        };
+        walk(dbPath);
+        return total;
+    }
+}
+exports.LanceDbRepository = LanceDbRepository;
+//# sourceMappingURL=lancedb-repository.js.map

package/dist/db/lancedb-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb-repository.js","sourceRoot":"","sources":["../../src/db/lancedb-repository.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAC7B,kDAAoC;AAqBpC,6EAA6E;AAE7E,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,oCAAoC;AAC5D,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,6EAA6E;AAE7E,MAAa,iBAAiB;IACpB,EAAE,CAAsB;IACxB,WAAW,CAA8B;IACzC,WAAW,GAAG,KAAK,CAAC;IAE5B,2EAA2E;IAE3E,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAA0C,CAAC;QAChG,CAAC;aAAM,CAAC;YACN,iDAAiD;YACjD,MAAM,WAAW,GAA8B;gBAC7C;oBACE,EAAE,EAAE,cAAc;oBAClB,QAAQ,EAAE,EAAE;oBACZ,IAAI,EAAE,CAAC;oBACP,IAAI,EAAE,EAAE;oBACR,MAAM,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAa;iBAClD;aACF,CAAC;YACF,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAA0C,CAAC;YAC7G,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,cAAc,GAAG,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,YAAY,CAAC,MAAqB;QACtC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAA8C,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAgB;QACvC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,iBAAiB,OAAO,GAAG,CAAC,CAAC;IAC7D,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,YAAY,CAAC,WAAqB,EAAE,IAAI,GAAG,EAAE;QACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,8DAA8D;QAC9D,MAAM,GAAG,GAAU,MAAO,IAAI,CAAC,WAAmB;aAC/C,MAAM,CAAC,WAAW,CAAC;aACnB,KAAK,CAAC,IAAI,CAAC;aACX,OAAO,EAAE,CAAC;QAEb,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnB,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACpB,0FAA0F;YAC1F,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;SACjD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,wDAAa,IAAI,GAAC,CAAC;QACrD,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;YAC3B,IAAI,CAAC;gBACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;oBACxC,IAAI,KAAK,CAAC,WAAW,EAAE;wBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;;wBAC/B,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;gBACpC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA/FD,8CA+FC"}