atmn 1.1.25 → 2.0.1

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"version":"7.0.0-dev.20260511.1","root":["../src/cli.tsx","../src/constants.ts","../src/commands/auth/command.ts","../src/commands/auth/constants.ts","../src/commands/auth/oauth.ts","../src/commands/config/command.ts","../src/commands/customers/command.tsx","../src/commands/customers/headless.ts","../src/commands/customers/index.ts","../src/commands/events/command.tsx","../src/commands/events/headless.ts","../src/commands/events/index.ts","../src/commands/events-aggregate-test/command.ts","../src/commands/events-aggregate-test/index.ts","../src/commands/features/command.tsx","../src/commands/features/headless.ts","../src/commands/features/index.ts","../src/commands/nuke/backup.ts","../src/commands/nuke/deletions.ts","../src/commands/nuke/legacyNuke.ts","../src/commands/nuke/types.ts","../src/commands/nuke/validation.ts","../src/commands/preview/index.ts","../src/commands/preview/previewPlan.ts","../src/commands/products/command.tsx","../src/commands/products/headless.ts","../src/commands/products/index.ts","../src/commands/pull/index.ts","../src/commands/pull/mergeEnvironments.ts","../src/commands/pull/pull.ts","../src/commands/pull/pullFromEnvironment.ts","../src/commands/pull/sdkTypes.ts","../src/commands/pull/types.ts","../src/commands/pull/writeConfig.ts","../src/commands/push/headless.ts","../src/commands/push/index.ts","../src/commands/push/prompts.ts","../src/commands/push/push.ts","../src/commands/push/types.ts","../src/commands/push/validate.ts","../src/commands/push/variantPropagation.ts","../src/commands/test-diff/command.ts","../src/commands/test-diff/index.ts","../src/commands/test-template/command.tsx","../src/compose/index.ts","../src/compose/builders/builderFunctions.ts","../src/compose/builders/rewardFunctions.ts","../src/compose/builders/variantFunctions.ts","../src/compose/models/featureModels.ts","../src/compose/models/index.ts","../src/compose/models/planModels.ts","../src/compose/models/rewardModels.ts","../src/compose/models/variantModels.ts","../src/lib/utils.ts","../src/lib/version.ts","../src/lib/writeEmptyConfig.ts","../src/lib/animation/explosion.ts","../src/lib/api/client.ts","../src/lib/api/endpoints/catalog.ts","../src/lib/api/endpoints/customers.ts","../src/lib/api/endpoints/events.ts","../src/lib/api/endpoints/features.ts","../src/lib/api/endpoints/index.ts","../src/lib/api/endpoints/organization.ts","../src/lib/api/endpoints/plans.ts","../src/lib/api/endpoints/rewards.ts","../src/lib/api/types/feature.ts","../src/lib/api/types/index.ts","../src/lib/api/types/organization.ts","../src/lib/api/types/plan.ts","../src/lib/api/types/planItem.ts","../src/lib/auth/headlessAuthRecovery.ts","../src/lib/config/loadConfig.ts","../src/lib/constants/templates.ts","../src/lib/constants/templates/index.ts","../src/lib/constants/templates/linear.config.ts","../src/lib/constants/templates/openai.config.ts","../src/lib/constants/templates/railway.config.ts","../src/lib/constants/templates/t3chat.config.ts","../src/lib/env/backendUrl.ts","../src/lib/env/cliContext.ts","../src/lib/env/detect.ts","../src/lib/env/dotenv.ts","../src/lib/env/index.ts","../src/lib/env/keys.ts","../src/lib/headless/CustomersController.ts","../src/lib/headless/FeaturesController.ts","../src/lib/headless/PlansController.ts","../src/lib/headless/index.ts","../src/lib/headless/types.ts","../src/lib/hooks/index.ts","../src/lib/hooks/useAgentSetup.ts","../src/lib/hooks/useAuthRecovery.ts","../src/lib/hooks/useClipboard.ts","../src/lib/hooks/useConfigCounts.ts","../src/lib/hooks/useCreateGuides.ts","../src/lib/hooks/useCreateSkills.ts","../src/lib/hooks/useCustomerExpanded.ts","../src/lib/hooks/useCustomerNavigation.ts","../src/lib/hooks/useCustomers.ts","../src/lib/hooks/useEnvironmentStore.ts","../src/lib/hooks/useEvents.ts","../src/lib/hooks/useEventsAggregate.ts","../src/lib/hooks/useEventsAggregateApi.ts","../src/lib/hooks/useEventsFilter.ts","../src/lib/hooks/useFeatures.ts","../src/lib/hooks/useHasCustomers.ts","../src/lib/hooks/useHeadlessAuth.ts","../src/lib/hooks/useListNavigation.ts","../src/lib/hooks/useLogin.ts","../src/lib/hooks/useNuke.ts","../src/lib/hooks/useNukeData.ts","../src/lib/hooks/useOrganization.ts","../src/lib/hooks/usePlans.ts","../src/lib/hooks/usePull.ts","../src/lib/hooks/usePush.ts","../src/lib/hooks/useTerminalSize.ts","../src/lib/hooks/useVisibleRowCount.ts","../src/lib/hooks/useWriteTemplateConfig.ts","../src/lib/transforms/index.ts","../src/lib/transforms/multiCurrency.test.ts","../src/lib/transforms/apiToSdk/Transformer.test.ts","../src/lib/transforms/apiToSdk/Transformer.ts","../src/lib/transforms/apiToSdk/feature.ts","../src/lib/transforms/apiToSdk/helpers.ts","../src/lib/transforms/apiToSdk/index.ts","../src/lib/transforms/apiToSdk/plan.ts","../src/lib/transforms/apiToSdk/planItem.ts","../src/lib/transforms/apiToSdk/reward.ts","../src/lib/transforms/inPlaceUpdate/index.ts","../src/lib/transforms/inPlaceUpdate/parseConfig.ts","../src/lib/transforms/inPlaceUpdate/updateConfig.ts","../src/lib/transforms/sdkToApi/feature.ts","../src/lib/transforms/sdkToApi/index.ts","../src/lib/transforms/sdkToApi/plan.ts","../src/lib/transforms/sdkToApi/reward.ts","../src/lib/transforms/sdkToCode/configFile.ts","../src/lib/transforms/sdkToCode/feature.ts","../src/lib/transforms/sdkToCode/helpers.test.ts","../src/lib/transforms/sdkToCode/helpers.ts","../src/lib/transforms/sdkToCode/imports.ts","../src/lib/transforms/sdkToCode/index.ts","../src/lib/transforms/sdkToCode/plan.ts","../src/lib/transforms/sdkToCode/planItem.ts","../src/lib/transforms/sdkToCode/reward.ts","../src/lib/transforms/sdkToCode/variant.ts","../src/lib/utils/index.ts","../src/lib/utils/monorepo.ts","../src/prompts/skills/autumn-billing-page.ts","../src/prompts/skills/autumn-gating.ts","../src/prompts/skills/autumn-modelling-pricing-plans.ts","../src/prompts/skills/autumn-setup.ts","../src/prompts/skills/index.ts","../src/views/App.tsx","../src/views/html/oauth-callback.ts","../src/views/react/test-agent.tsx","../src/views/react/components/AuthRecoveryBoundary.tsx","../src/views/react/components/Card.tsx","../src/views/react/components/KeyValue.tsx","../src/views/react/components/LoadingText.tsx","../src/views/react/components/MultiSelect.tsx","../src/views/react/components/ProgressBar.tsx","../src/views/react/components/PromptCard.tsx","../src/views/react/components/SelectMenu.tsx","../src/views/react/components/StatusLine.tsx","../src/views/react/components/StatusRow.tsx","../src/views/react/components/StepHeader.tsx","../src/views/react/components/index.ts","../src/views/react/components/providers/CardWidthContext.tsx","../src/views/react/components/providers/QueryProvider.tsx","../src/views/react/components/providers/index.ts","../src/views/react/customers/CustomersView.tsx","../src/views/react/customers/types.ts","../src/views/react/customers/components/CustomerRow.tsx","../src/views/react/customers/components/CustomerSheet.tsx","../src/views/react/customers/components/CustomersTable.tsx","../src/views/react/customers/components/EmptyState.tsx","../src/views/react/customers/components/ErrorState.tsx","../src/views/react/customers/components/KeybindHints.tsx","../src/views/react/customers/components/LoadingState.tsx","../src/views/react/customers/components/SearchInput.tsx","../src/views/react/customers/components/TitleBar.tsx","../src/views/react/customers/components/index.ts","../src/views/react/customers/components/sections/BalancesSection.tsx","../src/views/react/customers/components/sections/EntitiesSection.tsx","../src/views/react/customers/components/sections/InvoicesSection.tsx","../src/views/react/customers/components/sections/ReferralsSection.tsx","../src/views/react/customers/components/sections/RewardsSection.tsx","../src/views/react/customers/components/sections/SubscriptionsSection.tsx","../src/views/react/customers/components/sections/index.ts","../src/views/react/events/EventsView.tsx","../src/views/react/events/index.ts","../src/views/react/events/components/EventSheet.tsx","../src/views/react/events/components/EventsAggregateView.tsx","../src/views/react/events/components/EventsFilterSheet.tsx","../src/views/react/events/components/index.ts","../src/views/react/features/FeaturesView.tsx","../src/views/react/features/index.ts","../src/views/react/features/components/FeatureSheet.tsx","../src/views/react/features/components/index.ts","../src/views/react/init/HeadlessInitFlow.tsx","../src/views/react/init/InitFlow.tsx","../src/views/react/init/steps/AgentStep.tsx","../src/views/react/init/steps/AuthStep.tsx","../src/views/react/init/steps/ConfigStep.tsx","../src/views/react/init/steps/HandoffStep.tsx","../src/views/react/init/steps/PathInputStep.tsx","../src/views/react/init/steps/StripeStep.tsx","../src/views/react/login/LoginView.tsx","../src/views/react/nuke/InlineNukeFlow.tsx","../src/views/react/nuke/NukeAnimation.tsx","../src/views/react/nuke/NukeView.tsx","../src/views/react/nuke/components/BackupPrompt.tsx","../src/views/react/nuke/components/ConfirmScreen.tsx","../src/views/react/nuke/components/DeletionProgress.tsx","../src/views/react/nuke/components/FinalSummary.tsx","../src/views/react/nuke/components/SuccessScreen.tsx","../src/views/react/nuke/components/WarningScreen.tsx","../src/views/react/preview/PlanPreviewCard.tsx","../src/views/react/preview/PreviewView.tsx","../src/views/react/preview/index.ts","../src/views/react/primitives/index.ts","../src/views/react/primitives/input/SearchInput.tsx","../src/views/react/primitives/input/index.ts","../src/views/react/primitives/layout/BottomBar.tsx","../src/views/react/primitives/layout/ListViewLayout.tsx","../src/views/react/primitives/layout/SplitPane.tsx","../src/views/react/primitives/layout/TitleBar.tsx","../src/views/react/primitives/layout/index.ts","../src/views/react/primitives/sheet/DetailSheet.tsx","../src/views/react/primitives/sheet/SheetSection.tsx","../src/views/react/primitives/sheet/index.ts","../src/views/react/primitives/states/EmptyState.tsx","../src/views/react/primitives/states/ErrorState.tsx","../src/views/react/primitives/states/LoadingState.tsx","../src/views/react/primitives/states/index.ts","../src/views/react/primitives/table/DataTable.tsx","../src/views/react/primitives/table/TableRow.tsx","../src/views/react/primitives/table/index.ts","../src/views/react/primitives/utils/formatDate.ts","../src/views/react/primitives/utils/index.ts","../src/views/react/primitives/utils/pagination.ts","../src/views/react/primitives/utils/truncate.ts","../src/views/react/products/ProductsView.tsx","../src/views/react/products/index.ts","../src/views/react/products/components/ProductSheet.tsx","../src/views/react/products/components/index.ts","../src/views/react/pull/Pull.tsx","../src/views/react/pull/components/FeatureRow.tsx","../src/views/react/pull/components/FileRow.tsx","../src/views/react/pull/components/PlanRow.tsx","../src/views/react/pull/components/index.ts","../src/views/react/push/Push.tsx","../src/views/react/push/index.ts","../src/views/react/push/components/CompletionMessage.tsx","../src/views/react/push/components/ConfigResourcesPromptCard.tsx","../src/views/react/push/components/ErrorCard.tsx","../src/views/react/push/components/FeaturesCard.tsx","../src/views/react/push/components/NoChangesCard.tsx","../src/views/react/push/components/OrgCard.tsx","../src/views/react/push/components/OverviewCard.tsx","../src/views/react/push/components/PlansCard.tsx","../src/views/react/push/components/PushPromptCard.tsx","../src/views/react/push/components/index.ts","../src/views/react/template/TemplateSelector.tsx","../src/views/react/template2/Badge.tsx","../src/views/react/template2/PlanCard.tsx","../src/views/react/template2/TemplateRow.tsx","../src/views/react/template2/TemplateSelector2.tsx","../src/views/react/template2/data.ts","../src/views/react/template2/index.ts","../test/types/reward.ts"]}
+{"version":"7.0.0-dev.20260511.1","root":["../src/bin.ts","../src/cli.ts","../src/index.ts","../src/version.ts","../src/actions/env.ts","../src/actions/login.ts","../src/actions/pull.ts","../src/actions/push.ts","../src/actions/api/callApi.ts","../src/actions/api/registerApiCommands.ts","../src/actions/env/fetchOrgInfo.ts","../src/actions/env/types/orgInfo.ts","../src/actions/init/runInit.ts","../src/actions/login/keyless.ts","../src/actions/pull/appendPlanVersionFixture.ts","../src/actions/pull/applyPreview.ts","../src/actions/pull/applySettingsPreview.ts","../src/actions/pull/changedFixtureKeys.ts","../src/actions/pull/listSourceFiles.ts","../src/actions/pull/locateFixture.ts","../src/actions/pull/resolveCollectionTarget.ts","../src/actions/pull/rewriteConfig.ts","../src/actions/pull/scaffoldConfig.ts","../src/actions/push/backfillInternalIds.ts","../src/actions/push/deprecatedFields.ts","../src/actions/reset/runReset.ts","../src/actions/sandbox/createSandbox.ts","../src/actions/sandbox/deleteSandbox.ts","../src/actions/sandbox/listSandboxes.ts","../src/actions/sandbox/useSandbox.ts","../src/actions/sandbox/withSandboxScopeHint.ts","../src/actions/sandbox/types/sandboxClient.ts","../src/actions/skills/skills.ts","../src/auth/announceAuthorizationUrl.ts","../src/auth/buildAuthorizationUrl.ts","../src/auth/callbackPages.ts","../src/auth/createOrgApiKeys.ts","../src/auth/keyless.ts","../src/auth/oauthConfig.ts","../src/auth/runOAuthFlow.ts","../src/auth/browser/openSystemBrowser.ts","../src/auth/browser/tryOpenBrowser.ts","../src/auth/browser/watchLauncher.ts","../src/auth/types/browserOpener.ts","../src/auth/types/impersonationTokens.ts","../src/auth/types/oauthTokens.ts","../src/auth/types/orgApiKeys.ts","../src/config/configPackageName.ts","../src/config/legacyConfig.ts","../src/config/loadConfig.ts","../src/env/assertSandboxTarget.ts","../src/env/loadEnv.ts","../src/env/resolveTarget.ts","../src/env/sandboxKeyName.ts","../src/generated/apiRoutes.ts","../src/generated/client.ts","../src/generated/emit.ts","../src/generated/emitRuntime.ts","../src/generated/features.ts","../src/generated/labels.ts","../src/generated/licenses.ts","../src/generated/lintRules.ts","../src/generated/lintRuntime.ts","../src/generated/plans.ts","../src/generated/referralPrograms.ts","../src/generated/rewards.ts","../src/generated/settings.ts","../src/generated/skills.ts","../src/generated/variants.ts","../src/generated/wire.ts","../src/http/autumnFetch.ts","../src/project/chooseConfigDir.ts","../src/project/resolveProject.ts","../src/project/rootMarker.ts","../src/prompt/prompt.ts","../src/prompt/select.ts","../src/render/renderEnv.ts","../src/render/renderPreview.ts","../src/render/renderSandboxes.ts","../src/render/stripTerminalControls.ts","../src/repo/findRepoRoot.ts","../src/surgery/appendPropertyEdit.ts","../src/surgery/appendToArray.ts","../src/surgery/appendToBinding.ts","../src/surgery/appendToCollection.ts","../src/surgery/appendToFixtureArray.ts","../src/surgery/arrayBinding.ts","../src/surgery/deleteFixtureLiteral.ts","../src/surgery/deleteReference.ts","../src/surgery/ensureBuilderImport.ts","../src/surgery/findFixture.ts","../src/surgery/fixtureEdit.ts","../src/surgery/fixtureLocation.ts","../src/surgery/insertCollection.ts","../src/surgery/insertFirstProperty.ts","../src/surgery/patchFixtureProperty.ts","../src/surgery/patchSingletonProperty.ts","../src/surgery/replaceFixture.ts","../src/surgery/setFixtureProperty.ts","../src/surgery/staticFixtureRule.ts","../test/apiCommand.test.ts","../test/authorizationUrl.test.ts","../test/autumnFetch.test.ts","../test/backfill.test.ts","../test/backfillInlineVariants.test.ts","../test/backfillSlug.test.ts","../test/backfillVariants.test.ts","../test/chooseConfigDir.test.ts","../test/cliTargetFlags.test.ts","../test/client.test.ts","../test/configPackageName.test.ts","../test/emitFixture.test.ts","../test/env.test.ts","../test/envWriter.test.ts","../test/init.test.ts","../test/keyless.test.ts","../test/legacyConfig.test.ts","../test/lintDocument.test.ts","../test/loadConfigNode.test.ts","../test/loadConfigV2.test.ts","../test/login.test.ts","../test/nodeNextTypes.test.ts","../test/plans.test.ts","../test/previewIsEmpty.test.ts","../test/prompt.test.ts","../test/pull.test.ts","../test/pullByReference.test.ts","../test/pullFieldLevel.test.ts","../test/pullOmitDefaults.test.ts","../test/pullPlans.test.ts","../test/pullStatesSlugs.test.ts","../test/pullTwoCollections.test.ts","../test/renameHint.test.ts","../test/renderPreview.test.ts","../test/renderSandboxes.test.ts","../test/renderSettings.test.ts","../test/reset.test.ts","../test/resolveCollectionTarget.test.ts","../test/resolveProject.test.ts","../test/resolveTarget.test.ts","../test/sandboxActions.test.ts","../test/sandboxKeyName.test.ts","../test/sandboxUse.test.ts","../test/settingsActions.test.ts","../test/settingsWire.test.ts","../test/skills.test.ts","../test/watchLauncher.test.ts","../test/wireDocument.test.ts","../test/helpers/targetFor.ts","../test/surgery/appendToCollection.test.ts","../test/surgery/deleteFixtureLiteral.test.ts","../test/surgery/deleteReference.test.ts","../test/surgery/findFixture.test.ts","../test/surgery/fixtureLocation.test.ts","../test/surgery/insertCollection.test.ts","../test/surgery/insertFirstProperty.test.ts","../test/surgery/patchFixtureProperty.test.ts","../test/surgery/patchSingletonProperty.test.ts","../test/surgery/replaceFixture.test.ts","../test/surgery/staticFixtureRule.test.ts"]}

