abb-opencode-local-rag 0.1.0

package/dist/cli/read-neighbors.js

@@ -0,0 +1,224 @@
+// CLI read-neighbors subcommand — read N chunks before/after a target chunk within one document
+import { resolve } from 'node:path';
+import { MAX_NEIGHBOR_COUNT } from '../utils/limits.js';
+import { extractSourceFromPath, generateRawDataPath, isManagedRawDataPath, } from '../utils/raw-data-utils.js';
+import { createVectorStore, formatCliError } from './common.js';
+import { resolveGlobalConfig, validatePath } from './options.js';
+// ============================================
+// Defaults
+// ============================================
+const READ_NEIGHBORS_DEFAULTS = {
+    before: 2,
+    after: 2,
+};
+// ============================================
+// Help
+// ============================================
+const HELP_TEXT = `Usage: mcp-local-rag [global-options] read-neighbors [options]
+
+Read N chunks before and after a target chunk within the same document.
+
+Either --file-path or --source is required, not both.
+
+Options:
+  --file-path <abs-path>   File path of ingested content (absolute path)
+  --source <id>            Source identifier (for content ingested via ingest_data)
+  --chunk-index <n>        Target chunk index (zero-based, required, non-negative integer)
+  --before <n>             Number of chunks before the target (default: ${READ_NEIGHBORS_DEFAULTS.before}, non-negative integer)
+  --after <n>              Number of chunks after the target (default: ${READ_NEIGHBORS_DEFAULTS.after}, non-negative integer)
+  -h, --help               Show this help
+
+Defaults: before=${READ_NEIGHBORS_DEFAULTS.before}, after=${READ_NEIGHBORS_DEFAULTS.after} (grep -C 2 convention)
+
+Example:
+  npx mcp-local-rag read-neighbors --file-path /abs/path/file.md --chunk-index 12 --before 3 --after 3
+
+Global options (must appear before "read-neighbors"):
+  --db-path <path>         LanceDB database path
+  --cache-dir <path>       Model cache directory
+  --model-name <name>      Embedding model`;
+/**
+ * Parse a value expected to be a non-negative integer flag value.
+ * Throws a descriptive Error on malformed input; the outer runReadNeighbors
+ * try/catch converts this into `console.error` + `process.exit(1)`.
+ */
+function parseNonNegativeInteger(flag, rawValue) {
+    if (rawValue === undefined || rawValue.startsWith('-')) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    const parsed = Number.parseInt(rawValue, 10);
+    if (!Number.isInteger(parsed) || parsed < 0 || String(parsed) !== rawValue) {
+        throw new Error(`${flag} must be a non-negative integer`);
+    }
+    return parsed;
+}
+/**
+ * Parse read-neighbors CLI arguments.
+ * Flags: --file-path, --source, --chunk-index, --before, --after, -h/--help.
+ * Integer flags are validated syntactically (must be non-negative integer).
+ * Semantic validation (required-ness, XOR) is performed in runReadNeighbors.
+ */
+function parseArgs(args) {
+    let help = false;
+    let filePath;
+    let source;
+    let chunkIndex;
+    let before;
+    let after;
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '-h' || arg === '--help') {
+            help = true;
+            i++;
+        }
+        else if (arg === '--file-path') {
+            const value = args[++i];
+            if (value === undefined || value.startsWith('-')) {
+                throw new Error('Missing value for --file-path');
+            }
+            filePath = value;
+            i++;
+        }
+        else if (arg === '--source') {
+            const value = args[++i];
+            if (value === undefined || value.startsWith('-')) {
+                throw new Error('Missing value for --source');
+            }
+            source = value;
+            i++;
+        }
+        else if (arg === '--chunk-index') {
+            chunkIndex = parseNonNegativeInteger('--chunk-index', args[++i]);
+            i++;
+        }
+        else if (arg === '--before') {
+            before = parseNonNegativeInteger('--before', args[++i]);
+            i++;
+        }
+        else if (arg === '--after') {
+            after = parseNonNegativeInteger('--after', args[++i]);
+            i++;
+        }
+        else if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        else {
+            throw new Error(`Unexpected argument: ${arg}`);
+        }
+    }
+    const result = { help };
+    if (filePath !== undefined)
+        result.filePath = filePath;
+    if (source !== undefined)
+        result.source = source;
+    if (chunkIndex !== undefined)
+        result.chunkIndex = chunkIndex;
+    if (before !== undefined)
+        result.before = before;
+    if (after !== undefined)
+        result.after = after;
+    return result;
+}
+// ============================================
+// Main Entry Point
+// ============================================
+/**
+ * Run the read-neighbors CLI subcommand.
+ * Reads chunks adjacent to a target chunkIndex within a single document.
+ * Does NOT perform any search; this is an index-adjacent retrieval utility.
+ *
+ * @param args - Arguments after "read-neighbors"
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export async function runReadNeighbors(args, globalOptions = {}) {
+    // Parse CLI options (parse errors are caught and converted to exit(1) below).
+    let parsed;
+    try {
+        parsed = parseArgs(args);
+    }
+    catch (error) {
+        const reason = formatCliError(error);
+        console.error(`Error: ${reason}`);
+        process.exit(1);
+    }
+    // Handle --help OUTSIDE the main try/catch so exit(0) is not converted to exit(1).
+    // Mirrors src/cli/delete.ts and src/cli/query.ts.
+    if (parsed.help) {
+        console.error(HELP_TEXT);
+        process.exit(0);
+    }
+    try {
+        // Validation order matches the MCP handler: chunkIndex → before → after → XOR.
+        if (parsed.chunkIndex === undefined) {
+            throw new Error('--chunk-index is required and must be a non-negative integer');
+        }
+        const chunkIndex = parsed.chunkIndex;
+        const before = parsed.before ?? READ_NEIGHBORS_DEFAULTS.before;
+        if (before > MAX_NEIGHBOR_COUNT) {
+            throw new Error(`before must be between 0 and ${MAX_NEIGHBOR_COUNT} (got ${before})`);
+        }
+        const after = parsed.after ?? READ_NEIGHBORS_DEFAULTS.after;
+        if (after > MAX_NEIGHBOR_COUNT) {
+            throw new Error(`after must be between 0 and ${MAX_NEIGHBOR_COUNT} (got ${after})`);
+        }
+        // XOR: exactly one of --file-path / --source
+        const hasFilePath = parsed.filePath !== undefined;
+        const hasSource = parsed.source !== undefined;
+        if (!hasFilePath && !hasSource) {
+            throw new Error('Either --file-path or --source is required');
+        }
+        if (hasFilePath && hasSource) {
+            throw new Error('Cannot specify both --file-path and --source');
+        }
+        // Resolve global config
+        const globalConfig = resolveGlobalConfig(globalOptions);
+        // Determine target file path (dual-input resolution).
+        let targetPath;
+        if (parsed.source !== undefined) {
+            // Generate raw-data path from source identifier.
+            targetPath = generateRawDataPath(globalConfig.dbPath, parsed.source);
+        }
+        else {
+            // DB key is the resolve()'d ingest path, so look up by resolve() (never
+            // realpath); validate below (mirrors runDelete; realpath stays there).
+            targetPath = resolve(parsed.filePath);
+            const pathError = validatePath(targetPath, '--file-path');
+            if (pathError) {
+                console.error(pathError);
+                process.exit(1);
+            }
+        }
+        const vectorStore = createVectorStore(globalConfig);
+        try {
+            await vectorStore.initialize();
+            const minIdx = Math.max(0, chunkIndex - before);
+            const maxIdx = chunkIndex + after;
+            const rows = await vectorStore.getChunksByRange(targetPath, minIdx, maxIdx);
+            const isRaw = isManagedRawDataPath(targetPath, globalConfig.dbPath);
+            const sourceForAll = isRaw ? extractSourceFromPath(targetPath) : null;
+            const items = rows.map((row) => {
+                const item = {
+                    filePath: row.filePath,
+                    chunkIndex: row.chunkIndex,
+                    text: row.text,
+                    isTarget: row.chunkIndex === chunkIndex,
+                    fileTitle: row.fileTitle ?? null,
+                };
+                if (sourceForAll)
+                    item.source = sourceForAll;
+                return item;
+            });
+            process.stdout.write(`${JSON.stringify(items, null, 2)}\n`);
+        }
+        finally {
+            await vectorStore.close();
+        }
+    }
+    catch (error) {
+        const reason = formatCliError(error);
+        console.error(`Error: ${reason}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=read-neighbors.js.map

package/dist/cli/read-neighbors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-neighbors.js","sourceRoot":"","sources":["../../src/cli/read-neighbors.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE/D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhE,+CAA+C;AAC/C,WAAW;AACX,+CAA+C;AAE/C,MAAM,uBAAuB,GAAG;IAC9B,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACA,CAAA;AAEV,+CAA+C;AAC/C,OAAO;AACP,+CAA+C;AAE/C,MAAM,SAAS,GAAG;;;;;;;;;;0EAUwD,uBAAuB,CAAC,MAAM;yEAC/B,uBAAuB,CAAC,KAAK;;;mBAGnF,uBAAuB,CAAC,MAAM,WAAW,uBAAuB,CAAC,KAAK;;;;;;;;2CAQ9C,CAAA;AAe3C;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAE,QAA4B;IACzE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAC5C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,IAAI,GAAG,KAAK,CAAA;IAChB,IAAI,QAA4B,CAAA;IAChC,IAAI,MAA0B,CAAA;IAC9B,IAAI,UAA8B,CAAA;IAClC,IAAI,MAA0B,CAAA;IAC9B,IAAI,KAAyB,CAAA;IAE7B,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;QAEpB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAA;YACX,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;YAClD,CAAC;YACD,QAAQ,GAAG,KAAK,CAAA;YAChB,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;YACvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;YAC/C,CAAC;YACD,MAAM,GAAG,KAAK,CAAA;YACd,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YACnC,UAAU,GAAG,uBAAuB,CAAC,eAAe,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAChE,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,GAAG,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACvD,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,GAAG,uBAAuB,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACrD,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAA;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAsB,EAAE,IAAI,EAAE,CAAA;IAC1C,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;IACtD,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IAChD,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;IAC5D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;IAC7C,OAAO,MAAM,CAAA;AACf,CAAC;AAED,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAc,EACd,aAAa,GAAkB,EAAE;IAEjC,8EAA8E;IAC9E,IAAI,MAAyB,CAAA;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,EAAE,CAAC,CAAA;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,mFAAmF;IACnF,kDAAkD;IAClD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,IAAI,CAAC;QACH,+EAA+E;QAC/E,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;QACjF,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;QAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAA;QAC9D,IAAI,MAAM,GAAG,kBAAkB,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,kBAAkB,SAAS,MAAM,GAAG,CAAC,CAAA;QACvF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,uBAAuB,CAAC,KAAK,CAAA;QAC3D,IAAI,KAAK,GAAG,kBAAkB,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,+BAA+B,kBAAkB,SAAS,KAAK,GAAG,CAAC,CAAA;QACrF,CAAC;QAED,6CAA6C;QAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAA;QACjD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAA;QAC7C,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAC/D,CAAC;QACD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;QAED,wBAAwB;QACxB,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAA;QAEvD,sDAAsD;QACtD,IAAI,UAAkB,CAAA;QACtB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,iDAAiD;YACjD,UAAU,GAAG,mBAAmB,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QACtE,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,uEAAuE;YACvE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,QAAS,CAAC,CAAA;YACtC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;gBACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;QACnD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,UAAU,EAAE,CAAA;YAE9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,CAAA;YAC/C,MAAM,MAAM,GAAG,UAAU,GAAG,KAAK,CAAA;YACjC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;YAE3E,MAAM,KAAK,GAAG,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;YACnE,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YACrE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,MAAM,IAAI,GAON;oBACF,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,QAAQ,EAAE,GAAG,CAAC,UAAU,KAAK,UAAU;oBACvC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;iBACjC,CAAA;gBACD,IAAI,YAAY;oBAAE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAA;gBAC5C,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;YAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QAC7D,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,CAAC,KAAK,EAAE,CAAA;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,EAAE,CAAC,CAAA;QACjC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/cli/status.d.ts

@@ -0,0 +1,8 @@
+import type { GlobalOptions } from './options.js';
+/**
+ * Run the status CLI subcommand.
+ * @param args - Arguments after "status" (should be empty or --help)
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export declare function runStatus(args: string[], globalOptions?: GlobalOptions): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAoDjD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BhG"}

package/dist/cli/status.js

@@ -0,0 +1,80 @@
+// CLI status subcommand — show vector database status
+import { createVectorStore, formatCliError } from './common.js';
+import { resolveGlobalConfig } from './options.js';
+// ============================================
+// Help
+// ============================================
+const HELP_TEXT = `Usage: mcp-local-rag [global-options] status
+
+Show vector database status (document count, chunk count, memory usage, etc.).
+
+Options:
+  -h, --help             Show this help
+
+Global options (must appear before "status"):
+  --db-path <path>       LanceDB database path
+  --cache-dir <path>     Model cache directory
+  --model-name <name>    Embedding model`;
+// ============================================
+// Arg Parsing
+// ============================================
+/**
+ * Parse status-specific CLI arguments.
+ * Status accepts no options or positional args — only -h/--help.
+ * Unknown flags or positional args cause an error.
+ */
+function parseArgs(args) {
+    let help = false;
+    for (const arg of args) {
+        if (arg === '-h' || arg === '--help') {
+            help = true;
+        }
+        else if (arg.startsWith('-')) {
+            console.error(`Unknown option: ${arg}`);
+            console.error(HELP_TEXT);
+            process.exit(1);
+        }
+        else {
+            console.error(`Unexpected argument: ${arg}`);
+            console.error(HELP_TEXT);
+            process.exit(1);
+        }
+    }
+    return { help };
+}
+// ============================================
+// Main Entry Point
+// ============================================
+/**
+ * Run the status CLI subcommand.
+ * @param args - Arguments after "status" (should be empty or --help)
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export async function runStatus(args, globalOptions = {}) {
+    // Parse CLI options
+    const { help } = parseArgs(args);
+    // Handle --help
+    if (help) {
+        console.error(HELP_TEXT);
+        process.exit(0);
+    }
+    // Resolve global config
+    const globalConfig = resolveGlobalConfig(globalOptions);
+    const vectorStore = createVectorStore(globalConfig);
+    try {
+        await vectorStore.initialize();
+        // Get status
+        const status = await vectorStore.getStatus();
+        // Output JSON to stdout
+        process.stdout.write(JSON.stringify(status));
+    }
+    catch (error) {
+        const reason = formatCliError(error);
+        console.error(`Error: ${reason}`);
+        process.exitCode = 1;
+    }
+    finally {
+        await vectorStore.close();
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,+CAA+C;AAC/C,OAAO;AACP,+CAA+C;AAE/C,MAAM,SAAS,GAAG;;;;;;;;;;yCAUuB,CAAA;AAEzC,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAc;IAC/B,IAAI,IAAI,GAAG,KAAK,CAAA;IAEhB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAA;YACvC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;YAC5C,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAA;AACjB,CAAC;AAED,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,aAAa,GAAkB,EAAE;IAC/E,oBAAoB;IACpB,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAEhC,gBAAgB;IAChB,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,wBAAwB;IACxB,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;IAEnD,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,UAAU,EAAE,CAAA;QAE9B,aAAa;QACb,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,CAAA;QAE5C,wBAAwB;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACpC,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,EAAE,CAAC,CAAA;QACjC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,CAAC,KAAK,EAAE,CAAA;IAC3B,CAAC;AACH,CAAC"}

package/dist/cli/sync.d.ts

@@ -0,0 +1,8 @@
+import type { GlobalOptions } from './options.js';
+/**
+ * Run the sync CLI subcommand.
+ * @param args - Arguments after "sync"
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export declare function runSync(args: string[], globalOptions?: GlobalOptions): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAgIjD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6I9F"}

package/dist/cli/sync.js

@@ -0,0 +1,244 @@
+// CLI sync subcommand — foreground incremental reconciliation of the index.
+//
+// Composition root for `src/features/sync.ts`: this file supplies the real
+// collaborators (filesystem, scanner, hasher, store, ingestion) and renders the
+// result. Planning, prune eligibility, execution order, and the stop-on-first-
+// error policy all live in the core and are not reproduced here — including the
+// "inside a configured root" check, which the core answers by composing
+// `toSyncPathKey` with the unchanged `isUnderOrEqual`.
+//
+// The run stays attached to the process until it completes: backgrounding and
+// polling belong to the caller (SYNC-005), so there is no daemon, poller, or
+// watchdog here.
+import { readFile, stat } from 'node:fs/promises';
+import { resolve, sep } from 'node:path';
+import { SemanticChunker } from '../chunker/index.js';
+import { formatSyncError, runSync as runSyncCore, } from '../features/sync.js';
+import { computeContentHash } from '../ingest/compute.js';
+import { DocumentParser } from '../parser/index.js';
+import { MAX_SCAN_DEPTH } from '../utils/limits.js';
+import { bfsCollectSupportedFiles, canonicalizeRequestedPath, classifyRequestedPath, } from '../utils/scan.js';
+import { createEmbedder, createVectorStore, formatCliError } from './common.js';
+import { ingestSingleFile, resolveConfig } from './ingest.js';
+import { consumeBaseDirArg, resolveGlobalConfig } from './options.js';
+// ============================================
+// Help
+// ============================================
+const HELP_TEXT = `Usage: mcp-local-rag [global-options] sync [options] [path]
+
+Reconcile the index with the files on disk: ingest new and changed files, leave
+unchanged files alone, and remove index entries for files that are gone.
+
+Runs in the foreground until it finishes. Use your shell to run it in the
+background.
+
+Arguments:
+  <path>                 File or directory inside a configured base directory
+                         (default: every configured base directory)
+
+Options:
+  --base-dir <path>      Document root (repeatable; overrides environment roots)
+  --images               Store images for new/changed PDF and DOCX files
+  -h, --help             Show this help
+
+Without --base-dir, roots come from BASE_DIRS / BASE_DIR (default: current directory).
+
+Global options (must appear before "sync"):
+  --db-path <path>       LanceDB database path
+  --cache-dir <path>     Model cache directory
+  --model-name <name>    Embedding model`;
+/**
+ * Parse sync-specific CLI arguments: repeatable roots, at most one positional
+ * path, and -h/--help. Unknown flags still print the usage and exit 1.
+ */
+function parseArgs(args) {
+    let help = false;
+    const baseDirs = [];
+    let path;
+    let images = false;
+    let index = 0;
+    while (index < args.length) {
+        const arg = args[index];
+        switch (arg) {
+            case '-h':
+            case '--help':
+                help = true;
+                index++;
+                break;
+            case '--base-dir': {
+                const valueIndex = consumeBaseDirArg(args, index, baseDirs);
+                index = valueIndex + 1;
+                break;
+            }
+            case '--images':
+                images = true;
+                index++;
+                break;
+            default:
+                if (arg.startsWith('-')) {
+                    console.error(`Unknown option: ${arg}`);
+                    console.error(HELP_TEXT);
+                    process.exit(1);
+                }
+                if (path !== undefined) {
+                    console.error(`Unexpected argument: ${arg}`);
+                    console.error('Only one path is accepted. Omit it to sync every configured base directory.');
+                    process.exit(1);
+                }
+                path = arg;
+                index++;
+                break;
+        }
+    }
+    const parsed = { help, baseDirs, images };
+    if (path !== undefined)
+        parsed.path = path;
+    return parsed;
+}
+// ============================================
+// Reporting
+// ============================================
+/**
+ * Render the scanner's coverage facts as operator warnings. Each unobserved
+ * region is why prune was withheld there, so the path is named; the wording
+ * itself is not a contract.
+ */
+function coverageWarnings(coverage, maxFileSize) {
+    return [
+        ...coverage.unreadableDirs.map(({ dirPath, code }) => `Warning: cannot read directory (${code}), so its indexed files were kept: ${dirPath}`),
+        ...coverage.depthLimitedDirs.map((dirPath) => `Warning: not scanned because it exceeds the maximum depth (${MAX_SCAN_DEPTH}), so its indexed files were kept: ${dirPath}`),
+        ...coverage.skippedSymlinks.map((linkPath) => `Warning: symbolic link not followed, so its indexed files were kept: ${linkPath}`),
+        ...coverage.oversizedFiles.map((filePath) => `Warning: not read because it exceeds the maximum file size (${maxFileSize} bytes), so its indexed chunks were kept: ${filePath}`),
+    ];
+}
+// ============================================
+// Main Entry Point
+// ============================================
+/**
+ * Run the sync CLI subcommand.
+ * @param args - Arguments after "sync"
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export async function runSync(args, globalOptions = {}) {
+    const parsed = parseArgs(args);
+    if (parsed.help) {
+        console.error(HELP_TEXT);
+        process.exit(0);
+    }
+    const globalConfig = resolveGlobalConfig(globalOptions);
+    // Shared with `ingest`: CLI roots replace BASE_DIRS / BASE_DIR / cwd; an empty
+    // array preserves that environment fallback. Size/chunk settings share the
+    // same resolution and validation path.
+    const config = await resolveConfig(globalConfig, { baseDirs: parsed.baseDirs });
+    for (const warning of config.baseDirsWarnings) {
+        console.error(warning.message);
+    }
+    const excludePaths = [`${resolve(config.dbPath)}${sep}`, `${resolve(config.cacheDir)}${sep}`];
+    const vectorStore = createVectorStore(globalConfig);
+    // The parser's realpath check is the security boundary, so it takes the
+    // realpath'd roots; scanning uses the resolve()-only `rawBaseDirs` so scanned
+    // paths match the resolve()-stored DB keys (same split as `list`).
+    const parser = new DocumentParser({
+        baseDirs: config.baseDirs.baseDirs,
+        maxFileSize: config.maxFileSize,
+    });
+    const chunker = new SemanticChunker(config.chunkMinLength !== undefined ? { minChunkLength: config.chunkMinLength } : {});
+    // Built on the first upsert only: a run with nothing to ingest must not pay
+    // for the embedding model.
+    let embedder;
+    const ensureEmbedder = () => {
+        embedder ??= createEmbedder(globalConfig);
+        return embedder;
+    };
+    const collaborators = {
+        // The containment boundary for a requested path: the core compares this
+        // canonical form against the realpath'd roots, which is the only way to see
+        // that an intermediate component is a symbolic link out of the root.
+        canonicalizeRequestedPath,
+        // The walker's own predicates, so an explicitly requested path is subject to
+        // the same rules as a discovered one and is refused before it is read.
+        classifyPath: async (path) => await classifyRequestedPath(path, excludePaths),
+        // No `scope` argument, on purpose: a scope-pruned directory appears in none
+        // of the coverage arrays, which would hide an unobserved region and make
+        // prune unsafe.
+        scanDir: async (rootPath) => await bfsCollectSupportedFiles(rootPath, excludePaths, MAX_SCAN_DEPTH),
+        // Size first, bytes second: `MAX_FILE_SIZE` is otherwise enforced inside the
+        // parser, which runs long after the whole file would already be in memory
+        // here. Declining (`null`) keeps the rest of the run usable instead of
+        // aborting every future sync of the whole root on one oversized file.
+        //
+        // The bound holds only against a non-racing filesystem: a writer that grows
+        // the file, or replaces it with a FIFO, between the `stat` and the `readFile`
+        // restores the unbounded read or an indefinite block. That actor needs local
+        // write access as this same user and can already reach the database directly,
+        // so this is a recorded limitation rather than a defended boundary — as with
+        // the watchdog limitation noted on `requestedPathRejection`.
+        hashFile: async (filePath) => {
+            if ((await stat(filePath)).size > config.maxFileSize)
+                return null;
+            return computeContentHash(await readFile(filePath));
+        },
+        loadDbManifest: async () => await vectorStore.listChunkHashes(),
+        // Named as it happens, so a long run shows which file it is on and the
+        // counters alone are not the only record of what changed. A zero-chunk file
+        // already reports itself from inside `ingestSingleFile`.
+        ingestFile: async (filePath, images) => {
+            const ingestOptions = images
+                ? { visual: false, images: true }
+                : { visual: false, images: false };
+            const chunkCount = await ingestSingleFile(filePath, parser, chunker, ensureEmbedder(), vectorStore, ingestOptions);
+            if (chunkCount > 0)
+                console.error(`upserted ${filePath} (${chunkCount} chunks)`);
+            return chunkCount;
+        },
+        deleteExactPath: async (filePath) => await vectorStore.deleteChunks(filePath),
+        optimize: async () => {
+            await vectorStore.optimize();
+        },
+    };
+    try {
+        await vectorStore.initialize();
+        const result = await runSyncCore({
+            roots: config.baseDirs.rawBaseDirs,
+            // The realpath'd counterpart of the same roots, which is what the core
+            // decides requested-path containment in (the parser's boundary domain).
+            canonicalRoots: config.baseDirs.baseDirs,
+            dbPath: config.dbPath,
+            excludePaths,
+            platform: process.platform,
+            // resolve() (never realpath) so the requested path is spelled like the
+            // stored DB keys; the core validates it against the configured roots.
+            ...(parsed.path === undefined ? {} : { requestedPath: resolve(parsed.path) }),
+            ...(parsed.images ? { images: true } : {}),
+            collaborators,
+        });
+        for (const prunedPath of result.prunedPaths) {
+            console.error(`pruned ${prunedPath}`);
+        }
+        for (const warning of coverageWarnings(result.coverage, config.maxFileSize)) {
+            console.error(warning);
+        }
+        if (result.error !== null) {
+            console.error(`Error: ${formatSyncError(result.error)}`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(JSON.stringify({
+            upserted: result.upserted,
+            skipped: result.skipped,
+            empty: result.empty,
+            pruned: result.pruned,
+        }));
+    }
+    catch (error) {
+        console.error(`Error: ${formatCliError(error)}`);
+        process.exitCode = 1;
+    }
+    finally {
+        if (embedder !== undefined) {
+            await embedder.dispose();
+        }
+        await vectorStore.close();
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/sync.js.map

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

package/dist/cli-main.d.ts

@@ -0,0 +1,12 @@
+import type { GlobalOptions } from './cli/options.js';
+export declare const SUBCOMMANDS: readonly ['skills', 'ingest', 'list', 'query', 'status', 'delete', 'read-neighbors', 'sync'];
+export type Subcommand = (typeof SUBCOMMANDS)[number];
+/**
+ * Handle CLI subcommands. The caller is expected to have already validated
+ * `subcommand` against `SUBCOMMANDS`; the union type makes the switch exhaustive.
+ * @param subcommand - The validated subcommand name
+ * @param args - Arguments following the subcommand (subcommand itself excluded)
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export declare function handleCli(subcommand: Subcommand, args: string[], globalOptions?: GlobalOptions): Promise<void>;
+//# sourceMappingURL=cli-main.d.ts.map

package/dist/cli-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-main.d.ts","sourceRoot":"","sources":["../src/cli-main.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAMrD,eAAO,MAAM,WAAW,YACtB,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,MAAM,CACE,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,GAAE,aAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CA2Cf"}