@sanity/runtime-cli 17.9.0-blueprinit.g14aaebd → 17.10.0-next.g5e0bba6

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.9.0-blueprinit.g14aaebd/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/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.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/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.9.0-blueprinit.g14aaebd/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.10.0-next.g5e0bba6/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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/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>;

package/dist/cores/blueprints/init.js

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { basename, dirname, join, resolve } from 'node:path';
 import { cwd } from 'node:process';
 import { confirm } from '@inquirer/prompts';
 import { findBlueprintFile, readLocalBlueprint, writeBlueprintToDisk, } from '../../actions/blueprints/blueprint.js';
@@ -11,8 +11,9 @@ import { verifyExampleExists, writeExample } from '../../actions/sanity/examples
 import { getProject } from '../../actions/sanity/projects.js';
 import { BLUEPRINT_CONFIG_DIR, BLUEPRINT_CONFIG_FILE } from '../../config.js';
 import { check, filePathRelativeToCwd, labeledId, warn } from '../../utils/display/presenters.js';
-import { promptForBlueprintType, promptForOrganization, promptForProjectInOrg, promptForStack, runScopeAndStackWizard, } from '../../utils/display/prompt.js';
+import { CancelledError, promptForBlueprintType, promptForInitLocation, promptForOrganization, promptForProjectInOrg, promptForStack, runScopeAndStackWizard, } from '../../utils/display/prompt.js';
 import { isInteractive } from '../../utils/interactive.js';
+import { installCommand, runCommand } from '../../utils/package-manager.js';
 import { styleText } from '../../utils/style-text.js';
 import { blueprintConfigCore } from './config.js';
 /** Derive scope type and ID from mutually exclusive flag values. */
