clawup 1.0.0

package/dist/adapters/cli-adapter.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * CLI Runtime Adapter
+ *
+ * Implements RuntimeAdapter for interactive terminal usage
+ * using @clack/prompts for UI and child_process for execution.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliAdapter = void 0;
+exports.createCLIAdapter = createCLIAdapter;
+const p = __importStar(require("@clack/prompts"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const child_process_1 = require("child_process");
+const process_1 = require("../lib/process");
+const vendor_1 = require("../lib/vendor");
+// ============================================================================
+// Execution Adapter Implementation
+// ============================================================================
+class CLIExecAdapter {
+    capture(command, args = [], cwd) {
+        const resolved = (0, vendor_1.resolveCommand)(command);
+        try {
+            const result = (0, child_process_1.execSync)([resolved, ...args].join(" "), {
+                cwd,
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            return { stdout: result.trim(), stderr: "", exitCode: 0 };
+        }
+        catch (err) {
+            const e = err;
+            return {
+                stdout: (e.stdout ?? "").toString().trim(),
+                stderr: (e.stderr ?? "").toString().trim(),
+                exitCode: e.status ?? 1,
+            };
+        }
+    }
+    stream(command, args = [], options) {
+        const resolved = (0, vendor_1.resolveCommand)(command);
+        return new Promise((resolve) => {
+            const opts = {
+                cwd: options?.cwd,
+                stdio: options?.capture ? "pipe" : "inherit",
+                shell: true,
+            };
+            const child = (0, child_process_1.spawn)(resolved, args, opts);
+            (0, process_1.trackChild)(child);
+            child.on("close", (code) => resolve(code ?? 1));
+            child.on("error", (err) => {
+                console.warn(`[exec] Child process error: ${err.message}`);
+                resolve(1);
+            });
+        });
+    }
+    commandExists(command) {
+        return (0, vendor_1.commandExistsWithVendor)(command);
+    }
+}
+// ============================================================================
+// UI Adapter Implementation
+// ============================================================================
+class CLIUIAdapter {
+    intro(message) {
+        console.log();
+        p.intro(picocolors_1.default.bgCyan(picocolors_1.default.black(` ${message} `)));
+    }
+    note(content, title) {
+        p.note(content, title);
+    }
+    outro(message) {
+        p.outro(message);
+    }
+    cancel(message) {
+        p.cancel(message);
+        process.exit(0);
+    }
+    log = {
+        info(message) {
+            p.log.info(message);
+        },
+        step(message) {
+            p.log.step(message);
+        },
+        success(message) {
+            p.log.success(message);
+        },
+        warn(message) {
+            p.log.warn(message);
+        },
+        error(message) {
+            p.log.error(message);
+        },
+    };
+    async text(options) {
+        const result = await p.text({
+            message: options.message,
+            placeholder: options.placeholder,
+            defaultValue: options.defaultValue,
+            validate: options.validate,
+        });
+        if (p.isCancel(result)) {
+            this.cancel("Operation cancelled.");
+        }
+        return result;
+    }
+    async confirm(options) {
+        const result = await p.confirm({
+            message: options.message,
+            initialValue: options.initialValue,
+        });
+        if (p.isCancel(result)) {
+            this.cancel("Operation cancelled.");
+        }
+        return result;
+    }
+    async select(options) {
+        const result = await p.select({
+            message: options.message,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            options: options.options,
+            initialValue: options.initialValue,
+        });
+        if (p.isCancel(result)) {
+            this.cancel("Operation cancelled.");
+        }
+        return result;
+    }
+    async multiSelect(options) {
+        const result = await p.multiselect({
+            message: options.message,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            options: options.options,
+            initialValues: options.initialValues,
+            required: options.required,
+        });
+        if (p.isCancel(result)) {
+            this.cancel("Operation cancelled.");
+        }
+        return result;
+    }
+    spinner(message) {
+        const s = p.spinner();
+        s.start(message);
+        return {
+            stop(msg, code) {
+                s.stop(msg, code);
+            },
+            message(msg) {
+                s.message(msg);
+            },
+        };
+    }
+}
+// ============================================================================
+// Runtime Adapter
+// ============================================================================
+/**
+ * Create a CLI runtime adapter for interactive terminal usage
+ */
+function createCLIAdapter() {
+    return {
+        ui: new CLIUIAdapter(),
+        exec: new CLIExecAdapter(),
+        platform: "cli",
+    };
+}
+/**
+ * Singleton CLI adapter instance for convenience
+ */
+exports.cliAdapter = createCLIAdapter();
+//# sourceMappingURL=cli-adapter.js.map

package/dist/adapters/cli-adapter.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Runtime Adapters Module
+ *
+ * Provides platform-agnostic abstractions for UI and execution,
+ * enabling the same core command logic to run in different environments.
+ *
+ * @example
+ * import { createCLIAdapter, type RuntimeAdapter, type ToolImplementation } from './adapters';
+ *
+ * const myTool: ToolImplementation<{ name: string }> = async (runtime, options) => {
+ *   runtime.ui.intro("My Tool");
+ *   const name = options.name || await runtime.ui.text({ message: "Enter name:" });
+ *   runtime.ui.log.success(`Hello, ${name}!`);
+ * };
+ *
+ * // Run with CLI adapter
+ * await myTool(createCLIAdapter(), { name: "World" });
+ */
+export type { RuntimeAdapter, UIAdapter, ExecAdapter, LogAdapter, ExecResult, TextOptions, ConfirmOptions, SelectOptions, SelectOption, MultiSelectOptions, SpinnerController, StreamOptions, ToolImplementation, ToolDefinition, } from "./types";
+export { createCLIAdapter, cliAdapter } from "./cli-adapter";
+export { createAPIAdapter, APIAdapterNeedsInputError, APIAdapterValidationError, APIAdapterCancelError, } from "./api-adapter";
+export type { FieldDescriptor, LogEntry, APIResponse } from "./api-adapter";

package/dist/adapters/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Runtime Adapters Module
+ *
+ * Provides platform-agnostic abstractions for UI and execution,
+ * enabling the same core command logic to run in different environments.
+ *
+ * @example
+ * import { createCLIAdapter, type RuntimeAdapter, type ToolImplementation } from './adapters';
+ *
+ * const myTool: ToolImplementation<{ name: string }> = async (runtime, options) => {
+ *   runtime.ui.intro("My Tool");
+ *   const name = options.name || await runtime.ui.text({ message: "Enter name:" });
+ *   runtime.ui.log.success(`Hello, ${name}!`);
+ * };
+ *
+ * // Run with CLI adapter
+ * await myTool(createCLIAdapter(), { name: "World" });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIAdapterCancelError = exports.APIAdapterValidationError = exports.APIAdapterNeedsInputError = exports.createAPIAdapter = exports.cliAdapter = exports.createCLIAdapter = void 0;
+// Export CLI adapter
+var cli_adapter_1 = require("./cli-adapter");
+Object.defineProperty(exports, "createCLIAdapter", { enumerable: true, get: function () { return cli_adapter_1.createCLIAdapter; } });
+Object.defineProperty(exports, "cliAdapter", { enumerable: true, get: function () { return cli_adapter_1.cliAdapter; } });
+// Export API adapter
+var api_adapter_1 = require("./api-adapter");
+Object.defineProperty(exports, "createAPIAdapter", { enumerable: true, get: function () { return api_adapter_1.createAPIAdapter; } });
+Object.defineProperty(exports, "APIAdapterNeedsInputError", { enumerable: true, get: function () { return api_adapter_1.APIAdapterNeedsInputError; } });
+Object.defineProperty(exports, "APIAdapterValidationError", { enumerable: true, get: function () { return api_adapter_1.APIAdapterValidationError; } });
+Object.defineProperty(exports, "APIAdapterCancelError", { enumerable: true, get: function () { return api_adapter_1.APIAdapterCancelError; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAoBH,qBAAqB;AACrB,6CAA6D;AAApD,+GAAA,gBAAgB,OAAA;AAAE,yGAAA,UAAU,OAAA;AAErC,qBAAqB;AACrB,6CAKuB;AAJrB,+GAAA,gBAAgB,OAAA;AAChB,wHAAA,yBAAyB,OAAA;AACzB,wHAAA,yBAAyB,OAAA;AACzB,oHAAA,qBAAqB,OAAA"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Runtime Adapter Interfaces
+ *
+ * These interfaces define the contract between the core command logic
+ * and the runtime environment (CLI, API server, etc.).
+ *
+ * This pattern allows the same core to run with different adapters:
+ * - CLIAdapter: Interactive terminal with @clack/prompts
+ * - APIAdapter: HTTP server returning JSON responses (future)
+ * - TestAdapter: Mock adapter for testing (future)
+ */
+/** Result of a captured command execution */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/** Options for streaming command execution */
+export interface StreamOptions {
+    cwd?: string;
+    /** If true, capture output instead of streaming to console */
+    capture?: boolean;
+}
+/** Select option for prompts */
+export interface SelectOption<T> {
+    value: T;
+    label: string;
+    hint?: string;
+}
+/** Text input options */
+export interface TextOptions {
+    message: string;
+    placeholder?: string;
+    defaultValue?: string;
+    validate?: (value: string) => string | undefined;
+}
+/** Confirm options */
+export interface ConfirmOptions {
+    message: string;
+    initialValue?: boolean;
+}
+/** Select options */
+export interface SelectOptions<T> {
+    message: string;
+    options: SelectOption<T>[];
+    initialValue?: T;
+}
+/** Multi-select options */
+export interface MultiSelectOptions<T> {
+    message: string;
+    options: SelectOption<T>[];
+    initialValues?: T[];
+    required?: boolean;
+}
+/** Logging interface */
+export interface LogAdapter {
+    info(message: string): void;
+    step(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+/** User interface adapter for prompts and output */
+export interface UIAdapter {
+    /** Show introductory banner/message */
+    intro(message: string): void;
+    /** Show a note/info box */
+    note(content: string, title?: string): void;
+    /** Show outro/closing message */
+    outro(message: string): void;
+    /** Show cancellation message and exit */
+    cancel(message: string): never;
+    /** Logging methods */
+    log: LogAdapter;
+    /** Prompt for text input */
+    text(options: TextOptions): Promise<string>;
+    /** Prompt for yes/no confirmation */
+    confirm(options: ConfirmOptions): Promise<boolean>;
+    /** Prompt for single selection */
+    select<T>(options: SelectOptions<T>): Promise<T>;
+    /** Prompt for multiple selection */
+    multiSelect<T>(options: MultiSelectOptions<T>): Promise<T[]>;
+    /** Start a loading spinner */
+    spinner(message: string): SpinnerController;
+}
+/** Spinner control interface */
+export interface SpinnerController {
+    stop(message?: string, code?: number): void;
+    message(msg: string): void;
+}
+/** Command execution adapter */
+export interface ExecAdapter {
+    /** Execute a command and capture output */
+    capture(command: string, args?: string[], cwd?: string): ExecResult;
+    /** Execute a command with streaming output, returns exit code */
+    stream(command: string, args?: string[], options?: StreamOptions): Promise<number>;
+    /** Check if a command exists on the system */
+    commandExists(command: string): boolean;
+}
+/** Combined runtime adapter providing all platform abstractions */
+export interface RuntimeAdapter {
+    /** User interface adapter */
+    ui: UIAdapter;
+    /** Command execution adapter */
+    exec: ExecAdapter;
+    /** Platform identifier for conditional logic */
+    platform: "cli" | "api" | "test";
+}
+/**
+ * A tool implementation is a function that performs a command action
+ * using the provided runtime adapter. This allows the same logic to
+ * work across different runtime environments.
+ *
+ * @example
+ * const deployTool: ToolImplementation<DeployOptions> = async (runtime, options) => {
+ *   const { ui, exec } = runtime;
+ *   ui.intro("Deploying agents...");
+ *   const result = exec.capture("pulumi", ["up", "--yes"]);
+ *   if (result.exitCode !== 0) {
+ *     ui.log.error("Deployment failed");
+ *   }
+ * };
+ */
+export type ToolImplementation<TOptions = Record<string, unknown>> = (runtime: RuntimeAdapter, options: TOptions) => Promise<void>;
+/**
+ * Tool definition with metadata
+ */
+export interface ToolDefinition<TOptions = Record<string, unknown>> {
+    /** Tool name/identifier */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** The implementation function */
+    execute: ToolImplementation<TOptions>;
+}

package/dist/adapters/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Runtime Adapter Interfaces
+ *
+ * These interfaces define the contract between the core command logic
+ * and the runtime environment (CLI, API server, etc.).
+ *
+ * This pattern allows the same core to run with different adapters:
+ * - CLIAdapter: Interactive terminal with @clack/prompts
+ * - APIAdapter: HTTP server returning JSON responses (future)
+ * - TestAdapter: Mock adapter for testing (future)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}

package/dist/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Agent Army CLI — Entry point
+ *
+ * Provides interactive commands for the full agent lifecycle:
+ * init, deploy, redeploy, status, ssh, validate, destroy, config
+ */
+export {};

package/dist/bin.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Agent Army CLI — Entry point
+ *
+ * Provides interactive commands for the full agent lifecycle:
+ * init, deploy, redeploy, status, ssh, validate, destroy, config
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const process_1 = require("./lib/process");
+const init_1 = require("./commands/init");
+const deploy_1 = require("./commands/deploy");
+const status_1 = require("./commands/status");
+const ssh_1 = require("./commands/ssh");
+const validate_1 = require("./commands/validate");
+const push_1 = require("./commands/push");
+const destroy_1 = require("./commands/destroy");
+const list_1 = require("./commands/list");
+const update_1 = require("./commands/update");
+const config_1 = require("./commands/config");
+const secrets_1 = require("./commands/secrets");
+const redeploy_1 = require("./commands/redeploy");
+const webhooks_1 = require("./commands/webhooks");
+const update_check_1 = require("./lib/update-check");
+// Forward SIGINT/SIGTERM to child processes before exiting
+(0, process_1.setupGracefulShutdown)();
+// Read version from package.json so it stays in sync with npm publish
+const pkgJson = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8"));
+const program = new commander_1.Command();
+program
+    .name("clawup")
+    .description("Deploy and manage a fleet of OpenClaw AI agents on AWS")
+    .version(pkgJson.version);
+program
+    .command("init")
+    .description("Interactive setup wizard — configure stack, secrets, and agents")
+    .option("--deploy", "Deploy immediately after init")
+    .option("-y, --yes", "Skip confirmation prompt (for deploy)")
+    .action(async (opts) => {
+    await (0, init_1.initCommand)(opts);
+});
+program
+    .command("deploy")
+    .description("Deploy agents with pulumi up")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, deploy_1.deployCommand)(opts);
+});
+program
+    .command("status")
+    .description("Show agent statuses from stack outputs")
+    .option("--json", "Output as JSON")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, status_1.statusCommand)(opts);
+});
+program
+    .command("ssh <agent>")
+    .description("SSH to an agent by name or alias (juno, titus, scout)")
+    .option("-u, --user <user>", "SSH user")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .argument("[command...]", "Command to run on the agent")
+    .action(async (agent, commandArgs, opts) => {
+    await (0, ssh_1.sshCommand)(agent, commandArgs, opts);
+});
+program
+    .command("validate")
+    .description("Health check agents via Tailscale SSH")
+    .option("-t, --timeout <seconds>", "SSH timeout in seconds", "30")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, validate_1.validateCommand)(opts);
+});
+program
+    .command("push")
+    .description("Push workspace files, skills, and config to running agents")
+    .option("--skills", "Sync skills to remote workspace")
+    .option("--workspace", "Sync workspace files from identity")
+    .option("--memory-reset", "Remove remote memory/ dir and MEMORY.md")
+    .option("--openclaw", "Upgrade openclaw to latest + restart gateway")
+    .option("--config-push", "Copy local openclaw.json to remote + restart gateway")
+    .option("-a, --agent <name>", "Target a single agent (name, role, or alias)")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, push_1.pushCommand)({
+        skills: opts.skills,
+        workspace: opts.workspace,
+        memoryReset: opts.memoryReset,
+        openclaw: opts.openclaw,
+        pushConfig: opts.configPush,
+        agent: opts.agent,
+        config: opts.config,
+    });
+});
+program
+    .command("redeploy")
+    .description("Update agents in-place without destroying infrastructure")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, redeploy_1.redeployCommand)(opts);
+});
+program
+    .command("destroy")
+    .description("Tear down all resources with safety confirmations")
+    .option("-y, --yes", "Skip confirmation prompts (dangerous!)")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, destroy_1.destroyCommand)(opts);
+});
+program
+    .command("list")
+    .description("List all saved configs")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    await (0, list_1.listCommand)(opts);
+});
+const configCmd = program
+    .command("config")
+    .description("View or modify config without re-running init");
+configCmd
+    .command("show")
+    .description("Display current config")
+    .option("--json", "Output as JSON")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, config_1.configShowCommand)(opts);
+});
+configCmd
+    .command("set <key> <value>")
+    .description("Update a config value")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .option("-a, --agent <name>", "Target a specific agent")
+    .action(async (key, value, opts) => {
+    await (0, config_1.configSetCommand)(key, value, opts);
+});
+configCmd
+    .command("migrate")
+    .description("Migrate plugin config files into the manifest (one-time upgrade)")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, config_1.configMigrateCommand)(opts);
+});
+const secretsCmd = program
+    .command("secrets")
+    .description("View or update Pulumi secrets without re-running init");
+secretsCmd
+    .command("set <key> <value>")
+    .description("Set a secret (e.g. braveApiKey, anthropicApiKey)")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .option("-a, --agent <role>", "Agent role for per-agent secrets (e.g. eng, pm, tester)")
+    .action(async (key, value, opts) => {
+    await (0, secrets_1.secretsSetCommand)(key, value, opts);
+});
+secretsCmd
+    .command("list")
+    .description("Show which secrets are configured (values redacted)")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, secrets_1.secretsListCommand)(opts);
+});
+const webhooksCmd = program
+    .command("webhooks")
+    .description("Manage agent webhooks");
+webhooksCmd
+    .command("setup")
+    .description("Configure Linear webhooks for deployed agents")
+    .option("-c, --config <name>", "Config name (auto-detected if only one)")
+    .action(async (opts) => {
+    await (0, webhooks_1.webhooksSetupCommand)(opts);
+});
+program
+    .command("update")
+    .description("Update clawup CLI to the latest version")
+    .action(async (opts) => {
+    await (0, update_1.updateCommand)(opts);
+});
+// Fire-and-forget update check — must run before parse() because
+// Commander's --help/--version call process.exit() synchronously.
+// The cached path (no await) prints the notice before exit;
+// the stale-cache path fetches in the background for the next run.
+(0, update_check_1.checkForUpdates)(pkgJson.version).catch(() => { });
+program.parse();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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