@sanity/runtime-cli 14.8.5 → 14.9.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/14.8.5 linux-x64 node-v24.14.1
+@sanity/runtime-cli/14.9.0 linux-x64 node-v24.14.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -101,7 +101,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/v14.8.5/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/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/v14.8.5/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -159,8 +159,8 @@ FLAGS
 DESCRIPTION
   Deploy the local Blueprint to the remote Stack
 
-  Pushes your local Blueprint configuration to the remote Stack; provisioning, updating, or destroying resources as
-  needed. This is the primary command for applying infrastructure changes.
+  Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the
+  primary command for applying infrastructure changes.
 
   Before deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack
   status or 'blueprints logs' to monitor activity.
@@ -179,11 +179,11 @@ EXAMPLES
   $ sanity-run blueprints deploy --fn-installer npm
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
-Destroy the remote Stack deployment and its resources (will not delete local files)
+Destroy a remote Stack deployment and its resources
 
 ```
 USAGE
@@ -200,7 +200,7 @@ FLAGS
   --[no-]validate-resources  Validate resources
 
 DESCRIPTION
-  Destroy the remote Stack deployment and its resources (will not delete local files)
+  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'.
@@ -215,7 +215,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/v14.8.5/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -240,13 +240,18 @@ DESCRIPTION
 
   Run this command when encountering errors with other Blueprint commands. Use --fix to interactively resolve detected
   issues.
+
+EXAMPLES
+  $ sanity-run blueprints doctor
+
+  $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
-Show information about the local Blueprint's remote Stack deployment
+Display the status and resources of the remote Stack deployment
 
 ```
 USAGE
@@ -258,7 +263,7 @@ FLAGS
   --[no-]validate-resources  Validate resources
 
 DESCRIPTION
-  Show information about the local Blueprint's remote Stack deployment
+  Display the status and resources of the remote Stack deployment
 
   Displays the current state and metadata of your remote Stack deployment, including deployed resources, status, and
   configuration.
@@ -274,11 +279,11 @@ EXAMPLES
   $ sanity-run blueprints info --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
-Initialize a local Blueprint and optionally provision a remote Stack deployment
+Initialize a Blueprint and create a remote Stack
 
 ```
 USAGE
@@ -303,7 +308,7 @@ FLAGS
   --verbose                  Verbose output
 
 DESCRIPTION
-  Initialize a local Blueprint and optionally provision a remote Stack deployment
+  Initialize a Blueprint and create a remote Stack
 
   A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions,
   etc.). A Stack is the remote deployment target where your Blueprint is applied.
@@ -328,7 +333,7 @@ EXAMPLES
   $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -359,11 +364,11 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
-Enumerate resources to be deployed to the remote Stack - will not modify any resources
+Preview changes that will be applied to the remote Stack
 
 ```
 USAGE
@@ -375,7 +380,7 @@ FLAGS
   --[no-]validate-resources  Validate resources
 
 DESCRIPTION
-  Enumerate resources to be deployed to the remote Stack - will not modify any resources
+  Preview changes that will be applied to the remote Stack
 
   Use this command to preview what changes will be applied to your remote Stack before deploying. This is a safe,
   read-only operation—no resources are created, modified, or deleted.
