@sanity/runtime-cli 17.10.0 → 17.11.1-next.gc1820a0

package/README.md

@@ -90,7 +90,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.10.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -127,7 +127,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.10.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,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.10.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -221,7 +221,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.10.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -291,7 +291,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.10.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -355,7 +355,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.10.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -401,7 +401,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.10.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -446,7 +446,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.10.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.11.1-next.gc1820a0/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -479,7 +479,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.10.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -515,7 +515,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.10.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -556,7 +556,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.10.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -608,7 +608,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.10.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -643,7 +643,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -676,7 +676,7 @@ EXAMPLES
   $ sanity-run functions env add --stack <name-or-id> MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -706,7 +706,7 @@ EXAMPLES
   $ sanity-run functions env list --stack <name-or-id> MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -738,7 +738,7 @@ EXAMPLES
   $ sanity-run functions env remove --stack <name-or-id> MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -778,7 +778,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -836,7 +836,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.10.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.11.1-next.gc1820a0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 
@@ -856,5 +856,5 @@ DESCRIPTION
   Display help for sanity-run.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.58/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.3.0/src/commands/help.ts)_
 <!-- commandsstop -->

package/dist/actions/blueprints/blueprint.js

@@ -24,7 +24,7 @@ import {defineBlueprint, defineDocumentFunction} from '@sanity/blueprints'
 
 export default defineBlueprint({
   resources: [
-    // defineDocumentFunction({name: 'my-function'}),
+    // defineDocumentFunction({name: 'my-function', event: {on: ['create', 'update']}}),
   ],
 })
 `.trim();

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

@@ -1,5 +1,6 @@
 import { resolveDeployedResources } from '../../utils/blueprints/resolve-deployed-resources.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 import { isAssetResource, } from '../../utils/types.js';
 import { processAssets } from './process-assets.js';
@@ -67,8 +68,8 @@ async function preDeployStack(options) {
             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.`,
+                `Run \`${runCommand(bin)} blueprints plan\` to preview changes before deploying.`,
+                `Run \`${runCommand(bin)} blueprints doctor\` to check your configuration.`,
             ],
         };
     }
@@ -97,8 +98,8 @@ async function preDeployStack(options) {
             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.`,
+                `Run \`${runCommand(bin)} blueprints info\` to check status.`,
+                `Run \`${runCommand(bin)} blueprints logs --watch\` to keep streaming logs.`,
             ],
         };
     }
@@ -109,8 +110,8 @@ async function preDeployStack(options) {
             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.`,
+                `Run \`${runCommand(bin)} blueprints logs --verbose\` for more context.`,
+                `Run \`${runCommand(bin)} blueprints plan\` to identify issues with your Blueprint.`,
             ],
         };
     }

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

@@ -1,5 +1,6 @@
 import { setTimeout as sleep } from 'node:timers/promises';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { setupLogPolling } from './logs-polling.js';
 import { classifyOperationPoll, getOperation, OPERATION_POLL_INITIAL_DELAY_MS, OPERATION_POLL_INTERVAL_MS, OPERATION_POLL_MAX_CONSECUTIVE_ERRORS, } from './operations.js';
 const IDLE_SPINNER_DELAY_MS = 30_000;
