blitzreels 0.1.4 → 0.1.6

package/README.md

@@ -16,7 +16,6 @@ After the first real publish:
 ```bash
 npx blitzreels version
 npx blitzreels doctor
-npx blitzreels prime
 npx blitzreels agent-context --json
 npx blitzreels auth login
 ```
@@ -35,8 +34,9 @@ blitzreels auth set-key --api-key br_live_...
 blitzreels auth whoami
 ```
 
-`auth login` opens BlitzReels in your browser, asks you to approve a one-time
-CLI code, then stores the generated API key in macOS Keychain when available or
+`auth login` opens BlitzReels in your browser, shows the one-time CLI code, and
+waits for you to click `Connect CLI`. After confirmation, it stores the
+generated API key in macOS Keychain when available or
 `~/.blitzreels/config.json` as a fallback. Use `--no-browser` on remote shells
 and open the printed URL manually.
 
@@ -51,6 +51,13 @@ API keys are environment-bounded:
 blitzreels workspace settings get --json
 blitzreels workspace settings update --name "Creator Studio" --protected-words "Brand,Product"
 
+blitzreels onboarding scan start --website-url "https://example.com" --json
+blitzreels onboarding scan get --run-id RUN_ID --json
+blitzreels onboarding profile get --json
+blitzreels onboarding profile update --brand-name "Creator Studio" --protected-words "Brand,Product"
+blitzreels onboarding logo import --profile-id PROFILE_ID --replace-existing false
+blitzreels onboarding complete --brand-name "Creator Studio" --platforms tiktok,linkedin --save-workspace-icon true --json
+
 blitzreels projects list --status active --json
 blitzreels projects create --name "Launch short" --aspect-ratio 9:16
 blitzreels projects get --project-id PROJECT_ID --json
@@ -67,6 +74,7 @@ blitzreels media rename --asset-id ASSET_ID --name "New media name"
 blitzreels media update --asset-id ASSET_ID --description "B-roll" --folder-id FOLDER_ID
 blitzreels media move --asset-id ASSET_ID --target-folder-id FOLDER_ID
 blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --duration 4
+blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --duration 4 --placement-intent overlay
 blitzreels media attach --project-id PROJECT_ID --asset-id IMAGE_ID --at 6 --duration 1.6 --position-preset center --position-y -230 --width-px 561 --height-px 212 --animation-preset popIn
 blitzreels media folders list --json
 blitzreels media folders create --name "B-roll" --icon-type video
@@ -74,13 +82,15 @@ blitzreels media folders rename --folder-id FOLDER_ID --name "New folder name"
 blitzreels media folders update --folder-id FOLDER_ID --parent-folder-id root
 blitzreels media folders delete --folder-id FOLDER_ID --confirm-delete
 
-blitzreels clips create --source-type youtube --youtube-url "https://www.youtube.com/watch?v=..." --name "MKBHD hero loop" --min-duration 8 --max-duration 12 --qa-mode permissive
-blitzreels clips create --source-type asset --asset-id ASSET_ID --selection-mode time_range --start-seconds 52 --end-seconds 64 --max-duration 12
+blitzreels clips create --asset-id ASSET_ID --output ./clips
+blitzreels clips create --asset-id ASSET_ID --logo-asset-id LOGO_ASSET_ID --output ./clips --count 5
+blitzreels clips create --youtube-url "https://www.youtube.com/watch?v=..." --name "MKBHD hero loop"
 blitzreels clips get --clip-id CLIP_ID --json
 blitzreels clips wait --clip-id CLIP_ID --json
-blitzreels clips reselect --clip-id CLIP_ID --selection-mode time_range --start-seconds 52 --end-seconds 64 --min-duration 8 --max-duration 12
-blitzreels clips repair --clip-id CLIP_ID --repair-mode auto
-blitzreels clips export --clip-id CLIP_ID --resolution 1080p --format mp4 --allow-blocking-qa-bypass false
+blitzreels clips reselect --clip-id CLIP_ID --start-seconds 52 --end-seconds 64
+blitzreels clips reselect --clip-id CLIP_ID --suggestion-id SUGGESTION_ID
+blitzreels clips repair --clip-id CLIP_ID
+blitzreels clips export --clip-id CLIP_ID
 
 blitzreels project inspect --project-id PROJECT_ID --json
 blitzreels project timeline --project-id PROJECT_ID --json
@@ -103,13 +113,16 @@ blitzreels text update --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
 blitzreels text remove --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
 
 blitzreels audio search --query "ambient riser" --license cc0 --json
-blitzreels audio import --provider openverse --external-id AUDIO_ID --project-id PROJECT_ID --at 0 --duration 12 --volume 0.5
-blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.6
+blitzreels audio import --provider openverse --external-id AUDIO_ID --project-id PROJECT_ID --at 0 --duration 12 --volume 0.03
+blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.03
 
 blitzreels captions words list --project-id PROJECT_ID --match-text "Supabase" --json
 blitzreels captions words text --project-id PROJECT_ID --word-id WORD_ID --text "Supabase"
+blitzreels captions words update --project-id PROJECT_ID --word-id WORD_ID --text "Supabase"
 blitzreels captions words batch-text --project-id PROJECT_ID --updates-json '[{"word_id":"WORD_ID","new_text":"Supabase"}]'
+blitzreels captions words batch-text --project-id PROJECT_ID --updates-file caption-updates.json
 blitzreels captions words style --project-id PROJECT_ID --word-id WORD_ID --font-family Pacifico --color "#17FFA6" --scale 1.45
+blitzreels captions words style --project-id PROJECT_ID --all --style-file caption-word-style.json
 blitzreels captions words emphasis --project-id PROJECT_ID --match-text "MCP" --emphasis true
 blitzreels captions words delete --project-id PROJECT_ID --word-id WORD_ID
 blitzreels captions words merge --project-id PROJECT_ID --word-ids WORD_ID_1,WORD_ID_2 --text "serveurs MCP"
@@ -121,42 +134,56 @@ blitzreels silence apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITE
 blitzreels mistakes plan --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --json
 blitzreels mistakes apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --confirm-preview
 
-blitzreels captions themes list --json
-blitzreels captions theme set --project-id PROJECT_ID --theme-id THEME_ID
-blitzreels captions theme set-default --theme-id THEME_ID
+blitzreels captions looks list --json
+blitzreels captions look set --project-id PROJECT_ID --look-id editor-premium-lime
+blitzreels captions style update --project-id PROJECT_ID --look-id paper-karaoke --text-stroke-enabled false
 
-blitzreels exports start --project-id PROJECT_ID
+blitzreels exports start --project-id PROJECT_ID --cover-frame-seconds 1
 blitzreels exports wait --export-id EXPORT_ID
 blitzreels exports download --export-id EXPORT_ID --output ./short.mp4
 
+blitzreels formats run --format video-model-benchmark \
+  --prompt "A red figure walks toward a circular platform under a deep blue night sky" \
+  --left-model wan-2.1 --right-model krea-wan-14b-t2v --confirm-cost
+blitzreels jobs get --job-id JOB_ID --json
+
 blitzreels api docs
 blitzreels api spec
 ```
 
 Use `--json` for script and AI-agent workflows.
 Use `--fields id,name` with `--json` to trim large responses.
