argsbarg 4.0.4 → 4.1.1

package/src/types.ts

@@ -133,6 +133,10 @@ export interface CliMcpBundleConfig {
 export interface CliMcpServerConfig {
   /** When `true`, enables the `mcp` built-in and MCP stdio server. */
   enabled: boolean;
+  /** When `true`, `mcp bundle` writes `dist/<key>.mcpb` for Claude Desktop. Default false. */
+  mcpd?: boolean;
+  /** When `true`, `mcp bundle` also writes `dist/claude-plugin/<name>.zip`. Default false. */
+  claudePlugin?: boolean;
   /** Resource URI for schema export (default: `<sanitized root key>://schema`). */
   schemaResourceUri?: string;
   /**
@@ -198,6 +202,26 @@ export interface CliUpdateArtifact {
 /** Fetches the latest release binary for `install --update`. */
 export type CliUpdateGetLatest = (ctx: { version: string }) => Promise<CliUpdateArtifact>;
 
+/** Context passed to {@link CliAppConfigEntry.resolve} for one config key. */
+export interface CliAppConfigResolveContext {
+  /** Schema key being resolved. */
+  key: string;
+  /** Entry metadata for this key. */
+  entry: CliAppConfigEntry;
+  /** Program root (read-only). */
+  program: CliProgram;
+  /** Raw value from the config file, if any. */
+  fileValue: unknown;
+  /** Non-empty host env string when `entry.env` is set; otherwise `undefined`. */
+  envValue: string | undefined;
+}
+
+/**
+ * Optional fallback resolver for one config key (e.g. `gh auth token` when `GH_TOKEN` is unset).
+ * Return `undefined` to continue resolution (env, then default).
+ */
+export type CliAppConfigResolveFn = (ctx: CliAppConfigResolveContext) => unknown;
+
 /**
  * Metadata overlay for one key in {@link CliAppConfig.entries}.
  * Types and validation come from {@link CliAppConfig.jsonSchema} when set; otherwise all values are strings.
@@ -218,14 +242,17 @@ export interface CliAppConfigEntry {
   sensitive?: boolean;
   /** When set: non-empty `process.env[env]` overrides file; value exported after resolve. */
   env?: string;
+  /**
+   * Optional fallback after file when env is empty.
+   * Return `undefined` to fall back to `env` (if set) and schema defaults.
+   */
+  resolve?: CliAppConfigResolveFn;
 }
 
 /**
  * App configuration block on the program root ({@link CliProgram.appConfig}).
  */
 export interface CliAppConfig {
-  /** Default: `~/.config/<sanitized-key>/config` (or `%APPDATA%/<key>/config` on Windows). */
-  path?: string;
   /** Built-in `config get` / `config set`. Default: enabled when `appConfig` is set. */
   commands?: boolean | { enabled?: boolean; mcpSet?: boolean };
   /** Block JSON Schema (draft-07). When omitted, synthesize all-string schema from `entries`. */
@@ -237,13 +264,65 @@ export interface CliAppConfig {
 export interface CliInstallConfig {
   /** When `false`, hide/disable `install` (default: enabled). */
   enabled?: boolean;
-  /** Default bin directory (default: `~/.local/bin`). Overridden by `INSTALL_PREFIX` env and `--prefix`. */
-  prefix?: string;
   /**
-   * When set, enables `install --update` on the program root.
-   * Should download or locate the latest release binary and return its path.
+   * Default agent integration for full install (`install --all`).
+   * - `'mcp'` when `mcpServer.enabled` (default): MCP targets in `--all`; paired skills excluded.
+   * - `'skill'` when MCP is off (default): skill targets in `--all`; paired MCP excluded.
+   * - `'both'`: install MCP and skill for the same host when both are available.
    */
-  updateGetLatest?: CliUpdateGetLatest;
+  agentIntegration?: InstallAgentIntegration;
+  /** Per-artifact gates for full install/uninstall. See {@link resolveEffectiveInstallTargets}. */
+  targets?: CliInstallTargets;
+}
+
+/** Agent integration mode for install — MCP vs shell skill per host. */
+export type InstallAgentIntegration = "mcp" | "skill" | "both";
+
+/** Boolean or structured gate for one install artifact. */
+export type InstallTargetSpec =
+  | boolean
+  | {
+      /** When false, artifact is never installed (even with scoped CLI flags). Default true. */
+      enabled?: boolean;
+      /** When true, included in bare `install` / `install --all`. Default varies by key. */
+      includedInAll?: boolean;
+    };
+
+export interface ResolvedInstallTarget {
+  enabled: boolean;
+  includedInAll: boolean;
+}
+
+/** Per-artifact gates for full install/uninstall. See {@link resolveEffectiveInstallTargets}. */
+export interface CliInstallTargets {
+  /** App binary status only (Homebrew PATH); no self-install. */
+  app?: InstallTargetSpec;
+  /** ChatGPT desktop MCP. Default false. */
+  chatgptMcp?: InstallTargetSpec;
+  /** Claude Code MCP (`~/.claude.json`). Default false. */
+  claudeCodeMcp?: InstallTargetSpec;
+  /** Claude Desktop MCP. Default false. */
+  claudeDesktopMcp?: InstallTargetSpec;
+  /** Claude Code skill. Default false. */
+  claudeSkill?: InstallTargetSpec;
+  /** Codex MCP (`codex mcp add`). Default false. */
+  codexMcp?: InstallTargetSpec;
+  /** Codex skill. Default false. */
+  codexSkill?: InstallTargetSpec;
+  /** App config: wizard via install --configure only. Default not in --all. */
+  configure?: InstallTargetSpec;
+  /** Cursor MCP. Default false. */
+  cursorMcp?: InstallTargetSpec;
+  /** Cursor skill. Default false. */
+  cursorSkill?: InstallTargetSpec;
+  /** OpenClaw MCP. Default false. */
+  openclawMcp?: InstallTargetSpec;
+  /** OpenClaw skill. Default false. */
+  openclawSkill?: InstallTargetSpec;
+  /** OpenCode MCP. Default false. */
+  opencodeMcp?: InstallTargetSpec;
+  /** OpenCode skill. Default false. */
+  opencodeSkill?: InstallTargetSpec;
 }
 
 /**

package/src/validate.ts

@@ -6,6 +6,7 @@ import { reservedCommandNames, resolveCapabilities } from "./capabilities.ts";
 import { reservedDocsTopicResourceUris } from "./docs/mcp-resources.ts";
 import { DOCS_BUILTIN_TOPIC_KEYS } from "./docs/resolve.ts";
 import { validateFormatValue } from "./formats.ts";
+import { AGENT_PAIRS } from "./install/target-registry.ts";
 import { resolveMcpSchemaUri } from "./mcp/tools.ts";
 import {
   type CliLeaf,
@@ -14,6 +15,8 @@ import {
   type CliProgram,
   CliSchemaValidationError,
   CliValueFormat,
+  type InstallAgentIntegration,
+  type InstallTargetSpec,
   isCliLeaf,
   isCliRouter,
 } from "./types.ts";
@@ -78,6 +81,11 @@ function validateConfigBlock(appConfigBlock: import("./types.ts").CliAppConfig):
       }
       envNames.add(entry.env);
     }
+    if (entry.resolve !== undefined && typeof entry.resolve !== "function") {
+      throw new CliSchemaValidationError(
+        `program.appConfig.entries['${key}'].resolve must be a function when set`,
+      );
+    }
   }
 
   const jsonSchema = appConfigBlock.jsonSchema;
@@ -105,6 +113,69 @@ function validateConfigBlock(appConfigBlock: import("./types.ts").CliAppConfig):
   }
 }
 
+const PAIR_HOST_LABELS: Record<string, string> = {
+  cursorMcp: "cursor",
+  claudeCodeMcp: "claudeCode",
+  codexMcp: "codex",
+  opencodeMcp: "opencode",
+  openclawMcp: "openclaw",
+};
+
+function installTargetExplicitTruthy(spec: InstallTargetSpec | undefined): boolean {
+  if (spec === undefined || spec === false) return false;
+  if (spec === true) return true;
+  return spec.enabled !== false;
+}
+
+/** Validates `program.install` targets and agentIntegration. */
+function validateInstallConfig(program: CliProgram): void {
+  const install = program.install;
+  if (!install) return;
+
+  if ("prefix" in install) {
+    throw new CliSchemaValidationError(
+      "install.prefix removed; app installs to ~/.local/bin/<key>",
+    );
+  }
+
+  if (!install.targets) return;
+
+  const targets = install.targets;
+  if ("allSkills" in targets || "allMcps" in targets) {
+    throw new CliSchemaValidationError(
+      "install.targets.allSkills/allMcps removed; use agentIntegration and per-key targets",
+    );
+  }
+
+  const integration: InstallAgentIntegration =
+    install.agentIntegration ?? (program.mcpServer?.enabled === true ? "mcp" : "skill");
+
+  for (const [mcpKey, skillKey] of AGENT_PAIRS) {
+    const mcpSpec = targets[mcpKey];
+    const skillSpec = targets[skillKey];
+    const mcpOn = installTargetExplicitTruthy(mcpSpec);
+    const skillOn = installTargetExplicitTruthy(skillSpec);
+    const host = PAIR_HOST_LABELS[mcpKey] ?? mcpKey;
+
+    if (mcpOn && skillOn && integration !== "both") {
+      throw new CliSchemaValidationError(
+        `install.targets: ${host} has both MCP and skill configured; set agentIntegration: 'both' or disable one side`,
+      );
+    }
+
+    if (integration === "skill" && mcpOn) {
+      throw new CliSchemaValidationError(
+        `install.targets.${mcpKey} requires agentIntegration: 'both' when agentIntegration is 'skill'`,
+      );
+    }
+    if (integration === "mcp" && skillOn) {
+      throw new CliSchemaValidationError(
+        `install.targets.${skillKey} requires agentIntegration: 'both' when agentIntegration is 'mcp'`,
+      );
+    }
+  }
+}
+
 /** Validates a program schema. */
 export function cliValidateProgram(program: CliProgram): void {
   if (!program.version || program.version.trim().length === 0) {
@@ -131,15 +202,8 @@ export function cliValidateProgram(program: CliProgram): void {
     validateConfigBlock(program.appConfig);
   }
 
-  if (program.install?.updateGetLatest !== undefined) {
-    if (program.install.enabled === false) {
-      throw new CliSchemaValidationError(
-        "install.updateGetLatest requires install to be enabled (omit install.enabled: false)",
-      );
-    }
-    if (typeof program.install.updateGetLatest !== "function") {
-      throw new CliSchemaValidationError("install.updateGetLatest must be a function");
-    }
+  if (program.install !== undefined) {
+    validateInstallConfig(program);
   }
 
   const caps = resolveCapabilities(program);

package/docs/templates/cursor/rules/cli-program.mdc

@@ -1,31 +0,0 @@
----
-description: Argsbarg schema — read framework docs before editing CLI commands
-globs: "src/**/commands/**/*.{ts,tsx},src/index.{ts,tsx}"
-alwaysApply: false
----
-
-When adding or changing argsbarg schema, leaf handlers, or MCP exposure:
-
-1. **Read** `node_modules/argsbarg/docs/cli-program.md` (required — authoritative guide).
-2. MCP tools, varargs, `inputSchema` → also `node_modules/argsbarg/docs/mcp.md`.
-3. JSON stdout / `outputSchema` guide and codegen → `node_modules/argsbarg/docs/output-schema.md`.
-4. App config / `program.appConfig` guide and codegen → `node_modules/argsbarg/docs/config-schema.md`.
-5. `install`, completions, skills → `node_modules/argsbarg/docs/install.md`.
-6. Bundled `docs` built-in → `node_modules/argsbarg/docs/bundled-docs.md`.
-7. **Examples** (shipped under `node_modules/argsbarg/examples/`):
-   - Concepts / minimal config → `examples/config-app/`
-   - **Copy template** (all builtins, schemagen, `outputSchema`) → `examples/consumer-app/`
-
-**Hard rules** (details and examples are in the docs above — do not contradict them):
-
-- Reserved root commands: `completion`, `install`, `mcp`, `version`, `docs`, `update`, `config`.
-- `satisfies CliProgram` / `CliLeaf`; action-oriented `description` on root, commands, options, and positionals.
-- Omit `mcpTool` unless genuinely CLI-only (`enabled: false`) or an irreducible wire limit — fix schema and headless handlers first.
-- Interactive leaves: one headless path for MCP, non-TTY CLI, and `--yes` / `--dry-run` / `--json` (`shouldRunHeadless*`, `requireYesInNonTty`); not raw `isTTY`.
-- String options: `format` / `default` / `pattern` per `cli-program.md`; `readLeafInputs()` for multi-flag leaves.
-- Varargs (`argMax: 0`): CLI space-separated; MCP JSON array only — no comma-splitting positionals.
-- Multi-surface leaves (Ink + headless + MCP): one **`read*Flags(ctx)`** per command (or shared family helper + extensions); one **`resolve*Input(flags)`** for cross-field rules — handler reads ctx once, all paths share the struct.
-- JSON stdout: `outputSchema` on the leaf from generated constants in `outputSchemas.ts` — see `output-schema.md`; mark roots with **`JSON payload`** JSDoc in `src/**/types.ts`; do not hand-edit `src/schemas/generated/` or `outputSchemas.ts`.
-- App config: `program.appConfig.jsonSchema` from generated `configSchemas.ts` — see `config-schema.md`; mark roots with **`Config schema`** JSDoc; prefer the layout in `node_modules/argsbarg/examples/consumer-app/` when adding new schema roots.
-
-**App-specific conventions:** replace this line with a `**<your-app> conventions:**` section (bullets only). Keep it at the bottom of this file — `just consumer-dev` / `just consumers-sync` in the argsbarg repo refresh the template above and preserve this block. Do not duplicate `cli-program.md` here; link paths and patterns only. For a second rule file (e.g. `.cursor/argsbarg.mdc`), that is fine too.

package/examples/config-app/main.ts

@@ -1,20 +0,0 @@
-#!/usr/bin/env bun
-/*
-Multi-file consumer example for program.appConfig.
-
-Files:
-  types.ts   — AppConfig interface (Config schema JSDoc marker for schemagen)
-  schema.ts  — APP_CONFIG_JSON_SCHEMA (inline; production apps generate this)
-  program.ts — CliProgram with appConfig block and commands using ctx.appConfig
-
-Try:
-  CONFIG_APP_API_TOKEN=dev bun ./examples/config-app/main.ts show --json
-  CONFIG_APP_API_TOKEN=dev bun ./examples/config-app/main.ts config get
-  CONFIG_APP_API_TOKEN=dev bun ./examples/config-app/main.ts ping
-*/
-
-import { Cli } from "../../src/index.ts";
-import { program } from "./program.ts";
-
-const cli = new Cli(program);
-await cli.run();

package/examples/config-app/program.ts

@@ -1,81 +0,0 @@
-/*
-CliProgram for the config-app example — program.appConfig with jsonSchema + metadata overlay.
-*/
-
-import pkg from "../../package.json" with { type: "json" };
-import {
-  type CliAppConfig,
-  type CliAppConfigEntry,
-  CliOptionKind,
-  type CliProgram,
-} from "../../src/index.ts";
-import { APP_CONFIG_JSON_SCHEMA } from "./schema.ts";
-
-const configPath = process.env.CONFIG_APP_CONFIG_FILE;
-
-const configSchema = {
-  apiToken: {
-    description: "Create at https://example.com/settings/tokens",
-    env: "CONFIG_APP_API_TOKEN",
-    sensitive: true,
-  },
-  defaultRegion: {
-    description: "AWS region for API calls.",
-    required: false,
-  },
-  maxRetries: {
-    description: "HTTP retry count (0–10).",
-  },
-  prefs: {
-    description: "Local cache preferences (not exported to env).",
-    required: false,
-  },
-} as const satisfies Record<string, CliAppConfigEntry>;
-
-export const program = {
-  key: "config-app",
-  version: pkg.version,
-  description: "Demonstrates program.appConfig, ctx.appConfig, and built-in config get/set.",
-  appConfig: {
-    ...(configPath ? { path: configPath } : {}),
-    jsonSchema: APP_CONFIG_JSON_SCHEMA,
-    entries: configSchema,
-  } satisfies CliAppConfig,
-  commands: [
-    {
-      key: "show",
-      description: "Print resolved config (secrets redacted).",
-      options: [
-        {
-          name: "json",
-          description: "Emit JSON.",
-          kind: CliOptionKind.Presence,
-        },
-      ],
-      handler: (ctx) => {
-        const out = {
-          defaultRegion: ctx.appConfig.get("defaultRegion"),
-          maxRetries: ctx.appConfig.get("maxRetries"),
-          prefs: ctx.appConfig.get("prefs"),
-          apiTokenSet: ctx.appConfig.get("apiToken") !== undefined,
-        };
-        if (ctx.hasFlag("json")) {
-          console.log(JSON.stringify(out, null, 2));
-        } else {
-          console.log(`region=${out.defaultRegion ?? "(not set)"}`);
-          console.log(`maxRetries=${out.maxRetries ?? "(not set)"}`);
-          console.log(`prefs=${out.prefs ? JSON.stringify(out.prefs) : "(not set)"}`);
-          console.log(`apiToken=${out.apiTokenSet ? "set" : "missing"}`);
-        }
-      },
-    },
-    {
-      key: "ping",
-      description: "Require apiToken and print a short confirmation.",
-      handler: (ctx) => {
-        const token = ctx.appConfig.require("apiToken");
-        console.log(`ok (token length ${String(token).length})`);
-      },
-    },
-  ],
-} satisfies CliProgram;

package/examples/config-app/schema.ts

@@ -1,37 +0,0 @@
-/*
-Inline draft-07 JSON Schema for AppConfig.
-Production apps commit generated JSON and import via configSchemas.ts — see docs/config-schema.md.
-*/
-
-import type { AppConfig } from "./types.ts";
-
-/** JSON Schema root for program.appConfig.jsonSchema (hand-written stand-in for schemagen). */
-export const APP_CONFIG_JSON_SCHEMA = {
-  $schema: "http://json-schema.org/draft-07/schema#",
-  type: "object",
-  additionalProperties: false,
-  required: ["apiToken", "maxRetries"],
-  properties: {
-    apiToken: { type: "string", minLength: 1 },
-    defaultRegion: { type: "string", default: "us-east-1" },
-    maxRetries: { type: "integer", minimum: 0, maximum: 10, default: 3 },
-    prefs: {
-      type: "object",
-      additionalProperties: false,
-      required: ["ttl"],
-      properties: {
-        ttl: { type: "integer", minimum: 1 },
-      },
-    },
-  },
-} as const satisfies Record<string, unknown>;
-
-/** Compile-time check that schema keys align with AppConfig (documentation only). */
-type _SchemaKeys = keyof typeof APP_CONFIG_JSON_SCHEMA.properties;
-type _ConfigKeys = keyof AppConfig;
-const _assertKeysAlign: _SchemaKeys extends _ConfigKeys
-  ? _ConfigKeys extends _SchemaKeys
-    ? true
-    : never
-  : never = true;
-void _assertKeysAlign;

package/examples/config-app/types.ts

@@ -1,19 +0,0 @@
-/**
- * Config schema
- *
- * Application settings persisted in a flat JSON file (`program.appConfig`).
- * In a production app, generate `APP_CONFIG_JSON_SCHEMA` from this interface
- * with ts-json-schema-generator — see docs/config-schema.md.
- */
-export interface AppConfig {
-  /** API token from the provider dashboard. */
-  apiToken: string;
-  /** AWS region (default us-east-1). */
-  defaultRegion?: string;
-  /** HTTP retry count (default 3). */
-  maxRetries: number;
-  /** Local preferences (file-only; not mapped to process.env). */
-  prefs?: {
-    ttl: number;
-  };
-}

package/examples/consumer-app/README.md

@@ -1,57 +0,0 @@
-# consumer-app
-
-**Kitchen-sink argsbarg reference** — copy this layout when bootstrapping a production CLI. For a minimal `program.appConfig` intro, see [`../config-app/`](../config-app/).
-
-## What this demonstrates
-
-| Area | Files / wiring |
-| --- | --- |
-| All builtins | `completion`, `version`, `install` (+ `--update`), `docs`, `mcp`, `config get`/`set` |
-| `program.appConfig` | `src/types.ts` (`AppConfig`) → `schemas/configSchemas.ts` |
-| `outputSchema` | `src/commands/status/types.ts` (`StatusJsonOutput`) → `schemas/outputSchemas.ts` |
-| Schemagen | `scripts/schemagen.ts` + `scripts/schemagen/discover-schema-roots.ts` |
-| Handler access | `ctx.appConfig` in `src/program.ts` |
-| MCP doc topics | `docs.topics` auto-exposed as `<key>://docs/<topic>` resources when docs + MCP enabled |
-| Package import | `from "argsbarg"` (not relative to argsbarg `src/`) |
-
-## Quick start (in this repo)
-
-```bash
-cd examples/consumer-app
-bun install
-bun run schemagen   # after changing src/**/types.ts
-CONSUMER_APP_API_TOKEN=dev bun run start status --json
-CONSUMER_APP_API_TOKEN=dev bun run start config get apiToken --json
-CONSUMER_APP_API_TOKEN=dev bun run start docs readme
-```
-
-## Copy into a new app
-
-1. Copy this directory into your repo (e.g. `apps/my-cli/`).
-2. Set `"argsbarg": "^<version>"` in `package.json` (replace `file:../..`).
-3. Run `bun run schemagen` and commit `schemas/generated/` + bridge `.ts` files.
-4. Copy [`node_modules/argsbarg/docs/templates/cursor/rules/cli-program.mdc`](../../docs/templates/cursor/rules/cli-program.mdc) to `.cursor/rules/`.
-
-## Schemagen markers
-
-| Marker in interface JSDoc | Artifact |
-| --- | --- |
-| `Config schema` | `schemas/configSchemas.ts` + `schemas/generated/*-config.json` |
-| `JSON payload` | `schemas/outputSchemas.ts` + `schemas/generated/*.json` |
-
-Discovery walks `src/**/types.ts` only.
-
-## Environment
-
-| Variable | Purpose |
-| --- | --- |
-| `CONSUMER_APP_API_TOKEN` | Overrides `apiToken` via `program.appConfig` env mapping |
-| `CONSUMER_APP_CONFIG_FILE` | Overrides config file path (`config.path`) |
-
-## Maintainers (argsbarg repo)
-
-When adding or changing builtins, update this example and run:
-
-```bash
-just consumer-app-schemagen
-```

package/examples/consumer-app/src/main.ts

@@ -1,15 +0,0 @@
-#!/usr/bin/env bun
-/*
-Kitchen-sink argsbarg consumer reference.
-
-  cd examples/consumer-app && bun install && bun run schemagen
-  CONSUMER_APP_API_TOKEN=dev bun run start status --json
-  CONSUMER_APP_API_TOKEN=dev bun run start config get
-  CONSUMER_APP_API_TOKEN=dev bun run start docs readme
-*/
-
-import { Cli } from "argsbarg";
-import { program } from "./program.ts";
-
-const cli = new Cli(program);
-await cli.run();

package/examples/consumer-app/src/program.ts

@@ -1,108 +0,0 @@
-/*
-Kitchen-sink CliProgram — every argsbarg builtin enabled.
-*/
-
-import {
-  type CliAppConfig,
-  type CliAppConfigEntry,
-  CliOptionKind,
-  type CliProgram,
-} from "argsbarg";
-import readmeText from "../README.md" with { type: "text" };
-import { APP_CONFIG_JSON_SCHEMA } from "../schemas/configSchemas.ts";
-import { STATUS_JSON_OUTPUT_SCHEMA } from "../schemas/outputSchemas.ts";
-import type { StatusJsonOutput } from "./commands/status/types.ts";
-
-const configPath = process.env.CONSUMER_APP_CONFIG_FILE;
-
-const configSchema = {
-  apiToken: {
-    description: "Create at https://example.com/settings/tokens",
-    env: "CONSUMER_APP_API_TOKEN",
-    sensitive: true,
-  },
-  defaultRegion: {
-    description: "AWS region for API calls.",
-    required: false,
-  },
-  maxRetries: {
-    description: "HTTP retry count (0–10).",
-  },
-  prefs: {
-    description: "Local cache preferences (not exported to env).",
-    required: false,
-  },
-} as const satisfies Record<string, CliAppConfigEntry>;
-
-export const program = {
-  key: "consumer-app",
-  version: "1.0.0",
-  description: "Argsbarg kitchen-sink reference — all builtins, schemagen, ctx.appConfig.",
-  appConfig: {
-    ...(configPath ? { path: configPath } : {}),
-    jsonSchema: APP_CONFIG_JSON_SCHEMA,
-    entries: configSchema,
-  } satisfies CliAppConfig,
-  docs: {
-    enabled: true,
-    topics: {
-      readme: {
-        text: readmeText,
-      },
-    },
-  },
-  mcpServer: {
-    enabled: true,
-  },
-  install: {
-    updateGetLatest: async () => ({
-      path: process.execPath,
-      version: "1.0.0",
-    }),
-  },
-  commands: [
-    {
-      key: "status",
-      description: "Show resolved config and app version.",
-      options: [
-        {
-          name: "json",
-          description: "Emit JSON.",
-          kind: CliOptionKind.Presence,
-        },
-      ],
-      outputSchema: STATUS_JSON_OUTPUT_SCHEMA,
-      handler: (ctx) => {
-        const out: StatusJsonOutput = {
-          defaultRegion: ctx.appConfig.get("defaultRegion") as string | undefined,
-          maxRetries: ctx.appConfig.get("maxRetries") as number | undefined,
-          apiTokenSet: ctx.appConfig.get("apiToken") !== undefined,
-          version: ctx.program.version,
-        };
-        if (ctx.hasFlag("json")) {
-          console.log(JSON.stringify(out, null, 2));
-        } else {
-          console.log(`version=${out.version}`);
-          console.log(`region=${out.defaultRegion ?? "(not set)"}`);
-          console.log(`maxRetries=${out.maxRetries ?? "(not set)"}`);
-          console.log(`apiToken=${out.apiTokenSet ? "set" : "missing"}`);
-        }
-      },
-    },
-    {
-      key: "echo",
-      description: "Echo a message (MCP-friendly leaf).",
-      options: [
-        {
-          name: "message",
-          description: "Text to print.",
-          kind: CliOptionKind.String,
-          required: true,
-        },
-      ],
-      handler: (ctx) => {
-        console.log(ctx.stringOpt("message") ?? "");
-      },
-    },
-  ],
-} satisfies CliProgram;