package/package.json

@@ -1,9 +1,20 @@
 {
   "name": "atmn",
-  "version": "1.1.25",
+  "version": "2.0.1",
   "license": "MIT",
+  "description": "The CLI for Autumn — define your pricing in code, sync it to Autumn, and keep everything in version control.",
   "bin": {
-    "atmn": "dist/cli.js"
+    "atmn": "dist/bin.js"
+  },
+  "main": "dist/index.js",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "repository": {
     "type": "git",
@@ -11,89 +22,32 @@
     "directory": "packages/atmn"
   },
   "homepage": "https://docs.useautumn.com/api-reference/cli/getting-started",
-  "main": "dist/compose/index.js",
-  "types": "dist/src/compose/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/src/compose/index.d.ts",
-      "import": "./dist/compose/index.js",
-      "default": "./dist/compose/index.js"
-    },
-    "./skills": {
-      "types": "./src/prompts/skills/index.ts",
-      "import": "./src/prompts/skills/index.ts",
-      "default": "./src/prompts/skills/index.ts"
-    }
-  },
   "type": "module",
   "engines": {
-    "node": ">=16"
+    "node": ">=20"
   },
   "scripts": {
     "ts": "bunx tsgo --build --noEmit",
     "build": "bun run bun.config.ts",
-    "dev": "nodemon -e ts,tsx --watch src --ignore dist --exec \"bun run bun.config.ts\"",
-    "dev:bun": "bun run dev.ts",
-    "test": "bun test test/*.test.ts test/auth test/codegen test/nuke test/pull test/push test/workflow",
-    "test:integration": "echo 'deprecated: v1 atmn integration — see packages/atmn/test/integration/DEPRECATED.md' && exit 0",
-    "test:integration:cli": "echo 'deprecated: v1 atmn integration — see packages/atmn/test/integration/DEPRECATED.md' && exit 0",
-    "test:unit": "bun test test/codegen",
-    "test:watch": "bun test --watch",
-    "test2": "prettier --check . && xo && ava",
-    "test-cli": "node --trace-deprecation -- ./dist/cli.js"
+    "dev": "bun scripts/watchBuild.ts",
+    "test": "bun test test",
+    "prepack": "bun run build"
   },
   "files": [
     "dist",
+    "src",
     "package.json",
     "README.md"
   ],
   "dependencies": {
-    "@inquirer/prompts": "^7.6.0",
-    "@mishieck/ink-titled-box": "^0.3.0",
-    "@tanstack/react-query": "^5.90.17",
-    "@types/prettier": "^3.0.0",
-    "arctic": "^3.7.0",
-    "axios": "^1.10.0",
-    "cfonts": "^3.3.1",
-    "chalk": "^5.2.0",
-    "clipboardy": "^5.0.2",
-    "commander": "^14.0.0",
-    "dotenv": "^17.2.0",
-    "ervy": "^1.0.7",
-    "ink": "^6.6.0",
-    "ink-big-text": "^2.0.0",
-    "ink-chart": "^0.1.1",
-    "ink-confirm-input": "^2.0.0",
-    "ink-scroll-list": "^0.4.1",
-    "ink-scroll-view": "^0.3.5",
-    "ink-select-input": "^6.2.0",
-    "ink-spinner": "^5.0.0",
-    "ink-table": "^3.1.0",
-    "ink-text-input": "^6.0.0",
-    "inquirer": "^12.7.0",
-    "jiti": "^2.4.2",
-    "open": "^10.1.2",
-    "prettier": "^3.6.2",
-    "react": "^19.2.3",
-    "yocto-spinner": "^1.0.0",
-    "zod": "^4.0.0",
-    "conf": "^13.0.1"
-  },
-  "ava": {
-    "extensions": {
-      "ts": "module",
-      "tsx": "module"
-    },
-    "nodeArguments": [
-      "--loader=ts-node/esm"
-    ]
-  },
-  "xo": {
-    "extends": "xo-react",
-    "prettier": true,
-    "rules": {
-      "react/prop-types": "off"
-    }
-  },
-  "prettier": "@vdemedes/prettier-config"
+    "@ast-grep/napi": "0.45.3",
+    "arctic": "3.7.0",
+    "chalk": "5.6.2",
+    "commander": "14.0.3",
+    "dotenv": "16.6.1",
+    "jiti": "2.7.0",
+    "open": "10.2.0",
+    "yaml": "2.9.0"
+  },
+  "gitHead": "5a548945bb2a7bec37404428767108467915449d"
 }

