@orkestrel/scaffold 0.0.97 → 0.0.99

package/dist/host/manifest.json

@@ -16,7 +16,7 @@
 			"storage": "agents/orchestration.md",
 			"destination": ".agents/orchestration.md",
 			"executable": false,
-			"digest": "b31dfd8ec22606bf3d98ca2f32241c7f43d2537be49400c4b801028b4178bac0"
+			"digest": "8e4da9963c7e33a3fc58f6bf5c70d98aacf9a0cb451da8e1a0868034345ed04c"
 		},
 		{
 			"storage": "agents/skills/enterprise-bootstrap/SKILL.md",
@@ -136,7 +136,7 @@
 			"storage": "agents/skills/orkestrel-debrief/references/instruction-audit.md",
 			"destination": ".agents/skills/orkestrel-debrief/references/instruction-audit.md",
 			"executable": false,
-			"digest": "594e06e58d17e08206e1cac7a08469903e4b9a7575aaba38607c572d08955d5a"
+			"digest": "c7002c36743cdb4f1edc8ca75d9686607a6713c5c733a98c41d082041ab5779b"
 		},
 		{
 			"storage": "agents/skills/orkestrel-debrief/references/retention.md",
@@ -160,7 +160,7 @@
 			"storage": "agents/skills/orkestrel-dispatch/references/bench.md",
 			"destination": ".agents/skills/orkestrel-dispatch/references/bench.md",
 			"executable": false,
-			"digest": "63481819027b239adf3ce1bcbd879c440e7ee12c3d56ee10a1c439d4a1f58ce8"
+			"digest": "cad78c5ac41116d86740306f905582a322a26e279da7b733d9b95a80c16cabeb"
 		},
 		{
 			"storage": "agents/skills/orkestrel-dispatch/references/launch.md",
@@ -172,7 +172,7 @@
 			"storage": "agents/skills/orkestrel-dispatch/scripts/bench.ts",
 			"destination": ".agents/skills/orkestrel-dispatch/scripts/bench.ts",
 			"executable": false,
-			"digest": "a9bfce5def80e3b6917c76070c63c3a54ca9c0d1df62d62973b74b0dcd6224a2"
+			"digest": "952b12697e01f722fa50246718142987d1682bf3845a90b38e1255fa0ee609c4"
 		},
 		{
 			"storage": "agents/skills/orkestrel-dispatch/scripts/brief.ts",
@@ -220,7 +220,7 @@
 			"storage": "agents/skills/orkestrel-falsify/SKILL.md",
 			"destination": ".agents/skills/orkestrel-falsify/SKILL.md",
 			"executable": false,
-			"digest": "257ac6f56380decb55cb0ab7f2c2285f34474ba1a4b2944609c04218f4c9d013"
+			"digest": "d7d60fb440c3a66f8c913a4ed4f1c527f53ee4e5e8e5151b1c403677baa61c70"
 		},
 		{
 			"storage": "agents/skills/orkestrel-falsify/agents/openai.yaml",
@@ -238,7 +238,7 @@
 			"storage": "agents/skills/orkestrel-falsify/references/reconcile.md",
 			"destination": ".agents/skills/orkestrel-falsify/references/reconcile.md",
 			"executable": false,
-			"digest": "53a48ef8c9913bfcd965b1de2234ebe4b7f71e6e7a6e81fdbb55dca4ac744d87"
+			"digest": "4b7de68d05a28d50380cfbccdda27abbe230df249ea9d7f49ca875f41ea9ba35"
 		},
 		{
 			"storage": "agents/skills/orkestrel-harden/SKILL.md",
@@ -370,7 +370,7 @@
 			"storage": "agents/skills/orkestrel-publish/references/wave.md",
 			"destination": ".agents/skills/orkestrel-publish/references/wave.md",
 			"executable": false,
-			"digest": "68f5df5747f2b5cbd950413ce3e4a070ef5be229a79811711192763cd70d73fa"
+			"digest": "7aa0046c335d1728a3a4656757c19f096570970369eb04ca0377dcaf250d0901"
 		},
 		{
 			"storage": "agents/skills/orkestrel-publish/references/window.md",
@@ -406,7 +406,7 @@
 			"storage": "agents/skills/orkestrel-scout/SKILL.md",
 			"destination": ".agents/skills/orkestrel-scout/SKILL.md",
 			"executable": false,
-			"digest": "e42e0b06a0cc647b8f13f7bf033ed6b2800e13e61298e9a0d2f2d22688e5011a"
+			"digest": "17854ecdcb08c097b4d1e741764d535da8707267f560de16485fb758ee851302"
 		},
 		{
 			"storage": "agents/skills/orkestrel-scout/agents/openai.yaml",
@@ -418,7 +418,7 @@
 			"storage": "agents/skills/orkestrel-scout/scripts/map.ts",
 			"destination": ".agents/skills/orkestrel-scout/scripts/map.ts",
 			"executable": false,
-			"digest": "a9572e59598a9db3a6725861475e84459c620affa584933eb6cc59b2f8f4bbe3"
+			"digest": "45185a31d410513654547166e3d38f3da75c64d55c964b9eff95c39531451f0d"
 		},
 		{
 			"storage": "agents/templates/brief.md",
@@ -430,103 +430,103 @@
 			"storage": "agents/transports/claude-cli.md",
 			"destination": ".agents/transports/claude-cli.md",
 			"executable": false,
-			"digest": "cef2e96c822c7fd076703204d8c3e6192cd9c575f6527e272dde29dc6e53df32"
+			"digest": "2f5edf8c3395b29670d60e01aaf43eacd4f73c0a2b745f1e6f24da98f829af0a"
 		},
 		{
 			"storage": "agents/transports/codex.md",
 			"destination": ".agents/transports/codex.md",
 			"executable": false,
-			"digest": "d3c725c68b9260112fd15b3e724c581c223b6ddc80cb1436d3727a860749bce8"
+			"digest": "aa6c00f677ca4c1c40a402770aa21ec739ed7266e15f5d0e6cb8a8ca9e914e80"
 		},
 		{
 			"storage": "agents/transports/cursor.md",
 			"destination": ".agents/transports/cursor.md",
 			"executable": false,
-			"digest": "2c3063adbac28be4942398dad5c004a083d6018de95042bb2ae1f48ecd4a3f35"
+			"digest": "aac0d62e222e2b193fe08fb69efbe016a8cf3ddde29c4c493c84428c947c3167"
 		},
 		{
 			"storage": "claude/AGENTS.md",
 			"destination": ".claude/AGENTS.md",
 			"executable": false,
-			"digest": "9047a8df9cea1fdaae4b31a8ad14e54ba1ecf5de89eba8bf89939627553cead2"
+			"digest": "ab0a30f3dcf2b470ec2d85544b128587841a610217aa058aab09c10947915a98"
 		},
 		{
 			"storage": "claude/agents/analyst.md",
 			"destination": ".claude/agents/analyst.md",
 			"executable": false,
-			"digest": "e1d7e4202b293ff7d8d934e95d1c499845f0f49729180077f417864dc179c84b"
+			"digest": "6ad7895912fbfbdca3821132067d6c2993ace0a09bcc34d9f0a87b53d82d999b"
 		},
 		{
 			"storage": "claude/agents/astra.md",
 			"destination": ".claude/agents/astra.md",
 			"executable": false,
-			"digest": "4edd588c849f7bb9a3405096e935e5ff3ac0cc3391646a07f0d0f32efb12c41c"
+			"digest": "475af39fe97fc76836d969c66cab9cfb79f15d078b8668925236ef267cdd1c0c"
 		},
 		{
 			"storage": "claude/agents/builder.md",
 			"destination": ".claude/agents/builder.md",
 			"executable": false,
-			"digest": "a437e3410c183e7df6a7c5c007b72746111fc29771bb8c7116ee0a6d1ffab479"
+			"digest": "36bd7f5c6f2f57eaefca60f1743315f725f0604e77af8a81f217c2f0253252bf"
 		},
 		{
 			"storage": "claude/agents/checker.md",
 			"destination": ".claude/agents/checker.md",
 			"executable": false,
-			"digest": "7c57d1a025a2a88531dc3faefd9bf3c766ef76d309eae7778d1eef6f6db550e4"
+			"digest": "0b9cb8ebb287e80c52d653226f3b46a5e5e4fec4233a666d5f20d8a6a27e8ddc"
 		},
 		{
 			"storage": "claude/agents/distiller.md",
 			"destination": ".claude/agents/distiller.md",
 			"executable": false,
-			"digest": "03a38c07e45f19d925457cc3477de15b65701fab0f71f015acec0add55d1d7d2"
+			"digest": "a54a0534be8684a31741a6a9d1e56e083897a08bda09019fa5682c143e2677c2"
 		},
 		{
 			"storage": "claude/agents/grok.md",
 			"destination": ".claude/agents/grok.md",
 			"executable": false,
-			"digest": "6798fabf3a71e9514d8f33d7c310b7f20647951a0b847b11eee96f4150fb3e83"
+			"digest": "6f6a46a001f7cf32ecaa2395b2cad58bf1d9cee211f6da197e7fc593a9982df2"
 		},
 		{
 			"storage": "claude/agents/opus.md",
 			"destination": ".claude/agents/opus.md",
 			"executable": false,
-			"digest": "fc7a53b4d387ffdc7df51d31e7252c222d1ec539caca31c7ceee672c39f18042"
+			"digest": "007d5c173f8a0c9431aa2717a8571dfcefb65ae86fd277a20eaf7781d70935af"
 		},
 		{
 			"storage": "claude/agents/orkestrel.md",
 			"destination": ".claude/agents/orkestrel.md",
 			"executable": false,
-			"digest": "45b2b7db03fb405888baab95eb966efecbb31506755cc7e3a003152828d6b008"
+			"digest": "70f83a325d00ec5e8f72866c22a867c22747d9f8ac3ed2ad844a9af7cba6dd93"
 		},
 		{
 			"storage": "claude/agents/planner.md",
 			"destination": ".claude/agents/planner.md",
 			"executable": false,
-			"digest": "86cef178ce25c8c8e002ea69c2e1bf0e21494ac77417e2376c5584fa3ae0c8b7"
+			"digest": "b96f0c28057393dafff0727669009311b0a9277a94286df0e73706495ec810ed"
 		},
 		{
 			"storage": "claude/agents/researcher.md",
 			"destination": ".claude/agents/researcher.md",
 			"executable": false,
-			"digest": "e5f0686f6bb1825fbf6006933e034c1ef882501792a93f690ac4bb059132e926"
+			"digest": "3a65cc76ce7f19cc00d6ec36d1b79f8bacaba3319a7f7648cc4fdffacb07c5f8"
 		},
 		{
 			"storage": "claude/agents/reviewer.md",
 			"destination": ".claude/agents/reviewer.md",
 			"executable": false,
-			"digest": "5e0ebe2e95de2281780842ada840ec0bd11f88fee2877530eee5d6c86731d5b4"
+			"digest": "557daaa0786c117ddc457c5b8a0c11e5a5b6f5292aadb1349b189e6d44141b88"
 		},
 		{
 			"storage": "claude/agents/scout.md",
 			"destination": ".claude/agents/scout.md",
 			"executable": false,
-			"digest": "fa55e6ca6c89dae3bdf6f2faddf6beea0746b8714962a45a44999f7d8b5f7691"
+			"digest": "eb95a12c4f03a66a5214d3a558414967062cb1fadd78082c8f19f65c6af18f5e"
 		},
 		{
 			"storage": "claude/agents/verifier.md",
 			"destination": ".claude/agents/verifier.md",
 			"executable": false,
-			"digest": "bc5191ce230e03799a4437430be329a0593da06a28bfe45caaf5f8d51c72152a"
+			"digest": "70a39011bafc32bd39ef4506daba4b6b4be019356c13dc2a03756eccd345833c"
 		},
 		{
 			"storage": "claude/rules/application.md",
@@ -550,7 +550,7 @@
 			"storage": "claude/rules/documentation.md",
 			"destination": ".claude/rules/documentation.md",
 			"executable": false,
-			"digest": "51571aca137dc8ca10e5820c29c6607b289146c2feeaa78956c0075ceaa68abb"
+			"digest": "d9d745b54e3d4388be8982193568ec5a196fc777f1586007e22e0ed0234adbb7"
 		},
 		{
 			"storage": "claude/rules/names.md",
@@ -580,7 +580,7 @@
 			"storage": "claude/rules/styles.md",
 			"destination": ".claude/rules/styles.md",
 			"executable": false,
-			"digest": "156572b7c26740411e64726255f76e0f6e6e4e55e800a26262a923210866eb77"
+			"digest": "23197503f78e95abc6f367f4208318faa7b2d4e6f56dae7084cf5b947d9ce95f"
 		},
 		{
 			"storage": "claude/rules/tests.md",
@@ -610,7 +610,7 @@
 			"storage": "claude/settings.json",
 			"destination": ".claude/settings.json",
 			"executable": false,
-			"digest": "614d2cde6b6a6c00e90a8b7f8aa2a5c7b97f52bc5f4b4466df181752057e3f66"
+			"digest": "ebe54b12ac933a12312f562d069012b7d6dfe4b5155943c1805c3e1e2874afbd"
 		},
 		{
 			"storage": "claude/skills/enterprise-bootstrap/SKILL.md",
@@ -694,7 +694,7 @@
 			"storage": "codex/agents/builder.toml",
 			"destination": ".codex/agents/builder.toml",
 			"executable": false,
-			"digest": "578be6691f4ce4c6dac2d953f0285d85dfb6fe72e885966bf2861227e969b5e2"
+			"digest": "866d9aac668f1843b713a17da28877663e05141b6e754f27734de20d55a96ffd"
 		},
 		{
 			"storage": "codex/agents/checker.toml",
@@ -712,25 +712,25 @@
 			"storage": "codex/agents/grok.toml",
 			"destination": ".codex/agents/grok.toml",
 			"executable": false,
-			"digest": "820e7067d21b5ef598c3ad13e4e9d34bbfb4b51a99eed4063b477ef813d96d55"
+			"digest": "cd860a838499a2da64cbd5d04296e282a647ad8a0d4b3f39f94239966b7c4d81"
 		},
 		{
 			"storage": "codex/agents/opus.toml",
 			"destination": ".codex/agents/opus.toml",
 			"executable": false,
-			"digest": "a4b8bf109dabb72988d533914c0c791124c39dd0955485cbea92af5b679e4e10"
+			"digest": "590137fde723c90e8384eb8883cc6a80a7cb0a128ee0338c7c25e590b080e2c4"
 		},
 		{
 			"storage": "codex/agents/orkestrel.toml",
 			"destination": ".codex/agents/orkestrel.toml",
 			"executable": false,
-			"digest": "e423df1e601a5f5520a82d499dd9fe43e5460fc562e456360a5bbf6c615e54d7"
+			"digest": "6f6902e5b6836861cadc07703fb389dc1ba7cebdc63f17835e648e356cb3be95"
 		},
 		{
 			"storage": "codex/agents/planner.toml",
 			"destination": ".codex/agents/planner.toml",
 			"executable": false,
-			"digest": "57f982acb141a1c5f7b636baac140942cd5b96a44db426f44cae2b832318ba2a"
+			"digest": "280c61e14d3e538b683748258fa16c2754b9c0a5f8dd5cd9466d3aa86ed2d647"
 		},
 		{
 			"storage": "codex/agents/researcher.toml",
@@ -742,25 +742,25 @@
 			"storage": "codex/agents/reviewer.toml",
 			"destination": ".codex/agents/reviewer.toml",
 			"executable": false,
-			"digest": "b9732634676fef76de37d5d5d4327cd56c55177229782c1740a01beabffa0b2d"
+			"digest": "aea14e86192faea546d22d83dc79899dbe536af27f23ae5c9968829433a5450f"
 		},
 		{
 			"storage": "codex/agents/scout.toml",
 			"destination": ".codex/agents/scout.toml",
 			"executable": false,
-			"digest": "b79ed6467954fc01d83fb66d687cb2cd7e10ba2ee061c3a3b8946a5540222298"
+			"digest": "35e40dbb60dc3be7cd1aa73877ad3c80fc7e3bdae16a7c0be0ed17134acb7fc5"
 		},
 		{
 			"storage": "codex/agents/verifier.toml",
 			"destination": ".codex/agents/verifier.toml",
 			"executable": false,
-			"digest": "d2219ea560e960bb78f5180cb409e4d332382fdc2db3d646d5e8664698219f54"
+			"digest": "c143e57dbc715066e388c0682db90fc9c5908ece618a6f59b0005d0d5a3d69b4"
 		},
 		{
 			"storage": "codex/config.toml",
 			"destination": ".codex/config.toml",
 			"executable": false,
-			"digest": "753042a95fc6e441f96927d42029117cb481a814f7018562e284950e8f687e47"
+			"digest": "e22ac4e8cc9c6c41a9463dbaad3100a73f9fddc54fff1d9f8b8efd3357e34438"
 		},
 		{
 			"storage": "configs/helpers.ts",
@@ -784,7 +784,7 @@
 			"storage": "cursor/rules/orchestration.mdc",
 			"destination": ".cursor/rules/orchestration.mdc",
 			"executable": false,
-			"digest": "cec5fa84af278f780922ac084b15187126f22c6fee78ac425c172b3b1326d41c"
+			"digest": "4fe403040ef6dffc9bc68b6b84770d6d5ac89a90e1ebb04c580286411c6ffa2e"
 		},
 		{
 			"storage": "dotfiles/editorconfig",
@@ -1042,7 +1042,7 @@
 			"storage": "guides/scaffold.md",
 			"destination": "guides/scaffold.md",
 			"executable": false,
-			"digest": "a5c97efa111d3fe4832380638c025b9cd4f536819b595753c463d7ef2f094889"
+			"digest": "92391c5adfa7652ce6c4b34b4b78176f152d0c4398f28dc7da04797b64e2e973"
 		},
 		{
 			"storage": "guides/sea.md",
@@ -1140,6 +1140,12 @@
 			"executable": false,
 			"digest": "1353da0a0340a8ec7d7c2c08a028d95361bb75b2b03a0e743865c66eee3d0a42"
 		},
