adapty 0.8.9 → 0.9.0

package/oclif.manifest.json

@@ -270,7 +270,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -308,7 +307,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -357,7 +355,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -416,7 +413,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -425,6 +421,85 @@
         "update.js"
       ]
     },
+    "asa:connect": {
+      "aliases": [],
+      "args": {},
+      "description": "Connect an Apple Search Ads account to this company",
+      "examples": [
+        "<%= config.bin %> asa connect",
+        "<%= config.bin %> asa connect --no-wait"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for the browser step",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait until Apple Ads reports as connected",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:connect",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "connect.js"
+      ]
+    },
+    "asa:whoami": {
+      "aliases": [],
+      "args": {},
+      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
+      "examples": [
+        "<%= config.bin %> asa whoami"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:whoami",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "whoami.js"
+      ]
+    },
     "attribution:dimensions": {
       "aliases": [],
       "args": {},
@@ -721,7 +796,7 @@
     "auth:logout": {
       "aliases": [],
       "args": {},
-      "description": "Remove the stored session",
+      "description": "Remove stored credentials and the saved migration selection",
       "examples": [
         "<%= config.bin %> auth logout"
       ],
@@ -753,7 +828,7 @@
     "auth:revoke": {
       "aliases": [],
       "args": {},
-      "description": "Revoke the current token on the server and remove any matching stored session",
+      "description": "Revoke the current token and remove matching stored credentials and migration selection",
       "examples": [
         "<%= config.bin %> auth revoke"
       ],
@@ -837,7 +912,6 @@
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -846,85 +920,6 @@
         "whoami.js"
       ]
     },
-    "asa:connect": {
-      "aliases": [],
-      "args": {},
-      "description": "Connect an Apple Search Ads account to this company",
-      "examples": [
-        "<%= config.bin %> asa connect",
-        "<%= config.bin %> asa connect --no-wait"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for the browser step",
-          "name": "timeout",
-          "default": 300,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "description": "Wait until Apple Ads reports as connected",
-          "name": "wait",
-          "allowNo": true,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:connect",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "connect.js"
-      ]
-    },
-    "asa:whoami": {
-      "aliases": [],
-      "args": {},
-      "description": "Show which company the token unlocks, whether Apple Ads is connected, and the request budgets it gets\n\nLimits are raised per company, so read them here rather than assuming the defaults: metrics_limit_per_minute\nand metrics_burst_limit govern asa metrics, keywords_read_limit_per_minute the keyword lists,\nmetrics_inflight_limit how many analytics calls may overlap, and max_breakdown_rows_per_page the size a\ngrouped page may project to before it is refused.",
-      "examples": [
-        "<%= config.bin %> asa whoami"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:whoami",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "whoami.js"
-      ]
-    },
     "flows:create": {
       "aliases": [],
       "args": {},
@@ -1182,14 +1177,27 @@
         "update.js"
       ]
     },
-    "placements:create": {
+    "migrations:close": {
       "aliases": [],
       "args": {},
-      "description": "Create a placement with a paywall",
+      "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 %> 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": "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": {
@@ -1199,73 +1207,69 @@
           "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",
+        "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"
         },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
+        "outcome": {
+          "description": "finish: mark completed; cancel: abandon the migration",
+          "name": "outcome",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "finish",
+            "cancel"
+          ],
           "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",
+        "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": "placements: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",
-        "placements",
-        "create.js"
+        "migrations",
+        "close.js"
       ]
     },
-    "placements:get": {
+    "migrations:create": {
       "aliases": [],
-      "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
-          "required": true
-        }
-      },
-      "description": "Get placement 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 %> placements 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": {
@@ -1275,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": "placements: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",
-        "placements",
-        "get.js"
+        "migrations",
+        "create.js"
       ]
     },
-    "placements:list": {
+    "migrations:current": {
       "aliases": [],
       "args": {},
-      "description": "List placements 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 %> placements list --app 550e8400-..."
+        "<%= config.bin %> migrations current",
+        "<%= config.bin %> migrations current --json"
       ],
       "flags": {
         "json": {
@@ -1314,62 +1355,207 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "app": {
-          "description": "App ID (UUID)",
-          "name": "app",
-          "required": true,
+        }
+      },
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List migrations and the flows you can start",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "list.js"
+      ]
+    },
+    "migrations:run": {
+      "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.",
+      "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"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "input": {
+          "description": "Input action data as a JSON object matching input_schema",
+          "exclusive": [
+            "input-file"
+          ],
+          "name": "input",
           "hasDynamicHelp": false,
+          "helpValue": "JSON",
           "multiple": false,
           "type": "option"
         },
-        "page-size": {
-          "description": "Items per page (max 100)",
-          "name": "page-size",
-          "default": 20,
+        "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": "placements:list",
+      "id": "migrations:run",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "summary": "Run an input action or open an external action link",
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "placements",
-        "list.js"
+        "migrations",
+        "run.js"
       ]
     },
