@sanity/runtime-cli 17.1.0 → 17.2.0-blueprinit.g62f8017

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/17.1.0 linux-x64 node-v24.18.0
+@sanity/runtime-cli/17.2.0-blueprinit.g62f8017 linux-x64 node-v24.18.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -56,7 +56,7 @@ USAGE
 
 ```
 USAGE
-  $ sanity-run blueprints add TYPE [--json] [--example <value> | -n <value> | --fn-type
+  $ sanity-run blueprints add TYPE [--json] [--llms] [--example <value> | -n <value> | --fn-type
     document-publish|document-create|document-delete|document-update|media-library-asset-create|media-library-asset-dele
     te|media-library-asset-update|scheduled-function|sync-tag-invalidate... | --language ts|js | --javascript |
     --fn-helpers | --fn-installer skip|npm|pnpm|yarn] [-i | ]
@@ -81,6 +81,7 @@ FLAGS
       --json                   Format output as json
       --language=<option>      [default: ts] Language of the new function
                                <options: ts|js>
+      --llms                   Show agent-oriented guidance for this command
 
 DESCRIPTION
   [deprecated] Use "functions add" instead
@@ -103,7 +104,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -111,11 +112,13 @@ View or edit the local Blueprint configuration
 
 ```
 USAGE
-  $ sanity-run blueprints config [--json] [--stack <value> -e] [--project-id <value> ] [--organization-id <value> ]
+  $ sanity-run blueprints config [--json] [--llms] [--stack <value> -e] [--project-id <value> ] [--organization-id
+    <value> ]
 
 FLAGS
   -e, --edit                     Modify the configuration interactively, or directly when combined with ID flags.
       --json                     Format output as json
+      --llms                     Show agent-oriented guidance for this command
       --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
       --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
       --stack=<value>            Stack name or ID to set in the configuration. Requires --edit flag
@@ -140,7 +143,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -148,12 +151,13 @@ Deploy the local Blueprint to the remote Stack
 
 ```
 USAGE
-  $ sanity-run blueprints deploy [--json] [--stack <value>] [--project-id <value> | --organization-id <value>] [-m
-    <value>] [--no-wait] [--new-stack-name <value>]
+  $ sanity-run blueprints deploy [--json] [--llms] [--stack <value>] [--project-id <value> | --organization-id <value>]
+    [-m <value>] [--no-wait] [--new-stack-name <value>]
 
 FLAGS
   -m, --message=<value>          Message describing the deployment (e.g. reason for change)
       --json                     Format output as json
+      --llms                     Show agent-oriented guidance for this command
       --new-stack-name=<value>   Set a new name for the Stack
       --no-wait                  Do not wait for Stack deployment to complete
       --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
@@ -194,7 +198,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -202,12 +206,13 @@ Destroy a remote Stack deployment and its resources
 
 ```
 USAGE
-  $ sanity-run blueprints destroy [--json] [--project-id <value> --stack <value> --force] [--organization-id <value>  ]
-    [--no-wait]
+  $ sanity-run blueprints destroy [--json] [--llms] [--project-id <value> --stack <value> --force] [--organization-id
+    <value>  ] [--no-wait]
 
 FLAGS
   --force                    Force Stack destruction (skip confirmation)
   --json                     Format output as json
+  --llms                     Show agent-oriented guidance for this command
   --no-wait                  Do not wait for Stack destruction to complete
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
   --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
@@ -232,7 +237,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack <name-or-id> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -240,13 +245,13 @@ Diagnose potential issues with local Blueprint and remote Stack configuration
 
 ```
 USAGE
-  $ sanity-run blueprints doctor [--json] [-p <value>] [--verbose] [--fix]
+  $ sanity-run blueprints doctor [--json] [--llms] [-p <value>] [--fix]
 
 FLAGS
   -p, --path=<value>  [env: SANITY_BLUEPRINT_PATH] Path to a Blueprint file or directory containing one
       --fix           Interactively fix configuration issues
       --json          Format output as json
-      --[no-]verbose  Verbose output; defaults to true
+      --llms          Show agent-oriented guidance for this command
 
 DESCRIPTION
   Diagnose potential issues with local Blueprint and remote Stack configuration
@@ -257,13 +262,15 @@ DESCRIPTION
   Run this command when encountering errors with other Blueprint commands. Use --fix to interactively resolve detected
   issues.
 
+  Supports --json for programmatic consumption of diagnostic results.
+
 EXAMPLES
   $ sanity-run blueprints doctor
 
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -271,10 +278,11 @@ Display the status and resources of the remote Stack deployment
 
 ```
 USAGE
