@zvec/zvec-grep 0.1.5 → 0.1.7

package/dist/cli/help.js

@@ -1,3 +1,7 @@
+import { COMPONENT_CODE_FORMATS, STRUCTURED_CODE_FORMATS, } from "../engine/code-formats.js";
+import { listKnownBinaryExtensionGroups, listRecognizedFileTypes, } from "../engine/file-type.js";
+import { resolveMaxFileSizeBytes } from "../engine/file-size-policy.js";
+import { listEmbeddingModels } from "../engine/models/index.js";
 export function printHelp(version, topic) {
     if (!topic) {
         console.log(mainHelp(version));
@@ -9,6 +13,36 @@ export function printHelp(version, 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_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",
+    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: "Positive llama.cpp context parallelism override (advanced)",
+    NO_COLOR: "Disable terminal colors",
+    CODEX_HOME: "Codex configuration directory used by zg install",
+    CLAUDE_CONFIG_DIR: "Claude configuration directory used by zg install",
+    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}
 
@@ -19,20 +53,30 @@ Commands:
   query          Search indexed context or run managed ripgrep
   index          Build, rebuild, or drop the workspace index
   status         Show workspace and index status
-  collections    Manage named collections
+  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 a command
+  help           Show help for a command or topic
   version        Print the installed version
 
 Examples:
   zg query "where authentication is validated"
   zg query --fts "AuthService"
   zg query --rg -F "AuthService" src
-  zg index --embedding local/embeddinggemma-300m
+  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 <command> or zg <command> --help for command-specific help.
 Use zg -h/--help for this page and zg -v/--version for the version.`;
 }
@@ -50,53 +94,74 @@ Search routes:
   --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; cannot be mixed with indexed routes
-
-Each route option consumes one query and may be repeated. Without --fuse,
---limit applies to each query group; with --fuse it applies to the final list.
+  --rg                              Run exhaustive managed ripgrep
 
 Result options:
-  --limit <n>                       Maximum results
-  --human                           Human-readable ranked output
-  --preview <none|short|full>       Indexed source preview size
+  --limit <n>                       Maximum results per group (default: 7)
+  --human                           Human-readable output (default: agent markdown)
+  --preview <none|short|full>       Indexed preview size (default: none; --human: full)
   --debug                           Print diagnostics to stderr
   --trace                           Include per-hit indexed search trace
-  --color <auto|always|never>       Color mode
-  --no-color                        Disable color
+  --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.
 
-File filters (indexed and --rg):
+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
-
-Indexed-only filters:
-  --collection <name>               Query a named collection
   --symbol-type <type>              module, class, interface, function, value, alias
   --prefer-symbol                   Prefer exact indexed symbols
-  --no-auto-update                  Do not refresh a stale anonymous index
-  --embedding-concurrency <n>       Concurrency for automatic index refresh
-
-Managed --rg supports common ripgrep matching, file-selection, context, engine,
-encoding, and discovery flags, including -e/-f, -F, -i/-s/-S, -w/-x/-v,
--A/-B/-C, -m, -P/-U, -g/--iglob, -t/-T, --hidden, --no-ignore,
---ignore-file, --max-depth, --max-filesize, -L, and -z. Use -e when a
-pattern begins with "-". Options that replace rg's output format, such as
---json, --count, --files, -l, -o, --replace, and --vimgrep, are rejected.
-.git/** and .zvec-grep/** remain excluded.`;
+
+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",
+            ])}
+
+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]
 
-Options:
-  --embedding <model>               Model such as local/embeddinggemma-300m or qwen/text-embedding-v4
+Index options:
   --rebuild                         Rebuild the existing index
   --drop                            Permanently remove the workspace index
   --yes                             Confirm --drop without prompting
+  --debug                           Print skipped-file diagnostics to stderr
+  --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
+  --embedding-concurrency <n>       Embedding task concurrency
+  --allow-remote                    Allow Remote Embedding for this command only
+
+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
@@ -108,69 +173,336 @@ Options:
   --max-filesize <size>             Maximum bytes or K/M/G/T size
   -L, --follow                      Follow symbolic links safely
   --reset-paths                     Clear inherited file-selection settings
-  --embedding-concurrency <n>       Embedding task concurrency
-  --api-key <key>                   Embedding provider API key
-  --endpoint <url>                  Embedding provider endpoint
-  --model-cache <path>              Local model cache directory
-  --gpu                             Try GPU acceleration
-  --no-gpu                          Force CPU local embeddings
-  --llama-gpu <mode>                auto, metal, vulkan, cuda, off
-  --embedding-parallelism <n>       Local embedding context parallelism
 
 New indexes require --embedding, ZVEC_GREP_EMBEDDING, or a configured default.
