@boxes-dev/dvb-runtime 1.0.297 → 1.0.299

package/dist/devbox/commandRegistry/catalog.js

@@ -1,763 +0,0 @@
-const arg = (name, description, options = {}) => ({
-    name,
-    description,
-    required: options.required ?? true,
-    ...(options.completion ? { completion: options.completion } : {}),
-});
-const flag = (long, description, options = {}) => ({
-    long,
-    description,
-    ...(options.short ? { short: options.short } : {}),
-    ...(options.valueName ? { valueName: options.valueName } : {}),
-});
-export const CLI_ROOT_COMMAND = {
-    name: "dvb",
-    summary: "boxes.dev command-line interface",
-    usage: [
-        "dvb <command> [options]",
-        "dvb <command> <subcommand> [options]",
-        "dvb --version",
-    ],
-    notes: ["Use `dvb <command> --help` for command-specific help."],
-    children: [
-        {
-            name: "setup",
-            category: "Account",
-            summary: "Configure auth + org",
-            usage: [
-                "dvb setup [--sprite-token <token> | --token <token>] [--claude-code-oauth-token <token>] [--no-claude-auth] [--org <slug>] [--codex-auth <proxy|byo>] [--sprite-auth <default|byo>] [--modal-auth <default|byo>] [--modal-token-id <id>] [--modal-token-secret <secret>] [--no-verify] [--json]",
-            ],
-            options: [
-                flag("token", "Sprites API token", { valueName: "token" }),
-                flag("sprite-token", "Sprites API token", { valueName: "token" }),
-                flag("claude-code-oauth-token", "Claude Code setup token", {
-                    valueName: "token",
-                }),
-                flag("no-claude-auth", "Skip Claude setup-token status and prompts for this run"),
-                flag("org", "Sprites org slug", { valueName: "slug" }),
-                flag("codex-auth", "Codex auth mode", { valueName: "proxy|byo" }),
-                flag("sprite-auth", "Sprite auth mode", {
-                    valueName: "default|byo",
-                }),
-                flag("modal-auth", "Modal auth mode", {
-                    valueName: "default|byo",
-                }),
-                flag("modal-token-id", "Modal BYO token id", { valueName: "id" }),
-                flag("modal-token-secret", "Modal BYO token secret", {
-                    valueName: "secret",
-                }),
-                flag("no-verify", "Skip token verification"),
-                flag("json", "Output JSON"),
-            ],
-            notes: [
-                "Interactive setup requires local `codex` and offers to install it with `npm install -g @openai/codex --loglevel=error` when missing.",
-                "If local `claude` is installed, interactive setup offers Claude Code onboarding through `claude setup-token`.",
-            ],
-            examples: ["dvb setup", "dvb setup --json"],
-        },
-        {
-            name: "whoami",
-            category: "Account",
-            summary: "Show current signed-in user",
-            usage: ["dvb whoami [--json]"],
-            options: [flag("json", "Output JSON")],
-        },
-        {
-            name: "logout",
-            category: "Account",
-            summary: "Log out from dvb locally",
-            usage: ["dvb logout [--json]"],
-            options: [flag("json", "Output JSON")],
-        },
-        {
-            name: "uninstall",
-            category: "Account",
-            summary: "Remove local devbox state",
-            usage: ["dvb uninstall [--dry-run] [--yes] [--json]"],
-            options: [
-                flag("dry-run", "Preview cleanup actions"),
-                flag("yes", "Skip confirmation"),
-                flag("json", "Output JSON"),
-            ],
-        },
-        {
-            name: "init",
-            category: "Devboxes",
-            summary: "Create a devbox and upload repo",
-            usage: [
-                "dvb init [--alias <alias>] [--compute <provider>] [--force] [--yes] [--resume] [--status] [--json]",
-            ],
-            options: [
-                flag("alias", "Alias for the devbox", { valueName: "alias" }),
-                flag("compute", "Compute provider", {
-                    valueName: "provider",
-                }),
-                flag("force", "Force provisioning"),
-                flag("yes", "Skip force destroy confirmation"),
-                flag("resume", "Resume a previous init"),
-                flag("status", "Show init status and checkpoint info"),
-                flag("json", "Output JSON"),
-            ],
-            notes: [
-                "`dvb init --status` and `dvb init --resume` are mode switches, not subcommands.",
-                "`dvb init` provisions the default managed devbox path and uses provider-native state capture where available.",
-            ],
-        },
-        {
-            name: "list",
-            category: "Devboxes",
-            summary: "List devboxes",
-            usage: ["dvb list [--json]"],
-            options: [flag("json", "Output JSON")],
-        },
-        {
-            name: "connect",
-            category: "Devboxes",
-            summary: "Attach to a devbox session",
-            usage: [
-                "dvb connect [<box>[/<session>]] [-n <name>] [--command <cmd>] [--detach] [--no-log]",
-            ],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "connectTargets",
-                }),
-            ],
-            options: [
-                flag("name", "Explicit session name", {
-                    short: "n",
-                    valueName: "name",
-                }),
-                flag("command", "Run a command instead of a shell", {
-                    valueName: "cmd",
-                }),
-                flag("detach", "Detach from session"),
-                flag("no-log", "Disable session logging"),
-            ],
-        },
-        {
-            name: "cp",
-            category: "Devboxes",
-            summary: "Copy a local file or directory to a devbox",
-            usage: ["dvb cp <src> <box>:<dest> [-r|--recursive] [--json]"],
-            arguments: [
-                arg("src", "Local source file or directory"),
-                arg("dest", "Remote destination (<box>:<path>)"),
-            ],
-            options: [
-                flag("recursive", "Copy a directory recursively", { short: "r" }),
-                flag("json", "Output JSON"),
-            ],
-            notes: [
-                "Relative remote paths resolve against the remote project workdir.",
-                "Destination paths ending in `/` keep the local source basename.",
-            ],
-            examples: ["dvb cp .env my-box:", "dvb cp -r assets my-box:public/"],
-        },
-        {
-            name: "codex",
-            category: "Devboxes",
-            summary: "Start or resume a Codex session",
-            usage: [
-                "dvb codex [<box>] [--resume [<session-id>]]",
-                "dvb codex list [<box>]",
-                "dvb codex resume <session-id> [<box>]",
-            ],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [
-                flag("resume", "Resume a Codex session", { valueName: "session-id" }),
-            ],
-            children: [
-                {
-                    name: "list",
-                    summary: "List Codex sessions",
-                    usage: ["dvb codex list [<box>]"],
-                    arguments: [
-                        arg("box", "Target devbox alias", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                    ],
-                },
-                {
-                    name: "resume",
-                    summary: "Resume a Codex session by id",
-                    usage: ["dvb codex resume <session-id> [<box>]"],
-                    arguments: [
-                        arg("session-id", "Codex session id"),
-                        arg("box", "Target devbox alias", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "claude",
-            category: "Devboxes",
-            summary: "Start a Claude session",
-            usage: ["dvb claude [<box>] [--resume [<session-id>]]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [
-                flag("resume", "Resume a Claude session", { valueName: "session-id" }),
-            ],
-        },
-        {
-            name: "sessions",
-            category: "Devboxes",
-            summary: "List or manage sessions",
-            usage: [
-                "dvb sessions [<box>] [--json]",
-                "dvb sessions rename <session> -n <name>",
-                "dvb sessions rename <box>/<session> -n <name>",
-                "dvb sessions kill <session>",
-                "dvb sessions kill <box>/<session>",
-            ],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [flag("json", "Output JSON")],
-            children: [
-                {
-                    name: "rename",
-                    summary: "Rename a session",
-                    usage: [
-                        "dvb sessions rename <session> -n <name>",
-                        "dvb sessions rename <box>/<session> -n <name>",
-                    ],
-                    arguments: [
-                        arg("target", "Session name or <box>/<session>", {
-                            completion: "boxSessionNames",
-                        }),
-                    ],
-                    options: [
-                        flag("name", "New session name", {
-                            short: "n",
-                            valueName: "name",
-                        }),
-                    ],
-                },
-                {
-                    name: "kill",
-                    summary: "Kill a session",
-                    usage: [
-                        "dvb sessions kill <session>",
-                        "dvb sessions kill <box>/<session>",
-                    ],
-                    arguments: [
-                        arg("target", "Session name/id or <box>/<session>", {
-                            completion: "sessionTargets",
-                        }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "services",
-            category: "Devboxes",
-            summary: "Manage devbox services",
-            usage: [
-                "dvb services [<box>] [--json]",
-                "dvb services enable [<box>:]<service>",
-                "dvb services start [<box>:]<service>",
-                "dvb services stop [<box>:]<service>",
-                "dvb services logs [<box>:]<service>",
-                "dvb services add [<box>:]<name> --cmd '<cmd>' [--needs <service>] [--http-port <port>]",
-                "dvb services disable [<box>:]<service>",
-                "dvb services export [<box>[:service]]",
-            ],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [flag("json", "Output JSON")],
-            children: [
-                {
-                    name: "enable",
-                    summary: "Enable a service",
-                    usage: ["dvb services enable [<box>:]<service>"],
-                    arguments: [
-                        arg("target", "Service target", { completion: "serviceTargets" }),
-                    ],
-                },
-                {
-                    name: "start",
-                    summary: "Start a service",
-                    usage: ["dvb services start [<box>:]<service>"],
-                    arguments: [
-                        arg("target", "Service target", { completion: "serviceTargets" }),
-                    ],
-                },
-                {
-                    name: "stop",
-                    summary: "Stop a service",
-                    usage: ["dvb services stop [<box>:]<service>"],
-                    arguments: [
-                        arg("target", "Service target", { completion: "serviceTargets" }),
-                    ],
-                },
-                {
-                    name: "logs",
-                    summary: "Show service logs",
-                    usage: ["dvb services logs [<box>:]<service>"],
-                    arguments: [
-                        arg("target", "Service target", { completion: "serviceTargets" }),
-                    ],
-                },
-                {
-                    name: "add",
-                    summary: "Add a service",
-                    usage: [
-                        "dvb services add [<box>:]<name> --cmd '<cmd>' [--needs <service>] [--http-port <port>]",
-                    ],
-                    arguments: [
-                        arg("target", "Service target", { completion: "serviceTargets" }),
-                    ],
-                    options: [
-                        flag("cmd", "Service command", { valueName: "cmd" }),
-                        flag("needs", "Service dependency", { valueName: "service" }),
-                        flag("http-port", "HTTP port", { valueName: "port" }),
-                    ],
-                },
-                {
-                    name: "disable",
-                    summary: "Disable a service",
-                    usage: ["dvb services disable [<box>:]<service>"],
-                    arguments: [
-                        arg("target", "Service target", { completion: "serviceTargets" }),
-                    ],
-                },
-                {
-                    name: "export",
-                    summary: "Export service config",
-                    usage: ["dvb services export [<box>[:service]]"],
-                    arguments: [
-                        arg("target", "Devbox alias or <box>:<service>", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "ports",
-            category: "Devboxes",
-            summary: "Manage port forwarding",
-            usage: [
-                "dvb ports [--json] [--box <box>]",
-                "dvb ports [<box>]",
-                "dvb ports stop [<box>] <port|range> [port|range...]",
-                "dvb ports fwd [<box>] <port|range> [port|range...]",
-            ],
-            options: [
-                flag("json", "Output JSON"),
-                flag("box", "Target devbox", { valueName: "box" }),
-            ],
-            children: [
-                {
-                    name: "stop",
-                    summary: "Disable forwarding",
-                    usage: ["dvb ports stop [<box>] <port|range> [port|range...]"],
-                    arguments: [
-                        arg("box", "Target devbox alias", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                        arg("port|range", "Port or inclusive port range", {
-                            required: false,
-                        }),
-                    ],
-                },
-                {
-                    name: "fwd",
-                    summary: "Enable forwarding",
-                    usage: ["dvb ports fwd [<box>] <port|range> [port|range...]"],
-                    arguments: [
-                        arg("box", "Target devbox alias", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                        arg("port|range", "Port or inclusive port range", {
-                            required: false,
-                        }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "destroy",
-            category: "Devboxes",
-            summary: "Destroy a devbox",
-            usage: ["dvb destroy [<box>] [--force] [--json]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [
-                flag("force", "Skip confirmation"),
-                flag("json", "Output JSON"),
-            ],
-        },
-        {
-            name: "checkpoint",
-            category: "Devboxes",
-            summary: "Capture a devbox checkpoint",
-            usage: ["dvb checkpoint [<box>] [--comment <text>] [--json]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [
-                flag("comment", "Optional checkpoint note", {
-                    valueName: "text",
-                }),
-                flag("json", "Output JSON"),
-            ],
-            notes: [
-                "Currently supported for checkpoint-enabled devboxes only.",
-                "Captures a fresh checkpoint and stores it as the latest recorded restore point for later `dvb fork` restores.",
-            ],
-        },
-        {
-            name: "fork",
-            category: "Devboxes",
-            summary: "Clone a devbox from its latest checkpoint",
-            usage: ["dvb fork [<box>] --alias <alias> [--json]"],
-            arguments: [
-                arg("box", "Source devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [
-                flag("alias", "Alias for the restored devbox", {
-                    valueName: "alias",
-                }),
-                flag("json", "Output JSON"),
-            ],
-            notes: [
-                "Currently supported for checkpoint-enabled devboxes only.",
-                "Creates a new devbox from the latest recorded checkpoint of the source devbox.",
-            ],
-        },
-        {
-            name: "sleep",
-            category: "Devboxes",
-            summary: "Put a managed devbox to sleep",
-            usage: ["dvb sleep [<box>] [--json]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [flag("json", "Output JSON")],
-            notes: [
-                "Currently supported for pause-enabled devboxes only.",
-                "Uses the provider-managed sleep lifecycle and preserves the devbox state for wake.",
-            ],
-        },
-        {
-            name: "wake",
-            category: "Devboxes",
-            summary: "Wake a managed devbox",
-            usage: ["dvb wake [<box>] [--json]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [flag("json", "Output JSON")],
-            notes: [
-                "Currently supported for pause-enabled devboxes only.",
-                "Uses the provider-managed wake path and refreshes the devbox timeout.",
-            ],
-        },
-        {
-            name: "reboot",
-            category: "Devboxes",
-            summary: "Reboot a modal devbox from a filesystem snapshot",
-            usage: ["dvb reboot [<box>] [--json]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [flag("json", "Output JSON")],
-        },
-        {
-            name: "reset",
-            category: "Devboxes",
-            summary: "Reset an E2B devbox runtime",
-            usage: ["dvb reset [<box>] [--json]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-            options: [flag("json", "Output JSON")],
-            notes: [
-                "Currently supported for running E2B devboxes only.",
-                "Kills user-initiated runtime state without rebooting or changing filesystem state.",
-            ],
-        },
-        {
-            name: "ide",
-            category: "Devboxes",
-            summary: "Configure remote IDE access",
-            usage: [
-                "dvb ide setup [<box>] [--all] [--json]",
-                "dvb ide doctor [<box>] [--all] [--editor <vscode|jetbrains|all>] [--json]",
-                "dvb ide open <box> --editor <vscode|jetbrains> [--path <remote-path>] [--ide <jetbrains-ide>]",
-            ],
-            children: [
-                {
-                    name: "setup",
-                    summary: "Configure IDE SSH access",
-                    usage: ["dvb ide setup [<box>] [--all] [--json]"],
-                    arguments: [
-                        arg("box", "Target devbox alias", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                    ],
-                    options: [
-                        flag("all", "Configure all devboxes"),
-                        flag("json", "Output JSON"),
-                    ],
-                },
-                {
-                    name: "doctor",
-                    summary: "Check IDE prerequisites",
-                    usage: [
-                        "dvb ide doctor [<box>] [--all] [--editor <vscode|jetbrains|all>] [--json]",
-                    ],
-                    arguments: [
-                        arg("box", "Target devbox alias", {
-                            required: false,
-                            completion: "boxes",
-                        }),
-                    ],
-                    options: [
-                        flag("all", "Check all devboxes"),
-                        flag("editor", "Editor target", {
-                            valueName: "vscode|jetbrains|all",
-                        }),
-                        flag("json", "Output JSON"),
-                    ],
-                },
-                {
-                    name: "open",
-                    summary: "Open a devbox in an IDE",
-                    usage: [
-                        "dvb ide open <box> --editor <vscode|jetbrains> [--path <remote-path>] [--ide <jetbrains-ide>]",
-                    ],
-                    arguments: [
-                        arg("box", "Target devbox alias", { completion: "boxes" }),
-                    ],
-                    options: [
-                        flag("editor", "Editor target", {
-                            valueName: "vscode|jetbrains",
-                        }),
-                        flag("ide", "JetBrains IDE hint for Toolbox", {
-                            valueName: "jetbrains-ide",
-                        }),
-                        flag("path", "Absolute remote path", { valueName: "remote-path" }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "ssh",
-            category: "Devboxes",
-            summary: "Managed SSH helpers",
-            usage: ["dvb ssh proxy <box> [--port <port>]"],
-            children: [
-                {
-                    name: "proxy",
-                    summary: "Open the managed SSH proxy",
-                    usage: ["dvb ssh proxy <box> [--port <port>]"],
-                    arguments: [
-                        arg("box", "Target devbox alias", { completion: "boxes" }),
-                    ],
-                    options: [
-                        flag("port", "Remote SSH port override", { valueName: "port" }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "mount",
-            category: "Devboxes",
-            summary: "Mount a devbox",
-            usage: ["dvb mount [<box>]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-        },
-        {
-            name: "unmount",
-            category: "Devboxes",
-            summary: "Unmount a devbox",
-            usage: ["dvb unmount [<box>]"],
-            arguments: [
-                arg("box", "Target devbox alias", {
-                    required: false,
-                    completion: "boxes",
-                }),
-            ],
-        },
-        {
-            name: "daemon",
-            category: "System",
-            summary: "Manage the local daemon",
-            usage: [
-                "dvb daemon status [--json]",
-                "dvb daemon stop [--json]",
-                "dvb daemon restart [--json]",
-            ],
-            children: [
-                {
-                    name: "status",
-                    summary: "Show daemon status",
-                    usage: ["dvb daemon status [--json]"],
-                    options: [flag("json", "Output JSON")],
-                },
-                {
-                    name: "stop",
-                    summary: "Stop daemon",
-                    usage: ["dvb daemon stop [--json]"],
-                    options: [flag("json", "Output JSON")],
-                },
-                {
-                    name: "restart",
-                    summary: "Restart daemon",
-                    usage: ["dvb daemon restart [--json]"],
-                    options: [flag("json", "Output JSON")],
-                },
-            ],
-        },
-        {
-            name: "completions",
-            category: "System",
-            summary: "Manage shell completions",
-            usage: [
-                "dvb completions status",
-                "dvb completions install [--shell <bash|zsh|fish>]",
-                "dvb completions uninstall [--shell <bash|zsh|fish>]",
-                "dvb completions generate <bash|zsh|fish>",
-            ],
-            children: [
-                {
-                    name: "status",
-                    summary: "Show completion status",
-                    usage: ["dvb completions status"],
-                },
-                {
-                    name: "install",
-                    summary: "Install completions",
-                    usage: ["dvb completions install [--shell <bash|zsh|fish>]"],
-                    options: [
-                        flag("shell", "Shell to install for", {
-                            short: "s",
-                            valueName: "bash|zsh|fish",
-                        }),
-                    ],
-                },
-                {
-                    name: "uninstall",
-                    summary: "Remove completions",
-                    usage: ["dvb completions uninstall [--shell <bash|zsh|fish>]"],
-                    options: [
-                        flag("shell", "Shell to uninstall", {
-                            short: "s",
-                            valueName: "bash|zsh|fish",
-                        }),
-                    ],
-                },
-                {
-                    name: "generate",
-                    summary: "Print completion script",
-                    usage: ["dvb completions generate <bash|zsh|fish>"],
-                    arguments: [
-                        arg("shell", "Shell name", {
-                            completion: "shells",
-                        }),
-                    ],
-                },
-            ],
-        },
-        {
-            name: "complete",
-            category: "System",
-            visibility: "hidden",
-            summary: "Internal shell completion entrypoint",
-            usage: ["dvb complete <bash|zsh|fish>", "dvb complete -- <words...>"],
-            arguments: [
-                arg("shell", "Shell name", {
-                    required: false,
-                    completion: "shells",
-                }),
-            ],
-            notes: ["Internal completion entrypoint used by shell scripts."],
-        },
-        {
-            name: "upgrade",
-            category: "System",
-            summary: "Force an immediate runtime upgrade check",
-            usage: ["dvb upgrade [--json]"],
-            options: [flag("json", "Output JSON")],
-            notes: [
-                "Production `dvb` installs check the npm registry directly for the newest `@boxes-dev/dvb-runtime`, validate it, and promote it immediately.",
-            ],
-        },
-        {
-            name: "version",
-            category: "System",
-            summary: "Show CLI version details and daemon info",
-            usage: ["dvb version [--json]"],
-            options: [flag("json", "Output JSON")],
-        },
-        {
-            name: "sentry-test",
-            category: "System",
-            visibility: "hidden",
-            summary: "Internal admin diagnostic command",
-            usage: ["dvb sentry-test <cli|daemon> [--json]"],
-            arguments: [arg("target", "Diagnostic target")],
-            options: [flag("json", "Output JSON")],
-            notes: ["Restricted to authorized admin accounts."],
-        },
-    ],
-};
-export const HIDDEN_COMMAND_NAMES = new Set((CLI_ROOT_COMMAND.children ?? [])
-    .filter((command) => command.visibility === "hidden")
-    .map((command) => command.name));
-//# sourceMappingURL=catalog.js.map