@sanity/runtime-cli 14.10.0 → 14.10.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/14.10.0 linux-x64 node-v24.14.1
+@sanity/runtime-cli/14.10.1 linux-x64 node-v24.14.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -101,7 +101,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/v14.10.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/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/v14.10.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -182,7 +182,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --fn-installer npm
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -218,7 +218,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/v14.10.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -250,7 +250,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -282,7 +282,7 @@ EXAMPLES
   $ sanity-run blueprints info --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -336,7 +336,7 @@ EXAMPLES
   $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -367,7 +367,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -395,7 +395,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -427,7 +427,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -480,7 +480,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/v14.10.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -516,7 +516,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -547,7 +547,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/v14.10.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -575,7 +575,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -605,7 +605,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/v14.10.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -647,7 +647,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -705,7 +705,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/v14.10.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.10.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/logs-streaming.d.ts

@@ -8,6 +8,7 @@ export interface LogStreamingConfig {
     verbose?: boolean;
     log: Logger;
     onActivity?: () => void;
+    onLogEntry?: (log: BlueprintLog) => void;
 }
 export interface StreamLogsOptions {
     stackId: string;

package/dist/actions/blueprints/logs-streaming.js

@@ -80,6 +80,7 @@ export async function setupLogStreaming(config) {
             return;
         newestTimestamp = new Date(logEntry.timestamp).getTime();
         config.onActivity?.();
+        config.onLogEntry?.(logEntry);
         log(formatLogEntry(logEntry, verbose, previousLog));
         previousLog = logEntry;
     };

package/dist/cores/blueprints/deploy.js

@@ -2,6 +2,7 @@ import { setTimeout as sleep } from 'node:timers/promises';
 import { stashAsset } from '../../actions/blueprints/assets.js';
 import { setupLogStreaming } from '../../actions/blueprints/logs-streaming.js';
 import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
+import { createLogHintCollector } from '../../utils/blueprints/log-hints.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 import { isAssetResource } from '../../utils/types.js';
@@ -81,6 +82,7 @@ export async function blueprintDeployCore(options) {
             };
         }
         log(styleText('dim', 'Stack deployment progress:'));
+        const logHints = createLogHintCollector(bin);
         let logStreamCleanup = null;
         try {
             let lastLogAt = Date.now();
@@ -94,6 +96,7 @@ export async function blueprintDeployCore(options) {
                 onActivity: () => {
                     lastLogAt = Date.now();
                 },
+                onLogEntry: (logEntry) => logHints.inspect(logEntry),
             });
             while (true) {
                 const { ok, stack: currentStack } = await getStack({ stackId: stack.id, auth, logger: log });
@@ -122,6 +125,7 @@ export async function blueprintDeployCore(options) {
                         success: false,
                         error: 'Stack deployment failed',
                         suggestions: [
+                            ...logHints.getSuggestions(),
                             `Run \`npx ${bin} blueprints logs\` to review deployment logs.`,
                             `Run \`npx ${bin} blueprints plan\` to identify issues with your Blueprint.`,
                         ],

package/dist/cores/blueprints/destroy.js

@@ -2,6 +2,7 @@ import { setTimeout as sleep } from 'node:timers/promises';
 import { confirm } from '@inquirer/prompts';
 import { setupLogStreaming } from '../../actions/blueprints/logs-streaming.js';
 import { destroyStack, getStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
+import { createLogHintCollector } from '../../utils/blueprints/log-hints.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 export async function blueprintDestroyCore(options) {
@@ -103,6 +104,7 @@ export async function blueprintDestroyCore(options) {
             return { success: true, json: { stackId: stack.id, stackName: stack.name } };
         }
         log(styleText('dim', 'Stack destruction progress:'));
+        const logHints = createLogHintCollector(bin);
         let logStreamCleanup = null;
         try {
             let lastLogAt = Date.now();
@@ -115,6 +117,7 @@ export async function blueprintDestroyCore(options) {
                 onActivity: () => {
                     lastLogAt = Date.now();
                 },
+                onLogEntry: (logEntry) => logHints.inspect(logEntry),
             });
             while (true) {
                 const { ok, stack: currentStack } = await getStack({ stackId: stack.id, auth, logger: log });
@@ -134,6 +137,7 @@ export async function blueprintDestroyCore(options) {
                         success: false,
                         error: 'Stack destruction failed',
                         suggestions: [
+                            ...logHints.getSuggestions(),
                             `Run \`npx ${bin} blueprints logs\` to review destruction logs.`,
                             `Run \`npx ${bin} blueprints info\` to view current Stack status.`,
                         ],

package/dist/utils/blueprints/log-hints.d.ts

@@ -0,0 +1,25 @@
+import type { BlueprintLog } from '../types.js';
+/**
+ * A pattern that matches a log message and produces oclif suggestions
+ * The regex is tested against `BlueprintLog.message`
+ * capture groups are forwarded to the factory so suggestions can include dynamic values
+ */
+type LogHintPattern = [RegExp, (match: RegExpMatchArray, bin: string) => string[]];
+/**
+ * Patterns matched against ERROR/FATAL log entries during streaming operations
+ * like deploy and destroy. Each entry is a [regex, suggestionFactory] tuple.
+ *
+ * Add new patterns here -- no other code changes required.
+ */
+export declare const LOG_HINT_PATTERNS: LogHintPattern[];
+/**
+ * Creates a collector to create suggestions
+ * Use getSuggestions() after all logs are inspected
+ */
+export declare function createLogHintCollector(bin: string): {
+    /** Check a log entry against hint patterns; only ERROR/FATAL levels are inspected. */
+    inspect(log: BlueprintLog): void;
+    /** Return unique collected suggestions. */
+    getSuggestions(): string[];
+};
+export {};

package/dist/utils/blueprints/log-hints.js

@@ -0,0 +1,46 @@
+/**
+ * Patterns matched against ERROR/FATAL log entries during streaming operations
+ * like deploy and destroy. Each entry is a [regex, suggestionFactory] tuple.
+ *
+ * Add new patterns here -- no other code changes required.
+ */
+export const LOG_HINT_PATTERNS = [
+    [
+        // tester
+        /\[TEST\] '(.+)' TEST/,
+        (match) => [`TEST SUGGESTION for '${match[1]}'.`],
+    ],
+    [
+        // Function requires organization scope
+        /\[Functions\] Failed.+: (.+must be attached to an organization scoped stack)/,
+        (_match, bin) => [
+            `Run \`npx ${bin} blueprints promote\` to move from project to organization scope.`,
+        ],
+    ],
+];
+/**
+ * Creates a collector to create suggestions
+ * Use getSuggestions() after all logs are inspected
+ */
+export function createLogHintCollector(bin) {
+    const collected = [];
+    return {
+        /** Check a log entry against hint patterns; only ERROR/FATAL levels are inspected. */
+        inspect(log) {
+            const level = log.level.toUpperCase();
+            if (level !== 'ERROR' && level !== 'FATAL')
+                return;
+            for (const [pattern, factory] of LOG_HINT_PATTERNS) {
+                const match = log.message.match(pattern);
+                if (match) {
+                    collected.push(...factory(match, bin));
+                    break; // first matching pattern wins per entry
+                }
+            }
+        },
+        /** Return unique collected suggestions. */
+        getSuggestions() {
+            return [...new Set(collected)];
+        },
+    };
+}

package/oclif.manifest.json

@@ -2247,5 +2247,5 @@
       ]
     }
   },
-  "version": "14.10.0"
+  "version": "14.10.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "14.10.0",
+  "version": "14.10.1",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",