adapty 0.9.2 → 0.9.4

package/oclif.manifest.json

@@ -1177,12 +1177,27 @@
         "update.js"
       ]
     },
-    "paywalls:create": {
+    "migrations:close": {
       "aliases": [],
       "args": {},
-      "description": "Create a paywall with products",
+      "description": "Choose finish to mark the migration as completed, or cancel to abandon it.\nBoth outcomes permanently close the migration and require --yes. No confirmation prompt is shown.\n\nWith --json, returns the full migration response after closing.",
       "examples": [
-        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+        {
+          "description": "Finish the saved migration:",
+          "command": "<%= config.bin %> migrations close --outcome finish --yes"
+        },
+        {
+          "description": "Mark the migration as finished:",
+          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome finish --yes"
+        },
+        {
+          "description": "Abandon the migration:",
+          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome cancel --yes"
+        },
+        {
+          "description": "Finish and return the final state as JSON:",
+          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome finish --yes --json"
+        }
       ],
       "flags": {
         "json": {
@@ -1192,59 +1207,69 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "product-id",
+        "outcome": {
+          "description": "finish: mark completed; cancel: abandon the migration",
+          "name": "outcome",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
+          "options": [
+            "finish",
+            "cancel"
+          ],
           "type": "option"
         },
-        "title": {
-          "description": "Paywall title",
-          "name": "title",
+        "yes": {
+          "char": "y",
+          "description": "Confirm permanent closure of this migration",
+          "name": "yes",
           "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:create",
+      "id": "migrations:close",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Permanently finish or cancel a migration",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "create.js"
+        "migrations",
+        "close.js"
       ]
     },
-    "paywalls:get": {
+    "migrations:create": {
       "aliases": [],
-      "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
-          "required": true
-        }
-      },
-      "description": "Get paywall details",
+      "args": {},
+      "description": "Use --name to migrate a catalog into a new Adapty app.\nFor an existing app, use --flow and --app together. Choose a flow and its app from `adapty migrations list`.\n\nCreation starts the flow and saves it as current; use `adapty migrations status` to continue.\nUse --no-select to keep the previous selection. ADAPTY_MIGRATION overrides saved selection.\nWith --json, the migration ID is in migration.id.",
       "examples": [
-        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        {
+          "description": "Start a catalog migration into a new app:",
+          "command": "<%= config.bin %> migrations create --name \"Acme Fitness\""
+        },
+        {
+          "description": "Start transactions for an existing app, if listed as available:",
+          "command": "<%= config.bin %> migrations create --flow transactions --app 3f2ab1c4-0000-4000-8000-000000000000"
+        },
+        {
+          "description": "Return the new migration as JSON for an agent or script:",
+          "command": "<%= config.bin %> migrations create --name \"Acme Fitness\" --json"
+        }
       ],
       "flags": {
         "json": {
@@ -1254,37 +1279,74 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "no-select": {
+          "description": "Create without changing the saved migration selection",
+          "name": "no-select",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "description": "New Adapty app name; cannot be combined with --flow or --app",
+          "exclusive": [
+            "app",
+            "flow"
+          ],
+          "name": "name",
+          "hasDynamicHelp": false,
+          "helpValue": "APP_NAME",
+          "multiple": false,
+          "type": "option"
+        },
+        "flow": {
+          "dependsOn": [
+            "app"
+          ],
+          "description": "Available flow from `adapty migrations list`; requires --app",
+          "name": "flow",
+          "hasDynamicHelp": false,
+          "helpValue": "FLOW",
+          "multiple": false,
+          "type": "option"
+        },
         "app": {
-          "description": "App ID (UUID)",
+          "dependsOn": [
+            "flow"
+          ],
+          "description": "Existing Adapty app ID (UUID); requires --flow",
           "name": "app",
-          "required": true,
           "hasDynamicHelp": false,
+          "helpValue": "APP_ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:get",
+      "id": "migrations:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Start a migration into Adapty",
+      "usage": [
+        "migrations create --name APP_NAME [--no-select] [--json]",
+        "migrations create --flow FLOW --app APP_ID [--no-select] [--json]"
+      ],
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "get.js"
+        "migrations",
+        "create.js"
       ]
     },
-    "paywalls:list": {
+    "migrations:current": {
       "aliases": [],
       "args": {},
-      "description": "List paywalls for an app",
+      "description": "ADAPTY_MIGRATION takes precedence over the saved selection for the current token.\nWith no applicable selection, returns null and exits successfully.",
       "examples": [
-        "<%= config.bin %> paywalls list --app 550e8400-..."
+        "<%= config.bin %> migrations current",
+        "<%= config.bin %> migrations current --json"
       ],
       "flags": {
         "json": {
@@ -1293,60 +1355,38 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:list",
+      "id": "migrations:current",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "summary": "Show the effective migration selection and its source (no network)",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "list.js"
+        "migrations",
+        "current.js"
       ]
     },
-    "paywalls:placements": {
+    "migrations:list": {
       "aliases": [],
-      "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
-          "required": true
-        }
-      },
-      "description": "List placements that currently use this paywall",
+      "args": {},
+      "description": "Use a migration ID with `adapty migrations status -m ID` to continue an existing flow.\nStart an available flow with `adapty migrations create --flow FLOW --app APP_ID`.\n\nWith --json, items contains migrations and available contains flows with their target apps.",
       "examples": [
-        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
+        {
+          "description": "Find migrations and available flows, grouped by app:",
+          "command": "<%= config.bin %> migrations list"
+        },
+        {
+          "description": "Read migration IDs and available flows as JSON:",
+          "command": "<%= config.bin %> migrations list --json"
+        }
       ],
       "flags": {
         "json": {
@@ -1355,44 +1395,59 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:placements",
+      "id": "migrations:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "List migrations and the flows you can start",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "placements.js"
+        "migrations",
+        "list.js"
       ]
     },
-    "paywalls:update": {
+    "migrations:run": {
       "aliases": [],
       "args": {
-        "paywall_id": {
-          "description": "Paywall ID (UUID)",
-          "name": "paywall_id",
+        "action_id": {
+          "description": "Offered action ID from `adapty migrations status`",
+          "name": "action_id",
           "required": true
         }
       },
-      "description": "Update a paywall",
+      "description": "Choose an action ID from next_actions or available_actions in `adapty migrations status -m ID --json`.\nReplace ACTION_ID in the examples with an offered action ID.\nFor input actions, read the resources in reads and prepare a JSON object matching input_schema.\nOmitting input sends {}. Review confirm before passing --yes.\nWithout --yes, actions requiring confirmation exit with code 6. No confirmation prompt is shown.\n\nExternal actions print a link and open it in an interactive terminal. Complete the browser step, then check status.\nExternal actions reject --input and --input-file, including stdin.\nPipes and --json require --open to launch a browser; BROWSER=none disables it.\nFile uploads are not supported; use the dashboard or an offered Cloud Export action.\n\nAn agent action writes the resources in reads to .git/adapty/<migration ID>/ in the app's git repository and\nprints what a coding agent needs to do it. Run it from the agent, or paste its output into one. The agent\nreports the result by running the action again with --input.\n\nWith --json, returns the full migration response (before the browser step for external actions). For an agent\naction without --input, returns { action_id, files, instructions }: the files written and the text for the agent.\nAfter a revision_conflict error, read status and review the action before retrying.",
       "examples": [
-        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
+        {
+          "description": "Run an offered action on the saved migration after reviewing confirm:",
+          "command": "<%= config.bin %> migrations run ACTION_ID --yes"
+        },
+        {
+          "description": "Read current action IDs and input schemas first:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2 --json"
+        },
+        {
+          "description": "Submit an empty JSON object, if the action input_schema allows it:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input '{}'"
+        },
+        {
+          "description": "Submit a file matching input_schema, after reviewing confirm:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file ./decisions.json --yes --json"
+        },
+        {
+          "description": "Read the same prepared input from stdin:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file - --yes --json < ./decisions.json"
+        },
+        {
+          "description": "Get an external action link without opening a browser:",
+          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --no-browser"
+        }
       ],
       "flags": {
         "json": {
@@ -1402,55 +1457,105 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "product-id": {
-          "description": "Product ID (UUID). Repeat for multiple.",
-          "name": "product-id",
-          "required": true,
+        "input": {
+          "description": "Input action data as a JSON object matching input_schema",
+          "exclusive": [
+            "input-file"
+          ],
+          "name": "input",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "helpValue": "JSON",
+          "multiple": false,
           "type": "option"
         },
-        "title": {
-          "description": "Paywall title",
-          "name": "title",
-          "required": true,
+        "input-file": {
+          "description": "Read an input action's JSON object from a file; use - for stdin",
+          "exclusive": [
+            "input"
+          ],
+          "name": "input-file",
           "hasDynamicHelp": false,
+          "helpValue": "PATH",
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Confirm the input action after reviewing its confirmation text",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "open": {
+          "description": "Open an external action's HTTPS link, including with pipes or --json",
+          "exclusive": [
+            "no-browser"
+          ],
+          "name": "open",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-browser": {
+          "description": "Show the external action without opening a browser",
+          "exclusive": [
+            "open"
+          ],
+          "name": "no-browser",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "paywalls:update",
+      "id": "migrations:run",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Run an input action, open an external action link, or hand an agent action to a coding agent",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "paywalls",
-        "update.js"
+        "migrations",
+        "run.js"
       ]
     },
-    "placements:create": {
+    "migrations:show": {
       "aliases": [],
-      "args": {},
-      "description": "Create a placement with a paywall",
+      "args": {
+        "resource": {
+          "description": "Resource name; omit to list what can be read now",
+          "name": "resource"
+        }
+      },
+      "description": "Omit RESOURCE to list what can be read now. Use a name from that list, such as apps or mapping.\n\nReading a resource prints its data as JSON. With --json, returns the full migration response.\nResource data is in result (null if no data is available yet).",
       "examples": [
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        {
+          "description": "Read the RevenueCat apps of the selected migration:",
+          "command": "<%= config.bin %> migrations show apps"
+        },
+        {
+          "description": "List resource names available now:",
+          "command": "<%= config.bin %> migrations show -m mig_7x2"
+        },
+        {
+          "description": "Read mapping data, if listed as available:",
+          "command": "<%= config.bin %> migrations show mapping -m mig_7x2"
+        },
+        {
+          "description": "Extract only the resource data (requires jq):",
+          "command": "<%= config.bin %> migrations show mapping -m mig_7x2 --json | jq '.result'"
+        }
       ],
       "flags": {
         "json": {
@@ -1460,73 +1565,53 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "audiences": {
-          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
-          "name": "audiences",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
-          "required": true,
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:create",
+      "id": "migrations:show",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "List migration resources or read one resource",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "create.js"
+        "migrations",
+        "show.js"
       ]
     },
-    "placements:get": {
+    "migrations:status": {
       "aliases": [],
-      "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
-          "required": true
-        }
-      },
-      "description": "Get placement details",
+      "args": {},
+      "description": "Read next_actions for the next steps and available_actions for optional actions.\nUse --json to read each action's input_schema, reads, and confirmation text.\n\n--wait returns when the revision changes, the state leaves running, or the polling budget runs out.\nExit 0 means the request succeeded, even if the migration is still running or has failed.\nCheck migration.state in JSON output. Progress goes to stderr. Ctrl+C exits with code 130.",
       "examples": [
-        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        {
+          "description": "Inspect the saved migration:",
+          "command": "<%= config.bin %> migrations status"
+        },
+        {
+          "description": "See the current state and what to do next:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2"
+        },
+        {
+          "description": "Read action IDs, input schemas, and confirmation text as JSON:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2 --json"
+        },
+        {
+          "description": "Wait for a change with a five-minute polling budget:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2 --wait --timeout 5m --json"
+        }
       ],
       "flags": {
         "json": {
@@ -1536,37 +1621,66 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
+          "hasDynamicHelp": false,
+          "helpValue": "ID",
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "dependsOn": [
+            "wait"
+          ],
+          "description": "Polling budget with --wait: 1-600s, default 120s (e.g. 300, 300s, 5m); in-flight requests may take longer",
+          "name": "timeout",
           "hasDynamicHelp": false,
+          "helpValue": "DURATION",
           "multiple": false,
           "type": "option"
+        },
+        "wait": {
+          "description": "Poll for a revision or state change, then return the latest response",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:get",
+      "id": "migrations:status",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Show migration state, issues, and available actions",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "get.js"
+        "migrations",
+        "status.js"
       ]
     },
-    "placements:list": {
+    "migrations:steps": {
       "aliases": [],
       "args": {},
-      "description": "List placements for an app",
+      "description": "Shows done, active, and locked steps in migration order.\nTo find actions you can run, use `adapty migrations status -m ID`.\n\nWith --json, the full migration response is returned; the checklist is in steps.",
       "examples": [
-        "<%= config.bin %> placements list --app 550e8400-..."
+        {
+          "description": "View the saved migration checklist:",
+          "command": "<%= config.bin %> migrations steps"
+        },
+        {
+          "description": "View the checklist:",
+          "command": "<%= config.bin %> migrations steps -m mig_7x2"
+        },
+        {
+          "description": "Extract the checklist as JSON (requires jq):",
+          "command": "<%= config.bin %> migrations steps -m mig_7x2 --json | jq '.steps'"
+        }
       ],
       "flags": {
         "json": {
@@ -1576,61 +1690,38 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "migration": {
+          "char": "m",
+          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
+          "name": "migration",
           "hasDynamicHelp": false,
+          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:list",
+      "id": "migrations:steps",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Show the migration checklist and step statuses",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "list.js"
+        "migrations",
+        "steps.js"
       ]
     },
-    "placements:update": {
+    "migrations:unuse": {
       "aliases": [],
-      "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
-          "required": true
-        }
-      },
-      "description": "Update a placement",
+      "args": {},
+      "description": "Works without authentication, including when the saved context is malformed.\nADAPTY_MIGRATION remains active until you unset it in your shell.",
       "examples": [
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
+        "<%= config.bin %> migrations unuse"
       ],
       "flags": {
         "json": {
@@ -1639,68 +1730,69 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "audiences": {
-          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
-          "name": "audiences",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "migrations:unuse",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
+      "summary": "Clear the saved migration selection (no network)",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "update.js"
+        "migrations",
+        "unuse.js"
       ]
     },
-    "products:create": {
+    "migrations:use": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Migration ID from `adapty migrations list`",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Select a migration for the current token. This does not start or modify the migration.\nCompleted, canceled and failed migrations can also be selected for inspection.\nADAPTY_MIGRATION overrides the saved selection until you unset it in your shell.",
+      "examples": [
+        "<%= config.bin %> migrations use mig_7x2"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:use",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Save the current migration after verifying access",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "use.js"
+      ]
+    },
+    "paywalls:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a product with vendor products per platform",
+      "description": "Create a paywall with products",
       "examples": [
-        "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
+        "<%= config.bin %> paywalls create --app UUID --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -1718,80 +1810,16 @@
           "multiple": false,
           "type": "option"
         },
-        "access-level-id": {
-          "description": "Access level ID (UUID)",
-          "name": "access-level-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "android-base-plan-id": {
-          "description": "Android base plan ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "android-base-plan-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "android-product-id": {
-          "description": "Android product ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "android-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "ios-product-id": {
-          "description": "iOS product ID",
-          "helpGroup": "STORE BINDINGS",
-          "name": "ios-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "paddle-price-id": {
-          "description": "Paddle price ID (requires --paddle-product-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "paddle-price-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "paddle-product-id": {
-          "description": "Paddle product ID (requires --paddle-price-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "paddle-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "period": {
-          "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
-          "name": "period",
+        "product-id": {
+          "description": "Product ID (UUID). Repeat for multiple.",
+          "name": "product-id",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stripe-price-id": {
-          "description": "Stripe price ID (requires --stripe-product-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "stripe-price-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stripe-product-id": {
-          "description": "Stripe product ID (requires --stripe-price-id)",
-          "helpGroup": "STORE BINDINGS",
-          "name": "stripe-product-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "title": {
-          "description": "Product title",
+          "description": "Paywall title",
           "name": "title",
           "required": true,
           "hasDynamicHelp": false,
@@ -1801,7 +1829,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:create",
+      "id": "paywalls:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1811,22 +1839,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "paywalls",
         "create.js"
       ]
     },
-    "products:get": {
+    "paywalls:get": {
       "aliases": [],
       "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Get product details",
+      "description": "Get paywall details",
       "examples": [
-        "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> paywalls get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1847,7 +1875,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:get",
+      "id": "paywalls:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1857,16 +1885,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "paywalls",
         "get.js"
       ]
     },
-    "products:list": {
+    "paywalls:list": {
       "aliases": [],
       "args": {},
-      "description": "List products for an app",
+      "description": "List paywalls for an app",
       "examples": [
-        "<%= config.bin %> products list --app 550e8400-..."
+        "<%= config.bin %> paywalls list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1903,7 +1931,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:list",
+      "id": "paywalls:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1913,22 +1941,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
+        "paywalls",
         "list.js"
       ]
     },
-    "products:update": {
+    "paywalls:placements": {
       "aliases": [],
       "args": {
-        "product_id": {
-          "description": "Product ID (UUID)",
-          "name": "product_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Update a product (title and access level only)",
+      "description": "List placements that currently use this paywall",
       "examples": [
-        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
+        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
       ],
       "flags": {
         "json": {
@@ -1945,27 +1973,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "access-level-id": {
-          "description": "Access level ID (UUID)",
-          "name": "access-level-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "title": {
-          "description": "Product title",
-          "name": "title",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "products:update",
+      "id": "paywalls:placements",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1975,22 +1987,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "products",
-        "update.js"
+        "paywalls",
+        "placements.js"
       ]
     },
-    "segments:get": {
+    "paywalls:update": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
           "required": true
         }
       },
-      "description": "Get segment details",
+      "description": "Update a paywall",
       "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> paywalls update --app UUID 550e8400-... --title \"Default Paywall\" --product-id UUID1 --product-id UUID2"
       ],
       "flags": {
         "json": {
@@ -2007,30 +2019,48 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "segments:get",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "segments",
-        "get.js"
+        },
+        "product-id": {
+          "description": "Product ID (UUID). Repeat for multiple.",
+          "name": "product-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "title": {
+          "description": "Paywall title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "paywalls:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "paywalls",
+        "update.js"
       ]
     },
-    "segments:list": {
+    "placements:create": {
       "aliases": [],
       "args": {},
-      "description": "List segments for an app",
+      "description": "Create a placement with a paywall",
       "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -2048,18 +2078,32 @@
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "audiences": {
+          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
+          "name": "audiences",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Placement title",
+          "name": "title",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2067,7 +2111,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:list",
+      "id": "placements:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2077,31 +2121,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
-        "list.js"
+        "placements",
+        "create.js"
       ]
     },
-    "migrations:close": {
+    "placements:get": {
       "aliases": [],
-      "args": {},
-      "description": "Choose finish to mark the migration as completed, or cancel to abandon it.\nBoth outcomes permanently close the migration and require --yes. No confirmation prompt is shown.\n\nWith --json, returns the full migration response after closing.",
-      "examples": [
-        {
-          "description": "Finish the saved migration:",
-          "command": "<%= config.bin %> migrations close --outcome finish --yes"
-        },
-        {
-          "description": "Mark the migration as finished:",
-          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome finish --yes"
-        },
-        {
-          "description": "Abandon the migration:",
-          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome cancel --yes"
-        },
-        {
-          "description": "Finish and return the final state as JSON:",
-          "command": "<%= config.bin %> migrations close -m mig_7x2 --outcome finish --yes --json"
+      "args": {
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
+          "required": true
         }
+      },
+      "description": "Get placement details",
+      "examples": [
+        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2111,69 +2146,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "migration": {
-          "char": "m",
-          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
-          "name": "migration",
-          "hasDynamicHelp": false,
-          "helpValue": "ID",
-          "multiple": false,
-          "type": "option"
-        },
-        "outcome": {
-          "description": "finish: mark completed; cancel: abandon the migration",
-          "name": "outcome",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "finish",
-            "cancel"
-          ],
           "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Confirm permanent closure of this migration",
-          "name": "yes",
-          "required": true,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:close",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Permanently finish or cancel a migration",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "close.js"
+        "placements",
+        "get.js"
       ]
     },
-    "migrations:create": {
+    "placements:list": {
       "aliases": [],
       "args": {},
-      "description": "Use --name to migrate a catalog into a new Adapty app.\nFor an existing app, use --flow and --app together. Choose a flow and its app from `adapty migrations list`.\n\nCreation starts the flow and saves it as current; use `adapty migrations status` to continue.\nUse --no-select to keep the previous selection. ADAPTY_MIGRATION overrides saved selection.\nWith --json, the migration ID is in migration.id.",
+      "description": "List placements for an app",
       "examples": [
-        {
-          "description": "Start a catalog migration into a new app:",
-          "command": "<%= config.bin %> migrations create --name \"Acme Fitness\""
-        },
-        {
-          "description": "Start transactions for an existing app, if listed as available:",
-          "command": "<%= config.bin %> migrations create --flow transactions --app 3f2ab1c4-0000-4000-8000-000000000000"
-        },
-        {
-          "description": "Return the new migration as JSON for an agent or script:",
-          "command": "<%= config.bin %> migrations create --name \"Acme Fitness\" --json"
-        }
+        "<%= config.bin %> placements list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -2183,74 +2186,61 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "no-select": {
-          "description": "Create without changing the saved migration selection",
-          "name": "no-select",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "name": {
-          "description": "New Adapty app name; cannot be combined with --flow or --app",
-          "exclusive": [
-            "app",
-            "flow"
-          ],
-          "name": "name",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "APP_NAME",
           "multiple": false,
           "type": "option"
         },
-        "flow": {
-          "dependsOn": [
-            "app"
-          ],
-          "description": "Available flow from `adapty migrations list`; requires --app",
-          "name": "flow",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
-          "helpValue": "FLOW",
           "multiple": false,
           "type": "option"
         },
-        "app": {
-          "dependsOn": [
-            "flow"
-          ],
-          "description": "Existing Adapty app ID (UUID); requires --flow",
-          "name": "app",
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
           "hasDynamicHelp": false,
-          "helpValue": "APP_ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:create",
+      "id": "placements:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Start a migration into Adapty",
-      "usage": [
-        "migrations create --name APP_NAME [--no-select] [--json]",
-        "migrations create --flow FLOW --app APP_ID [--no-select] [--json]"
-      ],
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "create.js"
+        "placements",
+        "list.js"
       ]
     },
-    "migrations:current": {
+    "placements:update": {
       "aliases": [],
-      "args": {},
-      "description": "ADAPTY_MIGRATION takes precedence over the saved selection for the current token.\nWith no applicable selection, returns null and exits successfully.",
+      "args": {
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
+          "required": true
+        }
+      },
+      "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> migrations current",
-        "<%= config.bin %> migrations current --json"
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"paywall\",\"segment_ids\":[],\"paywall_id\":\"PAYWALL_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --audiences '[{\"content_type\":\"flow\",\"segment_ids\":[],\"flow_id\":\"FLOW_UUID\",\"priority\":0}]'",
+        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -2259,99 +2249,68 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "migrations:current",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Show the effective migration selection and its source (no network)",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "migrations",
-        "current.js"
-      ]
-    },
-    "migrations:list": {
-      "aliases": [],
-      "args": {},
-      "description": "Use a migration ID with `adapty migrations status -m ID` to continue an existing flow.\nStart an available flow with `adapty migrations create --flow FLOW --app APP_ID`.\n\nWith --json, items contains migrations and available contains flows with their target apps.",
-      "examples": [
-        {
-          "description": "Find migrations and available flows, grouped by app:",
-          "command": "<%= config.bin %> migrations list"
         },
-        {
-          "description": "Read migration IDs and available flows as JSON:",
-          "command": "<%= config.bin %> migrations list --json"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "audiences": {
+          "description": "JSON array of audience entries. Every entry needs an explicit content_type. Paywall: {content_type:\"paywall\", segment_ids, paywall_id, priority}. Flow: {content_type:\"flow\", segment_ids, flow_id, priority}. A flow must be published first (flows publish) — attaching a draft flow returns 400.",
+          "name": "audiences",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "developer-id": {
+          "description": "Developer ID for the placement",
+          "name": "developer-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paywall-id": {
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
+          "name": "paywall-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Placement title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:list",
+      "id": "placements:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "List migrations and the flows you can start",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "list.js"
+        "placements",
+        "update.js"
       ]
     },
-    "migrations:run": {
+    "products:create": {
       "aliases": [],
-      "args": {
-        "action_id": {
-          "description": "Offered action ID from `adapty migrations status`",
-          "name": "action_id",
-          "required": true
-        }
-      },
-      "description": "Choose an action ID from next_actions or available_actions in `adapty migrations status -m ID --json`.\nReplace ACTION_ID in the examples with an offered action ID.\nFor input actions, read the resources in reads and prepare a JSON object matching input_schema.\nOmitting input sends {}. Review confirm before passing --yes.\nWithout --yes, actions requiring confirmation exit with code 6. No confirmation prompt is shown.\n\nExternal actions print a link and open it in an interactive terminal. Complete the browser step, then check status.\nExternal actions reject --input and --input-file, including stdin.\nPipes and --json require --open to launch a browser; BROWSER=none disables it.\nFile uploads are not supported; use the dashboard or an offered Cloud Export action.\n\nWith --json, returns the full migration response (before the browser step for external actions).\nAfter a revision_conflict error, read status and review the action before retrying.",
+      "args": {},
+      "description": "Create a product with vendor products per platform",
       "examples": [
-        {
-          "description": "Run an offered action on the saved migration after reviewing confirm:",
-          "command": "<%= config.bin %> migrations run ACTION_ID --yes"
-        },
-        {
-          "description": "Read current action IDs and input schemas first:",
-          "command": "<%= config.bin %> migrations status -m mig_7x2 --json"
-        },
-        {
-          "description": "Submit an empty JSON object, if the action input_schema allows it:",
-          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input '{}'"
-        },
-        {
-          "description": "Submit a file matching input_schema, after reviewing confirm:",
-          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file ./decisions.json --yes --json"
-        },
-        {
-          "description": "Read the same prepared input from stdin:",
-          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --input-file - --yes --json < ./decisions.json"
-        },
-        {
-          "description": "Get an external action link without opening a browser:",
-          "command": "<%= config.bin %> migrations run ACTION_ID -m mig_7x2 --no-browser"
-        }
+        "<%= config.bin %> products create --app UUID --title \"Monthly\" --access-level-id UUID --period monthly --ios-product-id com.example.monthly"
       ],
       "flags": {
         "json": {
@@ -2361,105 +2320,123 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "migration": {
-          "char": "m",
-          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
-          "name": "migration",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "input": {
-          "description": "Input action data as a JSON object matching input_schema",
-          "exclusive": [
-            "input-file"
-          ],
-          "name": "input",
+        "access-level-id": {
+          "description": "Access level ID (UUID)",
+          "name": "access-level-id",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "JSON",
           "multiple": false,
           "type": "option"
         },
-        "input-file": {
-          "description": "Read an input action's JSON object from a file; use - for stdin",
-          "exclusive": [
-            "input"
-          ],
-          "name": "input-file",
+        "android-base-plan-id": {
+          "description": "Android base plan ID",
+          "helpGroup": "STORE BINDINGS",
+          "name": "android-base-plan-id",
           "hasDynamicHelp": false,
-          "helpValue": "PATH",
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "char": "y",
-          "description": "Confirm the input action after reviewing its confirmation text",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "android-product-id": {
+          "description": "Android product ID",
+          "helpGroup": "STORE BINDINGS",
+          "name": "android-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "open": {
-          "description": "Open an external action's HTTPS link, including with pipes or --json",
-          "exclusive": [
-            "no-browser"
-          ],
-          "name": "open",
-          "allowNo": false,
-          "type": "boolean"
+        "ios-product-id": {
+          "description": "iOS product ID",
+          "helpGroup": "STORE BINDINGS",
+          "name": "ios-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "no-browser": {
-          "description": "Show the external action without opening a browser",
-          "exclusive": [
-            "open"
-          ],
-          "name": "no-browser",
-          "allowNo": false,
-          "type": "boolean"
+        "paddle-price-id": {
+          "description": "Paddle price ID (requires --paddle-product-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "paddle-price-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paddle-product-id": {
+          "description": "Paddle product ID (requires --paddle-price-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "paddle-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "period": {
+          "description": "Subscription period (weekly, monthly, two_months, trimonthly, semiannual, annual, lifetime)",
+          "name": "period",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stripe-price-id": {
+          "description": "Stripe price ID (requires --stripe-product-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "stripe-price-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "stripe-product-id": {
+          "description": "Stripe product ID (requires --stripe-price-id)",
+          "helpGroup": "STORE BINDINGS",
+          "name": "stripe-product-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Product title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:run",
+      "id": "products:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Run an input action or open an external action link",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "run.js"
+        "products",
+        "create.js"
       ]
     },
-    "migrations:show": {
+    "products:get": {
       "aliases": [],
       "args": {
-        "resource": {
-          "description": "Resource name; omit to list what can be read now",
-          "name": "resource"
+        "product_id": {
+          "description": "Product ID (UUID)",
+          "name": "product_id",
+          "required": true
         }
       },
-      "description": "Omit RESOURCE to list what can be read now. Use a name from that list, such as apps or mapping.\n\nReading a resource prints its data as JSON. With --json, returns the full migration response.\nResource data is in result (null if no data is available yet).",
+      "description": "Get product details",
       "examples": [
-        {
-          "description": "Read the RevenueCat apps of the selected migration:",
-          "command": "<%= config.bin %> migrations show apps"
-        },
-        {
-          "description": "List resource names available now:",
-          "command": "<%= config.bin %> migrations show -m mig_7x2"
-        },
-        {
-          "description": "Read mapping data, if listed as available:",
-          "command": "<%= config.bin %> migrations show mapping -m mig_7x2"
-        },
-        {
-          "description": "Extract only the resource data (requires jq):",
-          "command": "<%= config.bin %> migrations show mapping -m mig_7x2 --json | jq '.result'"
-        }
+        "<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2469,53 +2446,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "migration": {
-          "char": "m",
-          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
-          "name": "migration",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:show",
+      "id": "products:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "List migration resources or read one resource",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "show.js"
+        "products",
+        "get.js"
       ]
     },
-    "migrations:status": {
+    "products:list": {
       "aliases": [],
       "args": {},
-      "description": "Read next_actions for the next steps and available_actions for optional actions.\nUse --json to read each action's input_schema, reads, and confirmation text.\n\n--wait returns when the revision changes, the state leaves running, or the polling budget runs out.\nExit 0 means the request succeeded, even if the migration is still running or has failed.\nCheck migration.state in JSON output. Progress goes to stderr. Ctrl+C exits with code 130.",
+      "description": "List products for an app",
       "examples": [
-        {
-          "description": "Inspect the saved migration:",
-          "command": "<%= config.bin %> migrations status"
-        },
-        {
-          "description": "See the current state and what to do next:",
-          "command": "<%= config.bin %> migrations status -m mig_7x2"
-        },
-        {
-          "description": "Read action IDs, input schemas, and confirmation text as JSON:",
-          "command": "<%= config.bin %> migrations status -m mig_7x2 --json"
-        },
-        {
-          "description": "Wait for a change with a five-minute polling budget:",
-          "command": "<%= config.bin %> migrations status -m mig_7x2 --wait --timeout 5m --json"
-        }
+        "<%= config.bin %> products list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -2525,66 +2486,121 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "migration": {
-          "char": "m",
-          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
-          "name": "migration",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "dependsOn": [
-            "wait"
-          ],
-          "description": "Polling budget with --wait: 1-600s, default 120s (e.g. 300, 300s, 5m); in-flight requests may take longer",
-          "name": "timeout",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
-          "helpValue": "DURATION",
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "description": "Poll for a revision or state change, then return the latest response",
-          "name": "wait",
-          "allowNo": false,
-          "type": "boolean"
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:status",
+      "id": "products:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show migration state, issues, and available actions",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "status.js"
+        "products",
+        "list.js"
       ]
     },
-    "migrations:steps": {
+    "products:update": {
       "aliases": [],
-      "args": {},
-      "description": "Shows done, active, and locked steps in migration order.\nTo find actions you can run, use `adapty migrations status -m ID`.\n\nWith --json, the full migration response is returned; the checklist is in steps.",
+      "args": {
+        "product_id": {
+          "description": "Product ID (UUID)",
+          "name": "product_id",
+          "required": true
+        }
+      },
+      "description": "Update a product (title and access level only)",
       "examples": [
-        {
-          "description": "View the saved migration checklist:",
-          "command": "<%= config.bin %> migrations steps"
+        "<%= config.bin %> products update --app UUID 550e8400-... --title \"Monthly\" --access-level-id UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        {
-          "description": "View the checklist:",
-          "command": "<%= config.bin %> migrations steps -m mig_7x2"
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        {
-          "description": "Extract the checklist as JSON (requires jq):",
-          "command": "<%= config.bin %> migrations steps -m mig_7x2 --json | jq '.steps'"
+        "access-level-id": {
+          "description": "Access level ID (UUID)",
+          "name": "access-level-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Product title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "products:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "products",
+        "update.js"
+      ]
+    },
+    "segments:get": {
+      "aliases": [],
+      "args": {
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
+          "required": true
         }
+      },
+      "description": "Get segment details",
+      "examples": [
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2594,38 +2610,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "migration": {
-          "char": "m",
-          "description": "Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create",
-          "name": "migration",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "ID",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:steps",
+      "id": "segments:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Show the migration checklist and step statuses",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "steps.js"
+        "segments",
+        "get.js"
       ]
     },
-    "migrations:unuse": {
+    "segments:list": {
       "aliases": [],
       "args": {},
-      "description": "Works without authentication, including when the saved context is malformed.\nADAPTY_MIGRATION remains active until you unset it in your shell.",
+      "description": "List segments for an app",
       "examples": [
-        "<%= config.bin %> migrations unuse"
+        "<%= config.bin %> segments list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -2634,37 +2649,56 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:unuse",
+      "id": "segments:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Clear the saved migration selection (no network)",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "unuse.js"
+        "segments",
+        "list.js"
       ]
     },
-    "migrations:use": {
+    "skills:install": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Migration ID from `adapty migrations list`",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Select a migration for the current token. This does not start or modify the migration.\nCompleted, canceled and failed migrations can also be selected for inspection.\nADAPTY_MIGRATION overrides the saved selection until you unset it in your shell.",
+      "args": {},
+      "description": "Install the Adapty skills into the coding agents on this machine",
       "examples": [
-        "<%= config.bin %> migrations use mig_7x2"
+        "<%= config.bin %> skills install",
+        "<%= config.bin %> skills install --agent claude-code",
+        "<%= config.bin %> skills install --yes"
       ],
       "flags": {
         "json": {
@@ -2673,22 +2707,41 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "agent": {
+          "description": "Install into this agent only. Repeat for several.",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "claude-code",
+            "codex",
+            "gemini-cli"
+          ],
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Install into every agent found without asking; required when several are found and no one can answer. Never runs the npx fallback, which is always asked for",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "migrations:use",
+      "id": "skills:install",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "summary": "Save the current migration after verifying access",
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "migrations",
-        "use.js"
+        "skills",
+        "install.js"
       ]
     },
     "asa:ads:create": {
@@ -4176,42 +4229,245 @@
           "multiple": true,
           "type": "option"
         },
-        "daily-budget": {
-          "description": "Daily budget (amount, e.g. 50 or 12.50)",
-          "name": "daily-budget",
+        "daily-budget": {
+          "description": "Daily budget (amount, e.g. 50 or 12.50)",
+          "name": "daily-budget",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Campaign name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Campaign status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
+          "type": "option"
+        },
+        "target-cpa": {
+          "description": "Target CPA (amount, e.g. 50 or 12.50)",
+          "name": "target-cpa",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:campaigns:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "campaigns",
+        "update.js"
+      ]
+    },
+    "asa:change-history:get": {
+      "aliases": [],
+      "args": {
+        "detail_id": {
+          "description": "Detail ID from asa change-history list (EntityType.entityId.txnId)",
+          "name": "detail_id",
+          "required": true
+        }
+      },
+      "description": "Field-level before/after of one change (proxied from the Apple Ads Platform API)",
+      "examples": [
+        "<%= config.bin %> asa change-history get Campaign.444555666.TXN_ID --campaign-group <uuid>"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "campaign-group": {
+          "description": "Organization the change belongs to (UUID; take campaign_group_id from the list row)",
+          "name": "campaign-group",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:change-history:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "change-history",
+        "get.js"
+      ]
+    },
+    "asa:change-history:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Apple Ads change history of one organization, read live from Apple (proxied from the Apple Ads Platform API)",
+      "examples": [
+        "<%= config.bin %> asa change-history list --campaign-group <uuid>",
+        "<%= config.bin %> asa change-history list --campaign-group <uuid> --date-from 2026-09-01 --entity-type Campaign --event-type UPDATE",
+        "<%= config.bin %> asa change-history list --campaign-group <uuid> --fields"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ad-group": {
+          "description": "Keep only changes inside these Apple ad group ids (not UUIDs); repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign": {
+          "description": "Keep only changes inside these Apple campaign ids (not UUIDs); repeatable",
+          "name": "campaign",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Organization to read (UUID from asa orgs list); one organization per call",
+          "name": "campaign-group",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "Start of the period (YYYY-MM-DD), defaults to 7 days ago; at most 14 days per call, Apple keeps 6 months",
+          "name": "date-from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "End of the period (YYYY-MM-DD), defaults to today",
+          "name": "date-to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "entity-id": {
+          "description": "Keep only changes of these Apple entity ids (not UUIDs); repeatable",
+          "name": "entity-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "entity-type": {
+          "description": "Keep only changes of this entity type; repeatable. Default is the campaign domain (Campaign, AdGroup, Keyword, NegativeKeyword, Ad, Creative, LocationGroup); Org and AdAccount cannot be mixed with it",
+          "name": "entity-type",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "Ad",
+            "AdAccount",
+            "AdGroup",
+            "Campaign",
+            "Creative",
+            "Keyword",
+            "LocationGroup",
+            "NegativeKeyword",
+            "Org"
+          ],
+          "type": "option"
+        },
+        "event-type": {
+          "description": "Keep only this operation; repeatable",
+          "name": "event-type",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "CREATE",
+            "DELETE",
+            "UPDATE"
+          ],
+          "type": "option"
+        },
+        "fields": {
+          "description": "Expand into flat field-level rows (field, old values, new values); page size defaults to 10 and may not exceed it",
+          "name": "fields",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "txn": {
+          "description": "Keep only these Apple transaction ids; repeatable",
+          "name": "txn",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "name": {
-          "description": "Campaign name",
-          "name": "name",
+        "user": {
+          "description": "Keep only changes made by these Apple user ids (not emails); repeatable",
+          "name": "user",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "status": {
-          "description": "Campaign status",
-          "name": "status",
+        "user-type": {
+          "description": "Keep only changes by this actor category; repeatable",
+          "name": "user-type",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "options": [
-            "ENABLED",
-            "PAUSED"
+            "APPLE_SUPPORT",
+            "CUSTOMER",
+            "CUSTOMER_API"
           ],
           "type": "option"
-        },
-        "target-cpa": {
-          "description": "Target CPA (amount, e.g. 50 or 12.50)",
-          "name": "target-cpa",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:campaigns:update",
+      "id": "asa:change-history:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4222,8 +4478,8 @@
         "dist",
         "commands",
         "asa",
-        "campaigns",
-        "update.js"
+        "change-history",
+        "list.js"
       ]
     },
     "asa:competitors:summary": {
@@ -5419,18 +5675,14 @@
         "list.js"
       ]
     },
-    "flows:config:get": {
+    "asa:ad-groups:create": {
       "aliases": [],
-      "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
-          "required": true
-        }
-      },
-      "description": "Read the flow builder config (404 until the config has been written at least once). On a failed publish, `publication_status`, `transform_error` and `publication_error` show why.",
+      "args": {},
+      "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
       "examples": [
-        "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
+        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
+        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
       ],
       "flags": {
         "json": {
@@ -5440,18 +5692,114 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-time": {
+          "description": "Schedule end (YYYY-MM-DD)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-time": {
+          "description": "Schedule start (YYYY-MM-DD), defaults to today",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pricing-model": {
+          "description": "Pricing model; Apple requires one on every ad group",
+          "name": "pricing-model",
+          "default": "CPC",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "CPC",
+            "CPM"
+          ],
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "idempotency-key": {
+          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
+          "name": "idempotency-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "automated": {
+          "description": "Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)",
+          "exclusive": [
+            "automated-keywords"
+          ],
+          "name": "automated",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "automated-keywords": {
+          "description": "Let Apple add keywords automatically",
+          "name": "automated-keywords",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "campaign": {
+          "description": "Campaign ID (UUID)",
+          "name": "campaign",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cpa-goal": {
+          "description": "CPA goal (amount, e.g. 50 or 12.50)",
+          "name": "cpa-goal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-bid": {
+          "description": "Default bid; required unless --automated is set (amount, e.g. 50 or 12.50)",
+          "name": "default-bid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Ad group name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "status": {
+          "description": "Initial status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:get",
+      "id": "asa:ad-groups:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5461,26 +5809,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "get.js"
+        "asa",
+        "ad-groups",
+        "create.js"
       ]
     },
-    "flows:config:preview": {
+    "asa:ad-groups:get": {
       "aliases": [],
       "args": {
-        "config_file": {
-          "description": "Path to a local flow config JSON file",
-          "name": "config_file",
+        "ad_group_id": {
+          "description": "Ad group ID (UUID)",
+          "name": "ad_group_id",
           "required": true
         }
       },
-      "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
+      "description": "Show one ad group; read numbers with asa metrics",
       "examples": [
-        "<%= config.bin %> flows config preview ./config.json",
-        "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
-        "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
-        "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
+        "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -5489,38 +5834,11 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "device": {
-          "description": "Device frame to render in",
-          "name": "device",
-          "default": "iphone-14",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "orientation": {
-          "description": "Device orientation to render in",
-          "name": "orientation",
-          "default": "portrait",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "landscape",
-            "portrait"
-          ],
-          "type": "option"
-        },
-        "screen": {
-          "description": "Screen ID to render (default: the flow's first screen)",
-          "name": "screen",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:preview",
+      "id": "asa:ad-groups:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5530,25 +5848,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "preview.js"
+        "asa",
+        "ad-groups",
+        "get.js"
       ]
     },
-    "flows:config:update": {
+    "asa:ad-groups:list": {
       "aliases": [],
-      "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
-          "required": true
-        }
-      },
-      "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
+      "args": {},
+      "description": "List ad groups; read numbers with asa metrics",
       "examples": [
-        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
-        "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
-        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
+        "<%= config.bin %> asa ad-groups list",
+        "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
       ],
       "flags": {
         "json": {
@@ -5558,46 +5869,65 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config": {
-          "description": "Builder config as a JSON string",
-          "name": "config",
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config-file": {
-          "description": "JSON file with the builder config, or - to read stdin",
-          "name": "config-file",
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "search": {
+          "description": "Case-insensitive substring match on the name",
+          "name": "search",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "expected-updated-at": {
-          "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
-          "name": "expected-updated-at",
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "remote-configs": {
-          "description": "JSON array of remote config entries: [{locale, data}]",
-          "name": "remote-configs",
+        "status": {
+          "description": "Keep only rows in this state",
+          "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:update",
+      "id": "asa:ad-groups:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5607,25 +5937,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "update.js"
+        "asa",
+        "ad-groups",
+        "list.js"
       ]
     },
-    "flows:config:validate": {
+    "asa:ad-groups:update": {
       "aliases": [],
       "args": {
-        "flow_id": {
-          "description": "Flow ID (UUID)",
-          "name": "flow_id",
+        "ad_group_id": {
+          "description": "Ad group ID (UUID)",
+          "name": "ad_group_id",
           "required": true
         }
       },
-      "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
+      "description": "Change an ad group: bid, CPA goal, status or schedule",
       "examples": [
-        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
-        "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
-        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
+        "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
+        "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
       ],
       "flags": {
         "json": {
@@ -5635,32 +5964,84 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config": {
-          "description": "Builder config as a JSON string",
-          "name": "config",
+        "end-time": {
+          "description": "Schedule end (YYYY-MM-DD)",
+          "name": "end-time",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config-file": {
-          "description": "JSON file with the builder config, or - to read stdin",
-          "name": "config-file",
+        "start-time": {
+          "description": "Schedule start (YYYY-MM-DD), defaults to today",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Apply without asking; required when the output is piped or --json is used",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "idempotency-key": {
+          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
+          "name": "idempotency-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "automated-keywords": {
+          "description": "Let Apple add keywords automatically",
+          "name": "automated-keywords",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "cpa-goal": {
+          "description": "CPA goal (amount, e.g. 50 or 12.50)",
+          "name": "cpa-goal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "default-bid": {
+          "description": "Default bid (amount, e.g. 50 or 12.50)",
+          "name": "default-bid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Ad group name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Ad group status",
+          "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:config:validate",
+      "id": "asa:ad-groups:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5670,23 +6051,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "flows",
-        "config",
-        "validate.js"
+        "asa",
+        "ad-groups",
+        "update.js"
       ]
     },
-    "flows:media:upload": {
+    "flows:config:get": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to the image file to upload",
-          "name": "file",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
+      "description": "Read the flow builder config (404 until the config has been written at least once). On a failed publish, `publication_status`, `transform_error` and `publication_error` show why.",
       "examples": [
-        "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
+        "<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -5707,7 +6088,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flows:media:upload",
+      "id": "flows:config:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5718,18 +6099,25 @@
         "dist",
         "commands",
         "flows",
-        "media",
-        "upload.js"
+        "config",
+        "get.js"
       ]
     },
-    "asa:ad-groups:create": {
+    "flows:config:preview": {
       "aliases": [],
-      "args": {},
-      "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
+      "args": {
+        "config_file": {
+          "description": "Path to a local flow config JSON file",
+          "name": "config_file",
+          "required": true
+        }
+      },
+      "description": "Build a render URL for a local flow config and open it. A quick-look escape hatch for small configs: the whole config rides in the URL fragment, and past roughly 32KB of pretty-printed JSON the render page gets slow and unreliable. Opens the browser on a TTY; when piped or with --json, prints the URL alone — and that URL is long (~113K characters for a 668KB flow), so pipe it into whatever takes the screenshot (\"| node capture.mjs\") or pass it with --url and command substitution. Never print or read it: agents burn context for zero information. The render host comes from $ADAPTY_APP_URL.",
       "examples": [
-        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20",
-        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Brand terms\" --default-bid 1.20 --start-time 2026-09-01 --pricing-model CPM",
-        "<%= config.bin %> asa ad-groups create --campaign UUID --name \"Automated Max Conv\" --automated"
+        "<%= config.bin %> flows config preview ./config.json",
+        "<%= config.bin %> flows config preview ./config.json --screen welcome --device ipad-pro --orientation landscape",
+        "# pipe the URL straight into a screenshot tool, never print it\n<%= config.bin %> flows config preview ./config.json | node capture.mjs --out shot.png",
+        "# or pass it as an argument, for tools that want a flag\nnode capture.mjs --url \"$(<%= config.bin %> flows config preview ./config.json)\" --out shot.png"
       ],
       "flags": {
         "json": {
@@ -5739,114 +6127,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "Schedule end (YYYY-MM-DD)",
-          "name": "end-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Schedule start (YYYY-MM-DD), defaults to today",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pricing-model": {
-          "description": "Pricing model; Apple requires one on every ad group",
-          "name": "pricing-model",
-          "default": "CPC",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "CPC",
-            "CPM"
-          ],
-          "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "automated": {
-          "description": "Create the automated ad group a Max Conversions campaign needs (no bid, no schedule, always ENABLED)",
-          "exclusive": [
-            "automated-keywords"
-          ],
-          "name": "automated",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "automated-keywords": {
-          "description": "Let Apple add keywords automatically",
-          "name": "automated-keywords",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "campaign": {
-          "description": "Campaign ID (UUID)",
-          "name": "campaign",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cpa-goal": {
-          "description": "CPA goal (amount, e.g. 50 or 12.50)",
-          "name": "cpa-goal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "default-bid": {
-          "description": "Default bid; required unless --automated is set (amount, e.g. 50 or 12.50)",
-          "name": "default-bid",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Ad group name",
-          "name": "name",
-          "required": true,
+        "device": {
+          "description": "Device frame to render in",
+          "name": "device",
+          "default": "iphone-14",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "status": {
-          "description": "Initial status",
-          "name": "status",
+        "orientation": {
+          "description": "Device orientation to render in",
+          "name": "orientation",
+          "default": "portrait",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "ENABLED",
-            "PAUSED"
+            "landscape",
+            "portrait"
           ],
           "type": "option"
+        },
+        "screen": {
+          "description": "Screen ID to render (default: the flow's first screen)",
+          "name": "screen",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:create",
+      "id": "flows:config:preview",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5856,23 +6167,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "ad-groups",
-        "create.js"
+        "flows",
+        "config",
+        "preview.js"
       ]
     },
-    "asa:ad-groups:get": {
+    "flows:config:update": {
       "aliases": [],
       "args": {
-        "ad_group_id": {
-          "description": "Ad group ID (UUID)",
-          "name": "ad_group_id",
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
           "required": true
         }
       },
-      "description": "Show one ad group; read numbers with asa metrics",
+      "description": "Write the flow builder config (creates the first version, or edits/forks the current one)",
       "examples": [
-        "<%= config.bin %> asa ad-groups get 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config-file config.json",
+        "cat config.json | <%= config.bin %> flows config update --app UUID FLOW_UUID --config-file -",
+        "<%= config.bin %> flows config update --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}' --expected-updated-at 1755001800000"
       ],
       "flags": {
         "json": {
@@ -5881,11 +6194,47 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "description": "Builder config as a JSON string",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config-file": {
+          "description": "JSON file with the builder config, or - to read stdin",
+          "name": "config-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "expected-updated-at": {
+          "description": "Optimistic lock: the `updated_at` from a prior config read. Omit for last-write-wins.",
+          "name": "expected-updated-at",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "remote-configs": {
+          "description": "JSON array of remote config entries: [{locale, data}]",
+          "name": "remote-configs",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:get",
+      "id": "flows:config:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5895,18 +6244,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "ad-groups",
-        "get.js"
+        "flows",
+        "config",
+        "update.js"
       ]
     },
-    "asa:ad-groups:list": {
+    "flows:config:validate": {
       "aliases": [],
-      "args": {},
-      "description": "List ad groups; read numbers with asa metrics",
+      "args": {
+        "flow_id": {
+          "description": "Flow ID (UUID)",
+          "name": "flow_id",
+          "required": true
+        }
+      },
+      "description": "Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.",
       "examples": [
-        "<%= config.bin %> asa ad-groups list",
-        "<%= config.bin %> asa ad-groups list --campaign CAMPAIGN_UUID"
+        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json",
+        "cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -",
+        "<%= config.bin %> flows config validate --app UUID FLOW_UUID --config '{\"screens\":[],\"locales\":[]}'"
       ],
       "flags": {
         "json": {
@@ -5916,65 +6272,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "app": {
-          "description": "Keep only rows in this app; repeatable",
+          "description": "App ID (UUID)",
           "name": "app",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "search": {
-          "description": "Case-insensitive substring match on the name",
-          "name": "search",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
+        "config": {
+          "description": "Builder config as a JSON string",
+          "name": "config",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "status": {
-          "description": "Keep only rows in this state",
-          "name": "status",
+        "config-file": {
+          "description": "JSON file with the builder config, or - to read stdin",
+          "name": "config-file",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:list",
+      "id": "flows:config:validate",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5984,24 +6307,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "ad-groups",
-        "list.js"
+        "flows",
+        "config",
+        "validate.js"
       ]
     },
-    "asa:ad-groups:update": {
+    "flows:media:upload": {
       "aliases": [],
       "args": {
-        "ad_group_id": {
-          "description": "Ad group ID (UUID)",
-          "name": "ad_group_id",
+        "file": {
+          "description": "Path to the image file to upload",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Change an ad group: bid, CPA goal, status or schedule",
+      "description": "Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config",
       "examples": [
-        "<%= config.bin %> asa ad-groups update UUID --default-bid 1.50",
-        "<%= config.bin %> asa ad-groups update UUID --status PAUSED"
+        "<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png"
       ],
       "flags": {
         "json": {
@@ -6011,84 +6333,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "Schedule end (YYYY-MM-DD)",
-          "name": "end-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Schedule start (YYYY-MM-DD), defaults to today",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Apply without asking; required when the output is piped or --json is used",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "idempotency-key": {
-          "description": "Idempotency key for this write; re-running with the same key replays the stored result instead of applying twice",
-          "name": "idempotency-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "automated-keywords": {
-          "description": "Let Apple add keywords automatically",
-          "name": "automated-keywords",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "cpa-goal": {
-          "description": "CPA goal (amount, e.g. 50 or 12.50)",
-          "name": "cpa-goal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "default-bid": {
-          "description": "Default bid (amount, e.g. 50 or 12.50)",
-          "name": "default-bid",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Ad group name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Ad group status",
-          "name": "status",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ad-groups:update",
+      "id": "flows:media:upload",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -6098,11 +6354,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "asa",
-        "ad-groups",
-        "update.js"
+        "flows",
+        "media",
+        "upload.js"
       ]
     }
   },
-  "version": "0.9.2"
+  "version": "0.9.4"
 }