abb-opencode-local-rag 0.1.0

package/dist/cli/options.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Validate that a path is not a sensitive system directory.
+ * Delegates to the shared `checkSensitivePath` helper so the CLI and the
+ * MCP server entry point share one policy implementation.
+ *
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export declare function validatePath(value: string, flagName: string): string | undefined;
+/**
+ * Validate model name against allowed pattern.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export declare function validateModelName(value: string): string | undefined;
+/**
+ * Validate max file size is within acceptable range.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export declare function validateMaxFileSize(value: number): string | undefined;
+/**
+ * Validate chunk minimum length is within acceptable range.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export declare function validateChunkMinLength(value: number): string | undefined;
+/**
+ * Consume the value that follows a `--base-dir` flag and append it to
+ * `collected`. Designed to be called from each subcommand's argv loop so
+ * `--base-dir <path>` can be provided one or more times, with the order
+ * preserved.
+ *
+ * `argv` is the full argv slice the loop is iterating; `flagIndex` is the
+ * index of the `--base-dir` token itself. On success returns the index of
+ * the value (so the caller can advance past it). On failure prints
+ * `Missing value for --base-dir` to stderr and calls `process.exit(1)` —
+ * matching the existing single-value error path so callers don't have to
+ * special-case the new shape.
+ *
+ * Why a shared helper: `ingest`, `list`, and `sync` parse `--base-dir` in
+ * identical fashion, so centralizing the accumulate-and-validate step keeps
+ * their argv loops in lockstep when the contract evolves.
+ */
+export declare function consumeBaseDirArg(argv: string[], flagIndex: number, collected: string[]): number;
+/**
+ * Read the required value that follows a value-taking flag at `argv[flagIndex]`.
+ * Centralizes the identical "missing value" guard every value flag used to
+ * inline (`--db-path`, `--cache-dir`, `--model-name`, `--max-file-size`,
+ * `--chunk-min-length`, `--limit`): when the next token is absent or is itself
+ * a flag, prints `Missing value for <flag>` and exits 1. The caller advances
+ * its index by 2 (flag + value). Numeric flags apply their own format/range
+ * validation to the returned string.
+ */
+export declare function requireFlagValue(argv: string[], flagIndex: number, flag: string): string;
+export interface GlobalOptions {
+    dbPath?: string | undefined;
+    cacheDir?: string | undefined;
+    modelName?: string | undefined;
+}
+export interface ParsedGlobalResult {
+    globalOptions: GlobalOptions;
+    remainingArgs: string[];
+}
+export interface ResolvedGlobalConfig {
+    dbPath: string;
+    cacheDir: string;
+    modelName: string;
+}
+export declare const GLOBAL_DEFAULTS: {
+    readonly dbPath: './lancedb/';
+    readonly cacheDir: './models/';
+    readonly modelName: 'Xenova/all-MiniLM-L6-v2';
+};
+export declare const ROOT_HELP_TEXT: string;
+/**
+ * Extract global options (--db-path, --cache-dir, --model-name, -h/--help)
+ * from the argument list and return them along with the remaining args.
+ *
+ * Global options are only recognized BEFORE the first non-flag argument
+ * (the subcommand). After the subcommand, everything is forwarded as-is.
+ */
+export declare function parseGlobalOptions(args: string[]): ParsedGlobalResult;
+/**
+ * Resolve global config with priority: CLI flags > environment variables > defaults.
+ * Validates all resolved values before returning.
+ */
+export declare function resolveGlobalConfig(options: GlobalOptions): ResolvedGlobalConfig;
+/**
+ * Resolve RAG_DEVICE. The value is passed through to transformers.js — no
+ * allowlist is maintained here. Whitespace-only is treated as unset.
+ */
+export declare function resolveDevice(value: string | undefined): string;
+/**
+ * Resolve RAG_DTYPE. Like resolveDevice, the value is passed through to
+ * transformers.js with no allowlist. Unlike resolveDevice, unset/whitespace-only
+ * resolves to `undefined` (NOT a default dtype): the fp32 default literal lives
+ * solely in Embedder.initialize(), and `undefined` is the only signal that
+ * distinguishes "RAG_DTYPE unset" from an explicit "RAG_DTYPE=fp32". That
+ * distinction gates failure-path error enrichment, so it must not be collapsed
+ * into a default here.
+ */
+export declare function resolveDtype(value: string | undefined): string | undefined;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKxE;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAShG;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxF;AAMD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAMD,eAAO,MAAM,eAAe;aAC1B,MAAM,EAAE,YAAY;aACpB,QAAQ,EAAE,WAAW;aACrB,SAAS,EAAE,yBAAyB;CAC5B,CAAA;AAMV,eAAO,MAAM,cAAc,QAgBiC,CAAA;AAM5D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAsDrE;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,oBAAoB,CA0BhF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG1E"}