+Export status responses include `thumbnail_url`, `thumbnail.frame_seconds`, `thumbnail.rationale`, and first-pass `platform_metadata` suggestions for YouTube, TikTok, and Instagram.
+Onboarding scan responses include `run_id`, `status`, optional `profile`, and `next_actions`; poll the run before completing onboarding. Mutating onboarding commands support `--dry-run`.
 
-## Agent Workflows
+## Machine-Readable Contract
 
 ```bash
-blitzreels prime
-blitzreels prime --command "media attach"
 blitzreels agent-context --json
 blitzreels agent-context --command "media attach" --json
+blitzreels agent-context --full --json
 blitzreels schema --command "captions words style" --json
 blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 6 --dry-run
 ```
 
-`prime` prints plain-language instructions that coding agents should read before
-editing BlitzReels projects. It is inspired by agent-first CLIs like Beans'
-`prime` command. `llms` is an alias.
+`agent-context --json` is the compact machine-readable command index. It lists
+stable operation IDs and command names, plus write and destructive operation ID
+sets. Use `--command` for one detailed contract with typed flags, defaults,
+examples, safety markers, and known errors. Use `--full` only for compatibility
+or bulk tooling that explicitly needs every detailed command contract.
 
-`agent-context` is the machine-readable command contract for agents. It includes
-command metadata, typed flags, examples, read/write markers, destructive markers,
-and known error categories.
+Agent workflow strategy lives in BlitzReels skills and docs, not in CLI command
+metadata or normal command output.
 