-  $ sanity-run blueprints info [--json] [--stack <value>] [--project-id <value> | --organization-id <value>]
+  $ sanity-run blueprints info [--json] [--llms] [--stack <value>] [--project-id <value> | --organization-id <value>]
 
 FLAGS
   --json                     Format output as json
+  --llms                     Show agent-oriented guidance for this command
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
   --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
   --stack=<value>            Stack name or ID
@@ -300,7 +308,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -308,8 +316,8 @@ Initialize a Blueprint and create a remote Stack
 
 ```
 USAGE
-  $ sanity-run blueprints init [DIR] [--json] [--dir <value>] [--example <value> | --blueprint-type json|js|ts |
-    --stack-id <value> | --stack-name <value>] [--project-id <value> | --organization-id <value>]
+  $ sanity-run blueprints init [DIR] [--json] [--llms] [--dir <value>] [--example <value> | --blueprint-type
+    json|js|ts | --stack-id <value> | --stack-name <value>] [--project-id <value> | --organization-id <value>]
 
 ARGUMENTS
   [DIR]  Directory to create the local Blueprint in (defaults to the current directory)
@@ -320,6 +328,7 @@ FLAGS
   --dir=<value>              Directory to create the local Blueprint in
   --example=<value>          Example to use for the local Blueprint
   --json                     Format output as json
+  --llms                     Show agent-oriented guidance for this command
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
   --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
   --stack-id=<value>         Existing Stack ID used to scope local Blueprint
@@ -364,7 +373,7 @@ EXAMPLES
   $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -372,14 +381,15 @@ Display logs for the current Blueprint's Stack deployment
 
 ```
 USAGE
-  $ sanity-run blueprints logs [--json] [--stack <value>] [--project-id <value> | --organization-id <value>] [-l
-    <value> | -w] [--since <value> | ] [--before <value> | ]
+  $ sanity-run blueprints logs [--json] [--llms] [--stack <value>] [--project-id <value> | --organization-id <value>]
+    [-l <value> | -w] [--since <value> | ] [--before <value> | ]
 
 FLAGS
   -l, --limit=<value>            Maximum number of log entries to retrieve (1-500)
   -w, --watch                    Watch for new Stack logs
       --before=<value>           Only show logs before this ISO 8601 timestamp
       --json                     Format output as json
+      --llms                     Show agent-oriented guidance for this command
       --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
       --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
       --since=<value>            Only show logs after this ISO 8601 timestamp
@@ -410,7 +420,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -418,13 +428,14 @@ Create a robot API token for deploying Blueprints from CI/CD
 
 ```
 USAGE
-  $ sanity-run blueprints mint-deploy-token [--project-id <value> | --organization-id <value>] [--label <value>] [-P |
-  --json]
+  $ sanity-run blueprints mint-deploy-token [--llms] [--project-id <value> | --organization-id <value>] [--label <value>] [-P |
+    --json]
 
 FLAGS
   -P, --print                    Print only the raw token to stdout (suitable for shell substitution)
       --json                     Format output as json
       --label=<value>            Human-readable label for the robot. Defaults to a generated value.
+      --llms                     Show agent-oriented guidance for this command
       --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
       --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
 
@@ -455,7 +466,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -463,10 +474,11 @@ Preview changes that will be applied to the remote Stack
 
 ```
 USAGE
-  $ sanity-run blueprints plan [--json] [--stack <value>] [--project-id <value> | --organization-id <value>]
+  $ sanity-run blueprints plan [--json] [--llms] [--stack <value>] [--project-id <value> | --organization-id <value>]
 
 FLAGS
   --json                     Format output as json
