@zvec/zvec-grep 0.1.0

package/dist/cli/commands.js

@@ -0,0 +1,270 @@
+import { resolve } from "node:path";
+import { createZvecGrep, } from "../index.js";
+import { findNearestAnonymousIndex } from "../engine/service/root.js";
+import { contextWarningLines, printAgentContextResult, printHumanContextResult } from "./format/context.js";
+import { printDebug } from "./format/debug.js";
+import { createIndexProgressReporter } from "./format/progress.js";
+import { printAnonymousInfo, printCollectionInfo, printCollectionList, printCollectionRemoveResult, printIndexResult, } from "./format/status.js";
+export async function runParsedCommand(parsed) {
+    if (parsed.options.init) {
+        await runInit(parsed);
+        return;
+    }
+    if (parsed.options.info) {
+        await runInfo(parsed);
+        return;
+    }
+    if (parsed.options.collections) {
+        await runCollections(parsed);
+        return;
+    }
+    await runQuery(parsed);
+}
+async function runInit(parsed) {
+    const explicitRoot = parsed.positionals.length > 0;
+    const root = resolveInitRoot(parsed.positionals[0]);
+    const rootPath = indexRootPath(root, parsed.options);
+    if (parsed.positionals.length > 1) {
+        throw new Error("zg --init accepts at most one root path");
+    }
+    const zvecGrep = await createZvecGrep(createServiceOptions(parsed.options, rootPath.absolutePath));
+    const progress = createIndexProgressReporter();
+    try {
+        const result = await zvecGrep.init({
+            root: rootPath.absolutePath,
+            rootPaths: explicitRoot ? [rootPath] : undefined,
+            rebuild: parsed.options.rebuild,
+            resetPaths: parsed.options.resetPaths,
+            includePaths: parsed.options.includePaths,
+            excludePaths: parsed.options.excludePaths,
+            embeddingConcurrency: parsed.options.embeddingConcurrency,
+            onProgress: progress.report,
+        });
+        progress.finish();
+        const info = await zvecGrep.info({ root: rootPath.absolutePath });
+        printIndexResult("Initialized anonymous index", result, parsed.options, info.collection?.rootPaths);
+    }
+    catch (error) {
+        progress.finish();
+        throw error;
+    }
+    finally {
+        await zvecGrep.close();
+    }
+}
+async function runInfo(parsed) {
+    const root = parsed.positionals[0] ?? process.cwd();
+    if (parsed.positionals.length > 1) {
+        throw new Error("zg --info accepts at most one root path");
+    }
+    const zvecGrep = await createZvecGrep(createServiceOptions(parsed.options, root));
+    try {
+        const info = await zvecGrep.info({ root });
+        printAnonymousInfo(info, parsed.options);
+    }
+    finally {
+        await zvecGrep.close();
+    }
+}
+async function runCollections(parsed) {
+    const [action = "list", name, root] = parsed.positionals;
+    const zvecGrep = await createZvecGrep(createServiceOptions(parsed.options, undefined));
+    try {
+        if (action === "list") {
+            if (parsed.options.resetPaths) {
+                throw new Error("--reset-paths can only be used with --collections index");
+            }
+            printCollectionList(await zvecGrep.collections.list(), parsed.options);
+            return;
+        }
+        if (action === "info") {
+            if (parsed.options.resetPaths) {
+                throw new Error("--reset-paths can only be used with --collections index");
+            }
+            if (!name) {
+                throw new Error("zg --collections info requires <name>");
+            }
+            const [info, status] = await Promise.all([
+                zvecGrep.collections.info(name),
+                zvecGrep.collections.status(name),
+            ]);
+            if (!info) {
+                throw new Error(`Collection not found: ${name}`);
+            }
+            printCollectionInfo(info, status, parsed.options);
+            return;
+        }
+        if (action === "index") {
+            if (!name) {
+                throw new Error("zg --collections index requires <name>");
+            }
+            const explicitRoot = root !== undefined;
+            const rootPath = indexRootPath(root ?? process.cwd(), parsed.options);
+            const rootPaths = explicitRoot ? rootPath : undefined;
+            const progress = createIndexProgressReporter();
+            try {
+                const result = await zvecGrep.collections.index(name, rootPaths, {
+                    rebuild: parsed.options.rebuild,
+                    resetPaths: parsed.options.resetPaths,
+                    includePaths: parsed.options.includePaths,
+                    excludePaths: parsed.options.excludePaths,
+                    embeddingConcurrency: parsed.options.embeddingConcurrency,
+                    onProgress: progress.report,
+                });
+                progress.finish();
+                const info = await zvecGrep.collections.info(name);
+                printIndexResult(`Indexed collection ${name}`, result, parsed.options, info?.rootPaths);
+            }
+            catch (error) {
+                progress.finish();
+                throw error;
+            }
+            return;
+        }
+        if (action === "remove") {
+            if (parsed.options.resetPaths) {
+                throw new Error("--reset-paths can only be used with --collections index");
+            }
+            if (!name) {
+                throw new Error("zg --collections remove requires <name>");
+            }
+            const removed = await zvecGrep.collections.remove(name);
+            printCollectionRemoveResult(name, removed, parsed.options);
+            return;
+        }
+        if (parsed.options.resetPaths) {
+            throw new Error("--reset-paths can only be used with --collections index");
+        }
+        throw new Error(`Unknown collections action: ${action}`);
+    }
+    finally {
+        await zvecGrep.close();
+    }
+}
+async function runQuery(parsed) {
+    const rgInput = parsed.options.rg
+        ? normalizeRgInput(parsed)
+        : undefined;
+    const commandOptions = rgInput?.options ?? parsed.options;
+    const queries = (rgInput?.queries ?? parsed.positionals)
+        .map((query) => query.trim())
+        .filter((query) => query.length > 0);
+    const routes = parsed.options.routes ?? [];
+    if (queries.length === 0 && routes.length === 0) {
+        throw new Error(parsed.options.rg
+            ? "zg --rg requires a pattern. Use --help for examples."
+            : "zg query requires text or --fts/--vector routes. Use --help for examples.");
+    }
+    const zvecGrep = await createZvecGrep(createServiceOptions(commandOptions, undefined));
+    try {
+        const result = await zvecGrep.context(contextOptions(commandOptions, queries));
+        if (commandOptions.human) {
+            printHumanContextResult(result, commandOptions);
+        }
+        else {
+            printAgentContextResult(result, commandOptions);
+        }
+        for (const line of contextWarningLines(result)) {
+            console.error(line);
+        }
+        if (commandOptions.debug) {
+            printDebug(result, {
+                trace: commandOptions.trace === true,
+            });
+        }
+    }
+    finally {
+        await zvecGrep.close();
+    }
+}
+function contextOptions(options, queries) {
+    return {
+        queries: queries.length > 0 ? queries : undefined,
+        rg: options.rg,
+        rgOptions: options.rgOptions,
+        rgPaths: options.rgPaths,
+        routes: options.routes,
+        collection: options.collection,
+        limit: options.limit,
+        fallback: "disabled",
+        autoUpdate: !options.noAutoUpdate,
+        trace: options.trace,
+        preferSymbol: options.preferSymbol,
+        includePaths: options.includePaths,
+        excludePaths: options.excludePaths,
+        modifiedAfter: options.modifiedAfter,
+        modifiedBefore: options.modifiedBefore,
+        symbolTypes: options.symbolTypes,
+        embeddingConcurrency: options.embeddingConcurrency,
+    };
+}
+function normalizeRgInput(parsed) {
+    const explicitPatterns = parsed.options.rgOptions?.patterns ?? [];
+    const queries = explicitPatterns.length > 0
+        ? explicitPatterns
+        : parsed.positionals.slice(0, 1);
+    const paths = explicitPatterns.length > 0
+        ? parsed.positionals
+        : parsed.positionals.slice(1);
+    return {
+        queries,
+        options: {
+            ...parsed.options,
+            rgPaths: paths.length > 0 ? paths : undefined,
+        },
+    };
+}
+function createServiceOptions(options, root) {
+    const embedding = options.embedding ?? process.env.ZVEC_GREP_EMBEDDING;
+    const apiKey = options.apiKey
+        ?? process.env.ZVEC_GREP_API_KEY
+        ?? process.env.DASHSCOPE_API_KEY
+        ?? process.env.QWEN_API_KEY;
+    const endpoint = options.endpoint ?? process.env.ZVEC_GREP_ENDPOINT;
+    return {
+        root,
+        home: options.home ?? process.env.ZVEC_GREP_HOME,
+        embedding,
+        apiKey,
+        endpoint,
+        modelCacheDir: options.modelCacheDir ?? process.env.ZVEC_GREP_MODEL_CACHE,
+        llamaGpu: options.llamaGpu ?? parseEnvLlamaGpu(process.env.ZVEC_GREP_LLAMA_GPU),
+        embeddingParallelism: options.embeddingParallelism ?? parseEnvPositiveInteger(process.env.ZVEC_GREP_EMBED_PARALLELISM),
+    };
+}
+function parseEnvLlamaGpu(value) {
+    const normalized = value?.trim().toLowerCase() ?? "";
+    if (!normalized) {
+        return undefined;
+    }
+    if (normalized === "auto" || normalized === "metal" || normalized === "vulkan" || normalized === "cuda") {
+        return normalized;
+    }
+    if (["false", "off", "none", "disable", "disabled", "0"].includes(normalized)) {
+        return false;
+    }
+    return undefined;
+}
+function parseEnvPositiveInteger(value) {
+    const normalized = value?.trim() ?? "";
+    if (!normalized) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(normalized, 10);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+function resolveInitRoot(root) {
+    if (root !== undefined) {
+        return root;
+    }
+    return findNearestAnonymousIndex(process.cwd())?.root ?? process.cwd();
+}
+function indexRootPath(path, options) {
+    return {
+        absolutePath: resolve(path),
+        recursive: true,
+        include: options.includePaths,
+        exclude: options.excludePaths,
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

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

package/dist/cli/errors.d.ts

@@ -0,0 +1,6 @@
+import type { ColorMode } from "./types.js";
+export type ErrorPrintOptions = {
+    color?: ColorMode;
+};
+export declare function printError(error: unknown, options?: ErrorPrintOptions): void;
+export declare function colorModeFromArgs(args: readonly string[]): ColorMode;

package/dist/cli/errors.js

@@ -0,0 +1,97 @@
+import { isEngineError } from "../engine/errors/index.js";
+export function printError(error, options = {}) {
+    const theme = createErrorTheme(options.color);
+    if (isEngineError(error)) {
+        console.error(`${theme.error("Error:")} ${error.message}`);
+        console.error(`${theme.label("Code:")} ${error.code}`);
+        if (error.context) {
+            console.error(`${theme.label("Details:")}`);
+            for (const line of formatContextLines(error.context)) {
+                console.error(`  ${line}`);
+            }
+        }
+        printCause(error, theme);
+        return;
+    }
+    console.error(`${theme.error("Error:")} ${error instanceof Error ? error.message : String(error)}`);
+    printCause(error, theme);
+}
+function formatContextLines(context) {
+    return context
+        .split(/\r?\n/)
+        .flatMap(formatContextLine)
+        .filter((line) => line.length > 0);
+}
+function formatContextLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) {
+        return [];
+    }
+    const pairs = parseKeyValuePairs(trimmed)
+        .filter((pair) => !(pair.key === "collection" && pair.value === "__anonymous__"));
+    return pairs.length > 0
+        ? pairs.map((pair) => `${pair.key}: ${pair.value}`)
+        : [trimmed];
+}
+function parseKeyValuePairs(line) {
+    const matches = [...line.matchAll(/(^|\s)([A-Za-z][A-Za-z0-9_.-]*)=/g)].map((match) => ({
+        key: match[2],
+        keyStart: match.index + match[1].length,
+        valueStart: match.index + match[0].length,
+    }));
+    if (matches.length === 0) {
+        return [];
+    }
+    return matches.map((match, index) => {
+        const next = matches[index + 1];
+        const valueEnd = next ? next.keyStart : line.length;
+        return {
+            key: match.key,
+            value: line.slice(match.valueStart, valueEnd).trim(),
+        };
+    });
+}
+function printCause(error, theme) {
+    const cause = errorCauseMessage(error);
+    if (cause) {
+        console.error(`${theme.label("Cause:")} ${cause}`);
+    }
+}
+function errorCauseMessage(error) {
+    if (!(error instanceof Error) || error.cause === undefined) {
+        return undefined;
+    }
+    return error.cause instanceof Error ? error.cause.message : String(error.cause);
+}
+export function colorModeFromArgs(args) {
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (arg === "--no-color") {
+            return "never";
+        }
+        if (arg === "--color") {
+            const value = args[index + 1];
+            if (value === "always" || value === "never" || value === "auto") {
+                return value;
+            }
+        }
+    }
+    return "auto";
+}
+function createErrorTheme(mode = "auto") {
+    const enabled = shouldUseErrorColor(mode);
+    return {
+        error: (value) => enabled ? `\x1b[1;31m${value}\x1b[0m` : value,
+        label: (value) => enabled ? `\x1b[2m${value}\x1b[0m` : value,
+    };
+}
+function shouldUseErrorColor(mode) {
+    if (mode === "always") {
+        return true;
+    }
+    if (mode === "never") {
+        return false;
+    }
+    return process.env.NO_COLOR === undefined && process.stderr.isTTY === true;
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

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

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

@@ -0,0 +1,5 @@
+import type { ZvecGrepContextResult } from "../../index.js";
+import type { CliOptions } from "../types.js";
+export declare function printAgentContextResult(result: ZvecGrepContextResult, options: CliOptions): void;
+export declare function printHumanContextResult(result: ZvecGrepContextResult, options: CliOptions): void;
+export declare function contextWarningLines(result: ZvecGrepContextResult): string[];