@ssmeo/mcp-local-rag 0.18.6

package/dist/cli/list.d.ts

@@ -0,0 +1,27 @@
+import type { GlobalOptions } from './options.js';
+interface ListCliOptions {
+    /**
+     * Collected `--base-dir` values in CLI order. Repeatable: each flag
+     * occurrence appends one entry. `undefined` means the flag was not
+     * provided.
+     */
+    baseDirs?: string[] | undefined;
+    /**
+     * Repeatable `--scope` prefixes in CLI order; multiple flags union.
+     * `undefined` means no scope. Trailing-separator equivalence is
+     * `scope-match.ts`'s job.
+     */
+    scope?: string[] | undefined;
+}
+interface ParsedArgs {
+    options: ListCliOptions;
+    help: boolean;
+}
+/** No positional arguments; an unknown flag exits 1. */
+export declare function parseArgs(args: string[]): ParsedArgs;
+/**
+ * Run the list CLI subcommand.
+ */
+export declare function runList(args: string[], globalOptions?: GlobalOptions): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/cli/list.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AA+DjD,UAAU,cAAc;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CAC7B;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,OAAO,CAAA;CACd;AAwDD,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsDpD;AAMD;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG9F"}

package/dist/cli/list.js

@@ -0,0 +1,207 @@
+// CLI list subcommand — list files and ingestion status
+import { resolve, sep } from 'node:path';
+import { listDocuments } from '../features/list.js';
+import { displayPath } from '../utils/base-dirs.js';
+import { MAX_SCAN_DEPTH } from '../utils/limits.js';
+import { bfsCollectSupportedFiles } from '../utils/scan.js';
+import { nonAbsolutePrefixes } from '../utils/scope-match.js';
+import { createVectorStore, formatCliError, resolveCliBaseDirsOrExit } from './common.js';
+import { consumeBaseDirArg, requireFlagValue, resolveGlobalConfig, validatePath, } from './options.js';
+// ============================================
+// Helpers
+// ============================================
+/** Lexicographic order, independent of locale. */
+function compareStrings(a, b) {
+    if (a < b) {
+        return -1;
+    }
+    return a > b ? 1 : 0;
+}
+/**
+ * Delegates traversal to {@link bfsCollectSupportedFiles} and renders the
+ * `list`-specific warnings, annotated with `displayPath`.
+ */
+async function scanRoot(root, excludePaths, scope) {
+    const { files, unreadableDirs, depthLimited } = await bfsCollectSupportedFiles(root, excludePaths, {
+        scope,
+    });
+    const warnings = [];
+    for (const { dirPath, code } of unreadableDirs) {
+        warnings.push(`cannot read directory: ${displayPath(dirPath)} (${code})`);
+    }
+    if (depthLimited) {
+        warnings.push(`some directories under ${displayPath(root)} were skipped because they exceed the maximum depth (${MAX_SCAN_DEPTH})`);
+    }
+    return { files, warnings };
+}
+// ============================================
+// Help
+// ============================================
+const HELP_TEXT = `Usage: mcp-local-rag [global-options] list [options]
+
+List files and their ingestion status.
+
+Options:
+  --base-dir <path>      Base directory to scan for files (repeatable: pass once per root; default: BASE_DIRS/BASE_DIR env or cwd)
+  --scope <prefix>       Restrict results to a path prefix (must be absolute; a relative prefix matches nothing; repeatable for multiple prefixes)
+  -h, --help             Show this help
+
+Global options (must appear before "list"):
+  --db-path <path>       LanceDB database path
+  --cache-dir <path>     Model cache directory
+  --model-name <name>    Embedding model`;
+// ============================================
+// Arg Parsing
+// ============================================
+/** No positional arguments; an unknown flag exits 1. */
+export function parseArgs(args) {
+    const options = {};
+    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 '--base-dir': {
+                // Repeatable: each `--base-dir <path>` occurrence appends one entry
+                // to `options.baseDirs`. The accumulator is lazily initialized so an
+                // absent flag leaves `options.baseDirs` as `undefined`, which the
+                // resolver treats as "fall through to env / cwd".
+                if (options.baseDirs === undefined) {
+                    options.baseDirs = [];
+                }
+                const valueIndex = consumeBaseDirArg(args, i, options.baseDirs);
+                i = valueIndex + 1;
+                break;
+            }
+            case '--scope': {
+                // Repeatable prefix filter (mirrors `query --scope`). Trim and reject
+                // empty/whitespace locally — the same non-empty check `normalizeScope`
+                // applies at the MCP boundary, kept module-private there. Trailing-
+                // separator equivalence is handled downstream in `scope-match.ts`.
+                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);
+                }
+                console.error(`Unexpected argument: ${arg}`);
+                console.error('The list command does not accept positional arguments.');
+                process.exit(1);
+        }
+    }
+    return { options, help };
+}
+// ============================================
+// Main Entry Point
+// ============================================
+/**
+ * Run the list CLI subcommand.
+ */
+export async function runList(args, globalOptions = {}) {
+    // Parse CLI options
+    const { options, help } = parseArgs(args);
+    // Handle --help
+    if (help) {
+        console.error(HELP_TEXT);
+        process.exit(0);
+    }
+    // Resolve global config
+    const globalConfig = resolveGlobalConfig(globalOptions);
+    // Validate CLI-supplied paths against the sensitive-path policy BEFORE
+    // calling the resolver, so the user sees a `--base-dir`-attributed error
+    // without an unnecessary realpath round-trip on a rejected path.
+    const cliBaseDirs = options.baseDirs ?? [];
+    for (const root of cliBaseDirs) {
+        const baseDirError = validatePath(root, '--base-dir');
+        if (baseDirError) {
+            console.error(baseDirError);
+            process.exit(1);
+        }
+    }
+    // Resolver errors exit non-zero and do NOT fall back. Warnings go to stderr,
+    // so the JSON-only stdout contract survives.
+    const { config: baseDirsConfig, warnings: baseDirsWarnings } = await resolveCliBaseDirsOrExit(cliBaseDirs);
+    for (const warning of baseDirsWarnings) {
+        console.error(warning.message);
+    }
+    // A non-absolute `--scope` prefix matches nothing (scan matching is
+    // absolute-path based) but silently yields an empty result for that prefix.
+    // Surface it as a non-fatal stderr warning without changing result semantics
+    // or the exit code — relative is unhelpful, not an error.
+    if (options.scope) {
+        for (const prefix of nonAbsolutePrefixes(options.scope)) {
+            console.error(`Warning [scope]: "${prefix}" is not an absolute path; it matches nothing.`);
+        }
+    }
+    // Scan/display the normal-path roots (`rawBaseDirs`) so scanned paths match
+    // the resolve()-stored DB keys; the realpath'd `baseDirs` are the security
+    // boundary, not used here. `rawBaseDirs[0]` is the legacy `baseDir` field.
+    const rawBaseDirs = baseDirsConfig.rawBaseDirs;
+    const firstRawBaseDir = rawBaseDirs[0];
+    if (firstRawBaseDir === undefined) {
+        // Cannot happen in non-degraded mode: the resolver always returns at least
+        // one effective root. Surface as a programming error rather than emitting
+        // an empty `baseDir` field.
+        throw new Error('internal: resolver returned no effective base directories');
+    }
+    const baseDir = firstRawBaseDir;
+    const vectorStore = createVectorStore(globalConfig);
+    try {
+        await vectorStore.initialize();
+        // Build exclude paths (resolved to absolute, platform-aware trailing
+        // separator). Applied uniformly to every root so dbPath/cacheDir remain
+        // excluded under each root even when they happen to live below one of
+        // them.
+        const excludePaths = [
+            `${resolve(globalConfig.dbPath)}${sep}`,
+            `${resolve(globalConfig.cacheDir)}${sep}`,
+        ];
+        const ingested = await vectorStore.listFiles();
+        const listed = await listDocuments({
+            roots: rawBaseDirs,
+            dbPath: globalConfig.dbPath,
+            ingested,
+            scope: options.scope,
+            scan: (root, scope) => scanRoot(root, excludePaths, scope),
+        });
+        for (const warning of listed.warnings) {
+            console.error(`Warning [${warning.baseDir}]: ${warning.message}`);
+        }
+        const files = listed.files;
+        files.sort((a, b) => compareStrings(a.filePath, b.filePath));
+        const sources = listed.sources;
+        const result = {
+            baseDirs: [...rawBaseDirs],
+            baseDir,
+            files,
+            sources,
+        };
+        // Output JSON to stdout
+        process.stdout.write(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        const message = formatCliError(error);
+        console.error(`Failed to list files: ${message}`);
+        process.exitCode = 1;
+    }
+    finally {
+        await vectorStore.close();
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/list.js.map

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

package/dist/cli/options.d.ts

@@ -0,0 +1,89 @@
+import { type QualityProfile } from '../utils/visual-profile.js';
+/**
+ * Delegates to `checkSensitivePath`, so the CLI and MCP entry points share one
+ * policy. Returns an error message, or `undefined` when 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 after a `--base-dir` and append it to `collected`, so the
+ * flag can repeat with its order preserved. Returns the value's index, or
+ * exits 1 when the value is missing.
+ *
+ * Shared because `ingest`, `list` and `sync` must stay in lockstep here.
+ */
+export declare function consumeBaseDirArg(argv: string[], flagIndex: number, collected: string[]): number;
+/**
+ * Read the required value after a value-taking flag, exiting 1 when the next
+ * token is absent or is itself a flag. The caller advances by 2. Numeric flags
+ * validate the returned string themselves.
+ */
+export declare function requireFlagValue(argv: string[], flagIndex: number, flag: string): string;
+/**
+ * Read the `--visual-quality` value, exiting 1 when it is missing or outside
+ * the profile vocabulary. Shared by `ingest` and `sync` so both subcommands
+ * accept and reject exactly the same values with the same message.
+ */
+export declare function requireVisualQuality(argv: string[], flagIndex: number): QualityProfile;
+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, which are recognized only BEFORE the subcommand.
+ * Everything after it 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, passed through with no allowlist like RAG_DEVICE. Unset
+ * resolves to `undefined`, NOT a default: that is the only signal separating
+ * "unset" from an explicit `RAG_DTYPE=fp32`, and it gates the failure-path
+ * error enrichment. The fp32 default lives in `Embedder.initialize()` alone.
+ */
+export declare function resolveDtype(value: string | undefined): string | undefined;
+/**
+ * Resolve RAG_EMBEDDING_SERVER_URL. Unset or whitespace-only resolves to
+ * `undefined`, which keeps the local Transformers.js pipeline selected.
+ */
+export declare function resolveEmbeddingServerUrl(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":"AAIA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAMlF;;;GAGG;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;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAShG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAStF;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;;;GAGG;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,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK1E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvF"}

package/dist/cli/options.js

@@ -0,0 +1,244 @@
+// 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';
+import { isQualityProfile } from '../utils/visual-profile.js';
+// ============================================
+// Validation Helpers
+// ============================================
+/**
+ * Delegates to `checkSensitivePath`, so the CLI and MCP entry points share one
+ * policy. Returns an error message, or `undefined` when 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 after a `--base-dir` and append it to `collected`, so the
+ * flag can repeat with its order preserved. Returns the value's index, or
+ * exits 1 when the value is missing.
+ *
+ * Shared because `ingest`, `list` and `sync` must stay in lockstep here.
+ */
+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 after a value-taking flag, exiting 1 when the next
+ * token is absent or is itself a flag. The caller advances by 2. Numeric flags
+ * validate the returned string themselves.
+ */
+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;
+}
+/**
+ * Read the `--visual-quality` value, exiting 1 when it is missing or outside
+ * the profile vocabulary. Shared by `ingest` and `sync` so both subcommands
+ * accept and reject exactly the same values with the same message.
+ */
+export function requireVisualQuality(argv, flagIndex) {
+    const value = requireFlagValue(argv, flagIndex, '--visual-quality');
+    if (!isQualityProfile(value)) {
+        console.error(`Invalid value for --visual-quality: "${value.slice(0, 100)}". Expected "fast" or "quality".`);
+        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, which are recognized only BEFORE the subcommand.
+ * Everything after it 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, passed through with no allowlist like RAG_DEVICE. Unset
+ * resolves to `undefined`, NOT a default: that is the only signal separating
+ * "unset" from an explicit `RAG_DTYPE=fp32`, and it gates the failure-path
+ * error enrichment. The fp32 default lives in `Embedder.initialize()` alone.
+ */
+export function resolveDtype(value) {
+    if (!value || value.trim() === '') {
+        return undefined;
+    }
+    return value.trim();
+}
+/**
+ * Resolve RAG_EMBEDDING_SERVER_URL. Unset or whitespace-only resolves to
+ * `undefined`, which keeps the local Transformers.js pipeline selected.
+ */
+export function resolveEmbeddingServerUrl(value) {
+    if (!value || value.trim() === '') {
+        return undefined;
+    }
+    return value.trim().replace(/\/+$/, '');
+}
+//# 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,17 @@
+import type { GlobalOptions } from './options.js';
+interface QueryCliOptions {
+    limit?: number | undefined;
+    scope?: string[] | undefined;
+}
+interface ParsedArgs {
+    queryText: string | undefined;
+    options: QueryCliOptions;
+    help: boolean;
+}
+export declare function parseArgs(args: string[]): ParsedArgs;
+/**
+ * Run the query CLI 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;AA2ED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAqCpD;AAuBD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F/F"}