@sanity/runtime-cli 17.1.0 → 17.2.0-next.ga4b9ae7

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/17.1.0 linux-x64 node-v24.18.0
+@sanity/runtime-cli/17.2.0-next.ga4b9ae7 linux-x64 node-v24.18.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/v17.1.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/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/v17.1.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -194,7 +194,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/v17.1.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -232,7 +232,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/v17.1.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -240,13 +240,12 @@ Diagnose potential issues with local Blueprint and remote Stack configuration
 
 ```
 USAGE
-  $ sanity-run blueprints doctor [--json] [-p <value>] [--verbose] [--fix]
+  $ sanity-run blueprints doctor [--json] [-p <value>] [--fix]
 
 FLAGS
   -p, --path=<value>  [env: SANITY_BLUEPRINT_PATH] Path to a Blueprint file or directory containing one
       --fix           Interactively fix configuration issues
       --json          Format output as json
-      --[no-]verbose  Verbose output; defaults to true
 
 DESCRIPTION
   Diagnose potential issues with local Blueprint and remote Stack configuration
@@ -257,13 +256,15 @@ DESCRIPTION
   Run this command when encountering errors with other Blueprint commands. Use --fix to interactively resolve detected
   issues.
 
+  Supports --json for programmatic consumption of diagnostic results.
+
 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/v17.1.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -300,7 +301,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/v17.1.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -364,7 +365,7 @@ EXAMPLES
   $ 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/v17.1.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -410,7 +411,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/v17.1.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -455,7 +456,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/v17.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/v17.2.0-next.ga4b9ae7/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -488,7 +489,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/v17.1.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -524,7 +525,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/v17.1.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -560,7 +561,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/v17.1.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -612,7 +613,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/v17.1.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -647,7 +648,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -677,7 +678,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/v17.1.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -704,7 +705,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -733,7 +734,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/v17.1.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -773,7 +774,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -830,7 +831,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/v17.1.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-next.ga4b9ae7/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -3,9 +3,10 @@ import type { Logger } from '../../utils/logger.js';
 import type { AssetResource, AuthParams, InstallerType } from '../../utils/types.js';
 export declare const assetCheckUrl: string;
 export declare const assetStashUrl: string;
-export declare function stashAsset({ resource, auth, logger, installer, }: {
+export declare function stashAsset({ resource, auth, blueprintFileDir, logger, installer, }: {
     resource: AssetResource;
     auth: AuthParams;
+    blueprintFileDir: string;
     logger: Logger;
     installer?: InstallerType;
 }): Promise<{

package/dist/actions/blueprints/assets.js

@@ -1,48 +1,52 @@
 import crypto from 'node:crypto';
 import fs from 'node:fs';
+import { readFile } from 'node:fs/promises';
 import AdmZip from 'adm-zip';
 import { blueprintsUrl } from '../../config.js';
 import { CONVERT_BYTES_TO_MB, MAX_ASSET_SIZE } from '../../constants.js';
 import { prepareAsset as prepareFunctionAsset } from '../../utils/functions/prepare-asset.js';
 import getHeaders from '../../utils/get-headers.js';
+import { prepareStudioAsset } from '../../utils/studios/prepare-asset.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { isLocalFunctionResource, isStudioResource } from '../../utils/types.js';
 const assetsUrl = blueprintsUrl('assets');
 export const assetCheckUrl = `${assetsUrl}/check`;
 export const assetStashUrl = `${assetsUrl}/stash`;
-export async function stashAsset({ resource, auth, logger, installer, }) {
+export async function stashAsset({ resource, auth, blueprintFileDir, logger, installer, }) {
+    let cleanup = async () => { };
     try {
         let b64;
         let hash;
         let extension;
-        let cleanup;
         if (isLocalFunctionResource(resource)) {
-            const prepResult = await prepareFunctionAsset({ resource }, { installer });
+            const prepResult = await prepareFunctionAsset({ resource, blueprintFileDir, installer });
             if (prepResult.success === false) {
+                await prepResult.cleanup();
                 return {
                     success: false,
                     error: prepResult.error,
                 };
             }
+            cleanup = prepResult.cleanup;
             const zipResult = await pathToB64ZipHash(prepResult.outputPath);
             b64 = zipResult.b64;
             hash = zipResult.hash;
             extension = 'zip';
-            cleanup = prepResult.cleanup;
         }
         else if (isStudioResource(resource)) {
-            const prepResult = await prepareStudioAsset({ resource });
+            const prepResult = await prepareStudioAsset({ resource, blueprintFileDir });
             if (prepResult.success === false) {
+                await prepResult.cleanup();
                 return {
                     success: false,
                     error: prepResult.error,
                 };
             }
-            const buffer = await fs.promises.readFile(prepResult.outputPath);
+            cleanup = prepResult.cleanup;
+            const buffer = await readFile(prepResult.outputPath);
             b64 = buffer.toString('base64');
             hash = hashBuffer(buffer);
             extension = 'tar.gz';
-            cleanup = prepResult.cleanup;
         }
         else {
             return {
@@ -61,28 +65,15 @@ export async function stashAsset({ resource, auth, logger, installer, }) {
         });
     }
     catch (err) {
+        try {
+            await cleanup();
+        }
+        catch {
+            // ignore clean up errors
+        }
         return { success: false, error: err instanceof Error ? err.message : `${err}` };
     }
 }
-async function prepareStudioAsset({ resource, }) {
-    if (!fs.existsSync(resource.src)) {
-        return {
-            success: false,
-            async cleanup() {
-                // no op
-            },
-            error: `Property 'src' on resource with type '${resource.type}' must be a directory`,
-        };
-    }
-    return {
-        success: true,
-        async cleanup() {
-            // no op
-        },
-        // studio must be pre built (e.g. with `npm run build`) and tarred/gzipped
-        outputPath: resource.src,
-    };
-}
 async function stashSingleAsset({ b64, hash, cleanup, resource, auth, logger, extension = 'zip', }) {
     const fetchFn = createTracedFetch(logger);
     try {

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

@@ -4,7 +4,7 @@ import type { Logger } from '../../utils/logger.js';
 import type { BlueprintParserError, ScopeType } from '../../utils/types.js';
 import { type LocatedBlueprintsConfig } from './config.js';
 import { type ConfigSource } from './resolve.js';
-declare const SUPPORTED_FILE_EXTENSIONS: readonly [".json", ".js", ".mjs", ".ts"];
+declare const SUPPORTED_FILE_EXTENSIONS: readonly ['.json', '.js', '.mjs', '.ts'];
 type BlueprintFileExtension = (typeof SUPPORTED_FILE_EXTENSIONS)[number];
 export declare const JSON_BLUEPRINT_CONTENT: {
     blueprintVersion: string;

package/dist/actions/blueprints/pre-deploy.d.ts

@@ -0,0 +1,29 @@
+import type { BlueprintResource } from '@sanity/blueprints';
+import type { Logger } from '../../utils/logger.js';
+import { type AuthParams, type InstallerType, type ScopeType } from '../../utils/types.js';
+type PreDeployResult = {
+    success: false;
+    error: string;
+    code?: string;
+    exitCode?: number;
+    suggestions?: string[];
+} | {
+    success: true;
+};
+type PreDeployResourceOptions = {
+    auth: AuthParams;
+    blueprintFileDir: string;
+    installer: InstallerType;
+    log: Logger;
+};
+type PreDeployOptions = {
+    scopeType: ScopeType;
+    scopeId: string;
+    resources: BlueprintResource[];
+    stackId: string;
+    stackName: string;
+    bin: string;
+    verbose: boolean | undefined;
+} & PreDeployResourceOptions;
+export declare function preDeploy(options: PreDeployOptions): Promise<PreDeployResult>;
+export {};

package/dist/actions/blueprints/pre-deploy.js

@@ -0,0 +1,164 @@
+import { env } from 'node:process';
+import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
+import { niceId } from '../../utils/display/presenters.js';
+import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
+import { styleText } from '../../utils/style-text.js';
+import { isAssetResource, } from '../../utils/types.js';
+import { stashAsset } from './assets.js';
+import { updateStack } from './stacks.js';
+import { waitForOperation } from './wait-for-operation.js';
+const DEFAULT_ASSET_TIMEOUT = 180;
+const assetTimeoutS = Number(process.env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
+const assetTimeoutMs = assetTimeoutS * 1000;
+const warnTimeoutMs = assetTimeoutMs / 3;
+export async function preDeploy(options) {
+    const { resources, stackId, auth, blueprintFileDir, installer, log } = options;
+    const hasAssetResources = resources.some(isAssetResource);
+    if (hasAssetResources) {
+        let assetResources;
+        if (env.SANITY_BLUEPRINTS_PRE_DEPLOY_ENABLED === 'true') {
+            const preDeployStackResult = await preDeployStack(options);
+            if (!preDeployStackResult.success) {
+                return preDeployStackResult;
+            }
+            /** Look up resources from the back-end and attach the externalId if possible */
+            const resolvedResources = await resolveDeployedResources({
+                resources,
+                stackId,
+                auth,
+                logger: log,
+            });
+            assetResources = resolvedResources.filter(isAssetResource);
+        }
+        else {
+            assetResources = resources.filter(isAssetResource);
+        }
+        log('Processing assets...');
+        for (const resource of assetResources) {
+            const preDeployResult = await preDeployResource(resource, {
+                auth,
+                blueprintFileDir,
+                installer,
+                log,
+            });
+            if (!preDeployResult.success)
+                return preDeployResult;
+            const idx = resources.findIndex((r) => r.name === resource.name);
+            if (idx === -1)
+                throw new Error('Unable to update resource asset');
+            resources[idx] = preDeployResult.resource;
+        }
+    }
+    return { success: true };
+}
+async function preDeployStack(options) {
+    const { scopeType, scopeId, stackId, stackName, resources, auth, log, bin, verbose } = options;
+    const spinner = log.ora('Starting pre-deploy...').start();
+    const stackMutation = {
+        scopeType,
+        scopeId,
+        name: stackName,
+        preDeploy: true,
+        document: { resources },
+    };
+    const { ok: deployOk, stack, error: deployError, } = await updateStack({ stackId, stackMutation, auth, logger: log });
+    if (!deployOk) {
+        spinner.fail(`${styleText('red', 'Failed')} to complete Stack pre-deployment`);
+        return {
+            success: false,
+            error: deployError || 'Failed to complete Stack pre-deployment',
+            suggestions: [
+                `Run \`npx ${bin} blueprints plan\` to preview changes before deploying.`,
+                `Run \`npx ${bin} blueprints doctor\` to check your configuration.`,
+            ],
+        };
+    }
+    spinner.stop().clear();
+    log(styleText('dim', 'Stack deployment progress:'));
+    log('');
+    const outcome = await waitForOperation({
+        stackId,
+        operationId: stack.operationId,
+        auth,
+        log,
+        bin,
+        verbose,
+        progressNoun: 'pre-deployment',
+    });
+    if (outcome.type === 'completed') {
+        log(styleText(['bold', 'green'], 'Stack pre-deployment completed!'));
+    }
+    else if (outcome.type === 'unconfirmed') {
+        return {
+            success: false,
+            error: `Stack pre-deployment was accepted but completion could not be confirmed${outcome.error ? ` (${outcome.error})` : ''}.`,
+            code: CODE_OPERATION_UNCONFIRMED,
+            exitCode: EXIT_OPERATION_UNCONFIRMED,
+            suggestions: [
+                'The pre-deployment may or may not have finished on Sanity servers.',
+                `Run \`npx ${bin} blueprints info\` to check status.`,
+                `Run \`npx ${bin} blueprints logs --watch\` to keep streaming logs.`,
+            ],
+        };
+    }
+    else {
+        return {
+            success: false,
+            error: 'Stack pre-deployment failed',
+            suggestions: [
+                ...outcome.logHints,
+                'Review the pre-deployment output above for error details.',
+                `Run \`npx ${bin} blueprints logs --verbose\` for more context.`,
+                `Run \`npx ${bin} blueprints plan\` to identify issues with your Blueprint.`,
+            ],
+        };
+    }
+    return { success: true };
+}
+async function preDeployResource(resource, options) {
+    const { auth, blueprintFileDir, installer, log } = options;
+    const fnSpinner = log.ora({ text: `Processing ${resource.name}...`, prefixText: ' ' }).start();
+    const warnTimer = setTimeout(() => {
+        fnSpinner.text = `Still processing ${resource.name}, this can take a moment...`;
+    }, warnTimeoutMs);
+    let assetTimeoutTimer;
+    let result;
+    try {
+        result = await Promise.race([
+            stashAsset({ resource, blueprintFileDir, auth, logger: log, installer }),
+            new Promise((_, reject) => {
+                assetTimeoutTimer = setTimeout(() => {
+                    reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));
+                }, assetTimeoutMs);
+            }),
+        ]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fnSpinner.fail(msg);
+        return { success: false, error: msg };
+    }
+    finally {
+        clearTimeout(warnTimer);
+        clearTimeout(assetTimeoutTimer);
+    }
+    if (result.success && result.assetId) {
+        const updatedResource = { ...resource, src: result.assetId };
+        fnSpinner.succeed(`${updatedResource.name} ${niceId(result.assetId)}`);
+        log(`   Source: ${updatedResource.src}`);
+        if (result.hash) {
+            if (result.hash.length > 24) {
+                log.verbose(`   Hash: ${result.hash.slice(0, 8)}...${result.hash.slice(-12)}`);
+            }
+            else {
+                log.verbose(`   Hash: ${result.hash}`);
+            }
+        }
+        if (result.exists)
+            log.verbose('   Asset unchanged');
+        return { success: true, resource: updatedResource };
+    }
+    const errorMsg = `Failed uploading ${resource.name} asset, deploy has stopped`;
+    fnSpinner.fail(errorMsg);
+    return { success: false, error: result.error || 'Failed to process asset' };
+}