package/dist/cli/options.js

@@ -0,0 +1,241 @@
+// Shared CLI global options — parsed before subcommand routing
+import { MAX_CHUNK_MIN_LENGTH, MAX_FILE_SIZE_LIMIT } from '../utils/limits.js';
+import { checkSensitivePath } from '../utils/sensitive-path.js';
+// ============================================
+// Validation Helpers
+// ============================================
+/**
+ * Validate that a path is not a sensitive system directory.
+ * Delegates to the shared `checkSensitivePath` helper so the CLI and the
+ * MCP server entry point share one policy implementation.
+ *
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export function validatePath(value, flagName) {
+    return checkSensitivePath(value, flagName);
+}
+/**
+ * Validate model name against allowed pattern.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export function validateModelName(value) {
+    const pattern = /^[a-zA-Z0-9_\-./]+$/;
+    if (!pattern.test(value)) {
+        return `Invalid model name: ${value}. Only alphanumeric, '_', '-', '.', '/' allowed.`;
+    }
+    if (value.includes('..')) {
+        return `Invalid model name: ${value}. Path traversal ('..') is not allowed.`;
+    }
+    return undefined;
+}
+/**
+ * Validate max file size is within acceptable range.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export function validateMaxFileSize(value) {
+    if (!Number.isFinite(value) || value < 1 || value > MAX_FILE_SIZE_LIMIT) {
+        return `--max-file-size must be between 1 and ${MAX_FILE_SIZE_LIMIT} (500MB)`;
+    }
+    return undefined;
+}
+/**
+ * Validate chunk minimum length is within acceptable range.
+ * Returns an error message if invalid, or undefined if valid.
+ */
+export function validateChunkMinLength(value) {
+    if (!Number.isFinite(value) || value < 1 || value > MAX_CHUNK_MIN_LENGTH) {
+        return `--chunk-min-length must be between 1 and ${MAX_CHUNK_MIN_LENGTH}`;
+    }
+    return undefined;
+}
+// ============================================
+// Repeatable --base-dir parsing
+// ============================================
+/**
+ * Consume the value that follows a `--base-dir` flag and append it to
+ * `collected`. Designed to be called from each subcommand's argv loop so
+ * `--base-dir <path>` can be provided one or more times, with the order
+ * preserved.
+ *
+ * `argv` is the full argv slice the loop is iterating; `flagIndex` is the
+ * index of the `--base-dir` token itself. On success returns the index of
+ * the value (so the caller can advance past it). On failure prints
+ * `Missing value for --base-dir` to stderr and calls `process.exit(1)` —
+ * matching the existing single-value error path so callers don't have to
+ * special-case the new shape.
+ *
+ * Why a shared helper: `ingest`, `list`, and `sync` parse `--base-dir` in
+ * identical fashion, so centralizing the accumulate-and-validate step keeps
+ * their argv loops in lockstep when the contract evolves.
+ */
+export function consumeBaseDirArg(argv, flagIndex, collected) {
+    const valueIndex = flagIndex + 1;
+    const value = argv[valueIndex];
+    if (value === undefined || value.startsWith('-')) {
+        console.error('Missing value for --base-dir');
+        process.exit(1);
+    }
+    collected.push(value);
+    return valueIndex;
+}
+/**
+ * Read the required value that follows a value-taking flag at `argv[flagIndex]`.
+ * Centralizes the identical "missing value" guard every value flag used to
+ * inline (`--db-path`, `--cache-dir`, `--model-name`, `--max-file-size`,
+ * `--chunk-min-length`, `--limit`): when the next token is absent or is itself
+ * a flag, prints `Missing value for <flag>` and exits 1. The caller advances
+ * its index by 2 (flag + value). Numeric flags apply their own format/range
+ * validation to the returned string.
+ */
+export function requireFlagValue(argv, flagIndex, flag) {
+    const value = argv[flagIndex + 1];
+    if (value === undefined || value.startsWith('-')) {
+        console.error(`Missing value for ${flag}`);
+        process.exit(1);
+    }
+    return value;
+}
+// ============================================
+// Defaults
+// ============================================
+export const GLOBAL_DEFAULTS = {
+    dbPath: './lancedb/',
+    cacheDir: './models/',
+    modelName: 'Xenova/all-MiniLM-L6-v2',
+};
+// ============================================
+// Help
+// ============================================
+export const ROOT_HELP_TEXT = `Usage: mcp-local-rag [options] <command>
+
+Options:
+  --db-path <path>       LanceDB database path (default: ${GLOBAL_DEFAULTS.dbPath})
+  --cache-dir <path>     Model cache directory (default: ${GLOBAL_DEFAULTS.cacheDir})
+  --model-name <name>    Embedding model (default: ${GLOBAL_DEFAULTS.modelName})
+  -h, --help             Show this help
+
+Commands:
+  ingest <path>          Ingest files into the vector database
+  sync [path]            Incrementally synchronize indexed files with disk
+  query <text>           Search ingested documents
+  read-neighbors         Read N chunks before and after a target chunk within the same document
+  list                   List files and ingestion status
+  status                 Show database status
+  delete <path>          Delete ingested content
+  skills install         Install Claude Code / Codex skills`;
+// ============================================
+// Global Option Parsing
+// ============================================
+/**
+ * Extract global options (--db-path, --cache-dir, --model-name, -h/--help)
+ * from the argument list and return them along with the remaining args.
+ *
+ * Global options are only recognized BEFORE the first non-flag argument
+ * (the subcommand). After the subcommand, everything is forwarded as-is.
+ */
+export function parseGlobalOptions(args) {
+    const globalOptions = {};
+    let help = false;
+    let i = 0;
+    // Parse global flags until we hit a non-flag (subcommand) or end of args
+    while (i < args.length) {
+        const arg = args[i];
+        switch (arg) {
+            case '-h':
+            case '--help':
+                help = true;
+                i++;
+                break;
+            case '--db-path': {
+                globalOptions.dbPath = requireFlagValue(args, i, '--db-path');
+                i += 2;
+                break;
+            }
+            case '--cache-dir': {
+                globalOptions.cacheDir = requireFlagValue(args, i, '--cache-dir');
+                i += 2;
+                break;
+            }
+            case '--model-name': {
+                globalOptions.modelName = requireFlagValue(args, i, '--model-name');
+                i += 2;
+                break;
+            }
+            default:
+                // If arg starts with -, it's an unknown global flag
+                if (arg.startsWith('-')) {
+                    console.error(`Unknown global option: ${arg}`);
+                    console.error('Run "mcp-local-rag --help" for available options.');
+                    process.exit(1);
+                }
+                // First non-global-flag token: treat as subcommand boundary.
+                // Everything from here onward is returned as remainingArgs.
+                if (help) {
+                    // If --help was seen before subcommand, show root help
+                    console.error(ROOT_HELP_TEXT);
+                    process.exit(0);
+                }
+                return { globalOptions, remainingArgs: args.slice(i) };
+        }
+    }
+    // All args consumed (no subcommand found)
+    if (help) {
+        console.error(ROOT_HELP_TEXT);
+        process.exit(0);
+    }
+    return { globalOptions, remainingArgs: [] };
+}
+// ============================================
+// Config Resolution
+// ============================================
+/**
+ * Resolve global config with priority: CLI flags > environment variables > defaults.
+ * Validates all resolved values before returning.
+ */
+export function resolveGlobalConfig(options) {
+    const dbPath = options.dbPath ?? process.env['DB_PATH'] ?? GLOBAL_DEFAULTS.dbPath;
+    const cacheDir = options.cacheDir ?? process.env['CACHE_DIR'] ?? GLOBAL_DEFAULTS.cacheDir;
+    const modelName = options.modelName ?? process.env['MODEL_NAME'] ?? GLOBAL_DEFAULTS.modelName;
+    // Validate paths
+    const dbPathError = validatePath(dbPath, '--db-path');
+    if (dbPathError) {
+        console.error(dbPathError);
+        process.exit(1);
+    }
+    const cacheDirError = validatePath(cacheDir, '--cache-dir');
+    if (cacheDirError) {
+        console.error(cacheDirError);
+        process.exit(1);
+    }
+    // Validate model name
+    const modelNameError = validateModelName(modelName);
+    if (modelNameError) {
+        console.error(modelNameError);
+        process.exit(1);
+    }
+    return { dbPath, cacheDir, modelName };
+}
+/**
+ * Resolve RAG_DEVICE. The value is passed through to transformers.js — no
+ * allowlist is maintained here. Whitespace-only is treated as unset.
+ */
+export function resolveDevice(value) {
+    if (!value || value.trim() === '')
+        return 'cpu';
+    return value.trim();
+}
+/**
+ * Resolve RAG_DTYPE. Like resolveDevice, the value is passed through to
+ * transformers.js with no allowlist. Unlike resolveDevice, unset/whitespace-only
+ * resolves to `undefined` (NOT a default dtype): the fp32 default literal lives
+ * solely in Embedder.initialize(), and `undefined` is the only signal that
+ * distinguishes "RAG_DTYPE unset" from an explicit "RAG_DTYPE=fp32". That
+ * distinction gates failure-path error enrichment, so it must not be collapsed
+ * into a default here.
+ */
+export function resolveDtype(value) {
+    if (!value || value.trim() === '')
+        return undefined;
+    return value.trim();
+}
+//# sourceMappingURL=options.js.map