@@ -387,11 +392,11 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
-List all remote Stack deployments (defaults to the current Blueprint's project scope)
+List remote Stack deployments for your project or organization
 
 ```
 USAGE
@@ -404,7 +409,7 @@ FLAGS
   --[no-]validate-resources  Validate resources
 
 DESCRIPTION
-  List all remote Stack deployments (defaults to the current Blueprint's project scope)
+  List remote Stack deployments for your project or organization
 
   Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.
 
@@ -419,7 +424,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -472,7 +477,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/v14.8.5/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -508,7 +513,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -539,7 +544,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/v14.8.5/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -567,7 +572,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -597,7 +602,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/v14.8.5/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -639,7 +644,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.8.5/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -697,7 +702,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/v14.8.5/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.9.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -39,9 +39,13 @@ export type ConfigSource = 'config' | 'env' | 'module' | 'inferred';
 export interface ReadBlueprintResult {
     fileInfo: FileInfo;
     blueprintConfig: LocatedBlueprintsConfig | null;
+    /** The raw blueprint data as read from disk */
     rawBlueprint: Record<string, unknown>;
+    /** The blueprints-parser blueprint result */
     parsedBlueprint: Blueprint;
     errors: BlueprintParserError[];
+    /** Validated resources escaped from parser types */
+    resources: BlueprintResource[];
     /** @deprecated - use blueprintConfig.configPath instead */
     configPath?: string;
     scopeType?: ScopeType;

package/dist/actions/blueprints/blueprint.js

@@ -229,10 +229,16 @@ export async function readLocalBlueprint(logger, validate, blueprintPath) {
             errors.push(...validateResources(parsedBlueprint.resources));
         }
     }
+    // Ceremony to cross from parser's Resource type to BlueprintResource
+    // widen from the parser's Resource type assignable to BlueprintResource
+    const parserResources = parsedBlueprint?.resources ?? [];
+    // filter to valid resources typed as BlueprintResource
+    const validResources = parserResources.filter((r) => !!r.type);
     return {
         fileInfo: { blueprintFilePath: foundFilePath, fileName, extension },
         blueprintConfig,
         rawBlueprint,
+        resources: validResources,
         errors,
         scopeType,
         scopeId,

package/dist/baseCommands.d.ts

@@ -1,6 +1,7 @@
 import type { Interfaces } from '@oclif/core';
 import { Command } from '@oclif/core';
 import type { ReadBlueprintResult } from './actions/blueprints/blueprint.js';
+import type { CoreResult } from './cores/index.js';
 import type { AuthParams, ScopeType, Stack } from './utils/types.js';
 export type Flags<T extends typeof Command> = Interfaces.InferredFlags<(typeof RuntimeCommand)['baseFlags'] & T['flags']>;
 export type Args<T extends typeof Command> = Interfaces.InferredArgs<T['args']>;
@@ -21,12 +22,12 @@ export declare const organizationIdFlagConfig: {
     aliases: string[];
 };
 /**
- * @description Unhides a flag by setting its hidden property to false
+ * Unhides a flag by setting its hidden property to false
  * Also makes oclif's types happy when destructuring the flag
  */
 export declare function unhide<T>(flag: T): T;
 /**
- * @description Guarantees flags and args.
+ * Guarantees flags and args.
  * Also centralizes baseFlags and enables oclif's built-in --json for all subclasses.
  * @extends Command
  */
@@ -50,9 +51,25 @@ export declare abstract class RuntimeCommand<T extends typeof Command> extends C
      */
     static getHelpText(bin?: string, commandId?: string): string;
     init(): Promise<void>;
+    /**
+     * Throws an oclif error from a failed CoreResult.
+     * forwarding suggestions, ref, or code to oclif's PrettyPrintableError rendering.
+     */
+    protected coreError(result: CoreResult & {
+        success: false;
+    }): never;
+    /**
+     * If an error doesn't have suggestions, match against known patterns to
+     * attach relevant suggestions before oclif renders the error.
+     *
+     * Add patterns to `CATCH_HINT_PATTERNS` as needed.
+     */
+    protected catch(err: Error & {
+        exitCode?: number;
+    }): Promise<unknown>;
 }
 /**
- * @description Guarantees flags, args, sanityToken, and blueprint.
+ * Guarantees flags, args, sanityToken, and blueprint.
  * Blueprint parser errors are logged and the command exits with an error
  * @extends RuntimeCommand
  */
@@ -67,13 +84,9 @@ export declare abstract class LocalBlueprintCommand<T extends typeof Command> ex
         verbose: Interfaces.BooleanFlag<boolean>;
     };
     init(): Promise<void>;
-    protected catch(err: Error & {
-        exitCode?: number;
-    }): Promise<unknown>;
-    protected finally(_: Error | undefined): Promise<unknown>;
 }
 /**
- * @description Guarantees flags, args, sanityToken, blueprint, scopeType, scopeId, stackId, auth, and deployedStack.
+ * Guarantees flags, args, sanityToken, blueprint, scopeType, scopeId, stackId, auth, and deployedStack.
  * If scope or stack is missing, the command exits with an error
  * @extends LocalBlueprintCommand
  */

package/dist/baseCommands.js

@@ -2,6 +2,15 @@
 import { Command, CommandHelp, Flags as OclifFlags } from '@oclif/core';
 import { initBlueprintConfig, initDeployedBlueprintConfig } from './cores/index.js';
 import { Logger } from './utils/logger.js';
+/**
+ * Fallback error-to-hint patterns for RuntimeCommand.catch().
+ * Each entry maps a regex to a function that returns suggestion strings.
+ * These only apply when the core did not set suggestions in the result.
+ */
+const CATCH_HINT_PATTERNS = [
+// Add patterns here as needed, for example:
+// [/scope/i, (bin) => [`Run \`npx ${bin} blueprints promote\` to change the Stack scope.`]],
+];
 const hidden = true;
 export const baseFlags = {
     json: OclifFlags.boolean({
@@ -44,14 +53,14 @@ export const organizationIdFlagConfig = {
     aliases: ['organization', 'organizationId', 'org'],
 };
 /**
- * @description Unhides a flag by setting its hidden property to false
+ * Unhides a flag by setting its hidden property to false
  * Also makes oclif's types happy when destructuring the flag
  */
 export function unhide(flag) {
     return { ...flag, hidden: false };
 }
 /**
- * @description Guarantees flags and args.
+ * Guarantees flags and args.
  * Also centralizes baseFlags and enables oclif's built-in --json for all subclasses.
  * @extends Command
  */
@@ -115,9 +124,38 @@ export class RuntimeCommand extends Command {
         this.args = args;
         await super.init();
     }
+    /**
+     * Throws an oclif error from a failed CoreResult.
+     * forwarding suggestions, ref, or code to oclif's PrettyPrintableError rendering.
+     */
+    coreError(result) {
+        this.error(result.error, {
+            suggestions: result.suggestions,
+            ref: result.ref,
+            code: result.code,
+        });
+    }
+    /**
+     * If an error doesn't have suggestions, match against known patterns to
+     * attach relevant suggestions before oclif renders the error.
+     *
+     * Add patterns to `CATCH_HINT_PATTERNS` as needed.
+     */
+    async catch(err) {
+        const pErr = err;
+        if (!pErr.suggestions?.length) {
+            for (const [pattern, hints] of CATCH_HINT_PATTERNS) {
+                if (pattern.test(err.message)) {
+                    pErr.suggestions = hints(this.config.bin);
+                    break;
+                }
+            }
+        }
+        return super.catch(err);
+    }
 }
 /**
- * @description Guarantees flags, args, sanityToken, and blueprint.
+ * Guarantees flags, args, sanityToken, and blueprint.
  * Blueprint parser errors are logged and the command exits with an error
  * @extends RuntimeCommand
  */
@@ -134,23 +172,22 @@ export class LocalBlueprintCommand extends RuntimeCommand {
             blueprintPath: this.flags.path,
         });
         if (!result.ok) {
-            this.error(result.error);
+            const suggestions = [];
+            if (/token|login/i.test(result.error)) {
+                suggestions.push('Run `npx @sanity/cli login` to authenticate.');
+            }
+            else if (/blueprint/i.test(result.error) && /error/i.test(result.error)) {
+                suggestions.push('Fix the Blueprint errors listed above.');
+            }
+            suggestions.push(`Run \`${this.config.bin} blueprints doctor\` to check your configuration.`);
+            this.error(result.error, { suggestions });
         }
         this.sanityToken = result.value.token;
         this.blueprint = result.value.blueprint;
     }