@@ -95,7 +96,7 @@ export async function waitForOperation(options) {
                     Math.floor((idleFor - IDLE_SPINNER_DELAY_MS) / IDLE_SPINNER_UPDATE_INTERVAL_MS) *
                         IDLE_SPINNER_UPDATE_INTERVAL_MS;
                 const elapsedIdleSeconds = elapsedIdleMs / 1000;
-                const text = `No new activity for ${elapsedIdleSeconds} seconds. The ${progressNoun} is still running on Sanity servers. You can safely exit and check status later with \`npx ${bin} blueprints info\`.`;
+                const text = `No new activity for ${elapsedIdleSeconds} seconds. The ${progressNoun} is still running on Sanity servers. You can safely exit and check status later with \`${runCommand(bin)} blueprints info\`.`;
                 if (idleSpinner)
                     idleSpinner.start(text);
                 else

package/dist/actions/sanity/examples.js

@@ -71,7 +71,13 @@ async function extractExampleFromArchive({ archiveStream, exampleType, exampleNa
         if (cleanPath.startsWith(`${fullPath}/`) || cleanPath === fullPath) {
             if (type === 'file') {
                 const chunks = [];
-                stream.on('data', (chunk) => chunks.push(chunk));
+                stream.on('data', (chunk) => {
+                    if (!(chunk instanceof Uint8Array)) {
+                        stream.destroy(new TypeError('Expected archive entry data to be a Uint8Array'));
+                        return;
+                    }
+                    chunks.push(chunk);
+                });
                 stream.on('end', () => {
                     const content = Buffer.concat(chunks).toString('utf8');
                     files[cleanPath.replace(`${fullPath}/`, '')] = content;
@@ -88,7 +94,8 @@ async function extractExampleFromArchive({ archiveStream, exampleType, exampleNa
             next();
         }
     });
-    // pipes!
+    // not ideal to cast as unknown as Writable...
+    // but tar-stream uses streamx, which interoperates with Node streams
     await pipeline(archiveStream, createGunzip(), extractStream);
     if (Object.keys(files).length === 0)
         return null;

package/dist/constants.d.ts

@@ -52,3 +52,5 @@ export declare const LABEL_SCHEDULED = "Scheduled";
 export declare const LABEL_SYNC_TAG_INVALIDATE = "Sync Tag Invalidate";
 export declare const CI_SETUP_DOCS_URL = "https://www.sanity.io/docs/blueprints/deploy-blueprints-from-ci";
 export declare const STEP_PHASE_GLYPH: Record<DurableStepPhase, string>;
+/** Stands in for environment variable values, which are never echoed back to the user */
+export declare const ENV_MASK = "********";

package/dist/constants.js

@@ -61,3 +61,5 @@ export const STEP_PHASE_GLYPH = {
     complete: '✔',
     error: '✖',
 };
+/** Stands in for environment variable values, which are never echoed back to the user */
+export const ENV_MASK = '********';

package/dist/cores/blueprints/config.js

@@ -2,7 +2,8 @@ import { patchConfigFile, writeConfigFile, } from '../../actions/blueprints/conf
 import { resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
 import { formatDateTime } from '../../utils/display/dates.js';
 import { filePathRelativeToCwd, labeledId, warn } from '../../utils/display/presenters.js';
-import { runScopeAndStackWizard } from '../../utils/display/prompt.js';
+import { CancelledError, runScopeAndStackWizard } from '../../utils/display/prompt.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintConfigCore(options) {
     const { bin = 'sanity', blueprint, log, token, flags } = options;
@@ -19,7 +20,7 @@ export async function blueprintConfigCore(options) {
             log('No Blueprint config found at .sanity/blueprint.config.json.');
         }
         if (!editConfig) {
-            log(`Run \`npx ${bin} blueprints doctor\` for diagnostics.`);
+            log(`Run \`${runCommand(bin)} blueprints doctor\` for diagnostics.`);
             return { success: true }; // not necessarily fatal
         }
     }
@@ -82,12 +83,21 @@ export async function blueprintConfigCore(options) {
         log('');
         const knownOrganizationId = configScopeType === 'organization' ? configScopeId : undefined;
         const knownProjectId = configScopeType === 'project' ? configScopeId : undefined;
-        const wizardResult = await runScopeAndStackWizard({
-            token,
-            knownOrganizationId,
-            knownProjectId,
-            logger: log,
-        });
+        let wizardResult;
+        try {
+            wizardResult = await runScopeAndStackWizard({
+                token,
+                knownOrganizationId,
+                knownProjectId,
+                logger: log,
+            });
+        }
+        catch (error) {
+            if (error instanceof CancelledError) {
+                return { success: false, error: 'Configuration cancelled.', cancelled: true };
+            }
+            throw error;
+        }
         if (!wizardResult.scopeId)
             return { success: false, error: 'Scope selection is required.' };
         try {

package/dist/cores/blueprints/deploy.js

@@ -7,6 +7,7 @@ import { extractDurableConfig } from '../../utils/blueprints/extract-durable-con
 import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { check, niceId, severe } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 import { getWarnings } from '../../utils/warnings.js';
 export async function blueprintDeployCore(options) {
@@ -29,7 +30,7 @@ export async function blueprintDeployCore(options) {
                 success: false,
                 error: 'A Stack operation is already in progress.',
                 suggestions: [
-                    `Run \`npx ${bin} blueprints info\` to check operation status.`,
+                    `Run \`${runCommand(bin)} blueprints info\` to check operation status.`,
                     'Wait for the current operation to complete, then try again.',
                 ],
             };
@@ -76,8 +77,8 @@ export async function blueprintDeployCore(options) {
                 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.`,
+                    `Run \`${runCommand(bin)} blueprints plan\` to preview changes before deploying.`,
+                    `Run \`${runCommand(bin)} blueprints doctor\` to check your configuration.`,
                 ],
             };
         }
@@ -92,7 +93,7 @@ export async function blueprintDeployCore(options) {
             : Promise.resolve(null);
         if (noWait) {
             logger(styleText(['bold', 'green'], 'Stack deployment started!'));
-            logger(`Use \`npx ${bin} blueprints info\` to check status`);
+            logger(`Use \`${runCommand(bin)} blueprints info\` to check status`);
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -132,8 +133,8 @@ export async function blueprintDeployCore(options) {
                 exitCode: EXIT_OPERATION_UNCONFIRMED,
                 suggestions: [
                     'The 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.`,
+                    `Run \`${runCommand(bin)} blueprints info\` to check status.`,
+                    `Run \`${runCommand(bin)} blueprints logs --watch\` to keep streaming logs.`,
                 ],
             };
         }
@@ -143,8 +144,8 @@ export async function blueprintDeployCore(options) {
             suggestions: [
                 ...outcome.logHints,
                 'Review the 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.`,
+                `Run \`${runCommand(bin)} blueprints logs --verbose\` for more context.`,
+                `Run \`${runCommand(bin)} blueprints plan\` to identify issues with your Blueprint.`,
             ],
         };
     }

package/dist/cores/blueprints/destroy.js

@@ -5,6 +5,7 @@ import { destroyStack, getStack, resolveStackIdByNameOrId } from '../../actions/
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintDestroyCore(options) {
     const { bin = 'sanity', log, token, scopeType, scopeId, localStackId, blueprintConfig, flags, } = options;
@@ -64,8 +65,8 @@ export async function blueprintDestroyCore(options) {
                 success: false,
                 error: 'Stack deployment not found',
                 suggestions: [
-                    `Run \`npx ${bin} blueprints stacks\` to list available Stacks.`,
-                    `Run \`npx ${bin} blueprints doctor\` to check your configuration.`,
+                    `Run \`${runCommand(bin)} blueprints stacks\` to list available Stacks.`,
+                    `Run \`${runCommand(bin)} blueprints doctor\` to check your configuration.`,
                 ],
             };
         }
@@ -164,8 +165,8 @@ async function waitForDestruction(options) {
             exitCode: EXIT_OPERATION_UNCONFIRMED,
             suggestions: [
                 'The destruction may or may not have finished on Sanity servers.',
-                `Run \`npx ${bin} blueprints info\` to view current Stack status.`,
-                `Run \`npx ${bin} blueprints logs --watch\` to keep streaming logs.`,
+                `Run \`${runCommand(bin)} blueprints info\` to view current Stack status.`,
+                `Run \`${runCommand(bin)} blueprints logs --watch\` to keep streaming logs.`,
             ],
         };
     }
@@ -175,8 +176,8 @@ async function waitForDestruction(options) {
         suggestions: [
             ...outcome.logHints,
             'Review the destruction output above for error details.',
-            `Run \`npx ${bin} blueprints logs --verbose\` for more context.`,
-            `Run \`npx ${bin} blueprints info\` to view current Stack status.`,
+            `Run \`${runCommand(bin)} blueprints logs --verbose\` for more context.`,
+            `Run \`${runCommand(bin)} blueprints info\` to view current Stack status.`,
         ],
     };
 }

package/dist/cores/blueprints/doctor.js

@@ -10,6 +10,7 @@ import config, { RUNTIME_CLI_VERSION } from '../../config.js';
 import { formatDateTime } from '../../utils/display/dates.js';
 import { presentBlueprintParserErrors } from '../../utils/display/errors.js';
 import { advise, check, filePathRelativeToCwd, niceId, renderSection, severe, unsure, } from '../../utils/display/presenters.js';
+import { runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
@@ -374,7 +375,9 @@ export async function blueprintDoctorCore(options) {
             return {
                 success: false,
                 error: `${errorMessage}. Unable to fix: Blueprint manifest is missing or invalid`,
-                suggestions: [`Run \`npx ${bin} blueprints init\` to create a new Blueprint manifest.`],
+                suggestions: [
+                    `Run \`${runCommand(bin)} blueprints init\` to create a new Blueprint manifest.`,
+                ],
                 data: { diagnostics: flatDiagnostics },
             };
         }
@@ -389,12 +392,22 @@ export async function blueprintDoctorCore(options) {
         if (fixResult.success) {
             return { ...fixResult, warnings: hasWarnings ? warnings : undefined };
         }
+        if (fixResult.cancelled) {
+            return {
+                success: false,
+                error: `${errorMessage}. Unable to fix: ${fixResult.error}`,
+                cancelled: true,
+                data: { diagnostics: flatDiagnostics },
+            };
+        }
         return fixResult;
     }
     return {
         success: false,
         error: errorMessage,
-        suggestions: [`Run \`npx ${bin} blueprints doctor --fix\` to fix configuration issues.`],
+        suggestions: [
+            `Run \`${runCommand(bin)} blueprints doctor --fix\` to fix configuration issues.`,
+        ],
         data: { diagnostics: flatDiagnostics },
     };
 }

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

@@ -36,6 +36,8 @@ export declare function resolveScopeAndStack(params: {
     stackId: string | undefined;
     stackName: string | undefined;
     knownProjectId?: string;
+    /** Where the Blueprint lands; its folder name seeds the new Stack name. */
+    blueprintDir?: string;
     log: Logger;
     token: string;
 }): Promise<ResolvedScope>;