package/dist/cli/options.js.map

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

package/dist/cli/query.d.ts

@@ -0,0 +1,24 @@
+import type { GlobalOptions } from './options.js';
+interface QueryCliOptions {
+    limit?: number | undefined;
+    scope?: string[] | undefined;
+}
+interface ParsedArgs {
+    queryText: string | undefined;
+    options: QueryCliOptions;
+    help: boolean;
+}
+/**
+ * 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.
+ */
+export declare function parseArgs(args: string[]): ParsedArgs;
+/**
+ * Run the query CLI subcommand.
+ * @param args - Arguments after "query" (e.g., option flags and query text)
+ * @param globalOptions - Global options parsed before the subcommand
+ */
+export declare function runQuery(args: string[], globalOptions?: GlobalOptions): Promise<void>;
+export {};
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/cli/query.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAOjD,UAAU,eAAe;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CAC7B;AAED,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,eAAe,CAAA;IACxB,IAAI,EAAE,OAAO,CAAA;CACd;AA8CD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsDpD;AAuBD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F/F"}

package/dist/cli/query.js

@@ -0,0 +1,191 @@
+// 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.
+ */
+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': {
+                const value = requireFlagValue(args, i, '--scope').trim();
+                if (value.length === 0) {
+                    console.error('--scope value must not be empty');
+                    process.exit(1);
+                }
+                const scope = options.scope ?? [];
+                scope.push(value);
+                options.scope = scope;
+                i += 2;
+                break;
+            }
+            default:
+                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);
+                }
+                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.
+ * @param args - Arguments after "query" (e.g., option flags and query text)
+ * @param globalOptions - Global options parsed before the 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,11 @@
+import type { GlobalOptions } from './options.js';
+/**
+ * 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 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;AAqIjD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,GAAE,aAAkB,GAChC,OAAO,CAAC,IAAI,CAAC,CAqGf"}