-    "placements:update": {
+    "migrations:show": {
       "aliases": [],
       "args": {
-        "placement_id": {
-          "description": "Placement ID (UUID)",
-          "name": "placement_id",
-          "required": true
+        "resource": {
+          "description": "Resource name; omit to list what can be read now",
+          "name": "resource"
         }
       },
-      "description": "Update a placement",
+      "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 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"
+        {
+          "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": {
@@ -1379,59 +1565,226 @@
           "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:show",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List migration resources or read one resource",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "show.js"
+      ]
+    },
+    "migrations:status": {
+      "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.",
+      "examples": [
+        {
+          "description": "Inspect the saved migration:",
+          "command": "<%= config.bin %> migrations status"
         },
-        "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"
+        {
+          "description": "See the current state and what to do next:",
+          "command": "<%= config.bin %> migrations status -m mig_7x2"
         },
-        "developer-id": {
-          "description": "Developer ID for the placement",
-          "name": "developer-id",
-          "required": true,
+        {
+          "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": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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"
         },
-        "paywall-id": {
-          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
-          "name": "paywall-id",
+        "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"
         },
-        "title": {
-          "description": "Placement title",
-          "name": "title",
-          "required": true,
+        "wait": {
+          "description": "Poll for a revision or state change, then return the latest response",
+          "name": "wait",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrations:status",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show migration state, issues, and available actions",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "status.js"
+      ]
+    },
+    "migrations:steps": {
+      "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.",
+      "examples": [
+        {
+          "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": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "placements:update",
+      "id": "migrations:steps",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Show the migration checklist and step statuses",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrations",
+        "steps.js"
+      ]
+    },
+    "migrations:unuse": {
+      "aliases": [],
+      "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 %> migrations unuse"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "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"
+      ]
+    },
+    "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": {
@@ -1700,18 +2053,90 @@
         "update.js"
       ]
     },
-    "segments:get": {
+    "placements:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a placement with a paywall",
+      "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"
+      ],
+      "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": "placements:create",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "placements",
+        "create.js"
+      ]
+    },
+    "placements:get": {
       "aliases": [],
       "args": {
-        "segment_id": {
-          "description": "Segment ID (UUID)",
-          "name": "segment_id",
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
           "required": true
         }
       },
-      "description": "Get segment details",
+      "description": "Get placement details",
       "examples": [
-        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> placements get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -1732,7 +2157,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:get",
+      "id": "placements:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1742,16 +2167,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "placements",
         "get.js"
       ]
     },
-    "segments:list": {
+    "placements:list": {
       "aliases": [],
       "args": {},
-      "description": "List segments for an app",
+      "description": "List placements for an app",
       "examples": [
-        "<%= config.bin %> segments list --app 550e8400-..."
+        "<%= config.bin %> placements list --app 550e8400-..."
       ],
       "flags": {
         "json": {
@@ -1788,7 +2213,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "segments:list",
+      "id": "placements:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -1798,10 +2223,88 @@
       "relativePath": [
         "dist",
         "commands",
-        "segments",
+        "placements",
         "list.js"
       ]
     },
+    "placements:update": {
+      "aliases": [],
+      "args": {
+        "placement_id": {
+          "description": "Placement ID (UUID)",
+          "name": "placement_id",
+          "required": true
+        }
+      },
+      "description": "Update a placement",
+      "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"
+      ],
+      "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": "placements:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "placements",
+        "update.js"
+      ]
+    },
     "products:create": {
       "aliases": [],
       "args": {},
@@ -2086,14 +2589,18 @@
         "update.js"
       ]
     },
-    "asa:ad-groups:create": {
+    "segments:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create an ad group inside a campaign; --automated creates the automated ad group a Max Conversions campaign needs to run",
+      "args": {
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
+          "required": true
+        }
+      },
+      "description": "Get segment details",
       "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 %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2103,36 +2610,184 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "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"
+      ]
+    },
+    "segments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List segments for an app",
+      "examples": [
+        "<%= config.bin %> segments list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "end-time": {
-          "description": "Schedule end (YYYY-MM-DD)",
-          "name": "end-time",
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "start-time": {
-          "description": "Schedule start (YYYY-MM-DD), defaults to today",
-          "name": "start-time",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "pricing-model": {
-          "description": "Pricing model; Apple requires one on every ad group",
-          "name": "pricing-model",
-          "default": "CPC",
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "CPC",
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "list.js"
+      ]
+    },
+    "asa:apps:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the apps promoted by this company in Apple Search Ads",
+      "examples": [
+        "<%= config.bin %> asa apps list",
+        "<%= config.bin %> asa apps list --page 2 --page-size 50"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:apps:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "apps",
+        "list.js"
+      ]
+    },
+    "asa:ad-groups:create": {
+      "aliases": [],
+      "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 %> 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": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "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"
@@ -2467,13 +3122,15 @@
         "update.js"
       ]
     },