-    async catch(err) {
-        // add any custom logic to handle errors from the command
-        // or simply return the parent class error handling
-        return super.catch(err);
-    }
-    async finally(_) {
-        // called after run and catch regardless of whether or not the command errored
-        return super.finally(_);
-    }
 }
 /**
- * @description Guarantees flags, args, sanityToken, blueprint, scopeType, scopeId, stackId, auth, and deployedStack.
+ * Guarantees flags, args, sanityToken, blueprint, scopeType, scopeId, stackId, auth, and deployedStack.
  * If scope or stack is missing, the command exits with an error
  * @extends LocalBlueprintCommand
  */
@@ -173,7 +210,9 @@ export class DeployedStackCommand extends LocalBlueprintCommand {
             stackOverride: this.flags.stack,
         });
         if (!result.ok) {
-            this.error(result.error);
+            this.error(result.error, {
+                suggestions: [`Run \`${this.config.bin} blueprints doctor\` to check your configuration.`],
+            });
         }
         this.scopeType = result.value.scopeType;
         this.scopeId = result.value.scopeId;

package/dist/commands/blueprints/add.js

@@ -88,7 +88,7 @@ After adding a function, use 'functions dev' to test locally, then 'blueprints d
         //     `\`npx ${bin} blueprints add function\` is deprecated. Use \`npx ${bin} functions add\` instead.`,
         //   ),
         // )
