@sanity/runtime-cli 17.1.0-next.gcfbd613 → 17.2.0-blueprinit.g3a96975

package/oclif.manifest.json

@@ -1,5 +1,111 @@
 {
   "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"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "name": "llms",
+          "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"
+        },
+        "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"
+        }
+      },
+      "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": {
@@ -30,6 +136,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -258,6 +374,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -390,6 +516,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -535,6 +671,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -668,6 +814,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -742,6 +898,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -864,6 +1030,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1045,6 +1221,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1197,6 +1383,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1322,6 +1518,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1431,6 +1637,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1557,6 +1773,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1677,6 +1903,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -1890,6 +2126,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2025,6 +2271,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2169,6 +2425,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2337,6 +2603,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2655,7 +2931,8 @@
       },
       "description": "Sets an environment variable in a deployed Sanity Function. If the variable already exists, its value is updated.\n\nEnvironment variables are useful for API keys, configuration values, and other secrets that shouldn't be hardcoded. Changes take effect on the next function invocation.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> MyFunction API_URL https://api.example.com/"
+        "<%= config.bin %> <%= command.id %> MyFunction API_URL https://api.example.com/",
+        "<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction API_URL https://api.example.com/"
       ],
       "flags": {
         "json": {
@@ -2664,6 +2941,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2700,7 +2987,6 @@
         },
         "stack": {
           "description": "Stack name or ID to use instead of the locally configured Stack",
-          "hidden": true,
           "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2771,7 +3057,8 @@
       },
       "description": "Displays all environment variables (keys only) configured in a deployed Sanity Function.\n\nUse 'functions env add' to set variables or 'functions env remove' to delete them.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> MyFunction"
+        "<%= config.bin %> <%= command.id %> MyFunction",
+        "<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction"
       ],
       "flags": {
         "json": {
@@ -2780,6 +3067,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2816,7 +3113,6 @@
         },
         "stack": {
           "description": "Stack name or ID to use instead of the locally configured Stack",
-          "hidden": true,
           "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2892,7 +3188,8 @@
       },
       "description": "Deletes an environment variable from a deployed Sanity Function. The change takes effect on the next function invocation.\n\nUse 'functions env list' to see current variables before removing.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> MyFunction API_URL"
+        "<%= config.bin %> <%= command.id %> MyFunction API_URL",
+        "<%= config.bin %> <%= command.id %> --stack <name-or-id> MyFunction API_URL"
       ],
       "flags": {
         "json": {
@@ -2901,6 +3198,16 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "llms": {
+          "aliases": [
+            "skill"
+          ],
+          "description": "Show agent-oriented guidance for this command",
+          "hidden": true,
+          "name": "llms",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "path": {
           "aliases": [
             "blueprint-path"
@@ -2937,7 +3244,6 @@
         },
         "stack": {
           "description": "Stack name or ID to use instead of the locally configured Stack",
-          "hidden": true,
           "name": "stack",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2998,5 +3304,5 @@
       ]
     }
   },
-  "version": "17.1.0-next.gcfbd613"
+  "version": "17.2.0-blueprinit.g3a96975"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.1.0-next.gcfbd613",
+  "version": "17.2.0-blueprinit.g3a96975",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -26,7 +26,9 @@
   "files": [
     "./bin",
     "./dist",
-    "./oclif.manifest.json"
+    "./oclif.manifest.json",
+    "./SKILL.md",
+    "./skills"
   ],
   "bin": {
     "sanity-run": "bin/run.js"
@@ -40,7 +42,9 @@
     "clean": "shx rm -rf dist oclif.manifest.json",
     "copy:design-tokens": "shx rm -rf ./src/server/static/vendor/design-tokens && shx cp -r ./node_modules/@sanity-labs/design-tokens/dist/css ./src/server/static/vendor/design-tokens",
     "copy:server": "shx cp -r ./src/server/static ./dist/server",
-    "copy:wrapper": "shx cp ./src/utils/functions/child-process-wrapper.js ./dist/utils/functions/child-process-wrapper.js",
+    "copy:wrapper": "npm run copy:wrapper:entry && npm run copy:wrapper:modules",
+    "copy:wrapper:entry": "shx cp ./src/utils/functions/child-process-wrapper.js ./dist/utils/functions/child-process-wrapper.js",
+    "copy:wrapper:modules": "shx rm -rf ./dist/utils/functions/child-runtime && shx cp -r ./src/utils/functions/child-runtime ./dist/utils/functions/child-runtime",
     "lint": "biome ci",
     "lint:write": "biome check --write",
     "lint:fix": "npm run lint:write",
@@ -64,8 +68,10 @@
     "@oclif/core": "^4.11.14",
     "@oclif/plugin-help": "^6.2.53",
     "@sanity-labs/design-tokens": "^0.0.2-alpha.2",
-    "@sanity/blueprints": "^0.22.0",
+    "@sanity/blueprints": "^0.23.0",
     "@sanity/blueprints-parser": "^0.4.0",
+    "@sanity/cli-build": "^5.0.0",
+    "@sanity/cli-core": "^2.5.1",
     "@sanity/client": "^7.23.1",
     "adm-zip": "^0.6.0",
     "array-treeify": "^0.1.5",
@@ -78,6 +84,7 @@
     "ora": "^9.4.1",
     "signal-exit": "^4.1.0",
     "strip-ansi": "^7.2.0",
+    "tar-fs": "^3.1.3",
     "tar-stream": "^3.2.0",
     "vite": "^8.1.4",
     "ws": "^8.21.1",
@@ -97,6 +104,7 @@
     "@types/cardinal": "^2.1.1",
     "@types/mime-types": "^3.0.1",
     "@types/node": "^22",
+    "@types/tar-fs": "^2.0.4",
     "@types/tar-stream": "^3.1.4",
     "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "4.1.10",

package/skills/blueprinit.md

@@ -0,0 +1,137 @@
+# Blueprinit
+
+Use `blueprinit` to scaffold a Blueprint around an existing Sanity project. The command is
+experimental, hidden from root help, and available from the `blueprinit` npm dist-tag.
+
+Use it for demos and evaluation, not as a stable project initializer. Its flags, generated files,
+and resource model may change.
+
+## Know what it does
+
+`blueprinit` uses an existing Sanity organization, project, and dataset. It writes local Blueprint
+files, then creates an empty organization-scoped Stack. The generated Blueprint attaches the
+project and dataset and declares resources for a later deployment.
+
+It does not create an organization, project, or dataset. It does not deploy the attached resources,
+Studio, or Function. Those changes happen only if `blueprints deploy` is run later.
+
+## Inspect the target directory
+
+Run the command from the directory that should contain the Blueprint.
+
+Before running:
+
+1. Check the working tree and existing files. Do not discard unrelated user changes.
+2. Look for a root `sanity.blueprint.*` file. If one exists, use the existing Blueprint instead of
+   initializing again.
+3. Look for a root `sanity.config.*` file. Its presence selects the Studio adoption flow.
+4. Confirm the user asked to initialize this directory. The command writes files and creates a
+   remote Stack.
+5. Confirm the user is signed in. If needed, have them run:
+
+```sh
+npx sanity login
+```
+
+The account must have at least one organization, one project in the selected organization, and one
+dataset in the selected project.
+
+## Choose the flow
+
+- **Existing Blueprint:** Exit without changes and use `blueprints config --edit` or
+  `blueprints doctor`.
+- **Root Studio config:** Adopt the Studio in place. Read literal `projectId` and `dataset` strings
+  from `sanity.config.*`, falling back to `sanity.cli.*`. Do not move the Studio.
+- **Fresh workspace:** Create a Blueprint, an npm-workspace Studio, and a starter `set-slug`
+  document function.
+
+Do not rewrite a Studio config merely to make adoption work unless the user asks. Dynamic
+`projectId` or `dataset` values built from environment variables or imports cannot be detected.
+
+For an existing Blueprint, inspect it with:
+
+```sh
+npx @sanity/runtime-cli@blueprinit blueprints doctor
+```
+
+## Run unattended
+
+When the organization and project IDs are known, run this from the target directory:
+
+```sh
+npx @sanity/runtime-cli@blueprinit blueprinit --yes \
+  --organization-id <organization-id> \
+  --project-id <project-id>
+```
+
+Replace both placeholders with real IDs. The project must belong to the organization. Do not guess
+either value.
+
+`--yes` skips confirmation and uses `studio` as the Studio name. Without explicit IDs, an
+unattended run stops when the account has several organizations or projects. Ask the user for the
+IDs or have them run the command interactively.
+
+For interactive organization, project, confirmation, and Studio-name prompts, have the user run:
+
+```sh
+npx @sanity/runtime-cli@blueprinit blueprinit
+```
+
+There is no dataset flag. The command uses `production` when present, otherwise the first dataset
+returned for the project. Report the selected dataset from the command output.
+
+## Review the result
+
+A successful fresh run creates or updates:
+
+```text
+.
+├── .sanity/blueprint.config.json
+├── sanity.blueprint.ts
+├── package.json
+├── functions/
+│   └── set-slug/
+└── studios/
+    └── studio/
+```
+
+The command also creates or updates `.gitignore`. It preserves existing package metadata and adds
+the required npm workspaces and `@sanity/blueprints` dependency.
+
+An adopted Studio stays at the repository root. The command adds the Blueprint, Blueprint config,
+dependency, and `.gitignore` entry, but does not generate the starter Function.
+
+After the command exits:
+
+1. Confirm the output names the expected organization, project, and dataset.
+2. Confirm `.sanity/blueprint.config.json` exists. Its presence means Stack creation completed.
+3. Review `sanity.blueprint.ts`, `package.json`, `.gitignore`, and the working-tree diff.
+4. Report the Stack ID and every created or modified path.
+
+Do not deploy as part of initialization unless the user separately asks for deployment. To continue
+after reviewing the scaffold, install dependencies and preview the deployment:
+
+```sh
+npm install
+npx @sanity/runtime-cli@blueprinit blueprints plan
+```
+
+Treat dependency installation and planning as separate follow-up actions when they were not part of
+the user's request.
+
+## Handle failures
+
+- **`No Sanity session found.`** Stop and ask the user to run `npx sanity login`. Authentication
+  fails before files are written.
+- **Multiple organizations or projects found.** Rerun with the matching `--organization-id` and
+  `--project-id`. Selection fails before files are written.
+- **No datasets found.** Ask the user to create or choose a project with a dataset. The command does
+  not create datasets.
+- **Could not read `projectId` and `dataset`.** The detected Studio config does not contain both
+  values as string literals. Report the config file and let the user decide whether to change it.
+- **Refusing to overwrite an existing path.** Inspect the reported Studio or Function directory.
+  Do not delete or replace it without the user's direction.
+- **Stack quota or duplicate-name error.** Local scaffold files may already exist while
+  `.sanity/blueprint.config.json` does not. Stop and report the partial state. Do not fabricate a
+  config file or blindly rerun: the command has no partial-failure recovery flow, and the generated
+  Blueprint makes a rerun exit as already initialized.