-    "asa:apps:list": {
+    "asa:automations:create": {
       "aliases": [],
       "args": {},
-      "description": "List the apps promoted by this company in Apple Search Ads",
+      "description": "Create an automation rule from a JSON rule file. The add-as-keyword action flags fill in or override actions[0].params, so the bid, the match type and the target ad groups need no hand-written JSON.",
       "examples": [
-        "<%= config.bin %> asa apps list",
-        "<%= config.bin %> asa apps list --page 2 --page-size 50"
+        "<%= config.bin %> asa automations create --file rule.json",
+        "<%= config.bin %> asa automations create --file rule.json --run-now",
+        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt",
+        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type set_to --cpt-bid 1.50 --negate ad-group"
       ],
       "flags": {
         "json": {
@@ -2483,26 +3140,111 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "cpt-bid": {
+          "description": "cpt_bid.value: the bid itself with --cpt-bid-type set_to, or a percent markup on the entity bid with search_term_current_cpt / keyword_current_bid; not accepted with ad_group_default_bid",
+          "name": "cpt-bid",
           "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,
+        "cpt-bid-type": {
+          "description": "Where the bid of the created keyword comes from; the API has no default",
+          "name": "cpt-bid-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad_group_default_bid",
+            "keyword_current_bid",
+            "search_term_current_cpt",
+            "set_to"
+          ],
+          "type": "option"
+        },
+        "match-type": {
+          "description": "Match type of the created keyword; the API has no default",
+          "name": "match-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BROAD",
+            "EXACT"
+          ],
+          "type": "option"
+        },
+        "negate": {
+          "description": "Also add the search term as a negative keyword at this level (search-term rules)",
+          "exclusive": [
+            "no-negate"
+          ],
+          "name": "negate",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad-group",
+            "campaign"
+          ],
+          "type": "option"
+        },
+        "no-negate": {
+          "description": "Leave no negative keyword behind (search-term rules)",
+          "exclusive": [
+            "negate"
+          ],
+          "name": "no-negate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pause-original": {
+          "description": "Pause the source keyword in its own ad group (targeting-keyword rules)",
+          "name": "pause-original",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "skip-enable-duplicates": {
+          "description": "Skip a keyword that already exists in the target ad group instead of enabling it (search-term rules)",
+          "name": "skip-enable-duplicates",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "target-ad-group": {
+          "description": "Ad group the keyword is added to (UUID), repeatable; a rule without one does nothing",
+          "name": "target-ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "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"
+        },
+        "file": {
+          "description": "JSON file with the rule body, or - to read stdin",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "run-now": {
+          "description": "Queue the first run right after the rule is stored",
+          "name": "run-now",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:apps:list",
+      "id": "asa:automations:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2513,104 +3255,22 @@
         "dist",
         "commands",
         "asa",
-        "apps",
-        "list.js"
+        "automations",
+        "create.js"
       ]
     },
-    "asa:ads:create": {
+    "asa:automations:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create an ad from a creative in an ad group",
+      "args": {
+        "automation_id": {
+          "description": "Automation rule ID (UUID)",
+          "name": "automation_id",
+          "required": true
+        }
+      },
+      "description": "Show one automation rule with its conditions and actions",
       "examples": [
-        "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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"
-        },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "name": "ad-group",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "creative-id": {
-          "description": "Apple creative ID from a product page or the default set",
-          "name": "creative-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Ad 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": "asa:ads:create",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "ads",
-        "create.js"
-      ]
-    },
-    "asa:ads:get": {
-      "aliases": [],
-      "args": {
-        "ad_id": {
-          "description": "Ad ID (UUID)",
-          "name": "ad_id",
-          "required": true
-        }
-      },
-      "description": "Show one ad and its serving state",
-      "examples": [
-        "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -2623,7 +3283,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:get",
+      "id": "asa:automations:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2634,17 +3294,16 @@
         "dist",
         "commands",
         "asa",
-        "ads",
+        "automations",
         "get.js"
       ]
     },
-    "asa:ads:list": {
+    "asa:automations:list": {
       "aliases": [],
       "args": {},
-      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
+      "description": "List automation rules; status 1 is active, 0 is stopped",
       "examples": [
-        "<%= config.bin %> asa ads list",
-        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
+        "<%= config.bin %> asa automations list"
       ],
       "flags": {
         "json": {
@@ -2669,50 +3328,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
-          "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"
-        },
-        "status": {
-          "description": "Keep only rows in this state",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:list",
+      "id": "asa:automations:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2723,22 +3343,23 @@
         "dist",
         "commands",
         "asa",
-        "ads",
+        "automations",
         "list.js"
       ]
     },
-    "asa:ads:update": {
+    "asa:automations:run": {
       "aliases": [],
       "args": {
-        "ad_id": {
-          "description": "Ad ID (UUID)",
-          "name": "ad_id",
+        "automation_id": {
+          "description": "Automation rule ID (UUID)",
+          "name": "automation_id",
           "required": true
         }
       },
-      "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
+      "description": "Run an automation rule now; the run is queued, not awaited",
       "examples": [
-        "<%= config.bin %> asa ads update UUID --status PAUSED"
+        "<%= config.bin %> asa automations run UUID",
+        "<%= config.bin %> asa automations run UUID --dry-run"
       ],
       "flags": {
         "json": {
@@ -2762,28 +3383,71 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Ad name",
-          "name": "name",
+        "dry-run": {
+          "description": "Evaluate and log the rule without touching Apple",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:automations:run",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "automations",
+        "run.js"
+      ]
+    },
+    "asa:automations:runs": {
+      "aliases": [],
+      "args": {
+        "automation_id": {
+          "description": "Automation rule ID (UUID)",
+          "name": "automation_id",
+          "required": true
+        }
+      },
+      "description": "List past runs of an automation rule, including dry runs",
+      "examples": [
+        "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
+      ],
+      "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"
         },
-        "status": {
-          "description": "Ad status",
-          "name": "status",
+        "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,
-          "options": [
-            "ENABLED",
-            "PAUSED"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:ads:update",
+      "id": "asa:automations:runs",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2794,19 +3458,24 @@
         "dist",
         "commands",
         "asa",
-        "ads",
-        "update.js"
+        "automations",
+        "runs.js"
       ]
     },
-    "asa:automations:create": {
+    "asa:automations:update": {
       "aliases": [],
-      "args": {},
-      "description": "Create an automation rule from a JSON rule file. The add-as-keyword action flags fill in or override actions[0].params, so the bid, the match type and the target ad groups need no hand-written JSON.",
+      "args": {
+        "automation_id": {
+          "description": "Automation rule ID (UUID)",
+          "name": "automation_id",
+          "required": true
+        }
+      },
+      "description": "Change an automation rule: stop it, rename it, or replace parts of the rule. An add-as-keyword action flag turns the call into a read-modify-write: the rule is read, actions[0].params is rebuilt from the flags and the whole actions list is written back — an edit someone makes in the dashboard in between is overwritten. This is also the way to repair a rule whose stored params carry the wrong shape.",
       "examples": [
-        "<%= config.bin %> asa automations create --file rule.json",
-        "<%= config.bin %> asa automations create --file rule.json --run-now",
-        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt",
-        "<%= config.bin %> asa automations create --file rule.json --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type set_to --cpt-bid 1.50 --negate ad-group"
+        "<%= config.bin %> asa automations update UUID --stop",
+        "<%= config.bin %> asa automations update UUID --file rule.json",
+        "<%= config.bin %> asa automations update UUID --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt"
       ],
       "flags": {
         "json": {
@@ -2904,62 +3573,41 @@
           "type": "option"
         },
         "file": {
-          "description": "JSON file with the rule body, or - to read stdin",
+          "description": "JSON file with the parts to change, or - to read stdin",
           "name": "file",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "run-now": {
-          "description": "Queue the first run right after the rule is stored",
-          "name": "run-now",
+        "name": {
+          "description": "Rule name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start": {
+          "description": "Activate the rule",
+          "exclusive": [
+            "stop"
+          ],
+          "name": "start",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:automations:create",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "automations",
-        "create.js"
-      ]
-    },
-    "asa:automations:get": {
-      "aliases": [],
-      "args": {
-        "automation_id": {
-          "description": "Automation rule ID (UUID)",
-          "name": "automation_id",
-          "required": true
-        }
-      },
-      "description": "Show one automation rule with its conditions and actions",
-      "examples": [
-        "<%= config.bin %> asa automations get 550e8400-e29b-41d4-a716-446655440000"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        },
+        "stop": {
+          "description": "Stop the rule and clear its next run",
+          "exclusive": [
+            "start"
+          ],
+          "name": "stop",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:automations:get",
+      "id": "asa:automations:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -2971,15 +3619,15 @@
         "commands",
         "asa",
         "automations",
-        "get.js"
+        "update.js"
       ]
     },
-    "asa:automations:list": {
+    "asa:ads:create": {
       "aliases": [],
       "args": {},
-      "description": "List automation rules; status 1 is active, 0 is stopped",
+      "description": "Create an ad from a creative in an ad group",
       "examples": [
-        "<%= config.bin %> asa automations list"
+        "<%= config.bin %> asa ads create --ad-group UUID --creative-id 4321 --name \"Summer ad\""
       ],
       "flags": {
         "json": {
@@ -2989,26 +3637,59 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "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"
         },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
+        "ad-group": {
+          "description": "Ad group ID (UUID) — the campaign is resolved from it",
+          "name": "ad-group",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "creative-id": {
+          "description": "Apple creative ID from a product page or the default set",
+          "name": "creative-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Ad 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": "asa:automations:list",
+      "id": "asa:ads:create",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3019,23 +3700,22 @@
         "dist",
         "commands",
         "asa",
-        "automations",
-        "list.js"
+        "ads",
+        "create.js"
       ]
     },
-    "asa:automations:run": {
+    "asa:ads:get": {
       "aliases": [],
       "args": {
-        "automation_id": {
-          "description": "Automation rule ID (UUID)",
-          "name": "automation_id",
+        "ad_id": {
+          "description": "Ad ID (UUID)",
+          "name": "ad_id",
           "required": true
         }
       },
-      "description": "Run an automation rule now; the run is queued, not awaited",
+      "description": "Show one ad and its serving state",
       "examples": [
-        "<%= config.bin %> asa automations run UUID",
-        "<%= config.bin %> asa automations run UUID --dry-run"
+        "<%= config.bin %> asa ads get 550e8400-e29b-41d4-a716-446655440000"
       ],
       "flags": {
         "json": {
@@ -3044,31 +3724,11 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "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"
-        },
-        "dry-run": {
-          "description": "Evaluate and log the rule without touching Apple",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:automations:run",
+      "id": "asa:ads:get",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3079,22 +3739,17 @@
         "dist",
         "commands",
         "asa",
-        "automations",
-        "run.js"
+        "ads",
+        "get.js"
       ]
     },
-    "asa:automations:runs": {
+    "asa:ads:list": {
       "aliases": [],
-      "args": {
-        "automation_id": {
-          "description": "Automation rule ID (UUID)",
-          "name": "automation_id",
-          "required": true
-        }
-      },
-      "description": "List past runs of an automation rule, including dry runs",
+      "args": {},
+      "description": "List ads; serving_state_reasons explains why an enabled ad is not running",
       "examples": [
-        "<%= config.bin %> asa automations runs 550e8400-e29b-41d4-a716-446655440000"
+        "<%= config.bin %> asa ads list",
+        "<%= config.bin %> asa ads list --ad-group AD_GROUP_UUID --status ENABLED"
       ],
       "flags": {
         "json": {
@@ -3119,11 +3774,50 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
+          "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"
+        },
+        "status": {
+          "description": "Keep only rows in this state",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ENABLED",
+            "PAUSED"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:automations:runs",
+      "id": "asa:ads:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3134,24 +3828,22 @@
         "dist",
         "commands",
         "asa",
-        "automations",
-        "runs.js"
+        "ads",
+        "list.js"
       ]
     },
-    "asa:automations:update": {
+    "asa:ads:update": {
       "aliases": [],
       "args": {
-        "automation_id": {
-          "description": "Automation rule ID (UUID)",
-          "name": "automation_id",
+        "ad_id": {
+          "description": "Ad ID (UUID)",
+          "name": "ad_id",
           "required": true
         }
       },
-      "description": "Change an automation rule: stop it, rename it, or replace parts of the rule. An add-as-keyword action flag turns the call into a read-modify-write: the rule is read, actions[0].params is rebuilt from the flags and the whole actions list is written back — an edit someone makes in the dashboard in between is overwritten. This is also the way to repair a rule whose stored params carry the wrong shape.",
+      "description": "Rename an ad or pause it; the creative and ad group are fixed at creation",
       "examples": [
-        "<%= config.bin %> asa automations update UUID --stop",
-        "<%= config.bin %> asa automations update UUID --file rule.json",
-        "<%= config.bin %> asa automations update UUID --target-ad-group AD_GROUP_ID --match-type EXACT --cpt-bid-type search_term_current_cpt"
+        "<%= config.bin %> asa ads update UUID --status PAUSED"
       ],
       "flags": {
         "json": {
@@ -3161,129 +3853,42 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "cpt-bid": {
-          "description": "cpt_bid.value: the bid itself with --cpt-bid-type set_to, or a percent markup on the entity bid with search_term_current_cpt / keyword_current_bid; not accepted with ad_group_default_bid",
-          "name": "cpt-bid",
+        "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"
         },
-        "cpt-bid-type": {
-          "description": "Where the bid of the created keyword comes from; the API has no default",
-          "name": "cpt-bid-type",
+        "name": {
+          "description": "Ad name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ad_group_default_bid",
-            "keyword_current_bid",
-            "search_term_current_cpt",
-            "set_to"
-          ],
           "type": "option"
         },
-        "match-type": {
-          "description": "Match type of the created keyword; the API has no default",
-          "name": "match-type",
+        "status": {
+          "description": "Ad status",
+          "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "BROAD",
-            "EXACT"
+            "ENABLED",
+            "PAUSED"
           ],
           "type": "option"
-        },
-        "negate": {
-          "description": "Also add the search term as a negative keyword at this level (search-term rules)",
-          "exclusive": [
-            "no-negate"
-          ],
-          "name": "negate",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ad-group",
-            "campaign"
-          ],
-          "type": "option"
-        },
-        "no-negate": {
-          "description": "Leave no negative keyword behind (search-term rules)",
-          "exclusive": [
-            "negate"
-          ],
-          "name": "no-negate",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pause-original": {
-          "description": "Pause the source keyword in its own ad group (targeting-keyword rules)",
-          "name": "pause-original",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "skip-enable-duplicates": {
-          "description": "Skip a keyword that already exists in the target ad group instead of enabling it (search-term rules)",
-          "name": "skip-enable-duplicates",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "target-ad-group": {
-          "description": "Ad group the keyword is added to (UUID), repeatable; a rule without one does nothing",
-          "name": "target-ad-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "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"
-        },
-        "file": {
-          "description": "JSON file with the parts to change, or - to read stdin",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Rule name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start": {
-          "description": "Activate the rule",
-          "exclusive": [
-            "stop"
-          ],
-          "name": "start",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "stop": {
-          "description": "Stop the rule and clear its next run",
-          "exclusive": [
-            "start"
-          ],
-          "name": "stop",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:automations:update",
+      "id": "asa:ads:update",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -3294,115 +3899,10 @@
         "dist",
         "commands",
         "asa",
-        "automations",
+        "ads",
         "update.js"
       ]
     },
-    "asa:competitors:summary": {
-      "aliases": [],
-      "args": {},
-      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
-      "examples": [
-        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-ids": {
-          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
-          "name": "app-ids",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:competitors:summary",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "competitors",
-        "summary.js"
-      ]
-    },
-    "asa:creatives:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List creatives; creative_id is what `asa ads create` needs",
-      "examples": [
-        "<%= config.bin %> asa creatives list",
-        "<%= config.bin %> asa creatives list --app APP_UUID"
-      ],
-      "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"
-        },
-        "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:creatives:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "creatives",
-        "list.js"
-      ]
-    },
     "asa:campaigns:bulk-create": {
       "aliases": [],
       "args": {},
@@ -4107,13 +4607,12 @@
         "update.js"
       ]
     },
-    "asa:keywords:add": {
+    "asa:competitors:summary": {
       "aliases": [],
       "args": {},
-      "description": "Add targeting keywords to an ad group",
+      "description": "Competitor summary for up to five App Store apps; the server covers the last full month and every country",
       "examples": [
-        "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
-        "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
+        "<%= config.bin %> asa competitors summary --app-ids 1668337467,6503873027"
       ],
       "flags": {
         "json": {
@@ -4123,77 +4622,74 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "currency": {
-          "description": "Currency code for the amounts in this call",
-          "name": "currency",
-          "default": "USD",
+        "app-ids": {
+          "description": "Apple App Store IDs (adam_id), comma-separated, 1-5 values",
+          "name": "app-ids",
+          "required": true,
           "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",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:competitors:summary",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "competitors",
+        "summary.js"
+      ]
+    },
+    "asa:creatives:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List creatives; creative_id is what `asa ads create` needs",
+      "examples": [
+        "<%= config.bin %> asa creatives list",
+        "<%= config.bin %> asa creatives list --app APP_UUID"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "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",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "name": "ad-group",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "bid": {
-          "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
-          "name": "bid",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "from-file": {
-          "description": "File with one keyword per line, combined with any --text values",
-          "name": "from-file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "match-type": {
-          "description": "Match type",
-          "name": "match-type",
-          "default": "BROAD",
+        "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,
-          "options": [
-            "BROAD",
-            "EXACT"
-          ],
           "type": "option"
         },
-        "status": {
-          "description": "Keyword status",
-          "name": "status",
-          "default": "ACTIVE",
+        "app": {
+          "description": "Keep only rows in this app; repeatable",
+          "name": "app",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "ACTIVE",
-            "PAUSED"
-          ],
+          "multiple": true,
           "type": "option"
         },
-        "text": {
-          "description": "Keyword text, repeatable",
-          "name": "text",
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -4201,7 +4697,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:add",
+      "id": "asa:creatives:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4212,17 +4708,21 @@
         "dist",
         "commands",
         "asa",
-        "keywords",
-        "add.js"
+        "creatives",
+        "list.js"
       ]
     },
-    "asa:keywords:list": {
+    "asa:metrics": {
       "aliases": [],
       "args": {},
-      "description": "List targeting keywords; read numbers with asa metrics",
+      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at a breakdown-row\ncount (entities × countries × periods); over it the call fails with 422 cli_response_too_large naming the\npage[size] that fits — coarsen the grouping, narrow the window, or reduce page[size].\n\nMoney columns are in the campaign group currency, not USD, and spend and local_spend carry the same\nfigure; the currency itself comes from asa orgs list. Rate budgets and the breakdown-row cap are set per\ncompany: read the current ones with asa whoami rather than assuming a default. meta.pagination.count is\nthe full entity count behind the filters, so take inventory from there instead of counting the rows on a\npage. meta.max_valid_day says how many days the youngest cohort in the window has lived — any --by-days\nwindow above it repeats the last real figure because that time has not passed yet, so treat those as\nunreached rather than as a plateau.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
       "examples": [
-        "<%= config.bin %> asa keywords list",
-        "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --group-by country --page-size 1000",
+        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
+        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90",
+        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric arpas --campaign 0f0e..."
       ],
       "flags": {
         "json": {
@@ -4248,6 +4748,20 @@
           "multiple": false,
           "type": "option"
         },
+        "by-days": {
+          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
+          "name": "by-days",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "app": {
           "description": "Keep only rows in this app; repeatable",
           "name": "app",
@@ -4255,49 +4769,96 @@
           "multiple": true,
           "type": "option"
         },
-        "campaign-group": {
-          "description": "Keep only rows in this campaign group; repeatable",
-          "name": "campaign-group",
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "search": {
-          "description": "Case-insensitive substring match on the name",
-          "name": "search",
+        "date-from": {
+          "description": "Start of the period (YYYY-MM-DD)",
+          "name": "date-from",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
+        "date-to": {
+          "description": "End of the period (YYYY-MM-DD)",
+          "name": "date-to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "entity": {
+          "description": "What to report on",
+          "name": "entity",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ad",
+            "ad-group",
+            "campaign",
+            "keyword"
+          ],
+          "type": "option"
+        },
+        "group-by": {
+          "description": "Break the rows down by a dimension, repeatable",
+          "name": "group-by",
           "hasDynamicHelp": false,
           "multiple": true,
+          "options": [
+            "country",
+            "day",
+            "month",
+            "quarter",
+            "week",
+            "year"
+          ],
           "type": "option"
         },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
+        "metric": {
+          "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable and required; every metric asked for is computed over the whole entity set, so list only what you read; a wrong name fails listing all valid ones",
+          "name": "metric",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "status": {
-          "description": "Keep only rows in this state",
-          "name": "status",
+        "order": {
+          "description": "Sort direction",
+          "name": "order",
+          "default": "desc",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "ACTIVE",
-            "PAUSED"
+            "asc",
+            "desc"
           ],
           "type": "option"
+        },
+        "order-by": {
+          "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
+          "name": "order-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "order-by-day": {
+          "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
+          "name": "order-by-day",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:list",
+      "id": "asa:metrics",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4308,18 +4869,17 @@
         "dist",
         "commands",
         "asa",
-        "keywords",
-        "list.js"
+        "metrics",
+        "index.js"
       ]
     },
-    "asa:keywords:recommend": {
+    "asa:metrics:overview": {
       "aliases": [],
       "args": {},
-      "description": "Keyword recommendations for one of your apps: its brand terms, generic terms, or the brand terms of its selected competitors",
+      "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
       "examples": [
-        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type brand",
-        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type generic --country US",
-        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type competitor"
+        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
+        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
       ],
       "flags": {
         "json": {
@@ -4329,38 +4889,69 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "adam-id": {
-          "description": "Apple App Store ID (adam_id) of your app, from `asa apps list`",
-          "name": "adam-id",
+        "by-days": {
+          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
+          "name": "by-days",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "date-from": {
+          "description": "Start of the period (YYYY-MM-DD)",
+          "name": "date-from",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "country": {
-          "description": "ISO country code (e.g. US); repeatable, default every country in the pool",
-          "name": "country",
+        "date-to": {
+          "description": "End of the period (YYYY-MM-DD)",
+          "name": "date-to",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "Which pool to read",
-          "name": "type",
+        "entity": {
+          "description": "What to report on",
+          "name": "entity",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "brand",
-            "generic",
-            "competitor"
+            "ad",
+            "ad-group",
+            "campaign",
+            "keyword"
+          ],
+          "type": "option"
+        },
+        "metric": {
+          "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
+          "name": "metric",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "period-unit": {
+          "description": "Bucket size",
+          "name": "period-unit",
+          "default": "day",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "day",
+            "month",
+            "quarter",
+            "week",
+            "year"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:recommend",
+      "id": "asa:metrics:overview",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4371,23 +4962,17 @@
         "dist",
         "commands",
         "asa",
-        "keywords",
-        "recommend.js"
+        "metrics",
+        "overview.js"
       ]
     },
-    "asa:keywords:update": {
+    "asa:keywords:add": {
       "aliases": [],
-      "args": {
-        "keyword_id": {
-          "description": "Keyword ID (UUID), repeatable as extra arguments",
-          "name": "keyword_id",
-          "required": true
-        }
-      },
-      "description": "Change bid, status, text or match type of keywords",
+      "args": {},
+      "description": "Add targeting keywords to an ad group",
       "examples": [
-        "<%= config.bin %> asa keywords update UUID --bid 2.00",
-        "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
+        "<%= config.bin %> asa keywords add --ad-group UUID --text \"running shoes\" --text \"trail shoes\" --bid 1.20",
+        "<%= config.bin %> asa keywords add --ad-group UUID --from-file keywords.txt --match-type EXACT"
       ],
       "flags": {
         "json": {
@@ -4419,16 +5004,32 @@
           "multiple": false,
           "type": "option"
         },
+        "ad-group": {
+          "description": "Ad group ID (UUID) — the campaign is resolved from it",
+          "name": "ad-group",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "bid": {
-          "description": "Bid (amount, e.g. 50 or 12.50)",
+          "description": "Bid per keyword (amount, e.g. 50 or 12.50)",
           "name": "bid",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "from-file": {
+          "description": "File with one keyword per line, combined with any --text values",
+          "name": "from-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "match-type": {
           "description": "Match type",
           "name": "match-type",
+          "default": "BROAD",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -4440,6 +5041,7 @@
         "status": {
           "description": "Keyword status",
           "name": "status",
+          "default": "ACTIVE",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -4449,20 +5051,20 @@
           "type": "option"
         },
         "text": {
-          "description": "Keyword text (only meaningful for a single keyword)",
+          "description": "Keyword text, repeatable",
           "name": "text",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:keywords:update",
+      "id": "asa:keywords:add",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -4470,20 +5072,16 @@
         "commands",
         "asa",
         "keywords",
-        "update.js"
+        "add.js"
       ]
     },
-    "asa:metrics": {
+    "asa:keywords:list": {
       "aliases": [],
       "args": {},
-      "description": "Query metrics for any level of the account over a date range\n\nOne row per entity, already aggregated server-side and sorted by --order-by, so a top-N question is one\ncall with --order-by and --page-size N — never sum pages yourself. Account-level totals are one call to\nasa metrics overview instead. The date window is capped by the finest --group-by period: 28 days when\nday is grouped, 90 with no period grouping, 180 by week, 365 by month and coarser — widen the window by\ncoarsening the grouping, not by splitting into more calls. Each page is also capped at a breakdown-row\ncount (entities × countries × periods); over it the call fails with 422 cli_response_too_large naming the\npage[size] that fits — coarsen the grouping, narrow the window, or reduce page[size].\n\nMoney columns are in the campaign group currency, not USD, and spend and local_spend carry the same\nfigure; the currency itself comes from asa orgs list. Rate budgets and the breakdown-row cap are set per\ncompany: read the current ones with asa whoami rather than assuming a default. meta.pagination.count is\nthe full entity count behind the filters, so take inventory from there instead of counting the rows on a\npage. meta.max_valid_day says how many days the youngest cohort in the window has lived — any --by-days\nwindow above it repeats the last real figure because that time has not passed yet, so treat those as\nunreached rather than as a plateau.\n\n--metric is required and every metric named is computed over the whole entity set, so ask for the\ncolumns you actually read. subscribers and paid_subscribers (and arppu / arpas, which derive from them)\ncount unique profiles per entity and cost roughly seventeen times the rest; whatever the --entity, they\nare refused unless --campaign or --ad-group scopes the call. Those scope flags are also the cheapest way\nto make any call fast, since cost follows the number of entities aggregated, not the page size.",
+      "description": "List targeting keywords; read numbers with asa metrics",
       "examples": [
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric adapty_installs",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --order-by spend --page-size 5",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --group-by country --page-size 1000",
-        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric spend --metric roas",
-        "<%= config.bin %> asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90",
-        "<%= config.bin %> asa metrics --entity keyword --date-from 2026-07-01 --date-to 2026-07-31 --metric arpas --campaign 0f0e..."
+        "<%= config.bin %> asa keywords list",
+        "<%= config.bin %> asa keywords list --ad-group AD_GROUP_UUID --status ACTIVE"
       ],
       "flags": {
         "json": {
@@ -4509,20 +5107,6 @@
           "multiple": false,
           "type": "option"
         },
-        "by-days": {
-          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
-          "name": "by-days",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "ad-group": {
-          "description": "Keep only rows in this ad group; repeatable",
-          "name": "ad-group",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
         "app": {
           "description": "Keep only rows in this app; repeatable",
           "name": "app",
@@ -4530,96 +5114,49 @@
           "multiple": true,
           "type": "option"
         },
-        "campaign": {
-          "description": "Keep only rows in this campaign; repeatable",
-          "name": "campaign",
+        "campaign-group": {
+          "description": "Keep only rows in this campaign group; repeatable",
+          "name": "campaign-group",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "date-from": {
-          "description": "Start of the period (YYYY-MM-DD)",
-          "name": "date-from",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "date-to": {
-          "description": "End of the period (YYYY-MM-DD)",
-          "name": "date-to",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "entity": {
-          "description": "What to report on",
-          "name": "entity",
-          "required": true,
+        "search": {
+          "description": "Case-insensitive substring match on the name",
+          "name": "search",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ad",
-            "ad-group",
-            "campaign",
-            "keyword"
-          ],
           "type": "option"
         },
-        "group-by": {
-          "description": "Break the rows down by a dimension, repeatable",
-          "name": "group-by",
+        "campaign": {
+          "description": "Keep only rows in this campaign; repeatable",
+          "name": "campaign",
           "hasDynamicHelp": false,
           "multiple": true,
-          "options": [
-            "country",
-            "day",
-            "month",
-            "quarter",
-            "week",
-            "year"
-          ],
           "type": "option"
         },
-        "metric": {
-          "description": "Metric name (dashboard nomenclature, e.g. spend, taps, gross_roas), repeatable and required; every metric asked for is computed over the whole entity set, so list only what you read; a wrong name fails listing all valid ones",
-          "name": "metric",
-          "required": true,
+        "ad-group": {
+          "description": "Keep only rows in this ad group; repeatable",
+          "name": "ad-group",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "order": {
-          "description": "Sort direction",
-          "name": "order",
-          "default": "desc",
+        "status": {
+          "description": "Keep only rows in this state",
+          "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "asc",
-            "desc"
+            "ACTIVE",
+            "PAUSED"
           ],
           "type": "option"
-        },
-        "order-by": {
-          "description": "Metric or field to sort by; cohort metrics rank via their gross_/proceeds_/net_ names",
-          "name": "order-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "order-by-day": {
-          "description": "Rank by a cohort metric at this renewal window; must be one of the --by-days values",
-          "name": "order-by-day",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:metrics",
+      "id": "asa:keywords:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4630,17 +5167,18 @@
         "dist",
         "commands",
         "asa",
-        "metrics",
-        "index.js"
+        "keywords",
+        "list.js"
       ]
     },
-    "asa:metrics:overview": {
+    "asa:keywords:recommend": {
       "aliases": [],
       "args": {},
-      "description": "Totals for a period, optionally split into day, week or month buckets\n\nThe one-call answer to \"how much did I spend / earn overall\" and to any single-period trend question:\ntotals for the whole entity level plus a per-period series, no pagination, no client-side summing. The\ndate window is capped by --period-unit: 90 days at day, 180 by week, 365 by month and coarser. Shares\nthe 5-per-minute metrics budget with asa metrics.",
+      "description": "Keyword recommendations for one of your apps: its brand terms, generic terms, or the brand terms of its selected competitors",
       "examples": [
-        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31",
-        "<%= config.bin %> asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit WEEK"
+        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type brand",
+        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type generic --country US",
+        "<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type competitor"
       ],
       "flags": {
         "json": {
@@ -4650,69 +5188,38 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "by-days": {
-          "description": "Renewal window in days for cohort metrics, repeatable; omit for the dashboard defaults",
-          "name": "by-days",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "date-from": {
-          "description": "Start of the period (YYYY-MM-DD)",
-          "name": "date-from",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "date-to": {
-          "description": "End of the period (YYYY-MM-DD)",
-          "name": "date-to",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "entity": {
-          "description": "What to report on",
-          "name": "entity",
+        "adam-id": {
+          "description": "Apple App Store ID (adam_id) of your app, from `asa apps list`",
+          "name": "adam-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "ad",
-            "ad-group",
-            "campaign",
-            "keyword"
-          ],
           "type": "option"
         },
-        "metric": {
-          "description": "Metric name, repeatable; cohort roots only here (revenue, roas, arpu), not their gross_/proceeds_/net_ variants; omit for every metric",
-          "name": "metric",
+        "country": {
+          "description": "ISO country code (e.g. US); repeatable, default every country in the pool",
+          "name": "country",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
         },
-        "period-unit": {
-          "description": "Bucket size",
-          "name": "period-unit",
-          "default": "day",
+        "type": {
+          "description": "Which pool to read",
+          "name": "type",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "day",
-            "month",
-            "quarter",
-            "week",
-            "year"
+            "brand",
+            "generic",
+            "competitor"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:metrics:overview",
+      "id": "asa:keywords:recommend",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4723,18 +5230,23 @@
         "dist",
         "commands",
         "asa",
-        "metrics",
-        "overview.js"
+        "keywords",
+        "recommend.js"
       ]
     },
-    "asa:negative-keywords:add": {
+    "asa:keywords:update": {
       "aliases": [],
-      "args": {},
-      "description": "Add negative keywords to an ad group or across a campaign",
+      "args": {
+        "keyword_id": {
+          "description": "Keyword ID (UUID), repeatable as extra arguments",
+          "name": "keyword_id",
+          "required": true
+        }
+      },
+      "description": "Change bid, status, text or match type of keywords",
       "examples": [
-        "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
-        "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
-        "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
+        "<%= config.bin %> asa keywords update UUID --bid 2.00",
+        "<%= config.bin %> asa keywords update UUID_A UUID_B --status PAUSED"
       ],
       "flags": {
         "json": {
@@ -4744,6 +5256,14 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "currency": {
+          "description": "Currency code for the amounts in this call",
+          "name": "currency",
+          "default": "USD",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "Apply without asking; required when the output is piped or --json is used",
@@ -4758,71 +5278,95 @@
           "multiple": false,
           "type": "option"
         },
-        "ad-group": {
-          "description": "Ad group ID (UUID) — the campaign is resolved from it",
-          "exclusive": [
-            "campaign"
-          ],
-          "name": "ad-group",
+        "bid": {
+          "description": "Bid (amount, e.g. 50 or 12.50)",
+          "name": "bid",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "all-ad-groups": {
-          "dependsOn": [
-            "campaign"
+        "match-type": {
+          "description": "Match type",
+          "name": "match-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BROAD",
+            "EXACT"
           ],
-          "description": "Apply to every ad group of the campaign instead of the campaign itself",
-          "name": "all-ad-groups",
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         },
-        "campaign": {
-          "description": "Campaign ID (UUID)",
-          "exclusive": [
-            "ad-group"
+        "status": {
+          "description": "Keyword status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ACTIVE",
+            "PAUSED"
           ],
-          "name": "campaign",
+          "type": "option"
+        },
+        "text": {
+          "description": "Keyword text (only meaningful for a single keyword)",
+          "name": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:keywords:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "keywords",
+        "update.js"
+      ]
+    },
+    "asa:orgs:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the Apple Search Ads organizations this company can spend from",
+      "examples": [
+        "<%= config.bin %> asa orgs list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "match-type": {
-          "description": "Match type",
-          "name": "match-type",
-          "default": "EXACT",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "BROAD",
-            "EXACT"
-          ],
           "type": "option"
         },
-        "status": {
-          "description": "Keyword status",
-          "name": "status",
-          "default": "ACTIVE",
+        "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,
-          "options": [
-            "ACTIVE",
-            "PAUSED"
-          ],
-          "type": "option"
-        },
-        "text": {
-          "description": "Keyword text, repeatable",
-          "name": "text",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:negative-keywords:add",
+      "id": "asa:orgs:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4833,17 +5377,17 @@
         "dist",
         "commands",
         "asa",
-        "negative-keywords",
-        "add.js"
+        "orgs",
+        "list.js"
       ]
     },
-    "asa:negative-keywords:list": {
+    "asa:search-terms:list": {
       "aliases": [],
       "args": {},
-      "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
+      "description": "List the search terms your ads matched, with their metrics",
       "examples": [
-        "<%= config.bin %> asa negative-keywords list",
-        "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
+        "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
+        "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
       ],
       "flags": {
         "json": {
@@ -4869,6 +5413,20 @@
           "multiple": false,
           "type": "option"
         },
+        "date-from": {
+          "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
+          "name": "date-from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "date-to": {
+          "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
+          "name": "date-to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "app": {
           "description": "Keep only rows in this app; repeatable",
           "name": "app",
@@ -4903,17 +5461,11 @@
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
-        },
-        "campaign-level-only": {
-          "description": "Keep only campaign-level rows (ad_group_id is null)",
-          "name": "campaign-level-only",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:negative-keywords:list",
+      "id": "asa:search-terms:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4924,16 +5476,17 @@
         "dist",
         "commands",
         "asa",
-        "negative-keywords",
+        "search-terms",
         "list.js"
       ]
     },
-    "asa:orgs:list": {
+    "asa:product-pages:list": {
       "aliases": [],
       "args": {},
-      "description": "List the Apple Search Ads organizations this company can spend from",
+      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
       "examples": [
-        "<%= config.bin %> asa orgs list"
+        "<%= config.bin %> asa product-pages list",
+        "<%= config.bin %> asa product-pages list --app APP_UUID"
       ],
       "flags": {
         "json": {
@@ -4958,11 +5511,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:orgs:list",
+      "id": "asa:product-pages:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -4973,17 +5540,17 @@
         "dist",
         "commands",
         "asa",
-        "orgs",
+        "product-pages",
         "list.js"
       ]
     },
-    "asa:product-pages:list": {
+    "asa:product-pages:sync": {
       "aliases": [],
       "args": {},
-      "description": "List custom product pages (read-only; authoring stays in App Store Connect)",
+      "description": "Refresh custom product pages from Apple",
       "examples": [
-        "<%= config.bin %> asa product-pages list",
-        "<%= config.bin %> asa product-pages list --app APP_UUID"
+        "<%= config.bin %> asa product-pages sync",
+        "<%= config.bin %> asa product-pages sync --adam-id 123456"
       ],
       "flags": {
         "json": {
@@ -4993,40 +5560,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "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"
         },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
+        "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"
         },
-        "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",
+        "adam-id": {
+          "description": "Limit the refresh to one app; omit to cover every app",
+          "name": "adam-id",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:product-pages:list",
+      "id": "asa:product-pages:sync",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5038,16 +5596,17 @@
         "commands",
         "asa",
         "product-pages",
-        "list.js"
+        "sync.js"
       ]
     },
-    "asa:product-pages:sync": {
+    "asa:negative-keywords:add": {
       "aliases": [],
       "args": {},
-      "description": "Refresh custom product pages from Apple",
+      "description": "Add negative keywords to an ad group or across a campaign",
       "examples": [
-        "<%= config.bin %> asa product-pages sync",
-        "<%= config.bin %> asa product-pages sync --adam-id 123456"
+        "<%= config.bin %> asa negative-keywords add --ad-group UUID --text \"free\"",
+        "<%= config.bin %> asa negative-keywords add --campaign UUID --text \"free\" --text \"cheap\"",
+        "<%= config.bin %> asa negative-keywords add --campaign UUID --all-ad-groups --text \"free\""
       ],
       "flags": {
         "json": {
@@ -5071,17 +5630,71 @@
           "multiple": false,
           "type": "option"
         },
-        "adam-id": {
-          "description": "Limit the refresh to one app; omit to cover every app",
-          "name": "adam-id",
+        "ad-group": {
+          "description": "Ad group ID (UUID) — the campaign is resolved from it",
+          "exclusive": [
+            "campaign"
+          ],
+          "name": "ad-group",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all-ad-groups": {
+          "dependsOn": [
+            "campaign"
+          ],
+          "description": "Apply to every ad group of the campaign instead of the campaign itself",
+          "name": "all-ad-groups",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "campaign": {
+          "description": "Campaign ID (UUID)",
+          "exclusive": [
+            "ad-group"
+          ],
+          "name": "campaign",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "match-type": {
+          "description": "Match type",
+          "name": "match-type",
+          "default": "EXACT",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BROAD",
+            "EXACT"
+          ],
+          "type": "option"
+        },
+        "status": {
+          "description": "Keyword status",
+          "name": "status",
+          "default": "ACTIVE",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "ACTIVE",
+            "PAUSED"
+          ],
+          "type": "option"
+        },
+        "text": {
+          "description": "Keyword text, repeatable",
+          "name": "text",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:product-pages:sync",
+      "id": "asa:negative-keywords:add",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5092,17 +5705,17 @@
         "dist",
         "commands",
         "asa",
-        "product-pages",
-        "sync.js"
+        "negative-keywords",
+        "add.js"
       ]
     },
-    "asa:search-terms:list": {
+    "asa:negative-keywords:list": {
       "aliases": [],
       "args": {},
-      "description": "List the search terms your ads matched, with their metrics",
+      "description": "List negative keywords; ad_group_id is empty for campaign-level ones",
       "examples": [
-        "<%= config.bin %> asa search-terms list --date-from 2026-07-01 --date-to 2026-07-31",
-        "<%= config.bin %> asa search-terms list --ad-group AD_GROUP_UUID"
+        "<%= config.bin %> asa negative-keywords list",
+        "<%= config.bin %> asa negative-keywords list --campaign CAMPAIGN_UUID"
       ],
       "flags": {
         "json": {
@@ -5128,20 +5741,6 @@
           "multiple": false,
           "type": "option"
         },
-        "date-from": {
-          "description": "Start of the reporting period (YYYY-MM-DD), defaults to today",
-          "name": "date-from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "date-to": {
-          "description": "End of the reporting period (YYYY-MM-DD), defaults to today",
-          "name": "date-to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "app": {
           "description": "Keep only rows in this app; repeatable",
           "name": "app",
@@ -5176,11 +5775,17 @@
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
+        },
+        "campaign-level-only": {
+          "description": "Keep only campaign-level rows (ad_group_id is null)",
+          "name": "campaign-level-only",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "asa:search-terms:list",
+      "id": "asa:negative-keywords:list",
       "pluginAlias": "adapty",
       "pluginName": "adapty",
       "pluginType": "core",
@@ -5191,7 +5796,7 @@
         "dist",
         "commands",
         "asa",
-        "search-terms",
+        "negative-keywords",
         "list.js"
       ]
     },
@@ -5499,5 +6104,5 @@
       ]
     }
   },
-  "version": "0.8.9"
+  "version": "0.9.0"
 }