atmn 1.1.24 → 2.0.0

package/dist/src/compose/models/planModels.d.ts

@@ -1,367 +0,0 @@
-import { z } from "zod/v4";
-export declare const AdditionalCurrencySchema: z.ZodObject<{
-    currency: z.ZodString;
-    amount: z.ZodNumber;
-}, z.core.$strip>;
-export declare const AdditionalCurrencyTierSchema: z.ZodObject<{
-    currency: z.ZodString;
-    amount: z.ZodOptional<z.ZodNumber>;
-    flatAmount: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const UsageTierSchema: z.ZodObject<{
-    to: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"inf">]>;
-    amount: z.ZodNumber;
-    additionalCurrencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        currency: z.ZodString;
-        amount: z.ZodOptional<z.ZodNumber>;
-        flatAmount: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-type AutoTopupPurchaseLimit = {
-    interval: "hour" | "day" | "week" | "month";
-    interval_count?: number;
-    limit: number;
-};
-type AutoTopup = {
-    feature_id: string;
-    enabled?: boolean;
-    threshold: number;
-    quantity: number;
-    purchase_limit?: AutoTopupPurchaseLimit;
-    invoice_mode?: boolean;
-};
-type SpendLimit = {
-    feature_id?: string;
-    enabled?: boolean;
-    limit_type?: "absolute" | "usage_percentage";
-    overage_limit?: number;
-    skip_overage_billing?: boolean;
-};
-type UsageLimit = {
-    feature_id: string;
-    enabled?: boolean;
-    limit: number;
-    interval: "day" | "week" | "month" | "year";
-    anchor?: "billing_cycle" | "utc";
-    filter?: UsageLimitFilter;
-};
-type UsageLimitFilter = {
-    properties: Record<string, string>;
-};
-type UsageAlert = {
-    feature_id?: string;
-    enabled?: boolean;
-    threshold: number;
-    threshold_type: "usage" | "usage_percentage" | "remaining" | "remaining_percentage";
-    basis?: "balance" | "included" | "recurring" | "usage_limit";
-    filter?: UsageLimitFilter;
-    name?: string;
-};
-type OverageAllowed = {
-    feature_id: string;
-    enabled?: boolean;
-};
-export type BillingControls = {
-    auto_topups?: AutoTopup[];
-    spend_limits?: SpendLimit[];
-    usage_limits?: UsageLimit[];
-    usage_alerts?: UsageAlert[];
-    overage_allowed?: OverageAllowed[];
-};
-export declare const PlanItemSchema: z.ZodObject<{
-    featureId: z.ZodString;
-    included: z.ZodOptional<z.ZodNumber>;
-    unlimited: z.ZodOptional<z.ZodBoolean>;
-    pooled: z.ZodOptional<z.ZodBoolean>;
-    reset: z.ZodOptional<z.ZodObject<{
-        interval: z.ZodUnion<readonly [z.ZodLiteral<"one_off">, z.ZodLiteral<"minute">, z.ZodLiteral<"hour">, z.ZodLiteral<"day">, z.ZodLiteral<"week">, z.ZodLiteral<"month">, z.ZodLiteral<"quarter">, z.ZodLiteral<"semi_annual">, z.ZodLiteral<"year">]>;
-        interval_count: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    price: z.ZodOptional<z.ZodObject<{
-        amount: z.ZodOptional<z.ZodNumber>;
-        tiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            to: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"inf">]>;
-            amount: z.ZodNumber;
-            additionalCurrencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                currency: z.ZodString;
-                amount: z.ZodOptional<z.ZodNumber>;
-                flatAmount: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>>;
-        additionalCurrencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            currency: z.ZodString;
-            amount: z.ZodNumber;
-        }, z.core.$strip>>>;
-        tier_behavior: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"graduated">, z.ZodLiteral<"volume">]>>;
-        interval: z.ZodUnion<readonly [z.ZodLiteral<"one_off">, z.ZodLiteral<"week">, z.ZodLiteral<"month">, z.ZodLiteral<"quarter">, z.ZodLiteral<"semi_annual">, z.ZodLiteral<"year">]>;
-        interval_count: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-        billing_units: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-        billing_method: z.ZodUnion<readonly [z.ZodLiteral<"prepaid">, z.ZodLiteral<"usage_based">]>;
-        max_purchase: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    proration: z.ZodOptional<z.ZodObject<{
-        on_increase: z.ZodUnion<readonly [z.ZodLiteral<"prorate">, z.ZodLiteral<"charge_immediately">]>;
-        on_decrease: z.ZodUnion<readonly [z.ZodLiteral<"prorate">, z.ZodLiteral<"refund_immediately">, z.ZodLiteral<"no_action">]>;
-    }, z.core.$strip>>;
-    rollover: z.ZodOptional<z.ZodObject<{
-        max: z.ZodOptional<z.ZodNumber>;
-        max_percentage: z.ZodOptional<z.ZodNumber>;
-        expiry_duration_type: z.ZodUnion<readonly [z.ZodLiteral<"month">, z.ZodLiteral<"forever">]>;
-        expiry_duration_length: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    entityFeatureId: z.ZodOptional<z.ZodString>;
-    entitlementId: z.ZodOptional<z.ZodString>;
-    priceId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const FreeTrialSchema: z.ZodObject<{
-    durationLength: z.ZodNumber;
-    durationType: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"day">, z.ZodLiteral<"month">, z.ZodLiteral<"year">]>>;
-    cardRequired: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export declare const BillingControlsSchema: z.ZodCustom<BillingControls, BillingControls>;
-export declare const PlanLicenseSchema: z.ZodObject<{
-    licensePlanId: z.ZodString;
-    version: z.ZodOptional<z.ZodNumber>;
-    included: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export declare const PlanSchema: z.ZodObject<{
-    description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    addOn: z.ZodDefault<z.ZodBoolean>;
-    autoEnable: z.ZodDefault<z.ZodBoolean>;
-    price: z.ZodOptional<z.ZodObject<{
-        amount: z.ZodNumber;
-        interval: z.ZodUnion<readonly [z.ZodLiteral<"one_off">, z.ZodLiteral<"week">, z.ZodLiteral<"month">, z.ZodLiteral<"quarter">, z.ZodLiteral<"semi_annual">, z.ZodLiteral<"year">]>;
-        intervalCount: z.ZodOptional<z.ZodNumber>;
-        additionalCurrencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            currency: z.ZodString;
-            amount: z.ZodNumber;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        featureId: z.ZodString;
-        included: z.ZodOptional<z.ZodNumber>;
-        unlimited: z.ZodOptional<z.ZodBoolean>;
-        pooled: z.ZodOptional<z.ZodBoolean>;
-        reset: z.ZodOptional<z.ZodObject<{
-            interval: z.ZodUnion<readonly [z.ZodLiteral<"one_off">, z.ZodLiteral<"minute">, z.ZodLiteral<"hour">, z.ZodLiteral<"day">, z.ZodLiteral<"week">, z.ZodLiteral<"month">, z.ZodLiteral<"quarter">, z.ZodLiteral<"semi_annual">, z.ZodLiteral<"year">]>;
-            interval_count: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        price: z.ZodOptional<z.ZodObject<{
-            amount: z.ZodOptional<z.ZodNumber>;
-            tiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                to: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"inf">]>;
-                amount: z.ZodNumber;
-                additionalCurrencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    currency: z.ZodString;
-                    amount: z.ZodOptional<z.ZodNumber>;
-                    flatAmount: z.ZodOptional<z.ZodNumber>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>>;
-            additionalCurrencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                currency: z.ZodString;
-                amount: z.ZodNumber;
-            }, z.core.$strip>>>;
-            tier_behavior: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"graduated">, z.ZodLiteral<"volume">]>>;
-            interval: z.ZodUnion<readonly [z.ZodLiteral<"one_off">, z.ZodLiteral<"week">, z.ZodLiteral<"month">, z.ZodLiteral<"quarter">, z.ZodLiteral<"semi_annual">, z.ZodLiteral<"year">]>;
-            interval_count: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-            billing_units: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-            billing_method: z.ZodUnion<readonly [z.ZodLiteral<"prepaid">, z.ZodLiteral<"usage_based">]>;
-            max_purchase: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        proration: z.ZodOptional<z.ZodObject<{
-            on_increase: z.ZodUnion<readonly [z.ZodLiteral<"prorate">, z.ZodLiteral<"charge_immediately">]>;
-            on_decrease: z.ZodUnion<readonly [z.ZodLiteral<"prorate">, z.ZodLiteral<"refund_immediately">, z.ZodLiteral<"no_action">]>;
-        }, z.core.$strip>>;
-        rollover: z.ZodOptional<z.ZodObject<{
-            max: z.ZodOptional<z.ZodNumber>;
-            max_percentage: z.ZodOptional<z.ZodNumber>;
-            expiry_duration_type: z.ZodUnion<readonly [z.ZodLiteral<"month">, z.ZodLiteral<"forever">]>;
-            expiry_duration_length: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        entityFeatureId: z.ZodOptional<z.ZodString>;
-        entitlementId: z.ZodOptional<z.ZodString>;
-        priceId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    freeTrial: z.ZodOptional<z.ZodObject<{
-        durationLength: z.ZodNumber;
-        durationType: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"day">, z.ZodLiteral<"month">, z.ZodLiteral<"year">]>>;
-        cardRequired: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    billingControls: z.ZodOptional<z.ZodCustom<BillingControls, BillingControls>>;
-    licenses: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        licensePlanId: z.ZodString;
-        version: z.ZodOptional<z.ZodNumber>;
-        included: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>;
-    id: z.ZodString;
-    name: z.ZodString;
-    group: z.ZodDefault<z.ZodString>;
-    archived: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export type ResetInterval = "one_off" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "semi_annual" | "year";
-export type RolloverExpiryDurationType = "month" | "forever";
-export type BillingInterval = "one_off" | "week" | "month" | "quarter" | "semi_annual" | "year";
-export type PlanPriceInterval = "one_off" | "week" | "month" | "quarter" | "semi_annual" | "year";
-export type BillingMethod = "prepaid" | "usage_based";
-export type OnIncrease = "prorate" | "charge_immediately";
-export type OnDecrease = "prorate" | "refund_immediately" | "no_action";
-export type AdditionalCurrency = {
-    /** Three-letter ISO currency code (e.g. 'eur', 'gbp') */
-    currency: string;
-    /** Amount in this currency */
-    amount: number;
-};
-export type AdditionalCurrencyTier = {
-    /** Three-letter ISO currency code (e.g. 'eur', 'gbp') */
-    currency: string;
-    /** Per-unit amount for this tier in this currency */
-    amount?: number;
-    /** Flat amount for this tier in this currency */
-    flatAmount?: number;
-};
-type ResetConfig = {
-    /** How often usage resets (e.g., 'month', 'day') */
-    interval: ResetInterval;
-    /** Number of intervals between resets (default: 1) */
-    intervalCount?: number;
-};
-type ProrationConfig = {
-    /** Behavior when quantity increases */
-    onIncrease: OnIncrease;
-    /** Behavior when quantity decreases */
-    onDecrease: OnDecrease;
-};
-type RolloverConfig = {
-    /** Maximum amount that can roll over (null for unlimited). Mutually exclusive with maxPercentage. */
-    max?: number | null;
-    /** Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max. */
-    maxPercentage?: number | null;
-    /** How long rollover lasts before expiring */
-    expiryDurationType: RolloverExpiryDurationType;
-    /** Duration length for rollover expiry */
-    expiryDurationLength?: number;
-};
-type PlanItemBaseFields = {
-    /** Reference to the feature being configured */
-    featureId: string;
-    /** The entity feature ID of the product item if applicable */
-    entityFeatureId?: string | null;
-    /** Amount of usage included in this plan */
-    included?: number;
-    /** Whether usage is unlimited */
-    unlimited?: boolean;
-    /** Whether entity-level grants contribute to a shared customer balance */
-    pooled?: boolean;
-    /** Proration rules for quantity changes */
-    proration?: ProrationConfig;
-    /** Rollover policy for unused usage */
-    rollover?: RolloverConfig;
-};
-type PriceBaseFields = {
-    /** Billing method: 'prepaid' or 'usage_based' */
-    billingMethod: BillingMethod;
-    /** Number of units per billing cycle */
-    billingUnits?: number;
-    /** Maximum purchasable quantity */
-    maxPurchase?: number;
-};
-type PriceWithAmount = PriceBaseFields & {
-    /** Price amount */
-    amount: number;
-    /** Cannot have tiers when using flat amount */
-    tiers?: never;
-    /** Flat price amounts in additional currencies */
-    additionalCurrencies?: AdditionalCurrency[];
-};
-type PriceWithTiers = PriceBaseFields & {
-    /** Cannot have flat amount when using tiers */
-    amount?: never;
-    /** Tiered pricing structure based on usage ranges */
-    tiers: Array<{
-        to: number | "inf";
-        amount: number;
-        flatAmount?: number;
-        /** Per-tier amounts in additional currencies */
-        additionalCurrencies?: AdditionalCurrencyTier[];
-    }>;
-    /** Required when tiers is defined: how tiers are applied */
-    tierBehavior: "graduated" | "volume";
-    /** Tiered prices carry additional currencies per tier, not at price level */
-    additionalCurrencies?: never;
-};
-type PriceAmountOrTiers = PriceWithAmount | PriceWithTiers;
-type Price = PriceAmountOrTiers & {
-    /** Billing interval - omit for one-off pricing */
-    interval?: BillingInterval;
-    /** Number of intervals between billing cycles (default: 1) */
-    intervalCount?: number;
-};
-/** Plan item with a free reset cycle (e.g. 100 messages per month). */
-export type PlanItemWithReset = PlanItemBaseFields & {
-    /** Reset configuration for the included allowance */
-    reset: ResetConfig;
-    price?: never;
-};
-/**
- * Plan item with prepaid or usage-based pricing.
- * Prepaid items may reset on a different cycle from billing.
- */
-export type PlanItemWithPrice = PlanItemBaseFields & {
-    /** Reset configuration when it differs from the billing cycle */
-    reset?: ResetConfig;
-    /** Pricing configuration */
-    price: Price;
-};
-/**
- * Plan item with no reset and no price.
- * Use for continuous-use or boolean features (e.g. seats, feature flags).
- */
-export type PlanItemNoReset = PlanItemBaseFields & {
-    /** No reset for continuous-use features */
-    reset?: never;
-    /** No price for free/boolean features */
-    price?: never;
-};
-/**
- * Plan item configuration:
- * - PlanItemWithReset: included allowance that resets on an interval (e.g. 100/month free)
- * - PlanItemWithPrice: prepaid or usage-based pricing with a billing cycle
- * - PlanItemNoReset: no reset, no price (continuous-use or boolean features)
- */
-export type PlanItem = PlanItemWithReset | PlanItemWithPrice | PlanItemNoReset;
-export type FreeTrial = z.infer<typeof FreeTrialSchema>;
-export type PlanLicense = z.infer<typeof PlanLicenseSchema>;
-export type Plan = {
-    /** Unique identifier for the plan. */
-    id: string;
-    /** Display name of the plan. */
-    name: string;
-    /** Optional description of the plan. */
-    description?: string | null;
-    /** Group identifier for organizing related plans. Plans in the same group are mutually exclusive. */
-    group?: string;
-    /** If true, this plan can be attached alongside other plans. Otherwise, attaching replaces existing plans in the same group. */
-    addOn?: boolean;
-    /** If true, plan is automatically attached when a customer is created. Use for free tiers. */
-    autoEnable?: boolean;
-    /** Base price for the plan */
-    price?: {
-        /** Price in your currency (e.g., 50 for $50.00) */
-        amount: number;
-        /** Billing frequency */
-        interval: PlanPriceInterval;
-        /** Base price amounts in additional currencies */
-        additionalCurrencies?: AdditionalCurrency[];
-    };
-    /** Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. */
-    items?: PlanItem[];
-    /** Free trial period before billing begins */
-    freeTrial?: FreeTrial | null;
-    /** Plan-level billing controls used as customer defaults */
-    billingControls?: BillingControls;
-    /** Plans offered as assignable licenses under this plan. */
-    licenses?: PlanLicense[];
-    /** Whether the plan is archived */
-    archived?: boolean;
-};
-export {};

package/dist/src/compose/models/rewardModels.d.ts

@@ -1,52 +0,0 @@
-export type RewardDuration = {
-    type: "months";
-    length: number;
-} | {
-    type: "one_off" | "forever";
-    length?: never;
-};
-type NonEmptyArray<T> = [T, ...T[]];
-export type CouponReward = {
-    id: string;
-    name: string;
-    type: "percentage_discount" | "fixed_discount";
-    value: number;
-    duration: RewardDuration;
-    planIds?: string[];
-    promoCodes?: Array<{
-        code: string;
-        maxRedemptions?: number;
-        firstTimeTransaction?: boolean;
-    }>;
-    readonly __atmnType?: "reward";
-};
-export type FeatureGrantReward = {
-    id: string;
-    name: string;
-    type: "feature_grant";
-    grants: NonEmptyArray<{
-        featureId: string;
-        included?: number;
-        expiry?: {
-            type: "day" | "week" | "month" | "year";
-            length: number;
-        };
-    }>;
-    promoCodes: NonEmptyArray<{
-        code: string;
-        maxUses?: number;
-    }>;
-    readonly __atmnType?: "reward";
-};
-export type Reward = CouponReward | FeatureGrantReward;
-export type ReferralProgram = {
-    id: string;
-    rewardId: string;
-    redeemOn: "customer_creation" | "checkout";
-    receivedBy: "referrer" | "all";
-    maxRedemptions?: number;
-    planIds?: string[];
-    excludeTrial?: boolean;
-    readonly __atmnType?: "referral_program";
-};
-export {};

package/dist/src/compose/models/variantModels.d.ts

@@ -1,34 +0,0 @@
-import type { BillingInterval, BillingMethod, FreeTrial, Plan as BasePlan, PlanItem, PlanPriceInterval, ResetInterval } from "./planModels.js";
-type ApiBasePrice = {
-    amount: number;
-    interval: PlanPriceInterval;
-    interval_count?: number;
-};
-export type PlanItemFilter = {
-    featureId?: string;
-    billingMethod?: BillingMethod;
-    interval?: BillingInterval | ResetInterval;
-    intervalCount?: number;
-};
-export type CustomizePlan = {
-    price?: (Pick<ApiBasePrice, "amount" | "interval"> & {
-        intervalCount?: ApiBasePrice["interval_count"];
-    }) | null;
-    items?: PlanItem[];
-    addItems?: PlanItem[];
-    removeItems?: PlanItemFilter[];
-    freeTrial?: FreeTrial | null;
-};
-export type Variant = {
-    id: string;
-    name: string;
-    version?: number;
-    customize?: CustomizePlan;
-    readonly __atmnType?: "variant";
-};
-export type Plan = BasePlan & {
-    version?: number;
-    variants?: Variant[];
-    variant?: (params: Omit<Variant, "__atmnType">) => Variant;
-};
-export {};

package/readme.md

@@ -1,186 +0,0 @@
-# atmn
-
-The CLI for [Autumn](https://useautumn.com) — define your pricing in code, sync it to Autumn, and keep everything in version control.
-
-## Install
-
-```bash
-npm install -g atmn
-```
-
-Or run directly:
-
-```bash
-npx atmn <command>
-```
-
-## Quick Start
-
-```bash
-atmn login          # Authenticate via OAuth
-atmn init           # Scaffold a project from a template
-atmn push           # Deploy your config to Autumn
-atmn pull           # Pull changes & generate SDK types
-```
-
-## Templates
-
-`atmn init` offers starter templates for common pricing models:
-
-- **OpenAI** — Credit system with model tiers
-- **T3 Chat** — Seats + message limits
-- **Railway** — Resource-based usage pricing
-- **Linear** — Feature flags + usage controls
-
-## What It Does
-
-You define features and plans in an `autumn.config.ts` file. The CLI syncs that config with your Autumn account — push to deploy, pull to fetch updates. It also generates TypeScript definitions so your SDK calls are type-safe.
-
-```ts
-import { feature, plan, planFeature } from 'atmn';
-
-export const messages = feature({
-  id: 'messages',
-  name: 'AI Messages',
-  type: 'metered',
-  consumable: true,
-});
-
-export const pro = plan({
-  id: 'pro',
-  name: 'Pro',
-  price: { amount: 2000, interval: 'month' },
-  items: [
-    planFeature({
-      feature_id: messages.id,
-      included: 1000,
-      reset: { interval: 'month' },
-    }),
-  ],
-});
-```
-
-## Commands
-
-### Authentication
-
-| Command | Description |
-|---------|-------------|
-| `atmn login` | Authenticate with Autumn (OAuth 2.0) |
-| `atmn logout` | Remove API keys from `.env` |
-| `atmn env` | Show current org and environment |
-
-### Configuration
-
-| Command | Description |
-|---------|-------------|
-| `atmn init` | Initialize a project with a starter template |
-| `atmn push` | Push local config to Autumn |
-| `atmn pull` | Pull config from Autumn and generate SDK types |
-| `atmn preview` | Preview plans locally (no API calls) |
-| `atmn config` | View and set global CLI configuration |
-
-### Data
-
-| Command | Description |
-|---------|-------------|
-| `atmn customers` | Browse and inspect customers |
-| `atmn plans` | Browse and inspect plans (alias: `products`) |
-| `atmn features` | Browse and inspect features |
-| `atmn events` | Browse and analyze usage events |
-
-### Utility
-
-| Command | Description |
-|---------|-------------|
-| `atmn nuke` | Permanently delete all sandbox data |
-| `atmn version` | Show CLI version |
-
-## Global Flags
-
-| Flag | Description |
-|------|-------------|
-| `-p, --prod` | Use production environment (default: sandbox) |
-| `-c, --config <path>` | Path to config file (default: `autumn.config.ts`) |
-| `--headless` | Force non-interactive mode (for CI/agents) |
-
-Flags combine: `atmn push -p` pushes to production.
-
-## Push & Pull
-
-**Push** analyzes your local config against remote state, shows you exactly what will change, and syncs it:
-
-```bash
-atmn push           # Deploy to sandbox
-atmn push --prod    # Deploy to production (extra confirmation)
-atmn push --yes     # Auto-confirm (for CI/CD)
-```
-
-**Pull** fetches your config and generates typed SDK definitions:
-
-```bash
-atmn pull           # Smart in-place update
-```
-
-
-### Declaration File
-
-Pull generates `@useautumn-sdk.d.ts` by default. To skip it:
-
-```bash
-atmn pull --no-declaration-file
-```
-
-Or set it globally:
-
-```bash
-atmn config --global noDeclarationFile true
-```
-
-## Data Commands
-
-All data commands have an interactive mode (default) and a headless mode for scripting:
-
-```bash
-atmn customers                              # Interactive browser
-atmn customers --headless --format json     # JSON output
-atmn customers --headless --format csv      # CSV export
-atmn customers --headless --id "cus_123"    # Specific customer
-```
-
-Events support aggregation:
-
-```bash
-atmn events --mode aggregate --bin day --time 30d
-atmn events --customer "cus_123" --feature "messages" --time 7d
-```
-
-## Global Config
-
-Manage persistent CLI settings:
-
-```bash
-atmn config                              # Show config file location and keys
-atmn config --global                     # Same as above
-atmn config --global noDeclarationFile   # Read a key
-atmn config --global noDeclarationFile true   # Set a key
-```
-
-## CI/CD
-
-The CLI auto-detects non-TTY environments and switches to headless mode. Set your API keys as environment variables:
-
-```yaml
-# GitHub Actions
-- name: Deploy to Autumn
-  run: atmn push --prod --yes
-  env:
-    AUTUMN_PROD_SECRET_KEY: ${{ secrets.AUTUMN_PROD_SECRET_KEY }}
-```
-
-## Links
-
-- [Documentation](https://docs.useautumn.com)
-- [Dashboard](https://app.useautumn.com)
-- [Main GitHub](https://github.com/useautumn/autumn)
-- [CLI & SDKs GitHub](https://github.com/useautumn/typescript)