-Existing indexes reuse their stored embedding schema. Explicit model/provider
-options used for a successful index are persisted in ~/.zvec-grep/config.json.`;
+Existing indexes reuse their stored embedding schema.
+
+Environment:
+${formatEnvironmentVariables([
+                "ZVEC_GREP_MODE",
+                "ZVEC_GREP_EMBEDDING",
+                "ZVEC_GREP_API_KEY",
+                "ZVEC_GREP_ENDPOINT",
+                "ZVEC_GREP_MODEL_CACHE",
+                "ZVEC_GREP_DEVICE",
+            ])}
+
+See zg help environment for precedence and Server-mode scope.`;
         case "status":
             return `Usage:
-  zg status [root] [--color <auto|always|never>] [--no-color]
+  zg status [root] [--mode <direct|server|auto>] [--check-ready]
 
 Shows the nearest workspace root, index policy, index state, embedding schema,
-stored paths, refresh status, and suggested next action.`;
-        case "collections":
+stored paths, refresh status, and suggested next action.
+
+--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 query 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 collections
-  zg collections info <name>
-  zg collections index <name> [root] [options]
-  zg collections remove <name>
+  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.
 
-Named collections support the same embedding, file-selection, discovery,
-rebuild, and embedding-concurrency options as zg index.`;
+Environment:
+${formatEnvironmentVariables([
+                "ZVEC_GREP_HOME",
+                "ZVEC_GREP_SERVER_URL",
+                "ZVEC_GREP_SERVER_TOKEN",
+                "ZVEC_GREP_SERVER_TOKEN_FILE",
+                "ZVEC_GREP_MCP_TOOLSET",
+            ])}
+
+See zg help environment for daemon startup scope.`;
         case "install":
             return `Usage:
-  zg install [--target codex|all|auto] [--yes] [--force]
+  zg install [--target codex|claude|opencode|cursor|all|auto] [--mcp-transport stdio|http] [--mcp-toolset agent|full] [--yes] [--force]
 
 Options:
-  --target <agent>                  Agent integration to install
-  --mcp-tool-timeout <seconds>      MCP tool timeout written to agent configuration
-  --yes                             Use default choices without prompting
-  --force                           Replace conflicting unmanaged integration configuration
+  --target <agent>                  codex, claude, 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>      Codex MCP tool timeout (default: 600)
+  --mcp-token-env <name>            HTTP mode Bearer token environment variable
+  --yes                             Install detected agents without prompting
+  --force                           Replace conflicting unmanaged configuration
 
-This installs agent guidance and MCP configuration. It does not install the npm package.`;
+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, and OpenCode also receive managed guidance;
+Codex and Claude Code receive local tool pre-approval. Remote Embedding
+authorization remains separate and is requested by zvec-grep on first remote
+use. This does not install the npm package.`;
         case "uninstall":
             return `Usage:
-  zg uninstall [--target codex|all|auto] [--yes]
+  zg uninstall [--target codex|claude|opencode|cursor|all|auto] [--yes]
 
-Removes zvec-grep-managed agent guidance and MCP configuration. It does not
-remove the npm package or unrelated user configuration.`;
+Removes zvec-grep-managed MCP configuration, trust, and guidance.`;
         case "help":
             return `Usage:
-  zg help [command]
+  zg help [command|topic]
   zg <command> --help
   zg -h
-  zg --help`;
+  zg --help
+
+Topics:
+  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 version
   zg version -v
   zg -v
   zg --version`;
-        case "serve":
-            return `Usage:
-  zg serve --mcp
-
-Starts the stdio MCP process used by installed agent integrations.`;
         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",
+    ])}
+
+Embedding:
+${formatEnvironmentVariables([
+        "ZVEC_GREP_EMBEDDING",
+        "ZVEC_GREP_API_KEY",
+        "ZVEC_GREP_ENDPOINT",
+        "ZVEC_GREP_MODEL_CACHE",
+        "ZVEC_GREP_DEVICE",
+    ])}
+
+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",
+        "OPENCODE_CONFIG",
+        "CURSOR_CONFIG_DIR",
+    ])}
+
+Precedence:
+  Embedding runtime                 CLI > Workspace snapshot > Global config > Environment
+  New-index model                  --embedding > ZVEC_GREP_EMBEDDING > Global config
+  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.
+  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

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAc;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,aAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;oEAwBuC,CAAC;AACrE,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA8C8B,CAAC;QACxC,KAAK,OAAO;YACV,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EAgCkE,CAAC;QAC5E,KAAK,QAAQ;YACX,OAAO;;;;yDAI4C,CAAC;QACtD,KAAK,aAAa;YAChB,OAAO;;;;;;;wDAO2C,CAAC;QACrD,KAAK,SAAS;YACZ,OAAO;;;;;;;;;yFAS4E,CAAC;QACtF,KAAK,WAAW;YACd,OAAO;;;;wDAI2C,CAAC;QACrD,KAAK,MAAM;YACT,OAAO;;;;YAID,CAAC;QACT,KAAK,SAAS;YACZ,OAAO;;;;eAIE,CAAC;QACZ,KAAK,OAAO;YACV,OAAO;;;mEAGsD,CAAC;QAChE;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --liftoff-only
 import { parseArgs } from "./args.js";
 import { runParsedCommand } from "./commands.js";
 import { colorModeFromArgs, printError } from "./errors.js";

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[];