package/src/actions/api/callApi.ts

@@ -0,0 +1,280 @@
+import type { ApiField, ApiRoute } from "../../generated/apiRoutes";
+import { API_ROUTES, API_VERSION } from "../../generated/apiRoutes";
+import { AutumnApiError } from "../../generated/client";
+import { autumnFetch } from "../../http/autumnFetch";
+
+export type ApiCallOptions = {
+	route: ApiRoute;
+	baseUrl: string;
+	secretKey: string;
+	/** `--body`: a JSON document, or `-` for stdin. */
+	body?: string;
+	/** `key=value` arguments, keyed by wire name; a JSON-typed field arrives as text. */
+	fields?: Record<string, string>;
+	/** `-H "name: value"`, repeatable; a stated header wins over the default. */
+	headers?: string[];
+	readStdin?: () => Promise<string>;
+	fetch?: typeof globalThis.fetch;
+};
+
+export const findApiRoute = ({
+	group,
+	method,
+}: {
+	group: string;
+	method: string;
+}): ApiRoute | undefined =>
+	API_ROUTES.find((route) => route.group === group && route.method === method);
+
+export const apiGroups = (): string[] => [
+	...new Set(API_ROUTES.map((route) => route.group)),
+];
+
+/**
+ * `customer_id=cus_1`: fields ride as positional pairs rather than flags, so a
+ * field named `version` or `config` can never collide with the CLI's own.
+ */
+export const parseFieldArgs = ({
+	args,
+}: {
+	args: string[];
+}): Record<string, string> => {
+	const fields: Record<string, string> = {};
+	for (const arg of args) {
+		const at = arg.indexOf("=");
+		if (at <= 0)
+			throw new Error(
+				`Expected key=value, got ${JSON.stringify(arg)}. Pass the whole body with --body instead.`,
+			);
+		fields[arg.slice(0, at)] = arg.slice(at + 1);
+	}
+	return fields;
+};
+
+const parseJson = ({ text, what }: { text: string; what: string }): unknown => {
+	try {
+		return JSON.parse(text);
+	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error);
+		throw new Error(`${what} is not valid JSON: ${detail}`);
+	}
+};
+
+const coerce = ({
+	field,
+	value,
+}: {
+	field: ApiField;
+	value: string;
+}): unknown => {
+	switch (field.type) {
+		case "boolean": {
+			if (value === "true") return true;
+			if (value === "false") return false;
+			throw new Error(`${field.name} takes true or false.`);
+		}
+		case "number": {
+			const parsed = Number(value);
+			if (value === "" || !Number.isFinite(parsed))
+				throw new Error(`${field.name} takes a number.`);
+			return parsed;
+		}
+		case "string":
+			return value;
+		case "json":
+			return parseJson({ text: value, what: field.name });
+	}
+};
+
+/**
+ * `--body` is the whole document; field flags layer on top of it, so a saved
+ * JSON body can still be overridden for one call.
+ */
+export const buildApiBody = async ({
+	route,
+	body,
+	fields = {},
+	readStdin,
+}: {
+	route: ApiRoute;
+	body?: string;
+	fields?: Record<string, string>;
+	readStdin?: () => Promise<string>;
+}): Promise<unknown> => {
+	const stated = Object.entries(fields);
+	let document: unknown = route.body === "array" ? undefined : {};
+	if (body !== undefined) {
+		const text = body === "-" ? await (readStdin ?? defaultReadStdin)() : body;
+		document = parseJson({ text, what: "--body" });
+	}
+	if (stated.length === 0) return document;
+	if (route.body === "array")
+		throw new Error(
+			`${route.path} takes an array body: pass it with --body, not key=value.`,
+		);
+	if (
+		typeof document !== "object" ||
+		document === null ||
+		Array.isArray(document)
+	)
+		throw new Error(
+			"--body must be a JSON object when key=value pairs are given.",
+		);
+	const byName = new Map(route.fields.map((field) => [field.name, field]));
+	const merged: Record<string, unknown> = { ...document };
+	for (const [name, value] of stated) {
+		const field = byName.get(name);
+		if (field === undefined)
+			throw new Error(
+				`${route.path} has no field ${name}. Fields: ${route.fields.map((known) => known.name).join(", ")}.`,
+			);
+		merged[name] = coerce({ field, value });
+	}
+	return merged;
+};
+
+const defaultReadStdin = async (): Promise<string> => {
+	const chunks: Buffer[] = [];
+	for await (const chunk of process.stdin) chunks.push(chunk as Buffer);
+	return Buffer.concat(chunks).toString("utf8");
+};
+
+/** `-H "x-api-version: 2.3.0"` → `["x-api-version", "2.3.0"]`; the name is lowercased like fetch does. */
+export const parseHeaderArgs = ({
+	headers,
+}: {
+	headers: string[];
+}): Record<string, string> => {
+	const parsed: Record<string, string> = {};
+	for (const header of headers) {
+		const at = header.indexOf(":");
+		const name = at > 0 ? header.slice(0, at).trim().toLowerCase() : "";
+		if (name === "")
+			throw new Error(
+				`Expected -H "name: value", got ${JSON.stringify(header)}.`,
+			);
+		parsed[name] = header.slice(at + 1).trim();
+	}
+	return parsed;
+};
+
+export type ApiRequest = {
+	url: string;
+	headers: Record<string, string>;
+	body: string;
+};
+
+export const buildApiRequest = async ({
+	route,
+	baseUrl,
+	secretKey,
+	body,
+	fields,
+	headers = [],
+	readStdin,
+}: Omit<ApiCallOptions, "fetch">): Promise<ApiRequest> => ({
+	url: `${baseUrl}${route.path}`,
+	headers: {
+		authorization: `Bearer ${secretKey}`,
+		"content-type": "application/json",
+		"x-api-version": API_VERSION,
+		...parseHeaderArgs({ headers }),
+	},
+	body: JSON.stringify(
+		(await buildApiBody({ route, body, fields, readStdin })) ?? {},
+	),
+});
+
+const shellQuote = (text: string): string => `'${text.replace(/'/g, "'\\''")}'`;
+
+/** The same request as a curl line, for pasting into a doc or a support
+ * thread. The key is shown as the literal name of its env var, on purpose:
+ * nothing in the output is a secret, and the reader fills it in. */
+export const renderCurl = ({
+	request,
+	secretKey,
+	secretKeyName,
+}: {
+	request: ApiRequest;
+	secretKey: string;
+	/** The env var the key came from, printed in the key's place. */
+	secretKeyName: string;
+}): string =>
+	[
+		`curl -X POST ${shellQuote(request.url)}`,
+		...Object.entries(request.headers).map(([name, value]) => {
+			// An authorization the caller overrode with -H is theirs to show.
+			const shown =
+				name === "authorization" && value === `Bearer ${secretKey}`
+					? `Bearer $${secretKeyName}`
+					: value;
+			return `  -H ${shellQuote(`${name}: ${shown}`)}`;
+		}),
+		`  -d ${shellQuote(request.body)}`,
+	].join(" \\\n");
+
+const tryParseJson = ({ text }: { text: string }): unknown => {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+};
+
+/** A non-2xx reply, whole: the command prints it rather than a one-line summary. */
+export class ApiResponseError extends AutumnApiError {
+	readonly statusText: string;
+
+	constructor({
+		status,
+		statusText,
+		body,
+		path,
+	}: {
+		status: number;
+		statusText: string;
+		body: unknown;
+		path: string;
+	}) {
+		super({ status, body, path });
+		this.name = "ApiResponseError";
+		this.statusText = statusText;
+	}
+}
+
+/** `HTTP 404 Not Found`, and the body as the server sent it, pretty-printed when it is JSON. */
+export const renderApiResponseError = ({
+	error,
+}: {
+	error: ApiResponseError;
+}): { statusLine: string; body: string } => ({
+	statusLine: `HTTP ${error.status} ${error.statusText}`,
+	body:
+		typeof error.body === "string"
+			? error.body
+			: JSON.stringify(error.body, null, 2),
+});
+
+/** One POST, the way the generated client does it, plus the version header the spec pins. */
+export const callApi = async ({
+	fetch = autumnFetch,
+	...options
+}: ApiCallOptions): Promise<unknown> => {
+	const request = await buildApiRequest(options);
+	const response = await fetch(request.url, {
+		method: "POST",
+		headers: request.headers,
+		body: request.body,
+	});
+	const text = await response.text();
+	// A proxy's HTML error page is not JSON; the status and route still matter.
+	const parsed: unknown = text ? tryParseJson({ text }) : null;
+	if (!response.ok)
+		throw new ApiResponseError({
+			status: response.status,
+			statusText: response.statusText,
+			body: parsed,
+			path: options.route.path,
+		});
+	return parsed;
+};

