@angri450/zvec-grep 0.2.2

package/dist/cli/help.js

@@ -0,0 +1,546 @@
+import { COMPONENT_CODE_FORMATS, STRUCTURED_CODE_FORMATS, } from "../engine/code-formats.js";
+import { resolveMaxFileSizeBytes } from "../engine/file-size-policy.js";
+import { listKnownBinaryExtensionGroups, listRecognizedFileTypes, } from "../engine/file-type.js";
+import { listEmbeddingModels } from "../engine/models/index.js";
+export function printHelp(version, topic) {
+    if (!topic) {
+        console.log(mainHelp(version));
+        return;
+    }
+    const help = commandHelp(topic);
+    if (!help) {
+        throw new Error(`Unknown help topic: ${topic}`);
+    }
+    console.log(help);
+}
+const ENVIRONMENT_VARIABLES = {
+    ZVEC_GREP_HOME: "Runtime and daemon state directory; Workspace indexes stay under <root>/.zvec-grep",
+    ZVEC_GREP_MODE: "Default client mode: direct, server, or auto",
+    ZVEC_GREP_SERVER_URL: "MCP server URL used by CLI clients",
+    ZVEC_GREP_SERVER_TOKEN: "Server/client Bearer token",
+    ZVEC_GREP_SERVER_TOKEN_FILE: "File containing the Server/client Bearer token",
+    ZVEC_GREP_MCP_TOOLSET: "Server MCP surface: agent or full",
+    ZVEC_GREP_WATCHER_IDLE_TIMEOUT_SECONDS: "Seconds of workspace inactivity before the Server releases its watcher; default 14400, 0 disables eviction",
+    ZVEC_GREP_EMBEDDING: "Default model for new indexes and auth grant",
+    ZVEC_GREP_API_KEY: "Embedding provider credential fallback",
+    ZVEC_GREP_ENDPOINT: "Remote Embedding endpoint fallback",
+    ZVEC_GREP_MODEL_CACHE: "Local embedding model cache directory",
+    ZVEC_GREP_DEVICE: "Local embedding device: auto, cpu, metal, vulkan, or cuda",
+    ZVEC_GREP_INDEX_EMBEDDING_CONCURRENCY: "Local/remote index-build/update embedding concurrency; explicit index CLI option takes precedence",
+    DASHSCOPE_API_KEY: "Qwen credential fallback after ZVEC_GREP_API_KEY",
+    QWEN_API_KEY: "Qwen credential fallback after DASHSCOPE_API_KEY",
+    ZVEC_GREP_AUTHORIZATION_KEY_FILE: "Workspace grant signing-key file (advanced)",
+    ZVEC_GREP_METAL_KEEP_RESIDENCY: "Set to 1 to keep llama.cpp Metal residency enabled (advanced)",
+    ZVEC_GREP_LLAMA_CONTEXT_PARALLELISM: "Legacy llama.cpp index limit; index CLI option and environment take precedence",
+    NO_COLOR: "Disable terminal colors",
+    CODEX_HOME: "Codex configuration directory used by zg --install",
+    CLAUDE_CONFIG_DIR: "Claude configuration directory used by zg --install",
+    QWEN_HOME: "Qwen Code configuration directory used by zg --install",
+    QODER_CONFIG_DIR: "Qoder CLI configuration directory used by zg --install",
+    QODER_IDE_MCP_PATH: "Full Qoder IDE mcp.json path used by zg --install",
+    QODER_IDE_EXECUTABLE: "Qoder IDE executable used by automatic install-target detection",
+    OPENCODE_CONFIG: "OpenCode configuration file used by zg --install",
+    CURSOR_CONFIG_DIR: "Cursor configuration directory used by zg --install",
+};
+const MAIN_ENVIRONMENT_VARIABLES = [
+    "ZVEC_GREP_HOME",
+    "ZVEC_GREP_MODE",
+    "ZVEC_GREP_EMBEDDING",
+    "ZVEC_GREP_API_KEY",
+    "ZVEC_GREP_SERVER_URL",
+];
+function mainHelp(version) {
+    return `zvec-grep ${version}
+
+Usage:
+  zg [search options] <query>
+  zg --<action> [action options]
+
+Search is the default operation. Management actions use reserved long options,
+so words such as "index", "install", and "status" remain valid queries.
+Leading command-shaped words emit a migration warning; use zg -- "index" to
+confirm that such a word is intended as literal search input.
+
+Actions:
+  --index        Build, rebuild, or drop the workspace index
+  --status       Show workspace and index status
+  --config       Configure provider credentials and embedding model defaults
+  --auth         Manage Workspace Remote Embedding authorization
+  --server       Start, stop, inspect, or run the shared MCP server
+  --install      Install agent integrations
+  --uninstall    Remove agent integrations
+  --help         Show help for an action or topic
+  --version      Print the installed version
+
+Examples:
+  zg "where authentication is validated"
+  zg --fts "AuthService"
+  zg --rg -F "AuthService" src
+  zg --index --embedding local/potion-code-16m-v2
+  zg --status
+  zg --auth status
+  zg --server on
+  zg --config model set local/potion-code-16m-v2 --device metal
+  zg --install
+
+Environment:
+${formatEnvironmentVariables(MAIN_ENVIRONMENT_VARIABLES)}
+
+Run zg --help models or zg --help file-types for supported indexing capabilities.
+Run zg --help environment for all variables, scopes, aliases, and precedence.
+Run zg --help <action> or zg --<action> --help for action-specific help.
+Use zg -h/--help for this page and zg -v/--version for the version.`;
+}
+function commandHelp(topic) {
+    switch (topic) {
+        case "search":
+            return `Usage:
+  zg <query> [options]
+  zg --hybrid <query> --fts <query> --vector <query> [--fuse]
+  zg --rg [rg-options] <pattern> [path...]
+
+Search routes:
+  positional query                  Hybrid FTS and vector search
+  --hybrid <query>                  Add an explicit hybrid query
+  --fts <query>                     Add an exact/lexical query
+  --vector <query>                  Add a semantic/vector query
+  --fuse                            Fuse all query groups into one ranked list
+  --rg                              Run exhaustive managed ripgrep
+
+Result options:
+  --limit <n>                       Maximum results per group (default: 7)
+  --compact                         Force compact output intended for pipes
+  --preview <none|short|full>       Indexed preview size (default: terminal=full, pipe=none)
+  --debug                           Print diagnostics to stderr
+  --trace                           Include per-hit indexed search trace
+  --refresh <background|wait|off>   Refresh policy (defaults: server=background, direct=off)
+                                    In direct mode, background warns and falls back to off
+  --mode <direct|server|auto>       Select indexed query transport (default: auto)
+
+Indexed results are shown by query group, preserving each group's own rank.
+A result that matches more than one group is shown in each matching group.
+
+Embedding runtime:
+  --api-key <key>                   Embedding provider API key
+  --model-cache <path>              Local model cache directory
+  --device <device>                 auto, cpu, metal, vulkan, cuda
+  --allow-remote                    Allow Remote Embedding for this command only
+
+File filters:
+  -g, --glob <glob>                 Include paths; prefix with ! to exclude; repeatable
+  --iglob <glob>                    Case-insensitive path glob; repeatable
+  -t, --type <type>                 Include a ripgrep file type; repeatable
+  -T, --type-not <type>             Exclude a ripgrep file type; repeatable
+  --modified-after <time>           Only files modified after a date or epoch milliseconds
+  --modified-before <time>          Only files modified before a date or epoch milliseconds
+  --symbol-type <type>              module, class, interface, function, value, alias
+  --prefer-symbol                   Prefer exact indexed symbols
+
+Managed --rg supports common ripgrep matching, context, engine, encoding,
+discovery, glob, and type flags. Use -e when a pattern begins with "-".
+Options that replace rg's output format are rejected.
+
+Environment:
+${formatEnvironmentVariables([
+                "ZVEC_GREP_MODE",
+                "ZVEC_GREP_API_KEY",
+                "ZVEC_GREP_ENDPOINT",
+                "ZVEC_GREP_MODEL_CACHE",
+                "ZVEC_GREP_DEVICE",
+            ])}
+
+If no index exists, zg creates one with a local embedding model before searching.
+Terminal output is human-readable by default; redirected output is compact.
+
+See zg --help environment for precedence and Server-mode scope.`;
+        case "index":
+            return `Usage:
+  zg --index [root] [options]
+  zg --index [root] --rebuild [options]
+  zg --index [root] --drop [--yes]
+
+Index options:
+  --rebuild                         Rebuild the existing index
+  --drop                            Permanently remove the workspace index
+  --yes                             Confirm --drop without prompting
+  --debug                           Print file-scan and model failure diagnostics
+  --mode <direct|server|auto>       Select indexing transport
+
+Embedding options:
+  --embedding <model>               Model such as local/potion-code-16m-v2 or qwen/text-embedding-v4
+  --api-key <key>                   Embedding provider API key
+  --endpoint <url>                  Embedding provider endpoint
+  --model-cache <path>              Local model cache directory
+  --device <device>                 auto, cpu, metal, vulkan, cuda
+  --index-embedding-concurrency <n> Index embedding concurrency limit
+  --allow-remote                    Allow Remote Embedding for this command only
+
+Index concurrency limits llama.cpp contexts, Transformers.js calls in flight,
+or concurrent batches for other models. llama.cpp/Transformers.js cap it at 8.
+It does not change query-vector inference.
+
+File selection:
+  -g, --glob <glob>                 Include paths; prefix with ! to exclude; repeatable
+  --iglob <glob>                    Case-insensitive path glob; repeatable
+  -t, --type <type>                 Include a ripgrep file type; repeatable
+  -T, --type-not <type>             Exclude a ripgrep file type; repeatable
+  --hidden                          Include hidden paths except .git and .zvec-grep
+  --no-ignore                       Do not apply default or .gitignore rules
+  --ignore-file <path>              Add an explicit ignore file; repeatable
+  --max-depth <n>                   Maximum directory depth
+  --max-filesize <size>             Maximum bytes or K/M/G/T size
+  -L, --follow                      Follow symbolic links safely
+  --reset-paths                     Clear inherited file-selection settings
+
+New indexes use --embedding, ZVEC_GREP_EMBEDDING, a configured default, or the
+built-in local default in that order. Existing indexes reuse their schema.
+
+Environment:
+${formatEnvironmentVariables([
+                "ZVEC_GREP_MODE",
+                "ZVEC_GREP_EMBEDDING",
+                "ZVEC_GREP_API_KEY",
+                "ZVEC_GREP_ENDPOINT",
+                "ZVEC_GREP_MODEL_CACHE",
+                "ZVEC_GREP_DEVICE",
+                "ZVEC_GREP_INDEX_EMBEDDING_CONCURRENCY",
+            ])}
+
+See zg --help environment for precedence and Server-mode scope.`;
+        case "status":
+            return `Usage:
+  zg --status [root] [--mode <direct|server|auto>] [--check-ready] [--debug]
+
+Shows the nearest workspace root, index policy, index state, embedding schema,
+stored paths, refresh status, and suggested next action.
+
+--debug includes model download failure details.
+--check-ready preserves the normal output and exits non-zero unless the
+Workspace index is ready.`;
+        case "config":
+            return `Usage:
+  zg --config provider set <provider> --api-key <key>
+  zg --config model set <model> [--endpoint <url> | --device <device>] [--default]
+
+Provider options:
+  --api-key <key>                   Default API key for the provider
+
+Model options:
+  --endpoint <url>                  Endpoint for a remote embedding model
+  --device <device>                 Local device: auto, cpu, metal, vulkan, cuda
+  --default                         Use this model for new indexes
+
+Remote models support --endpoint; local models support --device. At least one
+model option is required. --default may be used alone or with a runtime option.
+Existing indexes continue to use their stored model.
+
+Global configuration is stored in ~/.zvec-grep/config.json.`;
+        case "auth":
+            return `Usage:
+  zg --auth grant [root] --capability embedding --scope workspace [--embedding <model>]
+  zg --auth status [root]
+  zg --auth revoke [root]
+
+Manage the signed Remote Embedding grant stored in the Workspace under
+.zvec-grep/authorization.json. Workspace grants are shared by zg CLI and zg MCP.
+
+--embedding selects the Remote Embedding model to authorize; it does not run
+embedding. If omitted, auth grant uses the existing Workspace index model, then
+ZVEC_GREP_EMBEDDING, then the global default.
+
+Scopes used during operations:
+  once                              Current CLI command or Agent tool call only
+  workspace                         Persisted in this Workspace
+
+Use --allow-remote on zg or zg --index to authorize Remote Embedding for
+that command only. This authorization is not persisted. API credentials
+configure a provider but do not grant permission.
+
+Environment used by auth grant:
+${formatEnvironmentVariables([
+                "ZVEC_GREP_EMBEDDING",
+                "ZVEC_GREP_API_KEY",
+                "ZVEC_GREP_ENDPOINT",
+                "ZVEC_GREP_AUTHORIZATION_KEY_FILE",
+            ])}`;
+        case "server":
+            return `Usage:
+  zg --server --stdio [--token-file <path>] [--mcp-toolset <agent|full>]
+  zg --server on [--listen 127.0.0.1:7999] [--token-file <path>] [--mcp-toolset <agent|full>]
+  zg --server off [--token-file <path>]
+  zg --server status [--check-ready]
+  zg --server run [--listen 127.0.0.1:7999] [--token-file <path>] [--mcp-toolset <agent|full>]
+
+--stdio is the MCP client bootstrap transport. It safely starts or reuses the
+shared daemon, proxies MCP over stdin/stdout, and leaves the daemon running
+when the client disconnects.
+
+The server listens on loopback. Authentication is disabled by default; pass a
+token file or set ZVEC_GREP_SERVER_TOKEN to require Bearer authentication.
+The public MCP endpoint defaults to the agent toolset (indexed search only).
+Use --mcp-toolset full, or ZVEC_GREP_MCP_TOOLSET=full, to expose managed rg and
+the four index and status tools. CLI managed rg, index, and status commands
+continue to use the daemon's internal administration endpoint.
+--check-ready exits non-zero unless the server is ready.
+
+Environment:
+${formatEnvironmentVariables([
+                "ZVEC_GREP_HOME",
+                "ZVEC_GREP_SERVER_URL",
+                "ZVEC_GREP_SERVER_TOKEN",
+                "ZVEC_GREP_SERVER_TOKEN_FILE",
+                "ZVEC_GREP_MCP_TOOLSET",
+                "ZVEC_GREP_WATCHER_IDLE_TIMEOUT_SECONDS",
+            ])}
+
+See zg --help environment for daemon startup scope.`;
+        case "install":
+            return `Usage:
+  zg --install [--target codex|claude|qwen|qoder|opencode|cursor|all|auto] [--mcp-transport stdio|http] [--mcp-toolset agent|full] [--yes] [--force]
+
+Options:
+  --target <agent>                  codex, claude, qwen, qoder, opencode, cursor, auto, or all; repeatable
+  --mcp-transport <stdio|http>      MCP connection mode (default: stdio)
+  --mcp-toolset <agent|full>        Daemon MCP toolset (default: agent)
+  --mcp-tool-timeout <seconds>      MCP tool timeout where supported (default: 600)
+  --mcp-token-env <name>            HTTP mode Bearer token environment variable
+  --yes                             Install detected agents without prompting
+  --force                           Replace conflicting unmanaged configuration
+
+The qoder target configures Qoder CLI and Qoder IDE together.
+
+Interactive setup detects supported agents, configures stdio by default, and
+starts the shared daemon. In stdio mode an agent reconnect also starts the
+daemon automatically after a reboot. HTTP users manage later daemon restarts.
+Codex, Claude Code, Qwen Code, Qoder CLI, and OpenCode also receive managed
+guidance. Qoder IDE has no supported global Rules file, so only its MCP
+configuration is managed.
+Codex and Claude Code receive local tool pre-approval. Qoder's CLI-backed
+runtime receives exact pre-approval for zvec_grep_search and zvec_grep_rg. Remote Embedding
+authorization remains separate and is requested by zvec-grep on first remote
+use. Restart the agent or open a new session after installation. This does not
+install the npm package.`;
+        case "uninstall":
+            return `Usage:
+  zg --uninstall [--target codex|claude|qwen|qoder|opencode|cursor|all|auto] [--yes]
+
+Removes zvec-grep-managed MCP configuration, agent-specific approval, and
+guidance. The qoder target removes the managed Qoder CLI and IDE integration
+together.`;
+        case "help":
+            return `Usage:
+  zg --help [action|topic]
+  zg --<action> --help
+  zg -h
+  zg --help
+
+Topics:
+  search                             Search options and behavior
+  models                             Supported embedding models
+  file-types                         Supported file types and structural parsing
+  environment, env                   Environment variables and precedence`;
+        case "models":
+            return modelsHelp();
+        case "file-types":
+            return fileTypesHelp();
+        case "environment":
+        case "env":
+            return environmentHelp();
+        case "version":
+            return `Usage:
+  zg -v
+  zg --version`;
+        default:
+            return undefined;
+    }
+}
+function modelsHelp() {
+    const models = listEmbeddingModels().sort((left, right) => {
+        const leftRuntime = left.provider === "local" ? 0 : 1;
+        const rightRuntime = right.provider === "local" ? 0 : 1;
+        return (leftRuntime - rightRuntime ||
+            left.reference.localeCompare(right.reference));
+    });
+    return `Usage:
+  zg --help models
+
+Supported embedding models:
+${formatEmbeddingModels(models)}
+
+Local models are downloaded to the model cache on first use. Remote models
+require provider credentials plus --allow-remote or a Workspace authorization.
+Only qwen/qwen3-vl-embedding accepts image input.
+
+Existing indexes keep their stored model. See zg --help environment for
+new-index model selection and runtime precedence.`;
+}
+function fileTypesHelp() {
+    const types = listRecognizedFileTypes();
+    const structuredFormats = new Set(STRUCTURED_CODE_FORMATS);
+    const componentFormats = new Set(COMPONENT_CODE_FORMATS);
+    const codeTypes = types.filter((type) => type.kind === "code");
+    const structuredCode = codeTypes.filter((type) => structuredFormats.has(type.format));
+    const componentCode = codeTypes.filter((type) => componentFormats.has(type.format));
+    const plainCode = codeTypes.filter((type) => !structuredFormats.has(type.format) && !componentFormats.has(type.format));
+    const documentsAndData = types.filter((type) => type.kind === "text" || type.kind === "data");
+    const images = types.filter((type) => type.kind === "image");
+    const skipped = listKnownBinaryExtensionGroups().map((group) => [
+        group.label,
+        group.extensions.join(", "),
+    ]);
+    const sizeLimits = [
+        ["Code", "code"],
+        ["Text", "text"],
+        ["Data", "data"],
+        ["Image", "image"],
+    ].map(([label, kind]) => [
+        label,
+        `${resolveMaxFileSizeBytes(kind) / (1024 * 1024)} MiB`,
+    ]);
+    return `Usage:
+  zg --help file-types
+
+Structured code (symbols and scopes):
+${formatFileTypeTable(structuredCode)}
+
+Component code (JavaScript and TypeScript script blocks):
+${formatFileTypeTable(componentCode)}
+
+Other code (plain-text chunks):
+${formatFileTypeTable(plainCode)}
+
+Documents and data:
+${formatFileTypeTable(documentsAndData)}
+  Markdown preserves heading structure; other formats use text chunks.
+
+Images (multimodal embedding required):
+${formatFileTypeTable(images)}
+  Images are ignored by default and must be explicitly selected.
+
+Other text:
+  Unknown non-binary extensions and extensionless files use text chunks.
+
+Skipped binary types:
+${formatTable(["GROUP", "EXTENSIONS"], skipped)}
+  Files detected as binary by content are also skipped.
+
+Indexing rules:
+  Default size limits:
+${formatTable(["KIND", "MAX SIZE"], sizeLimits)}
+  Empty files are skipped. Use --max-filesize to override the size limit.
+  Common dependencies, build output, generated files, and lock files are
+  ignored by default. .git and .zvec-grep are always skipped.`;
+}
+function formatEmbeddingModels(models) {
+    const rows = models.map((model) => {
+        const runtime = model.provider === "local" ? "local" : "remote";
+        const input = "kind" in model && model.kind === "multimodal" ? "text,image" : "text";
+        const inputLimit = "maxInputTokens" in model ? model.maxInputTokens : model.contextSize;
+        return [
+            model.reference,
+            runtime,
+            input,
+            String(model.dimension),
+            String(inputLimit),
+            model.backend,
+        ];
+    });
+    return formatTable(["MODEL", "RUNTIME", "INPUT", "DIMS", "TOKENS", "BACKEND"], rows, new Set([3, 4]));
+}
+function formatFileTypeTable(types) {
+    const rows = [...types]
+        .sort((left, right) => left.format.localeCompare(right.format))
+        .map((type) => [type.format, type.patterns.join(", ")]);
+    return formatTable(["TYPE", "FILES"], rows);
+}
+function formatTable(header, rows, rightAlignedColumns = new Set()) {
+    const widths = header.map((label, index) => Math.max(label.length, ...rows.map((row) => row[index].length)));
+    const separator = widths.map((width) => "-".repeat(width));
+    return [header, separator, ...rows]
+        .map((row) => `  ${row
+        .map((value, index) => index === row.length - 1
+        ? value
+        : rightAlignedColumns.has(index)
+            ? value.padStart(widths[index])
+            : value.padEnd(widths[index]))
+        .join("  ")}`)
+        .join("\n");
+}
+function environmentHelp() {
+    return `Usage:
+  zg --help environment
+  zg --help env
+
+Client and Server:
+${formatEnvironmentVariables([
+        "ZVEC_GREP_MODE",
+        "ZVEC_GREP_SERVER_URL",
+        "ZVEC_GREP_SERVER_TOKEN",
+        "ZVEC_GREP_SERVER_TOKEN_FILE",
+        "ZVEC_GREP_MCP_TOOLSET",
+        "ZVEC_GREP_WATCHER_IDLE_TIMEOUT_SECONDS",
+    ])}
+
+Embedding:
+${formatEnvironmentVariables([
+        "ZVEC_GREP_EMBEDDING",
+        "ZVEC_GREP_API_KEY",
+        "ZVEC_GREP_ENDPOINT",
+        "ZVEC_GREP_MODEL_CACHE",
+        "ZVEC_GREP_DEVICE",
+        "ZVEC_GREP_INDEX_EMBEDDING_CONCURRENCY",
+    ])}
+
+Qwen credential aliases:
+${formatEnvironmentVariables(["DASHSCOPE_API_KEY", "QWEN_API_KEY"])}
+
+State and authorization:
+${formatEnvironmentVariables([
+        "ZVEC_GREP_HOME",
+        "ZVEC_GREP_AUTHORIZATION_KEY_FILE",
+    ])}
+
+Advanced:
+${formatEnvironmentVariables([
+        "ZVEC_GREP_METAL_KEEP_RESIDENCY",
+        "ZVEC_GREP_LLAMA_CONTEXT_PARALLELISM",
+        "NO_COLOR",
+    ])}
+
+Agent integration paths:
+${formatEnvironmentVariables([
+        "CODEX_HOME",
+        "CLAUDE_CONFIG_DIR",
+        "QWEN_HOME",
+        "QODER_CONFIG_DIR",
+        "QODER_IDE_MCP_PATH",
+        "QODER_IDE_EXECUTABLE",
+        "OPENCODE_CONFIG",
+        "CURSOR_CONFIG_DIR",
+    ])}
+
+Precedence:
+  Embedding runtime                 CLI > Workspace snapshot > Global config > Environment
+  Index embedding concurrency      Index CLI option > index environment > legacy llama variable > auto
+  New-index model                  --embedding > ZVEC_GREP_EMBEDDING > Global config > Built-in local
+  Client mode                      --mode > ZVEC_GREP_MODE > Global config
+  Qwen environment credential      ZVEC_GREP_API_KEY > DASHSCOPE_API_KEY > QWEN_API_KEY
+
+Server scope:
+  zg --index forwards its ZVEC_GREP_EMBEDDING default to Server and auto modes.
+  Explicit --index-embedding-concurrency is forwarded without restarting the daemon.
+  The index concurrency environment also applies to automatic indexing and refresh.
+  Index concurrency controls do not affect query-vector inference.
+  Direct MCP calls use the embedding environment inherited by the daemon.
+  Restart the daemon after changing its embedding runtime environment.
+
+Explicit CLI options take priority. Help output never prints or stores
+environment values.`;
+}
+function formatEnvironmentVariables(names) {
+    const width = Math.max(...names.map((name) => name.length)) + 2;
+    return names
+        .map((name) => `  ${name.padEnd(width)}${ENVIRONMENT_VARIABLES[name]}`)
+        .join("\n");
+}
+//# 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":"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"}

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env -S node --liftoff-only
+import { compatibilityWarningForArgs, 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);
+    let debug = false;
+    try {
+        const compatibilityWarning = compatibilityWarningForArgs(args);
+        if (compatibilityWarning)
+            console.error(compatibilityWarning);
+        const parsed = parseArgs(args);
+        if (parsed.command === "query" && parsed.options.human === undefined) {
+            parsed.options.human = process.stdout.isTTY === true;
+        }
+        debug = parsed.options.debug === true;
+        if (parsed.command === "version") {
+            console.log(PACKAGE_VERSION);
+            process.exitCode = 0;
+            return;
+        }
+        if (parsed.command === "help") {
+            printHelp(PACKAGE_VERSION, parsed.helpTopic);
+            process.exitCode = 0;
+            return;
+        }
+        await runParsedCommand(parsed);
+        process.exitCode = 0;
+    }
+    catch (error) {
+        printError(error, { color: errorColor, debug });
+        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,2BAA2B,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,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;AAElD,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;AAE7C,KAAK,IAAI,EAAE,CAAC;AAEZ,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;IAC3C,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,oBAAoB;YAAE,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACrE,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;QACvD,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;QAEtC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,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,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/install.d.ts

@@ -0,0 +1,4 @@
+import type { ParsedArgs } from "./types.js";
+export declare function runInstall(parsed: ParsedArgs): Promise<void>;
+export declare function runUninstall(parsed: ParsedArgs): Promise<void>;
+export declare function installerSelectionLines(activeIndex: number, detected: ReadonlySet<string>): string[];