-        const { success, error } = await functionAddCore({
+        const result = await functionAddCore({
             bin,
             log: Logger(this.log.bind(this), this.flags),
             blueprint,
@@ -104,7 +104,7 @@ After adding a function, use 'functions dev' to test locally, then 'blueprints d
                 install: flags.install,
             },
         });
-        if (!success)
-            this.error(error);
+        if (!result.success)
+            this.coreError(result);
     }
 }

package/dist/commands/blueprints/config.js

@@ -30,7 +30,7 @@ If you need to switch your Blueprint to a different Stack, use --edit --stack.`;
         }),
     };
     async run() {
-        const { success, error, json } = await blueprintConfigCore({
+        const result = await blueprintConfigCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             blueprint: this.blueprint,
@@ -38,8 +38,8 @@ If you need to switch your Blueprint to a different Stack, use --edit --stack.`;
             validateResources: this.flags['validate-resources'],
             flags: this.flags,
         });
-        if (!success)
-            this.error(error);
-        return json;
+        if (!result.success)
+            this.coreError(result);
+        return result.json;
     }
 }

package/dist/commands/blueprints/deploy.js

@@ -5,7 +5,7 @@ import { Logger } from '../../utils/logger.js';
 import { INSTALLER_OPTIONS } from '../../utils/types.js';
 export default class DeployCommand extends DeployedStackCommand {
     static summary = 'Deploy the local Blueprint to the remote Stack';
-    static description = `Pushes your local Blueprint configuration to the remote Stack; provisioning, updating, or destroying resources as needed. This is the primary command for applying infrastructure changes.
+    static description = `Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the primary command for applying infrastructure changes.
 
 Before deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.
 
@@ -37,7 +37,7 @@ Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for process
         }),
     };
     async run() {
-        const { success, error, json } = await blueprintDeployCore({
+        const result = await blueprintDeployCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             auth: this.auth,
@@ -49,8 +49,8 @@ Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for process
             validateResources: this.flags['validate-resources'],
             flags: this.flags,
         });
-        if (!success)
-            this.error(error);
-        return json;
+        if (!result.success)
+            this.coreError(result);
+        return result.json;
     }
 }

package/dist/commands/blueprints/destroy.js

@@ -3,7 +3,7 @@ import { LocalBlueprintCommand, organizationIdFlagConfig, projectIdFlagConfig, }
 import { blueprintDestroyCore } from '../../cores/blueprints/destroy.js';
 import { Logger } from '../../utils/logger.js';
 export default class DestroyCommand extends LocalBlueprintCommand {
-    static summary = 'Destroy the remote Stack deployment and its resources (will not delete local files)';
+    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'.
 
 This is a destructive operation. You will be prompted to confirm unless --force is specified.
@@ -39,7 +39,7 @@ Use this to clean up test environments or decommission a Stack you no longer nee
         }),
     };
     async run() {
-        const { success, error, json } = await blueprintDestroyCore({
+        const result = await blueprintDestroyCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             token: this.sanityToken,
@@ -47,8 +47,8 @@ Use this to clean up test environments or decommission a Stack you no longer nee
             validateResources: this.flags['validate-resources'],
             flags: this.flags,
         });
-        if (!success)
-            this.error(error);
-        return json;
+        if (!result.success)
+            this.coreError(result);
+        return result.json;
     }
 }

