@ssmeo/mcp-local-rag 0.18.6

package/dist/cli/query.js

@@ -0,0 +1,194 @@
+// CLI query subcommand — search ingested documents
+import { MAX_QUERY_LIMIT, MIN_QUERY_LIMIT } from '../utils/limits.js';
+import { extractSourceFromPath, isManagedRawDataPath } from '../utils/raw-data-utils.js';
+import { createEmbedder, createVectorStore, formatCliError } from './common.js';
+import { requireFlagValue, resolveGlobalConfig } from './options.js';
+// ============================================
+// Defaults
+// ============================================
+const QUERY_DEFAULTS = {
+    limit: 10,
+};
+// ============================================
+// Help
+// ============================================
+const HELP_TEXT = `Usage: mcp-local-rag [global-options] query [options] <query-text>
+
+Search ingested documents using hybrid vector + keyword matching.
+
+Options:
+  --limit <n>            Max results (default: ${QUERY_DEFAULTS.limit}, range: ${MIN_QUERY_LIMIT}-${MAX_QUERY_LIMIT})
+  --scope <prefix>       Restrict results to a path prefix (repeatable for multiple prefixes)
+  -h, --help             Show this help
+
+Global options (must appear before "query"):
+  --db-path <path>       LanceDB database path
+  --cache-dir <path>     Model cache directory
+  --model-name <name>    Embedding model`;
+// ============================================
+// Arg Parsing
+// ============================================
+/**
+ * Parse query-specific CLI arguments into options and a positional query text.
+ * Flags: --limit, --scope (repeatable), -h/--help
+ * Unknown flags (including global flags passed after subcommand) cause an error.
+ */
+/** Reject an unknown flag, or a second positional query text. */
+function rejectUnexpectedArgument(arg, queryText) {
+    if (arg.startsWith('-')) {
+        console.error(`Unknown option: ${arg}`);
+        console.error(HELP_TEXT);
+        process.exit(1);
+    }
+    if (queryText !== undefined) {
+        console.error(`Unexpected argument: ${arg}`);
+        console.error('Only one query text argument is accepted.');
+        process.exit(1);
+    }
+}
+/** Read one repeatable `--scope` value, rejecting an empty one. */
+function requireScopeValue(args, flagIndex) {
+    const value = requireFlagValue(args, flagIndex, '--scope').trim();
+    if (value.length === 0) {
+        console.error('--scope value must not be empty');
+        process.exit(1);
+    }
+    return value;
+}
+export function parseArgs(args) {
+    const options = {};
+    let queryText;
+    let help = false;
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i] ?? '';
+        switch (arg) {
+            case '-h':
+            case '--help':
+                help = true;
+                i++;
+                break;
+            case '--limit': {
+                const value = requireFlagValue(args, i, '--limit');
+                if (!/^\d+$/.test(value)) {
+                    console.error(`--limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`);
+                    process.exit(1);
+                }
+                options.limit = Number.parseInt(value, 10);
+                i += 2;
+                break;
+            }
+            case '--scope':
+                options.scope = [...(options.scope ?? []), requireScopeValue(args, i)];
+                i += 2;
+                break;
+            default:
+                rejectUnexpectedArgument(arg, queryText);
+                queryText = arg;
+                i++;
+                break;
+        }
+    }
+    return { queryText, options, help };
+}
+// ============================================
+// Limit Validation
+// ============================================
+/**
+ * Validate and resolve the limit value.
+ * Returns the validated limit or exits with error.
+ */
+function resolveLimit(rawLimit) {
+    const limit = rawLimit ?? QUERY_DEFAULTS.limit;
+    if (!Number.isFinite(limit) || limit < MIN_QUERY_LIMIT || limit > MAX_QUERY_LIMIT) {
+        console.error(`--limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`);
+        process.exit(1);
+    }
+    return limit;
+}
+// ============================================
+// Main Entry Point
+// ============================================
+/**
+ * Run the query CLI subcommand.
+ */
+export async function runQuery(args, globalOptions = {}) {
+    // Parse CLI options
+    const { queryText, options, help } = parseArgs(args);
+    // Handle --help
+    if (help) {
+        console.error(HELP_TEXT);
+        process.exit(0);
+    }
+    // Validate positional argument
+    if (!queryText) {
+        console.error('Usage: mcp-local-rag query [options] <query-text>');
+        console.error('  Search ingested documents.');
+        console.error('  Run with --help for all options.');
+        process.exit(1);
+    }
+    // Validate limit
+    const limit = resolveLimit(options.limit);
+    // Resolve global config
+    const globalConfig = resolveGlobalConfig(globalOptions);
+    // Initialize components
+    const vectorStore = createVectorStore(globalConfig);
+    const embedder = createEmbedder(globalConfig);
+    await vectorStore.initialize();
+    try {
+        // Generate query embedding
+        const embeddings = await embedder.embedBatch([queryText]);
+        const queryVector = embeddings[0];
+        if (!queryVector) {
+            throw new Error('Failed to generate query embedding');
+        }
+        // Hybrid search (vector + BM25). Thread scope only when present so the
+        // scope-absent call shape stays identical to the pre-flag behavior.
+        const searchResults = await vectorStore.search(queryVector, {
+            queryText,
+            limit,
+            ...(options.scope ? { scope: options.scope } : {}),
+        });
+        let attachmentsByIdentity = new Map();
+        try {
+            const hydration = await vectorStore.hydrateVisualAttachments(searchResults);
+            attachmentsByIdentity = new Map(hydration.rows.map((row) => [row.id, row.attachments]));
+            if (hydration.omittedCount > 0) {
+                console.error(`Warning: omitted ${hydration.omittedCount} unavailable or malformed image attachment(s) from query results`);
+            }
+        }
+        catch {
+            console.error('Warning: image attachments could not be loaded; returning text results only');
+        }
+        // Format results with source restoration for raw-data files
+        const results = searchResults.map((result) => {
+            const output = {
+                filePath: result.filePath,
+                chunkIndex: result.chunkIndex,
+                text: result.text,
+                score: result.score,
+                fileTitle: result.fileTitle ?? null,
+                images: attachmentsByIdentity.get(result.id) ?? [],
+            };
+            if (isManagedRawDataPath(result.filePath, globalConfig.dbPath)) {
+                const source = extractSourceFromPath(result.filePath);
+                if (source) {
+                    output.source = source;
+                }
+            }
+            return output;
+        });
+        // Output JSON to stdout
+        process.stdout.write(JSON.stringify(results, null, 2));
+    }
+    catch (error) {
+        const reason = formatCliError(error);
+        console.error(`Error: ${reason}`);
+        process.exit(1);
+    }
+    finally {
+        await embedder.dispose();
+        await vectorStore.close();
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/cli/query.js.map

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

package/dist/cli/read-neighbors.d.ts

@@ -0,0 +1,3 @@
+import type { GlobalOptions } from './options.js';
+export declare function runReadNeighbors(args: string[], globalOptions?: GlobalOptions): Promise<void>;
+//# sourceMappingURL=read-neighbors.d.ts.map

package/dist/cli/read-neighbors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-neighbors.d.ts","sourceRoot":"","sources":["../../src/cli/read-neighbors.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AA0LjD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,GAAE,aAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/cli/read-neighbors.js

@@ -0,0 +1,192 @@
+// 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.
+ */
+/** Flags whose value is taken verbatim, mapped to the field they fill. */
+const STRING_FLAGS = new Map([
+    ['--file-path', 'filePath'],
+    ['--source', 'source'],
+]);
+/** Flags whose value must parse as a non-negative integer. */
+const INTEGER_FLAGS = new Map([
+    ['--chunk-index', 'chunkIndex'],
+    ['--before', 'before'],
+    ['--after', 'after'],
+]);
+/** Take a flag's value, rejecting an absent one or the next flag. */
+function requireValue(flag, rawValue) {
+    if (rawValue === undefined || rawValue.startsWith('-')) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    return rawValue;
+}
+function parseArgs(args) {
+    const result = { help: false };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i] ?? '';
+        if (arg === '-h' || arg === '--help') {
+            result.help = true;
+            i += 1;
+            continue;
+        }
+        const stringKey = STRING_FLAGS.get(arg);
+        if (stringKey !== undefined) {
+            result[stringKey] = requireValue(arg, args[i + 1]);
+            i += 2;
+            continue;
+        }
+        const integerKey = INTEGER_FLAGS.get(arg);
+        if (integerKey !== undefined) {
+            result[integerKey] = parseNonNegativeInteger(arg, args[i + 1]);
+            i += 2;
+            continue;
+        }
+        throw new Error(arg.startsWith('-') ? `Unknown option: ${arg}` : `Unexpected argument: ${arg}`);
+    }
+    return result;
+}
+/**
+ * Apply the same validation order as the MCP handler: chunkIndex, then the
+ * window bounds, then the file-path/source XOR.
+ */
+function validateRequest(parsed) {
+    if (parsed.chunkIndex === undefined) {
+        throw new Error('--chunk-index is required and must be a non-negative integer');
+    }
+    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})`);
+    }
+    if (parsed.filePath === undefined && parsed.source === undefined) {
+        throw new Error('Either --file-path or --source is required');
+    }
+    if (parsed.filePath !== undefined && parsed.source !== undefined) {
+        throw new Error('Cannot specify both --file-path and --source');
+    }
+    return { chunkIndex: parsed.chunkIndex, before, after };
+}
+/** Resolve the document to read from either input form. */
+function resolveTargetPath(parsed, dbPath) {
+    if (parsed.source !== undefined) {
+        return generateRawDataPath(dbPath, parsed.source);
+    }
+    // DB key is the resolve()'d ingest path, so look up by resolve() (never
+    // realpath); validate here (mirrors runDelete; realpath stays there).
+    const targetPath = resolve(parsed.filePath ?? '');
+    const pathError = validatePath(targetPath, '--file-path');
+    if (pathError) {
+        console.error(pathError);
+        process.exit(1);
+    }
+    return targetPath;
+}
+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 {
+        const request = validateRequest(parsed);
+        const globalConfig = resolveGlobalConfig(globalOptions);
+        const targetPath = resolveTargetPath(parsed, globalConfig.dbPath);
+        const vectorStore = createVectorStore(globalConfig);
+        try {
+            await vectorStore.initialize();
+            const rows = await vectorStore.getChunksByRange(targetPath, Math.max(0, request.chunkIndex - request.before), request.chunkIndex + request.after);
+            const sourceForAll = isManagedRawDataPath(targetPath, globalConfig.dbPath)
+                ? extractSourceFromPath(targetPath)
+                : null;
+            const items = rows.map((row) => ({
+                filePath: row.filePath,
+                chunkIndex: row.chunkIndex,
+                text: row.text,
+                isTarget: row.chunkIndex === request.chunkIndex,
+                fileTitle: row.fileTitle ?? null,
+                ...(sourceForAll ? { source: sourceForAll } : {}),
+            }));
+            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,0EAA0E;AAC1E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAgC;IAC1D,CAAC,aAAa,EAAE,UAAU,CAAC;IAC3B,CAAC,UAAU,EAAE,QAAQ,CAAC;CACvB,CAAC,CAAA;AAEF,8DAA8D;AAC9D,MAAM,aAAa,GAAG,IAAI,GAAG,CAA4C;IACvE,CAAC,eAAe,EAAE,YAAY,CAAC;IAC/B,CAAC,UAAU,EAAE,QAAQ,CAAC;IACtB,CAAC,SAAS,EAAE,OAAO,CAAC;CACrB,CAAC,CAAA;AAEF,qEAAqE;AACrE,SAAS,YAAY,CAAC,IAAY,EAAE,QAA4B;IAC9D,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,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,MAAM,GAAsB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAEjD,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAEzB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;YAClB,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAClD,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,UAAU,CAAC,GAAG,uBAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC9D,CAAC,IAAI,CAAC,CAAA;YACN,SAAQ;QACV,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;IACjG,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAkBD;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAyB;IAChD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAA;IAC9D,IAAI,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,kBAAkB,SAAS,MAAM,GAAG,CAAC,CAAA;IACvF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,uBAAuB,CAAC,KAAK,CAAA;IAC3D,IAAI,KAAK,GAAG,kBAAkB,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,+BAA+B,kBAAkB,SAAS,KAAK,GAAG,CAAC,CAAA;IACrF,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AACzD,CAAC;AAED,2DAA2D;AAC3D,SAAS,iBAAiB,CAAC,MAAyB,EAAE,MAAc;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC;IACD,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IACzD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,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,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;QACvC,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAA;QACvD,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;QAEjE,MAAM,WAAW,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;QACnD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,UAAU,EAAE,CAAA;YAE9B,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,gBAAgB,CAC7C,UAAU,EACV,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,EAChD,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CACnC,CAAA;YAED,MAAM,YAAY,GAAG,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC;gBACxE,CAAC,CAAC,qBAAqB,CAAC,UAAU,CAAC;gBACnC,CAAC,CAAC,IAAI,CAAA;YACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC/B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,GAAG,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;gBAC/C,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;gBAChC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD,CAAC,CAAC,CAAA;YAEH,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,6 @@
+import type { GlobalOptions } from './options.js';
+/**
+ * Run the status CLI 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;;GAEG;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,78 @@
+// 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.
+ */
+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;;GAEG;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,6 @@
+import type { GlobalOptions } from './options.js';
+/**
+ * Run the sync CLI 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;AAmKjD;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6I9F"}