package/dist/actions/blueprints/wait-for-operation.js

@@ -12,6 +12,7 @@ export async function waitForOperation(options) {
     const logHints = createHintCollector(bin);
     let logStreamCleanup = null;
     try {
+        log.showProgress();
         let lastLogAt = Date.now();
         let idleMessageShown = false;
         let consecutiveErrors = 0;
@@ -85,4 +86,7 @@ export async function waitForOperation(options) {
             logStreamCleanup();
         throw error;
     }
+    finally {
+        log.clearProgress();
+    }
 }

package/dist/actions/sanity/examples.d.ts

@@ -2,12 +2,12 @@ import type { Logger } from '../../utils/logger.js';
 export declare const EXAMPLES_CACHE_DIR: string;
 declare const EXAMPLE_TYPES: {
     readonly blueprint: {
-        readonly repo: "sanity-io/sanity";
-        readonly dir: "examples/blueprints";
+        readonly repo: 'sanity-io/sanity';
+        readonly dir: 'examples/blueprints';
     };
     readonly function: {
-        readonly repo: "sanity-labs/function-recipes";
-        readonly dir: "";
+        readonly repo: 'sanity-labs/function-recipes';
+        readonly dir: '';
     };
 };
 export declare function verifyExampleExists({ type, name, logger, }: {

package/dist/baseCommands.d.ts

@@ -10,7 +10,7 @@ export declare const pathFlagConfig: {
     description: string;
     env: string;
     aliases: string[];
-    char: "p";
+    char: 'p';
 };
 export declare const baseFlags: {
     json: Interfaces.BooleanFlag<boolean>;
@@ -112,14 +112,14 @@ export type Need = 'token' | 'blueprint' | 'scope' | 'stackId' | 'deployedStack'
 export declare abstract class ResolvedCommand<T extends typeof Command> extends RuntimeCommand<T> {
     static needs: readonly Need[];
     static baseFlags: {
-        stack: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
-        'project-id': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
-        'organization-id': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         json: Interfaces.BooleanFlag<boolean>;
         path: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         trace: Interfaces.BooleanFlag<boolean>;
         'validate-resources': Interfaces.BooleanFlag<boolean>;
         verbose: Interfaces.BooleanFlag<boolean>;
+        stack: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'project-id': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'organization-id': Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
     };
     protected sanityToken: string;
     protected blueprint: ReadBlueprintResult;

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

@@ -4,7 +4,7 @@
  */
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class AddCommand extends ResolvedCommand<typeof AddCommand> {
-    static needs: readonly ["blueprint"];
+    static needs: readonly ['blueprint'];
     static state: string;
     static deprecationOptions: {
         to: string;

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

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class ConfigCommand extends ResolvedCommand<typeof ConfigCommand> {
-    static needs: readonly ["token", "blueprint"];
+    static needs: readonly ['token', 'blueprint'];
     static summary: string;
     static description: string;
     static examples: string[];

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

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class DeployCommand extends ResolvedCommand<typeof DeployCommand> {
-    static needs: readonly ["deployedStack", "blueprint"];
+    static needs: readonly ['deployedStack', 'blueprint'];
     static summary: string;
     static description: string;
     static examples: string[];

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

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class DestroyCommand extends ResolvedCommand<typeof DestroyCommand> {
-    static needs: readonly ["scope"];
+    static needs: readonly ['scope'];
     static summary: string;
     static description: string;
     static examples: string[];

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

@@ -6,7 +6,6 @@ export default class DoctorCommand extends RuntimeCommand<typeof DoctorCommand>
     static flags: {
         path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         fix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/doctor.js

@@ -7,8 +7,9 @@ export default class DoctorCommand extends RuntimeCommand {
     static summary = 'Diagnose potential issues with local Blueprint and remote Stack configuration';
     static description = `Analyzes your local Blueprint and remote Stack configuration for common issues, such as missing authentication, invalid project references, or misconfigured resources.
 
-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
+Run this command when encountering errors with other Blueprint commands. Use --fix to interactively resolve detected issues.
+
+Supports --json for programmatic consumption of diagnostic results.`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --fix',
@@ -19,11 +20,6 @@ Run this command when encountering errors with other Blueprint commands. Use --f
             description: 'Interactively fix configuration issues',
             default: false,
         }),
-        verbose: Flags.boolean({
-            description: 'Verbose output; defaults to true',
-            default: true,
-            allowNo: true,
-        }),
     };
     async run() {
         const { token } = config;

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

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class InfoCommand extends ResolvedCommand<typeof InfoCommand> {
-    static needs: readonly ["deployedStack"];
+    static needs: readonly ['deployedStack'];
     static summary: string;
     static description: string;
     static examples: string[];