@sanity/runtime-cli 17.7.1 → 17.8.0-next.g5972da4

package/oclif.manifest.json

@@ -1556,9 +1556,10 @@
     "blueprints:stacks": {
       "aliases": [],
       "args": {},
-      "description": "Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.\n\nUse this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to audit what's deployed across your project.\n\nUse --include-projects with --organization-id to also list Stacks from all projects within the organization.",
+      "description": "Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.\n\nUse this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to audit what's deployed across your project.\n\nWithout a scope, prompts for an organization or project. Use --all to list Stacks across every organization and project you can access, or --include-projects with --organization-id for one organization and its projects.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --all",
         "<%= config.bin %> <%= command.id %> --project-id <projectId>",
         "<%= config.bin %> <%= command.id %> --organization-id <organizationId>",
         "<%= config.bin %> <%= command.id %> --organization-id <organizationId> --include-projects"
@@ -1620,7 +1621,8 @@
           "description": "Sanity project ID used to scope Blueprint and Stack",
           "exclusive": [
             "organization-id",
-            "include-projects"
+            "include-projects",
+            "all"
           ],
           "name": "project-id",
           "hasDynamicHelp": false,
@@ -1635,7 +1637,8 @@
           ],
           "description": "Sanity organization ID used to scope Blueprint and Stack",
           "exclusive": [
-            "project-id"
+            "project-id",
+            "all"
           ],
           "name": "organization-id",
           "hasDynamicHelp": false,
@@ -1650,6 +1653,17 @@
           "name": "include-projects",
           "allowNo": false,
           "type": "boolean"
+        },
+        "all": {
+          "description": "List Stacks from every organization and project you have access to",
+          "exclusive": [
+            "project-id",
+            "organization-id",
+            "include-projects"
+          ],
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -1662,7 +1676,7 @@
       "summary": "List remote Stack deployments for your project or organization",
       "enableJsonFlag": true,
       "needs": [
-        "scope"
+        "token"
       ],
       "isESM": true,
       "relativePath": [
@@ -3127,5 +3141,5 @@
       ]
     }
   },
-  "version": "17.7.1"
+  "version": "17.8.0-next.g5972da4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.7.1",
+  "version": "17.8.0-next.g5972da4",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",

package/skills/blueprints-stacks.md

@@ -17,7 +17,9 @@ npx @sanity/cli blueprints stacks --project-id PROJECT_ID --json
 npx @sanity/cli blueprints stacks --organization-id ORGANIZATION_ID --json
 ```
 
-The JSON result contains `stacks`, `scopeType`, and `scopeId`; each entry carries `resourceCount` rather than a full `resources` array. Zero results prints `No stacks found` and emits no JSON. Match both the Stack and its scope; names alone may be ambiguous.
+Always pass a scope flag or `--all` when automating. With no scope to resolve the command prompts for an organization, then for a project if you pick project scope; without a terminal, or with `--json`, it fails with a missing-scope error instead.
+
+The JSON result contains `stacks`, `scopeType`, and `scopeId`; each entry carries `resourceCount` rather than a full `resources` array. Zero results prints `No stacks found`, and under `--json` returns an empty `stacks` array. Match both the Stack and its scope; names alone may be ambiguous.
 
 To also include Stacks scoped to the organization's projects:
 
@@ -25,4 +27,14 @@ To also include Stacks scoped to the organization's projects:
 npx @sanity/cli blueprints stacks --organization-id ORGANIZATION_ID --include-projects --json
 ```
 
-`--include-projects` requires `--organization-id`, cannot be combined with `--project-id`, and only queries the organization's first 50 projects. This command does not change the local Blueprint target; use `blueprints config --edit` for that.
+`--include-projects` requires `--organization-id`, cannot be combined with `--project-id`, and only queries the organization's first 50 projects.
+
+To sweep every organization and project the token can reach:
+
+```sh
+npx @sanity/cli blueprints stacks --all --json
+```
+
+`--all` cannot be combined with the scope flags or `--include-projects`. It is best effort: scopes that return an error are skipped and reported as a count, and only the first 200 projects are queried. Its JSON result contains `stacks` and no top-level `scopeType`/`scopeId`; read each entry's own `scopeType` and `scopeId` instead.
+
+This command does not change the local Blueprint target; use `blueprints config --edit` for that.