commet 2.0.0 → 2.2.0

package/dist/index.js

@@ -24,13 +24,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_chalk14 = __toESM(require("chalk"));
-var import_commander10 = require("commander");
+var import_chalk16 = __toESM(require("chalk"));
+var import_commander11 = require("commander");
 
 // package.json
 var package_default = {
   name: "commet",
-  version: "2.0.0",
+  version: "2.2.0",
   description: "Commet CLI - Manage your billing platform from the command line",
   bin: {
     commet: "./bin/commet"
@@ -65,7 +65,8 @@ var package_default = {
     "jsonc-parser": "3.3.1",
     open: "11.0.0",
     ora: "9.4.0",
-    tar: "^7.5.13"
+    tar: "^7.5.13",
+    "@commet/node": "workspace:*"
   },
   devDependencies: {
     "@types/node": "24.12.4",
@@ -160,7 +161,7 @@ function clearProjectConfig() {
 }
 
 // src/utils/telemetry.ts
-var CLI_VERSION = true ? "2.0.0" : "0.0.0";
+var CLI_VERSION = true ? "2.2.0" : "0.0.0";
 var TELEMETRY_URL = "https://commet.co/api/cli/telemetry";
 function detectRuntime() {
   if ("Bun" in globalThis) {
@@ -405,10 +406,22 @@ Examples:
   $ commet api-key --output agent     JSON output with the key
 
 Then use it in CI:
-  $ COMMET_API_KEY=sk_... commet push --yes
+  $ COMMET_API_KEY=ck_... commet push --yes
 `
 ).action(async (options) => {
   const agentMode = isAgentMode(options);
+  if (agentMode) {
+    console.log(
+      JSON.stringify({
+        deprecated: true,
+        replacement: "commet api-keys create"
+      })
+    );
+  } else {
+    console.log(
+      import_chalk2.default.yellow("\u26A0 Deprecated: use 'commet api-keys create' instead")
+    );
+  }
   if (process.env.COMMET_API_KEY) {
     exitWithError({
       code: "invalid_context",
@@ -1229,6 +1242,26 @@ Examples:
     mode: selectedOrg.mode
   });
   const gitignoreResult = updateGitignore(".commet/");
+  let autoApiKey = null;
+  const keyResult = await apiRequest(
+    `${BASE_URL}/api/cli/api-keys`,
+    {
+      method: "POST",
+      body: JSON.stringify({
+        organizationId: selectedOrg.id,
+        name: "CLI (auto)"
+      })
+    }
+  ).catch(() => null);
+  if (keyResult?.data?.apiKey) {
+    autoApiKey = keyResult.data.apiKey;
+    saveProjectConfig({
+      orgId: selectedOrg.id,
+      orgName: selectedOrg.name,
+      mode: selectedOrg.mode,
+      apiKey: autoApiKey
+    });
+  }
   if (agentMode) {
     console.log(
       JSON.stringify({
@@ -1239,7 +1272,8 @@ Examples:
           name: selectedOrg.name,
           slug: selectedOrg.slug,
           mode: selectedOrg.mode
-        }
+        },
+        ...autoApiKey ? { apiKey: autoApiKey, apiKeyAutoGenerated: true } : {}
       })
     );
   } else {
@@ -1251,6 +1285,17 @@ Examples:
     if (gitignoreResult.success && action === "linked") {
       console.log(import_chalk6.default.green("\u2713 Updated .gitignore"));
     }
+    if (autoApiKey) {
+      console.log(
+        import_chalk6.default.green("\u2713 API key auto-generated for resource commands")
+      );
+    } else {
+      console.log(
+        import_chalk6.default.dim(
+          "  API key auto-generation failed. Run `commet api-keys create` to create one manually."
+        )
+      );
+    }
     console.log(import_chalk6.default.dim("\nRun `commet pull` to sync your config"));
   }
 });
@@ -1523,7 +1568,7 @@ var orgsCommand = new import_commander7.Command("orgs").description(
   `
 Examples:
   $ commet orgs                  Show orgs with current selection marked
-  $ commet orgs --json           JSON array for agent/CI use
+  $ commet orgs --output agent   JSON array for agent/CI use
 
 The slug shown here is what you pass to 'commet link --org <slug>'.
 `
@@ -1910,7 +1955,7 @@ Examples:
   $ commet pull --dry-run        Preview changes without applying
   $ commet pull --yes            Apply without confirmation
   $ commet pull --output agent --yes   Agent/CI \u2014 structured JSON, no prompts
-  $ COMMET_API_KEY=sk_... commet pull --yes   CI pipeline
+  $ COMMET_API_KEY=ck_... commet pull --yes   CI pipeline
 `
 ).action(async (options) => {
   const agentMode = isAgentMode(options);
@@ -2144,7 +2189,7 @@ Examples:
   $ commet push --dry-run        Preview what would change on remote
   $ commet push --yes            Push without confirmation
   $ commet push --output agent --yes   Agent/CI \u2014 structured JSON, no prompts
-  $ COMMET_API_KEY=sk_... commet push --yes   CI pipeline
+  $ COMMET_API_KEY=ck_... commet push --yes   CI pipeline
 `
 ).action(async (options) => {
   const agentMode = isAgentMode(options);
@@ -2314,196 +2359,2731 @@ Examples:
   }
 });
 
-// src/index.ts
-var program = new import_commander10.Command();
-program.name("commet").description(
-  "Commet CLI \u2014 billing infrastructure as code.\nManage features, plans, and billing config from the command line."
-).version(package_default.version).addHelpText(
-  "after",
-  `
-Workflow:
-  $ commet pull                  Sync remote \u2192 commet.config.ts
-  $ commet push                  Push local changes \u2192 remote
-  $ commet pull --dry-run         See what's configured
+// src/commands/resources/factory.ts
+var import_node2 = require("@commet/node");
+var import_chalk14 = __toESM(require("chalk"));
+var import_commander10 = require("commander");
+var import_ora8 = __toESM(require("ora"));
 
-For agents and CI:
-  $ commet                       JSON capabilities when piped (no args)
-  $ commet pull --output agent --yes   Structured output, no prompts
-  $ COMMET_API_KEY=sk_... commet push --yes   CI pipeline
+// src/utils/sdk.ts
+var import_node = require("@commet/node");
+function createSdkClient() {
+  const envKey = process.env.COMMET_API_KEY;
+  if (envKey) {
+    return new import_node.Commet({ apiKey: envKey });
+  }
+  const config = loadProjectConfig();
+  if (config?.apiKey) {
+    return new import_node.Commet({ apiKey: config.apiKey });
+  }
+  exitWithError({
+    code: "api_key_required",
+    message: "No API key found. Set COMMET_API_KEY env var, or run `commet link` to auto-generate one.",
+    action: "commet link"
+  });
+}
 
-Run commet <command> --help for detailed usage and examples.
-`
-);
-program.addCommand(createCommand);
-program.addCommand(loginCommand);
-program.addCommand(logoutCommand);
-program.addCommand(linkCommand);
-program.addCommand(orgsCommand);
-program.addCommand(pushCommand);
-program.addCommand(pullCommand);
-program.addCommand(listenCommand);
-program.addCommand(apiKeyCommand);
-program.enablePositionalOptions().passThroughOptions().option(
-  "--output <format>",
-  "Output format: human (default) or agent",
-  "human"
-);
-program.action((options) => {
-  if (options.output === "agent") {
-    printAgentInfo();
-  } else {
-    printDefaultScreen();
+// src/commands/resources/factory.ts
+function createResourceCommand(def) {
+  const command = new import_commander10.Command(def.name).description(def.description);
+  for (const [actionName, actionDef] of Object.entries(def.actions)) {
+    const subcommand = new import_commander10.Command(actionName).description(actionDef.description).option(
+      "--output <format>",
+      "Output format: human (default) or agent",
+      "human"
+    );
+    for (const param of actionDef.params) {
+      if (param.required) {
+        subcommand.requiredOption(param.flag, param.description);
+      } else {
+        subcommand.option(param.flag, param.description);
+      }
+    }
+    subcommand.action(async (options) => {
+      const agentMode = isAgentMode(options);
+      const spinner = agentMode ? null : (0, import_ora8.default)(`Running ${def.name} ${actionName}...`).start();
+      try {
+        const client = createSdkClient();
+        const resource = client[def.sdkProperty];
+        const method = resource[actionDef.method];
+        let params;
+        if (actionDef.buildParams) {
+          params = actionDef.buildParams(options);
+        } else {
+          const built = {};
+          for (const paramDef of actionDef.params) {
+            const rawValue = options[paramDef.sdkKey];
+            if (rawValue === void 0) {
+              continue;
+            }
+            built[paramDef.sdkKey] = paramDef.parse ? paramDef.parse(rawValue) : rawValue;
+          }
+          params = built;
+        }
+        const result = await method.call(resource, params);
+        spinner?.succeed(`${def.name} ${actionName}`);
+        if (agentMode) {
+          console.log(JSON.stringify(result));
+        } else {
+          console.log(JSON.stringify(result, null, 2));
+        }
+      } catch (error) {
+        if (error instanceof import_node2.CommetValidationError) {
+          spinner?.fail(`Validation error`);
+          if (agentMode) {
+            console.log(
+              JSON.stringify({
+                error: {
+                  code: "validation_error",
+                  message: error.message,
+                  validationErrors: error.validationErrors
+                }
+              })
+            );
+          } else {
+            console.error(import_chalk14.default.red(`\u2717 ${error.message}`));
+            for (const [field, messages] of Object.entries(
+              error.validationErrors
+            )) {
+              for (const msg of messages) {
+                console.error(import_chalk14.default.red(`  ${field}: ${msg}`));
+              }
+            }
+          }
+          process.exit(1);
+        }
+        if (error instanceof import_node2.CommetAPIError) {
+          spinner?.fail(`API error`);
+          if (agentMode) {
+            console.log(
+              JSON.stringify({
+                error: {
+                  code: error.code ?? `http_${error.statusCode}`,
+                  message: error.message,
+                  statusCode: error.statusCode
+                }
+              })
+            );
+          } else {
+            console.error(
+              import_chalk14.default.red(`\u2717 ${error.message} (${error.statusCode})`)
+            );
+          }
+          process.exit(1);
+        }
+        spinner?.fail(`Unexpected error`);
+        const message = error instanceof Error ? error.message : String(error);
+        if (agentMode) {
+          console.log(JSON.stringify({ error: { code: "unknown", message } }));
+        } else {
+          console.error(import_chalk14.default.red(`\u2717 ${message}`));
+        }
+        process.exit(1);
+      }
+    });
+    command.addCommand(subcommand);
   }
-});
-program.showSuggestionAfterError();
-program.exitOverride();
-installCrashHandler();
-markCommandStart();
-var commandName = process.argv[2] || "(default)";
-program.hook("postAction", () => {
-  reportCommand(commandName, "success");
-});
-try {
-  program.parse(process.argv);
-} catch (error) {
-  if (error instanceof Error) {
-    const code = error.code;
-    if (code === "commander.version" || code === "commander.help" || code === "commander.helpDisplayed") {
-      process.exit(0);
+  return command;
+}
+function generateResourceSchema(defs) {
+  const resources = {};
+  for (const def of defs) {
+    const actions = {};
+    for (const [actionName, actionDef] of Object.entries(def.actions)) {
+      const params = {};
+      for (const param of actionDef.params) {
+        params[param.sdkKey] = {
+          flag: param.flag,
+          description: param.description,
+          required: param.required ?? false
+        };
+      }
+      actions[actionName] = {
+        usage: `commet ${def.name} ${actionName}`,
+        description: actionDef.description,
+        params
+      };
     }
-    reportCommand(commandName, "error", code);
-    console.error(import_chalk14.default.red("Error:"), error.message);
+    resources[def.name] = {
+      description: def.description,
+      actions
+    };
   }
-  process.exit(1);
+  return resources;
 }
-function printAgentInfo() {
-  const authenticated = authExists() || !!process.env.COMMET_API_KEY;
-  const projectConfig = projectConfigExists() ? loadProjectConfig() : null;
-  const configPath = findConfigFile(process.cwd());
-  const setup = [];
-  if (!authenticated) {
-    setup.push(
-      "Not authenticated. Run 'commet login' (interactive) or set COMMET_API_KEY env var."
-    );
+
+// src/commands/resources/param-types.ts
+function parseJson(value) {
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new Error(`Invalid JSON: ${value}`);
   }
-  if (authenticated && !projectConfig && !process.env.COMMET_API_KEY) {
-    setup.push(
-      "No project linked. Run 'commet link --org <slug>' or 'commet orgs --json' to find organizations."
-    );
+}
+function parseNumber(value) {
+  const num = Number(value);
+  if (Number.isNaN(num)) {
+    throw new Error(`Invalid number: ${value}`);
   }
-  const output = {
-    version: package_default.version,
-    authenticated,
-    ...setup.length > 0 ? { setup } : {},
-    project: projectConfig ? {
-      linked: true,
-      orgId: projectConfig.orgId,
-      orgName: projectConfig.orgName,
-      mode: projectConfig.mode
-    } : { linked: false },
-    config: {
-      exists: configPath !== null,
-      path: configPath?.split("/").pop() ?? null
+  return num;
+}
+function parseBool(value) {
+  if (value === "true") return true;
+  if (value === "false") return false;
+  throw new Error(`Invalid boolean: ${value}. Expected "true" or "false".`);
+}
+
+// src/commands/resources/registry.ts
+var customersResource = {
+  name: "customers",
+  description: "Manage customers",
+  sdkProperty: "customers",
+  actions: {
+    create: {
+      method: "create",
+      description: "Create a customer",
+      params: [
+        {
+          flag: "--email <email>",
+          description: "Billing email (required)",
+          required: true,
+          sdkKey: "email"
+        },
+        { flag: "--id <id>", description: "Custom customer ID", sdkKey: "id" },
+        {
+          flag: "--full-name <name>",
+          description: "Full name",
+          sdkKey: "fullName"
+        },
+        { flag: "--domain <domain>", description: "Domain", sdkKey: "domain" },
+        {
+          flag: "--website <url>",
+          description: "Website URL",
+          sdkKey: "website"
+        },
+        {
+          flag: "--timezone <tz>",
+          description: "Timezone",
+          sdkKey: "timezone"
+        },
+        {
+          flag: "--language <lang>",
+          description: "Language code",
+          sdkKey: "language"
+        },
+        {
+          flag: "--industry <industry>",
+          description: "Industry",
+          sdkKey: "industry"
+        },
+        {
+          flag: "--metadata <json>",
+          description: "Metadata (JSON)",
+          parse: parseJson,
+          sdkKey: "metadata"
+        },
+        {
+          flag: "--address <json>",
+          description: "Address (JSON: {line1, city, postalCode, country, ...})",
+          parse: parseJson,
+          sdkKey: "address"
+        }
+      ]
     },
-    mcp: {
-      url: "https://commet.co/mcp",
-      sandbox: "https://sandbox.commet.co/mcp",
-      hint: "For full billing CRUD (plans, features, customers, subscriptions), connect to the MCP server."
+    "create-batch": {
+      method: "createBatch",
+      description: "Create multiple customers in a batch",
+      params: [
+        {
+          flag: "--customers <json>",
+          description: "Array of customer objects (JSON)",
+          required: true,
+          parse: parseJson,
+          sdkKey: "customers"
+        }
+      ]
     },
-    auth: {
-      interactive: "commet login",
-      ci: "Set COMMET_API_KEY environment variable"
+    get: {
+      method: "get",
+      description: "Get a customer by ID",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
     },
-    commands: {
-      pull: {
-        description: "Pull remote config and generate commet.config.ts",
-        usage: "commet pull --output agent --yes",
-        preview: "commet pull --output agent --dry-run"
-      },
-      push: {
-        description: "Push commet.config.ts to remote",
-        usage: "commet push --output agent --yes",
-        preview: "commet push --output agent --dry-run",
-        ci: "COMMET_API_KEY=sk_... commet push --yes"
-      },
-      orgs: {
-        description: "List available organizations",
-        usage: "commet orgs --output agent"
-      },
-      link: {
-        description: "Link/switch/unlink organization",
-        usage: "commet link --org <slug-or-id>",
-        clear: "commet link --clear"
-      },
-      listen: {
-        description: "Forward webhook events to local server. Long-running streaming process.",
-        usage: "commet listen <url> [--events <types>]"
-      },
-      create: {
-        description: "Scaffold a new Commet app from template",
-        usage: "commet create [name] -t <template> --org <slug> -y"
-      },
-      "api-key": {
-        description: "Generate API key for CI",
-        usage: "commet api-key --output agent"
-      },
-      login: {
-        description: "Authenticate via browser. Requires a human \u2014 opens a device-code flow.",
-        usage: "commet login"
-      },
-      logout: {
-        description: "Log out of Commet",
-        usage: "commet logout"
-      }
+    update: {
+      method: "update",
+      description: "Update a customer",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--email <email>",
+          description: "Billing email",
+          sdkKey: "email"
+        },
+        {
+          flag: "--full-name <name>",
+          description: "Full name",
+          sdkKey: "fullName"
+        },
+        { flag: "--domain <domain>", description: "Domain", sdkKey: "domain" },
+        {
+          flag: "--website <url>",
+          description: "Website URL",
+          sdkKey: "website"
+        },
+        {
+          flag: "--timezone <tz>",
+          description: "Timezone",
+          sdkKey: "timezone"
+        },
+        {
+          flag: "--language <lang>",
+          description: "Language code",
+          sdkKey: "language"
+        },
+        {
+          flag: "--industry <industry>",
+          description: "Industry",
+          sdkKey: "industry"
+        },
+        {
+          flag: "--metadata <json>",
+          description: "Metadata (JSON)",
+          parse: parseJson,
+          sdkKey: "metadata"
+        },
+        {
+          flag: "--address <json>",
+          description: "Address (JSON)",
+          parse: parseJson,
+          sdkKey: "address"
+        }
+      ]
+    },
+    list: {
+      method: "list",
+      description: "List customers",
+      params: [
+        {
+          flag: "--search <query>",
+          description: "Search query",
+          sdkKey: "search"
+        },
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        },
+        {
+          flag: "--start-date <date>",
+          description: "Start date filter",
+          sdkKey: "startDate"
+        },
+        {
+          flag: "--end-date <date>",
+          description: "End date filter",
+          sdkKey: "endDate"
+        }
+      ]
     }
-  };
-  console.log(JSON.stringify(output, null, 2));
-}
-function printDefaultScreen() {
-  const version = import_chalk14.default.dim(`v${package_default.version}`);
-  console.log(`
-  ${commetColor.bold("Commet")} ${version}`);
-  console.log(import_chalk14.default.dim("  Billing infrastructure as code\n"));
-  const authenticated = authExists();
-  const projectConfig = projectConfigExists() ? loadProjectConfig() : null;
-  const configFile = findConfigFile(process.cwd());
-  if (authenticated) {
-    console.log(import_chalk14.default.green("  \u2713 Authenticated"));
-  } else {
-    console.log(
-      `  ${import_chalk14.default.yellow("\u26A0")} Not logged in ${import_chalk14.default.dim("\u2192 commet login")}`
-    );
-  }
-  if (projectConfig) {
-    console.log(
-      import_chalk14.default.green(
-        `  \u2713 ${projectConfig.orgName} ${import_chalk14.default.dim(`(${projectConfig.mode})`)}`
-      )
-    );
-    console.log(import_chalk14.default.dim(`    ${projectConfig.orgId}`));
-  } else if (authenticated) {
-    console.log(
-      `  ${import_chalk14.default.yellow("\u26A0")} No project linked ${import_chalk14.default.dim("\u2192 commet link")}`
-    );
-  }
-  if (configFile) {
-    const fileName = configFile.split("/").pop();
-    console.log(import_chalk14.default.green(`  \u2713 ${fileName}`));
-  } else if (projectConfig) {
-    console.log(
-      `  ${import_chalk14.default.yellow("\u26A0")} No config file ${import_chalk14.default.dim("\u2192 commet pull")}`
-    );
   }
-  const cmd = (name) => commetColor(name.padEnd(22));
-  const dim = import_chalk14.default.dim;
-  console.log(dim("\n  Config"));
-  console.log(`    ${cmd("pull")}${dim("Sync remote \u2192 commet.config.ts")}`);
-  console.log(`    ${cmd("push")}${dim("Sync commet.config.ts \u2192 remote")}`);
-  console.log(dim("\n  Development"));
-  console.log(`    ${cmd("listen <url>")}${dim("Forward webhooks locally")}`);
-  console.log(dim("\n  Project"));
-  console.log(`    ${cmd("link")}${dim("Link / switch organization")}`);
+};
+var subscriptionsResource = {
+  name: "subscriptions",
+  description: "Manage subscriptions",
+  sdkProperty: "subscriptions",
+  actions: {
+    create: {
+      method: "create",
+      description: "Create a subscription",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID (required)",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--plan-code <code>",
+          description: "Plan code (provide this or --plan-id)",
+          sdkKey: "planCode"
+        },
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID (provide this or --plan-code)",
+          sdkKey: "planId"
+        },
+        {
+          flag: "--billing-interval <interval>",
+          description: "Billing interval: weekly, monthly, quarterly, yearly, one_time",
+          sdkKey: "billingInterval"
+        },
+        {
+          flag: "--initial-seats <json>",
+          description: "Initial seats map (JSON: {featureCode: count})",
+          parse: parseJson,
+          sdkKey: "initialSeats"
+        },
+        {
+          flag: "--skip-trial <bool>",
+          description: "Skip trial period",
+          parse: parseBool,
+          sdkKey: "skipTrial"
+        },
+        {
+          flag: "--name <name>",
+          description: "Subscription name",
+          sdkKey: "name"
+        },
+        {
+          flag: "--start-date <date>",
+          description: "Start date (ISO 8601)",
+          sdkKey: "startDate"
+        },
+        {
+          flag: "--success-url <url>",
+          description: "Redirect URL after successful checkout",
+          sdkKey: "successUrl"
+        }
+      ],
+      buildParams: (options) => {
+        const params = {
+          customerId: options.customerId
+        };
+        if (options.planCode) params.planCode = options.planCode;
+        if (options.planId) params.planId = options.planId;
+        if (options.billingInterval)
+          params.billingInterval = options.billingInterval;
+        if (options.initialSeats)
+          params.initialSeats = parseJson(options.initialSeats);
+        if (options.skipTrial) params.skipTrial = parseBool(options.skipTrial);
+        if (options.name) params.name = options.name;
+        if (options.startDate) params.startDate = options.startDate;
+        if (options.successUrl) params.successUrl = options.successUrl;
+        return params;
+      }
+    },
+    "get-active": {
+      method: "getActive",
+      description: "Get the active subscription for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        }
+      ]
+    },
+    cancel: {
+      method: "cancel",
+      description: "Cancel a subscription",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--reason <reason>",
+          description: "Cancellation reason",
+          sdkKey: "reason"
+        },
+        {
+          flag: "--immediate <bool>",
+          description: "Cancel immediately instead of at period end",
+          parse: parseBool,
+          sdkKey: "immediate"
+        }
+      ]
+    },
+    uncancel: {
+      method: "uncancel",
+      description: "Revert a pending cancellation",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    "change-plan": {
+      method: "changePlan",
+      description: "Change subscription plan",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--new-plan-id <id>",
+          description: "New plan ID",
+          sdkKey: "newPlanId"
+        },
+        {
+          flag: "--new-billing-interval <interval>",
+          description: "New billing interval",
+          sdkKey: "newBillingInterval"
+        }
+      ]
+    },
+    list: {
+      method: "list",
+      description: "List subscriptions",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Filter by customer ID",
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--status <status>",
+          description: "Filter by status",
+          sdkKey: "status"
+        },
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    "preview-change": {
+      method: "previewChange",
+      description: "Preview plan change proration without applying",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--plan-id <planId>",
+          description: "New plan ID",
+          sdkKey: "planId"
+        },
+        {
+          flag: "--billing-interval <interval>",
+          description: "New billing interval",
+          sdkKey: "billingInterval"
+        }
+      ]
+    },
+    "activate-addon": {
+      method: "activateAddon",
+      description: "Activate an addon on a subscription",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--addon-id <addonId>",
+          description: "Addon ID",
+          required: true,
+          sdkKey: "addonId"
+        }
+      ]
+    },
+    "deactivate-addon": {
+      method: "deactivateAddon",
+      description: "Deactivate an addon from a subscription",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--addon-id <addonId>",
+          description: "Addon ID",
+          required: true,
+          sdkKey: "addonId"
+        }
+      ]
+    },
+    "adjust-balance": {
+      method: "adjustBalance",
+      description: "Adjust subscription balance or credits",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--amount <amount>",
+          description: "Amount (positive adds, negative subtracts)",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "amount"
+        },
+        {
+          flag: "--reason <reason>",
+          description: "Reason for adjustment",
+          sdkKey: "reason"
+        },
+        {
+          flag: "--type <type>",
+          description: "Adjustment type: balance or credits",
+          sdkKey: "type"
+        }
+      ]
+    },
+    "topup-balance": {
+      method: "topupBalance",
+      description: "Top up subscription balance (charges payment method)",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--amount <amount>",
+          description: "Amount to top up",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "amount"
+        }
+      ]
+    },
+    "purchase-credits": {
+      method: "purchaseCredits",
+      description: "Purchase a credit pack for a subscription",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Subscription ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--credit-pack-id <creditPackId>",
+          description: "Credit pack ID",
+          required: true,
+          sdkKey: "creditPackId"
+        }
+      ]
+    }
+  }
+};
+var plansResource = {
+  name: "plans",
+  description: "Manage plans",
+  sdkProperty: "plans",
+  actions: {
+    list: {
+      method: "list",
+      description: "List plans",
+      params: [
+        {
+          flag: "--include-private <bool>",
+          description: "Include private plans",
+          parse: parseBool,
+          sdkKey: "includePrivate"
+        },
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    get: {
+      method: "get",
+      description: "Get plan details",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create a plan",
+      params: [
+        {
+          flag: "--name <name>",
+          description: "Plan name",
+          required: true,
+          sdkKey: "name"
+        },
+        {
+          flag: "--code <code>",
+          description: "Plan code",
+          required: true,
+          sdkKey: "code"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Plan description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--consumption-model <model>",
+          description: "Consumption model: metered, credits, or balance",
+          sdkKey: "consumptionModel"
+        },
+        {
+          flag: "--is-public <bool>",
+          description: "Whether plan is publicly visible",
+          parse: parseBool,
+          sdkKey: "isPublic"
+        },
+        {
+          flag: "--is-free <bool>",
+          description: "Whether plan is free",
+          parse: parseBool,
+          sdkKey: "isFree"
+        },
+        {
+          flag: "--block-on-exhaustion <bool>",
+          description: "Block usage when balance/credits exhausted",
+          parse: parseBool,
+          sdkKey: "blockOnExhaustion"
+        },
+        {
+          flag: "--plan-group-id <id>",
+          description: "Plan group ID",
+          sdkKey: "planGroupId"
+        },
+        {
+          flag: "--metadata <json>",
+          description: "Metadata (JSON)",
+          parse: parseJson,
+          sdkKey: "metadata"
+        }
+      ]
+    },
+    update: {
+      method: "update",
+      description: "Update a plan",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--name <name>",
+          description: "Plan name",
+          sdkKey: "name"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Plan description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--metadata <json>",
+          description: "Metadata (JSON)",
+          parse: parseJson,
+          sdkKey: "metadata"
+        },
+        {
+          flag: "--is-public <bool>",
+          description: "Whether plan is publicly visible",
+          parse: parseBool,
+          sdkKey: "isPublic"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete a plan",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    "set-visibility": {
+      method: "setVisibility",
+      description: "Set plan visibility",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--is-public <bool>",
+          description: "Public visibility",
+          required: true,
+          parse: parseBool,
+          sdkKey: "isPublic"
+        }
+      ]
+    },
+    "add-feature": {
+      method: "addFeature",
+      description: "Add a feature to a plan",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--feature-id <id>",
+          description: "Feature ID",
+          required: true,
+          sdkKey: "featureId"
+        },
+        {
+          flag: "--enabled <bool>",
+          description: "Whether feature is enabled",
+          parse: parseBool,
+          sdkKey: "enabled"
+        },
+        {
+          flag: "--included-amount <n>",
+          description: "Included amount",
+          parse: parseNumber,
+          sdkKey: "includedAmount"
+        },
+        {
+          flag: "--unlimited <bool>",
+          description: "Whether usage is unlimited",
+          parse: parseBool,
+          sdkKey: "unlimited"
+        },
+        {
+          flag: "--overage-enabled <bool>",
+          description: "Whether overage is enabled",
+          parse: parseBool,
+          sdkKey: "overageEnabled"
+        },
+        {
+          flag: "--overage-unit-price <n>",
+          description: "Overage unit price (fixed pricing)",
+          parse: parseNumber,
+          sdkKey: "overageUnitPrice"
+        },
+        {
+          flag: "--pricing-mode <mode>",
+          description: "Pricing mode: fixed or ai_model",
+          sdkKey: "pricingMode"
+        },
+        {
+          flag: "--margin <n>",
+          description: "Margin percentage (ai_model pricing)",
+          parse: parseNumber,
+          sdkKey: "margin"
+        },
+        {
+          flag: "--credits-per-unit <n>",
+          description: "Credits per unit",
+          parse: parseNumber,
+          sdkKey: "creditsPerUnit"
+        }
+      ]
+    },
+    "update-feature": {
+      method: "updateFeature",
+      description: "Update a feature on a plan",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--feature-id <id>",
+          description: "Feature ID",
+          required: true,
+          sdkKey: "featureId"
+        },
+        {
+          flag: "--enabled <bool>",
+          description: "Whether feature is enabled",
+          parse: parseBool,
+          sdkKey: "enabled"
+        },
+        {
+          flag: "--included-amount <n>",
+          description: "Included amount",
+          parse: parseNumber,
+          sdkKey: "includedAmount"
+        },
+        {
+          flag: "--unlimited <bool>",
+          description: "Whether usage is unlimited",
+          parse: parseBool,
+          sdkKey: "unlimited"
+        },
+        {
+          flag: "--overage-enabled <bool>",
+          description: "Whether overage is enabled",
+          parse: parseBool,
+          sdkKey: "overageEnabled"
+        },
+        {
+          flag: "--overage-unit-price <n>",
+          description: "Overage unit price (fixed pricing)",
+          parse: parseNumber,
+          sdkKey: "overageUnitPrice"
+        },
+        {
+          flag: "--pricing-mode <mode>",
+          description: "Pricing mode: fixed or ai_model",
+          sdkKey: "pricingMode"
+        },
+        {
+          flag: "--margin <n>",
+          description: "Margin percentage (ai_model pricing)",
+          parse: parseNumber,
+          sdkKey: "margin"
+        },
+        {
+          flag: "--credits-per-unit <n>",
+          description: "Credits per unit",
+          parse: parseNumber,
+          sdkKey: "creditsPerUnit"
+        }
+      ]
+    },
+    "remove-feature": {
+      method: "removeFeature",
+      description: "Remove a feature from a plan",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--feature-id <id>",
+          description: "Feature ID",
+          required: true,
+          sdkKey: "featureId"
+        }
+      ]
+    },
+    "add-price": {
+      method: "addPrice",
+      description: "Add a price to a plan",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--billing-interval <interval>",
+          description: "Billing interval: weekly, monthly, quarterly, yearly, one_time",
+          required: true,
+          sdkKey: "billingInterval"
+        },
+        {
+          flag: "--price <n>",
+          description: "Price in cents",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "price"
+        },
+        {
+          flag: "--trial-days <n>",
+          description: "Trial days",
+          parse: parseNumber,
+          sdkKey: "trialDays"
+        },
+        {
+          flag: "--is-default <bool>",
+          description: "Set as default price",
+          parse: parseBool,
+          sdkKey: "isDefault"
+        },
+        {
+          flag: "--included-balance <n>",
+          description: "Included balance",
+          parse: parseNumber,
+          sdkKey: "includedBalance"
+        },
+        {
+          flag: "--included-credits <n>",
+          description: "Included credits",
+          parse: parseNumber,
+          sdkKey: "includedCredits"
+        },
+        {
+          flag: "--intro-offer-enabled <bool>",
+          description: "Enable intro offer",
+          parse: parseBool,
+          sdkKey: "introOfferEnabled"
+        },
+        {
+          flag: "--intro-offer-discount-type <type>",
+          description: "Intro offer discount type: percentage or amount",
+          sdkKey: "introOfferDiscountType"
+        },
+        {
+          flag: "--intro-offer-discount-value <n>",
+          description: "Intro offer discount value",
+          parse: parseNumber,
+          sdkKey: "introOfferDiscountValue"
+        },
+        {
+          flag: "--intro-offer-duration-cycles <n>",
+          description: "Intro offer duration in cycles",
+          parse: parseNumber,
+          sdkKey: "introOfferDurationCycles"
+        }
+      ]
+    },
+    "update-price": {
+      method: "updatePrice",
+      description: "Update a plan price",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--price-id <id>",
+          description: "Price ID",
+          required: true,
+          sdkKey: "priceId"
+        },
+        {
+          flag: "--price <n>",
+          description: "Price in cents",
+          parse: parseNumber,
+          sdkKey: "price"
+        },
+        {
+          flag: "--is-default <bool>",
+          description: "Set as default price",
+          parse: parseBool,
+          sdkKey: "isDefault"
+        },
+        {
+          flag: "--trial-days <n>",
+          description: "Trial days",
+          parse: parseNumber,
+          sdkKey: "trialDays"
+        },
+        {
+          flag: "--included-balance <n>",
+          description: "Included balance",
+          parse: parseNumber,
+          sdkKey: "includedBalance"
+        },
+        {
+          flag: "--included-credits <n>",
+          description: "Included credits",
+          parse: parseNumber,
+          sdkKey: "includedCredits"
+        },
+        {
+          flag: "--intro-offer-enabled <bool>",
+          description: "Enable intro offer",
+          parse: parseBool,
+          sdkKey: "introOfferEnabled"
+        },
+        {
+          flag: "--intro-offer-discount-type <type>",
+          description: "Intro offer discount type: percentage or amount",
+          sdkKey: "introOfferDiscountType"
+        },
+        {
+          flag: "--intro-offer-discount-value <n>",
+          description: "Intro offer discount value",
+          parse: parseNumber,
+          sdkKey: "introOfferDiscountValue"
+        },
+        {
+          flag: "--intro-offer-duration-cycles <n>",
+          description: "Intro offer duration in cycles",
+          parse: parseNumber,
+          sdkKey: "introOfferDurationCycles"
+        }
+      ]
+    },
+    "delete-price": {
+      method: "deletePrice",
+      description: "Delete a plan price",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--price-id <id>",
+          description: "Price ID",
+          required: true,
+          sdkKey: "priceId"
+        }
+      ]
+    },
+    "set-default-price": {
+      method: "setDefaultPrice",
+      description: "Set a price as the default for a plan",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--price-id <id>",
+          description: "Price ID",
+          required: true,
+          sdkKey: "priceId"
+        }
+      ]
+    },
+    "set-regional-prices": {
+      method: "setRegionalPrices",
+      description: "Set regional price overrides",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--price-id <id>",
+          description: "Price ID",
+          required: true,
+          sdkKey: "priceId"
+        },
+        {
+          flag: "--overrides <json>",
+          description: 'Regional overrides (JSON: [{currency: "EUR", price: 900}])',
+          required: true,
+          parse: parseJson,
+          sdkKey: "overrides"
+        }
+      ]
+    },
+    "delete-regional-prices": {
+      method: "deleteRegionalPrices",
+      description: "Delete regional price overrides",
+      params: [
+        {
+          flag: "--plan-id <id>",
+          description: "Plan ID",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--price-id <id>",
+          description: "Price ID",
+          required: true,
+          sdkKey: "priceId"
+        }
+      ]
+    }
+  }
+};
+var featuresResource = {
+  name: "features",
+  description: "Manage features and check feature access",
+  sdkProperty: "features",
+  actions: {
+    get: {
+      method: "get",
+      description: "Get feature access for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "code"
+        }
+      ]
+    },
+    "can-use": {
+      method: "canUse",
+      description: "Check if a customer can use a feature",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "code"
+        }
+      ]
+    },
+    list: {
+      method: "list",
+      description: "List features for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create a feature",
+      params: [
+        {
+          flag: "--code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "code"
+        },
+        {
+          flag: "--name <name>",
+          description: "Feature name",
+          required: true,
+          sdkKey: "name"
+        },
+        {
+          flag: "--type <type>",
+          description: "Feature type: boolean, usage, or seats",
+          required: true,
+          sdkKey: "type"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Feature description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--unit-name <name>",
+          description: "Unit name for metered features",
+          sdkKey: "unitName"
+        }
+      ]
+    },
+    update: {
+      method: "update",
+      description: "Update a feature",
+      params: [
+        {
+          flag: "--code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "code"
+        },
+        {
+          flag: "--name <name>",
+          description: "Feature name",
+          sdkKey: "name"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Feature description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--unit-name <name>",
+          description: "Unit name",
+          sdkKey: "unitName"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete a feature",
+      params: [
+        {
+          flag: "--code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "code"
+        }
+      ]
+    }
+  }
+};
+var seatsResource = {
+  name: "seats",
+  description: "Manage seat allocations",
+  sdkProperty: "seats",
+  actions: {
+    add: {
+      method: "add",
+      description: "Add seats for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--feature-code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "featureCode"
+        },
+        {
+          flag: "--count <n>",
+          description: "Number of seats to add (defaults to 1)",
+          parse: parseNumber,
+          sdkKey: "count"
+        }
+      ]
+    },
+    remove: {
+      method: "remove",
+      description: "Remove seats for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--feature-code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "featureCode"
+        },
+        {
+          flag: "--count <n>",
+          description: "Number of seats to remove (defaults to 1)",
+          parse: parseNumber,
+          sdkKey: "count"
+        }
+      ]
+    },
+    set: {
+      method: "set",
+      description: "Set exact seat count for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--feature-code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "featureCode"
+        },
+        {
+          flag: "--count <n>",
+          description: "Exact seat count",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "count"
+        }
+      ]
+    },
+    "set-all": {
+      method: "setAll",
+      description: "Set all seat counts for a customer at once",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--seats <json>",
+          description: "Seats map (JSON: {featureCode: count})",
+          required: true,
+          parse: parseJson,
+          sdkKey: "seats"
+        }
+      ]
+    },
+    "get-balance": {
+      method: "getBalance",
+      description: "Get seat balance for a specific feature",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--feature-code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "featureCode"
+        }
+      ]
+    },
+    "get-all-balances": {
+      method: "getAllBalances",
+      description: "Get all seat balances for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        }
+      ]
+    }
+  }
+};
+var usageResource = {
+  name: "usage",
+  description: "Track usage events",
+  sdkProperty: "usage",
+  actions: {
+    track: {
+      method: "track",
+      description: "Track a usage event",
+      params: [
+        {
+          flag: "--feature <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "feature"
+        },
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--value <n>",
+          description: "Usage value (standard tracking)",
+          parse: parseNumber,
+          sdkKey: "value"
+        },
+        {
+          flag: "--model <model>",
+          description: "AI model name (model token tracking)",
+          sdkKey: "model"
+        },
+        {
+          flag: "--input-tokens <n>",
+          description: "Input tokens (model tracking)",
+          parse: parseNumber,
+          sdkKey: "inputTokens"
+        },
+        {
+          flag: "--output-tokens <n>",
+          description: "Output tokens (model tracking)",
+          parse: parseNumber,
+          sdkKey: "outputTokens"
+        },
+        {
+          flag: "--cache-read-tokens <n>",
+          description: "Cache read tokens (model tracking)",
+          parse: parseNumber,
+          sdkKey: "cacheReadTokens"
+        },
+        {
+          flag: "--cache-write-tokens <n>",
+          description: "Cache write tokens (model tracking)",
+          parse: parseNumber,
+          sdkKey: "cacheWriteTokens"
+        },
+        {
+          flag: "--idempotency-key <key>",
+          description: "Idempotency key for deduplication",
+          sdkKey: "idempotencyKey"
+        },
+        {
+          flag: "--timestamp <ts>",
+          description: "Event timestamp (ISO 8601)",
+          sdkKey: "timestamp"
+        },
+        {
+          flag: "--properties <json>",
+          description: "Event properties (JSON: {key: value})",
+          parse: parseJson,
+          sdkKey: "properties"
+        }
+      ],
+      buildParams: (options) => {
+        const params = {
+          feature: options.feature,
+          customerId: options.customerId
+        };
+        if (options.idempotencyKey)
+          params.idempotencyKey = options.idempotencyKey;
+        if (options.timestamp) params.timestamp = options.timestamp;
+        if (options.properties)
+          params.properties = parseJson(options.properties);
+        if (options.model) {
+          params.model = options.model;
+          params.inputTokens = parseNumber(options.inputTokens);
+          params.outputTokens = parseNumber(options.outputTokens);
+          if (options.cacheReadTokens)
+            params.cacheReadTokens = parseNumber(options.cacheReadTokens);
+          if (options.cacheWriteTokens)
+            params.cacheWriteTokens = parseNumber(options.cacheWriteTokens);
+        } else {
+          if (options.value) params.value = parseNumber(options.value);
+        }
+        return params;
+      }
+    },
+    check: {
+      method: "check",
+      description: "Check if a usage event would be allowed",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--feature-code <code>",
+          description: "Feature code",
+          required: true,
+          sdkKey: "featureCode"
+        },
+        {
+          flag: "--quantity <n>",
+          description: "Quantity to check",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "quantity"
+        }
+      ]
+    }
+  }
+};
+var portalResource = {
+  name: "portal",
+  description: "Customer portal access",
+  sdkProperty: "portal",
+  actions: {
+    "get-url": {
+      method: "getUrl",
+      description: "Get a portal URL for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID (provide this or --email)",
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--email <email>",
+          description: "Customer email (provide this or --customer-id)",
+          sdkKey: "email"
+        }
+      ],
+      buildParams: (options) => {
+        if (options.customerId) {
+          return { customerId: options.customerId };
+        }
+        if (options.email) {
+          return { email: options.email };
+        }
+        throw new Error("Either --customer-id or --email is required");
+      }
+    }
+  }
+};
+var addonsResource = {
+  name: "addons",
+  description: "Manage addons",
+  sdkProperty: "addons",
+  actions: {
+    "list-active": {
+      method: "listActive",
+      description: "List active addons for a customer",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        }
+      ]
+    },
+    list: {
+      method: "list",
+      description: "List all addons",
+      params: [
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    get: {
+      method: "get",
+      description: "Get addon details",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Addon ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create an addon",
+      params: [
+        {
+          flag: "--name <name>",
+          description: "Addon name",
+          required: true,
+          sdkKey: "name"
+        },
+        {
+          flag: "--base-price <n>",
+          description: "Base price in cents",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "basePrice"
+        },
+        {
+          flag: "--feature-id <id>",
+          description: "Feature ID",
+          required: true,
+          sdkKey: "featureId"
+        },
+        {
+          flag: "--consumption-model <model>",
+          description: "Consumption model: boolean, metered, credits, or balance",
+          required: true,
+          sdkKey: "consumptionModel"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Addon description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--included-units <n>",
+          description: "Included units (metered)",
+          parse: parseNumber,
+          sdkKey: "includedUnits"
+        },
+        {
+          flag: "--overage-rate <n>",
+          description: "Overage rate (metered/balance)",
+          parse: parseNumber,
+          sdkKey: "overageRate"
+        },
+        {
+          flag: "--credit-cost <n>",
+          description: "Credit cost (credits)",
+          parse: parseNumber,
+          sdkKey: "creditCost"
+        }
+      ]
+    },
+    update: {
+      method: "update",
+      description: "Update an addon",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Addon ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--name <name>",
+          description: "Addon name",
+          sdkKey: "name"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Addon description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--base-price <n>",
+          description: "Base price in cents",
+          parse: parseNumber,
+          sdkKey: "basePrice"
+        },
+        {
+          flag: "--included-units <n>",
+          description: "Included units",
+          parse: parseNumber,
+          sdkKey: "includedUnits"
+        },
+        {
+          flag: "--overage-rate <n>",
+          description: "Overage rate",
+          parse: parseNumber,
+          sdkKey: "overageRate"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete an addon",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Addon ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    }
+  }
+};
+var creditPacksResource = {
+  name: "credit-packs",
+  description: "Manage credit packs",
+  sdkProperty: "creditPacks",
+  actions: {
+    list: {
+      method: "list",
+      description: "List credit packs",
+      params: []
+    },
+    create: {
+      method: "create",
+      description: "Create a credit pack",
+      params: [
+        {
+          flag: "--name <name>",
+          description: "Credit pack name",
+          required: true,
+          sdkKey: "name"
+        },
+        {
+          flag: "--credits <n>",
+          description: "Number of credits",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "credits"
+        },
+        {
+          flag: "--price <n>",
+          description: "Price in cents",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "price"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Credit pack description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--is-active <bool>",
+          description: "Whether credit pack is active",
+          parse: parseBool,
+          sdkKey: "isActive"
+        }
+      ]
+    },
+    update: {
+      method: "update",
+      description: "Update a credit pack",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Credit pack ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--name <name>",
+          description: "Credit pack name",
+          sdkKey: "name"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Credit pack description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--credits <n>",
+          description: "Number of credits",
+          parse: parseNumber,
+          sdkKey: "credits"
+        },
+        {
+          flag: "--price <n>",
+          description: "Price in cents",
+          parse: parseNumber,
+          sdkKey: "price"
+        },
+        {
+          flag: "--is-active <bool>",
+          description: "Whether credit pack is active",
+          parse: parseBool,
+          sdkKey: "isActive"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete a credit pack",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Credit pack ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    }
+  }
+};
+var webhooksResource = {
+  name: "webhooks",
+  description: "Manage webhook endpoints",
+  sdkProperty: "webhooks",
+  actions: {
+    list: {
+      method: "list",
+      description: "List webhook endpoints",
+      params: [
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create a webhook endpoint",
+      params: [
+        {
+          flag: "--url <url>",
+          description: "Webhook URL",
+          required: true,
+          sdkKey: "url"
+        },
+        {
+          flag: "--events <json>",
+          description: 'Events to subscribe to (JSON array: ["subscription.created"])',
+          required: true,
+          parse: parseJson,
+          sdkKey: "events"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Webhook description",
+          sdkKey: "description"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete a webhook endpoint",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Webhook endpoint ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    test: {
+      method: "test",
+      description: "Send a test event to a webhook endpoint",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Webhook endpoint ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    }
+  }
+};
+var apiKeysResource = {
+  name: "api-keys",
+  description: "Manage API keys",
+  sdkProperty: "apiKeys",
+  actions: {
+    list: {
+      method: "list",
+      description: "List API keys",
+      params: [
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create an API key",
+      params: [
+        {
+          flag: "--name <name>",
+          description: "API key name",
+          required: true,
+          sdkKey: "name"
+        },
+        {
+          flag: "--expires-in-days <n>",
+          description: "Expiration in days",
+          parse: parseNumber,
+          sdkKey: "expiresInDays"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete an API key",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "API key ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    }
+  }
+};
+var invoicesResource = {
+  name: "invoices",
+  description: "Manage invoices",
+  sdkProperty: "invoices",
+  actions: {
+    list: {
+      method: "list",
+      description: "List invoices",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Filter by customer ID",
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--status <status>",
+          description: "Filter by status",
+          sdkKey: "status"
+        },
+        {
+          flag: "--subscription-id <id>",
+          description: "Filter by subscription ID",
+          sdkKey: "subscriptionId"
+        },
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    get: {
+      method: "get",
+      description: "Get invoice details",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Invoice ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    "create-adjustment": {
+      method: "createAdjustment",
+      description: "Create an adjustment invoice (negative amount = credit)",
+      params: [
+        {
+          flag: "--customer-id <id>",
+          description: "Customer ID",
+          required: true,
+          sdkKey: "customerId"
+        },
+        {
+          flag: "--amount <n>",
+          description: "Amount in cents (negative for credit)",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "amount"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Adjustment description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--metadata <json>",
+          description: "Metadata (JSON)",
+          parse: parseJson,
+          sdkKey: "metadata"
+        }
+      ]
+    },
+    "get-download-url": {
+      method: "getDownloadUrl",
+      description: "Get a signed download URL for an invoice PDF",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Invoice ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    send: {
+      method: "send",
+      description: "Send an invoice by email",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Invoice ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    "update-status": {
+      method: "updateStatus",
+      description: "Update invoice status (outstanding invoices only)",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Invoice ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--status <status>",
+          description: "New status (paid or void)",
+          required: true,
+          sdkKey: "status"
+        }
+      ]
+    }
+  }
+};
+var transactionsResource = {
+  name: "transactions",
+  description: "Manage transactions",
+  sdkProperty: "transactions",
+  actions: {
+    list: {
+      method: "list",
+      description: "List transactions",
+      params: [
+        {
+          flag: "--status <status>",
+          description: "Filter by status",
+          sdkKey: "status"
+        },
+        {
+          flag: "--customer-email <email>",
+          description: "Filter by customer email",
+          sdkKey: "customerEmail"
+        },
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    get: {
+      method: "get",
+      description: "Get transaction details",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Transaction ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    refund: {
+      method: "refund",
+      description: "Refund a transaction (full refund)",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Transaction ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    retry: {
+      method: "retry",
+      description: "Retry a failed transaction",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Transaction ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    }
+  }
+};
+var promoCodesResource = {
+  name: "promo-codes",
+  description: "Manage promo codes",
+  sdkProperty: "promoCodes",
+  actions: {
+    list: {
+      method: "list",
+      description: "List promo codes",
+      params: [
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    get: {
+      method: "get",
+      description: "Get promo code details",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Promo code ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create a promo code",
+      params: [
+        {
+          flag: "--code <code>",
+          description: "Promo code string",
+          required: true,
+          sdkKey: "code"
+        },
+        {
+          flag: "--discount-type <type>",
+          description: "Discount type: percentage or amount",
+          required: true,
+          sdkKey: "discountType"
+        },
+        {
+          flag: "--discount-value <n>",
+          description: "Discount value",
+          required: true,
+          parse: parseNumber,
+          sdkKey: "discountValue"
+        },
+        {
+          flag: "--duration-cycles <n>",
+          description: "Duration in billing cycles",
+          parse: parseNumber,
+          sdkKey: "durationCycles"
+        },
+        {
+          flag: "--max-redemptions <n>",
+          description: "Maximum number of redemptions",
+          parse: parseNumber,
+          sdkKey: "maxRedemptions"
+        },
+        {
+          flag: "--expires-at <date>",
+          description: "Expiration date (ISO 8601)",
+          sdkKey: "expiresAt"
+        },
+        {
+          flag: "--plan-ids <json>",
+          description: "Restrict to plan IDs (JSON array)",
+          parse: parseJson,
+          sdkKey: "planIds"
+        }
+      ]
+    },
+    update: {
+      method: "update",
+      description: "Update a promo code",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Promo code ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--max-redemptions <n>",
+          description: "Maximum number of redemptions",
+          parse: parseNumber,
+          sdkKey: "maxRedemptions"
+        },
+        {
+          flag: "--expires-at <date>",
+          description: "Expiration date (ISO 8601)",
+          sdkKey: "expiresAt"
+        },
+        {
+          flag: "--active <bool>",
+          description: "Whether promo code is active",
+          parse: parseBool,
+          sdkKey: "active"
+        },
+        {
+          flag: "--plan-ids <json>",
+          description: "Restrict to plan IDs (JSON array)",
+          parse: parseJson,
+          sdkKey: "planIds"
+        }
+      ]
+    }
+  }
+};
+var planGroupsResource = {
+  name: "plan-groups",
+  description: "Manage plan groups",
+  sdkProperty: "planGroups",
+  actions: {
+    list: {
+      method: "list",
+      description: "List plan groups",
+      params: [
+        {
+          flag: "--limit <n>",
+          description: "Max results",
+          parse: parseNumber,
+          sdkKey: "limit"
+        },
+        {
+          flag: "--cursor <cursor>",
+          description: "Pagination cursor",
+          sdkKey: "cursor"
+        }
+      ]
+    },
+    get: {
+      method: "get",
+      description: "Get plan group details",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan group ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    create: {
+      method: "create",
+      description: "Create a plan group",
+      params: [
+        {
+          flag: "--name <name>",
+          description: "Plan group name",
+          required: true,
+          sdkKey: "name"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Plan group description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--is-public <bool>",
+          description: "Whether plan group is publicly visible",
+          parse: parseBool,
+          sdkKey: "isPublic"
+        }
+      ]
+    },
+    update: {
+      method: "update",
+      description: "Update a plan group",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan group ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--name <name>",
+          description: "Plan group name",
+          sdkKey: "name"
+        },
+        {
+          flag: "--description <desc>",
+          description: "Plan group description",
+          sdkKey: "description"
+        },
+        {
+          flag: "--is-public <bool>",
+          description: "Whether plan group is publicly visible",
+          parse: parseBool,
+          sdkKey: "isPublic"
+        }
+      ]
+    },
+    delete: {
+      method: "delete",
+      description: "Delete a plan group",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan group ID",
+          required: true,
+          sdkKey: "id"
+        }
+      ]
+    },
+    "add-plan": {
+      method: "addPlan",
+      description: "Add a plan to a group",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan group ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--plan-id <planId>",
+          description: "Plan ID to add",
+          required: true,
+          sdkKey: "planId"
+        },
+        {
+          flag: "--sort-order <n>",
+          description: "Sort order",
+          parse: parseNumber,
+          sdkKey: "sortOrder"
+        }
+      ]
+    },
+    "remove-plan": {
+      method: "removePlan",
+      description: "Remove a plan from a group",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan group ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--plan-id <planId>",
+          description: "Plan ID to remove",
+          required: true,
+          sdkKey: "planId"
+        }
+      ]
+    },
+    "reorder-plans": {
+      method: "reorderPlans",
+      description: "Reorder plans within a group",
+      params: [
+        {
+          flag: "--id <id>",
+          description: "Plan group ID",
+          required: true,
+          sdkKey: "id"
+        },
+        {
+          flag: "--plan-ids <json>",
+          description: "Ordered plan IDs (JSON array)",
+          required: true,
+          parse: parseJson,
+          sdkKey: "planIds"
+        }
+      ]
+    }
+  }
+};
+var resourceDefinitions = [
+  customersResource,
+  subscriptionsResource,
+  plansResource,
+  featuresResource,
+  seatsResource,
+  usageResource,
+  portalResource,
+  addonsResource,
+  creditPacksResource,
+  webhooksResource,
+  apiKeysResource,
+  invoicesResource,
+  transactionsResource,
+  promoCodesResource,
+  planGroupsResource
+];
+
+// src/utils/update-check.ts
+var fs6 = __toESM(require("fs"));
+var os3 = __toESM(require("os"));
+var path6 = __toESM(require("path"));
+var import_chalk15 = __toESM(require("chalk"));
+var CACHE_FILE = path6.join(os3.homedir(), ".commet", ".update-check");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var REGISTRY_URL = "https://registry.npmjs.org/commet/latest";
+function isNewerVersion(latest, current) {
+  const l = latest.split(".").map(Number);
+  const c = current.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] ?? 0) > (c[i] ?? 0)) return true;
+    if ((l[i] ?? 0) < (c[i] ?? 0)) return false;
+  }
+  return false;
+}
+function readCache() {
+  try {
+    return JSON.parse(fs6.readFileSync(CACHE_FILE, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    fs6.writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf8");
+  } catch {
+  }
+}
+function shouldSkip() {
+  if (process.env.COMMET_NO_UPDATE_CHECK === "1") return true;
+  if (process.env.CI) return true;
+  const idx = process.argv.indexOf("--output");
+  if (idx !== -1 && process.argv[idx + 1] === "agent") return true;
+  return false;
+}
+var updateAvailable = null;
+function scheduleUpdateCheck(currentVersion) {
+  if (shouldSkip()) return;
+  const cache = readCache();
+  if (cache && isNewerVersion(cache.latestVersion, currentVersion)) {
+    updateAvailable = cache.latestVersion;
+  }
+  const needsFetch = !cache || Date.now() - cache.checkedAt > CHECK_INTERVAL_MS;
+  if (!needsFetch) return;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 3e3);
+  fetch(REGISTRY_URL, { signal: controller.signal }).then((r) => r.json()).then((data) => {
+    writeCache({ latestVersion: data.version, checkedAt: Date.now() });
+    if (!updateAvailable && isNewerVersion(data.version, currentVersion)) {
+      updateAvailable = data.version;
+    }
+  }).catch(() => {
+  }).finally(() => clearTimeout(timeout));
+}
+function printUpdateNotification(currentVersion) {
+  if (!updateAvailable) return;
+  console.log("");
+  console.log(
+    `  Update available: ${import_chalk15.default.dim(currentVersion)} \u2192 ${import_chalk15.default.green(updateAvailable)}`
+  );
+  console.log(import_chalk15.default.dim(`  Run: npm i -g commet@latest`));
+}
+
+// src/index.ts
+var program = new import_commander11.Command();
+program.name("commet").description(
+  "Commet CLI \u2014 billing infrastructure as code.\nManage features, plans, and billing config from the command line."
+).version(package_default.version).addHelpText(
+  "after",
+  `
+Workflow:
+  $ commet pull                  Sync remote \u2192 commet.config.ts
+  $ commet push                  Push local changes \u2192 remote
+  $ commet pull --dry-run         See what's configured
+
+For agents and CI:
+  $ commet                       JSON capabilities when piped (no args)
+  $ commet pull --output agent --yes   Structured output, no prompts
+  $ COMMET_API_KEY=ck_... commet push --yes   CI pipeline
+
+Run commet <command> --help for detailed usage and examples.
+`
+);
+program.addCommand(createCommand);
+program.addCommand(loginCommand);
+program.addCommand(logoutCommand);
+program.addCommand(linkCommand);
+program.addCommand(orgsCommand);
+program.addCommand(pushCommand);
+program.addCommand(pullCommand);
+program.addCommand(listenCommand);
+program.addCommand(apiKeyCommand);
+for (const def of resourceDefinitions) {
+  program.addCommand(createResourceCommand(def));
+}
+program.enablePositionalOptions().passThroughOptions().option(
+  "--output <format>",
+  "Output format: human (default) or agent",
+  "human"
+);
+program.action((options) => {
+  if (options.output === "agent") {
+    printAgentInfo();
+  } else {
+    printDefaultScreen();
+  }
+});
+program.showSuggestionAfterError();
+program.exitOverride();
+installCrashHandler();
+markCommandStart();
+scheduleUpdateCheck(package_default.version);
+var commandName = process.argv[2] || "(default)";
+program.hook("postAction", () => {
+  reportCommand(commandName, "success");
+  printUpdateNotification(package_default.version);
+});
+try {
+  program.parse(process.argv);
+} catch (error) {
+  if (error instanceof Error) {
+    const code = error.code;
+    if (code === "commander.version" || code === "commander.help" || code === "commander.helpDisplayed") {
+      process.exit(0);
+    }
+    reportCommand(commandName, "error", code);
+    console.error(import_chalk16.default.red("Error:"), error.message);
+  }
+  process.exit(1);
+}
+function printAgentInfo() {
+  const authenticated = authExists() || !!process.env.COMMET_API_KEY;
+  const projectConfig = projectConfigExists() ? loadProjectConfig() : null;
+  const configPath = findConfigFile(process.cwd());
+  const setup = [];
+  if (!authenticated) {
+    setup.push(
+      "Not authenticated. Run 'commet login' (interactive) or set COMMET_API_KEY env var."
+    );
+  }
+  if (authenticated && !projectConfig && !process.env.COMMET_API_KEY) {
+    setup.push(
+      "No project linked. Run 'commet link --org <slug>' or 'commet orgs --json' to find organizations."
+    );
+  }
+  const output = {
+    version: package_default.version,
+    authenticated,
+    ...setup.length > 0 ? { setup } : {},
+    project: projectConfig ? {
+      linked: true,
+      orgId: projectConfig.orgId,
+      orgName: projectConfig.orgName,
+      mode: projectConfig.mode
+    } : { linked: false },
+    config: {
+      exists: configPath !== null,
+      path: configPath?.split("/").pop() ?? null
+    },
+    mcp: {
+      url: "https://commet.co/mcp",
+      sandbox: "https://sandbox.commet.co/mcp",
+      hint: "For full billing CRUD (plans, features, customers, subscriptions), connect to the MCP server."
+    },
+    auth: {
+      interactive: "commet login",
+      ci: "Set COMMET_API_KEY environment variable"
+    },
+    commands: {
+      pull: {
+        description: "Pull remote config and generate commet.config.ts",
+        usage: "commet pull --output agent --yes",
+        preview: "commet pull --output agent --dry-run"
+      },
+      push: {
+        description: "Push commet.config.ts to remote",
+        usage: "commet push --output agent --yes",
+        preview: "commet push --output agent --dry-run",
+        ci: "COMMET_API_KEY=ck_... commet push --yes"
+      },
+      orgs: {
+        description: "List available organizations",
+        usage: "commet orgs --output agent"
+      },
+      link: {
+        description: "Link/switch/unlink organization",
+        usage: "commet link --org <slug-or-id>",
+        clear: "commet link --clear"
+      },
+      listen: {
+        description: "Forward webhook events to local server. Long-running streaming process.",
+        usage: "commet listen <url> [--events <types>]"
+      },
+      create: {
+        description: "Scaffold a new Commet app from template",
+        usage: "commet create [name] -t <template> --org <slug> -y"
+      },
+      "api-key": {
+        description: "Generate API key for CI",
+        usage: "commet api-key --output agent"
+      },
+      login: {
+        description: "Authenticate via browser. Requires a human \u2014 opens a device-code flow.",
+        usage: "commet login"
+      },
+      logout: {
+        description: "Log out of Commet",
+        usage: "commet logout"
+      }
+    },
+    resources: generateResourceSchema(resourceDefinitions)
+  };
+  console.log(JSON.stringify(output, null, 2));
+}
+function printDefaultScreen() {
+  const version = import_chalk16.default.dim(`v${package_default.version}`);
+  console.log(`
+  ${commetColor.bold("Commet")} ${version}`);
+  console.log(import_chalk16.default.dim("  Billing infrastructure as code\n"));
+  const authenticated = authExists();
+  const projectConfig = projectConfigExists() ? loadProjectConfig() : null;
+  const configFile = findConfigFile(process.cwd());
+  if (authenticated) {
+    console.log(import_chalk16.default.green("  \u2713 Authenticated"));
+  } else {
+    console.log(
+      `  ${import_chalk16.default.yellow("\u26A0")} Not logged in ${import_chalk16.default.dim("\u2192 commet login")}`
+    );
+  }
+  if (projectConfig) {
+    console.log(
+      import_chalk16.default.green(
+        `  \u2713 ${projectConfig.orgName} ${import_chalk16.default.dim(`(${projectConfig.mode})`)}`
+      )
+    );
+    console.log(import_chalk16.default.dim(`    ${projectConfig.orgId}`));
+  } else if (authenticated) {
+    console.log(
+      `  ${import_chalk16.default.yellow("\u26A0")} No project linked ${import_chalk16.default.dim("\u2192 commet link")}`
+    );
+  }
+  if (configFile) {
+    const fileName = configFile.split("/").pop();
+    console.log(import_chalk16.default.green(`  \u2713 ${fileName}`));
+  } else if (projectConfig) {
+    console.log(
+      `  ${import_chalk16.default.yellow("\u26A0")} No config file ${import_chalk16.default.dim("\u2192 commet pull")}`
+    );
+  }
+  const cmd = (name) => commetColor(name.padEnd(22));
+  const dim = import_chalk16.default.dim;
+  console.log(dim("\n  Config"));
+  console.log(`    ${cmd("pull")}${dim("Sync remote \u2192 commet.config.ts")}`);
+  console.log(`    ${cmd("push")}${dim("Sync commet.config.ts \u2192 remote")}`);
+  console.log(dim("\n  Development"));
+  console.log(`    ${cmd("listen <url>")}${dim("Forward webhooks locally")}`);
+  console.log(dim("\n  Project"));
+  console.log(`    ${cmd("link")}${dim("Link / switch organization")}`);
   console.log(`    ${cmd("orgs")}${dim("List organizations")}`);
+  console.log(dim("\n  Resources (SDK)"));
+  for (const def of resourceDefinitions) {
+    console.log(`    ${cmd(def.name)}${dim(def.description)}`);
+  }
   console.log(dim("\n  Setup"));
   console.log(`    ${cmd("create")}${dim("Scaffold a new Commet app")}`);
   console.log(`    ${cmd("api-key")}${dim("Generate API key for CI")}`);