@sanity/runtime-cli 15.0.5 → 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.0.5 linux-x64 node-v24.14.1
+@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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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/commands/blueprints/plan.js

@@ -24,7 +24,6 @@ Run 'blueprints plan' after making local changes to your Blueprint manifest to v
             log: Logger(this.log.bind(this), this.flags),
             token: this.sanityToken,
             blueprint: this.blueprint,
-            validateResources: this.flags['validate-resources'],
             flags: this.flags,
         });
         if (!result.success)

package/dist/cores/blueprints/deploy.js

@@ -2,7 +2,7 @@ import { setTimeout as sleep } from 'node:timers/promises';
 import { stashAsset } from '../../actions/blueprints/assets.js';
 import { setupLogPolling } from '../../actions/blueprints/logs-polling.js';
 import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
-import { createLogHintCollector } from '../../utils/blueprints/log-hints.js';
+import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 import { isAssetResource } from '../../utils/types.js';
@@ -61,10 +61,15 @@ export async function blueprintDeployCore(options) {
         });
         if (!deployOk) {
             spinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
+            const hints = createHintCollector(bin);
+            if (deployError) {
+                hints.inspectMessage(deployError);
+            }
             return {
                 success: false,
                 error: deployError || 'Failed to update Stack deployment',
                 suggestions: [
+                    ...hints.getSuggestions(),
                     `Run \`npx ${bin} blueprints plan\` to preview changes before deploying.`,
                     `Run \`npx ${bin} blueprints doctor\` to check your configuration.`,
                 ],
@@ -82,7 +87,7 @@ export async function blueprintDeployCore(options) {
         }
         log(styleText('dim', 'Stack deployment progress:'));
         log('');
-        const logHints = createLogHintCollector(bin);
+        const logHints = createHintCollector(bin);
         let logStreamCleanup = null;
         try {
             let lastLogAt = Date.now();
@@ -96,7 +101,7 @@ export async function blueprintDeployCore(options) {
                 onActivity: () => {
                     lastLogAt = Date.now();
                 },
-                onLogEntry: (logEntry) => logHints.inspect(logEntry),
+                onLogEntry: (logEntry) => logHints.inspectLog(logEntry),
             });
             while (true) {
                 const { ok, stack: currentStack } = await getStack({ stackId: stack.id, auth, logger: log });

package/dist/cores/blueprints/destroy.js

@@ -1,8 +1,9 @@
 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 { createLogHintCollector } from '../../utils/blueprints/log-hints.js';
+import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintDestroyCore(options) {
@@ -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,11 +133,24 @@ 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:'));
     log('');
-    const logHints = createLogHintCollector(bin);
+    const logHints = createHintCollector(bin);
     let logStreamCleanup = null;
     try {
         let lastLogAt = Date.now();
@@ -147,7 +163,7 @@ async function waitForDestruction(options) {
             onActivity: () => {
                 lastLogAt = Date.now();
             },
-            onLogEntry: (logEntry) => logHints.inspect(logEntry),
+            onLogEntry: (logEntry) => logHints.inspectLog(logEntry),
         });
         while (true) {
             const { ok, stack: currentStack } = await getStack({ stackId, auth, logger: log });

package/dist/cores/blueprints/plan.js

@@ -1,4 +1,5 @@
 import { planStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
+import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { formatDeploymentPlan, formatResourceTree, hasActionableChanges, } from '../../utils/display/blueprints-formatting.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintPlanCore(options) {
@@ -42,9 +43,11 @@ export async function blueprintPlanCore(options) {
     });
     spinner.stop().clear();
     if (!planResponse.ok) {
+        const hints = createHintCollector(bin);
         if (planResponse.problems) {
             log('');
             for (const problem of planResponse.problems) {
+                hints.inspectMessage(problem.message);
                 const messages = problem.message
                     .split('\n')
                     .map((s) => s.trim())
@@ -60,7 +63,10 @@ export async function blueprintPlanCore(options) {
         return {
             success: false,
             error: 'Deployment plan has problems',
-            suggestions: [`Fix the issues above, then run \`npx ${bin} blueprints deploy\`.`],
+            suggestions: [
+                ...hints.getSuggestions(),
+                `Fix the issues above, then run \`npx ${bin} blueprints deploy\`.`,
+            ],
         };
     }
     log('');