@sanity/runtime-cli 17.4.0-blueprinit.g0ac8878 → 17.5.0

package/dist/actions/blueprints/process-assets.js

@@ -0,0 +1,80 @@
+import { env } from 'node:process';
+import { stashAsset } from './assets.js';
+const DEFAULT_ASSET_CONCURRENCY = 4;
+const DEFAULT_ASSET_TIMEOUT = 180;
+const assetTimeoutS = Number(env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
+const assetTimeoutMs = assetTimeoutS * 1000;
+const warnTimeoutMs = assetTimeoutMs / 3;
+export async function processAssets(options) {
+    const { assetResources, onProgress, onResult } = options;
+    const total = assetResources.length;
+    const processedAssets = [];
+    const concurrency = getAssetConcurrency();
+    let completed = 0;
+    let slow = false;
+    const reportProgress = () => onProgress?.({ completed, total, slow });
+    reportProgress();
+    const warnTimer = setTimeout(() => {
+        slow = true;
+        reportProgress();
+    }, warnTimeoutMs);
+    try {
+        for (let start = 0; start < total; start += concurrency) {
+            const batch = assetResources.slice(start, start + concurrency);
+            const batchResults = await Promise.all(batch.map(async (resource) => {
+                const result = await processAsset(resource, options);
+                completed += 1;
+                reportProgress();
+                onResult?.(result);
+                return result;
+            }));
+            processedAssets.push(...batchResults);
+            if (batchResults.some((result) => !result.success))
+                break;
+        }
+    }
+    finally {
+        clearTimeout(warnTimer);
+    }
+    return processedAssets;
+}
+function getAssetConcurrency() {
+    const configured = Number(env.SANITY_ASSET_CONCURRENCY);
+    return Number.isSafeInteger(configured) && configured > 0 ? configured : DEFAULT_ASSET_CONCURRENCY;
+}
+async function processAsset(resource, options) {
+    const { auth, blueprintFileDir, installer, logger } = options;
+    let assetTimeoutTimer;
+    let result;
+    try {
+        result = await Promise.race([
+            stashAsset({ resource, blueprintFileDir, auth, logger, 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);
+        return { success: false, resource, error: msg, failureKind: 'processing' };
+    }
+    finally {
+        clearTimeout(assetTimeoutTimer);
+    }
+    if (result.success && result.assetId) {
+        return {
+            success: true,
+            resource: { ...resource, src: result.assetId },
+            hash: result.hash,
+            exists: result.exists,
+        };
+    }
+    return {
+        success: false,
+        resource,
+        error: result.error || 'Failed to process asset',
+        failureKind: 'upload',
+    };
+}

package/dist/commands/blueprints/deploy.js

@@ -14,7 +14,9 @@ Use --no-wait to queue the deployment and return immediately without waiting for
 
 Use --fn-installer to force which package manager to use when deploying functions.
 
-Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.
+Set SANITY_ASSET_TIMEOUT (seconds) to override the 180-second timeout for processing resource assets.
+
+Set SANITY_ASSET_CONCURRENCY to override how many resource assets are processed at once (default 4).
 
 Exit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).`;
     static examples = [

package/dist/commands/blueprints/destroy.js

@@ -19,7 +19,7 @@ Exit codes: 0 destroyed, 2 destruction failed, 75 destruction accepted but compl
     static flags = {
         force: Flags.boolean({
             description: 'Force Stack destruction (skip confirmation)',
-            aliases: ['f'],
+            char: 'f',
             default: false,
         }),
         'project-id': Flags.string({

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

@@ -8,6 +8,7 @@ export default class InfoCommand extends ResolvedCommand<typeof InfoCommand> {
         stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'organization-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/info.js

@@ -23,6 +23,11 @@ Run 'blueprints stacks' to see all available Stacks in your project or organizat
         }),
         'project-id': Flags.string({ ...projectIdFlagConfig }),
         'organization-id': Flags.string({ ...organizationIdFlagConfig }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show resource and external IDs',
+            default: false,
+        }),
     };
     async run() {
         const result = await blueprintInfoCore({

package/dist/commands/blueprints/init.js

@@ -6,10 +6,9 @@ import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
 export default class InitCommand extends RuntimeCommand {
     static summary = 'Initialize a Blueprint and create a remote Stack';
     static description = `A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.
-[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]
 
 This is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.
-Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.
+Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. A .gitignore covering node_modules, .env, and Function build output is created or updated; the .sanity/ config itself is not ignored.
 
 After initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.
 

package/dist/commands/blueprints/logs.js

@@ -28,6 +28,7 @@ If you're not seeing expected logs, verify your Stack is deployed with 'blueprin
             char: 'w',
             description: 'Watch for new Stack logs',
             aliases: ['follow'],
+            exclusive: ['json'],
         }),
         limit: Flags.integer({
             char: 'l',

package/dist/commands/functions/add.js

@@ -23,7 +23,7 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
         example: Flags.string({
             description: 'Example to use for the Function',
             aliases: ['recipe'],
-            exclusive: ['name', 'fn-type', 'language', 'javascript', 'fn-helpers', 'fn-installer'],
+            exclusive: ['name', 'type', 'language', 'javascript', 'helpers', 'installer', 'install'],
         }),
         name: Flags.string({
             description: 'Name of the Function to add',
@@ -56,9 +56,9 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
             options: ['skip', ...INSTALLER_OPTIONS],
         }),
         install: Flags.boolean({
-            description: 'Shortcut for --fn-installer npm',
+            description: 'Shortcut for --installer npm',
             char: 'i',
-            exclusive: ['fn-installer'],
+            exclusive: ['installer'],
         }),
     };
     async run() {

package/dist/commands/functions/dev.js

@@ -9,11 +9,11 @@ export default class DevCommand extends ResolvedCommand {
 
 Open the emulator in your browser to interactively test your functions with the payload editor.
 
-Optionally, set the host and port with the --host and --port flags. Function timeout can be configured with the --timeout flag.
+Optionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.
 
 To invoke a function with the CLI, use 'functions test'.`;
     static examples = [
-        '<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974',
+        '<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 3333',
         '<%= config.bin %> <%= command.id %> --timeout 60',
     ];
     static flags = {

package/dist/commands/functions/logs.d.ts

@@ -15,5 +15,5 @@ export default class LogsCommand extends ResolvedCommand<typeof LogsCommand> {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         watch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<Record<string, unknown> | undefined>;
+    run(): Promise<void | Record<string, unknown>>;
 }

package/dist/commands/functions/logs.js

@@ -46,6 +46,7 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
             char: 'w',
             description: 'Watch for new logs (streaming mode)',
             aliases: ['follow'],
+            exclusive: ['json'],
         }),
     };
     async run() {
@@ -67,6 +68,8 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
         });
         if (!result.success)
             this.coreError(result);
+        if (result.streaming)
+            return result.streaming;
         return result.json;
     }
 }

package/dist/cores/blueprints/deploy.js

@@ -4,21 +4,21 @@ import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
 import { checkUserPermission } from '../../actions/sanity/access.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
-import { niceId } from '../../utils/display/presenters.js';
+import { check, niceId, severe } 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 { getWarnings } from '../../utils/warnings.js';
 export async function blueprintDeployCore(options) {
-    const { bin = 'sanity', log, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
+    const { bin = 'sanity', log: logger, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
     const { verbose } = flags;
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
     const installer = flags['fn-installer'] || undefined;
     const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
     const workspaceWarnings = getWarnings({ dir: blueprintFileDir });
-    log(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
+    logger(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
-        const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger: log });
+        const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger });
         if (!checkOk) {
             return { success: false, error: 'Failed to check current Stack status' };
         }
@@ -37,20 +37,20 @@ export async function blueprintDeployCore(options) {
         const preDeployResult = await preDeploy({
             scopeType,
             scopeId,
-            resources,
+            resources, // mutated by preDeploy
             stackId,
             stackName,
             auth,
             blueprintFileDir,
             installer,
-            log,
+            logger,
             bin,
             verbose,
+            onAssetEvent: createAssetEventHandler(logger),
         });
-        if (!preDeployResult?.success) {
+        if (!preDeployResult?.success)
             return preDeployResult;
-        }
-        const spinner = log.ora('Deploying...').start();
+        const deploySpinner = logger.ora('Deploying...').start();
         const { ok: deployOk, stack, error: deployError, } = await updateStack({
             stackId,
             stackMutation: {
@@ -61,10 +61,10 @@ export async function blueprintDeployCore(options) {
                 userMessage: flags.message,
             },
             auth,
-            logger: log,
+            logger,
         });
         if (!deployOk) {
-            spinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
+            deploySpinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
             const hints = createHintCollector(bin);
             if (deployError) {
                 hints.inspectMessage(deployError);
@@ -79,18 +79,18 @@ export async function blueprintDeployCore(options) {
                 ],
             };
         }
-        spinner.stop().clear();
+        deploySpinner.stop().clear();
         const legacyPermissionsNoticePromise = CHECK_LEGACY_DEPLOY_PERMISSION
             ? checkLegacyDeployPermission({
                 auth,
                 scopeType,
                 scopeId,
-                log,
+                log: logger,
             })
             : Promise.resolve(null);
         if (noWait) {
-            log(styleText(['bold', 'green'], 'Stack deployment started!'));
-            log(`Use \`npx ${bin} blueprints info\` to check status`);
+            logger(styleText(['bold', 'green'], 'Stack deployment started!'));
+            logger(`Use \`npx ${bin} blueprints info\` to check status`);
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -100,19 +100,19 @@ export async function blueprintDeployCore(options) {
                 warnings: warnings.length ? warnings : undefined,
             };
         }
-        log(styleText('dim', 'Stack deployment progress:'));
-        log('');
+        logger(styleText('dim', 'Stack deployment progress:'));
+        logger('');
         const outcome = await waitForOperation({
             stackId,
             operationId: stack.operationId,
             auth,
-            log,
+            log: logger,
             bin,
             verbose,
             progressNoun: 'deployment',
         });
         if (outcome.type === 'completed') {
-            log(styleText(['bold', 'green'], 'Stack deployment completed!'));
+            logger(styleText(['bold', 'green'], 'Stack deployment completed!'));
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -151,6 +151,56 @@ export async function blueprintDeployCore(options) {
         return { success: false, error: errorMessage };
     }
 }
+function createAssetEventHandler(logger) {
+    let spinner;
+    const results = [];
+    return (event) => {
+        switch (event.type) {
+            case 'progress': {
+                const { completed, total, slow } = event.progress;
+                const text = [
+                    `Processing assets (${completed}/${total})`,
+                    slow ? ', this can take a moment' : '',
+                ].join('');
+                if (spinner)
+                    spinner.text = text;
+                else
+                    spinner = logger.ora(text).start();
+                return;
+            }
+            case 'result': {
+                results.push(event.result);
+                return;
+            }
+            case 'complete': {
+                spinner?.stop();
+                spinner = undefined;
+                break;
+            }
+        }
+        // done. print report
+        for (const result of results) {
+            const { resource } = result;
+            if (!result.success) {
+                const summary = result.failureKind === 'upload'
+                    ? `Failed uploading ${resource.name} asset`
+                    : `Failed processing ${resource.name} asset`;
+                logger(` ${severe(summary)}`);
+                logger.error(`   ${result.error}`);
+                continue;
+            }
+            logger(` ${check(`${resource.name} ${niceId(resource.src)}`)}`);
+            logger(`   Source: ${resource.src}`);
+            if (result.hash) {
+                const hash = result.hash;
+                const h = hash.length > 24 ? `${hash.slice(0, 8)}...${hash.slice(-12)}` : hash;
+                logger.verbose(`   Hash: ${h}`);
+            }
+            if (result.exists)
+                logger.verbose('   Asset unchanged');
+        }
+    };
+}
 const CHECK_LEGACY_DEPLOY_PERMISSION = false;
 const BLUEPRINTS_PERMISSION_ENFORCEMENT_DATE = 'July 1, 2026';
 async function checkLegacyDeployPermission({ auth, scopeType, scopeId, log, }) {

package/dist/cores/functions/add.js

@@ -224,7 +224,7 @@ async function promptForFunctionName() {
     const functionName = await input({
         message: 'Enter function name:',
         validate: (input) => validateFunctionName(input) ||
-            'Invalid function name. Must be 6+ characters, no special characters, no spaces',
+            'Invalid function name. Must be 3+ characters, no special characters, no spaces',
     });
     return functionName;
 }

package/dist/utils/display/blueprints-formatting.js

@@ -72,15 +72,15 @@ function resourceName(res, displayNameAttribute) {
         nameParts.push(styleText('green', `"${displayName}"`));
     return nameParts.join(' ');
 }
-function deployedResourceName(res, displayNameAttribute, _verbose = false) {
+function deployedResourceName(res, displayNameAttribute, verbose = false) {
     const nameParts = [styleText(['bold', 'green'], res.name)];
     const displayName = displayNameAttribute &&
         typeof res.parameters[displayNameAttribute] === 'string' &&
         res.parameters[displayNameAttribute];
     if (displayName && displayName !== res.name)
         nameParts.push(styleText('green', `"${displayName}"`));
-    // if (verbose)
-    nameParts.push(idList(res));
+    if (verbose)
+        nameParts.push(idList(res));
     return nameParts.join(' ');
 }
 function idList(res) {

package/dist/utils/style-text.js

@@ -1,3 +1,4 @@
+// TODO: move to ./display
 import { env } from 'node:process';
 import { styleText as nodeStyleText } from 'node:util';
 import { isInteractive } from './interactive.js';

package/oclif.manifest.json

@@ -1,133 +1,5 @@
 {
   "commands": {
-    "blueprinit": {
-      "aliases": [],
-      "args": {},
-      "description": "Scaffolds a Blueprint, Studio, and starter function around an existing Sanity project.\n\nThis hidden command is an experiment; its interface and generated files are not stable.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --yes",
-        "<%= config.bin %> <%= command.id %> --project-id <id> --dataset <name> --yes"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "path": {
-          "aliases": [
-            "blueprint-path"
-          ],
-          "char": "p",
-          "description": "Path to a Blueprint file or directory containing one",
-          "env": "SANITY_BLUEPRINT_PATH",
-          "hidden": true,
-          "name": "path",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "trace": {
-          "description": "Trace output",
-          "hidden": true,
-          "name": "trace",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "validate-resources": {
-          "description": "Validate resources",
-          "hidden": true,
-          "name": "validate-resources",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "verbose": {
-          "description": "Verbose output",
-          "hidden": true,
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "llms": {
-          "aliases": [
-            "skill"
-          ],
-          "description": "Show agent-oriented guidance for this command",
-          "name": "llms",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "organization-id": {
-          "aliases": [
-            "organization",
-            "organizationId",
-            "org"
-          ],
-          "description": "Organization to use when the account has several",
-          "name": "organization-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "project-id": {
-          "aliases": [
-            "project",
-            "projectId"
-          ],
-          "description": "Project to use when the organization has several",
-          "name": "project-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dataset": {
-          "description": "Dataset to attach",
-          "name": "dataset",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "stack-name": {
-          "description": "Name for the new organization-scoped Stack",
-          "name": "stack-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "studio-name": {
-          "description": "Name and hosted slug for the Studio resource",
-          "name": "studio-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "blueprinit",
-      "pluginAlias": "@sanity/runtime-cli",
-      "pluginName": "@sanity/runtime-cli",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Experimental blueprints-first project init",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "blueprinit.js"
-      ]
-    },
     "blueprints:add": {
       "aliases": [],
       "args": {
@@ -501,7 +373,7 @@
     "blueprints:deploy": {
       "aliases": [],
       "args": {},
-      "description": "Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.\n\nExit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).",
+      "description": "Applies your local Blueprint to the remote Stack, creating, updating, or removing resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 180-second timeout for processing resource assets.\n\nSet SANITY_ASSET_CONCURRENCY to override how many resource assets are processed at once (default 4).\n\nExit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --message \"Enable staging dataset\"",
@@ -757,9 +629,7 @@
           "type": "option"
         },
         "force": {
-          "aliases": [
-            "f"
-          ],
+          "char": "f",
           "description": "Force Stack destruction (skip confirmation)",
           "name": "force",
           "allowNo": false,
@@ -909,8 +779,8 @@
           "type": "boolean"
         },
         "verbose": {
-          "description": "Verbose output",
-          "hidden": true,
+          "char": "v",
+          "description": "Show resource and external IDs",
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
@@ -983,7 +853,7 @@
           "name": "dir"
         }
       },
-      "description": "A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.\n[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]\n\nThis is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.\nAdditionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.\n\nAfter initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.\n\nRunning without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the current directory without a prompt.",
+      "description": "A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.\n\nThis is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.\nAdditionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. A .gitignore covering node_modules, .env, and Function build output is created or updated; the .sanity/ config itself is not ignored.\n\nAfter initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.\n\nRunning without a directory prompts to confirm the current directory. Run 'blueprints init .' to initialize in the current directory without a prompt.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> .",
@@ -1260,6 +1130,9 @@
           ],
           "char": "w",
           "description": "Watch for new Stack logs",
+          "exclusive": [
+            "json"
+          ],
           "name": "watch",
           "allowNo": false,
           "type": "boolean"
@@ -1896,11 +1769,12 @@
           "description": "Example to use for the Function",
           "exclusive": [
             "name",
-            "fn-type",
+            "type",
             "language",
             "javascript",
-            "fn-helpers",
-            "fn-installer"
+            "helpers",
+            "installer",
+            "install"
           ],
           "name": "example",
           "hasDynamicHelp": false,
@@ -1984,9 +1858,9 @@
         },
         "install": {
           "char": "i",
-          "description": "Shortcut for --fn-installer npm",
+          "description": "Shortcut for --installer npm",
           "exclusive": [
-            "fn-installer"
+            "installer"
           ],
           "name": "install",
           "allowNo": false,
@@ -2152,9 +2026,9 @@
     "functions:dev": {
       "aliases": [],
       "args": {},
-      "description": "Runs a local, web-based development server to test your functions before deploying.\n\nOpen the emulator in your browser to interactively test your functions with the payload editor.\n\nOptionally, set the host and port with the --host and --port flags. Function timeout can be configured with the --timeout flag.\n\nTo invoke a function with the CLI, use 'functions test'.",
+      "description": "Runs a local, web-based development server to test your functions before deploying.\n\nOpen the emulator in your browser to interactively test your functions with the payload editor.\n\nOptionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.\n\nTo invoke a function with the CLI, use 'functions test'.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974",
+        "<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 3333",
         "<%= config.bin %> <%= command.id %> --timeout 60"
       ],
       "flags": {
@@ -2538,6 +2412,9 @@
           ],
           "char": "w",
           "description": "Watch for new logs (streaming mode)",
+          "exclusive": [
+            "json"
+          ],
           "name": "watch",
           "allowNo": false,
           "type": "boolean"
@@ -3248,5 +3125,5 @@
       ]
     }
   },
-  "version": "17.4.0-blueprinit.g0ac8878"
+  "version": "17.5.0"
 }