+		{
+			"storage": "scripts/browsers.sh",
+			"destination": "scripts/browsers.sh",
+			"executable": true,
+			"digest": "1f38c4b95681fe2415bfa5b44641859d80df866551733cb3d3b0e30ce41ff093"
+		},
 		{
 			"storage": "scripts/codex.sh",
 			"destination": "scripts/codex.sh",
@@ -1158,6 +1164,12 @@
 			"executable": true,
 			"digest": "8f4ad360cd43ea3da202892bf2cdea546795c4081e435384754cbffbf73d773e"
 		},
+		{
+			"storage": "scripts/npm.sh",
+			"destination": "scripts/npm.sh",
+			"executable": true,
+			"digest": "5f9e12952eeddfd9c40d42710c0eabbbe5c9ee55d882f24e0015f419f0fba137"
+		},
 		{
 			"storage": "scripts/ollama.sh",
 			"destination": "scripts/ollama.sh",
@@ -2108,5 +2120,5 @@
 			]
 		}
 	],
-	"digest": "6981084470d3dbfe6c017adc4a1ba93efd243bc15f11508c1ba8a6e01ae43093"
+	"digest": "9accd825a5d01bac14b22e69911c94abb361165b21ab9e12dbc899dcc1cbc0cd"
 }

package/dist/host/scripts/browsers.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# ============================================================================
+# scripts/browsers.sh — SessionStart hook: Playwright browsers for the pinned playwright-core
+# ----------------------------------------------------------------------------
+# Runs only in Claude Code's remote environment. The container pre-installs one
+# Chromium build under PLAYWRIGHT_BROWSERS_PATH; when the lockfile pins a
+# playwright-core whose browsers.json names another build, every browser project
+# fails at launch. Playwright's own installer resolves the store, skips a build
+# whose completion marker exists, and downloads the rest, so this hook runs it
+# and reports what it did. It runs after scripts/deps.sh in the same SessionStart
+# command, because matching hooks run in parallel and the installer arrives with
+# node_modules.
+# ============================================================================
+
+if [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then
+  exit 0
+fi
+
+cd "$CLAUDE_PROJECT_DIR" || exit 0
+
+CLI="node_modules/playwright/cli.js"
+if [ ! -f "$CLI" ]; then
+  echo "browsers.sh: playwright is not installed — skipped."
+  exit 0
+fi
+
+if ! TEMPORARY="$(node -p 'require("node:os").tmpdir()')" || [ -z "$TEMPORARY" ]; then
+  echo "browsers.sh: could not read the temporary directory — skipped."
+  exit 0
+fi
+
+BROWSERS_LOG="$(mktemp -p "$TEMPORARY" orkestrel-browsers.XXXXXX)" || {
+  echo "browsers.sh: could not create a private install log — skipped."
+  exit 0
+}
+chmod 600 "$BROWSERS_LOG"
+
+cleanup_browsers_log() {
+  rm -f -- "$BROWSERS_LOG"
+}
+
+trap cleanup_browsers_log EXIT
+
+if node "$CLI" install chromium >"$BROWSERS_LOG" 2>&1; then
+  if grep -q 'downloaded to' "$BROWSERS_LOG"; then
+    echo "browsers.sh: installed the Chromium builds playwright-core pins."
+  else
+    echo "browsers.sh: Playwright browsers match playwright-core — skipped."
+  fi
+else
+  echo "browsers.sh: playwright install failed; browser projects remain unlaunchable in this session."
+fi
+
+exit 0

package/dist/host/scripts/npm.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# ============================================================================
+# scripts/npm.sh — SessionStart hook: npm at the checkout's declared floor
+# ----------------------------------------------------------------------------
+# Runs only in Claude Code's remote environment. A generated workspace declares
+# its npm floor in devEngines.packageManager with onFail error, and an older npm
+# refuses every install there with EBADDEVENGINES. This hook reads that floor:
+# packageManager is one entry or an array of entries, each naming its manager,
+# and the entry named npm carries a ">=major.minor.patch" version, the form
+# readNpmFloor in tests/setupServer.ts admits. The @orkestrel/scaffold checkout
+# declares no devEngines, because its CI installs on a Node whose bundled npm is
+# older, so there the hook reads the MINIMUM_NPM_VERSION src/core/constants.ts
+# exports. When the session's npm is older than the floor or a prerelease, it
+# installs the newest npm in the floor's major globally. It runs first in the
+# SessionStart command, before scripts/deps.sh runs npm ci.
+# ============================================================================
+
+if [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then
+  exit 0
+fi
+
+cd "$CLAUDE_PROJECT_DIR" || exit 0
+
+if [ ! -f package.json ]; then
+  exit 0
+fi
+
+if ! TEMPORARY="$(node -p 'require("node:os").tmpdir()')" || [ -z "$TEMPORARY" ]; then
+  echo "npm.sh: could not read the temporary directory — skipped."
+  exit 0
+fi
+
+NPM_LOG="$(mktemp -p "$TEMPORARY" orkestrel-npm.XXXXXX)" || {
+  echo "npm.sh: could not create a private install log — skipped."
+  exit 0
+}
+chmod 600 "$NPM_LOG"
+
+cleanup_npm_log() {
+  rm -f -- "$NPM_LOG"
+}
+
+trap cleanup_npm_log EXIT
+
+meets_floor() {
+  [[ "$1" =~ ^[0-9]+\.[0-9]+\.[0-9]+(\+[0-9A-Za-z.-]+)?$ ]] &&
+    [ "$(printf '%s\n%s\n' "$FLOOR" "${1%%+*}" | sort -V | head -n 1)" = "$FLOOR" ]
+}
+
+if ! FLOOR="$(node --input-type=module -e '
+import { readFileSync } from "node:fs"
+import { resolve } from "node:path"
+import { pathToFileURL } from "node:url"
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value)
+const manifest = JSON.parse(readFileSync("package.json", "utf8"))
+if (!isRecord(manifest)) throw new Error("package.json is not a record")
+if (manifest.devEngines !== undefined && !isRecord(manifest.devEngines)) throw new Error("devEngines is not a record")
+const declared = manifest.devEngines?.packageManager
+let floor
+if (declared !== undefined) {
+  const entries = Array.isArray(declared) ? declared : [declared]
+  if (!entries.every((candidate) => isRecord(candidate) && typeof candidate.name === "string")) throw new Error("devEngines.packageManager holds an entry with no name")
+  const entry = entries.find((candidate) => candidate.name === "npm")
+  if (entry !== undefined) {
+    floor = typeof entry.version === "string" ? /^>=((?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*))$/u.exec(entry.version)?.[1] : undefined
+    if (floor === undefined) throw new Error("the npm entry declares no >=major.minor.patch floor")
+  }
+} else if (manifest.name === "@orkestrel/scaffold") {
+  const constants = await import(pathToFileURL(resolve("src/core/constants.ts")).href)
+  floor = constants.MINIMUM_NPM_VERSION
+  if (typeof floor !== "string" || !/^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/u.test(floor)) throw new Error("MINIMUM_NPM_VERSION is not a major.minor.patch version")
+}
+process.stdout.write(floor ?? "")
+' 2>"$NPM_LOG")"; then
+  echo "npm.sh: could not read the npm floor — skipped."
+  exit 0
+fi
+
+if [ -z "$FLOOR" ]; then
+  echo "npm.sh: the checkout declares no npm floor — skipped."
+  exit 0
+fi
+
+CURRENT="$(npm --version 2>"$NPM_LOG")"
+if [ -z "$CURRENT" ]; then
+  echo "npm.sh: npm is not installed — skipped."
+  exit 0
+fi
+
+if meets_floor "$CURRENT"; then
+  echo "npm.sh: npm $CURRENT meets the floor $FLOOR — skipped."
+  exit 0
+fi
+
+if npm install -g "npm@^$FLOOR" >"$NPM_LOG" 2>&1; then
+  INSTALLED="$(npm --version 2>"$NPM_LOG")"
+  if meets_floor "$INSTALLED"; then
+    echo "npm.sh: installed npm $INSTALLED over $CURRENT to meet the floor $FLOOR."
+  else
+    echo "npm.sh: npm install ran, and npm reads ${INSTALLED:-nothing}, which does not meet the floor $FLOOR; installs that declare it refuse."
+  fi
+else
+  INSTALLED="$(npm --version 2>"$NPM_LOG")"
+  if meets_floor "$INSTALLED"; then
+    echo "npm.sh: npm install failed, and npm $INSTALLED meets the floor $FLOOR."
+  else
+    echo "npm.sh: npm install failed; npm reads ${INSTALLED:-nothing}, which does not meet the floor $FLOOR; installs that declare it refuse."
+  fi
+fi
+
+exit 0

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.97",
+	version: "0.0.99",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -115,7 +115,7 @@ var package_default = {
 		"oxlint": "^1.87.0",
 		"playwright": "^1.63.0",
 		"typescript": "^6.0.3",
-		"vite": "^8.3.3",
+		"vite": "^8.3.4",
 		"vitest": "^4.1.11"
 	},
 	engines: { "node": ">=22.18.0" }
@@ -384,9 +384,11 @@ var WORKSPACE_OWNED_PATHS = Object.freeze([".gitignore"]);
 * that must run when a target invokes it belongs here the moment it is vendored.
 */
 var EXECUTABLE_PATHS = Object.freeze([
+	"scripts/browsers.sh",
 	"scripts/codex.sh",
 	"scripts/cursor.sh",
 	"scripts/deps.sh",
+	"scripts/npm.sh",
 	"scripts/ollama.sh"
 ]);
 /**
@@ -6245,6 +6247,37 @@ function blueprintToProjects(blueprint) {
 	return projects;
 }
 /**
+* Compiles the browser projects' pre-bundled dependency list for a blueprint.
+*
+* @remarks
+* A browser-mode run that discovers a runtime package mid-collection reloads the page, so the
+* list names the test package, its browser entry, and every Orkestrel runtime package the
+* blueprint declares or peers with, inline when the line fits the print width and stacked
+* otherwise.
+*
+* @example
+* ```ts
+* import { blueprintToOptimizedDependencies, createBlueprint } from '@orkestrel/scaffold'
+*
+* const blueprint = createBlueprint('router', { src: ['core'] })
+*
+* blueprintToOptimizedDependencies(blueprint).includes("'@orkestrel/test/browser'") // true
+* ```
+*/
+function blueprintToOptimizedDependencies(blueprint) {
+	const names = [
+		"@orkestrel/test",
+		"@orkestrel/test/browser",
+		...[.../* @__PURE__ */ new Set([
+			...Object.hasOwn(blueprintToDevDependencies(blueprint), "@orkestrel/contract") ? ["@orkestrel/contract"] : [],
+			...blueprint.dependencies.map((dependency) => dependency.name),
+			...blueprint.peers.map((peer) => peer.name)
+		])].filter((name) => name.startsWith("@orkestrel/")).sort()
+	];
+	const inline = `\tinclude: [${names.map((name) => `'${name}'`).join(", ")}],`;
+	return matchesPrintWidth(inline) ? `const optimizeDeps = {\n${inline}\n}\n\n` : `const optimizeDeps = {\n\tinclude: [\n${names.map((name) => `\t\t'${name}',`).join("\n")}\n\t],\n}\n\n`;
+}
+/**
 * Compiles the root Vite and Vitest configuration for a blueprint.
 *
 * @param blueprint - The workspace specification.
@@ -6424,13 +6457,7 @@ ${projects.map((project) => `\t\t\t${project},`).join("\n")}
 		imports: imports.length === 0 ? "" : `${imports.join("\n")}\n`,
 		helpers: helpers.length === 0 ? "" : matchesPrintWidth(helperImport.trimEnd()) ? helperImport : `import {\n${helpers.map((helper) => `\t${helper},`).join("\n")}\n} from './configs/helpers.js'\n`,
 		browsers: machinery.browser ? "import { resolveBrowser, resolvePinnedBrowser } from './configs/browsers.js'\n" : "",
-		options: (machinery.browser ? `const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)
-
-const optimizeDeps = {\n\tinclude: ${JSON.stringify([
-			"@orkestrel/test",
-			"@orkestrel/test/browser",
-			...Object.hasOwn(blueprintToDevDependencies(blueprint), "@orkestrel/contract") || blueprint.dependencies.some((dependency) => dependency.name === "@orkestrel/contract") || blueprint.peers.some((peer) => peer.name === "@orkestrel/contract") ? ["@orkestrel/contract"] : []
-		]).replaceAll("\"", "'").replaceAll(",", ", ")},\n}\n\n` : "") + (blueprint.journey && blueprint.app.includes("browser") ? "const capture = process.env.CAPTURE === '1'\n\n" : "") + ((blueprint.journey || blueprint.showcase) && blueprint.app.includes("browser") ? `const applications = {\n\tbrowser: appBrowser,\n${blueprintToFaces(blueprint).filter((extension) => extension.surface === "browser" && extension.axes.includes("app")).map((extension) => `\t${extension.name}: app${extension.name[0]?.toUpperCase()}${extension.name.slice(1)},\n`).join("")}}\n\n` : ""),
+		options: (machinery.browser ? "const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n\n" + blueprintToOptimizedDependencies(blueprint) : "") + (blueprint.journey && blueprint.app.includes("browser") ? "const capture = process.env.CAPTURE === '1'\n\n" : "") + ((blueprint.journey || blueprint.showcase) && blueprint.app.includes("browser") ? `const applications = {\n\tbrowser: appBrowser,\n${blueprintToFaces(blueprint).filter((extension) => extension.surface === "browser" && extension.axes.includes("app")).map((extension) => `\t${extension.name}: app${extension.name[0]?.toUpperCase()}${extension.name.slice(1)},\n`).join("")}}\n\n` : ""),
 		factories: body,
 		projects: projectRows
 	});
@@ -8779,6 +8806,7 @@ exports.blueprintToGuideArtifacts = blueprintToGuideArtifacts;
 exports.blueprintToHostArtifacts = blueprintToHostArtifacts;
 exports.blueprintToMachinery = blueprintToMachinery;
 exports.blueprintToManifest = blueprintToManifest;
+exports.blueprintToOptimizedDependencies = blueprintToOptimizedDependencies;
 exports.blueprintToOrchestrationArtifacts = blueprintToOrchestrationArtifacts;
 exports.blueprintToProjects = blueprintToProjects;
 exports.blueprintToQuestions = blueprintToQuestions;