localrag 0.1.0

package/README.md

@@ -0,0 +1,178 @@
+# localrag
+
+**Local-first semantic document search CLI.**  
+Find your files by *meaning*, not keywords — entirely on your machine. No cloud. No API keys.
+
+---
+
+## Features
+
+- 🔍 **Semantic search** across PDF, DOCX, XLSX, PPTX, TXT, and Markdown
+- ⚡ **Sub-second search** — queries hit pre-built vectors, not raw files
+- 👁  **Watch-based indexing** — the index updates automatically as files change
+- 🔒 **100% local** — embeddings and vectors never leave your machine
+- 📦 **Zero config** — works out of the box with one command
+
+---
+
+## Installation
+
+```bash
+npm install -g localrag
+```
+
+Requires **Node.js ≥ 18**.
+
+> **First run note:** On first use the embedding model (`all-MiniLM-L6-v2`, ~25 MB) is downloaded from Hugging Face and cached permanently in `~/.cache/huggingface`. An internet connection is only needed this once.
+
+---
+
+## Quick Start
+
+```bash
+# 1. Add a folder and run an initial index
+localrag init ~/Documents
+
+# 2. Search
+localrag search "vacation policy"
+
+# 3. Open the first result
+localrag open 1
+
+# 4. Start continuous watching (keeps index up-to-date)
+localrag start
+```
+
+---
+
+## Commands
+
+### `localrag init <folder>`
+
+Add a folder to the watch list and immediately index all supported files inside it.
+
+```bash
+localrag init ~/Documents
+localrag init ~/Desktop/Work
+```
+
+### `localrag search "<query>"`
+
+Semantically search indexed documents. Returns file path, page number, similarity score, and a content snippet.
+
+```bash
+localrag search "annual leave policy"
+localrag search "Q3 revenue projections"
+localrag search "meeting notes product roadmap"
+```
+
+Options:
+
+| Flag | Description | Default |
+|---|---|---|
+| `-t, --top <n>` | Number of results | `10` |
+
+### `localrag open <N>`
+
+Open the Nth result from the last search using your OS default app.
+
+```bash
+localrag open 1
+localrag open 3
+```
+
+### `localrag start`
+
+Start continuous background indexing. Runs in the foreground — press `Ctrl+C` to stop.
+
+```bash
+localrag start
+```
+
+### `localrag status`
+
+Display a summary of the current index.
+
+```bash
+localrag status
+```
+
+Output includes:
+- Watched folders
+- Indexed file count
+- Total chunk count
+- Database size on disk
+- Last indexing activity
+
+---
+
+## Supported File Types
+
+| Extension | Parser |
+|---|---|
+| `.pdf` | pdf-parse (per-page text) |
+| `.docx` | mammoth |
+| `.xlsx` | SheetJS |
+| `.pptx` | adm-zip + XML parsing |
+| `.txt` | fs.readFile |
+| `.md` | fs.readFile |
+
+---
+
+## Architecture
+
+```
+localrag init / start
+     │
+     ▼
+FileScanner / FileWatcher  (chokidar)
+     │
+     ▼
+Indexer  (orchestrator)
+  ├── Extractor  (PDF / DOCX / XLSX / PPTX / TXT / MD)
+  ├── ChunkingService  (500-char overlapping windows)
+  ├── EmbeddingService  (Transformers.js, all-MiniLM-L6-v2)
+  └── LanceDbRepository  (vector storage)
+          │
+          └── ~/.localrag/db/  (LanceDB)
+
+localrag search
+     │
+     ▼
+SearchService
+  ├── EmbeddingService  (embed query)
+  └── LanceDbRepository  (vector search)
+```
+
+**Data stored in `~/.localrag/`:**
+
+| File | Purpose |
+|---|---|
+| `config.json` | Watched folders, DB path |
+| `documents.json` | Per-file metadata + chunk counts |
+| `last-results.json` | Result cache for `open` command |
+| `db/` | LanceDB vector store |
+
+---
+
+## Local-First Design
+
+- No cloud services
+- No API keys required
+- All embeddings generated locally via ONNX runtime
+- All vectors stored locally in LanceDB
+
+---
+
+## Extending
+
+The extractor layer is designed for easy extension. To add a new file type:
+
+1. Create `src/extractors/<type>-extractor.ts` implementing `Extractor`
+2. Register it in `src/extractors/extractor.interface.ts`
+
+---
+
+## License
+
+MIT

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