+  --llms                     Show agent-oriented guidance for this command
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
   --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
   --stack=<value>            Stack name or ID to use instead of the locally configured Stack
@@ -488,7 +500,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -496,12 +508,13 @@ Promote a Stack from project scope to organization scope
 
 ```
 USAGE
-  $ sanity-run blueprints promote [--json] [--stack <value>] [--project-id <value> | ] [--force] [--new-stack-name
-    <value>]
+  $ sanity-run blueprints promote [--json] [--llms] [--stack <value>] [--project-id <value> | ] [--force]
+    [--new-stack-name <value>]
 
 FLAGS
   --force                   Skip confirmation prompt
   --json                    Format output as json
+  --llms                    Show agent-oriented guidance for this command
   --new-stack-name=<value>  Set a new name for the Stack while promoting
   --project-id=<value>      Sanity project ID used to scope Blueprint and Stack
   --stack=<value>           Stack name or ID to promote
@@ -524,7 +537,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -532,11 +545,13 @@ List remote Stack deployments for your project or organization
 
 ```
 USAGE
-  $ sanity-run blueprints stacks [--json] [--project-id <value> | --organization-id <value> | --include-projects]
+  $ sanity-run blueprints stacks [--json] [--llms] [--project-id <value> | --organization-id <value> |
+    --include-projects]
 
 FLAGS
   --include-projects         Include Stacks from all projects within the organization. Requires --organization-id.
   --json                     Format output as json
+  --llms                     Show agent-oriented guidance for this command
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
   --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
 
@@ -560,7 +575,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -568,9 +583,9 @@ Add a Function to your Blueprint
 
 ```
 USAGE
-  $ sanity-run functions add [--json] [--example <value> | -n <value> |  | --language ts|js | --javascript |  | ]
-    [--type document-publish|document-create|document-delete|document-update|media-library-asset-create|media-library-as
-    set-delete|media-library-asset-update|scheduled-function|sync-tag-invalidate... ] [--helpers] [--installer
+  $ sanity-run functions add [--json] [--llms] [--example <value> | -n <value> |  | --language ts|js | --javascript
+    |  | ] [--type document-publish|document-create|document-delete|document-update|media-library-asset-create|media-lib
+    rary-asset-delete|media-library-asset-update|scheduled-function|sync-tag-invalidate... ] [--helpers] [--installer
     skip|npm|pnpm|yarn] [-i | ]
 
 FLAGS
@@ -584,6 +599,7 @@ FLAGS
       --json                Format output as json
       --language=<option>   [default: ts] Language of the new Function
                             <options: ts|js>
+      --llms                Show agent-oriented guidance for this command
       --type=<option>...    Document change event(s) that should trigger the function; you can specify multiple events
                             by specifying this flag multiple times
                             <options: document-publish|document-create|document-delete|document-update|media-library-ass
@@ -612,7 +628,7 @@ EXAMPLES
   $ sanity-run functions add --name my-function --type document-create --type document-update --lang js
 ```
 
-_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -620,7 +636,7 @@ Start the Sanity Function emulator
 
 ```
 USAGE
-  $ sanity-run functions dev [--json] [-h <value>] [-p <value>] [-t <value>]
+  $ sanity-run functions dev [--json] [--llms] [-h <value>] [-p <value>] [-t <value>]
 
 FLAGS
   -h, --host=<value>     The local network interface at which to listen. [default: "localhost"]
@@ -628,6 +644,7 @@ FLAGS
   -t, --timeout=<value>  Maximum execution time for all functions, in seconds. Takes precedence over function-specific
                          `timeout`
       --json             Format output as json
+      --llms             Show agent-oriented guidance for this command
 
 DESCRIPTION
   Start the Sanity Function emulator
@@ -647,7 +664,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -655,7 +672,7 @@ Add or set an environment variable for a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env add NAME KEY VALUE [--json]
+  $ sanity-run functions env add NAME KEY VALUE [--json] [--llms] [--stack <value>]
 
 ARGUMENTS
   NAME   The name of the Sanity Function
@@ -663,7 +680,9 @@ ARGUMENTS
   VALUE  The value of the environment variable
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --llms           Show agent-oriented guidance for this command
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   Add or set an environment variable for a deployed function
@@ -675,9 +694,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
+
+  $ 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.1.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -685,13 +706,15 @@ List environment variables for a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env list NAME [--json]
+  $ sanity-run functions env list NAME [--json] [--llms] [--stack <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --llms           Show agent-oriented guidance for this command
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   List environment variables for a deployed function
@@ -702,9 +725,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env list MyFunction
+
+  $ 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.1.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -712,14 +737,16 @@ Remove an environment variable from a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env remove NAME KEY [--json]
+  $ sanity-run functions env remove NAME KEY [--json] [--llms] [--stack <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
   KEY   The name of the environment variable
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --llms           Show agent-oriented guidance for this command
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   Remove an environment variable from a deployed function
@@ -731,9 +758,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
+
+  $ 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.1.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -741,7 +770,7 @@ Retrieve or delete logs for a Sanity Function
 
 ```
 USAGE