package/src/actions/api/registerApiCommands.ts

@@ -0,0 +1,121 @@
+import type { Command } from "commander";
+import {
+	requireSecretKey,
+	type Target,
+	targetBaseUrl,
+} from "../../env/resolveTarget";
+import { API_ROUTES, type ApiRoute } from "../../generated/apiRoutes";
+import {
+	ApiResponseError,
+	buildApiRequest,
+	callApi,
+	parseFieldArgs,
+	renderApiResponseError,
+	renderCurl,
+} from "./callApi";
+
+const SUMMARY_MAX = 80;
+
+/** The first sentence, clipped: the group listing is a table, the method's own --help carries the rest. */
+export const summarize = ({ text }: { text: string }): string => {
+	const sentence = /^.*?[.!?](?=\s|$)/.exec(text)?.[0] ?? text;
+	return sentence.length <= SUMMARY_MAX
+		? sentence
+		: `${sentence.slice(0, SUMMARY_MAX - 1).trimEnd()}…`;
+};
+
+const fieldHelp = ({ route }: { route: ApiRoute }): string => {
+	if (route.body === "none") return "\nTakes no body.";
+	if (route.body === "array")
+		return "\nTakes a JSON array: pass it with --body '[...]' or --body - (stdin).";
+	const width = Math.max(0, ...route.fields.map((field) => field.name.length));
+	return [
+		"\nFields (key=value; json values are parsed):",
+		...route.fields.map((field) => {
+			const type = `${field.type}${field.required ? ", required" : ""}`;
+			return `  ${field.name.padEnd(width)}  ${type.padEnd(18)}${field.description ?? ""}`.trimEnd();
+		}),
+	].join("\n");
+};
+
+/**
+ * One subcommand per public RPC route, straight off the spec: `atmn api
+ * balances check customer_id=cus_1 feature_id=messages`. Nothing here knows
+ * what any route does; the spec's own description is the help.
+ */
+export const registerApiCommands = ({
+	program,
+	targetOf,
+}: {
+	program: Command;
+	targetOf: (command: Command) => Target;
+}): void => {
+	const api = program
+		.command("api")
+		.description(
+			"call any public API route: atmn api <group> <method> [key=value...]",
+		);
+	const groups = new Map<string, Command>();
+	for (const route of API_ROUTES) {
+		let group = groups.get(route.group);
+		if (group === undefined) {
+			group = api.command(route.group).description(`${route.group}.* routes`);
+			groups.set(route.group, group);
+		}
+		group
+			.command(route.method)
+			.summary(summarize({ text: route.description ?? route.path }))
+			.description(route.description ?? route.path)
+			.argument("[fields...]", "body fields as key=value")
+			.option("--body <json>", "the whole JSON body; - reads stdin")
+			.option(
+				"-H, --header <header>",
+				'an extra request header, "name: value"; repeatable',
+				(value: string, previous: string[] = []) => [...previous, value],
+			)
+			.option(
+				"--curl",
+				"print the request as a curl command instead of sending it",
+			)
+			.addHelpText("after", fieldHelp({ route }))
+			.action(
+				async (
+					args: string[],
+					options: { body?: string; header?: string[]; curl?: boolean },
+					command: Command,
+				) => {
+					const target = targetOf(command);
+					const call = {
+						route,
+						baseUrl: targetBaseUrl({ target }),
+						secretKey: requireSecretKey({ target }),
+						...(options.body === undefined ? {} : { body: options.body }),
+						fields: parseFieldArgs({ args }),
+						headers: options.header ?? [],
+					};
+					if (options.curl === true) {
+						process.stdout.write(
+							`${renderCurl({
+								request: await buildApiRequest(call),
+								secretKey: call.secretKey,
+								secretKeyName: target.secretKeyName,
+							})}\n`,
+						);
+						return;
+					}
+					try {
+						const response = await callApi(call);
+						process.stdout.write(`${JSON.stringify(response, null, 2)}\n`);
+					} catch (error) {
+						// The server's reply is the answer, so it is shown whole: the
+						// status line on stderr, the body on stdout like a success.
+						if (!(error instanceof ApiResponseError)) throw error;
+						const { statusLine, body } = renderApiResponseError({ error });
+						process.stderr.write(`${statusLine}\n`);
+						process.stdout.write(`${body}\n`);
+						process.exitCode = 1;
+					}
+				},
+			);
+	}
+};