package/dist/commands/blueprints/doctor.d.ts

@@ -2,7 +2,7 @@ import { RuntimeCommand } from '../../baseCommands.js';
 export default class DoctorCommand extends RuntimeCommand<typeof DoctorCommand> {
     static summary: string;
     static description: string;
-    static examples: never[];
+    static examples: string[];
     static flags: {
         path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         fix: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/blueprints/doctor.js

@@ -9,7 +9,10 @@ export default class DoctorCommand extends RuntimeCommand {
 
 Run this command when encountering errors with other Blueprint commands. Use --fix to interactively resolve detected issues.`;
     // TODO: add "Supports --json for programmatic consumption of diagnostic results." to help text
-    static examples = [];
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --fix',
+    ];
     static flags = {
         path: unhide(baseFlags.path),
         fix: Flags.boolean({
@@ -32,9 +35,8 @@ Run this command when encountering errors with other Blueprint commands. Use --f
             validateResources: this.flags['validate-resources'],
             flags: this.flags,
         });
-        const { success, error, json } = result;
-        if (!success)
-            this.error(error);
-        return json;
+        if (!result.success)
+            this.coreError(result);
+        return result.json;
     }
 }

package/dist/commands/blueprints/info.js

@@ -3,7 +3,7 @@ import { DeployedStackCommand } from '../../baseCommands.js';
 import { blueprintInfoCore } from '../../cores/blueprints/info.js';
 import { Logger } from '../../utils/logger.js';
 export default class InfoCommand extends DeployedStackCommand {
-    static summary = "Show information about the local Blueprint's remote Stack deployment";
+    static summary = 'Display the status and resources of the remote Stack deployment';
     static description = `Displays the current state and metadata of your remote Stack deployment, including deployed resources, status, and configuration.
 
 Use this command to verify a deployment succeeded, check what resources are live, or confirm which Stack your local Blueprint is connected to.
@@ -20,7 +20,7 @@ Run 'blueprints stacks' to see all available Stacks in your project or organizat
         }),
     };
     async run() {
-        const { success, error, json } = await blueprintInfoCore({
+        const result = await blueprintInfoCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             stackId: this.stackId,
@@ -28,8 +28,8 @@ Run 'blueprints stacks' to see all available Stacks in your project or organizat
             validateResources: this.flags['validate-resources'],
             flags: this.flags,
         });
-        if (!success)
-            this.error(error);
-        return json;
+        if (!result.success)
+            this.coreError(result);
+        return result.json;
     }
 }

package/dist/commands/blueprints/init.js

@@ -4,7 +4,7 @@ import { blueprintInitCore } from '../../cores/blueprints/init.js';
 import { Logger } from '../../utils/logger.js';
 import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
 export default class InitCommand extends RuntimeCommand {
-    static summary = 'Initialize a local Blueprint and optionally provision a remote Stack deployment';
+    static summary = 'Initialize a Blueprint and create a remote Stack';
     static description = `A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.
 [NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]
 
@@ -57,7 +57,7 @@ After initialization, use 'blueprints plan' to preview changes, then 'blueprints
         const result = await validTokenOrErrorMessage(log);
         if (!result.ok)
             this.error(result.error.message);
-        const { success, error } = await blueprintInitCore({
+        const initResult = await blueprintInitCore({
             bin: this.config.bin,
             log,
             token: result.value,
@@ -65,7 +65,7 @@ After initialization, use 'blueprints plan' to preview changes, then 'blueprints
             args: this.args,
             flags: this.flags,
         });
-        if (!success)
-            this.error(error);
+        if (!initResult.success)
+            this.coreError(initResult);
     }
 }