-  $ sanity-run functions logs [NAME] [--stack <value>] [-u] [-f [-d | -l <value> | --json]] [-w]
+  $ sanity-run functions logs [NAME] [--llms] [--stack <value>] [-u] [-f [-d | -l <value> | --json]] [-w]
 
 ARGUMENTS
   [NAME]  The name of the Sanity Function
@@ -753,6 +782,7 @@ FLAGS
   -u, --utc            Show dates in UTC time zone
   -w, --watch          Watch for new logs (streaming mode)
       --json           Format output as json
+      --llms           Show agent-oriented guidance for this command
       --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
@@ -773,7 +803,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -781,11 +811,11 @@ Invoke a local Sanity Function
 
 ```
 USAGE
-  $ sanity-run functions test [NAME] [--json] [--data-before <value> | [-d <value> | -f <value> | --document-id
-    <value>] |  |  | --file-before <value> | --file-after <value> | --document-id-before <value> | --document-id-after
-    <value>] [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>] [-a <value>]
-    [--with-user-token] [--media-library-id <value> | [--project-id <value> | --organization-id <value>] | --dataset
-    <value>]
+  $ sanity-run functions test [NAME] [--json] [--llms] [--data-before <value> | [-d <value> | -f <value> |
+    --document-id <value>] |  |  | --file-before <value> | --file-after <value> | --document-id-before <value> |
+    --document-id-after <value>] [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>] [-a
+    <value>] [--with-user-token] [--media-library-id <value> | [--project-id <value> | --organization-id <value>] |
+    --dataset <value>]
 
 ARGUMENTS
   [NAME]  The name of the Sanity Function
@@ -806,6 +836,7 @@ FLAGS
       --file-after=<value>          Current document
       --file-before=<value>         Original document
       --json                        Format output as json
+      --llms                        Show agent-oriented guidance for this command
       --media-library-id=<value>    Sanity Media Library ID to use
       --organization-id=<value>     Sanity organization ID used to scope Blueprint and Stack
       --project-id=<value>          Sanity project ID used to scope Blueprint and Stack
@@ -830,7 +861,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.1.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0-blueprinit.g62f8017/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: runtime-cli
+description: Use the Sanity Runtime CLI for Blueprints and Functions workflows. Use when an agent needs to run or explain sanity-run commands, especially unattended command flows, local Blueprint management, Stack operations, Function development, or the experimental blueprinit command.
+---
+
+# Sanity Runtime CLI
+
+Use `sanity-run <command> --help` for flags and arguments. Use
+`sanity-run <command> --llms` (or `--skill`) for the agent-oriented workflow and examples for that
+command.
+
+Read only the command skill relevant to the task:
+
+- `blueprinit` → `skills/blueprinit.md`
+- `blueprints deploy` → `skills/blueprints-deploy.md`
+- `functions test` → `skills/functions-test.md`
+
+Derive other filenames by joining the command words with hyphens.
+
+Command skills are added incrementally. If one is absent, inspect the command's `--help` output and
+the repository implementation before acting.

package/dist/actions/blueprinit/manifest.d.ts

@@ -0,0 +1,13 @@
+export declare const STARTER_DOCUMENT_TYPE = "post";
+export declare const STARTER_FUNCTION_NAME = "set-slug";
+export interface BlueprintManifestOptions {
+    projectName: string;
+    displayName: string;
+    projectId: string;
+    datasetName: string;
+    studioName: string;
+    studioSrc: string;
+    withFunction: boolean;
+}
+export declare function renderBlueprint(options: BlueprintManifestOptions): string;
+export declare function slugify(value: string): string;

package/dist/actions/blueprinit/manifest.js

@@ -0,0 +1,57 @@
+const quote = (value) => `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+export const STARTER_DOCUMENT_TYPE = 'post';
+export const STARTER_FUNCTION_NAME = 'set-slug';
+export function renderBlueprint(options) {
+    const { projectName, displayName, projectId, datasetName, studioName, studioSrc, withFunction } = options;
+    const definers = ['defineBlueprint', 'defineDataset', 'defineProject', 'defineStudio'];
+    if (withFunction)
+        definers.splice(2, 0, 'defineDocumentFunction');
+    const functionResource = withFunction
+        ? `    defineDocumentFunction({
+      name: ${quote(STARTER_FUNCTION_NAME)},
+      project: ${quote(projectId)},
+      event: {
+        on: ['create', 'update'],
+        filter: "_type == '${STARTER_DOCUMENT_TYPE}' && !defined(slug.current)",
+        projection: '{_id, title, slug}',
+      },
+    }),
+`
+        : '';
+    // Project references stay literal until the deploy API can resolve resource references here.
+    return `import {${definers.join(', ')}} from '@sanity/blueprints'
+
+export default defineBlueprint({
+  resources: [
+    defineProject({
+      name: ${quote(projectName)},
+      displayName: ${quote(displayName)},
+      lifecycle: {
+        deletionPolicy: 'retain',
+        ownershipAction: {type: 'attach', id: ${quote(projectId)}},
+      },
+    }),
+    defineDataset({
+      name: ${quote(datasetName)},
+      project: ${quote(projectId)},
+      lifecycle: {
+        deletionPolicy: 'retain',
+        ownershipAction: {type: 'attach', id: ${quote(datasetName)}, projectId: ${quote(projectId)}},
+      },
+    }),
+    defineStudio({
+      name: ${quote(studioName)},
+      src: ${quote(studioSrc)},
+      autoUpdates: {enabled: true},
+      project: ${quote(projectId)},
+    }),
+${functionResource}  ],
+})
+`;
+}
+export function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}