@@ -29,8 +30,8 @@ export async function blueprintInitCore(options) {
     const { dir: argDir } = args;
     const explicitDir = argDir || flagDir;
     const isHere = !explicitDir || explicitDir === '.' || explicitDir === './';
-    const blueprintDir = isHere ? '.' : explicitDir;
-    const userProvidedDirName = isHere ? undefined : explicitDir;
+    let blueprintDir = isHere ? '.' : explicitDir;
+    let userProvidedDirName = isHere ? undefined : explicitDir;
     const validationError = validateFlags({
         stackId: flagStackId,
         stackName: flagStackName,
@@ -43,7 +44,7 @@ export async function blueprintInitCore(options) {
         const existingBlueprintFile = findBlueprintFile(blueprintDir);
         // existing blueprint file on disk → configure it for deployment
         if (existingBlueprintFile) {
-            return handleExistingBlueprint({
+            const result = await handleExistingBlueprint({
                 existingBlueprintFile,
                 bin,
                 log,
@@ -56,6 +57,11 @@ export async function blueprintInitCore(options) {
                 flagStackName,
                 verbose,
             });
+            // the config core owns the wizard, but the user ran `init`
+            if (!result.success && result.cancelled) {
+                return { success: false, error: 'Initialization cancelled.', cancelled: true };
+            }
+            return result;
         }
         // --example flag → scaffold from an example template
         if (flagExample) {
@@ -70,13 +76,21 @@ export async function blueprintInitCore(options) {
         }
         // no blueprint on disk → create new blueprint files from scratch
         if (!explicitDir && isInteractive) {
-            const proceed = await confirm({
-                message: `Initialize a Blueprint here in ${cwd()}?`,
-                default: true,
-            });
-            if (!proceed) {
-                log(`Run \`${bin} blueprints init <directory>\` to initialize in a different location.`);
-                return { success: false, error: 'Initialization cancelled.' };
+            const chosenDir = await promptForInitLocation(cwd());
+            if (chosenDir) {
+                blueprintDir = chosenDir;
+                userProvidedDirName = chosenDir;
+                // findBlueprintFile walks up, so only refuse on a manifest in the folder itself
+                const existing = findBlueprintFile(chosenDir);
+                if (existing && dirname(resolve(existing.blueprintFilePath)) === resolve(chosenDir)) {
+                    return {
+                        success: false,
+                        error: `A Blueprint already exists in "${chosenDir}".`,
+                        suggestions: [
+                            `Run \`${runCommand(bin)} blueprints init ${chosenDir}\` to configure it for deployment.`,
+                        ],
+                    };
+                }
             }
         }
         return handleFreshInitialization({
@@ -94,6 +108,9 @@ export async function blueprintInitCore(options) {
         });
     }
     catch (error) {
+        if (error instanceof CancelledError) {
+            return { success: false, error: 'Initialization cancelled.', cancelled: true };
+        }
         const errorMessage = error instanceof Error ? error.message : String(error);
         return { success: false, error: errorMessage };
     }
@@ -156,6 +173,7 @@ async function handleFreshInitialization(options) {
         stackId: flagStackId,
         stackName: flagStackName,
         knownProjectId,
+        blueprintDir,
         log,
         token,
     });
@@ -241,7 +259,7 @@ async function handleExampleInitialization(options) {
     const { blueprintFilePath } = discoveredBlueprint;
     writeConfigFile(blueprintFilePath, { projectId: resolvedProjectId, stackId: stack.id });
     log(check(`${styleText('bold', 'Configured:')} ${exampleDir}/${BLUEPRINT_CONFIG_DIR}/${BLUEPRINT_CONFIG_FILE}`));
-    log(`\n  Run "${styleText(['bold', 'magenta'], `cd ${exampleDir} && npm i`)}" and check out the README`);
+    log(`\n  Run "${styleText(['bold', 'magenta'], `cd ${exampleDir} && ${installCommand(exampleDir)}`)}" and check out the README`);
     if (instructions) {
         log('');
         log(instructions);
@@ -251,6 +269,7 @@ async function handleExampleInitialization(options) {
 export async function resolveScopeAndStack(params) {
     const { projectId, organizationId, stackId, stackName, knownProjectId, log, token } = params;
     const flagScope = resolveScopeFromFlags(projectId, organizationId);
+    const suggestedName = params.blueprintDir ? basename(resolve(params.blueprintDir)) : undefined;
     // --- Branch 1: Scope provided via flags ---
     if (flagScope) {
         const { scopeType, scopeId } = flagScope;
@@ -283,7 +302,13 @@ export async function resolveScopeAndStack(params) {
         // No stack flag: prompt for stack selection
         if (!resolvedStackId) {
             log('\nBlueprints are deployed to a "Stack".');
-            const stackResult = await promptForStack({ scopeType, scopeId, token, logger: log });
+            const stackResult = await promptForStack({
+                scopeType,
+                scopeId,
+                token,
+                logger: log,
+                suggestedName,
+            });
             if (typeof stackResult === 'symbol')
                 throw new Error('Unexpected back navigation');
             resolvedStackId = stackResult.stackId;
@@ -315,6 +340,7 @@ export async function resolveScopeAndStack(params) {
                     scopeId: knownProjectId,
                     token,
                     logger: log,
+                    suggestedName,
                 });
                 if (typeof stackResult === 'symbol')
                     throw new Error('Unexpected back navigation');
@@ -323,7 +349,11 @@ export async function resolveScopeAndStack(params) {
         }
     }
     // Full wizard: org -> scope -> project (if needed) -> stack
-    const wizard = await runScopeAndStackWizard({ token, logger: log });
+    const wizard = await runScopeAndStackWizard({
+        token,
+        logger: log,
+        suggestedStackName: suggestedName,
+    });
     return { scopeType: wizard.scopeType, scopeId: wizard.scopeId, stackId: wizard.stackId };
 }
 export async function determineBlueprintExtension(params) {
@@ -386,12 +416,18 @@ export async function createBlueprintFiles(params) {
             log.warn(warn(`Unable to add ${blueprintsPackage} to your project.`));
         }
     }
-    const nextStepParts = [];
+    const runLine = (command, purpose) => `  Run "${styleText(['bold', 'magenta'], command)}" ${purpose}`;
+    // project setup, only when there is something to do
+    const setupParts = [];
     if (userProvidedDirName)
-        nextStepParts.push(`cd ${userProvidedDirName}`);
+        setupParts.push(`cd ${userProvidedDirName}`);
     if (blueprintExtension !== 'json')
-        nextStepParts.push('npm install');
-    nextStepParts.push(`npx ${bin} blueprints --help`);
-    log(`\n  Run "${styleText(['bold', 'magenta'], nextStepParts.join(' && '))}" to get started`);
+        setupParts.push(installCommand(blueprintDir));
+    log('');
+    if (setupParts.length > 0)
+        log(runLine(setupParts.join(' && '), 'first'));
+    // the manifest starts empty, so name the command that fills it
+    log(runLine(`${runCommand(bin)} functions add`, 'to add a Function'));
+    log(runLine(`${runCommand(bin)} blueprints --help`, 'to see every command'));
     return { success: true };
 }