@volter/cyclotron 0.5.203 → 0.5.205

package/dist-node/cli.js

@@ -199,7 +199,7 @@ var init_client = __esm({
             const { code, detail } = describeFetchFailure2(error50);
             if (options?.retryTransport === true && !retried && RETRYABLE_TRANSPORT_CODES2.has(code)) {
               retried = true;
-              await new Promise((resolve13) => setTimeout(resolve13, TRANSPORT_RETRY_DELAY_MS2));
+              await new Promise((resolve14) => setTimeout(resolve14, TRANSPORT_RETRY_DELAY_MS2));
               continue;
             }
             throw new EditorCommandError2(
@@ -2038,8 +2038,8 @@ __export(blender_mcp_exports, {
   serveBlenderMcp: () => serveBlenderMcp
 });
 import { randomUUID } from "node:crypto";
-import { mkdirSync as mkdirSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync7 } from "node:fs";
-import { delimiter, dirname as dirname9, isAbsolute as isAbsolute6, relative as relative5, sep as sep3 } from "node:path";
+import { mkdirSync as mkdirSync8, readFileSync as readFileSync11, writeFileSync as writeFileSync8 } from "node:fs";
+import { delimiter, dirname as dirname9, isAbsolute as isAbsolute6, relative as relative6, sep as sep4 } from "node:path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -2049,7 +2049,7 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 function projectRelative(project, absolute) {
-  const rel = relative5(project, absolute).split(sep3).join("/");
+  const rel = relative6(project, absolute).split(sep4).join("/");
   if (rel === "" || rel.startsWith("../")) return null;
   return rel;
 }
@@ -2250,15 +2250,15 @@ var init_blender_mcp = __esm({
             const bytes = Buffer.from(await spooled.arrayBuffer());
             if (shipped === null) {
               try {
-                if (readFileSync10(onDisk).equals(bytes)) {
+                if (readFileSync11(onDisk).equals(bytes)) {
                   this.#seen.set(entry.path, stamp);
                   continue;
                 }
               } catch (error50) {
                 if (error50.code !== "ENOENT") throw error50;
               }
-              mkdirSync7(dirname9(onDisk), { recursive: true });
-              writeFileSync7(onDisk, bytes);
+              mkdirSync8(dirname9(onDisk), { recursive: true });
+              writeFileSync8(onDisk, bytes);
             } else {
               const query = new URLSearchParams({
                 path: shipped,
@@ -2353,7 +2353,7 @@ var init_blender_mcp = __esm({
 
 // node/cli.ts
 import { parseArgs } from "node:util";
-import { resolve as resolve12, dirname as dirname10 } from "node:path";
+import { resolve as resolve13, dirname as dirname10 } from "node:path";
 import { spawn as spawn5 } from "node:child_process";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
@@ -2384,7 +2384,7 @@ function hasManifest(dir) {
 var package_default = {
   name: "@volter/cyclotron",
   author: "Volter AI, Inc.",
-  version: "0.5.203",
+  version: "0.5.205",
   publishConfig: {
     access: "public"
   },
@@ -2440,28 +2440,28 @@ var package_default = {
       adapterRequired: true,
       workbench: {
         "darwin-arm64": {
-          release: "cyclotron-f16dc165c0df-28b19dec3e1a-darwin-arm64",
-          tarballSha256: "5bc0f4df6b89477e7563afd83e2bdab5ddebac565ed55fb8af634225d5e6fe63"
+          release: "cyclotron-4782d9a281ef-ec1e0e845c3a-darwin-arm64",
+          tarballSha256: "2a57c0cbc8baa64114d727fe9be00e849f5b8257a8416b50189017f247982c55"
         },
         "linux-x64": {
-          release: "cyclotron-f16dc165c0df-28b19dec3e1a-linux-x64",
-          tarballSha256: "f091a9d6759adb06089e6db35d2be08ac747a154b93904cb5d0da0eba8ca2964"
+          release: "cyclotron-4782d9a281ef-ec1e0e845c3a-linux-x64",
+          tarballSha256: "c23c4aadf241d10af59d4b64e0b944bff2316ceb384d5ad8f02604620418b8f7"
         },
         "win32-x64": {
-          release: "cyclotron-f16dc165c0df-28b19dec3e1a-win32-x64",
-          tarballSha256: "f5fe532a1571fd34a6b5b1f1c10b6c92e933be4132c164ed9ca35ee557587162"
+          release: "cyclotron-4782d9a281ef-ec1e0e845c3a-win32-x64",
+          tarballSha256: "3eecc57767a754cb839ff81fd107db5a524c06ca164a1e3757602d62844967e4"
         }
       }
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.203",
-    "@volter/editor-blender": "0.1.142",
-    "@volter/editor-threejs": "0.5.203",
-    "@volter/blender-engine": "0.1.140",
-    "@volter/project": "0.5.203",
-    "@volter/sdk": "0.5.203",
-    "@volter/live": "0.5.203",
+    "@volter/editor-core": "0.5.205",
+    "@volter/editor-blender": "0.1.144",
+    "@volter/editor-threejs": "0.5.205",
+    "@volter/blender-engine": "0.1.142",
+    "@volter/project": "0.5.205",
+    "@volter/sdk": "0.5.205",
+    "@volter/live": "0.5.205",
     "@modelcontextprotocol/sdk": "1.32.1",
     typescript: "5.9.3",
     undici: "7.29.1"
@@ -16645,6 +16645,22 @@ ${playable ? PLAYABLE.regionIncludes : ""}  editor: { Layout: ModelLayout, style
   }
   return { targetDir: target, manifest };
 }
+async function refreshStarterGuidance(projectDir, log = console.log) {
+  const target = join2(projectDir, "AGENTS.md");
+  let current;
+  try {
+    current = await readFile(target, "utf8");
+  } catch {
+    return;
+  }
+  const starter = await readFile(join2(productRoot, "starter", "AGENTS.md"), "utf8");
+  const firstLine = (text2) => text2.split(/\r?\n/, 1)[0] ?? "";
+  if (current === starter || firstLine(current) !== firstLine(starter)) return;
+  await mkdir(join2(projectDir, ".volter"), { recursive: true });
+  await writeFile(join2(projectDir, ".volter", "AGENTS.previous.md"), current);
+  await writeFile(target, starter);
+  log("AGENTS.md updated to the installed editor guidance (the previous copy is .volter/AGENTS.previous.md).");
+}
 
 // node/startup.ts
 import { existsSync as existsSync4 } from "node:fs";
@@ -16655,8 +16671,8 @@ import { dirname as dirname3, join as join4, resolve as resolve3 } from "node:pa
 // ../sdk/src/session/project-upgrade.ts
 import { spawn as spawn2 } from "node:child_process";
 import { existsSync as existsSync3, lstatSync, readFileSync } from "node:fs";
-import { readFile as readFile2, rename, rm, writeFile as writeFile2 } from "node:fs/promises";
-import { dirname as dirname2, join as join3, resolve as resolve2 } from "node:path";
+import { mkdir as mkdir2, readdir as readdir2, readFile as readFile2, rename, rm, rmdir, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname as dirname2, join as join3, relative as relative2, resolve as resolve2, sep } from "node:path";
 
 // ../sdk/src/session/editor-compatibility.ts
 var EXACT_SEMVER = /^(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
@@ -16674,9 +16690,9 @@ function compareSemver(a, b) {
 }
 
 // ../sdk/src/session/project-upgrade.ts
-var UPGRADE_USAGE = "upgrade [version]    # move this project's @volter packages and its engine pin to one release (default: latest)";
+var UPGRADE_USAGE = "upgrade [version]    # move this project's @volter packages and its engine pin to one release (default: latest); from a project made before 0.5.203, run the newest release's own: npx <package>@latest upgrade";
 function upgradeLine(product) {
-  return `npx ${product.packageName} upgrade`;
+  return `npx ${product.packageName}@latest upgrade`;
 }
 function declaredRetiredProduct(product, project) {
   let pkg;
@@ -16694,6 +16710,99 @@ function retiredProjectError(product, retired, project) {
   );
 }
 var RENAMED_PRODUCT_FILES = [".mcp.json", ".codex/config.toml", "AGENTS.md", "CLAUDE.md"];
+var RENAMED_KIT_PACKAGES = [
+  ["@volter/editor-project", "@volter/project"],
+  ["@volter/editor-sdk", "@volter/sdk"],
+  ["@volter/editor-live", "@volter/live"],
+  ["@volter/editor-model-play", "@volter/play"]
+];
+var MOVED_TO_EDITOR = [
+  ["volter.adapter.ts", "editor/volter.adapter.ts"],
+  ["src/contributions", "editor/contributions"],
+  ["src/tools", "editor/tools"]
+];
+async function allFiles(path) {
+  let entries;
+  try {
+    entries = await readdir2(path, { withFileTypes: true });
+  } catch {
+    return existsSync3(path) ? [path] : [];
+  }
+  const files = [];
+  for (const entry of entries) {
+    const child = join3(path, entry.name);
+    if (entry.isDirectory()) files.push(...await allFiles(child));
+    else files.push(child);
+  }
+  return files;
+}
+async function scriptFiles(dir) {
+  const files = [];
+  let entries;
+  try {
+    entries = await readdir2(dir, { withFileTypes: true });
+  } catch {
+    return files;
+  }
+  for (const entry of entries) {
+    if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+    const path = join3(dir, entry.name);
+    if (entry.isDirectory()) files.push(...await scriptFiles(path));
+    else if (/\.(?:[cm]?[jt]sx?)$/.test(entry.name)) files.push(path);
+  }
+  return files;
+}
+async function projectSourceFiles(project) {
+  const files = [];
+  try {
+    for (const entry of await readdir2(project, { withFileTypes: true })) {
+      if (entry.isFile() && /\.(?:[cm]?[jt]sx?)$/.test(entry.name)) files.push(join3(project, entry.name));
+    }
+  } catch {
+  }
+  for (const folder of ["editor", "src", "scripts"]) files.push(...await scriptFiles(join3(project, folder)));
+  return files;
+}
+function rewriteMovedPaths(text2) {
+  return text2.replace(/(^|[^\w./-])(\.\/)?src\/(contributions|tools)(?=$|[/'"`\s),;:\]]|\.$)/gm, "$1$2editor/$3").replace(/(^|[^\w./-])(\.\/)?volter\.adapter\.ts\b/gm, "$1$2editor/volter.adapter.ts");
+}
+async function projectTextFiles(project) {
+  const files = [];
+  try {
+    for (const entry of await readdir2(project, { withFileTypes: true })) {
+      if (entry.isFile() && /(?:\.md|^tsconfig(?:\.[\w-]+)?\.json)$/i.test(entry.name)) files.push(join3(project, entry.name));
+    }
+  } catch {
+  }
+  const under = async (dir, pattern) => {
+    for (const path of await allFiles(dir)) if (!path.includes(`${sep}node_modules${sep}`) && pattern.test(path)) files.push(path);
+  };
+  for (const folder of [".claude", ".agents", ".github"]) await under(join3(project, folder), /\.md$/i);
+  await under(join3(project, ".volter", "catalog"), /\.json$/i);
+  if (existsSync3(join3(project, ".volter", "scaffold-baseline.json"))) files.push(join3(project, ".volter", "scaffold-baseline.json"));
+  return files;
+}
+function renameKitSpecifiers(text2) {
+  let out = text2;
+  for (const [from, to] of RENAMED_KIT_PACKAGES) {
+    out = out.replace(new RegExp(`(['"\`]|node_modules\\/)${from.replace("/", "\\/")}(?=[/'"\`])`, "g"), `$1${to}`);
+  }
+  return out;
+}
+function rebaseRelativeSpecifiers(text2, fromDir, toDir, moved) {
+  return text2.replace(
+    /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*|\bnew\s+URL\s*\(\s*|\bimport\.meta\.glob\s*\(\s*)(['"`])(\.{1,2}(?:\/[^'"`]*)?)\2/g,
+    (whole, lead, quote, spec) => {
+      const target = resolve2(fromDir, spec);
+      if (fromDir === toDir && moved(target) === target) return whole;
+      let next = relative2(toDir, moved(target)).split("\\").join("/");
+      if (next === "") next = ".";
+      if (!next.startsWith(".")) next = `./${next}`;
+      if (spec.endsWith("/") && !next.endsWith("/")) next = `${next}/`;
+      return `${lead}${quote}${next}${quote}`;
+    }
+  );
+}
 function wholeWord(text2) {
   return new RegExp(`(?<![\\w-])${text2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?![\\w-])`, "g");
 }
@@ -16704,6 +16813,9 @@ function declaredVersion(spec) {
   const bare = spec?.replace(/^[\^~=v]+/, "");
   return bare !== void 0 && EXACT_VERSION.test(bare) ? bare : null;
 }
+function kitVersion(spec) {
+  return declaredVersion(spec) ?? spec?.match(/^file:.*-(\d+\.\d+\.\d+)\.tgz$/)?.[1] ?? null;
+}
 async function writeAll(files) {
   const temp = (path) => `${path}.upgrade-${process.pid}.tmp`;
   try {
@@ -16719,7 +16831,7 @@ async function writeAll(files) {
       moved.push(file3);
     }
   } catch (error50) {
-    for (const file3 of moved) await writeFile2(file3.path, file3.original).catch(() => {
+    for (const file3 of moved) await (file3.created ? rm(file3.path, { force: true }) : writeFile2(file3.path, file3.original)).catch(() => {
     });
     await Promise.all(files.map((file3) => rm(temp(file3.path), { force: true })));
     throw new Error(`The upgrade could not be put in place, and what had moved was put back: ${error50 instanceof Error ? error50.message : String(error50)}`);
@@ -16756,11 +16868,11 @@ function jsonLayout(raw) {
 }
 function npmView(spec) {
   return new Promise((done, fail) => {
-    const child = spawn2("npm", ["view", spec, "version", "dependencies", "--json"], {
-      windowsHide: true,
-      stdio: ["ignore", "pipe", "pipe"],
-      shell: process.platform === "win32"
-    });
+    if (!/^@?[\w.-]+(?:\/[\w.-]+)?@[\w.+-]+$/.test(spec)) {
+      fail(new Error(`${spec} is not a package and a version or tag.`));
+      return;
+    }
+    const child = process.platform === "win32" ? spawn2(`npm view ${spec} version dependencies --json`, { windowsHide: true, stdio: ["ignore", "pipe", "pipe"], shell: true }) : spawn2("npm", ["view", spec, "version", "dependencies", "--json"], { stdio: ["ignore", "pipe", "pipe"] });
     let out = "";
     let err = "";
     child.stdout.on("data", (chunk) => {
@@ -16816,7 +16928,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   const warnings = [];
   const packageRaw = await readFile2(packagePath, "utf8");
   const pkg = JSON.parse(packageRaw);
-  const previousKit = pkg.devDependencies?.["@volter/project"] ?? pkg.dependencies?.["@volter/project"];
+  const previousKit = pkg.devDependencies?.["@volter/project"] ?? pkg.dependencies?.["@volter/project"] ?? pkg.devDependencies?.["@volter/editor-project"] ?? pkg.dependencies?.["@volter/editor-project"];
   const currentProduct = declaredVersion(pkg.dependencies?.[product.packageName] ?? pkg.devDependencies?.[product.packageName]);
   for (const section of ["peerDependencies", "optionalDependencies"]) {
     for (const [name, current] of Object.entries(pkg[section] ?? {})) {
@@ -16868,12 +16980,91 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
       changed.push(`${file3}: names ${product.packageName} and \`${product.command}\``);
     }
   }
+  for (const section of ["dependencies", "devDependencies"]) {
+    const declared = pkg[section];
+    if (declared === void 0) continue;
+    for (const [from, to] of RENAMED_KIT_PACKAGES) {
+      const current = declared[from];
+      if (current === void 0) continue;
+      if (declared[to] !== void 0) {
+        delete declared[from];
+        changed.push(`package.json ${section}: ${from} removed (${to} is already declared)`);
+      } else {
+        pkg[section] = renameKey(pkg[section], from, to, current);
+        changed.push(`package.json ${section}: ${from} -> ${to}`);
+      }
+      packagesChanged = true;
+    }
+  }
+  const projectPath = (path) => relative2(project, path).split("\\").join("/");
+  const moves = [];
+  for (const [from, to] of MOVED_TO_EDITOR) {
+    const source = join3(project, from);
+    if (existsSync3(source)) moves.push({ from: source, to: join3(project, to) });
+  }
+  const movedPath = (path) => {
+    for (const move of moves) {
+      if (path === move.from) return move.to;
+      if (path.startsWith(move.from + sep)) return move.to + path.slice(move.from.length);
+      const bare = move.from.replace(/\.ts$/, "");
+      if (bare !== move.from && (path === bare || path === `${bare}.js`)) return move.to.replace(/\.ts$/, "") + path.slice(bare.length);
+    }
+    return path;
+  };
+  const collides = (path) => movedPath(path) !== path && existsSync3(movedPath(path));
+  const stranded = [];
+  for (const move of moves) for (const path of await allFiles(move.from)) if (collides(path)) stranded.push(path);
+  for (const path of stranded)
+    kept.push(`${projectPath(path)} stays where it is and is not read: ${projectPath(movedPath(path))} already exists; keep one of the two by hand`);
+  const willMove = (path) => movedPath(path) !== path && !stranded.includes(path);
+  const leftBehind = [];
+  for (const path of await projectSourceFiles(project)) {
+    const original = await readFile2(path, "utf8");
+    const destination = willMove(path) ? movedPath(path) : path;
+    const content = rewriteMovedPaths(
+      rebaseRelativeSpecifiers(renameKitSpecifiers(original), dirname2(path), dirname2(destination), (p) => willMove(p) ? movedPath(p) : p)
+    );
+    if (destination !== path) {
+      textFiles.push({ path: destination, content, original: "", created: true });
+      leftBehind.push(path);
+    } else if (content !== original) {
+      textFiles.push({ path, content, original });
+      changed.push(`${projectPath(path)}: names the kit's current packages and the moved files where they now are`);
+      if (path.startsWith(join3(project, "src") + sep) && !stranded.includes(path) && /(['"`])(?:\.{1,2}\/)+[^'"`]*\beditor\//.test(content) && !/(['"`])(?:\.{1,2}\/)+[^'"`]*\beditor\//.test(original))
+        kept.push(`${projectPath(path)} now imports from editor/, which a game build refuses from 0.5.203: move what it uses out of editor/ (src/ is the game)`);
+    }
+  }
+  for (const move of moves) {
+    if ((await allFiles(move.from)).some((path) => !stranded.includes(path)))
+      changed.push(`${projectPath(move.from)} -> ${projectPath(move.to)} (a project's editor side lives in editor/ from 0.5.203)`);
+  }
+  for (const path of await projectTextFiles(project)) {
+    const original = await readFile2(path, "utf8");
+    const content = rewriteMovedPaths(renameKitSpecifiers(original));
+    if (content === original) continue;
+    textFiles.push({ path, content, original });
+    changed.push(`${projectPath(path)}: names the moved files and the kit's packages where they now are`);
+  }
+  const volter = pkg["volter"];
+  const tools = volter !== null && typeof volter === "object" && !Array.isArray(volter) ? volter.tools : void 0;
+  if (Array.isArray(tools)) {
+    const rewritten = tools.map((registration) => {
+      const entry = typeof registration === "string" ? registration : registration?.entry;
+      if (typeof entry !== "string" || !entry.startsWith("./")) return registration;
+      const next = `./${projectPath(movedPath(join3(project, entry.slice(2))))}`;
+      if (next === entry) return registration;
+      changed.push(`package.json volter.tools: ${entry} -> ${next}`);
+      packagesChanged = true;
+      return typeof registration === "string" ? next : { ...registration, entry: next };
+    });
+    volter.tools = rewritten;
+  }
   for (const section of ["dependencies", "devDependencies"]) {
     const declared = pkg[section];
     if (!declared) continue;
     for (const [name, current] of Object.entries(declared)) {
       if (!name.startsWith("@volter/")) continue;
-      const target = name === product.packageName ? release.version : release.dependencies[name] ?? (current === previousKit ? kit : void 0);
+      const target = name === product.packageName ? release.version : release.dependencies[name] ?? (current === previousKit || kitVersion(current) !== null && kitVersion(current) === kitVersion(previousKit) ? kit : void 0);
       if (target === void 0) {
         kept.push(`package.json keeps ${name}@${current}: ${product.packageName}@${release.version} does not name it`);
         continue;
@@ -16881,7 +17072,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
       if (current === target) continue;
       declared[name] = target;
       packagesChanged = true;
-      changed.push(`package.json ${section}: ${name} ${current} -> ${target}`);
+      changed.push(current.startsWith("file:") ? `package.json ${section}: ${name} was the local tarball ${current}; it is now ${target} from the registry` : `package.json ${section}: ${name} ${current} -> ${target}`);
     }
   }
   const manifestPath = join3(project, MANIFEST_FILENAME);
@@ -16901,7 +17092,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
     manifest.engine = { ...manifest.engine, version: engine };
     changed.push(`${MANIFEST_FILENAME} engine.version: ${typeof pinned === "string" ? pinned : "(none)"} -> ${engine}`);
   }
-  const linked = (() => {
+  const linked = product.linksNodeModules === true || (() => {
     try {
       return lstatSync(join3(project, "node_modules")).isSymbolicLink();
     } catch {
@@ -16910,12 +17101,39 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   })();
   const locks = packagesChanged && !linked ? (await Promise.all([join3(project, "package-lock.json"), join3(project, "node_modules", ".package-lock.json")].map(lockWithoutVolter))).filter((lock) => lock !== null) : [];
   if (locks.length > 0) changed.push("package-lock.json: the old @volter rows dropped, so npm install resolves the new ones");
-  await writeAll([
-    ...packagesChanged ? [{ path: packagePath, content: jsonLayout(packageRaw)(pkg), original: packageRaw }] : [],
-    ...pinChanged ? [{ path: manifestPath, content: jsonLayout(manifestRaw)(manifest), original: manifestRaw }] : [],
-    ...textFiles,
-    ...locks
-  ]);
+  const madeDirs = [];
+  for (const file3 of textFiles) {
+    if (!file3.created) continue;
+    const chain = [];
+    for (let dir = dirname2(file3.path); !existsSync3(dir) && dir !== dirname2(dir); dir = dirname2(dir)) chain.unshift(dir);
+    for (const dir of chain) {
+      await mkdir2(dir);
+      madeDirs.push(dir);
+    }
+  }
+  try {
+    await writeAll([
+      ...packagesChanged ? [{ path: packagePath, content: jsonLayout(packageRaw)(pkg), original: packageRaw }] : [],
+      ...pinChanged ? [{ path: manifestPath, content: jsonLayout(manifestRaw)(manifest), original: manifestRaw }] : [],
+      ...textFiles,
+      ...locks
+    ]);
+  } catch (error50) {
+    for (const dir of madeDirs.reverse()) await rmdir(dir).catch(() => void 0);
+    throw error50;
+  }
+  const failed = [];
+  const leftover = (path, error50) => (failed.push(path), kept.push(`${projectPath(path)} could not be removed (${error50 instanceof Error ? error50.message : String(error50)}); the editor does not read it, so delete it by hand`));
+  for (const path of leftBehind) await rm(path).catch((error50) => leftover(path, error50));
+  for (const move of moves) {
+    for (const path of await allFiles(move.from)) {
+      if (leftBehind.includes(path) || stranded.includes(path)) continue;
+      const to = movedPath(path);
+      await mkdir2(dirname2(to), { recursive: true });
+      await rename(path, to).catch((error50) => leftover(path, error50));
+    }
+    if (!move.from.endsWith(".ts") && ![...failed, ...stranded].some((path) => path.startsWith(move.from + sep))) await rm(move.from, { recursive: true, force: true }).catch(() => void 0);
+  }
   for (const line of warnings) console.warn(`! ${line}`);
   console.log(changed.length > 0 ? `Upgraded ${project} to ${product.packageName}@${release.version} (engine ${engine}):` : `${project} is already on ${product.packageName}@${release.version} (engine ${engine}).`);
   for (const line of changed) console.log(`  + ${line}`);
@@ -16957,11 +17175,62 @@ async function startupProject(create, { cwd = process.cwd(), home = homedir() }
 
 // node/chat.ts
 import { connect } from "@volter/live";
+
+// ../sdk/src/session/registry-format.ts
+import {
+  mkdirSync,
+  readdirSync,
+  readFileSync as readFileSync2,
+  realpathSync,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join5, resolve as resolve4 } from "node:path";
+var EDITOR_SESSIONS_REGISTRY_FILE = join5(homedir2(), ".volter", "editor-sessions.json");
+function isEditorSessionEntry(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const s = v;
+  const optionalIdentity = (value) => value === void 0 || value === null || typeof value === "string";
+  return (typeof s["project"] === "string" || s["project"] === null) && typeof s["port"] === "number" && typeof s["pid"] === "number" && typeof s["startedAt"] === "string" && optionalIdentity(s["sessionId"]) && optionalIdentity(s["controlSecret"]) && optionalIdentity(s["repositoryId"]) && optionalIdentity(s["worktreeId"]) && optionalIdentity(s["worktreeRoot"]) && optionalIdentity(s["projectRelativePath"]) && optionalIdentity(s["branch"]) && optionalIdentity(s["headCommit"]) && optionalIdentity(s["baseCommit"]);
+}
+function normalizeEditorSessionEntry(session) {
+  return {
+    ...session,
+    sessionId: session.sessionId ?? null,
+    controlSecret: session.controlSecret ?? null,
+    repositoryId: session.repositoryId ?? null,
+    worktreeId: session.worktreeId ?? null,
+    worktreeRoot: session.worktreeRoot ?? null,
+    projectRelativePath: session.projectRelativePath ?? null,
+    branch: session.branch ?? null,
+    headCommit: session.headCommit ?? null,
+    baseCommit: session.baseCommit ?? null
+  };
+}
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error50) {
+    return error50.code === "EPERM";
+  }
+}
+function readLiveRegisteredSessions() {
+  try {
+    const raw = JSON.parse(readFileSync2(EDITOR_SESSIONS_REGISTRY_FILE, "utf8"));
+    return Array.isArray(raw) ? raw.filter(isEditorSessionEntry).map(normalizeEditorSessionEntry).filter((s) => pidAlive(s.pid)) : [];
+  } catch {
+    return [];
+  }
+}
+
+// node/chat.ts
 var CHAT_USAGE = "chat status | chat send <prompt> | chat stop";
 async function chat(args) {
   const [action, prompt] = args;
   if (!["status", "send", "stop"].includes(action ?? "") || args.length !== (action === "send" ? 2 : 1) || action === "send" && !prompt?.trim()) throw new Error(`Usage: cyclotron ${CHAT_USAGE}`);
-  const { editor } = await connect();
+  const { editor, session } = await connect();
   const state = await editor.command("supercode.frontend.status", true);
   const view = await editor.command("volter.chat.inspect");
   if (action === "status") return { ...state, focusedSessionResource: view.sessionResource };
@@ -16972,8 +17241,38 @@ async function chat(args) {
   if (!connection && !draft || !connection && state.setupHandoff?.complete !== true) {
     throw new Error("Chat is not ready. Open Chat in the editor and choose an agent or complete its sign-in, then run chat status.");
   }
-  if (action === "send" && (state.busy || connection?.pendingRequests?.length)) {
-    throw new Error("Chat has an active turn or a pending request. Finish it in the editor or use chat stop before sending another prompt.");
+  if (action === "send" && connection?.pendingRequests?.length) {
+    throw new Error("Chat is waiting on an approval in the editor. Answer it there (or use chat stop), then send.");
+  }
+  if (action === "send" && state.busy) {
+    const entry = readLiveRegisteredSessions().find((s) => s.port === session.port);
+    const origin = `http://127.0.0.1:${session.port}`;
+    const response = await fetch(`${origin}/__editor/harness-chat/steer`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Origin: origin,
+        ...entry?.controlSecret ? { "x-volter-editor-control": entry.controlSecret } : {}
+      },
+      body: JSON.stringify({ text: prompt })
+    });
+    const said = await response.json().catch(() => null);
+    if (response.ok && said?.queued) {
+      return {
+        queued: true,
+        sessionId: connection?.sessionId,
+        note: "Queued into the running turn: the agent reads it at its next step. Nothing confirms delivery; the Chat shows it when it lands."
+      };
+    }
+    if (said?.state === "waiting") {
+      throw new Error("Chat is waiting on an approval in the editor. Answer it there (or use chat stop), then send.");
+    }
+    if (said?.state === "unknown") {
+      throw new Error("Chat's turn could not be read, so the prompt was not sent (a turn may be running). Run chat status, then send again.");
+    }
+    if (said?.state !== "idle") {
+      throw new Error(`Chat did not take the prompt into its running turn: ${said?.error ?? `HTTP ${response.status}`}`);
+    }
   }
   if (!resource && connection) await editor.command("volter.chat.openSession", `supercode://${connection.id}/conversation`);
   if (action === "stop") {
@@ -17020,14 +17319,14 @@ async function playLog(options) {
 }
 
 // node/add-play.ts
-import { existsSync as existsSync5, lstatSync as lstatSync2, realpathSync, statSync } from "node:fs";
-import { mkdir as mkdir2, readFile as readFile4, readdir as readdir2, rm as rm2, rmdir, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname4, isAbsolute, join as join5, posix, relative as relative2, resolve as resolve4 } from "node:path";
+import { existsSync as existsSync5, lstatSync as lstatSync2, realpathSync as realpathSync2, statSync } from "node:fs";
+import { mkdir as mkdir3, readFile as readFile4, readdir as readdir3, rm as rm2, rmdir as rmdir2, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname as dirname4, isAbsolute, join as join6, posix, relative as relative3, resolve as resolve5 } from "node:path";
 var ADD_PLAY_USAGE = "add-play [folder]    # make a models project playable: Play deps, UI root, a first Play script for its model";
 async function playScripts(project) {
-  const src = join5(project, "src");
+  const src = join6(project, "src");
   if (!existsSync5(src)) return [];
-  const entries = await readdir2(src, { recursive: true });
+  const entries = await readdir3(src, { recursive: true });
   return entries.map((entry) => `src/${entry.replace(/\\/g, "/")}`).filter((path) => path.endsWith(".play.ts") && !path.includes("/node_modules/"));
 }
 function occupied(path) {
@@ -17039,7 +17338,7 @@ function occupied(path) {
   }
 }
 function inside(root, path) {
-  const rel = relative2(root, path);
+  const rel = relative3(root, path);
   return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
 }
 function blocked(project, realProject, path) {
@@ -17049,13 +17348,13 @@ function blocked(project, realProject, path) {
     if (!occupied(dir)) continue;
     if (deepest === project) deepest = dir;
     try {
-      if (!statSync(dir).isDirectory()) return `${relative2(project, dir)} is not a folder`;
+      if (!statSync(dir).isDirectory()) return `${relative3(project, dir)} is not a folder`;
     } catch {
-      return `${relative2(project, dir)} is a dangling link`;
+      return `${relative3(project, dir)} is a dangling link`;
     }
   }
-  const real = realpathSync(deepest);
-  if (!inside(realProject, real)) return `${relative2(project, deepest) || "."} resolves outside the project, to ${real}`;
+  const real = realpathSync2(deepest);
+  if (!inside(realProject, real)) return `${relative3(project, deepest) || "."} resolves outside the project, to ${real}`;
   return null;
 }
 function missingFolders(project, file3) {
@@ -17065,14 +17364,14 @@ function missingFolders(project, file3) {
 }
 async function playModel(project, adapter) {
   const declared = adapter === null ? void 0 : /default:\s*'model:(src\/models\/[^']+\.blend)'/.exec(adapter)?.[1];
-  if (declared !== void 0 && existsSync5(join5(project, declared))) return declared;
-  const models = join5(project, "src", "models");
-  const blends = existsSync5(models) ? (await readdir2(models, { recursive: true })).map((entry) => `src/models/${entry.replace(/\\/g, "/")}`).filter((path) => path.endsWith(".blend")) : [];
+  if (declared !== void 0 && existsSync5(join6(project, declared))) return declared;
+  const models = join6(project, "src", "models");
+  const blends = existsSync5(models) ? (await readdir3(models, { recursive: true })).map((entry) => `src/models/${entry.replace(/\\/g, "/")}`).filter((path) => path.endsWith(".blend")) : [];
   if (blends.length === 1) return blends[0];
   return { why: blends.length === 0 ? "the project has no src/models/*.blend for it to drive" : `the project has ${blends.length} models (${blends.join(", ")}) and its adapter's default document is none of them` };
 }
 async function firstPlaySet(model) {
-  const starter = (name) => readFile4(join5(productRoot, "starter", "add-play", name), "utf8");
+  const starter = (name) => readFile4(join6(productRoot, "starter", "add-play", name), "utf8");
   const folder = posix.dirname(model);
   const state = posix.relative(posix.dirname(PLAY_SCAFFOLD.uiRoot.entry), posix.join(folder, "game-state"));
   return [
@@ -17088,11 +17387,11 @@ function jsonLayout2(raw) {
   return (value) => JSON.stringify(value, null, indent).replace(/\n/g, eol) + trailing;
 }
 async function addPlay(folder) {
-  const project = resolve4(folder);
-  const manifestPath = join5(project, MANIFEST_FILENAME);
+  const project = resolve5(folder);
+  const manifestPath = join6(project, MANIFEST_FILENAME);
   if (!existsSync5(manifestPath)) throw new Error(`${project} is not a Cyclotron project: it has no ${MANIFEST_FILENAME}.`);
-  const realProject = realpathSync(project);
-  const packagePath = join5(project, "package.json");
+  const realProject = realpathSync2(project);
+  const packagePath = join6(project, "package.json");
   if (!existsSync5(packagePath)) throw new Error(`${project} has no package.json to declare the Play dependencies in.`);
   const { kit } = await productVersions();
   const added = [];
@@ -17112,7 +17411,7 @@ async function addPlay(folder) {
       added.push(`package.json ${section}: ${name}@${version3}`);
     }
   }
-  const adapterPath = join5(project, "editor/volter.adapter.ts");
+  const adapterPath = join6(project, "editor/volter.adapter.ts");
   const adapterSource = existsSync5(adapterPath) ? await readFile4(adapterPath, "utf8") : null;
   let model = null;
   let example = null;
@@ -17126,7 +17425,7 @@ async function addPlay(folder) {
     } else {
       const set3 = await firstPlaySet(chosen);
       const refusals = set3.flatMap(({ to }) => {
-        const reason = blocked(project, realProject, join5(project, to));
+        const reason = blocked(project, realProject, join6(project, to));
         return reason === null ? [] : [`${to}: ${reason}`];
       });
       if (refusals.length > 0) {
@@ -17144,7 +17443,7 @@ async function addPlay(folder) {
   const roots = manifest.roots ?? [];
   if (roots.some((root) => root.id === PLAY_SCAFFOLD.uiRoot.id)) {
     kept.push(`${MANIFEST_FILENAME} already has a "${PLAY_SCAFFOLD.uiRoot.id}" root`);
-  } else if (example !== null || existsSync5(join5(project, PLAY_SCAFFOLD.uiRoot.entry))) {
+  } else if (example !== null || existsSync5(join6(project, PLAY_SCAFFOLD.uiRoot.entry))) {
     manifest.roots = [...roots, { ...PLAY_SCAFFOLD.uiRoot }];
     manifestChanged = true;
     added.push(`${MANIFEST_FILENAME} root: ${JSON.stringify(PLAY_SCAFFOLD.uiRoot)}`);
@@ -17172,7 +17471,7 @@ async function addPlay(folder) {
     }
     adapter = { original: adapterSource, next };
   }
-  const tsconfigPath = join5(project, "tsconfig.json");
+  const tsconfigPath = join6(project, "tsconfig.json");
   const writeTsconfig = !occupied(tsconfigPath);
   if (writeTsconfig) added.push("tsconfig.json");
   else if (!existsSync5(tsconfigPath))
@@ -17182,9 +17481,9 @@ async function addPlay(folder) {
     const created = /* @__PURE__ */ new Set();
     try {
       for (const { to, content } of example) {
-        const target = join5(project, to);
+        const target = join6(project, to);
         for (const dir of missingFolders(project, target)) created.add(dir);
-        await mkdir2(dirname4(target), { recursive: true });
+        await mkdir3(dirname4(target), { recursive: true });
         await writeFile3(target, content, { flag: "wx" });
         written.push(target);
       }
@@ -17193,9 +17492,9 @@ async function addPlay(folder) {
       const remaining = [];
       for (const dir of [...created].sort((a, b) => b.length - a.length)) {
         try {
-          await rmdir(dir);
+          await rmdir2(dir);
         } catch {
-          if (occupied(dir)) remaining.push(relative2(project, dir));
+          if (occupied(dir)) remaining.push(relative3(project, dir));
         }
       }
       const reason = error50 instanceof Error ? error50.message : String(error50);
@@ -17214,7 +17513,7 @@ async function addPlay(folder) {
   console.log("Next:");
   const linked = (() => {
     try {
-      return lstatSync2(join5(project, "node_modules")).isSymbolicLink();
+      return lstatSync2(join6(project, "node_modules")).isSymbolicLink();
     } catch {
       return false;
     }
@@ -17317,7 +17616,7 @@ The play log has the entry: cyclotron play-log --kind script-error${documentId ?
       lastProgressAt = now;
       console.error(`Play is on; waiting for the game's first frame (${Math.round((now - startedAt) / 1e3)}s). The tab draws frames only while it is visible \u2014 is it hidden or minimised?`);
     }
-    await new Promise((resolve13) => setTimeout(resolve13, 250));
+    await new Promise((resolve14) => setTimeout(resolve14, 250));
     current = await state(args);
   }
   return current;
@@ -17330,9 +17629,10 @@ var __export2 = (target, all) => {
     __defProp2(target, name, { get: all[name], enumerable: true });
 };
 
-// ../editor-core/dist/server/chunk-OFYTOZI6.js
+// ../editor-core/dist/server/chunk-D2E2T73W.js
 import { existsSync as existsSync6 } from "node:fs";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
+var MANIFEST_FILENAME2 = "volter.project.json";
 var ADAPTER_MODULE_FILENAME = "editor/volter.adapter.ts";
 var external_exports2 = {};
 __export2(external_exports2, {
@@ -31194,7 +31494,26 @@ var ProjectCompatibilityError = class extends Error {
 };
 function assertProjectAdapter(projectRoot, product) {
   if (product === null || product.adapterRequired !== true) return;
-  if (existsSync6(join6(projectRoot, ADAPTER_MODULE_FILENAME))) return;
+  if (existsSync6(join7(projectRoot, ADAPTER_MODULE_FILENAME))) return;
+  if (existsSync6(join7(projectRoot, "volter.adapter.ts"))) {
+    throw new ProjectCompatibilityError(
+      `${projectRoot} keeps its adapter at its root (volter.adapter.ts), where projects made before 0.5.203 kept it; this editor reads ${ADAPTER_MODULE_FILENAME}.`,
+      {
+        kind: "bring-project-up-to-date",
+        title: "Bring this project up to date",
+        guidance: product.upgrade === true ? `To move it: npx ${product.name}@latest upgrade, in the project folder. It moves the adapter into editor/ and the kit's packages to their current names; then npm install, and open the project again.` : `To move it: put volter.adapter.ts, src/contributions and src/tools into editor/, and rename the kit's packages (@volter/editor-project, editor-sdk, editor-live and editor-model-play are @volter/project, sdk, live and play); then npm install, and open the project again.`,
+        summary: "adapter at the project root"
+      }
+    );
+  }
+  if (existsSync6(join7(projectRoot, MANIFEST_FILENAME2))) {
+    throw new ProjectCompatibilityError(`${projectRoot} is a project with no ${ADAPTER_MODULE_FILENAME}.`, {
+      kind: "bring-project-up-to-date",
+      title: "Bring this project up to date",
+      guidance: `Add one: a project made by npx ${product.name} create <another folder> has an ${ADAPTER_MODULE_FILENAME} to copy into this project's editor/ folder; then open this project again.`,
+      summary: "no adapter"
+    });
+  }
   throw new ProjectCompatibilityError(`${projectRoot} has no ${ADAPTER_MODULE_FILENAME}.`, {
     kind: "make-project",
     title: "Make a project",
@@ -31272,9 +31591,9 @@ function describeEditorBootFailure(outcome, ctx) {
 }
 
 // ../editor-core/dist/server/chunk-SDCQ4SU3.js
-import { existsSync as existsSync7, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync3 } from "node:fs";
 import { createRequire } from "node:module";
-import { dirname as dirname5, join as join7 } from "node:path";
+import { dirname as dirname5, join as join8 } from "node:path";
 import { pathToFileURL } from "node:url";
 var PRODUCT_DECLARATION_KEY = "volter.product";
 var PRODUCT_INSTALL_LINES = [
@@ -31284,10 +31603,10 @@ var PRODUCT_INSTALL_LINES = [
 var PRODUCT_CREATE_LINES = ["  npx @volter/editor-core create <name>"];
 var PRODUCT_COLOR_THEMES = ["dark", "light"];
 function readProductManifest(packageDir) {
-  const manifestPath = join7(packageDir, "package.json");
+  const manifestPath = join8(packageDir, "package.json");
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync2(manifestPath, "utf8"));
+    manifest = JSON.parse(readFileSync3(manifestPath, "utf8"));
   } catch {
     return null;
   }
@@ -31298,7 +31617,7 @@ function readProductManifest(packageDir) {
     throw new Error(
       `${manifestPath} declares ${PRODUCT_DECLARATION_KEY} but its "entry" is ${JSON.stringify(entry)}. It must be a ./-relative module \u2014 the product's ONE source entry, which is also its frame entry (e.g. "./src/index.ts").`
     );
-  const resolved = join7(packageDir, entry);
+  const resolved = join8(packageDir, entry);
   if (!existsSync7(resolved))
     throw new Error(
       `${manifestPath} declares ${PRODUCT_DECLARATION_KEY}.entry ${JSON.stringify(entry)}, which does not exist (${resolved}).`
@@ -31398,7 +31717,7 @@ function declaredVolterPackages(projectRoot) {
   let manifest;
   try {
     manifest = JSON.parse(
-      readFileSync2(join7(projectRoot, "package.json"), "utf8")
+      readFileSync3(join8(projectRoot, "package.json"), "utf8")
     );
   } catch {
     return [];
@@ -31406,16 +31725,16 @@ function declaredVolterPackages(projectRoot) {
   return Object.keys({ ...manifest.dependencies ?? {}, ...manifest.devDependencies ?? {} }).filter((name) => name.startsWith("@volter/")).sort();
 }
 function locatePackage(projectRoot, name) {
-  const require2 = createRequire(pathToFileURL(join7(projectRoot, "package.json")));
+  const require2 = createRequire(pathToFileURL(join8(projectRoot, "package.json")));
   try {
     return dirname5(require2.resolve(`${name}/package.json`));
   } catch {
     try {
       let dir = dirname5(require2.resolve(name));
       for (; ; ) {
-        const candidate = join7(dir, "package.json");
+        const candidate = join8(dir, "package.json");
         try {
-          if (JSON.parse(readFileSync2(candidate, "utf8")).name === name)
+          if (JSON.parse(readFileSync3(candidate, "utf8")).name === name)
             return dir;
         } catch {
         }
@@ -31465,30 +31784,30 @@ import { createHash } from "node:crypto";
 import {
   createWriteStream,
   existsSync as existsSync8,
-  mkdirSync,
-  readFileSync as readFileSync3,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync4,
   renameSync,
   rmSync,
-  writeFileSync
+  writeFileSync as writeFileSync2
 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { basename, isAbsolute as isAbsolute2, join as join8, resolve as resolve5, sep } from "node:path";
+import { homedir as homedir3 } from "node:os";
+import { basename, isAbsolute as isAbsolute2, join as join9, resolve as resolve6, sep as sep2 } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 var WORKBENCH_LOCATOR_PATH = ".volter/workbench.json";
 var RELEASE_RECORD = "BUILD.json";
-var SOURCES_LAUNCHER = join8("scripts", "code-server.sh");
+var SOURCES_LAUNCHER = join9("scripts", "code-server.sh");
 var OVERLAY_RECORD = ".volter-overlay.json";
 function workbenchDeclarationExample(projectRoot) {
-  return `${join8(projectRoot, WORKBENCH_LOCATOR_PATH)}:
+  return `${join9(projectRoot, WORKBENCH_LOCATOR_PATH)}:
   { "workbench": "<path to an extracted Code-OSS release, or to a fork checkout>" }`;
 }
 function readWorkbenchDeclaration(projectRoot) {
-  const file3 = join8(projectRoot, WORKBENCH_LOCATOR_PATH);
+  const file3 = join9(projectRoot, WORKBENCH_LOCATOR_PATH);
   if (!existsSync8(file3)) return null;
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync3(file3, "utf8"));
+    parsed = JSON.parse(readFileSync4(file3, "utf8"));
   } catch (error50) {
     throw new Error(
       `${file3} is not valid JSON (${error50 instanceof Error ? error50.message : String(error50)}). It says which Code-OSS workbench this project opens in, and nothing else:
@@ -31516,27 +31835,27 @@ ${workbenchDeclarationExample(projectRoot)}`
 ${workbenchDeclarationExample(projectRoot)}`
     );
   }
-  return isAbsolute2(declared) ? resolve5(declared) : resolve5(projectRoot, declared);
+  return isAbsolute2(declared) ? resolve6(declared) : resolve6(projectRoot, declared);
 }
 function writeWorkbenchDeclaration(projectRoot, workbenchDir) {
-  mkdirSync(join8(projectRoot, ".volter"), { recursive: true });
-  writeFileSync(
-    join8(projectRoot, WORKBENCH_LOCATOR_PATH),
-    `${JSON.stringify({ workbench: resolve5(workbenchDir) }, null, 2)}
+  mkdirSync2(join9(projectRoot, ".volter"), { recursive: true });
+  writeFileSync2(
+    join9(projectRoot, WORKBENCH_LOCATOR_PATH),
+    `${JSON.stringify({ workbench: resolve6(workbenchDir) }, null, 2)}
 `
   );
 }
 function workbenchUrl(proxyPort, projectRoot) {
-  const id = basename(resolve5(projectRoot));
-  const hostId = createHash("sha256").update(resolve5(projectRoot)).digest("hex").slice(0, 16);
+  const id = basename(resolve6(projectRoot));
+  const hostId = createHash("sha256").update(resolve6(projectRoot)).digest("hex").slice(0, 16);
   return `http://editor-${hostId}.localhost:${proxyPort}/?project=${encodeURIComponent(id)}`;
 }
 function machinePlatform() {
   return `${process.platform}-${process.arch}`;
 }
 function resolveWorkbench(dir, expectedProduct) {
-  const root = resolve5(dir);
-  const resolved = existsSync8(join8(root, RELEASE_RECORD)) ? resolveRelease(root) : existsSync8(join8(root, SOURCES_LAUNCHER)) ? resolveSources(root) : null;
+  const root = resolve6(dir);
+  const resolved = existsSync8(join9(root, RELEASE_RECORD)) ? resolveRelease(root) : existsSync8(join9(root, SOURCES_LAUNCHER)) ? resolveSources(root) : null;
   if (resolved === null) {
     throw new Error(
       `${root} is neither a Code-OSS release nor a fork checkout: it carries no ${RELEASE_RECORD} (the record scripts/workbench/build-release.mjs writes beside its tarball) and no ${SOURCES_LAUNCHER}. Name the directory the release was extracted into, or the fork checkout itself.`
@@ -31552,11 +31871,11 @@ function resolveWorkbench(dir, expectedProduct) {
   return resolved;
 }
 function resolveRelease(dir) {
-  const record3 = join8(dir, RELEASE_RECORD);
+  const record3 = join9(dir, RELEASE_RECORD);
   const cut = `node scripts/workbench/build-release.mjs --product <id> --platform ${machinePlatform()} --checkout <fork dir> --out ${dir}`;
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync3(record3, "utf8"));
+    parsed = JSON.parse(readFileSync4(record3, "utf8"));
   } catch (error50) {
     throw new Error(`${record3} could not be read: ${String(error50)}`);
   }
@@ -31580,13 +31899,13 @@ function resolveRelease(dir) {
   node scripts/workbench/build-release.mjs --product ${product} --platform ${machine} --checkout <fork dir>`
     );
   }
-  const packageRoot = join8(dir, target);
-  const serverBinPath = join8(packageRoot, serverBin);
+  const packageRoot = join9(dir, target);
+  const serverBinPath = join9(packageRoot, serverBin);
   if (!existsSync8(serverBinPath)) {
     const tarball = typeof parsed["tarball"] === "string" ? parsed["tarball"] : `${target}-<commit>.tar.gz`;
     throw new Error(
       `${dir} records ${target}, but ${serverBinPath} is not there \u2014 the tarball has not been extracted beside ${RELEASE_RECORD}. Run:
-  tar -xzf ${join8(dir, tarball)} -C ${dir}`
+  tar -xzf ${join9(dir, tarball)} -C ${dir}`
     );
   }
   return { kind: "release", dir, commit, product, serverBin: serverBinPath, cwd: packageRoot };
@@ -31600,7 +31919,7 @@ function resolveSources(dir) {
       `${dir} carries ${SOURCES_LAUNCHER}, so it reads as a Code-OSS fork checkout, but \`git rev-parse HEAD\` there failed (${error50 instanceof Error ? error50.message : String(error50)}). A checkout's commit is the only record of which fork this workbench is.`
     );
   }
-  const marker = join8(dir, OVERLAY_RECORD);
+  const marker = join9(dir, OVERLAY_RECORD);
   if (!existsSync8(marker)) {
     throw new Error(
       `${dir} is a Code-OSS checkout with no volter overlay: ${OVERLAY_RECORD} is not there, so nothing of the editor is compiled into it and the workbench would come up as plain Code-OSS. Overlay and compile it:
@@ -31609,7 +31928,7 @@ function resolveSources(dir) {
   }
   let product;
   try {
-    product = JSON.parse(readFileSync3(marker, "utf8"))["product"];
+    product = JSON.parse(readFileSync4(marker, "utf8"))["product"];
   } catch (error50) {
     throw new Error(`${marker} could not be read: ${String(error50)}`);
   }
@@ -31623,24 +31942,24 @@ function resolveSources(dir) {
     dir,
     commit,
     product,
-    serverBin: join8(dir, SOURCES_LAUNCHER),
+    serverBin: join9(dir, SOURCES_LAUNCHER),
     cwd: dir
   };
 }
 var RELEASE_REPO = "volter-ai/code-oss";
-var WORKBENCH_CACHE_ROOT = join8(homedir2(), ".volter", "workbenches");
+var WORKBENCH_CACHE_ROOT = join9(homedir3(), ".volter", "workbenches");
 async function resolveWorkbenchForProject(options) {
   const { projectRoot, product, override, io } = options;
   const productId = workbenchProductId(product.name);
   if (override !== void 0)
     return {
-      ...resolveWorkbench(resolve5(override), productId),
+      ...resolveWorkbench(resolve6(override), productId),
       source: "flag",
       tag: null,
       fetched: false
     };
   const declared = readWorkbenchDeclaration(projectRoot);
-  const fetchRecord = declared !== null && product.workbench !== null && declared.startsWith(`${WORKBENCH_CACHE_ROOT}${sep}`);
+  const fetchRecord = declared !== null && product.workbench !== null && declared.startsWith(`${WORKBENCH_CACHE_ROOT}${sep2}`);
   if (declared !== null && !fetchRecord)
     return {
       ...resolveWorkbench(declared, productId),
@@ -31652,8 +31971,8 @@ async function resolveWorkbenchForProject(options) {
     `${product.name} is a private source product with no released workbench. Pass --workbench <compiled checkout> or declare it in ${WORKBENCH_LOCATOR_PATH}. Public distribution requires a pinned workbench release and checksum.`
   );
   const tag = product.workbench.release;
-  const dir = join8(WORKBENCH_CACHE_ROOT, tag);
-  const fetched = !existsSync8(join8(dir, RELEASE_RECORD));
+  const dir = join9(WORKBENCH_CACHE_ROOT, tag);
+  const fetched = !existsSync8(join9(dir, RELEASE_RECORD));
   if (fetched) await fetchDeclaredRelease(product, tag, dir, io);
   else io.log(`Workbench ${tag} is already installed (${dir}).`);
   const workbench = resolveWorkbench(dir, productId);
@@ -31734,7 +32053,7 @@ async function fetchDeclaredRelease(product, tag, dir, io) {
   const productId = workbenchProductId(product.name);
   const machine = machinePlatform();
   const token = githubToken();
-  const partial3 = join8(WORKBENCH_CACHE_ROOT, `.${tag}.${process.pid}.partial`);
+  const partial3 = join9(WORKBENCH_CACHE_ROOT, `.${tag}.${process.pid}.partial`);
   const cutLine = `  node scripts/workbench/build-release.mjs --product ${productId} --platform ${machine} --checkout <fork dir> --publish`;
   const releaseUrl = `https://api.github.com/repos/${RELEASE_REPO}/releases/tags/${encodeURIComponent(tag)}`;
   const response = await downloadOperation(
@@ -31770,7 +32089,7 @@ ${tokenDoors()}` : "")
 ${cutLine}`
     );
   rmSync(partial3, { recursive: true, force: true });
-  mkdirSync(partial3, { recursive: true });
+  mkdirSync2(partial3, { recursive: true });
   try {
     const recordText = await downloadAssetText(record3, token);
     const built = await downloadOperation(
@@ -31788,11 +32107,11 @@ ${cutLine}`
       throw new Error(
         `Release ${tag}'s own ${RELEASE_RECORD} records tarballSha256 ${String(built["tarballSha256"])} and ${product.name} pins ${product.workbench.tarballSha256}. A release is immutable, so these two cannot disagree about one tag: either the product declares the wrong release, or the release was replaced. Nothing was downloaded.`
       );
-    writeFileSync(join8(partial3, RELEASE_RECORD), recordText);
+    writeFileSync2(join9(partial3, RELEASE_RECORD), recordText);
     io.log(
       `Fetching the ${productId} workbench ${tag} from ${RELEASE_REPO} \u2014 ${megabytes(tarball.size)} MB, once per machine.`
     );
-    const tarballPath = join8(partial3, tarball.name);
+    const tarballPath = join9(partial3, tarball.name);
     let announced = 0;
     const sha = await downloadAsset(tarball, token, tarballPath, (received) => {
       if (received - announced < 4 * 1024 ** 2 && received !== tarball.size) return;
@@ -31806,13 +32125,13 @@ ${cutLine}`
         `The download of ${tag} hashes to ${sha} and ${product.name} pins ${product.workbench.tarballSha256}. These are not the bytes this product runs in; the partial download was deleted and nothing was extracted.`
       );
     io.log(`  sha256 ${sha.slice(0, 12)}\u2026 matches the pin. Extracting\u2026`);
-    const tar = process.platform === "win32" ? join8(process.env["SystemRoot"] ?? "C:\\Windows", "System32", "tar.exe") : "tar";
+    const tar = process.platform === "win32" ? join9(process.env["SystemRoot"] ?? "C:\\Windows", "System32", "tar.exe") : "tar";
     execFileSync(tar, ["-xzf", tarballPath, "-C", partial3], {
       windowsHide: true,
       stdio: ["ignore", "ignore", "pipe"]
     });
     rmSync(tarballPath, { force: true });
-    if (existsSync8(join8(dir, RELEASE_RECORD))) {
+    if (existsSync8(join9(dir, RELEASE_RECORD))) {
       rmSync(partial3, { recursive: true, force: true });
     } else {
       rmSync(dir, { recursive: true, force: true });
@@ -31870,8 +32189,8 @@ async function downloadAsset(asset, token, destination, onProgress) {
 // ../editor-core/dist/server/chunk-VNHTPCBZ.js
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { createHash as createHash2 } from "node:crypto";
-import { realpathSync as realpathSync2 } from "node:fs";
-import { basename as basename2, isAbsolute as isAbsolute3, relative as relative3, resolve as resolve6 } from "node:path";
+import { realpathSync as realpathSync3 } from "node:fs";
+import { basename as basename2, isAbsolute as isAbsolute3, relative as relative4, resolve as resolve7 } from "node:path";
 function hash3(value) {
   return createHash2("sha256").update(value).digest("hex").slice(0, 24);
 }
@@ -31880,9 +32199,9 @@ function worktreeIdForRoot(repositoryId, worktreeRoot) {
 }
 function canonical(path) {
   try {
-    return realpathSync2(path);
+    return realpathSync3(path);
   } catch {
-    return resolve6(path);
+    return resolve7(path);
   }
 }
 function git(cwd, args) {
@@ -31899,7 +32218,7 @@ function git(cwd, args) {
 }
 function resolveGitPath(worktreeRoot, rawPath) {
   if (!rawPath) return null;
-  return canonical(isAbsolute3(rawPath) ? rawPath : resolve6(worktreeRoot, rawPath));
+  return canonical(isAbsolute3(rawPath) ? rawPath : resolve7(worktreeRoot, rawPath));
 }
 function defaultBaseCommit(worktreeRoot, headCommit) {
   if (!headCommit) return null;
@@ -31942,7 +32261,7 @@ function resolveWorktreeIdentity(projectRoot) {
   const repositoryId = `repository-${hash3(repositoryKey)}`;
   const branch = git(worktreeRoot, ["symbolic-ref", "--quiet", "--short", "HEAD"]);
   const headCommit = git(worktreeRoot, ["rev-parse", "--verify", "HEAD"]);
-  const projectRelativePath = relative3(worktreeRoot, project) || ".";
+  const projectRelativePath = relative4(worktreeRoot, project) || ".";
   if (projectRelativePath === ".." || projectRelativePath.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`)) {
     throw new Error(`Project ${project} is outside its reported Git worktree ${worktreeRoot}.`);
   }
@@ -31959,24 +32278,24 @@ function resolveWorktreeIdentity(projectRoot) {
 
 // ../editor-core/dist/server/chunk-UZKAJSSR.js
 import {
-  mkdirSync as mkdirSync2,
-  readdirSync,
-  readFileSync as readFileSync4,
-  realpathSync as realpathSync3,
-  unlinkSync,
-  writeFileSync as writeFileSync2
+  mkdirSync as mkdirSync3,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync5,
+  realpathSync as realpathSync4,
+  unlinkSync as unlinkSync2,
+  writeFileSync as writeFileSync3
 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { join as join9, resolve as resolve7 } from "node:path";
+import { homedir as homedir4 } from "node:os";
+import { join as join10, resolve as resolve8 } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
-var EDITOR_SESSIONS_REGISTRY_FILE = join9(homedir3(), ".volter", "editor-sessions.json");
-function isEditorSessionEntry(v) {
+var EDITOR_SESSIONS_REGISTRY_FILE2 = join10(homedir4(), ".volter", "editor-sessions.json");
+function isEditorSessionEntry2(v) {
   if (typeof v !== "object" || v === null) return false;
   const s = v;
   const optionalIdentity = (value) => value === void 0 || value === null || typeof value === "string";
   return (typeof s["project"] === "string" || s["project"] === null) && typeof s["port"] === "number" && typeof s["pid"] === "number" && typeof s["startedAt"] === "string" && optionalIdentity(s["sessionId"]) && optionalIdentity(s["controlSecret"]) && optionalIdentity(s["repositoryId"]) && optionalIdentity(s["worktreeId"]) && optionalIdentity(s["worktreeRoot"]) && optionalIdentity(s["projectRelativePath"]) && optionalIdentity(s["branch"]) && optionalIdentity(s["headCommit"]) && optionalIdentity(s["baseCommit"]);
 }
-function normalizeEditorSessionEntry(session) {
+function normalizeEditorSessionEntry2(session) {
   return {
     ...session,
     sessionId: session.sessionId ?? null,
@@ -31990,7 +32309,7 @@ function normalizeEditorSessionEntry(session) {
     baseCommit: session.baseCommit ?? null
   };
 }
-function pidAlive(pid) {
+function pidAlive2(pid) {
   try {
     process.kill(pid, 0);
     return true;
@@ -31998,23 +32317,23 @@ function pidAlive(pid) {
     return error50.code === "EPERM";
   }
 }
-function readLiveRegisteredSessions() {
+function readLiveRegisteredSessions2() {
   try {
-    const raw = JSON.parse(readFileSync4(EDITOR_SESSIONS_REGISTRY_FILE, "utf8"));
-    return Array.isArray(raw) ? raw.filter(isEditorSessionEntry).map(normalizeEditorSessionEntry).filter((s) => pidAlive(s.pid)) : [];
+    const raw = JSON.parse(readFileSync5(EDITOR_SESSIONS_REGISTRY_FILE2, "utf8"));
+    return Array.isArray(raw) ? raw.filter(isEditorSessionEntry2).map(normalizeEditorSessionEntry2).filter((s) => pidAlive2(s.pid)) : [];
   } catch {
     return [];
   }
 }
 function announceEditorLaunch(project) {
-  const directory = join9(project, ".volter", "editor-launches");
-  mkdirSync2(directory, { recursive: true });
-  const file3 = join9(directory, `${process.pid}.json`);
-  writeFileSync2(file3, JSON.stringify({ pid: process.pid }));
+  const directory = join10(project, ".volter", "editor-launches");
+  mkdirSync3(directory, { recursive: true });
+  const file3 = join10(directory, `${process.pid}.json`);
+  writeFileSync3(file3, JSON.stringify({ pid: process.pid }));
   const clear = () => {
     process.removeListener("exit", clear);
     try {
-      unlinkSync(file3);
+      unlinkSync2(file3);
     } catch {
     }
   };
@@ -32022,12 +32341,12 @@ function announceEditorLaunch(project) {
   return clear;
 }
 function hasPendingEditorLaunch(project) {
-  const directory = join9(project, ".volter", "editor-launches");
+  const directory = join10(project, ".volter", "editor-launches");
   try {
-    return readdirSync(directory).some((name) => {
+    return readdirSync2(directory).some((name) => {
       if (!/^\d+\.json$/.test(name)) return false;
       const pid = Number(name.slice(0, -5));
-      return pid !== process.pid && pidAlive(pid);
+      return pid !== process.pid && pidAlive2(pid);
     });
   } catch {
     return false;
@@ -32035,7 +32354,7 @@ function hasPendingEditorLaunch(project) {
 }
 async function waitForPendingEditorLaunch(project) {
   const canon = canonicalizeProjectPath(project);
-  const ready = () => readLiveRegisteredSessions().some(
+  const ready = () => readLiveRegisteredSessions2().some(
     (session) => session.project !== null && canonicalizeProjectPath(session.project) === canon
   );
   if (ready() || !hasPendingEditorLaunch(canon)) return;
@@ -32061,9 +32380,9 @@ function servedProjectAnswer(body) {
   };
 }
 function canonicalizeProjectPath(p) {
-  const absolute = resolve7(p);
+  const absolute = resolve8(p);
   try {
-    return realpathSync3(absolute);
+    return realpathSync4(absolute);
   } catch {
     return absolute;
   }
@@ -32081,7 +32400,7 @@ async function loopbackPortFree(port) {
   });
 }
 function liveSessions() {
-  return readLiveRegisteredSessions();
+  return readLiveRegisteredSessions2();
 }
 async function fetchEditorSession(port, timeoutMs = 5e3) {
   try {
@@ -32397,13 +32716,13 @@ function killEditorSessionProcess(pid, signal = "SIGTERM") {
 }
 async function waitForPidExit(pid, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
-  while (pidAlive(pid) && Date.now() < deadline) {
-    await new Promise((resolve13) => setTimeout(resolve13, 50));
+  while (pidAlive2(pid) && Date.now() < deadline) {
+    await new Promise((resolve14) => setTimeout(resolve14, 50));
   }
-  return !pidAlive(pid);
+  return !pidAlive2(pid);
 }
 async function terminateEditorSession(session, graceMs = 5500) {
-  if (!pidAlive(session.pid)) return "already-gone";
+  if (!pidAlive2(session.pid)) return "already-gone";
   try {
     killEditorSessionProcess(session.pid, "SIGTERM");
   } catch (error50) {
@@ -32422,20 +32741,20 @@ async function terminateEditorSession(session, graceMs = 5500) {
   return "forced";
 }
 
-// ../editor-core/dist/server/chunk-FDJPJQAL.js
+// ../editor-core/dist/server/chunk-42TLBVCO.js
 import { spawn as spawn3 } from "node:child_process";
 import { createRequire as createRequire2 } from "node:module";
-import { mkdirSync as mkdirSync22, openSync, closeSync, realpathSync as realpathSync4 } from "node:fs";
-import { join as join22, resolve as resolve8 } from "node:path";
+import { mkdirSync as mkdirSync22, openSync, closeSync, realpathSync as realpathSync5 } from "node:fs";
+import { join as join22, resolve as resolve9 } from "node:path";
 import { createHash as createHash3 } from "node:crypto";
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync5, renameSync as renameSync2, rmdirSync, statSync as statSync2, writeFileSync as writeFileSync3 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { dirname as dirname6, join as join10 } from "node:path";
+import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, renameSync as renameSync2, rmdirSync, statSync as statSync2, writeFileSync as writeFileSync4 } from "node:fs";
+import { homedir as homedir5 } from "node:os";
+import { dirname as dirname6, join as join11 } from "node:path";
 var MIN_PORT = 1024;
 var MAX_PORT = 65535;
 var WORKTREE_EDITOR_PORT_MIN = 20200;
 var WORKTREE_EDITOR_PORT_MAX = 29999;
-var DEFAULT_PORT_REGISTRY = join10(homedir4(), ".volter", "worktree-ports.json");
+var DEFAULT_PORT_REGISTRY = join11(homedir5(), ".volter", "worktree-ports.json");
 var LOCK_STALE_MS = 1e4;
 var lockWait = new Int32Array(new SharedArrayBuffer(4));
 function assertPort(value, source) {
@@ -32452,7 +32771,7 @@ function isEntry(value) {
 function readEntries(registryFile) {
   let raw;
   try {
-    raw = readFileSync5(registryFile, "utf8");
+    raw = readFileSync6(registryFile, "utf8");
   } catch (error50) {
     if (error50.code === "ENOENT") return [];
     throw new Error(
@@ -32481,19 +32800,19 @@ function readEntries(registryFile) {
   return entries;
 }
 function writeEntries(registryFile, entries) {
-  mkdirSync3(dirname6(registryFile), { recursive: true });
+  mkdirSync4(dirname6(registryFile), { recursive: true });
   const temp = `${registryFile}.${process.pid}.tmp`;
-  writeFileSync3(temp, `${JSON.stringify(entries, null, 2)}
+  writeFileSync4(temp, `${JSON.stringify(entries, null, 2)}
 `);
   renameSync2(temp, registryFile);
 }
 function withRegistryLock(registryFile, action) {
   const lock = `${registryFile}.lock`;
-  mkdirSync3(dirname6(registryFile), { recursive: true });
+  mkdirSync4(dirname6(registryFile), { recursive: true });
   const deadline = Date.now() + 5e3;
   for (; ; ) {
     try {
-      mkdirSync3(lock);
+      mkdirSync4(lock);
       break;
     } catch (error50) {
       if (error50.code !== "EEXIST") throw error50;
@@ -32587,7 +32906,7 @@ function refuseProjectWithoutAdapter(project, product) {
   if (refusal !== null) throw new Error(refusal);
 }
 async function launch(folder, launching, options = {}) {
-  const project = realpathSync4(resolve8(folder));
+  const project = realpathSync5(resolve9(folder));
   const product = resolveProductForProject(project);
   if (product.name !== launching.packageName) throw new Error(`${project} declares ${product.name}, not ${launching.displayName}.`);
   refuseProjectWithoutAdapter(project, product);
@@ -32630,7 +32949,7 @@ async function launch(folder, launching, options = {}) {
       stdio: ["ignore", log, log],
       env: {
         ...process.env,
-        VOLTER_CLI_ENTRY: resolve8(process.argv[1]),
+        VOLTER_CLI_ENTRY: resolve9(process.argv[1]),
         VOLTER_PROJECT: project,
         VOLTER_PRODUCT_DIR: product.dir,
         VOLTER_EDITOR_PORT: String(port),
@@ -32673,7 +32992,7 @@ async function launch(folder, launching, options = {}) {
   }
 }
 async function prepareSession(folder, launching) {
-  const project = realpathSync4(resolve8(folder));
+  const project = realpathSync5(resolve9(folder));
   const product = resolveProductForProject(project);
   if (product.name !== launching.packageName) throw new Error(`${project} declares ${product.name}, not ${launching.displayName}.`);
   refuseProjectWithoutAdapter(project, product);
@@ -32704,7 +33023,7 @@ async function refuseIncompatibleProject(serverUrl, command, noOpen) {
   const refusal = await read();
   if (!refusal) return;
   const kind = refusal.recovery?.kind;
-  if (kind !== "use-compatible-editor" && kind !== "upgrade-project") return;
+  if (kind !== "use-compatible-editor" && kind !== "upgrade-project" && kind !== "bring-project-up-to-date") return;
   const message = refusal.error;
   const guidance = typeof refusal.recovery?.guidance === "string" ? refusal.recovery.guidance : null;
   const verbs = refusal.recovery?.verbs;
@@ -32811,7 +33130,7 @@ async function connectHostedAttachment(attachment) {
   const socket = new WebSocket(hostedSocketUrl(attachment.endpoint));
   const pending = /* @__PURE__ */ new Map();
   let state = {};
-  const ready = new Promise((resolve13, reject) => {
+  const ready = new Promise((resolve14, reject) => {
     const timer = setTimeout(() => {
       reject(new Error("Hosted attachment did not answer."));
       socket.close();
@@ -32823,7 +33142,7 @@ async function connectHostedAttachment(attachment) {
         if (value.type === "ready") {
           state = value.state ?? {};
           clearTimeout(timer);
-          resolve13();
+          resolve14();
         } else if (value.type === "state") state = value.state ?? {};
         else if (value.type === "response") {
           const call = pending.get(value.id);
@@ -32868,7 +33187,7 @@ async function connectHostedAttachment(attachment) {
     if (request.body) message.body = await request.text();
     if (!isHostedRequest(message)) throw new Error("Hosted attachment only carries bounded editor HTTP requests.");
     request.signal.throwIfAborted();
-    return await new Promise((resolve13, reject) => {
+    return await new Promise((resolve14, reject) => {
       const abort = () => {
         pending.delete(message.id);
         if (socket.readyState === WebSocket.OPEN) socket.send(JSON.stringify({ type: "cancel", id: message.id }));
@@ -32878,7 +33197,7 @@ async function connectHostedAttachment(attachment) {
         reject(new Error("Hosted attachment is disconnected."));
         return;
       }
-      pending.set(message.id, { resolve: resolve13, reject, cleanup: () => request.signal.removeEventListener("abort", abort) });
+      pending.set(message.id, { resolve: resolve14, reject, cleanup: () => request.signal.removeEventListener("abort", abort) });
       request.signal.addEventListener("abort", abort, { once: true });
       socket.send(JSON.stringify(message));
     });
@@ -33066,7 +33385,7 @@ var EditorClient = class {
         const { code, detail } = describeFetchFailure(error50);
         if (options?.retryTransport === true && !retried && RETRYABLE_TRANSPORT_CODES.has(code)) {
           retried = true;
-          await new Promise((resolve13) => setTimeout(resolve13, TRANSPORT_RETRY_DELAY_MS));
+          await new Promise((resolve14) => setTimeout(resolve14, TRANSPORT_RETRY_DELAY_MS));
           continue;
         }
         throw new EditorCommandError(
@@ -34120,11 +34439,11 @@ function spawnOpener(cmd, cmdArgs, fallback) {
 }
 
 // ../editor-core/dist/server/chunk-JQ4HMG7T.js
-import { existsSync as existsSync9, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "node:fs";
 function isWSL() {
   if (process.platform !== "linux") return false;
   try {
-    return readFileSync6("/proc/version", "utf8").toLowerCase().includes("microsoft");
+    return readFileSync7("/proc/version", "utf8").toLowerCase().includes("microsoft");
   } catch {
     return false;
   }
@@ -34154,9 +34473,9 @@ function openBrowserUrl(browserUrl, options) {
 
 // ../editor-core/dist/server/chunk-N6NBRKBO.js
 import { createHash as createHash4 } from "node:crypto";
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4, rmSync as rmSync2, existsSync as existsSync10 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
-import { dirname as dirname7, join as join11, resolve as resolve9 } from "node:path";
+import { mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5, rmSync as rmSync2, existsSync as existsSync10 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { dirname as dirname7, join as join12, resolve as resolve10 } from "node:path";
 import { LiveEditor, LiveTools } from "@volter/live";
 import { connect as connect5, unconnectedBindings, withEditorMemberHints } from "@volter/live";
 var NOISE = /* @__PURE__ */ new Set(["constructor", "then", "catch", "finally"]);
@@ -34298,8 +34617,8 @@ async function control(command, verb, argument, reason, scope, attachment) {
 }
 var HOSTED_USAGE = "hosted attach <https-url> | hosted status | hosted eval <JavaScript> | hosted screenshot <file.png> | hosted detach";
 function stateFile() {
-  const key = createHash4("sha256").update(resolve9(process.cwd())).digest("hex");
-  return join11(homedir5(), ".local", "state", "volter-editor", "hosted", `${key}.json`);
+  const key = createHash4("sha256").update(resolve10(process.cwd())).digest("hex");
+  return join12(homedir6(), ".local", "state", "volter-editor", "hosted", `${key}.json`);
 }
 async function hostedControl(command, args) {
   const [verb, argument] = args;
@@ -34322,8 +34641,8 @@ async function hostedControl(command, args) {
     const created = await response.json();
     if (created.page !== page.href || new URL(created.endpoint).origin !== page.origin || !/^[a-f0-9]{64}$/.test(created.clientToken) || !/^[a-f0-9]{64}$/.test(created.workerToken)) throw new Error("Invalid hosted attachment response.");
     const common = { id: created.id, endpoint: created.endpoint, page: created.page, expiresAt: created.expiresAt };
-    mkdirSync4(dirname7(file3), { recursive: true, mode: 448 });
-    writeFileSync4(file3, JSON.stringify({ ...common, token: created.clientToken }), { mode: 384, flag: "wx" });
+    mkdirSync5(dirname7(file3), { recursive: true, mode: 448 });
+    writeFileSync5(file3, JSON.stringify({ ...common, token: created.clientToken }), { mode: 384, flag: "wx" });
     page.hash = new URLSearchParams({ [HOSTED_ATTACHMENT_FRAGMENT]: JSON.stringify({ ...common, token: created.workerToken }) }).toString();
     openBrowserUrl(page.href, { background: true });
     console.log(`Attaching to hosted editor: ${created.page}
@@ -34334,7 +34653,7 @@ Use ${command} hosted status from this directory. Attachment expires ${new Date(
   if (!["status", "eval", "screenshot", "detach"].includes(verb ?? "")) throw new Error(HOSTED_USAGE);
   let attachment;
   try {
-    attachment = JSON.parse(readFileSync7(file3, "utf8"));
+    attachment = JSON.parse(readFileSync8(file3, "utf8"));
   } catch {
     throw new Error(`No hosted attachment in this directory. Run ${command} hosted attach <https-url>.`);
   }
@@ -34374,8 +34693,8 @@ Use ${command} hosted status from this directory. Attachment expires ${new Date(
       if (!argument?.endsWith(".png")) throw new Error("hosted screenshot requires an output .png path.");
       const shot = await live.editor.captureActiveDocument();
       if (shot.mimeType !== "image/png") throw new Error("Editor did not return a PNG of the active document.");
-      writeFileSync4(resolve9(argument), Buffer.from(shot.base64, "base64"));
-      console.log(resolve9(argument));
+      writeFileSync5(resolve10(argument), Buffer.from(shot.base64, "base64"));
+      console.log(resolve10(argument));
     } else await control(command, verb, argument, void 0, void 0, { live, client, consolePolicy: "report" });
   } finally {
     remote.close();
@@ -34505,11 +34824,11 @@ var RELAY_COMMANDS = {
 var RELAY_COMMAND_TYPES = Object.keys(RELAY_COMMANDS);
 
 // ../editor-core/dist/server/launcher/session-verbs.js
-import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync8, statSync as statSync3, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync9, statSync as statSync3, writeFileSync as writeFileSync6 } from "node:fs";
 import { basename as basename3, dirname as dirname8, join as join23, resolve as resolve22 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 import { resolveSession } from "@volter/live";
-import { isAbsolute as isAbsolute4, join as join12, relative as relative4, resolve as resolve10 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join13, relative as relative5, resolve as resolve11 } from "node:path";
 var MODEL_TARGET_EXTENSIONS = [".glb", ".gltf", ".spz"];
 var MODULE_TARGET_EXTENSIONS = [".ts", ".tsx"];
 var endsWithAny = (value, suffixes) => {
@@ -34524,9 +34843,9 @@ function classifyScreenshotTarget(target) {
 }
 function resolveModelTarget(target, options) {
   const { cwd, projectRoot, exists } = options;
-  const candidates = [resolve10(cwd, target)];
+  const candidates = [resolve11(cwd, target)];
   if (target.startsWith("/") && projectRoot) {
-    candidates.push(join12(projectRoot, target), join12(projectRoot, "public", target));
+    candidates.push(join13(projectRoot, target), join13(projectRoot, "public", target));
   }
   const file3 = candidates.find((candidate) => exists(candidate));
   if (file3 === void 0) {
@@ -34541,7 +34860,7 @@ A model target is a path on disk (or the served path the editor loads it from, e
 The editor loads models same-origin from the project it is serving; run this from inside the project.`
     };
   }
-  const withinProject = relative4(projectRoot, file3);
+  const withinProject = relative5(projectRoot, file3);
   if (withinProject.startsWith("..") || isAbsolute4(withinProject)) {
     return {
       error: `${file3} is outside ${projectRoot}.
@@ -34743,8 +35062,8 @@ async function sessionLook(client, projectRoot) {
       capture3 = await client.captureGame({ refreshStarvedFrame: true });
       loopRecoveryFrame = true;
     }
-    mkdirSync5(dirname8(outPath), { recursive: true });
-    writeFileSync5(outPath, Buffer.from(capture3.base64, "base64"));
+    mkdirSync6(dirname8(outPath), { recursive: true });
+    writeFileSync6(outPath, Buffer.from(capture3.base64, "base64"));
     console.log(outPath);
     if (capture3.flatness?.degenerate === true && capture3.flatness.warning !== void 0) console.error(`warning \u2014 ${capture3.flatness.warning}`);
     if (loopRecoveryFrame || capture3.loopRecoveryFrame === true) {
@@ -34755,8 +35074,8 @@ async function sessionLook(client, projectRoot) {
     return;
   }
   const capture2 = await client.captureActiveDocument();
-  mkdirSync5(dirname8(outPath), { recursive: true });
-  writeFileSync5(outPath, Buffer.from(capture2.base64, "base64"));
+  mkdirSync6(dirname8(outPath), { recursive: true });
+  writeFileSync6(outPath, Buffer.from(capture2.base64, "base64"));
   console.log(outPath);
   console.error(`${capture2.document.title} (${capture2.document.kind}${capture2.document.sourcePath ? `, ${capture2.document.sourcePath}` : ""}) \u2014 ${capture2.source}`);
 }
@@ -34779,11 +35098,11 @@ async function capture(options) {
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const slug = name ? name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 48) : "";
   const outPath = named ?? join23(session.projectRoot, ".volter", "captures", `${slug ? `${slug}-` : ""}${region}-${stamp}.png`);
-  mkdirSync5(dirname8(outPath), { recursive: true });
-  writeFileSync5(outPath, Buffer.from(shot.base64, "base64"), { flag: options.force === true ? "w" : "wx" });
+  mkdirSync6(dirname8(outPath), { recursive: true });
+  writeFileSync6(outPath, Buffer.from(shot.base64, "base64"), { flag: options.force === true ? "w" : "wx" });
   console.log(outPath);
   console.error(`${region}: ${shot.size.width}x${shot.size.height} at ${shot.scale}x (${shot.layers.canvases} canvas, ${shot.layers.domOverlays} DOM layer${shot.layers.domOverlays === 1 ? "" : "s"})`);
-  if (shot.flatness?.degenerate === true && shot.flatness.warning !== void 0) console.error(`warning \u2014 ${shot.flatness.warning}`);
+  if (region !== "page" && shot.flatness?.degenerate === true && shot.flatness.warning !== void 0) console.error(`warning \u2014 ${shot.flatness.warning}`);
 }
 async function assertUnambiguousTarget(client, target, file3) {
   const entities = await liveEntityRows(client);
@@ -34802,10 +35121,10 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
     ...flags.width === void 0 ? {} : { width: flags.width },
     ...flags.height === void 0 ? {} : { height: flags.height }
   };
-  mkdirSync5(outputDirectory, { recursive: true });
+  mkdirSync6(outputDirectory, { recursive: true });
   if (flags.compare !== void 0) {
     if (flags.shots !== void 0) throw new Error("--compare cannot be combined with --shots");
-    const refBytes = readFileSync8(resolve22(flags.compare));
+    const refBytes = readFileSync9(resolve22(flags.compare));
     const maxRefBytes = 32 * 1024 * 1024;
     if (refBytes.byteLength > maxRefBytes) throw new Error(`--compare reference GLB must be ${maxRefBytes / 1024 / 1024} MiB or less.`);
     const capture3 = await client.captureAssetComparePreview(source, refBytes.toString("base64"), dimensions);
@@ -34813,7 +35132,7 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
     for (const view of capture3.views) {
       iou[view.view] = view.iou;
       for (const [suffix, image] of [["overlay", view.overlay], ["asset", view.asset], ["ref", view.ref]]) {
-        writeFileSync5(join23(outputDirectory, `compare-${view.view}-${suffix}.png`), Buffer.from(image.base64, "base64"));
+        writeFileSync6(join23(outputDirectory, `compare-${view.view}-${suffix}.png`), Buffer.from(image.base64, "base64"));
       }
     }
     console.log(JSON.stringify({ compare: { iou } }));
@@ -34833,18 +35152,18 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
     const warnings = new Map((capture3.warnings ?? []).map((warning) => [warning.label, warning]));
     for (const image of capture3.shots) {
       const file3 = join23(outputDirectory, `${image.label}.png`);
-      writeFileSync5(file3, Buffer.from(image.base64, "base64"));
+      writeFileSync6(file3, Buffer.from(image.base64, "base64"));
       const warning = warnings.get(image.label);
       if (warning) console.warn(`WARNING  ${file3}: ${warning.message}`);
     }
-    writeFileSync5(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture3.contactSheet.base64, "base64"));
+    writeFileSync6(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture3.contactSheet.base64, "base64"));
     const empty = capture3.warnings?.length ?? 0;
     console.log(`Shot set '${flags.shots}' preview (${capture3.shots.length} shots${empty > 0 ? `, ${empty} EMPTY \u2014 see the warnings above` : ""}) written to ${outputDirectory}`);
     return;
   }
   const capture2 = await client.captureAssetPreview(source, { ...dimensions, ...defaultStage === void 0 ? {} : { stage: defaultStage } });
-  for (const image of capture2.views) writeFileSync5(join23(outputDirectory, `${image.view}.png`), Buffer.from(image.base64, "base64"));
-  writeFileSync5(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture2.contactSheet.base64, "base64"));
+  for (const image of capture2.views) writeFileSync6(join23(outputDirectory, `${image.view}.png`), Buffer.from(image.base64, "base64"));
+  writeFileSync6(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture2.contactSheet.base64, "base64"));
   console.log(`${join23(outputDirectory, "contact-sheet.png")}   \u2190 every view on one sheet`);
   console.log(`  per-view frames beside it: ${capture2.views.map((image) => `${image.view}.png`).join(" ")}`);
   if (capture2.orientation && capture2.orientation.yawDegrees !== 0) {
@@ -34906,23 +35225,23 @@ import { execFileSync as execFileSync4 } from "node:child_process";
 import {
   createWriteStream as createWriteStream2,
   existsSync as existsSync12,
-  mkdirSync as mkdirSync6,
-  readFileSync as readFileSync9,
+  mkdirSync as mkdirSync7,
+  readFileSync as readFileSync10,
   renameSync as renameSync3,
   rmSync as rmSync3,
-  writeFileSync as writeFileSync6
+  writeFileSync as writeFileSync7
 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
-import { basename as basename4, isAbsolute as isAbsolute5, join as join13, resolve as resolve11, sep as sep2 } from "node:path";
+import { homedir as homedir7 } from "node:os";
+import { basename as basename4, isAbsolute as isAbsolute5, join as join14, resolve as resolve12, sep as sep3 } from "node:path";
 var WORKBENCH_LOCATOR_PATH2 = ".volter/workbench.json";
 var RELEASE_RECORD2 = "BUILD.json";
-var SOURCES_LAUNCHER2 = join13("scripts", "code-server.sh");
+var SOURCES_LAUNCHER2 = join14("scripts", "code-server.sh");
 var OVERLAY_RECORD2 = ".volter-overlay.json";
 function writeWorkbenchDeclaration2(projectRoot, workbenchDir) {
-  mkdirSync6(join13(projectRoot, ".volter"), { recursive: true });
-  writeFileSync6(
-    join13(projectRoot, WORKBENCH_LOCATOR_PATH2),
-    `${JSON.stringify({ workbench: resolve11(workbenchDir) }, null, 2)}
+  mkdirSync7(join14(projectRoot, ".volter"), { recursive: true });
+  writeFileSync7(
+    join14(projectRoot, WORKBENCH_LOCATOR_PATH2),
+    `${JSON.stringify({ workbench: resolve12(workbenchDir) }, null, 2)}
 `
   );
 }
@@ -34930,8 +35249,8 @@ function machinePlatform2() {
   return `${process.platform}-${process.arch}`;
 }
 function resolveWorkbench2(dir, expectedProduct) {
-  const root = resolve11(dir);
-  const resolved = existsSync12(join13(root, RELEASE_RECORD2)) ? resolveRelease2(root) : existsSync12(join13(root, SOURCES_LAUNCHER2)) ? resolveSources2(root) : null;
+  const root = resolve12(dir);
+  const resolved = existsSync12(join14(root, RELEASE_RECORD2)) ? resolveRelease2(root) : existsSync12(join14(root, SOURCES_LAUNCHER2)) ? resolveSources2(root) : null;
   if (resolved === null) {
     throw new Error(
       `${root} is neither a Code-OSS release nor a fork checkout: it carries no ${RELEASE_RECORD2} (the record scripts/workbench/build-release.mjs writes beside its tarball) and no ${SOURCES_LAUNCHER2}. Name the directory the release was extracted into, or the fork checkout itself.`
@@ -34947,11 +35266,11 @@ function resolveWorkbench2(dir, expectedProduct) {
   return resolved;
 }
 function resolveRelease2(dir) {
-  const record3 = join13(dir, RELEASE_RECORD2);
+  const record3 = join14(dir, RELEASE_RECORD2);
   const cut = `node scripts/workbench/build-release.mjs --product <id> --platform ${machinePlatform2()} --checkout <fork dir> --out ${dir}`;
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync9(record3, "utf8"));
+    parsed = JSON.parse(readFileSync10(record3, "utf8"));
   } catch (error50) {
     throw new Error(`${record3} could not be read: ${String(error50)}`);
   }
@@ -34975,13 +35294,13 @@ function resolveRelease2(dir) {
   node scripts/workbench/build-release.mjs --product ${product} --platform ${machine} --checkout <fork dir>`
     );
   }
-  const packageRoot = join13(dir, target);
-  const serverBinPath = join13(packageRoot, serverBin);
+  const packageRoot = join14(dir, target);
+  const serverBinPath = join14(packageRoot, serverBin);
   if (!existsSync12(serverBinPath)) {
     const tarball = typeof parsed["tarball"] === "string" ? parsed["tarball"] : `${target}-<commit>.tar.gz`;
     throw new Error(
       `${dir} records ${target}, but ${serverBinPath} is not there \u2014 the tarball has not been extracted beside ${RELEASE_RECORD2}. Run:
-  tar -xzf ${join13(dir, tarball)} -C ${dir}`
+  tar -xzf ${join14(dir, tarball)} -C ${dir}`
     );
   }
   return { kind: "release", dir, commit, product, serverBin: serverBinPath, cwd: packageRoot };
@@ -34995,7 +35314,7 @@ function resolveSources2(dir) {
       `${dir} carries ${SOURCES_LAUNCHER2}, so it reads as a Code-OSS fork checkout, but \`git rev-parse HEAD\` there failed (${error50 instanceof Error ? error50.message : String(error50)}). A checkout's commit is the only record of which fork this workbench is.`
     );
   }
-  const marker = join13(dir, OVERLAY_RECORD2);
+  const marker = join14(dir, OVERLAY_RECORD2);
   if (!existsSync12(marker)) {
     throw new Error(
       `${dir} is a Code-OSS checkout with no volter overlay: ${OVERLAY_RECORD2} is not there, so nothing of the editor is compiled into it and the workbench would come up as plain Code-OSS. Overlay and compile it:
@@ -35004,7 +35323,7 @@ function resolveSources2(dir) {
   }
   let product;
   try {
-    product = JSON.parse(readFileSync9(marker, "utf8"))["product"];
+    product = JSON.parse(readFileSync10(marker, "utf8"))["product"];
   } catch (error50) {
     throw new Error(`${marker} could not be read: ${String(error50)}`);
   }
@@ -35018,16 +35337,16 @@ function resolveSources2(dir) {
     dir,
     commit,
     product,
-    serverBin: join13(dir, SOURCES_LAUNCHER2),
+    serverBin: join14(dir, SOURCES_LAUNCHER2),
     cwd: dir
   };
 }
-var WORKBENCH_CACHE_ROOT2 = join13(homedir6(), ".volter", "workbenches");
+var WORKBENCH_CACHE_ROOT2 = join14(homedir7(), ".volter", "workbenches");
 
 // node/cli.ts
 var PRODUCT = { packageName: package_default.name, id: "cyclotron", displayName: package_default.volter.product.displayName, command: Object.keys(package_default.bin)[0] };
 function refuseRetired(from) {
-  for (let dir = resolve12(from); ; dir = dirname10(dir)) {
+  for (let dir = resolve13(from); ; dir = dirname10(dir)) {
     if (hasManifest(dir)) {
       const retired = declaredRetiredProduct(UPGRADING, dir);
       if (retired !== null) throw retiredProjectError(UPGRADING, retired, dir);
@@ -35114,7 +35433,7 @@ try {
     await hostedControl(PRODUCT.command, positionals.slice(1));
   } else if (verb === "blender-mcp") {
     if (positionals.length !== 1) throw new Error("Usage: cyclotron blender-mcp");
-    let project = resolve12(process.cwd());
+    let project = resolve13(process.cwd());
     while (!hasManifest(project)) {
       const parent = dirname10(project);
       if (parent === project) throw new Error("Run cyclotron blender-mcp inside a modeling project.");
@@ -35181,13 +35500,14 @@ try {
     if (verb !== "create" && verb !== "edit") throw new Error(`Unknown command: ${verb}`);
     if (verb === "create") {
       if (!positionals[1]) throw new Error("create requires a new folder name.");
-      if (values.workbench) resolveWorkbench2(resolve12(values.workbench), PRODUCT.id);
-      console.log(`Creating Cyclotron project at ${resolve12(folder)}\u2026`);
-      await declaration.create({ name: folder.split(/[\\/]/).at(-1), targetDir: resolve12(folder), ...values.template ? { template: values.template } : {} });
-      if (values.workbench) writeWorkbenchDeclaration2(resolve12(folder), resolve12(values.workbench));
+      if (values.workbench) resolveWorkbench2(resolve13(values.workbench), PRODUCT.id);
+      console.log(`Creating Cyclotron project at ${resolve13(folder)}\u2026`);
+      await declaration.create({ name: folder.split(/[\\/]/).at(-1), targetDir: resolve13(folder), ...values.template ? { template: values.template } : {} });
+      if (values.workbench) writeWorkbenchDeclaration2(resolve13(folder), resolve13(values.workbench));
     }
     const project = verb === "edit" && positionals.length < 2 ? await startupProject(declaration.create) : folder;
-    console.log(`Opening Cyclotron for ${resolve12(project)}\u2026`);
+    console.log(`Opening Cyclotron for ${resolve13(project)}\u2026`);
+    await refreshStarterGuidance(resolve13(project));
     await launch(project, PRODUCT, {
       ...values.workbench ? { workbench: values.workbench } : {},
       ...values["no-open"] ? { noOpen: true } : {},