package/dist/actions/blueprinit/studio.d.ts

@@ -0,0 +1,6 @@
+export interface DetectedStudio {
+    configFile: string;
+    projectId?: string;
+    dataset?: string;
+}
+export declare function detectStudio(dir: string): DetectedStudio | undefined;

package/dist/actions/blueprinit/studio.js

@@ -0,0 +1,43 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const STUDIO_CONFIG_PATTERN = /^sanity\.config\.[cm]?[jt]sx?$/;
+const STUDIO_CLI_PATTERN = /^sanity\.cli\.[cm]?[jt]sx?$/;
+export function detectStudio(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isFile())
+            .map((entry) => entry.name);
+    }
+    catch {
+        return undefined;
+    }
+    const configFile = entries.find((name) => STUDIO_CONFIG_PATTERN.test(name));
+    if (!configFile)
+        return undefined;
+    const detected = { configFile };
+    const cliFile = entries.find((name) => STUDIO_CLI_PATTERN.test(name));
+    for (const file of [configFile, cliFile]) {
+        if (!file)
+            continue;
+        const source = readSource(join(dir, file));
+        if (!source)
+            continue;
+        detected.projectId ??= extractLiteral(source, 'projectId');
+        detected.dataset ??= extractLiteral(source, 'dataset');
+        if (detected.projectId && detected.dataset)
+            break;
+    }
+    return detected;
+}
+function readSource(filePath) {
+    try {
+        return readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractLiteral(source, key) {
+    return source.match(new RegExp(`\\b${key}\\s*:\\s*(['"\`])([^'"\`\\\\]+)\\1`))?.[2];
+}