@sanity/runtime-cli 15.1.0 → 15.1.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/15.1.0 linux-x64 node-v24.15.0
+@sanity/runtime-cli/15.1.1 linux-x64 node-v24.15.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -103,7 +103,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -140,7 +140,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -191,7 +191,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -213,8 +213,8 @@ FLAGS
 DESCRIPTION
   Destroy a remote Stack deployment and its resources
 
-  Permanently removes the remote Stack and all its provisioned resources. Your local Blueprint files remain untouched,
-  allowing you to redeploy later with 'blueprints init' + 'blueprints deploy'.
+  Permanently removes the remote Stack and all its provisioned resources. Your Blueprint manifest and resource files
+  remain intact; "stackId" is unset in your local config.
 
   This is a destructive operation. You will be prompted to confirm unless --force is specified.
 
@@ -226,7 +226,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack <name-or-id> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -257,7 +257,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -294,7 +294,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -340,12 +340,20 @@ EXAMPLES
 
   $ sanity-run blueprints init --blueprint-type <json|js|ts>
 
-  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId> --stack-id <stackId>
+  $ sanity-run blueprints init --organization-id <organizationId>
 
-  $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
+  $ sanity-run blueprints init --project-id <projectId>
+
+  $ sanity-run blueprints init --stack-name <newStackName>
+
+  $ sanity-run blueprints init --stack-id <existingStackId>
+
+  $ sanity-run blueprints init new-stack --type <json|js|ts> --org <organizationId> --name <newStackName>
+
+  $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -391,7 +399,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -436,7 +444,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -469,7 +477,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -505,7 +513,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -541,7 +549,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -593,7 +601,7 @@ EXAMPLES
   $ sanity-run functions add --name my-function --type document-create --type document-update --lang js
 ```
 
-_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -628,7 +636,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -658,7 +666,7 @@ EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -685,7 +693,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -714,7 +722,7 @@ EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -754,7 +762,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -811,7 +819,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v15.1.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/config.d.ts

@@ -32,7 +32,7 @@ export declare function writeConfigFile(blueprintFilePath: string, options: {
 export interface ConfigPatch {
     organizationId?: string | null;
     projectId?: string | null;
-    stackId?: string;
+    stackId?: string | null;
 }
 /**
  * Update the config file with the given properties.
@@ -42,7 +42,7 @@ export interface ConfigPatch {
  * @param updateableProperties - the properties to update
  * @param updateableProperties.organizationId - the organization ID (null to remove)
  * @param updateableProperties.projectId - the project ID (null to remove)
- * @param updateableProperties.stackId - the stack ID
+ * @param updateableProperties.stackId - the stack ID (null to remove)
  */
 export declare function patchConfigFile(blueprintFilePath: string, updateableProperties: ConfigPatch): BlueprintsConfig;
 /**

package/dist/actions/blueprints/config.js

@@ -59,7 +59,7 @@ export function writeConfigFile(blueprintFilePath, options) {
  * @param updateableProperties - the properties to update
  * @param updateableProperties.organizationId - the organization ID (null to remove)
  * @param updateableProperties.projectId - the project ID (null to remove)
- * @param updateableProperties.stackId - the stack ID
+ * @param updateableProperties.stackId - the stack ID (null to remove)
  */
 export function patchConfigFile(blueprintFilePath, updateableProperties) {
     const existingConfig = readConfigFile(blueprintFilePath);

package/dist/commands/blueprints/destroy.js

@@ -5,7 +5,7 @@ import { Logger } from '../../utils/logger.js';
 export default class DestroyCommand extends ResolvedCommand {
     static needs = ['token', 'blueprint'];
     static summary = 'Destroy a remote Stack deployment and its resources';
-    static description = `Permanently removes the remote Stack and all its provisioned resources. Your local Blueprint files remain untouched, allowing you to redeploy later with 'blueprints init' + 'blueprints deploy'.
+    static description = `Permanently removes the remote Stack and all its provisioned resources. Your Blueprint manifest and resource files remain intact; "stackId" is unset in your local config.
 
 This is a destructive operation. You will be prompted to confirm unless --force is specified.
 

package/dist/commands/blueprints/init.js

@@ -16,8 +16,12 @@ After initialization, use 'blueprints plan' to preview changes, then 'blueprints
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> [directory]',
         '<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts>',
-        '<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts> --project-id <projectId> --stack-id <stackId>',
-        '<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts> --stack-name <stackName>',
+        '<%= config.bin %> <%= command.id %> --organization-id <organizationId>',
+        '<%= config.bin %> <%= command.id %> --project-id <projectId>',
+        '<%= config.bin %> <%= command.id %> --stack-name <newStackName>',
+        '<%= config.bin %> <%= command.id %> --stack-id <existingStackId>',
+        '<%= config.bin %> <%= command.id %> new-stack --type <json|js|ts> --org <organizationId> --name <newStackName>',
+        '<%= config.bin %> <%= command.id %> old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>',
     ];
     static args = {
         dir: Args.string({

package/dist/cores/blueprints/destroy.js

@@ -1,5 +1,6 @@
 import { setTimeout as sleep } from 'node:timers/promises';
 import { confirm } from '@inquirer/prompts';
+import { patchConfigFile } from '../../actions/blueprints/config.js';
 import { setupLogPolling } from '../../actions/blueprints/logs-polling.js';
 import { destroyStack, getStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
@@ -32,6 +33,7 @@ export async function blueprintDestroyCore(options) {
         });
         if (!ok)
             return { success: false, error: error || 'Failed to destroy Stack deployment' };
+        clearLocalStackIdFromConfig(blueprint, stack.id, log);
         if (noWait) {
             log(styleText(['bold', 'magenta'], 'Stack destruction started!'));
             return { success: true, json: { stackId: stack.id, stackName: stack.name } };
@@ -112,6 +114,7 @@ export async function blueprintDestroyCore(options) {
             return { success: false, error: error || 'Failed to destroy Stack deployment' };
         }
         destroySpinner.stop().clear();
+        clearLocalStackIdFromConfig(blueprint, stack.id, log);
         if (noWait) {
             log(styleText(['bold', 'magenta'], 'Stack destruction started!'));
             return { success: true, json: { stackId: stack.id, stackName: stack.name } };
@@ -130,6 +133,19 @@ export async function blueprintDestroyCore(options) {
         return { success: false, error: errorMessage };
     }
 }
+function clearLocalStackIdFromConfig(blueprint, destroyedStackId, log) {
+    if (!blueprint.blueprintConfig)
+        return;
+    if (blueprint.blueprintConfig.stackId !== destroyedStackId)
+        return;
+    try {
+        patchConfigFile(blueprint.fileInfo.blueprintFilePath, { stackId: null });
+        log(styleText('dim', 'Removed stackId from .sanity/blueprint.config.json'));
+    }
+    catch {
+        log(styleText('yellow', 'Could not update .sanity/blueprint.config.json. Remove stackId manually.'));
+    }
+}
 async function waitForDestruction(options) {
     const { stackId, stackName, operationId, auth, log, bin } = options;
     log(styleText('dim', 'Stack destruction progress:'));

package/oclif.manifest.json

@@ -523,7 +523,7 @@
     "blueprints:destroy": {
       "aliases": [],
       "args": {},
-      "description": "Permanently removes the remote Stack and all its provisioned resources. Your local Blueprint files remain untouched, allowing you to redeploy later with 'blueprints init' + 'blueprints deploy'.\n\nThis is a destructive operation. You will be prompted to confirm unless --force is specified.\n\nUse this to clean up test environments or decommission a Stack you no longer need.",
+      "description": "Permanently removes the remote Stack and all its provisioned resources. Your Blueprint manifest and resource files remain intact; \"stackId\" is unset in your local config.\n\nThis is a destructive operation. You will be prompted to confirm unless --force is specified.\n\nUse this to clean up test environments or decommission a Stack you no longer need.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --stack <name-or-id> --project-id <projectId> --force --no-wait"
@@ -849,8 +849,12 @@
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> [directory]",
         "<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts>",
-        "<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts> --project-id <projectId> --stack-id <stackId>",
-        "<%= config.bin %> <%= command.id %> --blueprint-type <json|js|ts> --stack-name <stackName>"
+        "<%= config.bin %> <%= command.id %> --organization-id <organizationId>",
+        "<%= config.bin %> <%= command.id %> --project-id <projectId>",
+        "<%= config.bin %> <%= command.id %> --stack-name <newStackName>",
+        "<%= config.bin %> <%= command.id %> --stack-id <existingStackId>",
+        "<%= config.bin %> <%= command.id %> new-stack --type <json|js|ts> --org <organizationId> --name <newStackName>",
+        "<%= config.bin %> <%= command.id %> old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>"
       ],
       "flags": {
         "json": {
@@ -2994,5 +2998,5 @@
       ]
     }
   },
-  "version": "15.1.0"
+  "version": "15.1.1"
 }

package/package.json

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