@lzehrung/codegraph 2.1.0

package/dist/cli/options.js

@@ -0,0 +1,694 @@
+const CLI_VALUE_OPTIONS = new Set([
+    "--root",
+    "--output",
+    "--out",
+    "--stderr-file",
+    "--threads",
+    "--native",
+    "--cache",
+    "--changed-since",
+    "--git-base",
+    "--git-head",
+    "--symbols-detailed-scope",
+    "--symbols-detailed-max-edges",
+    "--sqlite",
+    "--db",
+    "--file",
+    "--line",
+    "--col",
+    "--column",
+    "--query",
+    "--pattern",
+    "--regex",
+    "--glob",
+    "--file-glob",
+    "--kind",
+    "--provider",
+    "--base",
+    "--head",
+    "--base-artifact",
+    "--pr",
+    "--repo",
+    "--max-refs",
+    "--max-changed-symbols",
+    "--max-reference-lookups",
+    "--max-total-references",
+    "--time-budget-ms",
+    "--depth",
+    "--filter",
+    "--sort",
+    "--scope",
+    "--ref-context",
+    "--ref-context-lines",
+    "--ref-block-max-lines",
+    "--max-tests",
+    "--max-callsites",
+    "--language",
+    "--min-tokens",
+    "--max-tokens",
+    "--max-bucket-size",
+    "--min-confidence",
+    "--max-hits",
+    "--resolution-hint",
+    "--review-depth",
+    "--ignore-glob",
+    "--include-glob",
+    "--ignore-root-glob",
+    "--include-root-glob",
+    "--report-file",
+    "--lcov",
+    "--coverage-report",
+    "--test-command-template",
+    "--duplicates",
+    "--agent",
+    "--target",
+    "--print-config",
+    "--limit",
+    "--fail-on",
+    "--hotspot-jump-threshold",
+    "--graph-edges",
+    "--public-api",
+    "--profile",
+    "--budget",
+    "--health",
+    "--mode",
+    "--from",
+    "--max-dependencies",
+    "--max-snippets",
+    "--max-symbols",
+    "--max-duplicates",
+    "--max-packets",
+    "--max-paths",
+    "--artifact",
+    "--host",
+    "--graph",
+    "--port",
+    "--offset",
+    "--max-bytes",
+    "--max-edits",
+    "--rename",
+    "--max-references",
+    "--max-callers",
+    "--max-hierarchy",
+]);
+const SHARED_BUILD_FLAGS = [
+    "--cache-strict",
+    "--cache-verify",
+    "--progress",
+    "--no-progress",
+    "--workers",
+    "--no-gitignore",
+    "--fast-graph",
+    "--resolve-node-modules",
+    "--dynamic-import-heuristics",
+];
+const SHARED_BUILD_OPTIONS = [
+    "--root",
+    "--threads",
+    "--native",
+    "--cache",
+    "--include-glob",
+    "--ignore-glob",
+    "--resolution-hint",
+];
+// Lifecycle commands (init/status/sync) always warm/read the disk cache and never honor an
+// explicit --cache override, so --cache is intentionally excluded here to keep the CLI
+// contract truthful.
+const LIFECYCLE_BUILD_OPTIONS = SHARED_BUILD_OPTIONS.filter((option) => option !== "--cache");
+// `status` never calls createAgentSession/loadProject (it only hashes config, hashes build
+// options, and lists project files for signature hashing), so progress, cache verification,
+// and workers have no observable effect there, unlike for init/sync which do a full build.
+const STATUS_BUILD_FLAGS = SHARED_BUILD_FLAGS.filter((flag) => flag !== "--cache-verify" && flag !== "--progress" && flag !== "--no-progress" && flag !== "--workers");
+// --threads only matters for the concurrency of an actual build (init/sync); status never builds.
+const STATUS_BUILD_OPTIONS = LIFECYCLE_BUILD_OPTIONS.filter((option) => option !== "--threads");
+const JSON_OUTPUT_FLAGS = ["--json", "--pretty"];
+const REPORT_FLAGS = ["--report"];
+const REPORT_OPTIONS = ["--report-file"];
+const GIT_RANGE_OPTIONS = ["--base", "--head", "--changed-since"];
+function commandSchema(flags, options, positionals) {
+    return { flags, options, positionals };
+}
+function graphCommandSchema(positionals) {
+    return commandSchema([
+        ...SHARED_BUILD_FLAGS,
+        ...JSON_OUTPUT_FLAGS,
+        ...REPORT_FLAGS,
+        "--dot",
+        "--full",
+        "--mermaid",
+        "--sql-artifacts",
+        "--stable",
+        "--stdout",
+        "--symbols",
+        "--symbols-detailed",
+        "--symbols-detailed-members-only",
+        "--symbols-only",
+        "--verbose",
+    ], [
+        ...SHARED_BUILD_OPTIONS,
+        ...REPORT_OPTIONS,
+        "--changed-since",
+        "--git-base",
+        "--git-head",
+        "--db",
+        "--ignore-root-glob",
+        "--include-root-glob",
+        "--output",
+        "--out",
+        "--sqlite",
+        "--stderr-file",
+        "--symbols-detailed-max-edges",
+        "--symbols-detailed-scope",
+    ], positionals);
+}
+const CLI_COMMAND_SCHEMAS = new Map([
+    [
+        "affected",
+        commandSchema([...SHARED_BUILD_FLAGS, "--json", "--quiet", "--stdin"], [...SHARED_BUILD_OPTIONS, "--base", "--depth", "--filter", "--head"], {
+            kind: "any",
+        }),
+    ],
+    [
+        "apisurface",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], SHARED_BUILD_OPTIONS, {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph apisurface [project-root] [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "artifact",
+        commandSchema([...SHARED_BUILD_FLAGS, "--force", "--graph-json", ...JSON_OUTPUT_FLAGS, "--questions", "--report", "--sqlite"], [...SHARED_BUILD_OPTIONS, "--out", "--output"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph artifact [build] [--root <path>] [--out <dir>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "chunk",
+        commandSchema([...JSON_OUTPUT_FLAGS, "--text"], ["--language", "--max-tokens", "--min-tokens"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph chunk <file-path> [options]",
+        }),
+    ],
+    [
+        "cycles",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--sort"], {
+            kind: "any",
+        }),
+    ],
+    [
+        "deps",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--depth"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph deps <file> [--root <path>] [--depth <n>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "doctor",
+        commandSchema(["--json", "--pretty"], [], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph doctor [artifact-path] [--json | --pretty]",
+        }),
+    ],
+    [
+        "drift",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [
+            ...SHARED_BUILD_OPTIONS,
+            "--base",
+            "--base-artifact",
+            "--fail-on",
+            "--graph-edges",
+            "--head",
+            "--hotspot-jump-threshold",
+            "--limit",
+            "--public-api",
+        ], { kind: "any" }),
+    ],
+    [
+        "dumpmod",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], SHARED_BUILD_OPTIONS, {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph dumpmod <file> [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "duplicates",
+        commandSchema([
+            ...SHARED_BUILD_FLAGS,
+            ...JSON_OUTPUT_FLAGS,
+            "--include-same-file",
+            "--include-small",
+            "--no-summary",
+            "--raw-pairs",
+        ], [
+            ...SHARED_BUILD_OPTIONS,
+            "--ignore-root-glob",
+            "--include-root-glob",
+            "--limit",
+            "--max-bucket-size",
+            "--max-tokens",
+            "--min-confidence",
+            "--min-tokens",
+            "--profile",
+            "--sort",
+        ], { kind: "any" }),
+    ],
+    [
+        "explain",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--changed-context"], [
+            ...SHARED_BUILD_OPTIONS,
+            ...GIT_RANGE_OPTIONS,
+            "--max-dependencies",
+            "--max-duplicates",
+            "--max-snippets",
+            "--max-symbols",
+        ], { kind: "any" }),
+    ],
+    [
+        "explore",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--no-source", "--include-graph-context", "--allow-sensitive"], [...SHARED_BUILD_OPTIONS, "--limit", "--max-packets", "--max-paths"], { kind: "any" }),
+    ],
+    [
+        "file",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--include-graph-context", "--allow-sensitive"], [...SHARED_BUILD_OPTIONS, "--offset", "--limit", "--max-bytes"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph file <path> [--root <path>] [--offset <line>] [--limit <lines>] [--max-bytes <bytes>] [--include-graph-context] [--allow-sensitive] [--json | --pretty]",
+        }),
+    ],
+    [
+        "goto",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], SHARED_BUILD_OPTIONS, {
+            kind: "max",
+            max: 3,
+            usage: "Usage: codegraph goto <file>[:line[:column]] [line] [column] [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    ["graph", graphCommandSchema({ kind: "any" })],
+    [
+        "graph-delta",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--incremental-strict"], [...SHARED_BUILD_OPTIONS, "--changed-since", "--git-base", "--git-head", "--output"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph graph-delta [project-root] [--root <path>] [--git-base <ref> | --changed-since <ref>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "grep",
+        commandSchema(["--ignore-case", "--json", "-i", "--no-gitignore"], ["--glob", "--ignore-glob", "--include-glob", "--max-hits", "--pattern", "--query", "--regex", "--root"], {
+            kind: "any",
+        }),
+    ],
+    [
+        "hotspots",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--limit"], { kind: "any" }),
+    ],
+    [
+        "impact",
+        commandSchema([
+            ...SHARED_BUILD_FLAGS,
+            ...JSON_OUTPUT_FLAGS,
+            "--compact",
+            "--include-tests",
+            "--members-only",
+            "--mermaid",
+            "--verify-refs",
+        ], [
+            ...SHARED_BUILD_OPTIONS,
+            ...GIT_RANGE_OPTIONS,
+            "--coverage-report",
+            "--depth",
+            "--duplicates",
+            "--lcov",
+            "--max-refs",
+            "--max-changed-symbols",
+            "--max-reference-lookups",
+            "--max-total-references",
+            "--time-budget-ms",
+            "--pr",
+            "--provider",
+            "--ref-block-max-lines",
+            "--ref-context",
+            "--ref-context-lines",
+            "--repo",
+            "--scope",
+            "--test-command-template",
+        ], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph impact [project-root] [--provider git|github|raw] [options]",
+        }),
+    ],
+    [
+        "implementations",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--limit"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph implementations <symbol-target> [--root <path>] [--limit <0-500>] [--json | --pretty]",
+        }),
+    ],
+    ["index", graphCommandSchema({ kind: "any" })],
+    [
+        "init",
+        commandSchema([...SHARED_BUILD_FLAGS, "--json", "--pretty", "--force", "--no-update-gitignore"], LIFECYCLE_BUILD_OPTIONS, {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph init [path] [--force] [--no-update-gitignore] [--json | --pretty] OR codegraph init --root <path> [--force] [--no-update-gitignore] [--json | --pretty]",
+        }),
+    ],
+    [
+        "install",
+        commandSchema(["--all", "--detect", "--dry-run", "--force", "--json", "--pretty", "--yes"], ["--print-config", "--target"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph install [target] [--target <ids> | --all] [--detect] [--yes | --dry-run] [--force] [--json | --pretty] [--print-config <target>]",
+        }),
+    ],
+    [
+        "uninstall",
+        commandSchema(["--detect", "--dry-run", "--json", "--pretty", "--yes"], ["--target"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph uninstall [target] [--target <ids>] [--detect] [--yes | --dry-run] [--json | --pretty]",
+        }),
+    ],
+    [
+        "inspect",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, ...REPORT_FLAGS, "--duplicates"], [...SHARED_BUILD_OPTIONS, ...REPORT_OPTIONS, "--limit"], {
+            kind: "any",
+        }),
+    ],
+    [
+        "mcp",
+        commandSchema([...SHARED_BUILD_FLAGS, "--allow-build", "--stdio", "--warmup", "--warmup-symbols"], [...SHARED_BUILD_OPTIONS, "--artifact", "--host", "--port", "--idle-timeout-ms"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph mcp [serve] [--root <path>] [--stdio | --port <number>]",
+        }),
+    ],
+    [
+        "orient",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--budget", "--health"], {
+            kind: "any",
+        }),
+    ],
+    [
+        "packet",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--max-duplicates", "--max-snippets", "--max-symbols"], {
+            kind: "max",
+            max: 2,
+            usage: "Usage: codegraph packet [get] <target> [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "path",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], SHARED_BUILD_OPTIONS, {
+            kind: "max",
+            max: 2,
+            usage: "Usage: codegraph path <from-file> <to-file> [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "rdeps",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--depth"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph rdeps <file> [--root <path>] [--depth <n>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "refs",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--col", "--column", "--file", "--line"], {
+            kind: "max",
+            max: 3,
+            usage: "Usage: codegraph refs <file>[:line[:column]] [line] [column] [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "review",
+        commandSchema([
+            ...SHARED_BUILD_FLAGS,
+            ...JSON_OUTPUT_FLAGS,
+            ...REPORT_FLAGS,
+            "--include-symbol-details",
+            "--incremental-strict",
+        ], [
+            ...SHARED_BUILD_OPTIONS,
+            ...REPORT_OPTIONS,
+            ...GIT_RANGE_OPTIONS,
+            "--duplicates",
+            "--max-callsites",
+            "--max-tests",
+            "--review-depth",
+        ], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph review [project-root] [--root <path>] [--base <ref>] [--head <ref>] [--changed-since <ref>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "rename-preview",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--include-comments", "--include-strings", "--include-filenames"], [...SHARED_BUILD_OPTIONS, "--max-edits"], {
+            kind: "max",
+            max: 2,
+            usage: "Usage: codegraph rename-preview <symbol-target> <new-name> [--include-comments] [--include-strings] [--include-filenames] [--max-edits N] [--json | --pretty]",
+        }),
+    ],
+    [
+        "refactor-plan",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--include-source"], [...SHARED_BUILD_OPTIONS, "--rename", "--max-references", "--max-callers", "--max-hierarchy"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph refactor-plan <symbol-target> [--rename <new-name>] [--max-references <0-500>] [--max-callers <0-500>] [--max-hierarchy <0-500>] [--include-source] [--json | --pretty]",
+        }),
+    ],
+    [
+        "search",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, ...REPORT_FLAGS, "--no-snippets"], [...SHARED_BUILD_OPTIONS, ...REPORT_OPTIONS, "--depth", "--from", "--limit", "--mode"], { kind: "any" }),
+    ],
+    [
+        "symbols",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--exported", "--include-imports"], [...SHARED_BUILD_OPTIONS, "--file-glob", "--kind", "--limit"], { kind: "any" }),
+    ],
+    [
+        "callees",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--include-heuristic"], [...SHARED_BUILD_OPTIONS, "--depth", "--limit"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph callees <symbol-target> [--root <path>] [--depth <1-5>] [--limit <0-500>] [--include-heuristic] [--json | --pretty]",
+        }),
+    ],
+    [
+        "callers",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--include-heuristic"], [...SHARED_BUILD_OPTIONS, "--depth", "--limit"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph callers <symbol-target> [--root <path>] [--depth <1-5>] [--limit <0-500>] [--include-heuristic] [--json | --pretty]",
+        }),
+    ],
+    [
+        "subtypes",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--depth", "--limit"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph subtypes <symbol-target> [--root <path>] [--depth <1-10>] [--limit <0-500>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "supertypes",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS], [...SHARED_BUILD_OPTIONS, "--depth", "--limit"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph supertypes <symbol-target> [--root <path>] [--depth <1-10>] [--limit <0-500>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "skill",
+        commandSchema(["--force", "--json"], ["--agent", "--target"], {
+            kind: "max",
+            max: 2,
+            usage: "Usage: codegraph skill <install|print-path|doctor> [--agent <name> | --target <dir>] [--force] [--json]",
+        }),
+    ],
+    [
+        "status",
+        commandSchema([...STATUS_BUILD_FLAGS, "--json", "--pretty"], STATUS_BUILD_OPTIONS, {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph status [path] [--json | --pretty] OR codegraph status --root <path> [--json | --pretty]",
+        }),
+    ],
+    [
+        "sync",
+        commandSchema([...SHARED_BUILD_FLAGS, "--json", "--pretty", "--init", "--no-update-gitignore"], LIFECYCLE_BUILD_OPTIONS, {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph sync [path] [--init] [--no-update-gitignore] [--json | --pretty] OR codegraph sync --root <path> [--init] [--no-update-gitignore] [--json | --pretty]",
+        }),
+    ],
+    [
+        "sql",
+        commandSchema(["--json"], ["--db", "--query", "--sqlite"], {
+            kind: "max",
+            max: 2,
+            usage: 'Usage: codegraph sql <sqlite-path> "SELECT ..." [--json] OR codegraph sql --db <sqlite path> --query "SELECT ..." [--json]',
+        }),
+    ],
+    [
+        "uninit",
+        commandSchema(["--force", "--json", "--pretty"], ["--root"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph uninit [path] [--force] [--json | --pretty] OR codegraph uninit --root <path> [--force] [--json | --pretty]",
+        }),
+    ],
+    [
+        "viewer",
+        commandSchema(["--open", "--print-url"], ["--root", "--graph", "--host", "--port"], {
+            kind: "none",
+            usage: "Usage: codegraph viewer [--root <path>] [--graph <root-confined-json>] [--host <host>] [--port <0-65535>] [--open] [--print-url]",
+        }),
+    ],
+    [
+        "links",
+        commandSchema(["--verbose", ...JSON_OUTPUT_FLAGS], ["--root"], {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph links [project-root] [--root <path>] [--json | --pretty] [--verbose]",
+        }),
+    ],
+    [
+        "unresolved",
+        commandSchema([...SHARED_BUILD_FLAGS, ...JSON_OUTPUT_FLAGS, "--verbose"], SHARED_BUILD_OPTIONS, {
+            kind: "max",
+            max: 1,
+            usage: "Usage: codegraph unresolved [project-root] [--root <path>] [--json | --pretty]",
+        }),
+    ],
+    [
+        "version",
+        commandSchema(["--json", "--pretty"], [], {
+            kind: "none",
+            usage: "Usage: codegraph version [--json | --pretty]",
+        }),
+    ],
+]);
+function allowedFlagsForSchema(schema) {
+    return new Set(["--help", "-h", "--version", "-v", "--debug", ...(schema.flags ?? [])]);
+}
+function allowedOptionsForSchema(schema) {
+    return new Set(schema.options ?? []);
+}
+export function validateCliArgs(command, parsed) {
+    const schema = CLI_COMMAND_SCHEMAS.get(command);
+    if (!schema)
+        return;
+    const allowedFlags = allowedFlagsForSchema(schema);
+    for (const flag of parsed.flags) {
+        if (!allowedFlags.has(flag)) {
+            throw new Error(`Unknown option for ${command}: ${flag}`);
+        }
+    }
+    const allowedOptions = allowedOptionsForSchema(schema);
+    for (const option of parsed.options.keys()) {
+        if (!allowedOptions.has(option)) {
+            throw new Error(`Unknown option for ${command}: ${option}`);
+        }
+    }
+    if (parsed.flags.has("--progress") && parsed.flags.has("--no-progress")) {
+        throw new Error("--progress and --no-progress cannot be used together.");
+    }
+    if (command === "sync" && parsed.flags.has("--no-update-gitignore") && !parsed.flags.has("--init")) {
+        throw new Error("--no-update-gitignore for sync requires --init.");
+    }
+    if (schema.positionals.kind === "none" && parsed.positionals.length) {
+        throw new Error(`Unexpected positional argument for ${command}: ${parsed.positionals[0]}\n${schema.positionals.usage}`);
+    }
+    if (schema.positionals.kind === "max" && parsed.positionals.length > schema.positionals.max) {
+        const unexpected = parsed.positionals[schema.positionals.max];
+        throw new Error(`Unexpected positional argument for ${command}: ${unexpected}\n${schema.positionals.usage}`);
+    }
+}
+export function isCliValueOption(command, key, positionals) {
+    if (command === "artifact" && key === "--sqlite" && positionals[0] === "build")
+        return false;
+    if (command === "inspect" && key === "--duplicates")
+        return false;
+    return CLI_VALUE_OPTIONS.has(key);
+}
+export function parseCacheModeOption(rawValue) {
+    if (rawValue === undefined) {
+        return undefined;
+    }
+    if (rawValue === "off" || rawValue === "memory" || rawValue === "disk") {
+        return rawValue;
+    }
+    throw new Error(`Invalid --cache value "${rawValue}". Expected one of: off, memory, disk.`);
+}
+const STRICT_INTEGER_PATTERN = /^-?\d+$/;
+function parseIntegerOptionValue(rawValue, optionName, expectedDescription, minValue, maxValue) {
+    const trimmed = rawValue.trim();
+    if (!STRICT_INTEGER_PATTERN.test(trimmed)) {
+        throw new Error(`Invalid ${optionName} value "${rawValue}". Expected ${expectedDescription}.`);
+    }
+    const parsedValue = Number(trimmed);
+    const isAboveMinimum = parsedValue >= minValue;
+    const isBelowMaximum = maxValue === undefined || parsedValue <= maxValue;
+    if (!Number.isInteger(parsedValue) || !isAboveMinimum || !isBelowMaximum) {
+        throw new Error(`Invalid ${optionName} value "${rawValue}". Expected ${expectedDescription}.`);
+    }
+    return parsedValue;
+}
+export function parseSymbolGraphScopeOption(rawValue, optionName) {
+    if (rawValue === undefined)
+        return undefined;
+    if (rawValue === "all" || rawValue === "imported")
+        return rawValue;
+    throw new Error(`Invalid ${optionName} value "${rawValue}". Expected one of: all, imported.`);
+}
+export function parseRefContextOption(rawValue, optionName) {
+    if (rawValue === undefined)
+        return undefined;
+    if (rawValue === "line" || rawValue === "block")
+        return rawValue;
+    throw new Error(`Invalid ${optionName} value "${rawValue}". Expected one of: line, block.`);
+}
+export function parseImpactScopeOption(rawValue, optionName) {
+    return parseSymbolGraphScopeOption(rawValue, optionName);
+}
+function parseDefaultedIntegerOption(rawValue, optionName, defaultValue, expectedDescription, minValue, maxValue) {
+    if (rawValue === undefined) {
+        return defaultValue;
+    }
+    return parseIntegerOptionValue(rawValue, optionName, expectedDescription, minValue, maxValue);
+}
+function parseOptionalIntegerOption(rawValue, optionName, expectedDescription, minValue, maxValue) {
+    if (rawValue === undefined) {
+        return undefined;
+    }
+    return parseIntegerOptionValue(rawValue, optionName, expectedDescription, minValue, maxValue);
+}
+export function parsePositiveIntegerOption(rawValue, optionName, defaultValue) {
+    return parseDefaultedIntegerOption(rawValue, optionName, defaultValue, "a positive integer", 1);
+}
+export function parseOptionalPositiveIntegerOption(rawValue, optionName) {
+    return parseOptionalIntegerOption(rawValue, optionName, "a positive integer", 1);
+}
+export function parseNonNegativeIntegerOption(rawValue, optionName, defaultValue) {
+    return parseDefaultedIntegerOption(rawValue, optionName, defaultValue, "a non-negative integer", 0);
+}
+export function parseOptionalNonNegativeIntegerOption(rawValue, optionName) {
+    return parseOptionalIntegerOption(rawValue, optionName, "a non-negative integer", 0);
+}
+export function parseBoundedIntegerOption(rawValue, optionName, defaultValue, minValue, maxValue) {
+    return parseDefaultedIntegerOption(rawValue, optionName, defaultValue, `an integer from ${minValue} to ${maxValue}`, minValue, maxValue);
+}
+export function parseOptionalBoundedIntegerOption(rawValue, optionName, minValue, maxValue) {
+    return parseOptionalIntegerOption(rawValue, optionName, `an integer from ${minValue} to ${maxValue}`, minValue, maxValue);
+}
+//# sourceMappingURL=options.js.map