@zvec/zvec-grep 0.1.0

package/dist/cli/format/highlight.js

@@ -0,0 +1,106 @@
+export function shouldUseColor(options) {
+    const mode = options.color ?? "auto";
+    if (mode === "always") {
+        return true;
+    }
+    if (mode === "never") {
+        return false;
+    }
+    return process.env.NO_COLOR === undefined && process.stdout.isTTY === true;
+}
+export function createHighlighter(query, enabled) {
+    if (!enabled) {
+        return (value) => value;
+    }
+    const terms = highlightTerms(query);
+    if (terms.length === 0) {
+        return (value) => value;
+    }
+    return (value) => highlightTermsInText(value, terms);
+}
+function highlightTerms(query) {
+    const ignored = new Set([
+        "a",
+        "an",
+        "and",
+        "are",
+        "as",
+        "by",
+        "class",
+        "enum",
+        "find",
+        "for",
+        "from",
+        "function",
+        "how",
+        "in",
+        "interface",
+        "is",
+        "method",
+        "of",
+        "on",
+        "or",
+        "struct",
+        "the",
+        "to",
+        "type",
+        "what",
+        "where",
+    ]);
+    const terms = new Set();
+    const trimmed = query.trim();
+    if (trimmed.length > 1) {
+        terms.add(trimmed);
+    }
+    for (const match of trimmed.matchAll(/[A-Za-z_~][A-Za-z0-9_~]*|[0-9]+(?:\.[0-9]+)?/g)) {
+        const term = match[0];
+        if (term.length >= 2 && !ignored.has(term.toLowerCase())) {
+            terms.add(term);
+        }
+    }
+    return [...terms].sort((left, right) => right.length - left.length);
+}
+function highlightTermsInText(value, terms) {
+    const ranges = [];
+    const lower = value.toLowerCase();
+    for (const term of terms) {
+        const lowerTerm = term.toLowerCase();
+        let offset = 0;
+        while (lowerTerm.length > 0) {
+            const start = lower.indexOf(lowerTerm, offset);
+            if (start < 0) {
+                break;
+            }
+            ranges.push({ start, end: start + lowerTerm.length });
+            offset = start + Math.max(lowerTerm.length, 1);
+        }
+    }
+    if (ranges.length === 0) {
+        return value;
+    }
+    const merged = mergeRanges(ranges);
+    let highlighted = "";
+    let cursor = 0;
+    for (const range of merged) {
+        highlighted += value.slice(cursor, range.start);
+        highlighted += `\x1b[1;33m${value.slice(range.start, range.end)}\x1b[0m`;
+        cursor = range.end;
+    }
+    return highlighted + value.slice(cursor);
+}
+function mergeRanges(ranges) {
+    const sorted = ranges
+        .filter((range) => range.end > range.start)
+        .sort((left, right) => left.start - right.start || right.end - left.end);
+    const merged = [];
+    for (const range of sorted) {
+        const previous = merged.at(-1);
+        if (!previous || range.start > previous.end) {
+            merged.push({ ...range });
+            continue;
+        }
+        previous.end = Math.max(previous.end, range.end);
+    }
+    return merged;
+}
+//# sourceMappingURL=highlight.js.map

package/dist/cli/format/highlight.js.map

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

package/dist/cli/format/progress.d.ts

@@ -0,0 +1,9 @@
+import type { IndexProgress } from "../../index.js";
+export type IndexProgressReporter = {
+    report(progress: IndexProgress): void;
+    finish(): void;
+};
+export type IndexProgressReporterOptions = {
+    nonTtyIntervalMs?: number;
+};
+export declare function createIndexProgressReporter(options?: IndexProgressReporterOptions): IndexProgressReporter;

package/dist/cli/format/progress.js

