@vgai/cli 0.5.50 → 0.5.51

package/dist/index.js

@@ -319407,7 +319407,7 @@ var require_sync = __commonJS({
   "../../../donor-main/node_modules/get-package-type/sync.cjs"(exports, module) {
     "use strict";
     var path = __require("path");
-    var { readFileSync: readFileSync34 } = __require("fs");
+    var { readFileSync: readFileSync33 } = __require("fs");
     var isNodeModules = require_is_node_modules();
     var resultsCache = require_cache5();
     function getDirectoryTypeActual(directory) {
@@ -319415,7 +319415,7 @@ var require_sync = __commonJS({
         return "commonjs";
       }
       try {
-        return JSON.parse(readFileSync34(path.resolve(directory, "package.json"))).type || "commonjs";
+        return JSON.parse(readFileSync33(path.resolve(directory, "package.json"))).type || "commonjs";
       } catch (_) {
       }
       const parent = path.dirname(directory);
@@ -333438,7 +333438,7 @@ import {
   mkdirSync as mkdirSync17,
   openSync as openSync3,
   readdirSync as readdirSync16,
-  readFileSync as readFileSync33,
+  readFileSync as readFileSync32,
   realpathSync as realpathSync8,
   statSync as statSync12,
   writeFileSync as writeFileSync15
@@ -333447,7 +333447,7 @@ import { createRequire as createRequire2 } from "node:module";
 import { homedir as homedir7 } from "node:os";
 import { basename as basename6, dirname as dirname26, isAbsolute as isAbsolute12, join as join39, relative as relative12, resolve as resolve21, sep as sep6 } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
-import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL2 } from "node:url";
+import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL2 } from "node:url";
 import { inspect } from "node:util";
 
 // ../create-vgai-project/src/scaffold.ts
@@ -333459,7 +333459,7 @@ import {
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync5,
   readdirSync as readdirSync6,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync11,
   rmSync as rmSync2,
   writeFileSync as writeFileSync4
 } from "node:fs";
@@ -335628,12 +335628,101 @@ function satisfiesTilde(version2, base) {
   return version2[0] === base[0] && version2[1] === base[1];
 }
 
+// ../create-vgai-project/templates.json
+var templates_default = {
+  $comment: "The empty project, named presets of additions, and focused reference examples.",
+  registryVersion: 1,
+  templates: [
+    {
+      id: "empty",
+      title: "Empty project",
+      description: "A project that declares nothing yet \u2014 add a 3D world, a UI, a server or models from here.",
+      source: "template:empty",
+      thumbnail: "packages/create-vgai-project/thumbnails/default.png",
+      whatsInside: [
+        "No roots, no configurations",
+        "The four settings layers",
+        "Add what the project needs"
+      ]
+    },
+    {
+      id: "prototype",
+      title: "Game prototype",
+      description: "A 3D world for a playable prototype, without required Data, Game Inspector or Analytics panels.",
+      source: "template:prototype",
+      thumbnail: "packages/create-vgai-project/thumbnails/default.png",
+      whatsInside: [
+        "Three.js world root",
+        "Neutral daylight scene + focal cube prefab",
+        "No required development panels",
+        "No preselected genre"
+      ]
+    },
+    {
+      id: "game",
+      title: "Game development",
+      description: "A 3D world, multiplayer configuration and required game-specific Data, Game Inspector and Analytics panels to implement.",
+      source: "template:game",
+      thumbnail: "packages/create-vgai-project/thumbnails/default.png",
+      whatsInside: [
+        "Three.js world root",
+        "Neutral daylight scene + focal cube prefab",
+        "server + multiplayer configurations",
+        "Data, Game Inspector and Analytics stubs",
+        "No preselected genre"
+      ]
+    },
+    {
+      id: "website",
+      title: "Website / UI",
+      description: "A React root mounted as a DOM layer \u2014 JSX as the authored truth.",
+      source: "template:website",
+      thumbnail: "packages/create-vgai-project/thumbnails/react.png",
+      whatsInside: [
+        "React DOM root",
+        "Styled shell page",
+        "react-root capability"
+      ]
+    },
+    {
+      id: "models",
+      title: "Models",
+      description: "The mesh capability alone: authored models, Edit Mesh, the model finder \u2014 no world to run.",
+      source: "template:models",
+      thumbnail: "packages/create-vgai-project/thumbnails/default.png",
+      whatsInside: [
+        "mesh capability",
+        "src/models/ + the model finder",
+        "Opens in the Model workspace"
+      ]
+    },
+    {
+      id: "first-person",
+      title: "First Person",
+      description: "Premium bright arena shooter with Quaternius enemies, layered combat animation, and three weapons.",
+      source: "example:first-person",
+      thumbnail: "examples/first-person/learn/thumbnail.png"
+    },
+    {
+      id: "third-person",
+      title: "Third Person",
+      description: "Premium coastal-citadel TPS with over-shoulder combat, layered Quaternius animation, AI, and a complete match.",
+      source: "example:third-person",
+      thumbnail: "examples/third-person/learn/thumbnail.png"
+    },
+    {
+      id: "top-down-strategy",
+      title: "Top Down Strategy",
+      description: "Premium orthographic strategy sample with multi-selection, formation movement, navigation, physics props, automatic doors, and roof reveal.",
+      source: "example:top-down-strategy",
+      thumbnail: "examples/top-down-strategy/learn/thumbnail.png"
+    }
+  ]
+};
+
 // ../create-vgai-project/src/templates.ts
-import { readFileSync as readFileSync11 } from "node:fs";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
 var TEMPLATE_COMPOSITION_IDS = ["empty", "prototype", "game", "website", "models"];
 var SCAFFOLD_PRESENTATIONS = ["blank"];
-var REGISTRY_PATH = fileURLToPath2(new URL("../templates.json", import.meta.url));
 function parseTemplateSource(source) {
   const exampleId = source.startsWith("example:") ? source.slice("example:".length) : void 0;
   if (exampleId !== void 0) {
@@ -335690,7 +335779,7 @@ function isEntryScaffoldable(entry, scaffoldTemplates) {
   return source.type === "example" ? scaffoldTemplates.includes("example") : scaffoldTemplates.includes(source.template);
 }
 function loadTemplateRegistry() {
-  const raw = JSON.parse(readFileSync11(REGISTRY_PATH, "utf-8"));
+  const raw = templates_default;
   if (typeof raw !== "object" || raw === null) {
     throw new Error("Template registry: templates.json is not an object");
   }
@@ -335776,7 +335865,7 @@ var PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH = "DEVLOG.md";
 function rewriteRoadmap(targetDir, name) {
   const path = join15(targetDir, PROJECT_ROADMAP_RELATIVE_PATH);
   if (!existsSync10(path)) return;
-  const body = readFileSync12(path, "utf-8").replace(/^# .*$/m, `# Roadmap \u2014 ${name}`);
+  const body = readFileSync11(path, "utf-8").replace(/^# .*$/m, `# Roadmap \u2014 ${name}`);
   writeFileSync4(path, body, "utf-8");
 }
 function resolveEngineDependencyNames(engineDir, fallbackDir) {
@@ -335793,7 +335882,7 @@ function readInstalledVersionWithFallback(monoRoot, fallbackDir, name) {
 }
 function readEngineDependencyNames(engineDir) {
   try {
-    const enginePkg = JSON.parse(readFileSync12(join15(engineDir, "package.json"), "utf-8"));
+    const enginePkg = JSON.parse(readFileSync11(join15(engineDir, "package.json"), "utf-8"));
     return new Set(Object.keys(enginePkg.dependencies ?? {}));
   } catch {
     return void 0;
@@ -335802,7 +335891,7 @@ function readEngineDependencyNames(engineDir) {
 function readInstalledVersion(monoRoot, packageName) {
   try {
     const installed = JSON.parse(
-      readFileSync12(join15(monoRoot, "node_modules", packageName, "package.json"), "utf-8")
+      readFileSync11(join15(monoRoot, "node_modules", packageName, "package.json"), "utf-8")
     );
     return installed.version;
   } catch {
@@ -335959,7 +336048,7 @@ function shouldCopyStarterPath(templateDir, sourcePath) {
 function rewritePackageJson(targetDir, slug, engineDir, monoRoot) {
   const pkgPath = join15(targetDir, "package.json");
   if (!existsSync10(pkgPath)) return;
-  const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
   pkg.name = slug;
   pkg.dependencies = pkg.dependencies ?? {};
   pkg.dependencies["@vgai/engine"] = engineDependencySpec(monoRoot, "@vgai/engine");
@@ -336006,7 +336095,7 @@ function versionFromCheckout(monoRoot, relPath) {
   const candidate = resolve9(monoRoot, cleaned, "package.json");
   if (!existsSync10(candidate)) return void 0;
   try {
-    const parsed = JSON.parse(readFileSync12(candidate, "utf8"));
+    const parsed = JSON.parse(readFileSync11(candidate, "utf8"));
     return typeof parsed.version === "string" ? parsed.version : void 0;
   } catch {
     return void 0;
@@ -336024,7 +336113,7 @@ function rewriteGameManifest(targetDir, name, slug, additions, monoRoot) {
   const engineVersion = readInstalledVersion(monoRoot, "@vgai/engine");
   let manifest;
   if (existsSync10(manifestPath)) {
-    manifest = JSON.parse(readFileSync12(manifestPath, "utf-8"));
+    manifest = JSON.parse(readFileSync11(manifestPath, "utf-8"));
   } else {
     manifest = {
       manifestVersion: 2,
@@ -336070,7 +336159,7 @@ function repinEngineAfterInstall(targetDir) {
   const manifestPath = resolveManifestPath(targetDir);
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync12(manifestPath, "utf-8"));
+    manifest = JSON.parse(readFileSync11(manifestPath, "utf-8"));
   } catch {
     return null;
   }
@@ -336081,7 +336170,7 @@ function repinEngineAfterInstall(targetDir) {
   writeJson(manifestPath, manifest);
   const baselinePath = join15(targetDir, SCAFFOLD_BASELINE_RELATIVE_PATH);
   try {
-    const baseline = JSON.parse(readFileSync12(baselinePath, "utf-8"));
+    const baseline = JSON.parse(readFileSync11(baselinePath, "utf-8"));
     baseline.engineVersion = installed;
     baseline.files["vgai.project.json"] = hashFile(manifestPath);
     writeFileSync4(baselinePath, `${JSON.stringify(baseline, null, 2)}
@@ -336115,7 +336204,7 @@ function checkoutVgaiPackageDirs(monoRoot) {
     if (!existsSync10(join15(dir, "src"))) continue;
     let name;
     try {
-      name = JSON.parse(readFileSync12(join15(dir, "package.json"), "utf-8")).name;
+      name = JSON.parse(readFileSync11(join15(dir, "package.json"), "utf-8")).name;
     } catch {
       continue;
     }
@@ -336126,7 +336215,7 @@ function checkoutVgaiPackageDirs(monoRoot) {
 function declaredVgaiDependencies(projectDir) {
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync12(join15(projectDir, "package.json"), "utf-8"));
+    pkg = JSON.parse(readFileSync11(join15(projectDir, "package.json"), "utf-8"));
   } catch {
     return [];
   }
@@ -336156,7 +336245,7 @@ var runPackageBuild = (packageDir) => {
 function declaredBins(packageDir) {
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync12(join15(packageDir, "package.json"), "utf-8"));
+    pkg = JSON.parse(readFileSync11(join15(packageDir, "package.json"), "utf-8"));
   } catch {
     return [];
   }
@@ -336206,7 +336295,7 @@ function rewriteTemplateVariantFiles(targetDir, additions) {
     writeFileSync4(join15(targetDir, "vgai.adapter.ts"), adapterSourceFor(additions), "utf-8");
   } else {
     const adapterPath = join15(targetDir, "vgai.adapter.ts");
-    const source = joinAdditionFinders(readFileSync12(adapterPath, "utf-8"), additions);
+    const source = joinAdditionFinders(readFileSync11(adapterPath, "utf-8"), additions);
     writeFileSync4(adapterPath, source, "utf-8");
   }
   if (additions.has("mesh")) {
@@ -336228,7 +336317,7 @@ function relaxIndexAccessForModels(targetDir) {
   const tsconfigPath = join15(targetDir, "tsconfig.json");
   if (!existsSync10(tsconfigPath)) return;
   const parseErrors = [];
-  const tsconfig = parse4(readFileSync12(tsconfigPath, "utf-8"), parseErrors, {
+  const tsconfig = parse4(readFileSync11(tsconfigPath, "utf-8"), parseErrors, {
     allowTrailingComma: true
   });
   if (parseErrors.length > 0) return;
@@ -336239,7 +336328,7 @@ function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
   const tsconfigPath = join15(targetDir, "tsconfig.json");
   if (!existsSync10(tsconfigPath)) return;
   const parseErrors = [];
-  const tsconfig = parse4(readFileSync12(tsconfigPath, "utf-8"), parseErrors, {
+  const tsconfig = parse4(readFileSync11(tsconfigPath, "utf-8"), parseErrors, {
     allowTrailingComma: true
   });
   if (parseErrors.length > 0) {
@@ -336261,7 +336350,7 @@ function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
 function rewriteViteConfig(targetDir) {
   const vitePath = join15(targetDir, "vite.config.ts");
   if (!existsSync10(vitePath)) return;
-  writeFileSync4(vitePath, rewriteViteConfigContent(readFileSync12(vitePath, "utf-8")), "utf-8");
+  writeFileSync4(vitePath, rewriteViteConfigContent(readFileSync11(vitePath, "utf-8")), "utf-8");
 }
 function rewriteViteConfigContent(content) {
   return ensureReactDedupe(content);
@@ -336287,7 +336376,7 @@ function ensureReactDedupe(content) {
 function rewriteIndexHtml(targetDir, name) {
   const htmlPath = join15(targetDir, "index.html");
   if (!existsSync10(htmlPath)) return;
-  const html = readFileSync12(htmlPath, "utf-8").replace(
+  const html = readFileSync11(htmlPath, "utf-8").replace(
     /<title>.*<\/title>/,
     `<title>${name}</title>`
   );
@@ -336346,7 +336435,7 @@ function scaffoldProject(opts) {
 // ../create-vgai-project/src/dep-cache.ts
 import { spawnSync as spawnSync4 } from "node:child_process";
 import { createHash as createHash4 } from "node:crypto";
-import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync13, renameSync as renameSync2, rmSync as rmSync3, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync12, renameSync as renameSync2, rmSync as rmSync3, statSync as statSync4 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { dirname as dirname10, isAbsolute as isAbsolute7, join as join16, resolve as resolve10 } from "node:path";
 var LOCAL_SPECIFIER_PREFIXES = ["file:", "link:", "portal:"];
@@ -336454,7 +336543,7 @@ function cacheDependencies(targetDir, env3, clone2 = cloneTree) {
 }
 function readKey(targetDir) {
   try {
-    const pkg = JSON.parse(readFileSync13(join16(targetDir, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync12(join16(targetDir, "package.json"), "utf8"));
     return computeDepCacheKey({
       dependencies: pkg.dependencies ?? {},
       devDependencies: pkg.devDependencies ?? {},
@@ -336500,7 +336589,7 @@ import {
   existsSync as existsSync12,
   mkdtempSync,
   readdirSync as readdirSync7,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync13,
   statSync as statSync5,
   writeFileSync as writeFileSync5
 } from "node:fs";
@@ -336592,7 +336681,7 @@ ${detail}`
     );
   }
   const stagedManifestPath = join17(stagedDir, "vgai.project.json");
-  const staged = JSON.parse(readFileSync14(stagedManifestPath, "utf-8"));
+  const staged = JSON.parse(readFileSync13(stagedManifestPath, "utf-8"));
   staged.relay = {
     grant: minted.grant,
     expiresAt: minted.expiresAt,
@@ -336602,7 +336691,7 @@ ${detail}`
   writeFileSync5(stagedManifestPath, `${JSON.stringify(staged, null, 2)}
 `, "utf-8");
   const sourceManifestPath = resolveManifestPath(projectDir);
-  const source = JSON.parse(readFileSync14(sourceManifestPath, "utf-8"));
+  const source = JSON.parse(readFileSync13(sourceManifestPath, "utf-8"));
   if (source.relay !== void 0) {
     throw new DeployError(
       `vgai deploy: internal invariant violated \u2014 the SOURCE manifest at ${sourceManifestPath} gained a relay grant. The grant must live only in the staged bundle.`
@@ -336646,7 +336735,7 @@ async function deployProject(opts) {
 }
 
 // ../create-vgai-project/src/deploy-itch.ts
-import { mkdirSync as mkdirSync7, readdirSync as readdirSync8, readFileSync as readFileSync15, writeFileSync as writeFileSync6 } from "node:fs";
+import { mkdirSync as mkdirSync7, readdirSync as readdirSync8, readFileSync as readFileSync14, writeFileSync as writeFileSync6 } from "node:fs";
 import { dirname as dirname11, isAbsolute as isAbsolute8, join as join18, relative as relative7, sep as sep3 } from "node:path";
 
 // ../../../donor-main/node_modules/fflate/esm/index.mjs
@@ -337652,7 +337741,7 @@ function collectZippable(dir, base = dir) {
       Object.assign(out, collectZippable(full, base));
     } else if (entry.isFile()) {
       const relPath = relative7(base, full).split(sep3).join("/");
-      out[relPath] = new Uint8Array(readFileSync15(full));
+      out[relPath] = new Uint8Array(readFileSync14(full));
     }
   }
   return out;
@@ -337671,7 +337760,7 @@ function assertItchZipEntries(entries) {
   }
 }
 function validateItchZipFile(zipPath) {
-  const bytes = readFileSync15(zipPath);
+  const bytes = readFileSync14(zipPath);
   const entries = [];
   unzipSync(new Uint8Array(bytes), {
     filter(file2) {
@@ -337789,7 +337878,7 @@ import {
   mkdirSync as mkdirSync8,
   mkdtempSync as mkdtempSync2,
   readdirSync as readdirSync9,
-  readFileSync as readFileSync16,
+  readFileSync as readFileSync15,
   rmSync as rmSync4,
   writeFileSync as writeFileSync7
 } from "node:fs";
@@ -337941,7 +338030,7 @@ function classifyTemplateFiles(projectDir, baseline, newTemplateAbsPaths) {
           status: "user-edited",
           diff: unifiedDiff(
             path,
-            readFileSync16(currentAbsPath, "utf-8"),
+            readFileSync15(currentAbsPath, "utf-8"),
             readTextSafe(newTemplateAbsPath)
           )
         });
@@ -337958,7 +338047,7 @@ function classifyTemplateFiles(projectDir, baseline, newTemplateAbsPaths) {
       if (currentHash !== newTemplateHash) {
         report.diff = unifiedDiff(
           path,
-          readFileSync16(currentAbsPath, "utf-8"),
+          readFileSync15(currentAbsPath, "utf-8"),
           readTextSafe(newTemplateAbsPath)
         );
       }
@@ -337973,7 +338062,7 @@ function classifyTemplateFiles(projectDir, baseline, newTemplateAbsPaths) {
 }
 function readTextSafe(absPath) {
   try {
-    return readFileSync16(absPath, "utf-8");
+    return readFileSync15(absPath, "utf-8");
   } catch {
     return "";
   }
@@ -338038,7 +338127,7 @@ function buildDependencyVersionsReport(projectDir, currentEngineVersion, targetP
   if (!existsSync13(pkgPath)) return [];
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync16(pkgPath, "utf-8"));
+    pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
   } catch {
     return [];
   }
@@ -338064,7 +338153,7 @@ function rewriteDependencyVersions(projectDir, entries) {
   if (toWrite.length === 0) return;
   const pkgPath = join19(projectDir, "package.json");
   if (!existsSync13(pkgPath)) return;
-  const pkg = JSON.parse(readFileSync16(pkgPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
   for (const entry of toWrite) {
     const bucket = entry.field === "dependencies" ? pkg.dependencies : pkg.devDependencies;
     if (!bucket || bucket[entry.name] === void 0) continue;
@@ -338075,7 +338164,7 @@ function rewriteDependencyVersions(projectDir, entries) {
 }
 function rewriteEngineVersionPin(projectDir, newVersion) {
   const manifestPath = resolveManifestPath(projectDir);
-  const raw = readFileSync16(manifestPath, "utf-8");
+  const raw = readFileSync15(manifestPath, "utf-8");
   const manifest = JSON.parse(raw);
   manifest.engine = { ...manifest.engine, version: newVersion };
   writeFileSync7(manifestPath, `${JSON.stringify(manifest, null, 2)}
@@ -338096,7 +338185,7 @@ function buildNewTemplateSnapshot(monoRoot, projectDir, scratchDir, currentEngin
   const catalogDir = join19(templateDir, "..", "catalog");
   copyTemplateTree(templateDir, scratchDir);
   const currentManifestPath = resolveManifestPath(projectDir);
-  const name = existsSync13(currentManifestPath) ? JSON.parse(readFileSync16(currentManifestPath, "utf-8")).name ?? "game" : "game";
+  const name = existsSync13(currentManifestPath) ? JSON.parse(readFileSync15(currentManifestPath, "utf-8")).name ?? "game" : "game";
   reapplyScaffoldRewrites(
     scratchDir,
     projectDir,
@@ -338125,7 +338214,7 @@ var R3F_STARTER_WORLD_PATHS = /* @__PURE__ */ new Set([
 ]);
 function projectUsesR3fStarterWorld(projectDir) {
   try {
-    const manifest = JSON.parse(readFileSync16(resolveManifestPath(projectDir), "utf8"));
+    const manifest = JSON.parse(readFileSync15(resolveManifestPath(projectDir), "utf8"));
     return manifest.roots?.some(
       (root) => root.adapter === "three" && root.entry?.replace(/^\.\//, "") === "src/world.tsx"
     ) ?? false;
@@ -338166,12 +338255,12 @@ function copyTemplateTree(templateDir, targetDir) {
     const src = join19(templateDir, relPath);
     const dest = join19(targetDir, relPath);
     mkdirSync8(join19(dest, ".."), { recursive: true });
-    writeFileSync7(dest, readFileSync16(src));
+    writeFileSync7(dest, readFileSync15(src));
   }
 }
 function projectHasThreeRoot(projectDir) {
   try {
-    const manifest = JSON.parse(readFileSync16(resolveManifestPath(projectDir), "utf8"));
+    const manifest = JSON.parse(readFileSync15(resolveManifestPath(projectDir), "utf8"));
     return manifest.roots?.some((root) => root.adapter === "three") ?? false;
   } catch {
     return false;
@@ -338193,9 +338282,9 @@ function reapplyScaffoldRewrites(scratchDir, projectDir, monoRoot, name, current
   };
   const pkgPath = join19(scratchDir, "package.json");
   if (existsSync13(pkgPath)) {
-    const pkg = JSON.parse(readFileSync16(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
     const projectPkgPath = join19(projectDir, "package.json");
-    const projectPkg = existsSync13(projectPkgPath) ? JSON.parse(readFileSync16(projectPkgPath, "utf-8")) : void 0;
+    const projectPkg = existsSync13(projectPkgPath) ? JSON.parse(readFileSync15(projectPkgPath, "utf-8")) : void 0;
     const slug = projectPkg?.name;
     if (slug) pkg.name = slug;
     pkg.dependencies = pkg.dependencies ?? {};
@@ -338234,9 +338323,9 @@ function reapplyScaffoldRewrites(scratchDir, projectDir, monoRoot, name, current
   }
   const manifestPath = resolveManifestPath(scratchDir);
   if (existsSync13(manifestPath)) {
-    const manifest = JSON.parse(readFileSync16(manifestPath, "utf-8"));
+    const manifest = JSON.parse(readFileSync15(manifestPath, "utf-8"));
     const currentManifestPath = resolveManifestPath(projectDir);
-    const currentManifest = existsSync13(currentManifestPath) ? JSON.parse(readFileSync16(currentManifestPath, "utf-8")) : void 0;
+    const currentManifest = existsSync13(currentManifestPath) ? JSON.parse(readFileSync15(currentManifestPath, "utf-8")) : void 0;
     manifest["name"] = name;
     if (currentManifest?.["appId"] !== void 0) manifest["appId"] = currentManifest["appId"];
     writeFileSync7(manifestPath, `${JSON.stringify(manifest, null, 2)}
@@ -338244,7 +338333,7 @@ function reapplyScaffoldRewrites(scratchDir, projectDir, monoRoot, name, current
   }
   const tsconfigPath = join19(scratchDir, "tsconfig.json");
   if (existsSync13(tsconfigPath)) {
-    const tsconfig = JSON.parse(readFileSync16(tsconfigPath, "utf-8"));
+    const tsconfig = JSON.parse(readFileSync15(tsconfigPath, "utf-8"));
     tsconfig.compilerOptions = tsconfig.compilerOptions ?? {};
     tsconfig.compilerOptions.paths = {
       // Kept byte-identical to `scaffold.ts`'s `rewriteTsconfig` — see its doc
@@ -338264,12 +338353,12 @@ function reapplyScaffoldRewrites(scratchDir, projectDir, monoRoot, name, current
   }
   const vitePath = join19(scratchDir, "vite.config.ts");
   if (existsSync13(vitePath)) {
-    const content = rewriteViteConfigContent(readFileSync16(vitePath, "utf-8"));
+    const content = rewriteViteConfigContent(readFileSync15(vitePath, "utf-8"));
     writeFileSync7(vitePath, content, "utf-8");
   }
   const htmlPath = join19(scratchDir, "index.html");
   if (existsSync13(htmlPath)) {
-    const html = readFileSync16(htmlPath, "utf-8").replace(
+    const html = readFileSync15(htmlPath, "utf-8").replace(
       /<title>.*<\/title>/,
       `<title>${name}</title>`
     );
@@ -338277,14 +338366,14 @@ function reapplyScaffoldRewrites(scratchDir, projectDir, monoRoot, name, current
   }
   const roadmapPath = join19(scratchDir, PROJECT_ROADMAP_RELATIVE_PATH);
   if (existsSync13(roadmapPath)) {
-    const roadmap = readFileSync16(roadmapPath, "utf-8").replace(/^# .*$/m, `# ${name} \u2014 Roadmap`);
+    const roadmap = readFileSync15(roadmapPath, "utf-8").replace(/^# .*$/m, `# ${name} \u2014 Roadmap`);
     writeFileSync7(roadmapPath, roadmap, "utf-8");
   }
 }
 function readBaseline(projectDir) {
   const path = join19(projectDir, SCAFFOLD_BASELINE_RELATIVE_PATH);
   if (!existsSync13(path)) return void 0;
-  return JSON.parse(readFileSync16(path, "utf-8"));
+  return JSON.parse(readFileSync15(path, "utf-8"));
 }
 function refreshBaselineAfterUpgrade(projectDir, engineVersion, newTemplateFiles, engineDir) {
   const files = {};
@@ -338315,7 +338404,7 @@ async function upgradeProject(opts) {
   const { projectDir, monoRoot, currentEngineVersion } = opts;
   const manifestPath = resolveManifestPath(projectDir);
   const pinBefore = existsSync13(manifestPath) ? compareEnginePin(
-    JSON.parse(readFileSync16(manifestPath, "utf-8")).engine?.version ?? "",
+    JSON.parse(readFileSync15(manifestPath, "utf-8")).engine?.version ?? "",
     currentEngineVersion
   ) : {
     status: "invalid",
@@ -338420,7 +338509,7 @@ async function upgradeProject(opts) {
         if (!newAbsPath) continue;
         const destPath = join19(projectDir, file2.path);
         mkdirSync8(join19(destPath, ".."), { recursive: true });
-        writeFileSync7(destPath, readFileSync16(newAbsPath));
+        writeFileSync7(destPath, readFileSync15(newAbsPath));
       } else if (file2.status === "removed-incompatible-starter") {
         const destPath = join19(projectDir, file2.path);
         const baselineHash = baseline.files[file2.path];
@@ -338460,7 +338549,7 @@ function editorServerNodeOptions(inherited) {
 }
 
 // ../editor/server/open-browser.ts
-import { existsSync as existsSync14, readFileSync as readFileSync17 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync16 } from "node:fs";
 
 // ../editor/server/spawn-opener.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -338506,7 +338595,7 @@ function spawnOpener(cmd, cmdArgs, fallback) {
 function isWSL() {
   if (process.platform !== "linux") return false;
   try {
-    return readFileSync17("/proc/version", "utf8").toLowerCase().includes("microsoft");
+    return readFileSync16("/proc/version", "utf8").toLowerCase().includes("microsoft");
   } catch {
     return false;
   }
@@ -338705,7 +338794,7 @@ init_load_file();
 
 // ../vgai-sdk/src/project/build-discipline.ts
 import { spawnSync as spawnSync6 } from "node:child_process";
-import { existsSync as existsSync15, mkdirSync as mkdirSync9, readdirSync as readdirSync10, readFileSync as readFileSync18, statSync as statSync6, writeFileSync as writeFileSync8 } from "node:fs";
+import { existsSync as existsSync15, mkdirSync as mkdirSync9, readdirSync as readdirSync10, readFileSync as readFileSync17, statSync as statSync6, writeFileSync as writeFileSync8 } from "node:fs";
 import { dirname as dirname12, join as join20 } from "node:path";
 function formatElapsed(ms2) {
   const totalMinutes = Math.floor(ms2 / 6e4);
@@ -338933,7 +339022,7 @@ function unplayedSessionBanner(sessionStartedAtMs, newestEvidence, now, playable
 var TRIPWIRE_GATE_PATH = join20(".vgai", "tripwire-gate.json");
 
 // ../vgai-sdk/src/project/session-journal.ts
-import { appendFileSync, mkdirSync as mkdirSync10, readdirSync as readdirSync11, readFileSync as readFileSync19, unlinkSync } from "node:fs";
+import { appendFileSync, mkdirSync as mkdirSync10, readdirSync as readdirSync11, readFileSync as readFileSync18, unlinkSync } from "node:fs";
 import { join as join21 } from "node:path";
 var PREFIX = "editor-";
 var SUFFIX = ".jsonl";
@@ -338951,7 +339040,7 @@ function readRecentJournalEvents(projectRoot, kinds, limit) {
   if (path === null || limit <= 0) return [];
   let raw;
   try {
-    raw = readFileSync19(path, "utf-8");
+    raw = readFileSync18(path, "utf-8");
   } catch {
     return [];
   }
@@ -339087,7 +339176,7 @@ function sessionJournalPointerLine(journalPath) {
 }
 
 // src/account-session.ts
-import { readFileSync as readFileSync20 } from "node:fs";
+import { readFileSync as readFileSync19 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join22, resolve as resolve11 } from "node:path";
 
@@ -339224,7 +339313,7 @@ function cliAccountPath() {
 }
 function readCliAccountState() {
   try {
-    const value = JSON.parse(readFileSync20(cliAccountPath(), "utf8"));
+    const value = JSON.parse(readFileSync19(cliAccountPath(), "utf8"));
     if (value.version !== 1 || value.backend !== "mock" && value.backend !== "live") {
       return void 0;
     }
@@ -339714,7 +339803,7 @@ function formatAssetPackFailure(outcome, projectDir) {
 
 // src/check-idioms-status.ts
 import { spawnSync as spawnSync7 } from "node:child_process";
-import { existsSync as existsSync16, readFileSync as readFileSync21, statSync as statSync7 } from "node:fs";
+import { existsSync as existsSync16, readFileSync as readFileSync20, statSync as statSync7 } from "node:fs";
 import { dirname as dirname15, join as join25 } from "node:path";
 var SCANNER_SOURCE = "check-idioms.ts";
 var FINDINGS_RECORD = join25(".vgai", "check-idioms.json");
@@ -339778,7 +339867,7 @@ function readCheckIdiomsFindings(projectRoot, changedAt) {
   const at = recordedAt(projectRoot);
   if (at === null || changedAt !== null && changedAt > at) refreshFindings(projectRoot);
   try {
-    const raw = JSON.parse(readFileSync21(join25(projectRoot, FINDINGS_RECORD), "utf-8"));
+    const raw = JSON.parse(readFileSync20(join25(projectRoot, FINDINGS_RECORD), "utf-8"));
     if (!Array.isArray(raw.findings)) {
       return [gateFailure("record-malformed", `${FINDINGS_RECORD} has no findings array`)];
     }
@@ -339802,16 +339891,16 @@ function gateFailure(kind, detail) {
 // src/colyseus-autoboot.ts
 init_load_file();
 import { spawn as spawn3 } from "node:child_process";
-import { existsSync as existsSync17, readFileSync as readFileSync23 } from "node:fs";
+import { existsSync as existsSync17, readFileSync as readFileSync22 } from "node:fs";
 import { join as join27 } from "node:path";
 
 // ../engine/src/manifest/runtime-environment.ts
 var import_semver = __toESM(require_semver2(), 1);
-import { readFileSync as readFileSync22 } from "node:fs";
+import { readFileSync as readFileSync21 } from "node:fs";
 import { join as join26 } from "node:path";
 function declaredNodeRange(projectDir) {
   try {
-    const raw = JSON.parse(readFileSync22(join26(projectDir, "package.json"), "utf-8"));
+    const raw = JSON.parse(readFileSync21(join26(projectDir, "package.json"), "utf-8"));
     const engines = raw?.engines;
     return typeof engines?.node === "string" && engines.node.trim() ? engines.node.trim() : null;
   } catch {
@@ -339910,7 +339999,7 @@ function readDeclaredProcess(projectDir) {
   try {
     const manifestPath = resolveManifestPath(projectDir);
     if (!existsSync17(manifestPath)) return null;
-    const parsed = JSON.parse(readFileSync23(manifestPath, "utf8"));
+    const parsed = JSON.parse(readFileSync22(manifestPath, "utf8"));
     const declared = (parsed.configurations ?? []).find(
       (c) => c?.kind === "process" && typeof c.entry === "string"
     );
@@ -340661,7 +340750,7 @@ function describeEditorBootFailure(outcome, ctx) {
 // src/editor-sessions.ts
 init_session_registry_format();
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { readFileSync as readFileSync24, realpathSync as realpathSync4, statSync as statSync9 } from "node:fs";
+import { readFileSync as readFileSync23, realpathSync as realpathSync4, statSync as statSync9 } from "node:fs";
 import { join as join29 } from "node:path";
 
 // src/loopback-port.ts
@@ -340869,7 +340958,7 @@ function restartPendingSessionHint(projectDir, opts = {}) {
   let parsed;
   try {
     mtimeMs = statSync9(file2).mtimeMs;
-    parsed = JSON.parse(readFileSync24(file2, "utf8"));
+    parsed = JSON.parse(readFileSync23(file2, "utf8"));
   } catch {
     return null;
   }
@@ -350627,7 +350716,7 @@ function livePlaneLine(shape) {
 }
 
 // src/integrations.ts
-import { existsSync as existsSync21, mkdirSync as mkdirSync11, readFileSync as readFileSync26, renameSync as renameSync3, writeFileSync as writeFileSync9 } from "node:fs";
+import { existsSync as existsSync21, mkdirSync as mkdirSync11, readFileSync as readFileSync25, renameSync as renameSync3, writeFileSync as writeFileSync9 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { dirname as dirname17, join as join30 } from "node:path";
 
@@ -350752,7 +350841,7 @@ function handleIntegrationHook(event, stdinRaw, env3 = process.env) {
 function readJsonObject(path) {
   if (!existsSync21(path)) return null;
   try {
-    const raw = JSON.parse(readFileSync26(path, "utf8"));
+    const raw = JSON.parse(readFileSync25(path, "utf8"));
     if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
       return raw;
     }
@@ -350997,7 +351086,7 @@ function uninstallFromClaude(path) {
 function defaultReadStdinSync() {
   try {
     if (process.stdin.isTTY) return "";
-    return readFileSync26(0, "utf8");
+    return readFileSync25(0, "utf8");
   } catch {
     return "";
   }
@@ -351071,14 +351160,14 @@ import {
   mkdirSync as mkdirSync12,
   openSync as openSync2,
   readdirSync as readdirSync13,
-  readFileSync as readFileSync27,
+  readFileSync as readFileSync26,
   renameSync as renameSync4,
   rmSync as rmSync5,
   writeFileSync as writeFileSync10
 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { dirname as dirname18, isAbsolute as isAbsolute10, join as join31, relative as relative10, resolve as resolve14, sep as sep5 } from "node:path";
-import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
+import { fileURLToPath as fileURLToPath2, pathToFileURL } from "node:url";
 
 // ../editor/server/worktree-identity.ts
 import { execFileSync as execFileSync4 } from "node:child_process";
@@ -351172,7 +351261,7 @@ function resolveWorktreeIdentity(projectRoot) {
 // src/isolated-worktree.ts
 var CONTAINER_IMAGE_REVISION = 7;
 var CLI_VERSION = JSON.parse(
-  readFileSync27(resolve14(dirname18(fileURLToPath3(import.meta.url)), "../package.json"), "utf8")
+  readFileSync26(resolve14(dirname18(fileURLToPath2(import.meta.url)), "../package.json"), "utf8")
 ).version;
 var IMAGE = `vgai/isolated-worktree:${CLI_VERSION}-${CONTAINER_IMAGE_REVISION}`;
 var CONTAINER_PORT = 25680;
@@ -351237,7 +351326,7 @@ function writeRecord(record2) {
   chmodSync(statePath(record2.id), 384);
 }
 function readRecord(id) {
-  const record2 = JSON.parse(readFileSync27(statePath(id), "utf8"));
+  const record2 = JSON.parse(readFileSync26(statePath(id), "utf8"));
   if (record2.version !== STATE_VERSION || record2.id !== id) {
     throw new Error(`Unsupported isolated-worktree state: ${statePath(id)}`);
   }
@@ -351259,7 +351348,7 @@ function isolatedId(repositoryId, branch) {
   return createHash7("sha256").update(`${repositoryId}\0${branch}`).digest("hex").slice(0, 16);
 }
 function imageContext() {
-  return resolve14(dirname18(fileURLToPath3(import.meta.url)), "../container");
+  return resolve14(dirname18(fileURLToPath2(import.meta.url)), "../container");
 }
 function ensureImage(runner) {
   try {
@@ -351282,7 +351371,7 @@ function assertCleanRepository(root, runner) {
 function assertLocalDependencyInsideRepository(root, ownerPath, label, rawSpecifier) {
   let target;
   if (rawSpecifier.startsWith("file:")) {
-    target = fileURLToPath3(new URL(rawSpecifier, pathToFileURL(`${dirname18(ownerPath)}/`)));
+    target = fileURLToPath2(new URL(rawSpecifier, pathToFileURL(`${dirname18(ownerPath)}/`)));
   } else if (rawSpecifier.startsWith("link:")) {
     target = resolve14(dirname18(ownerPath), rawSpecifier.slice("link:".length));
   }
@@ -351327,7 +351416,7 @@ function assertReproducibleLocalDependencies(root, runner) {
   ];
   for (const manifestRelative of manifests) {
     const manifestPath = resolve14(root, manifestRelative);
-    const manifest = JSON.parse(readFileSync27(manifestPath, "utf8"));
+    const manifest = JSON.parse(readFileSync26(manifestPath, "utf8"));
     for (const group of dependencyGroups) {
       for (const [name, rawSpecifier] of Object.entries(manifest[group] ?? {})) {
         if (typeof rawSpecifier !== "string") continue;
@@ -351342,7 +351431,7 @@ function assertReproducibleLocalDependencies(root, runner) {
     assertLockResolutionsInsideRepository(
       root,
       lockPath,
-      JSON.parse(readFileSync27(lockPath, "utf8"))
+      JSON.parse(readFileSync26(lockPath, "utf8"))
     );
   }
 }
@@ -351726,7 +351815,7 @@ async function hydrateManagedDeployEnv(resolveToken = cliAccountAccessToken) {
 var import_core13 = __toESM(require_lib(), 1);
 init_src2();
 import { dirname as dirname19, resolve as resolvePath2 } from "node:path";
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/oclif/exit-codes.ts
 var EXIT_CODES = {
@@ -351788,7 +351877,7 @@ function exitCodeForErrorCode(code) {
 
 // src/oclif/operation-command.ts
 var import_core12 = __toESM(require_lib(), 1);
-import { readFileSync as readFileSync28 } from "node:fs";
+import { readFileSync as readFileSync27 } from "node:fs";
 import { resolve as resolve15 } from "node:path";
 
 // src/oclif/schema-to-flags.ts
@@ -351956,7 +352045,7 @@ function applyScalarFlags(scalarFields, flags, input) {
 function readInputFile(inputFile) {
   let raw;
   try {
-    raw = readFileSync28(resolve15(inputFile), "utf-8");
+    raw = readFileSync27(resolve15(inputFile), "utf-8");
   } catch (err2) {
     return {
       ok: false,
@@ -352178,7 +352267,7 @@ function createOperationCommand(def, registry3) {
 }
 
 // src/oclif/dispatch.ts
-var __dirname3 = dirname19(fileURLToPath4(import.meta.url));
+var __dirname3 = dirname19(fileURLToPath3(import.meta.url));
 var CLI_PACKAGE_ROOT = resolvePath2(__dirname3, "..", "..");
 var cachedConfig;
 async function loadConfig() {
@@ -352261,7 +352350,7 @@ import { join as join33 } from "node:path";
 
 // src/perf.ts
 init_load();
-import { existsSync as existsSync23, mkdirSync as mkdirSync13, readdirSync as readdirSync14, readFileSync as readFileSync29, rmSync as rmSync6, writeFileSync as writeFileSync11 } from "node:fs";
+import { existsSync as existsSync23, mkdirSync as mkdirSync13, readdirSync as readdirSync14, readFileSync as readFileSync28, rmSync as rmSync6, writeFileSync as writeFileSync11 } from "node:fs";
 import { dirname as dirname20, join as join32, resolve as resolve16 } from "node:path";
 function percentile2(values, fraction) {
   if (values.length === 0) return 0;
@@ -352439,7 +352528,7 @@ function readTrendEntries(projectRoot, limit) {
   const entries = [];
   for (const f of files) {
     try {
-      entries.push(JSON.parse(readFileSync29(join32(dir, f), "utf8")));
+      entries.push(JSON.parse(readFileSync28(join32(dir, f), "utf8")));
     } catch {
     }
   }
@@ -352500,7 +352589,7 @@ function readManifestBudget(manifestPath) {
   }
   let raw;
   try {
-    raw = JSON.parse(readFileSync29(manifestPath, "utf8"));
+    raw = JSON.parse(readFileSync28(manifestPath, "utf8"));
   } catch (err2) {
     throw new PerfGateError(
       `Could not parse ${manifestPath}: ${err2 instanceof Error ? err2.message : String(err2)}`
@@ -352519,7 +352608,7 @@ function readReportFile(path) {
   if (!existsSync23(abs)) throw new PerfGateError(`No perf report at ${abs}.`);
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync29(abs, "utf8"));
+    parsed = JSON.parse(readFileSync28(abs, "utf8"));
   } catch (err2) {
     throw new PerfGateError(
       `Could not parse perf report ${abs}: ${err2 instanceof Error ? err2.message : String(err2)}`
@@ -352881,7 +352970,7 @@ async function playWithRelayReloadRetry(client, opts, dependencies = {}) {
 
 // src/project-editor-port.ts
 import { createHash as createHash8 } from "node:crypto";
-import { mkdirSync as mkdirSync14, readFileSync as readFileSync30, renameSync as renameSync5, rmdirSync, statSync as statSync10, writeFileSync as writeFileSync12 } from "node:fs";
+import { mkdirSync as mkdirSync14, readFileSync as readFileSync29, renameSync as renameSync5, rmdirSync, statSync as statSync10, writeFileSync as writeFileSync12 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
 import { dirname as dirname21, join as join34 } from "node:path";
 var MIN_PORT = 1024;
@@ -352905,7 +352994,7 @@ function isEntry(value) {
 function readEntries2(registryFile) {
   let raw;
   try {
-    raw = readFileSync30(registryFile, "utf8");
+    raw = readFileSync29(registryFile, "utf8");
   } catch (error48) {
     if (error48.code === "ENOENT") return [];
     throw new Error(
@@ -353611,7 +353700,7 @@ function describeTabAttachment(outcome, editorUrl) {
 // src/validate.ts
 var import_typescript2 = __toESM(require_typescript(), 1);
 init_zod();
-import { existsSync as existsSync24, readdirSync as readdirSync15, readFileSync as readFileSync31, statSync as statSync11 } from "node:fs";
+import { existsSync as existsSync24, readdirSync as readdirSync15, readFileSync as readFileSync30, statSync as statSync11 } from "node:fs";
 import { dirname as dirname22, join as join36, resolve as resolve18 } from "node:path";
 init_load_file();
 
@@ -353699,7 +353788,7 @@ function collectSourceFiles2(dir) {
 }
 function collectUnmanagedReactRoots(folder) {
   return collectSourceFiles2(join36(folder, "src")).flatMap(
-    (file2) => detectUnmanagedReactRoots(readFileSync31(file2, "utf-8"), file2)
+    (file2) => detectUnmanagedReactRoots(readFileSync30(file2, "utf-8"), file2)
   );
 }
 var MIN_REACT_ROOT_DESIGN_STATES = 3;
@@ -353832,7 +353921,7 @@ function readDefaultExportedComponentName(source) {
 function parseStoryModule(file2) {
   let text2;
   try {
-    text2 = readFileSync31(file2, "utf-8");
+    text2 = readFileSync30(file2, "utf-8");
   } catch {
     return null;
   }
@@ -353868,7 +353957,7 @@ function collectReactDesignStateChecks(folder, manifest) {
     if (!existsSync24(entryPath)) return skip(`${entry} does not exist`);
     let entrySource;
     try {
-      entrySource = readFileSync31(entryPath, "utf-8");
+      entrySource = readFileSync30(entryPath, "utf-8");
     } catch {
       return skip(`${entry} could not be read`);
     }
@@ -353935,7 +354024,7 @@ function checkEngineSourceDrift(folder, engineDir) {
   if (!existsSync24(baselinePath)) return void 0;
   let recorded;
   try {
-    recorded = JSON.parse(readFileSync31(baselinePath, "utf-8")).engineSource;
+    recorded = JSON.parse(readFileSync30(baselinePath, "utf-8")).engineSource;
   } catch {
     return void 0;
   }
@@ -354003,7 +354092,7 @@ import { execFile as execFile2, execFileSync as execFileSync7 } from "node:child
 // ../editor/server/worktree-retention.mjs
 import { execFileSync as execFileSync6 } from "node:child_process";
 import { createHash as createHash9, randomUUID as randomUUID2 } from "node:crypto";
-import { existsSync as existsSync25, linkSync, mkdirSync as mkdirSync15, readFileSync as readFileSync32, realpathSync as realpathSync6, renameSync as renameSync6, rmSync as rmSync7, writeFileSync as writeFileSync13 } from "node:fs";
+import { existsSync as existsSync25, linkSync, mkdirSync as mkdirSync15, readFileSync as readFileSync31, realpathSync as realpathSync6, renameSync as renameSync6, rmSync as rmSync7, writeFileSync as writeFileSync13 } from "node:fs";
 import { basename as basename4, dirname as dirname23, join as join37, resolve as resolve19 } from "node:path";
 var git4 = (root, args2) => execFileSync6("git", ["-C", root, ...args2], { encoding: "utf8" }).trim();
 function canonical2(target) {
@@ -354033,7 +354122,7 @@ function locked(repo, target, action) {
   }
 }
 function read(file2) {
-  return existsSync25(file2) ? JSON.parse(readFileSync32(file2, "utf8")) : null;
+  return existsSync25(file2) ? JSON.parse(readFileSync31(file2, "utf8")) : null;
 }
 function registered(repo, path) {
   return git4(repo, ["worktree", "list", "--porcelain", "-z"]).split("\0").includes(`worktree ${path}`);
@@ -354046,7 +354135,7 @@ function generationFile(repo, path) {
 function markGeneration(repo, path, record2) {
   const file2 = generationFile(repo, path);
   if (existsSync25(file2)) {
-    if (readFileSync32(file2, "utf8") !== record2.generation) throw new Error("Worktree generation differs from creation intent.");
+    if (readFileSync31(file2, "utf8") !== record2.generation) throw new Error("Worktree generation differs from creation intent.");
   } else {
     const temporary = `${file2}.${randomUUID2()}.tmp`;
     try {
@@ -354058,7 +354147,7 @@ function markGeneration(repo, path, record2) {
   }
 }
 function verifyGeneration(repo, path, record2) {
-  if (readFileSync32(generationFile(repo, path), "utf8") !== record2.generation) throw new Error("Worktree generation changed; old completion cannot remove it.");
+  if (readFileSync31(generationFile(repo, path), "utf8") !== record2.generation) throw new Error("Worktree generation changed; old completion cannot remove it.");
 }
 function preserve(repo, ref, head) {
   try {
@@ -354300,7 +354389,7 @@ function archiveRepositoryWorktree(projectRoot, targetRoot, sessions2) {
 }
 
 // src/index.ts
-var __dirname4 = dirname26(fileURLToPath5(import.meta.url));
+var __dirname4 = dirname26(fileURLToPath4(import.meta.url));
 function resolveCliEngineRoot(cliDir) {
   const candidate = resolve21(cliDir, "..", "..", "..");
   return basename6(candidate) === "node_modules" ? dirname26(candidate) : candidate;
@@ -354313,11 +354402,11 @@ function catalogDistributionDir() {
   );
 }
 function cliVersion() {
-  if ("0.5.50") {
-    return "0.5.50";
+  if ("0.5.51") {
+    return "0.5.51";
   }
   try {
-    const pkg = JSON.parse(readFileSync33(join39(__dirname4, "..", "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync32(join39(__dirname4, "..", "package.json"), "utf8"));
     return typeof pkg.version === "string" ? pkg.version : "unknown";
   } catch {
     return "unknown";
@@ -354333,7 +354422,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.5.50","@vgai/editor":"0.5.50","@vgai/p2p-colyseus":"0.5.50","@vgai/live":"0.5.50","@vgai/sdk":"0.5.50","@vgai/editor-sdk":"0.5.50","@vgai/cli":"0.5.50"}');
+    return JSON.parse('{"@vgai/engine":"0.5.51","@vgai/editor":"0.5.51","@vgai/p2p-colyseus":"0.5.51","@vgai/live":"0.5.51","@vgai/sdk":"0.5.51","@vgai/editor-sdk":"0.5.51","@vgai/cli":"0.5.51"}');
   } catch {
     return void 0;
   }
@@ -354450,11 +354539,12 @@ Drive the running game or editor \u2014 THE general door:
   eval <js>            Literal JS with { editor, game, page, tools, session }.
                        A game names its OWN commands, so no fixed verb set can
                        cover them. Start with:  vgai eval --list
-  run <name>           Invoke one registered project tool with validated JSON
+  tool <name>          Invoke one registered project tool with validated JSON
                        input (--list names them, --describe prints its schemas,
                        --input <file|-> pipes the input in)
 
 Run and look at it:
+  run [id]             List or start a declared run configuration; --stop <id> stops it
   play / stop          Enter / leave play mode
   restart              Reload stale public/ assets when needed, then remount \u2014 acks
                        only when the session is READY (tab attached, play running)
@@ -354606,8 +354696,10 @@ Project:
   open <path>                 Switch project in running editor
   project                     Show current project info
   projects                    List recent projects
-  run --list                  List project-local runnable capabilities
-  run <name>                  Run a Node-hosted project capability with validated JSON input
+  run [id]                    List or start a declared run configuration
+    --stop <id>               Stop the selected configuration
+  tool --list                 List project-local runnable capabilities
+  tool <name>                 Run a Node-hosted project capability with validated JSON input
     --describe                Print the selected capability's schemas and metadata without running
     --input <file|->           Read input JSON from a file or stdin (default: {})
     --yes                      Confirm write/destructive tool execution
@@ -355217,7 +355309,7 @@ async function colyseusPresenceWarning(projectDir) {
   try {
     const manifestPath = resolveManifestPath(projectDir);
     if (!existsSync27(manifestPath)) return null;
-    const parsed = JSON.parse(readFileSync33(manifestPath, "utf8"));
+    const parsed = JSON.parse(readFileSync32(manifestPath, "utf8"));
     if (typeof parsed.server?.room !== "string") return null;
     room = parsed.server.room;
   } catch {
@@ -355359,7 +355451,7 @@ function readNewestPlayLog(projectRoot) {
     const name = newestPlayLogName(readdirSync16(logsDir));
     if (!name) return { logFile: null, logErrors: [] };
     const file2 = join39(logsDir, name);
-    return { logFile: file2, logErrors: playLogErrorMessages(readFileSync33(file2, "utf-8")) };
+    return { logFile: file2, logErrors: playLogErrorMessages(readFileSync32(file2, "utf-8")) };
   } catch {
     return { logFile: null, logErrors: [] };
   }
@@ -355626,7 +355718,7 @@ add requires at least one capability id`);
 }
 function projectToolIdentities(projectDir) {
   try {
-    const pkg = JSON.parse(readFileSync33(join39(projectDir, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync32(join39(projectDir, "package.json"), "utf8"));
     const identities = /* @__PURE__ */ new Set();
     for (const tool of pkg.vgai?.tools ?? []) {
       const identity = typeof tool === "string" ? tool : tool.entry ?? tool.id;
@@ -355687,7 +355779,7 @@ function listAvailableExamples(monoRoot = ENGINE_ROOT) {
     const manifestPath = join39(examplesDir, entry.name, "vgai.project.json");
     if (!existsSync27(manifestPath)) continue;
     try {
-      const manifest = JSON.parse(readFileSync33(manifestPath, "utf-8"));
+      const manifest = JSON.parse(readFileSync32(manifestPath, "utf-8"));
       examples.push({
         id: entry.name,
         name: typeof manifest.name === "string" ? manifest.name : entry.name
@@ -356267,7 +356359,7 @@ function describeEditorProvenance(packagedEntry, engineRoot) {
   const editorPkgDir = dirname26(dirname26(packagedEntry));
   let version2 = "unknown";
   try {
-    version2 = JSON.parse(readFileSync33(join39(editorPkgDir, "package.json"), "utf8")).version ?? "unknown";
+    version2 = JSON.parse(readFileSync32(join39(editorPkgDir, "package.json"), "utf8")).version ?? "unknown";
   } catch {
   }
   return `Editor: packaged @vgai/editor@${version2} (${editorPkgDir})`;
@@ -357197,7 +357289,7 @@ async function runAssetLabLook(source, flags, outputDirectory, defaultStage) {
       screenshotUsageError("--compare stages its own subject; --stage does not apply");
     }
     const refAbsolute = resolve21(flags.compare);
-    const refBytes = readFileSync33(refAbsolute);
+    const refBytes = readFileSync32(refAbsolute);
     const maxRefBytes = 32 * 1024 * 1024;
     if (refBytes.byteLength > maxRefBytes) {
       throw new Error(`--compare reference GLB must be ${maxRefBytes / 1024 / 1024} MiB or less.`);
@@ -357939,7 +358031,7 @@ async function run() {
   try {
     await dispatchCommand();
   } finally {
-    await drainConsoleLoudness(resolveConsoleLoudnessUrl());
+    if (command !== "close") await drainConsoleLoudness(resolveConsoleLoudnessUrl());
   }
 }
 async function dispatchCommand() {
@@ -358053,7 +358145,7 @@ ${JSON.stringify(operation.resultSchema, null, 2)}`);
       if (inputPath) {
         try {
           input = JSON.parse(
-            inputPath === "-" ? readFileSync33(0, "utf8") : readFileSync33(resolve21(inputPath), "utf8")
+            inputPath === "-" ? readFileSync32(0, "utf8") : readFileSync32(resolve21(inputPath), "utf8")
           );
         } catch (error48) {
           console.error(
@@ -358188,7 +358280,7 @@ Inspects first. Without --write this is a preview. With --write it creates only
         throw new Error("vgai blender-mcp: run it from inside a vgai project.");
       }
       if (!await hasLiveEditorSession(project)) {
-        spawnSync10(process.execPath, [fileURLToPath5(import.meta.url), "edit", project], {
+        spawnSync10(process.execPath, [fileURLToPath4(import.meta.url), "edit", project], {
           cwd: project,
           stdio: ["ignore", 2, 2],
           env: { ...process.env, VGAI_DETACH_AFTER_READY: "1" }
@@ -359429,7 +359521,7 @@ Choose exactly one target: project, --port/--url, --all, or --everywhere.`
       let source;
       if (fileFlag) {
         try {
-          source = readFileSync33(resolve21(process.cwd(), rest[1] ?? ""), "utf-8");
+          source = readFileSync32(resolve21(process.cwd(), rest[1] ?? ""), "utf-8");
         } catch (err2) {
           console.error(
             `vgai eval: cannot read ${rest[1]} \u2014 ${err2 instanceof Error ? err2.message : String(err2)}`
@@ -359567,24 +359659,27 @@ Choose exactly one target: project, --port/--url, --all, or --everywhere.`
     case "run": {
       if (hasHelpFlag(args)) {
         console.log(
-          "Usage: vgai run                 (list the project's configurations and their status)\n       vgai run <id>            (start a declared run-role configuration through the live editor session)\n       vgai run --stop <id>     (stop it)\n  Configurations are the manifest's `run[]` (ARCHITECTURE-CORE \xA7The project model): an id and a\n  registered kind. The editor's transport, this verb and a harness start the same declaration."
+          "Usage: vgai run                 (list the project's configurations and their status)\n       vgai run <id>            (start a declared run-role configuration through the live editor session)\n       vgai run --stop <id>     (stop it)\n  The editor's transport, this verb and a harness start the same declared configuration."
         );
         break;
       }
-      const base = resolveEditorTargetUrl();
       const rest = args.slice(1);
+      const validArgs = rest.length === 0 || rest.length === 1 && !rest[0].startsWith("-") || rest.length === 2 && rest[0] === "--stop" && !rest[1].startsWith("-");
+      if (!validArgs) throw new Error("Usage: vgai run [id] | vgai run --stop <id>");
+      const base = resolveEditorTargetUrl();
       const stopFlag = rest.indexOf("--stop");
       const targetId = stopFlag >= 0 ? rest[stopFlag + 1] : rest.find((a) => !a.startsWith("-"));
       if (!targetId) {
         const res2 = await fetch(`${base}/__editor/configurations`);
         const body2 = await res2.json();
         if (!res2.ok) throw new Error(body2.error ?? `vgai run: ${res2.status}`);
-        for (const c of (body2.configurations ?? []).filter((c2) => c2.role === "run")) {
+        const configurations = (body2.configurations ?? []).filter((c) => c.role === "run");
+        for (const c of configurations) {
           console.log(
             `${c.status === "running" ? "\u25CF" : "\u25CB"} ${c.id}  ${c.kind}${c.port ? `  :${c.port}` : ""}`
           );
         }
-        if ((body2.configurations ?? []).length === 0)
+        if (configurations.length === 0)
           console.log("(this project declares no run configurations)");
         break;
       }
@@ -359757,7 +359852,7 @@ Choose exactly one target: project, --port/--url, --all, or --everywhere.`
       );
       let playable = true;
       try {
-        const raw = JSON.parse(readFileSync33(resolveManifestPath(statusProjectRoot), "utf8"));
+        const raw = JSON.parse(readFileSync32(resolveManifestPath(statusProjectRoot), "utf8"));
         playable = Array.isArray(raw.roots) && raw.roots.length > 0;
       } catch {
       }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.50",
+  "version": "0.5.51",
   "description": "Create, open, control, validate, and playtest VGAI game projects.",
   "keywords": [
     "game-engine",
@@ -39,12 +39,12 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.14",
-    "@vgai/editor": "0.5.50",
-    "@vgai/editor-sdk": "0.5.50",
-    "@vgai/engine": "0.5.50",
-    "@vgai/live": "0.5.50",
-    "@vgai/p2p-colyseus": "0.5.50",
-    "@vgai/sdk": "0.5.50",
+    "@vgai/editor": "0.5.51",
+    "@vgai/editor-sdk": "0.5.51",
+    "@vgai/engine": "0.5.51",
+    "@vgai/live": "0.5.51",
+    "@vgai/p2p-colyseus": "0.5.51",
+    "@vgai/sdk": "0.5.51",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",