-When the CLI detects an agent environment, command help also points agents to
-`prime` and `agent-context` for the focused command.
+Retry project, clip-batch, and export creation safely with a stable key:
+
+```bash
+blitzreels projects create --name "Launch clips" --idempotency-key project:launch-clips:v1
+blitzreels clips create --asset-id ASSET_ID --idempotency-key clips:ASSET_ID:v1
+blitzreels exports start --project-id PROJECT_ID --idempotency-key export:PROJECT_ID:1080p:v1
+```
+
+Reuse a key only with identical inputs. A changed request returns a conflict.
 
 `--dry-run` is available on mutating commands and prints the API request that
 would be made without making the write request. Destructive dry-runs still require
@@ -202,5 +229,8 @@ With `--json`, errors are structured on stderr:
 }
 ```
 
+Plan-limit failures use `upgrade_required`, exit code `3`, and include an
+`upgrade_url`. Human output prints the same billing link after the error.
+
 Use `blitzreels <command> --help` for command-specific flags without requiring
 auth.

package/dist/agent-context.d.ts

@@ -0,0 +1,68 @@
+import { type SequenceOperationId } from "@blitzreels/sdk";
+import { type CliExitCode } from "./cli-errors.js";
+import type { CommandSpec, FlagSpec } from "./command-metadata.js";
+export type AgentContext = {
+    schema_version: "1";
+    cli: {
+        name: "blitzreels";
+        version: string;
+        default_base_url: string;
+        exit_codes: Array<{
+            code: CliExitCode;
+            meaning: string;
+            retryable: boolean;
+        }>;
+    };
+    sequence_error_codes: string[];
+    sequence_error_contract: "/api/capabilities.json#error_contract";
+    commands: Array<{
+        operation_id: string;
+        command: string;
+        category: string;
+        description: string;
+        usage: string;
+        mutates: boolean;
+        destructive: boolean;
+        requires_auth: boolean;
+        dry_run_supported: boolean;
+        kernel_operation_ids: readonly SequenceOperationId[];
+        flags: readonly FlagSpec[];
+        examples: readonly string[];
+        errors: Array<{
+            code: string;
+            description: string;
+            exit_code: CliExitCode;
+            retryable: boolean;
+        }>;
+    }>;
+};
+export type AgentContextIndex = {
+    schema_version: "2";
+    mode: "index";
+    cli: {
+        name: "blitzreels";
+        version: string;
+    };
+    command_count: number;
+    detail_command: string;
+    full_command: string;
+    write_operation_ids: string[];
+    destructive_operation_ids: string[];
+    commands: Array<{
+        operation_id: string;
+        command: string;
+    }>;
+};
+export type AgentContextResult = AgentContext | AgentContextIndex;
+export declare function buildAgentContextIndex({ commandSpecs, }: {
+    commandSpecs: CommandSpec[];
+}): AgentContextIndex;
+export declare function buildAgentContext({ commandFilter, commandSpecs, surfaceName, }: {
+    commandFilter: string | undefined;
+    commandSpecs: CommandSpec[];
+    surfaceName?: string;
+}): AgentContext;
+export declare function buildAgentContextLines({ value, }: {
+    value: AgentContextResult;
+}): string[];
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQnE,MAAM,MAAM,YAAY,GAAG;IACzB,cAAc,EAAE,GAAG,CAAC;IACpB,GAAG,EAAE;QACH,IAAI,EAAE,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,WAAW,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;IACF,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,uBAAuB,EAAE,uCAAuC,CAAC;IACjE,QAAQ,EAAE,KAAK,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,CAAC;QACrD,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;QAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,WAAW,CAAC;YACvB,SAAS,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,GAAG,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE;QACH,IAAI,EAAE,YAAY,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,QAAQ,EAAE,KAAK,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAElE,wBAAgB,sBAAsB,CAAC,EACrC,YAAY,GACb,EAAE;IACD,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,GAAG,iBAAiB,CA6BpB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,YAAY,EACZ,WAA6B,GAC9B,EAAE;IACD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,YAAY,CA+Cf;AAED,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,GACN,EAAE;IACD,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GAAG,MAAM,EAAE,CAaX"}

package/dist/agent-context.js

@@ -0,0 +1,214 @@
+import { SEQUENCE_OPERATION_ERROR_DEFINITIONS, } from "@blitzreels/sdk";
+import { CliUsageError } from "./cli-errors.js";
+import { CLI_VERSION, DEFAULT_BASE_URL } from "./cli-runtime.js";
+import { commandLabel, commandsEqual, flagsForCommand, suggestCommandSpecs, } from "./command-metadata.js";
+export function buildAgentContextIndex({ commandSpecs, }) {
+    const operations = commandSpecs.map((spec) => ({
+        operation_id: operationIdForCommand({ command: spec.command }),
+        command: commandLabel({ command: spec.command }),
+        mutates: spec.mutates,
+        destructive: spec.destructive,
+    }));
+    return {
+        schema_version: "2",
+        mode: "index",
+        cli: {
+            name: "blitzreels",
+            version: CLI_VERSION,
+        },
+        command_count: operations.length,
+        detail_command: 'blitzreels agent-context --command "COMMAND" --json',
+        full_command: "blitzreels agent-context --full --json",
+        write_operation_ids: operations
+            .filter((operation) => operation.mutates)
+            .map((operation) => operation.operation_id),
+        destructive_operation_ids: operations
+            .filter((operation) => operation.destructive)
+            .map((operation) => operation.operation_id),
+        commands: operations.map((operation) => ({
+            operation_id: operation.operation_id,
+            command: operation.command,
+        })),
+    };
+}
+export function buildAgentContext({ commandFilter, commandSpecs, surfaceName = "agent-context", }) {
+    const commands = commandFilter
+        ? commandSpecs.filter((spec) => commandsEqual(spec.command, splitCommandFilter({ value: commandFilter })))
+        : commandSpecs;
+    if (commandFilter && commands.length === 0) {
+        throw new CliUsageError({
+            code: "unknown_command",
+            message: `Unknown command for ${surfaceName}: ${commandFilter}`,
+            suggestions: suggestCommandSpecs({
+                command: splitCommandFilter({ value: commandFilter }),
+                specs: commandSpecs,
+            }).map((spec) => commandLabel({ command: spec.command })),
+        });
+    }
+    return {
+        schema_version: "1",
+        cli: {
+            name: "blitzreels",
+            version: CLI_VERSION,
+            default_base_url: DEFAULT_BASE_URL,
+            exit_codes: buildCliExitCodeContract(),
+        },
+        sequence_error_codes: SEQUENCE_OPERATION_ERROR_DEFINITIONS.map((definition) => definition.code),
+        sequence_error_contract: "/api/capabilities.json#error_contract",
+        commands: commands.map((spec) => ({
+            operation_id: operationIdForCommand({ command: spec.command }),
+            command: commandLabel({ command: spec.command }),
+            category: spec.command[0] ?? "unknown",
+            description: spec.description,
+            usage: spec.usage,
+            mutates: spec.mutates,
+            destructive: spec.destructive,
+            requires_auth: spec.requiresAuth,
+            dry_run_supported: spec.dryRunSupported,
+            kernel_operation_ids: spec.kernelOperationIds,
+            flags: flagsForCommand({ spec, includeHidden: true }),
+            examples: spec.examples,
+            errors: buildCommandErrors({ spec }),
+        })),
+    };
+}
+export function buildAgentContextLines({ value, }) {
+    if (value.schema_version === "2") {
+        const writeOperations = new Set(value.write_operation_ids);
+        const destructiveOperations = new Set(value.destructive_operation_ids);
+        return value.commands.map((command) => `${command.command} ${writeOperations.has(command.operation_id) ? "write" : "read"}${destructiveOperations.has(command.operation_id) ? " destructive" : ""}`);
+    }
+    return value.commands.map((command) => `${command.command} ${command.mutates ? "write" : "read"}${command.destructive ? " destructive" : ""}${command.dry_run_supported ? " dry-run" : ""} - ${command.description}`);
+}
+function splitCommandFilter({ value }) {
+    return value
+        .trim()
+        .split(/\s+/)
+        .filter((part) => part.length > 0);
+}
+function buildCommandErrors({ spec }) {
+    const errors = [
+        {
+            code: "unknown_command",
+            description: "Command is not registered.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "unknown_flag",
+            description: "Flag is not accepted by command.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "missing_required_flag",
+            description: "A required flag was not provided.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "invalid_flag_value",
+            description: "A flag value could not be parsed.",
+            exit_code: 2,
+            retryable: false,
+        },
+        {
+            code: "cli_error",
+            description: "Input or local execution failed.",
+            exit_code: 1,
+            retryable: false,
+        },
+    ];
+    if (spec.requiresAuth) {
+        errors.push({
+            code: "api_error",
+            description: "BlitzReels API returned a non-2xx response.",
+            exit_code: 1,
+            retryable: false,
+        });
+        errors.push({
+            code: "auth_error",
+            description: "Authentication or permission failed.",
+            exit_code: 3,
+            retryable: false,
+        });
+        errors.push({
+            code: "upgrade_required",
+            description: "The workspace plan limit was reached. Open the returned upgrade_url.",
+            exit_code: 3,
+            retryable: false,
+        });
+        errors.push({
+            code: "not_found",
+            description: "Requested BlitzReels resource was not found.",
+            exit_code: 4,
+            retryable: false,
+        });
+        errors.push({
+            code: "conflict",
+            description: "Requested operation conflicted with current project state.",
+            exit_code: 5,
+            retryable: false,
+        });
+        errors.push({
+            code: "rate_limited",
+            description: "Request was rate limited.",
+            exit_code: 6,
+            retryable: true,
+        });
+        errors.push({
+            code: "server_error",
+            description: "BlitzReels API returned a transient server error.",
+            exit_code: 7,
+            retryable: true,
+        });
+    }
+    if (spec.mutates && !spec.dryRunSupported) {
+        errors.push({
+            code: "unsupported_dry_run",
+            description: "--dry-run was used on a command that cannot preview.",
+            exit_code: 2,
+            retryable: false,
+        });
+    }
+    if (spec.destructive) {
+        errors.push({
+            code: "missing_confirmation",
+            description: "Required destructive confirmation flag was not provided.",
+            exit_code: 2,
+            retryable: false,
+        });
+    }
+    return errors;
+}
+function operationIdForCommand({ command }) {
+    const [first = "unknown", ...rest] = command;
+    return [
+        first,
+        ...rest.map((part) => part.replace(/-([a-z0-9])/g, (_match, value) => value.toUpperCase())),
+    ].join(".");
+}
+function buildCliExitCodeContract() {
+    return [
+        { code: 1, meaning: "Local or generic API failure.", retryable: false },
+        {
+            code: 2,
+            meaning: "Usage error: command, flag, or input is invalid.",
+            retryable: false,
+        },
+        {
+            code: 3,
+            meaning: "Authentication or permission failure.",
+            retryable: false,
+        },
+        { code: 4, meaning: "Requested resource was not found.", retryable: false },
+        {
+            code: 5,
+            meaning: "Conflict with current server state.",
+            retryable: false,
+        },
+        { code: 6, meaning: "Rate limited; retry after backoff.", retryable: true },
+        { code: 7, meaning: "Transient server/provider failure.", retryable: true },
+    ];
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/agent-context.js.map

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

package/dist/cli-command-routing.d.ts

@@ -0,0 +1,27 @@
+import { CliUsageError } from "./cli-errors.js";
+import type { ParsedArgs } from "./cli-types.js";
+import { type CommandSpec } from "./command-metadata.js";
+export declare function parseArgs({ argv }: {
+    argv: string[];
+}): ParsedArgs;
+export declare function validateParsedArgs({ parsed }: {
+    parsed: ParsedArgs;
+}): void;
+export declare function validateSafeInputs({ parsed }: {
+    parsed: ParsedArgs;
+}): void;
+export declare function findCommandSpec({ command, }: {
+    command: string[];
+}): CommandSpec | undefined;
+export declare function findGroupCommandSpecs({ command, }: {
+    command: string[];
+}): CommandSpec[];
+export declare function printCommandOrGroupHelpOrThrow({ command, }: {
+    command: string[];
+}): void;
+export declare function printHelp(): void;
+export declare function buildUnknownCommandError({ command, }: {
+    command: string[];
+}): CliUsageError;
+export declare function usageForCurrentCommand(): string | undefined;
+//# sourceMappingURL=cli-command-routing.d.ts.map

package/dist/cli-command-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-routing.d.ts","sourceRoot":"","sources":["../src/cli-command-routing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,KAAK,WAAW,EAOjB,MAAM,uBAAuB,CAAC;AAG/B,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,UAAU,CAiClE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAwB3E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAgB3E;AAED,wBAAgB,eAAe,CAAC,EAC9B,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,WAAW,GAAG,SAAS,CAE1B;AAED,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,WAAW,EAAE,CAOhB;AAED,wBAAgB,8BAA8B,CAAC,EAC7C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,IAAI,CAYP;AAED,wBAAgB,SAAS,IAAI,IAAI,CAWhC;AAED,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,aAAa,CAQhB;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAG3D"}