@@ -0,0 +1,92 @@
+const NON_TTY_PROGRESS_INTERVAL_MS = 15_000;
+export function createIndexProgressReporter(options = {}) {
+    const nonTtyIntervalMs = options.nonTtyIntervalMs ?? NON_TTY_PROGRESS_INTERVAL_MS;
+    let lastLineLength = 0;
+    let finished = false;
+    let currentNonTtyLine = "";
+    let lastNonTtyWriteTime = 0;
+    let heartbeat = null;
+    const writeLine = (line, force = false) => {
+        if (process.stderr.isTTY) {
+            lastLineLength = writeTtyProgressLine(line, lastLineLength);
+            return;
+        }
+        currentNonTtyLine = line;
+        startHeartbeat();
+        const now = Date.now();
+        if (force || lastNonTtyWriteTime === 0 || now - lastNonTtyWriteTime >= nonTtyIntervalMs) {
+            writeNonTtyProgressLine(line);
+            lastNonTtyWriteTime = now;
+        }
+    };
+    const startHeartbeat = () => {
+        if (heartbeat || nonTtyIntervalMs <= 0) {
+            return;
+        }
+        heartbeat = setInterval(() => {
+            if (finished || currentNonTtyLine.length === 0) {
+                return;
+            }
+            const now = Date.now();
+            if (now - lastNonTtyWriteTime >= nonTtyIntervalMs) {
+                writeNonTtyProgressLine(currentNonTtyLine);
+                lastNonTtyWriteTime = now;
+            }
+        }, nonTtyIntervalMs);
+        heartbeat.unref?.();
+    };
+    return {
+        report(progress) {
+            if (progress.phase === "scanning") {
+                if (progress.detail) {
+                    writeLine(progress.detail);
+                }
+                return;
+            }
+            if (progress.phase === "indexing") {
+                const indexed = progress.filesIndexed ?? 0;
+                const total = progress.filesTotal ?? 0;
+                const detail = progress.detail ? ` ${truncate(progress.detail, 100)}` : "";
+                const line = total > 0
+                    ? `Indexing files: ${indexed}/${total}${detail}`
+                    : `Indexing files...${detail}`;
+                writeLine(line);
+                return;
+            }
+            if (progress.phase === "done") {
+                const line = progress.detail ?? "Indexing complete";
+                writeLine(line, true);
+            }
+        },
+        finish() {
+            if (finished) {
+                return;
+            }
+            finished = true;
+            if (heartbeat) {
+                clearInterval(heartbeat);
+                heartbeat = null;
+            }
+            if (process.stderr.isTTY && lastLineLength > 0) {
+                process.stderr.write("\n");
+            }
+        },
+    };
+}
+function writeTtyProgressLine(line, previousLength) {
+    const padding = previousLength > line.length
+        ? " ".repeat(previousLength - line.length)
+        : "";
+    process.stderr.write(`\r${line}${padding}`);
+    return line.length;
+}
+function writeNonTtyProgressLine(line) {
+    process.stderr.write(`${line}\n`);
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxLength - 1))}...`;
+}
+//# sourceMappingURL=progress.js.map

package/dist/cli/format/progress.js.map

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

package/dist/cli/format/range.d.ts

@@ -0,0 +1,3 @@
+import type { Range } from "../../engine/types.js";
+export declare function rangeLabel(range: Range): string;
+export declare function rangeStartLine(range: Range): number;

package/dist/cli/format/range.js

@@ -0,0 +1,24 @@
+export function rangeLabel(range) {
+    if (range.kind === "text") {
+        return range.startLine === range.endLine
+            ? String(range.startLine)
+            : `${range.startLine}-${range.endLine}`;
+    }
+    if (range.kind === "byte") {
+        return `bytes:${range.startOffset}-${range.endOffset}`;
+    }
+    if (range.kind === "page") {
+        return `page:${range.page}`;
+    }
+    if (range.kind === "page_text") {
+        return `page:${range.page}`;
+    }
+    if (range.kind === "page_region") {
+        return `page:${range.page}`;
+    }
+    return "file";
+}
+export function rangeStartLine(range) {
+    return range.kind === "text" ? range.startLine : 0;
+}
+//# sourceMappingURL=range.js.map

package/dist/cli/format/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../../src/cli/format/range.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,OAAO;YACtC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;YACzB,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,SAAS,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACjC,OAAO,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,KAAY;IACzC,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { CollectionIndexStatus, CollectionInfo, IndexResult, ZvecGrepInfoResult } from "../../index.js";
+import type { CliOptions } from "../types.js";
+export declare function printCollectionList(collections: readonly CollectionInfo[], options: CliOptions): void;
+export declare function printCollectionInfo(info: CollectionInfo, status: CollectionIndexStatus | null, options: CliOptions): void;
+export declare function printAnonymousInfo(info: ZvecGrepInfoResult, options: CliOptions): void;
+export declare function printIndexResult(label: string, result: IndexResult, options: CliOptions, rootPaths?: CollectionInfo["rootPaths"]): void;
+export declare function printCollectionRemoveResult(name: string, removed: boolean, options: CliOptions): void;

package/dist/cli/format/status.js

@@ -0,0 +1,200 @@
+import { shouldUseColor } from "./highlight.js";
+export function printCollectionList(collections, options) {
+    const theme = createStatusTheme(options);
+    for (const collection of collections) {
+        const roots = collection.rootPaths.map(formatRootPath).join(", ");
+        console.log(`${theme.accent(collection.name)}\t${theme.path(roots)}`);
+    }
+}
+export function printCollectionInfo(info, status, options) {
+    const theme = createStatusTheme(options);
+    printField(theme, "name", theme.accent(info.name));
+    printField(theme, "id", info.id);
+    printField(theme, "path", theme.path(info.path));
+    printField(theme, "embedding", `${info.embedding.provider}/${info.embedding.model}`);
+    printField(theme, "roots", theme.path(info.rootPaths.map(formatRootPath).join(", ")));
+    if (status) {
+        printIndexStatus(theme, status);
+        if (statusNeedsRefresh(status)) {
+            printField(theme, "suggestion", theme.accent(`zg --collections index ${shellArg(info.name)}`));
+        }
+        printFailedFilesNote(theme, status, `zg --collections index ${shellArg(info.name)}`);
+    }
+}
+export function printAnonymousInfo(info, options) {
+    const theme = createStatusTheme(options);
+    printField(theme, "root", theme.path(info.root));
+    printField(theme, "initialized", info.initialized ? theme.success("yes") : theme.warning("no"));
+    printField(theme, "source", info.source === "index" ? theme.success(info.source) : theme.warning(info.source));
+    printField(theme, "home", theme.path(info.home));
+    printField(theme, "index", theme.path(info.indexPath));
+    if (info.collection) {
+        printField(theme, "embedding", `${info.collection.embedding.provider}/${info.collection.embedding.model}`);
+        printField(theme, "dimension", String(info.collection.embedding.dimension));
+        printField(theme, "metric", info.collection.embedding.metric);
+        printField(theme, "roots", theme.path(info.collection.rootPaths.map(formatRootPath).join(", ")));
+    }
+    if (info.status) {
+        printIndexStatus(theme, info.status);
+    }
+    const suggestion = info.status && statusNeedsRefresh(info.status)
+        ? "zg --init"
+        : info.suggestion;
+    if (suggestion) {
+        printField(theme, "suggestion", theme.accent(suggestion));
+    }
+    if (info.status) {
+        printFailedFilesNote(theme, info.status, "zg --init");
+    }
+}
+export function printIndexResult(label, result, options, rootPaths) {
+    const theme = createStatusTheme(options);
+    console.log(theme.accent(label));
+    printField(theme, "files", `${result.filesScanned} scanned, `
+        + `${theme.success(String(result.filesAdded))} added, `
+        + `${theme.warning(String(result.filesModified))} modified, `
+        + `${theme.warning(String(result.filesPending))} retried, `
+        + `${theme.muted(String(result.filesUnchanged))} unchanged, `
+        + `${theme.muted(String(result.filesDeleted))} deleted, `
+        + failedCount(theme, result.filesFailed));
+    printField(theme, "entities", String(result.entitiesCreated));
+    printField(theme, "duration", `${formatDuration(result.durationMs)} ${theme.muted(`(${result.durationMs}ms)`)}`);
+    if (rootPaths && rootPaths.length > 0) {
+        printField(theme, "roots", theme.path(rootPaths.map(formatRootPath).join(", ")));
+    }
+    printQueryFilters(theme, options);
+}
+export function printCollectionRemoveResult(name, removed, options) {
+    const theme = createStatusTheme(options);
+    console.log(removed
+        ? `${theme.success("Removed")} collection ${theme.accent(name)}`
+        : `${theme.warning("Collection not found")}: ${theme.accent(name)}`);
+}
+function printIndexStatus(theme, status) {
+    printField(theme, "files", `${status.filesIndexed}/${status.filesScanned} indexed`);
+    printField(theme, "fresh", statusNeedsRefresh(status)
+        ? theme.warning("no")
+        : theme.success("yes"));
+    printField(theme, "changed", changedCount(theme, status));
+    printField(theme, "pending", status.filesPending > 0
+        ? theme.warning(String(status.filesPending))
+        : theme.success(String(status.filesPending)));
+    printField(theme, "failed", failedCount(theme, status.filesFailed));
+}
+function statusNeedsRefresh(status) {
+    return status.filesAdded > 0
+        || status.filesModified > 0
+        || status.filesDeleted > 0
+        || status.filesPending > 0
+        || status.filesFailed > 0;
+}
+function printFailedFilesNote(theme, status, retryCommand) {
+    if (status.filesFailed === 0) {
+        return;
+    }
+    printField(theme, "note", theme.warning(`retry ${retryCommand}; if failures persist, fix failed files or embedding configuration`));
+    const reasons = summarizeFailedFileReasons(status.failedFiles, retryCommand);
+    if (reasons) {
+        printField(theme, "failed_reasons", theme.danger(reasons));
+    }
+}
+function summarizeFailedFileReasons(files, retryCommand) {
+    const withReasons = files.filter((file) => file.indexStatus?.error);
+    if (withReasons.length === 0) {
+        return undefined;
+    }
+    const shown = withReasons.slice(0, 3).map((file) => `${file.relativePath}: ${clipReason(explainStoredFailureReason(file.indexStatus.error, retryCommand))}`);
+    const remaining = withReasons.length - shown.length;
+    return remaining > 0
+        ? `${shown.join("; ")}; and ${remaining} more`
+        : shown.join("; ");
+}
+function explainStoredFailureReason(reason, retryCommand) {
+    const legacy = /ZVEC_GREP\.ENGINE\.INDEXING\.FILE_FAILED: Indexing file failed \(.*\bstage=([^) ]+)/.exec(reason);
+    if (!legacy) {
+        return reason;
+    }
+    return `${legacy[1]} failed; this stored failure was recorded without the underlying cause, rerun ${retryCommand} to refresh the detailed error`;
+}
+function clipReason(reason) {
+    const compact = reason.replace(/\s+/g, " ").trim();
+    const maxLength = 240;
+    return compact.length > maxLength
+        ? `${compact.slice(0, maxLength - 3)}...`
+        : compact;
+}
+function changedCount(theme, status) {
+    const count = status.filesAdded + status.filesModified + status.filesDeleted;
+    const value = `${status.filesAdded} added, ${status.filesModified} modified, ${status.filesDeleted} deleted`;
+    return count > 0 ? theme.warning(value) : theme.success(value);
+}
+function printQueryFilters(theme, options) {
+    if (options.modifiedAfter !== undefined) {
+        printField(theme, "modified_after", formatTimeFilter(options.modifiedAfter));
+    }
+    if (options.modifiedBefore !== undefined) {
+        printField(theme, "modified_before", formatTimeFilter(options.modifiedBefore));
+    }
+}
+function printField(theme, label, value) {
+    console.log(`${theme.label(label)}\t${value}`);
+}
+function failedCount(theme, count) {
+    return count > 0 ? theme.danger(`${count} failed`) : theme.success(`${count} failed`);
+}
+function createStatusTheme(options) {
+    if (!shouldUseColor(options)) {
+        return {
+            label: identity,
+            path: identity,
+            success: identity,
+            warning: identity,
+            danger: identity,
+            accent: identity,
+            muted: identity,
+        };
+    }
+    return {
+        label: (value) => `\x1b[2m${value}\x1b[0m`,
+        path: (value) => `\x1b[36m${value}\x1b[0m`,
+        success: (value) => `\x1b[32m${value}\x1b[0m`,
+        warning: (value) => `\x1b[33m${value}\x1b[0m`,
+        danger: (value) => `\x1b[31m${value}\x1b[0m`,
+        accent: (value) => `\x1b[1m${value}\x1b[0m`,
+        muted: (value) => `\x1b[2m${value}\x1b[0m`,
+    };
+}
+function formatRootPath(root) {
+    const filters = [
+        root.include && root.include.length > 0 ? `include=${root.include.join("|")}` : undefined,
+        root.exclude && root.exclude.length > 0 ? `exclude=${root.exclude.join("|")}` : undefined,
+    ].filter((part) => part !== undefined);
+    return filters.length > 0
+        ? `${root.absolutePath} (${filters.join(" ")})`
+        : root.absolutePath;
+}
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const totalSeconds = Math.round(ms / 1000);
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes === 0) {
+        return `${seconds}s`;
+    }
+    return `${minutes}m ${seconds}s`;
+}
+function formatTimeFilter(value) {
+    return `${new Date(value).toISOString()} (${value})`;
+}
+function identity(value) {
+    return value;
+}
+function shellArg(value) {
+    if (/^[A-Za-z0-9_./:=@+-]+$/.test(value)) {
+        return value;
+    }
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/format/status.js.map

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

package/dist/cli/help.d.ts

@@ -0,0 +1 @@
+export declare function printHelp(version: string): void;

package/dist/cli/help.js

@@ -0,0 +1,88 @@
+export function printHelp(version) {
+    console.log(`zvec-grep ${version}
+
+Usage:
+  zg [options] <query...>
+  zg "multi word query" "another query"
+  zg --rg "Symbol|LogMessage"
+  zg --rg -F "ExactSymbolOrText" src
+  zg <query...> --fts <query...> --vector <query...>
+  zg --fts <query...>
+  zg --human [options] <query...>
+  zg --init --embedding <model> [root]
+  zg --init --embedding <model> --include "src/**" --exclude "dist/**,node_modules/**" [root]
+  zg --init --embedding local/embeddinggemma-300m [root]
+  zg --info [root]
+  zg --collection <name> [options] <query...>
+  zg --collections
+  zg --collections info <name>
+  zg --collections index <name> [root]
+  zg --collections remove <name>
+
+Output:
+  default                         Agent markdown grouped by file
+  --human                         Human-readable ranked output
+  --preview <none|short|full>     Indexed result preview size (default none; --human default full)
+  default --rg output             path:range plus numbered lines; no source label
+                                  context blocks include matched:<line>
+
+Query:
+  Each shell argument is one hybrid query. Quote multi-word queries.
+  Without --limit, 1-3 query groups return up to 10 each; more groups share about 30.
+  Default indexed queries require an initialized anonymous index. Run zg --init first.
+  Existing anonymous indexes are checked and incrementally refreshed before query.
+  Init skips dependency/build/cache dirs, .gitignore entries, and files over 1 MB by default.
+  New indexes require --embedding <model> or ZVEC_GREP_EMBEDDING; existing indexes reuse stored schema.
+  --rg is explicit exhaustive ripgrep search and works without an index.
+  Without --limit, --rg returns every match.
+  --rg uses rg regex syntax by default. Use -F/--fixed-strings for literal text.
+  Use -e/--regexp when the pattern begins with "-".
+  --rg accepts common agent rg flags: -n, -H, -F, -i, -w, -A/-B/-C,
+  -e/--regexp, -g/--glob, --hidden, -t/--type, -T/--type-not,
+  --max-depth, --ignore-file, --no-ignore, --smart-case, and --pcre2.
+
+Options:
+  --debug                         Print diagnostics to stderr
+  --trace                         Print inline per-hit search trace
+  --info                          Show anonymous index status for this root
+  --color <auto|always|never>     Colorize human/status output (default auto)
+  --no-color                      Disable color output
+  --limit <n>                     Maximum returned items per query/group
+  --preview <none|short|full>     Control indexed source preview; not used with --rg
+  --rg                            Managed ripgrep search with zvec-grep output
+  --fts <query...>                Add exact/lexical search routes
+  --vector <query...>             Add semantic/vector search routes
+  --no-auto-update                Do not refresh an existing stale anonymous index before query
+  --no-fallback                   Compatibility flag; anonymous queries already require an index
+  --collection <name>             Query a named collection
+  --collections                   Manage named collections
+  --home <path>                   Named collection registry home
+  --embedding <model>             Embedding model, e.g. local/embeddinggemma-300m or qwen/text-embedding-v4
+  --model-cache <path>            Local model cache directory
+  --gpu                           Try GPU acceleration; falls back to CPU if unavailable
+  --no-gpu                        Force CPU local embeddings
+  --llama-gpu <mode>              CPU by default; auto, metal, vulkan, cuda, off
+  --embedding-parallelism <n>     Local embedding context parallelism
+  --api-key <key>                 Embedding provider API key
+  --endpoint <url>                Embedding provider endpoint
+  --include <glob>                Include indexed/query paths
+  --exclude <glob>                Exclude indexed/query paths
+  --modified-after <time>         Query files modified after time
+  --modified-before <time>        Query files modified before time
+  --symbol-type <type>            module, class, interface, function, value, alias
+  --prefer-symbol                 Prefer exact indexed symbols
+  --rebuild                       Rebuild on init/index
+  --reset-paths                   Clear inherited include/exclude filters on rebuild
+
+Environment:
+  ZVEC_GREP_HOME
+  ZVEC_GREP_EMBEDDING
+  ZVEC_GREP_MODEL_CACHE
+  ZVEC_GREP_LLAMA_GPU
+  ZVEC_GREP_EMBED_PARALLELISM
+  ZVEC_GREP_API_KEY
+  ZVEC_GREP_ENDPOINT
+  NO_COLOR
+`);
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFjC,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { parseArgs } from "./args.js";
+import { runParsedCommand } from "./commands.js";
+import { colorModeFromArgs, printError } from "./errors.js";
+import { printHelp } from "./help.js";
+import { readPackageVersion } from "./version.js";
+const PACKAGE_VERSION = readPackageVersion();
+void main();
+async function main() {
+    const args = process.argv.slice(2);
+    const errorColor = colorModeFromArgs(args);
+    try {
+        const parsed = parseArgs(args);
+        if (parsed.options.version) {
+            console.log(PACKAGE_VERSION);
+            process.exitCode = 0;
+            return;
+        }
+        if (parsed.options.help || args.length === 0) {
+            printHelp(PACKAGE_VERSION);
+            process.exitCode = args.length === 0 ? 1 : 0;
+            return;
+        }
+        await runParsedCommand(parsed);
+        process.exitCode = 0;
+    }
+    catch (error) {
+        printError(error, { color: errorColor });
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;AAG7C,KAAK,IAAI,EAAE,CAAC;AAGZ,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,SAAS,CAAC,eAAe,CAAC,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}