package/src/actions/env/fetchOrgInfo.ts

@@ -0,0 +1,32 @@
+import { AutumnApiError } from "../../generated/client";
+import { autumnFetch } from "../../http/autumnFetch";
+import type { OrgInfo } from "./types/orgInfo";
+
+const ORG_INFO_PATH = "/v1/organization/me";
+
+/** Not in the spec, so hand-written like the key-minting call rather than generated. */
+export const fetchOrgInfo = async ({
+	baseUrl,
+	secretKey,
+	fetch = autumnFetch,
+}: {
+	baseUrl: string;
+	secretKey: string;
+	fetch?: typeof globalThis.fetch;
+}): Promise<OrgInfo> => {
+	const response = await fetch(`${baseUrl}${ORG_INFO_PATH}`, {
+		method: "GET",
+		headers: { authorization: `Bearer ${secretKey}` },
+	});
+
+	const text = await response.text();
+	const body: unknown = text ? JSON.parse(text) : null;
+	if (!response.ok) {
+		throw new AutumnApiError({
+			status: response.status,
+			body,
+			path: ORG_INFO_PATH,
+		});
+	}
+	return body as OrgInfo;
+};

package/src/actions/env/types/orgInfo.ts

@@ -0,0 +1,18 @@
+/** What the server says about the key it was given: the org and the env it unlocks. */
+export type OrgInfo = {
+	id: string;
+	name: string;
+	slug: string;
+	env: string;
+	/** True when the key belongs to a sandbox sub-org rather than the main one. */
+	is_sandbox?: boolean;
+	/** The main organization's id, for a sandbox. */
+	created_by?: string | null;
+	/** `pending` while a keyless org has no owner; null for an ordinary org. */
+	claim_state?: "pending" | "claimed" | "expiring" | null;
+	/** When a pending claim window closes, ISO 8601. */
+	claim_expires_at?: string | null;
+	user?: { id: string; email: string; name: string };
+};
+
+export type FetchOrgInfo = () => Promise<OrgInfo>;