@@ -0,0 +1,18 @@
+import { ExtractedChunk } from '../extractors/extractor.interface';
+export interface TextChunk {
+    id: string;
+    filePath: string;
+    page: number;
+    text: string;
+}
+export declare class ChunkingService {
+    /**
+     * Split an array of ExtractedChunks (from any extractor) into smaller,
+     * fixed-size overlapping TextChunks suitable for embedding.
+     *
+     * Each TextChunk retains the source page number from the ExtractedChunk it
+     * came from, enabling result display to show the right page.
+     */
+    chunk(filePath: string, extracted: ExtractedChunk[]): TextChunk[];
+}
+//# sourceMappingURL=chunking-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunking-service.d.ts","sourceRoot":"","sources":["../../src/chunking/chunking-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAInE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;CAqBlE"}

package/dist/chunking/chunking-service.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunkingService = void 0;
+// ── Config ────────────────────────────────────────────────────────────────
+/** Target character count per chunk. */
+const CHUNK_SIZE = 500;
+/** Overlap between consecutive chunks (preserves context at boundaries). */
+const CHUNK_OVERLAP = 100;
+/** Minimum length to bother embedding. */
+const MIN_CHUNK_LENGTH = 20;
+// ── Service ───────────────────────────────────────────────────────────────
+class ChunkingService {
+    /**
+     * Split an array of ExtractedChunks (from any extractor) into smaller,
+     * fixed-size overlapping TextChunks suitable for embedding.
+     *
+     * Each TextChunk retains the source page number from the ExtractedChunk it
+     * came from, enabling result display to show the right page.
+     */
+    chunk(filePath, extracted) {
+        const results = [];
+        let globalIndex = 0;
+        for (const { text, page = 0 } of extracted) {
+            if (!text.trim())
+                continue;
+            const subTexts = splitText(text);
+            for (const sub of subTexts) {
+                if (sub.trim().length < MIN_CHUNK_LENGTH)
+                    continue;
+                results.push({
+                    id: `${filePath}::${globalIndex++}`,
+                    filePath,
+                    page,
+                    text: sub.trim(),
+                });
+            }
+        }
+        return results;
+    }
+}
+exports.ChunkingService = ChunkingService;
+// ── Helpers ───────────────────────────────────────────────────────────────
+/**
+ * Split a long string into overlapping windows.
+ * Tries to break at whitespace boundaries to avoid cutting words.
+ */
+function splitText(text) {
+    if (text.length <= CHUNK_SIZE)
+        return [text];
+    const chunks = [];
+    let start = 0;
+    while (start < text.length) {
+        let end = start + CHUNK_SIZE;
+        if (end < text.length) {
+            // Extend to the next whitespace so we don't cut mid-word
+            const nextSpace = text.indexOf(' ', end);
+            if (nextSpace !== -1 && nextSpace - end < 50) {
+                end = nextSpace;
+            }
+        }
+        else {
+            end = text.length;
+        }
+        chunks.push(text.slice(start, end));
+        // Advance by (CHUNK_SIZE - CHUNK_OVERLAP), but always make progress
+        const advance = Math.max(1, CHUNK_SIZE - CHUNK_OVERLAP);
+        start += advance;
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunking-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunking-service.js","sourceRoot":"","sources":["../../src/chunking/chunking-service.ts"],"names":[],"mappings":";;;AAWA,6EAA6E;AAE7E,wCAAwC;AACxC,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,4EAA4E;AAC5E,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,0CAA0C;AAC1C,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,6EAA6E;AAE7E,MAAa,eAAe;IAC1B;;;;;;OAMG;IACH,KAAK,CAAC,QAAgB,EAAE,SAA2B;QACjD,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAE3B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YACjC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,gBAAgB;oBAAE,SAAS;gBACnD,OAAO,CAAC,IAAI,CAAC;oBACX,EAAE,EAAE,GAAG,QAAQ,KAAK,WAAW,EAAE,EAAE;oBACnC,QAAQ;oBACR,IAAI;oBACJ,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA7BD,0CA6BC;AAED,6EAA6E;AAE7E;;;GAGG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,GAAG,GAAG,KAAK,GAAG,UAAU,CAAC;QAE7B,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,yDAAyD;YACzD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACzC,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC;gBAC7C,GAAG,GAAG,SAAS,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACpB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAEpC,oEAAoE;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC;QACxD,KAAK,IAAI,OAAO,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * `localrag init <folder>`
+ *
+ * Adds the given folder to the watched list and immediately performs
+ * a full initial scan so results are available right away.
+ */
+export declare function initCommand(folder: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2D/D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,107 @@
+"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.initCommand = initCommand;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+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");
+/**
+ * `localrag init <folder>`
+ *
+ * Adds the given folder to the watched list and immediately performs
+ * a full initial scan so results are available right away.
+ */
+async function initCommand(folder) {
+    const absFolder = path.resolve(folder);
+    // Validate folder
+    if (!fs.existsSync(absFolder)) {
+        console.error(chalk_1.default.red(`✗ Folder not found: ${absFolder}`));
+        process.exit(1);
+    }
+    if (!fs.statSync(absFolder).isDirectory()) {
+        console.error(chalk_1.default.red(`✗ Not a directory: ${absFolder}`));
+        process.exit(1);
+    }
+    const config = new config_service_1.ConfigService();
+    const added = config.addWatchedFolder(absFolder);
+    if (!added) {
+        console.log(chalk_1.default.yellow(`⚠  Folder already watched: ${absFolder}`));
+    }
+    else {
+        console.log(chalk_1.default.green(`✓ Added watched folder: ${absFolder}`));
+    }
+    // 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);
+    const scanner = new file_scanner_1.FileScanner(metadata, indexer);
+    console.log(chalk_1.default.cyan('\n🔍 Starting initial scan…\n'));
+    const spinner = (0, ora_1.default)({ text: 'Scanning…', spinner: 'dots' }).start();
+    let indexed = 0;
+    let errors = 0;
+    const processed = await scanner.scan([absFolder], {
+        onProgress: (msg) => {
+            spinner.text = msg;
+        },
+        onError: (filePath, err) => {
+            spinner.warn(chalk_1.default.red(`Error: ${path.basename(filePath)} — ${err.message}`));
+            spinner.start();
+            errors++;
+        },
+    });
+    indexed = processed;
+    spinner.succeed(chalk_1.default.green(`Initial scan complete.`));
+    console.log('');
+    console.log(`  ${chalk_1.default.bold('Indexed:')}  ${chalk_1.default.cyan(indexed)} file(s)`);
+    if (errors > 0) {
+        console.log(`  ${chalk_1.default.bold('Errors:')}   ${chalk_1.default.red(errors)} file(s) skipped`);
+    }
+    console.log('');
+    console.log(chalk_1.default.dim(`Run ${chalk_1.default.white('localrag start')} to watch for changes.`));
+    console.log(chalk_1.default.dim(`Run ${chalk_1.default.white('localrag search "<query>"')} to search.`));
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * `localrag open <N>`
+ *
+ * Opens the Nth result from the last `localrag search` run using the
+ * OS-default application (open / xdg-open / start).
+ */
+export declare function openCommand(resultNumber: string): Promise<void>;
+//# sourceMappingURL=open.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/open.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCrE"}

package/dist/cli/commands/open.js

@@ -0,0 +1,105 @@
+"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.openCommand = openCommand;
+const path = __importStar(require("path"));
+const childProcess = __importStar(require("child_process"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_service_1 = require("../../config/config-service");
+const search_service_1 = require("../../search/search-service");
+const lancedb_repository_1 = require("../../db/lancedb-repository");
+const embedding_service_1 = require("../../embedding/embedding-service");
+/**
+ * `localrag open <N>`
+ *
+ * Opens the Nth result from the last `localrag search` run using the
+ * OS-default application (open / xdg-open / start).
+ */
+async function openCommand(resultNumber) {
+    const n = parseInt(resultNumber, 10);
+    if (isNaN(n) || n < 1) {
+        console.error(chalk_1.default.red('✗ Please provide a valid result number (e.g. localrag open 1).'));
+        process.exit(1);
+    }
+    const config = new config_service_1.ConfigService();
+    // SearchService exposes getLastResults() which reads last-results.json
+    const repo = new lancedb_repository_1.LanceDbRepository();
+    // We don't need a full DB connection just to read cached results,
+    // but SearchService requires a repo instance. We'll instantiate without
+    // calling initialize() to avoid the DB overhead.
+    const embedder = new embedding_service_1.EmbeddingService();
+    const searchService = new search_service_1.SearchService(config, repo, embedder);
+    const results = searchService.getLastResults();
+    if (results.length === 0) {
+        console.error(chalk_1.default.red('✗ No previous search results found.'));
+        console.log(chalk_1.default.dim(`Run ${chalk_1.default.white('localrag search "<query>"')} first.`));
+        process.exit(1);
+    }
+    if (n > results.length) {
+        console.error(chalk_1.default.red(`✗ Result ${n} doesn't exist. Last search returned ${results.length} result(s).`));
+        process.exit(1);
+    }
+    const result = results[n - 1];
+    const filePath = result.filePath;
+    console.log(chalk_1.default.cyan(`Opening: ${path.basename(filePath)}`));
+    console.log(chalk_1.default.dim(filePath));
+    openFile(filePath);
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+function openFile(filePath) {
+    const platform = process.platform;
+    let cmd;
+    if (platform === 'darwin') {
+        cmd = `open "${escapePath(filePath)}"`;
+    }
+    else if (platform === 'win32') {
+        cmd = `start "" "${escapePath(filePath)}"`;
+    }
+    else {
+        cmd = `xdg-open "${escapePath(filePath)}"`;
+    }
+    childProcess.exec(cmd, (err) => {
+        if (err) {
+            console.error(chalk_1.default.red(`✗ Failed to open file: ${err.message}`));
+        }
+    });
+}
+function escapePath(p) {
+    return p.replace(/"/g, '\\"');
+}
+//# sourceMappingURL=open.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * `localrag search "<query>"`
+ *
+ * Embeds the query, runs vector search, and displays ranked results.
+ * Results are also saved so `localrag open <N>` can open them by index.
+ */
+export declare function searchCommand(query: string, options: {
+    top?: string;
+}): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE3F"}

package/dist/cli/commands/search.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchCommand = searchCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const config_service_1 = require("../../config/config-service");
+const lancedb_repository_1 = require("../../db/lancedb-repository");
+const embedding_service_1 = require("../../embedding/embedding-service");
+const search_service_1 = require("../../search/search-service");
+/**
+ * `localrag search "<query>"`
+ *
+ * Embeds the query, runs vector search, and displays ranked results.
+ * Results are also saved so `localrag open <N>` can open them by index.
+ */
+async function searchCommand(query, options) {
+    const topK = options.top ? parseInt(options.top, 10) : 10;
+    if (!query.trim()) {
+        console.error(chalk_1.default.red('✗ Query cannot be empty.'));
+        process.exit(1);
+    }
+    const config = new config_service_1.ConfigService();
+    if (config.getWatchedFolders().length === 0) {
+        console.error(chalk_1.default.red('✗ No folders indexed yet.'));
+        console.log(chalk_1.default.dim(`Run ${chalk_1.default.white('localrag init <folder>')} first.`));
+        process.exit(1);
+    }
+    const repo = new lancedb_repository_1.LanceDbRepository();
+    await repo.initialize(config.getDbPath());
+    const embedder = new embedding_service_1.EmbeddingService();
+    const searchService = new search_service_1.SearchService(config, repo, embedder);
+    const spinner = (0, ora_1.default)({ text: `Searching for "${query}"…`, spinner: 'dots' }).start();
+    let results;
+    try {
+        results = await searchService.search(query, topK);
+    }
+    catch (err) {
+        spinner.fail('Search failed.');
+        console.error(chalk_1.default.red((err instanceof Error ? err.message : String(err))));
+        process.exit(1);
+    }
+    spinner.stop();
+    if (results.length === 0) {
+        console.log(chalk_1.default.yellow('\n  No results found.\n'));
+        console.log(chalk_1.default.dim('  Try indexing more documents with: localrag init <folder>'));
+        return;
+    }
+    // ── Display results ────────────────────────────────────────────────────
+    console.log('');
+    console.log(chalk_1.default.bold.cyan(`  Search results for: `) + chalk_1.default.bold.white(`"${query}"`) +
+        chalk_1.default.dim(`  (top ${results.length})`));
+    console.log('');
+    results.forEach((result, idx) => {
+        const num = chalk_1.default.bold.cyan(`  [${idx + 1}]`);
+        const fileName = chalk_1.default.bold.white(result.fileName);
+        const filePath = chalk_1.default.dim(result.filePath);
+        const page = result.page > 0
+            ? chalk_1.default.dim(`  Page ${result.page}`)
+            : '';
+        const score = chalk_1.default.green(`  Score: ${(result.score * 100).toFixed(1)}%`);
+        const snippet = chalk_1.default.white(`  ${result.text}`);
+        console.log(`${num} ${fileName}${page}${score}`);
+        console.log(`     ${filePath}`);
+        console.log(`     ${snippet}`);
+        console.log('');
+    });
+    console.log(chalk_1.default.dim(`  Run ${chalk_1.default.white('localrag open <N>')} to open a result.`));
+    console.log('');
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * `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.
+ */
+export declare function startCommand(): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA8ElD"}