@sanity/runtime-cli 12.3.0 → 12.4.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/12.3.0 linux-x64 node-v24.11.1
+@sanity/runtime-cli/12.4.0 linux-x64 node-v24.12.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -44,8 +44,8 @@ USAGE
 * [`sanity-run functions env add NAME KEY VALUE`](#sanity-run-functions-env-add-name-key-value)
 * [`sanity-run functions env list NAME`](#sanity-run-functions-env-list-name)
 * [`sanity-run functions env remove NAME KEY`](#sanity-run-functions-env-remove-name-key)
-* [`sanity-run functions logs NAME`](#sanity-run-functions-logs-name)
-* [`sanity-run functions test NAME`](#sanity-run-functions-test-name)
+* [`sanity-run functions logs [NAME]`](#sanity-run-functions-logs-name)
+* [`sanity-run functions test [NAME]`](#sanity-run-functions-test-name)
 * [`sanity-run help [COMMAND]`](#sanity-run-help-command)
 
 ## `sanity-run blueprints add TYPE`
@@ -92,7 +92,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/v12.3.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -121,7 +121,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -143,7 +143,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -170,7 +170,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack-id <stackId> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -178,18 +178,19 @@ Diagnose potential issues with Blueprint configuration
 
 ```
 USAGE
-  $ sanity-run blueprints doctor [--verbose] [--path <value>] [--fix]
+  $ sanity-run blueprints doctor [--json] [--path <value>] [--verbose] [--fix]
 
 FLAGS
   --fix           Interactively fix configuration issues
-  --path=<value>  Path to the Blueprint configuration file
-  --verbose       Provide detailed information about issues
+  --json          Format output as json.
+  --path=<value>  Path to the directory containing the Blueprint
+  --verbose       Verbose output
 
 DESCRIPTION
   Diagnose potential issues with Blueprint configuration
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -211,7 +212,7 @@ EXAMPLES
   $ sanity-run blueprints info --id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -219,8 +220,8 @@ Initialize a new Blueprint Stack deployment
 
 ```
 USAGE
-  $ sanity-run blueprints init [DIR] [--dir <value>] [--example <value> | --blueprint-type json|js|ts | --stack-id
-    <value> | --stack-name <value>] [--project-id <value>] [--organization-id <value>] [--verbose]
+  $ sanity-run blueprints init [DIR] [--verbose] [--dir <value>] [--example <value> | --blueprint-type json|js|ts |
+    --stack-id <value> | --stack-name <value>] [--project-id <value>] [--organization-id <value>]
 
 ARGUMENTS
   [DIR]  Directory to create the Blueprint in
@@ -251,7 +252,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/v12.3.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -273,7 +274,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -290,7 +291,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -315,7 +316,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -357,7 +358,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/v12.3.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -380,7 +381,7 @@ EXAMPLES
   $ sanity-run functions dev --host 127.0.0.1 --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -402,7 +403,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/v12.3.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -422,7 +423,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -443,18 +444,18 @@ 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/v12.3.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/env/remove.ts)_
 
-## `sanity-run functions logs NAME`
+## `sanity-run functions logs [NAME]`
 
 Retrieve or delete logs for a Sanity Function
 
 ```
 USAGE
-  $ sanity-run functions logs NAME [-u] [-f [-d | -l <value> | -j]] [-w]
+  $ sanity-run functions logs [NAME] [-u] [-f [-d | -l <value> | -j]] [-w]
 
 ARGUMENTS
-  NAME  The name of the Sanity Function
+  [NAME]  The name of the Sanity Function
 
 FLAGS
   -d, --delete         Delete all logs for the function
@@ -477,21 +478,21 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.3.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/logs.ts)_
 
-## `sanity-run functions test NAME`
+## `sanity-run functions test [NAME]`
 
 Invoke a local Sanity Function
 
 ```
 USAGE
-  $ sanity-run functions test NAME [--data-before <value> | [-d <value> | -f <value> | --document-id <value>] |  | 
+  $ sanity-run functions test [NAME] [--data-before <value> | [-d <value> | -f <value> | --document-id <value>] |  |
     | --file-before <value> | --file-after <value> | --document-id-before <value> | --document-id-after <value>]
     [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>] [-a <value>] [--organization-id
     <value>] [--with-user-token] [--media-library-id <value> | --project-id <value> | --dataset <value>]
 
 ARGUMENTS
-  NAME  The name of the Sanity Function
+  [NAME]  The name of the Sanity Function
 
 FLAGS
   -a, --api=<value>                 Sanity API Version to use
@@ -526,7 +527,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/v12.3.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v12.4.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/assets.js

@@ -21,6 +21,7 @@ export async function stashAsset({ resource, auth, }) {
     const isCollection = isLocalFunctionCollection(resource);
     const functions = isCollection ? resource.functions : [resource];
     const combinedAsset = [];
+    const prepareErrors = [];
     try {
         for (const func of functions) {
             const prepResult = await prepareAsset({ resource: func, auth });
@@ -30,13 +31,18 @@ export async function stashAsset({ resource, auth, }) {
                     partAsset: { outputPath: prepResult.outputPath, cleanup: prepResult.cleanup },
                 });
             }
+            else if (prepResult.error) {
+                prepareErrors.push({ name: func.name, error: prepResult.error });
+            }
         }
         if (combinedAsset.length !== functions.length) {
             const processedNames = new Set(combinedAsset.map((asset) => asset.name));
             const failedFunctions = functions.filter((func) => !processedNames.has(func.name));
+            const failedNames = failedFunctions.map((f) => f.name).join(', ');
+            const errorDetails = prepareErrors.map((e) => `${e.name}: ${e.error}`).join('; ');
             return {
                 success: false,
-                error: `Failed to prepare ${failedFunctions.length} function(s) in collection: ${failedFunctions.map((f) => f.name).join(', ')}`,
+                error: `Failed to prepare ${failedFunctions.length} function(s) in blueprint: ${failedNames}${errorDetails ? `. Details: ${errorDetails}` : ''}`,
             };
         }
         let result = { success: false };

package/dist/baseCommands.d.ts

@@ -2,19 +2,53 @@ import type { Interfaces } from '@oclif/core';
 import { Command } from '@oclif/core';
 import type { ReadBlueprintResult } from './actions/blueprints/blueprint.js';
 import type { AuthParams, ScopeType, Stack } from './utils/types.js';
-export type Flags<T extends typeof Command> = Interfaces.InferredFlags<(typeof BlueprintCommand)['baseFlags'] & T['flags']>;
+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']>;
+export declare const baseFlags: {
+    json: Interfaces.BooleanFlag<boolean>;
+    path: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+    verbose: Interfaces.BooleanFlag<boolean>;
+};
+/**
+ * @description 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.
+ * Also centralizes baseFlags and enables oclif's built-in --json for all subclasses.
+ * @extends Command
+ */
+export declare abstract class RuntimeCommand<T extends typeof Command> extends Command {
+    protected flags: Flags<T>;
+    protected args: Args<T>;
+    static baseFlags: {
+        json: Interfaces.BooleanFlag<boolean>;
+        path: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        verbose: Interfaces.BooleanFlag<boolean>;
+    };
+    static enableJsonFlag: boolean;
+    /**
+     * Generates help text for this command class
+     * @param bin - The bin name to use for the help text; e.g. 'sanity', defaults to 'sanity-run'
+     * @param commandId - The sub-command to use for the help text; optional but recommended for better help text
+     * @returns The oclif-styled help text for the command
+     * @example const helpText = InfoCommand.getHelpText('sanity', 'blueprints info')
+     */
+    static getHelpText(bin?: string, commandId?: string): string;
+    init(): Promise<void>;
+}
 /**
  * @description Guarantees flags, args, sanityToken, and blueprint.
  * Blueprint parser errors are logged and the command exits with an error
- * @extends Command
+ * @extends RuntimeCommand
  */
-export declare abstract class BlueprintCommand<T extends typeof Command> extends Command {
+export declare abstract class LocalBlueprintCommand<T extends typeof Command> extends RuntimeCommand<T> {
     protected sanityToken: string;
     protected blueprint: ReadBlueprintResult;
-    protected flags: Flags<T>;
-    protected args: Args<T>;
     static baseFlags: {
+        json: Interfaces.BooleanFlag<boolean>;
+        path: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         verbose: Interfaces.BooleanFlag<boolean>;
     };
     init(): Promise<void>;
@@ -26,15 +60,17 @@ export declare abstract class BlueprintCommand<T extends typeof Command> extends
 /**
  * @description Guarantees flags, args, sanityToken, blueprint, scopeType, scopeId, stackId, auth, and deployedStack.
  * If scope or stack is missing, the command exits with an error
- * @extends BlueprintCommand
+ * @extends LocalBlueprintCommand
  */
-export declare abstract class DeployedBlueprintCommand<T extends typeof Command> extends BlueprintCommand<T> {
+export declare abstract class DeployedStackCommand<T extends typeof Command> extends LocalBlueprintCommand<T> {
     protected auth: AuthParams;
     protected deployedStack: Stack;
     protected scopeType: ScopeType;
     protected scopeId: string;
     protected stackId: string;
     static baseFlags: {
+        json: Interfaces.BooleanFlag<boolean>;
+        path: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         verbose: Interfaces.BooleanFlag<boolean>;
     };
     init(): Promise<void>;

package/dist/baseCommands.js

@@ -1,24 +1,83 @@
 // * https://oclif.io/docs/base_class
-import { Command, Flags as OclifFlags } from '@oclif/core';
+import { Command, CommandHelp, Flags as OclifFlags } from '@oclif/core';
 import { initBlueprintConfig, initDeployedBlueprintConfig } from './cores/index.js';
-const baseFlags = {
+const hidden = true;
+export const baseFlags = {
+    json: OclifFlags.boolean({
+        // override defaults from oclif's built-in --json flag
+        description: 'Format output as json.',
+        hidden,
+    }),
+    path: OclifFlags.string({
+        description: 'Path to the directory containing the Blueprint',
+        hidden,
+    }),
     verbose: OclifFlags.boolean({
         description: 'Verbose output',
         default: false,
-        hidden: true, // prevent help output on all commands
+        hidden,
     }),
 };
 /**
- * @description Guarantees flags, args, sanityToken, and blueprint.
- * Blueprint parser errors are logged and the command exits with an error
+ * @description 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.
+ * Also centralizes baseFlags and enables oclif's built-in --json for all subclasses.
  * @extends Command
  */
-export class BlueprintCommand extends Command {
-    sanityToken;
-    blueprint;
+export class RuntimeCommand extends Command {
     flags;
     args;
     static baseFlags = baseFlags;
+    static enableJsonFlag = true; // oclif's built-in --json flag
+    /**
+     * Generates help text for this command class
+     * @param bin - The bin name to use for the help text; e.g. 'sanity', defaults to 'sanity-run'
+     * @param commandId - The sub-command to use for the help text; optional but recommended for better help text
+     * @returns The oclif-styled help text for the command
+     * @example const helpText = InfoCommand.getHelpText('sanity', 'blueprints info')
+     */
+    static getHelpText(bin = 'sanity-run', commandId) {
+        // biome-ignore lint/complexity/noThisInStatic: this is this command class - not confusing
+        const thisClass = this;
+        const rawArgs = thisClass.args || {};
+        const args = Object.entries(rawArgs).reduce((acc, [name, arg]) => {
+            acc[name] = { ...arg, name };
+            return acc;
+        }, {});
+        const commandLoadable = {
+            //! required properties
+            id: commandId || thisClass.id || '',
+            flags: thisClass.flags || {},
+            args,
+            aliases: thisClass.aliases || [],
+            hidden: thisClass.hidden || false,
+            hiddenAliases: thisClass.hiddenAliases || [],
+            load: async () => thisClass,
+            //* optional properties
+            // bin, // seems to not be used in the CommandHelp class
+            // thisClass, // doesn't change the help text
+            help: thisClass.help,
+            usage: thisClass.usage,
+            examples: thisClass.examples,
+            description: thisClass.description,
+            summary: thisClass.summary,
+            state: thisClass.state,
+            deprecateAliases: thisClass.deprecateAliases,
+            deprecationOptions: thisClass.deprecationOptions,
+            strict: thisClass.strict,
+            hasDynamicHelp: thisClass.hasDynamicHelp,
+        };
+        const commandHelp = new CommandHelp(commandLoadable, { bin }, {
+            maxWidth: 120,
+        });
+        return commandHelp.generate();
+    }
     async init() {
         const { args, flags } = await this.parse({
             flags: this.ctor.flags,
@@ -30,6 +89,19 @@ export class BlueprintCommand extends Command {
         this.flags = flags;
         this.args = args;
         await super.init();
+    }
+}
+/**
+ * @description Guarantees flags, args, sanityToken, and blueprint.
+ * Blueprint parser errors are logged and the command exits with an error
+ * @extends RuntimeCommand
+ */
+export class LocalBlueprintCommand extends RuntimeCommand {
+    sanityToken;
+    blueprint;
+    static baseFlags = baseFlags;
+    async init() {
+        await super.init();
         const result = await initBlueprintConfig({
             bin: this.config.bin,
             log: (msg) => this.log(msg),
@@ -53,9 +125,9 @@ export class BlueprintCommand extends Command {
 /**
  * @description Guarantees flags, args, sanityToken, blueprint, scopeType, scopeId, stackId, auth, and deployedStack.
  * If scope or stack is missing, the command exits with an error
- * @extends BlueprintCommand
+ * @extends LocalBlueprintCommand
  */
-export class DeployedBlueprintCommand extends BlueprintCommand {
+export class DeployedStackCommand extends LocalBlueprintCommand {
     auth;
     deployedStack;
     scopeType;

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

@@ -3,8 +3,8 @@
  * @deprecated Use `functions add` instead.
  * We're in the process of deprecating the `blueprints add` command.
  */
-import { BlueprintCommand } from '../../baseCommands.js';
-export default class AddCommand extends BlueprintCommand<typeof AddCommand> {
+import { LocalBlueprintCommand } from '../../baseCommands.js';
+export default class AddCommand extends LocalBlueprintCommand<typeof AddCommand> {
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/blueprints/add.js

@@ -4,10 +4,10 @@
  * We're in the process of deprecating the `blueprints add` command.
  */
 import { Args, Flags } from '@oclif/core';
-import { BlueprintCommand } from '../../baseCommands.js';
+import { LocalBlueprintCommand } from '../../baseCommands.js';
 import { functionAddCore } from '../../cores/functions/index.js';
 // import {warn} from '../../utils/display/presenters.js'
-export default class AddCommand extends BlueprintCommand {
+export default class AddCommand extends LocalBlueprintCommand {
     // static state = 'deprecated'
     // static deprecationOptions = {
     //   message: '`blueprints add` is deprecated. Use `functions add` instead.',

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

@@ -1,5 +1,5 @@
-import { BlueprintCommand } from '../../baseCommands.js';
-export default class ConfigCommand extends BlueprintCommand<typeof ConfigCommand> {
+import { LocalBlueprintCommand } from '../../baseCommands.js';
+export default class ConfigCommand extends LocalBlueprintCommand<typeof ConfigCommand> {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/blueprints/config.js

@@ -1,7 +1,7 @@
 import { Flags } from '@oclif/core';
-import { BlueprintCommand } from '../../baseCommands.js';
+import { LocalBlueprintCommand } from '../../baseCommands.js';
 import { blueprintConfigCore } from '../../cores/blueprints/config.js';
-export default class ConfigCommand extends BlueprintCommand {
+export default class ConfigCommand extends LocalBlueprintCommand {
     static description = 'View or edit Blueprint configuration';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

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

@@ -1,5 +1,5 @@
-import { DeployedBlueprintCommand } from '../../baseCommands.js';
-export default class DeployCommand extends DeployedBlueprintCommand<typeof DeployCommand> {
+import { DeployedStackCommand } from '../../baseCommands.js';
+export default class DeployCommand extends DeployedStackCommand<typeof DeployCommand> {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/blueprints/deploy.js

@@ -1,7 +1,7 @@
 import { Flags } from '@oclif/core';
-import { DeployedBlueprintCommand } from '../../baseCommands.js';
+import { DeployedStackCommand } from '../../baseCommands.js';
 import { blueprintDeployCore } from '../../cores/blueprints/deploy.js';
-export default class DeployCommand extends DeployedBlueprintCommand {
+export default class DeployCommand extends DeployedStackCommand {
     static description = 'Deploy a Blueprint';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

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

@@ -1,5 +1,5 @@
-import { BlueprintCommand } from '../../baseCommands.js';
-export default class DestroyCommand extends BlueprintCommand<typeof DestroyCommand> {
+import { LocalBlueprintCommand } from '../../baseCommands.js';
+export default class DestroyCommand extends LocalBlueprintCommand<typeof DestroyCommand> {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/blueprints/destroy.js

@@ -1,7 +1,7 @@
 import { Flags } from '@oclif/core';
-import { BlueprintCommand } from '../../baseCommands.js';
+import { LocalBlueprintCommand } from '../../baseCommands.js';
 import { blueprintDestroyCore } from '../../cores/blueprints/destroy.js';
-export default class DestroyCommand extends BlueprintCommand {
+export default class DestroyCommand extends LocalBlueprintCommand {
     static description = 'Destroy a Blueprint Stack deployment and its resources (will not delete local files)';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

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

@@ -1,11 +1,12 @@
-import { Command } from '@oclif/core';
-export default class DoctorCommand extends Command {
+import { RuntimeCommand } from '../../baseCommands.js';
+export default class DoctorCommand extends RuntimeCommand<typeof DoctorCommand> {
     static description: string;
     static examples: never[];
     static flags: {
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         fix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<void>;
+    run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/doctor.js

@@ -1,32 +1,30 @@
-import { Command, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
+import { baseFlags, RuntimeCommand, unhide } from '../../baseCommands.js';
 import config from '../../config.js';
 import { blueprintDoctorCore } from '../../cores/blueprints/doctor.js';
-export default class DoctorCommand extends Command {
+export default class DoctorCommand extends RuntimeCommand {
     static description = 'Diagnose potential issues with Blueprint configuration';
     static examples = [];
     static flags = {
-        verbose: Flags.boolean({
-            description: 'Provide detailed information about issues',
-            default: false,
-        }),
-        path: Flags.string({
-            description: 'Path to the Blueprint configuration file',
-        }),
+        path: unhide(baseFlags.path),
         fix: Flags.boolean({
             description: 'Interactively fix configuration issues',
             default: false,
         }),
+        json: unhide(baseFlags.json),
+        verbose: unhide(baseFlags.verbose),
     };
     async run() {
-        const { flags } = await this.parse(DoctorCommand);
         const { token } = config;
-        const { success, error } = await blueprintDoctorCore({
+        const result = await blueprintDoctorCore({
             bin: this.config.bin,
             log: (message) => this.log(message),
             token,
-            flags,
+            flags: this.flags,
         });
+        const { success, error } = result;
         if (!success)
             this.error(error);
+        return result.data;
     }
 }

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

@@ -1,5 +1,5 @@
-import { DeployedBlueprintCommand } from '../../baseCommands.js';
-export default class InfoCommand extends DeployedBlueprintCommand<typeof InfoCommand> {
+import { DeployedStackCommand } from '../../baseCommands.js';
+export default class InfoCommand extends DeployedStackCommand<typeof InfoCommand> {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/blueprints/info.js

@@ -1,7 +1,7 @@
 import { Flags } from '@oclif/core';
-import { DeployedBlueprintCommand } from '../../baseCommands.js';
+import { DeployedStackCommand } from '../../baseCommands.js';
 import { blueprintInfoCore } from '../../cores/blueprints/info.js';
-export default class InfoCommand extends DeployedBlueprintCommand {
+export default class InfoCommand extends DeployedStackCommand {
     static description = 'Show information about a Blueprint Stack deployment';
     static examples = [
         '<%= config.bin %> <%= command.id %>',

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

@@ -1,5 +1,5 @@
-import { Command } from '@oclif/core';
-export default class InitCommand extends Command {
+import { RuntimeCommand } from '../../baseCommands.js';
+export default class InitCommand extends RuntimeCommand<typeof InitCommand> {
     static description: string;
     static examples: string[];
     static args: {