@volter/game-editor 0.5.68 → 0.5.70

package/template/README.md

@@ -1,6 +1,6 @@
-# VGAI game project
+# Volter game project
 
-This is a standalone game project created by VGAI. Describe the game you want
+This is a standalone game project created by Volter. Describe the game you want
 to a coding agent, or open the shared visual editor directly:
 
 ```bash
@@ -17,8 +17,7 @@ exported builds only.
 npm run dev               # open/reuse this project's editor
 npm run check-idioms      # project architecture and completion diagnostics
 npm run typecheck         # game, editor contributions, Node config, and server
-npm run validate          # project files and React design states
-npm run validate-manifest # vgai.project.json
+npm run validate-manifest # volter.project.json
 npm run build             # production game bundle
 ```
 
@@ -26,7 +25,7 @@ The `studio` addition (`game-editor create <name> --with studio`, or `--template
 brings three development contributions; no other preset does. The files are:
 `src/contributions/tester.inspector.tsx`, `src/contributions/data.document.tsx` and
 `src/contributions/analytics.analytics.tsx`. They emit
-`VGAI_STUB_UNIMPLEMENTED`, so the editor console and `check-idioms` remain red
+`VOLTER_STUB_UNIMPLEMENTED`, so the editor console and `check-idioms` remain red
 until the game supplies its own Tester, Data and Analytics surfaces (or deletes
 Data because it genuinely has no authored content tables). Analytics must provide
 game-specific analysis. The editor already provides session selection, playback
@@ -50,23 +49,23 @@ example must not silently erase the architecture it demonstrates.
 Drive/read the running game through its own exported modules:
 
 ```bash
-npm run vgai -- eval 'return game.run(async ({ modules }) => { const bot = await modules("src/bot/tester-station.ts"); return bot.describeTester(); })'
+npm run volter -- eval 'return game.run(async ({ modules }) => { const bot = await modules("src/bot/tester-station.ts"); return bot.describeTester(); })'
 ```
 
 Record through the same eval door while Play is running:
 
 ```bash
-npm run vgai -- eval 'return editor.recording.start({ fps: 30 })'
+npm run volter -- eval 'return editor.recording.start({ fps: 30 })'
 # direct the resident tester and advance simulation time
-npm run vgai -- eval 'return editor.recording.stop()'
+npm run volter -- eval 'return editor.recording.stop()'
 ```
 
-Recordings are standard WebM files under `.vgai/recordings/`. Inspect and trim
+Recordings are standard WebM files under `.volter/recordings/`. Inspect and trim
 them with ordinary `ffmpeg`/`ffprobe`; promote only reviewed evidence into
 `media/`. Structured Gameplay Session logs live under `logs/play-*.jsonl` and
 remain the durable Analytics source after Stop or reload.
 
-The project manifest is `vgai.project.json`. `ROADMAP.md` owns major feature
+The project manifest is `volter.project.json`. `ROADMAP.md` owns major feature
 arcs; `DEVLOG.md` is the development journal. Coding agents begin with
 `AGENTS.md`, which routes task-specific details to `.agents/` skills and the
 project manual.
@@ -76,8 +75,8 @@ Editor runtime image for its engine version (`~/.volter/images/`), which
 carries every package the template and the catalog's capabilities use; the
 game is its own code. `package.json` still declares what the game uses, so
 replacing the link with `npm install` gives a standalone installation.
-`npm run vgai -- status` reports the product serving the active session.
+`npm run volter -- status` reports the product serving the active session.
 
-Learn and manual: https://vgai-learn.pages.dev
+Learn and manual: https://volter-learn.pages.dev
 
-Hosted editor: https://vgai-editor.pages.dev
+Hosted editor: https://volter-editor.pages.dev

package/template/check-idioms.ts

@@ -21,7 +21,7 @@ import { fileURLToPath } from 'node:url';
 //   ERROR (exit 1 always) — unambiguous drift, one canonical fix each:
 //     E1. `playwright`/`@playwright/test` imported anywhere in the project —
 //         the resident tester (directed through its running game module via
-//         `vgai eval`) is the ONE bot harness, and a
+//         `volter-game-editor eval`) is the ONE bot harness, and a
 //         hand-rolled browser boot is banned.
 //         VALUE imports only: a type-only import (`import type {Page}`, or
 //         an inline `{ type Page }` with no value specifier) binds nothing
@@ -30,18 +30,18 @@ import { fileURLToPath } from 'node:url';
 //         step normally needs, so the direct import is usually avoidable
 //         anyway.
 //     E2. package.json scripts invoking `playwright` directly.
-//     E3. `window.__vgai` accessed in src/** (the bot/CLI consumer
+//     E3. `window.__volter` accessed in src/** (the bot/CLI consumer
 //         surface, not the authoring surface — export the state from a module).
 //     E4. `?bot=`-style query-param bot plumbing in src/** — the project's
 //         resident tester owns bot entry.
 //     E5. raw `Math.random()`/`Date.now()`/`performance.now()` in
 //         src/scripts/** gameplay code — ONLY when this project's OWN
-//         vgai.project.json declares `determinism.seededRandom: true`; silent
+//         volter.project.json declares `determinism.seededRandom: true`; silent
 //         when undeclared (D15, T-D15.3's third enforcer leg — the other
 //         two, the engine-src permanent scan and the examples/ burn-down
 //         scan, live in the engine repo's own test suite; see
 //         packages/engine/test/gameplay-rng-ban.test.ts).
-//     E6. `VGAI_STUB_UNIMPLEMENTED` remains in src/tools/** or src/contributions/** — this
+//     E6. `VOLTER_STUB_UNIMPLEMENTED` remains in src/tools/** or src/contributions/** — this
 //         is the starter's explicit unfinished-work sentinel, so a completion
 //         check containing it cannot be green. Replace the Tester/Data/Analytics stub
 //         whole in the game's vocabulary; a game with no content tables may
@@ -104,12 +104,11 @@ import { fileURLToPath } from 'node:url';
 //
 // E9 is the one rule that does NOT answer its question from the file tree
 // alone: the R3F00x codes come from the editor's own source analyzer
-// (`ui-source/r3f-project-contracts.ts`), the same pass validate-on-save and
-// `vgai status` report from. It is loaded OFFLINE — the analyzer is a pure
+// (`@volter/editor-react`'s `src/source/r3f-project-contracts.ts`), the same pass validate-on-save and
+// `volter-game-editor status` report from. It is loaded OFFLINE — the analyzer is a pure
 // `(code, file) => diagnostics` function over `typescript`, with no dev
-// server, browser or editor session anywhere in it — through this project's
-// own `@editor/*` tsconfig mapping, so check-idioms never requires a running
-// editor. See `loadR3fAnalyzer`.
+// server, browser or editor session anywhere in it — from the installed
+// package, so check-idioms never requires a running editor. See `loadR3fAnalyzer`.
 //
 // Suppression: put `// idioms-ignore <rule-id> <reason>` on the flagged
 // line. The reason is REQUIRED — an empty/missing reason does not suppress
@@ -117,7 +116,7 @@ import { fileURLToPath } from 'node:url';
 // incomplete). This is intentionally a dumb line/regex scanner, not an AST
 // pass — it comment-strips PURE comment lines (lines whose trimmed text
 // starts with `//`, `/*`, `*`, or is exactly `*/`) before matching rule
-// patterns, so doc-comment prose that merely MENTIONS e.g. `window.__vgai`
+// patterns, so doc-comment prose that merely MENTIONS e.g. `window.__volter`
 // doesn't trip a finding, but it does not understand string literals,
 // template strings, or multi-statement lines. False positives are expected
 // occasionally; suppress them with a reason rather than fighting the regex.
@@ -147,7 +146,7 @@ if (!existsSync(rootDir)) {
 
 // This script's own resolved path — excluded from every scan so its rule
 // regexes (which literally contain the strings they look for, e.g.
-// 'colyseus.js', 'window.__vgai', '@playwright/test') never self-flag.
+// 'colyseus.js', 'window.__volter', '@playwright/test') never self-flag.
 const SELF_PATH = resolve(fileURLToPath(import.meta.url));
 
 // ---------------------------------------------------------------------------
@@ -166,7 +165,7 @@ const SKIP_DIRS = new Set([
   '.github',
   'dist',
   'build',
-  '.vgai',
+  '.volter',
   'coverage',
   '.turbo',
 ]);
@@ -347,7 +346,7 @@ function checkPlaywrightImports(): void {
         'error',
         'bot-canonical',
         `"${pkg}" imported — the resident tester, directed through the running game's own module, is the ONE bot harness; hand-rolled Playwright boots are banned.`,
-        "Drive the game through the live session (vgai eval + the running tester module), or take the Playwright types from '@volter/game-live' as a type-only import.",
+        "Drive the game through the live session (volter-game-editor eval + the running tester module), or take the Playwright types from '@volter/game-live' as a type-only import.",
       );
     }
   }
@@ -380,7 +379,7 @@ function checkPackageJsonScripts(): void {
       'error',
       'bot-canonical',
       `script "${name}" invokes playwright directly ("${cmd}") — this project has no Playwright lane to own a browser binary or config.`,
-      `Delete the "${name}" script — playtesting is the live session (vgai eval + the running tester module), not a script.`,
+      `Delete the "${name}" script — playtesting is the live session (volter-game-editor eval + the running tester module), not a script.`,
     );
   }
 }
@@ -393,7 +392,7 @@ function checkPackageJsonScripts(): void {
  *  file enters an endless cycle of rewriting assertions and actions (owner
  *  ruling, 2026-08-21 — measured live: three assertion renegotiations in
  *  twenty minutes on one balance suite). The playtest loop is INTERACTIVE:
- *  `vgai eval` + cheats set the situation, bot policy runs behavior, event
+ *  `volter-game-editor eval` + cheats set the situation, bot policy runs behavior, event
  *  logs are read on an interval, and the run is redirected live until the
  *  operator is satisfied. The play log (logs/play-*.jsonl) is the receipt. This
  *  rule keeps the furniture out so the cheapest path stays the sanctioned
@@ -403,7 +402,7 @@ function checkNoTestFurniture(): void {
     'Delete it and playtest LIVE: eval + cheats set the situation, bot goals run behavior, the ' +
     'event log is read on an interval, the run is redirected until satisfied; the play log ' +
     '(logs/play-*.jsonl) is the receipt.';
-  const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', '.vgai', 'logs', 'media', 'public']);
+  const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', '.volter', 'logs', 'media', 'public']);
   const testFile = /\.(test|spec)\.[cm]?[jt]sx?$/;
   const walk = (dir: string): void => {
     for (const entry of readdirSync(dir)) {
@@ -477,31 +476,31 @@ function checkNoTestFurniture(): void {
 }
 
 // ---------------------------------------------------------------------------
-// E3 — window.__vgai accessed in src/**
+// E3 — window.__volter accessed in src/**
 // ---------------------------------------------------------------------------
 
-function checkWindowVgai(): void {
-  // Two-part, same-line heuristic rather than a single `window\.__vgai`
+function checkWindowVolter(): void {
+  // Two-part, same-line heuristic rather than a single `window\.__volter`
   // regex: this codebase's OWN canonical way to reach the bridge (see
   // @volter/game-live's game-client/client.ts) is a cast in between —
-  // `(window as unknown as { __vgai?: ... }).__vgai` — so `window` and
-  // `.__vgai` are literal-adjacent only coincidentally. Flag any line that
-  // mentions the `window` token AND a bare `.__vgai`/`['__vgai']` property
+  // `(window as unknown as { __volter?: ... }).__volter` — so `window` and
+  // `.__volter` are literal-adjacent only coincidentally. Flag any line that
+  // mentions the `window` token AND a bare `.__volter`/`['__volter']` property
   // access. The negative lookahead on the dotted form keeps this off
-  // `__vgaiScene`/`__vgaiCamera`/`__vgaiRender`/`__vgaiBatch` etc. — those
-  // are different, unrelated dev-only globals, not the frozen `window.__vgai`
+  // `__volterScene`/`__volterCamera`/`__volterRender`/`__volterBatch` etc. — those
+  // are different, unrelated dev-only globals, not the frozen `window.__volter`
   // debug-bridge shape (D18). A file-scoped `window` ALIAS on its own line
-  // (`const w = window as …; w['__vgai']`) is a known miss — this is a
+  // (`const w = window as …; w['__volter']`) is a known miss — this is a
   // line-scan, not an AST pass.
   const windowRe = /\bwindow\b/;
-  const vgaiAccessRe = /\.__vgai(?![A-Za-z0-9_])|\[\s*['"]__vgai['"]\s*\]/g;
+  const volterAccessRe = /\.__volter(?![A-Za-z0-9_])|\[\s*['"]__volter['"]\s*\]/g;
   for (const file of srcFiles) {
     const { rawLines, blanked } = readFileText(file);
     const blankedLines = blanked.split('\n');
     blankedLines.forEach((line, i) => {
       if (!windowRe.test(line)) return;
-      vgaiAccessRe.lastIndex = 0;
-      if (!vgaiAccessRe.test(line)) return;
+      volterAccessRe.lastIndex = 0;
+      if (!volterAccessRe.test(line)) return;
       addFinding(
         file,
         rawLines,
@@ -509,7 +508,7 @@ function checkWindowVgai(): void {
         'E3',
         'error',
         'bot-canonical',
-        'window.__vgai accessed directly in src/** — this is the bot/CLI consumer surface, not the authoring surface.',
+        'window.__volter accessed directly in src/** — this is the bot/CLI consumer surface, not the authoring surface.',
         'Read and drive the game through its own exported modules instead (game.run(({ modules }) => …)).',
       );
     });
@@ -550,7 +549,7 @@ function checkBotParam(): void {
  *  reads as "none" — validating its shape is validate-manifest.ts's job. */
 function manifestDomRootEntries(): Set<string> {
   const entries = new Set<string>();
-  const manifestPath = join(rootDir, 'vgai.project.json');
+  const manifestPath = join(rootDir, 'volter.project.json');
   if (!existsSync(manifestPath)) return entries;
   try {
     const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as {
@@ -710,11 +709,6 @@ function checkTriggerNameIdentity(): void {
 // ---------------------------------------------------------------------------
 // git-history plumbing shared by slice-proxy rules (W9)
 // ---------------------------------------------------------------------------
-// The vgai CLI mirrors this exact measurement (source path, gameplay
-// pathspecs, threshold, silent-on-unaskable) as `vgai status`'s ambient
-// bot-drift line — engine repo, packages/vgai-cli/src/instrumentation-signal.ts.
-// If you change any of the three constants below, change them there too, or
-// the ambient signal and this rule will disagree about whether a bot drifted.
 
 /** The files that ARE the game, for slice-proxy measurements (W9). Deliberately
  *  NOT all of src/ — churn in src/ui/, src/tools/ or src/data/ is not by
@@ -833,7 +827,7 @@ function checkUseFramePriority(): void {
 
 /** The one way a project shows that Play has actually run: `logs/play-*.jsonl`
  *  — the editor server opens one per Play session
- *  (packages/editor/server/editor-server.ts, POST /__editor/log-session).
+ *  (packages/editor-core/server/editor-server.ts, POST /__editor/log-session).
  *  A working-tree fact, not a git fact (`logs/` is gitignored), written by
  *  the tool itself, so it cannot be produced by intending to play. This
  *  receipt is also the playtest's proof (owner ruling 2026-08-21). */
@@ -848,7 +842,7 @@ function hasPlayEvidence(): boolean {
 }
 
 /** The scaffolder's own record of where this project came from
- *  (packages/create-vgai-project/src/baseline.ts). W9's history ANCHOR.
+ *  (packages/game-editor/node/scaffold/baseline.ts). W9's history ANCHOR.
  *
  *  W7 anchors its window on a file's last commit; W9 does the same, and this
  *  is the file that means "this project began here". Anchoring matters: an
@@ -859,7 +853,7 @@ function hasPlayEvidence(): boolean {
  *  maintenance history, and a rule that shouts at our own reference material
  *  on every run is noise, not a tripwire. A project with no committed
  *  baseline cannot be asked when it started, so W9 stays silent there. */
-const SCAFFOLD_BASELINE_SOURCE = '.vgai/scaffold-baseline.json';
+const SCAFFOLD_BASELINE_SOURCE = '.volter/scaffold-baseline.json';
 
 /** Gameplay commits since the scaffold anchor, at or above which a project
  *  that has never been played is reported.
@@ -900,23 +894,23 @@ function checkPlayedBeforeAuthoring(): void {
       'typecheck and unit tests cannot see: a blank canvas, an invisible mesh, a camera inside ' +
       'the geometry.',
     'Author in playable slices (AGENTS.md) — enter Play before writing the next slice: run ' +
-      '`npm run vgai -- play`, look at the game, playtest live, then continue; reading the ' +
+      '`npm run volter -- play`, look at the game, playtest live, then continue; reading the ' +
       'code again does not count.',
   );
 }
 
 // ---------------------------------------------------------------------------
 // E5 — raw Math.random()/Date.now()/performance.now() in src/scripts/**,
-// only when THIS project's own vgai.project.json declares
+// only when THIS project's own volter.project.json declares
 // determinism.seededRandom (D15, T-D15.3's third enforcer leg).
 // ---------------------------------------------------------------------------
 
-/** Reads rootDir/vgai.project.json and reports whether it declares
+/** Reads rootDir/volter.project.json and reports whether it declares
  *  `determinism.seededRandom: true`. Missing/malformed manifests read as
  *  "not declared" (silent) — validating the manifest's own shape is
  *  validate-manifest.ts's job, not this scanner's. */
 function projectDeclaresSeededRandom(): boolean {
-  const manifestPath = join(rootDir, 'vgai.project.json');
+  const manifestPath = join(rootDir, 'volter.project.json');
   if (!existsSync(manifestPath)) return false;
   try {
     const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as {
@@ -943,7 +937,7 @@ function checkDeterminismRng(): void {
         'E5',
         'error',
         'gameplay-rng-ctx-random',
-        `raw "${m[1]}(" in src/scripts/** — this project's vgai.project.json declares ` +
+        `raw "${m[1]}(" in src/scripts/** — this project's volter.project.json declares ` +
           'determinism.seededRandom, so ALL gameplay RNG/wall-clock reads must flow through ' +
           'ctx.random, not raw Math.random()/Date.now()/performance.now().',
         'Use ctx.random() (or ctx.random.stream(name) for an independent named stream) instead.',
@@ -957,7 +951,7 @@ function checkDeterminismRng(): void {
 // ---------------------------------------------------------------------------
 
 function checkUnconfiguredProjectTools(): void {
-  const sentinel = /\bVGAI_STUB_UNIMPLEMENTED\b/g;
+  const sentinel = /\bVOLTER_STUB_UNIMPLEMENTED\b/g;
   const toolFiles = srcFiles.filter((file) => /^(src\/tools|src\/contributions)\//.test(relPath(file)));
   for (const file of toolFiles) {
     const { rawLines, blanked } = readFileText(file);
@@ -969,7 +963,7 @@ function checkUnconfiguredProjectTools(): void {
         'E6',
         'error',
         'studio-surfaces-complete',
-        'VGAI_STUB_UNIMPLEMENTED remains in an editor contribution — this is an explicit starter obligation, not a usable game-specific surface.',
+        'VOLTER_STUB_UNIMPLEMENTED remains in an editor contribution — this is an explicit starter obligation, not a usable game-specific surface.',
         "Rewrite the stub whole in this game's vocabulary and remove its warning. If this is the Data stub and the game genuinely has no authored content tables, delete the file.",
       );
     }
@@ -1007,8 +1001,8 @@ type R3fAnalyzer = (
 ) => R3fDiagnostic[];
 
 /**
- * The editor's OWN R3F source analyzer, resolved from this project's
- * `@editor/*` tsconfig mapping and loaded synchronously.
+ * The editor's OWN R3F source analyzer, resolved from the installed
+ * `@volter/editor-react` package and loaded synchronously.
  *
  * Why not re-implement the codes here: they are a real TypeScript AST pass
  * over the project's import graph (relative imports, re-exports, shared prop
@@ -1018,49 +1012,28 @@ type R3fAnalyzer = (
  * pure (`(code, file) => diagnostics`, `typescript` + `node:fs` and nothing
  * else), so nothing about reusing it needs a server or a session.
  *
- * The mapping is read from the project's own `tsconfig.json` instead of
- * hardcoding a path because it is exactly what the scaffolder rewrites per
- * dependency mode: an in-checkout project points at the engine checkout's
- * `packages/editor/src`, an installed one at
- * `node_modules/@volter/editor-core/src` (the published package ships `src/`).
- * Reading the alias means one code path serves both without knowing which.
- * A node_modules target uses Node's package resolution as a fallback so the
- * same mapping also works when a workspace manager hoists the package.
+ * The published packages ship `src/`, so a module is found as
+ * `node_modules/<package>/<file>` in the project or any directory above it
+ * (a workspace manager may hoist the package).
  *
  * Returns null when the analyzer genuinely cannot be reached. E9 reports that
  * as a finding of its own rather than passing silently — a floor rule that
  * disappears when its instrument is missing reads as a clean bill of health,
  * which is the one thing an analyzer must never produce.
  */
-function resolveEditorModule(relative: string): string | null {
-  const tsconfig = join(rootDir, 'tsconfig.json');
-  if (!existsSync(tsconfig)) return null;
-  let mapped: string;
-  try {
-    const raw = readFileSync(tsconfig, 'utf-8');
-    // Deliberately a text match, not JSON.parse: tsconfigs legitimately carry
-    // comments, and this needs one string out of a known key.
-    const alias = raw.match(/"@editor\/\*"\s*:\s*\[\s*"([^"]+)"/);
-    if (!alias) return null;
-    const baseUrl = raw.match(/"baseUrl"\s*:\s*"([^"]+)"/)?.[1] ?? '.';
-    const aliasTarget = alias[1]!.replace('*', relative);
-    mapped = resolve(rootDir, baseUrl, aliasTarget);
-    if (!existsSync(mapped)) {
-      const nodeModulesMarker = 'node_modules/';
-      const normalizedTarget = aliasTarget.replaceAll('\\', '/');
-      const markerIndex = normalizedTarget.lastIndexOf(nodeModulesMarker);
-      if (markerIndex < 0) return null;
-      const packageTarget = normalizedTarget.slice(markerIndex + nodeModulesMarker.length);
-      mapped = createRequire(join(rootDir, 'package.json')).resolve(packageTarget);
-    }
-  } catch {
-    return null;
+function resolvePackageModule(packageName: string, relative: string): string | null {
+  let dir = rootDir;
+  for (;;) {
+    const candidate = join(dir, 'node_modules', packageName, relative);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
   }
-  return existsSync(mapped) ? mapped : null;
 }
 
 function loadR3fAnalyzer(): R3fAnalyzer | null {
-  const mapped = resolveEditorModule('ui-source/r3f-project-contracts.ts');
+  const mapped = resolvePackageModule('@volter/editor-react', 'src/source/r3f-project-contracts.ts');
   if (!mapped) return null;
   try {
     const loaded = createRequire(import.meta.url)(mapped) as {
@@ -1087,7 +1060,7 @@ function loadR3fAnalyzer(): R3fAnalyzer | null {
  */
 interface RegionSurfaces {
   surfaces: ReadonlyMap<string, string>;
-  /** This project's `vgai.adapter.ts` declares a `regions` binding the static
+  /** This project's `volter.adapter.ts` declares a `regions` binding the static
    *  reader could not evaluate, so its `include` globs were not consulted.
    *  Carried rather than dropped: the editor's own loader EVALUATES that module
    *  and would honor those globs, so silence here means the two readers
@@ -1096,7 +1069,10 @@ interface RegionSurfaces {
 }
 
 function loadRegionSurfaces(): RegionSurfaces | null {
-  const mapped = resolveEditorModule('asset-workflow/project-content.ts');
+  const mapped = resolvePackageModule(
+    '@volter/editor-sdk',
+    'src/kit/asset-workflow/project-source-index.ts',
+  );
   if (!mapped) return null;
   try {
     const loaded = createRequire(import.meta.url)(mapped) as {
@@ -1121,7 +1097,7 @@ function loadRegionSurfaces(): RegionSurfaces | null {
         m: string,
         a: string,
       ) => { regions: unknown[]; unreadable: boolean }
-    )(read('vgai.project.json'), read('vgai.adapter.ts'));
+    )(read('volter.project.json'), read('volter.adapter.ts'));
     const sources = srcFiles.map((file) => ({
       path: relPath(file),
       source: readFileSync(file, 'utf-8'),
@@ -1141,31 +1117,31 @@ function loadRegionSurfaces(): RegionSurfaces | null {
 function checkAuthoringWarnings(): void {
   const analyze = loadR3fAnalyzer();
   if (!analyze) {
-    // Silent for a folder that is not a vgai project at all — this scanner
+    // Silent for a folder that is not a volter-game-editor project at all — this scanner
     // is pointed at scratch directories by its own tests and by curious
     // agents, and a rule about a missing tsconfig mapping is a rule about a
     // project. Inside a real project the mapping is scaffolded, so its
     // absence is worth saying out loud rather than passing quietly.
-    if (!existsSync(join(rootDir, 'vgai.project.json'))) return;
+    if (!existsSync(join(rootDir, 'volter.project.json'))) return;
     addProjectFinding(
       'E9',
       'warn',
       'authoring-warnings-zero',
-      'the R3F authoring analyzer could not be loaded, so authoring warnings were NOT checked — this run says nothing about them. It resolves through this project\'s tsconfig.json "@editor/*" path mapping.',
-      'Restore the "@editor/*" mapping in tsconfig.json (it points at the engine checkout, or at node_modules/@volter/editor-core/src) and re-run. `npm run vgai -- status` reports the same counts from the live editor meanwhile.',
+      'the R3F authoring analyzer could not be loaded, so authoring warnings were NOT checked — this run says nothing about them. It resolves from the installed `@volter/editor-react` package.',
+      'Install the project\'s dependencies (`npm install`): the analyzer is `@volter/editor-react`\'s source and the region resolver `@volter/editor-sdk`\'s. `npm run volter -- status` reports the same counts from the live editor meanwhile.',
     );
     return;
   }
 
   const resolved = loadRegionSurfaces();
   if (!resolved) {
-    if (!existsSync(join(rootDir, 'vgai.project.json'))) return;
+    if (!existsSync(join(rootDir, 'volter.project.json'))) return;
     addProjectFinding(
       'E9',
       'warn',
       'authoring-warnings-zero',
       "the region resolver could not be loaded, so no file could be attributed to this project's `three` region and authoring warnings were NOT checked — this run says nothing about them.",
-      'Restore the "@editor/*" mapping in tsconfig.json (it points at the engine checkout, or at node_modules/@volter/editor-core/src) and re-run. `npm run vgai -- status` reports the same counts from the live editor meanwhile.',
+      'Install the project\'s dependencies (`npm install`): the analyzer is `@volter/editor-react`\'s source and the region resolver `@volter/editor-sdk`\'s. `npm run volter -- status` reports the same counts from the live editor meanwhile.',
     );
     return;
   }
@@ -1175,7 +1151,7 @@ function checkAuthoringWarnings(): void {
       'E9',
       'warn',
       'authoring-warnings-zero',
-      "vgai.adapter.ts declares a `regions` binding that cannot be read statically, so its `include` globs were NOT consulted — any file those globs place is missing from this run, while the editor's own loader still honors them.",
+      "volter.adapter.ts declares a `regions` binding that cannot be read statically, so its `include` globs were NOT consulted — any file those globs place is missing from this run, while the editor's own loader still honors them.",
       'Write the regions as an array of object literals passed directly to defineAdapter({…}), with literal `id` and `include` values (not a hoisted const, not a spread).',
     );
   }
@@ -1349,7 +1325,7 @@ function checkPrefabStories(): void {
 // ---------------------------------------------------------------------------
 
 function manifestHasThreeRoot(): boolean {
-  const manifestPath = join(rootDir, 'vgai.project.json');
+  const manifestPath = join(rootDir, 'volter.project.json');
   if (!existsSync(manifestPath)) return false;
   try {
     const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as {
@@ -1448,7 +1424,7 @@ function checkSceneFolderContract(): void {
 checkPlaywrightImports();
 checkPackageJsonScripts();
 checkNoTestFurniture();
-checkWindowVgai();
+checkWindowVolter();
 checkBotParam();
 checkPollingPump();
 checkColyseusStaticImport();
@@ -1470,7 +1446,7 @@ const warnFindings = findings.filter((f) => f.severity === 'warn');
  *
  * Measured failure: a blind probe ran `typecheck` seven times and this scanner
  * once, at minute 19, which turned every open finding into an end-of-build
- * scramble. `vgai status` — the command an agent polls constantly — reads this
+ * scramble. `volter-game-editor status` — the command an agent polls constantly — reads this
  * file and surfaces the open ERROR findings as an advisory count, so they are
  * visible from the first status call while THIS script stays the gate.
  *
@@ -1479,9 +1455,9 @@ const warnFindings = findings.filter((f) => f.severity === 'warn');
  */
 function writeFindingsRecord(): void {
   try {
-    mkdirSync(join(rootDir, '.vgai'), { recursive: true });
+    mkdirSync(join(rootDir, '.volter'), { recursive: true });
     writeFileSync(
-      join(rootDir, '.vgai', 'check-idioms.json'),
+      join(rootDir, '.volter', 'check-idioms.json'),
       `${JSON.stringify(
         {
           at: new Date().toISOString(),

package/template/manifest-entry-modules-plugin.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from 'vite';
 
-const MANIFEST_ENTRIES_ID = 'virtual:vgai-manifest-entries';
+const MANIFEST_ENTRIES_ID = 'virtual:volter-manifest-entries';
 const RESOLVED_MANIFEST_ENTRIES_ID = `\0${MANIFEST_ENTRIES_ID}`;
 
 function collectManifestEntries(manifest: unknown): string[] {
@@ -20,7 +20,7 @@ function collectManifestEntries(manifest: unknown): string[] {
 
   for (const entry of entries) {
     if (entry.startsWith('/') || entry.includes('\\') || entry.split('/').includes('..')) {
-      throw new Error(`vgai.project.json world entry must be project-relative: ${entry}`);
+      throw new Error(`volter.project.json world entry must be project-relative: ${entry}`);
     }
   }
 
@@ -31,18 +31,31 @@ function collectManifestEntries(manifest: unknown): string[] {
  * Render imports for the manifest's exact `roots[].entry` declarations.
  * The manifest—not a filename convention—is the only discovery source.
  */
+function declaresCanvasRoot(manifest: unknown): boolean {
+  const roots = manifest && typeof manifest === 'object' ? (manifest as { roots?: unknown }).roots : undefined;
+  return (
+    Array.isArray(roots) &&
+    roots.some((root) => root && typeof root === 'object' && (root as { adapter?: unknown }).adapter === 'canvas')
+  );
+}
+
 export function renderManifestEntryModule(manifest: unknown): string {
   const entries = collectManifestEntries(manifest);
   const imports = entries.map(
     (entry, index) => `import * as entry${index} from ${JSON.stringify(`/${entry}`)};`,
   );
   const members = entries.map((entry, index) => `${JSON.stringify(entry)}: entry${index}`);
-  return `${imports.join('\n')}\nexport const manifestEntryModules = {${members.join(',')}};\n`;
+  // Pixi rides only with a declared `canvas` root: its mount (and the two packages it imports)
+  // is `src/canvas-mount.ts`, which only such a project carries.
+  const canvas = declaresCanvasRoot(manifest)
+    ? `export { mountCanvasRoot } from "/src/canvas-mount.ts";`
+    : 'export const mountCanvasRoot = undefined;';
+  return `${imports.join('\n')}\nexport const manifestEntryModules = {${members.join(',')}};\n${canvas}\n`;
 }
 
 export function manifestEntryModulesPlugin(manifest: unknown): Plugin {
   return {
-    name: 'vgai:manifest-entry-modules',
+    name: 'volter:manifest-entry-modules',
     resolveId(id) {
       return id === MANIFEST_ENTRIES_ID ? RESOLVED_MANIFEST_ENTRIES_ID : undefined;
     },

package/template/package.json

@@ -8,14 +8,14 @@
     "node": ">=22.0.0"
   },
   "scripts": {
-    "vgai": "volter-game-editor",
+    "volter": "volter-game-editor",
     "dev": "volter-game-editor edit .",
     "dev:standalone": "vite",
     "build": "tsc && vite build",
     "preview": "vite preview",
     "postinstall": "node scripts/patch-drei-stats-gl.mjs",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.tools.json && tsc --noEmit -p tsconfig.node.json && tsc --noEmit -p server/tsconfig.json",
-    "validate-manifest": "npx tsx validate-manifest.ts vgai.project.json",
+    "validate-manifest": "npx tsx validate-manifest.ts volter.project.json",
     "check-idioms": "npx tsx check-idioms.ts .",
     "server": "npx tsx --tsconfig server/tsconfig.json server/main.ts"
   },
@@ -24,15 +24,13 @@
     "@colyseus/sdk": "^0.17.34",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.1",
-    "@volter/editor-project": "^0.5.68",
-    "@volter/game-runtime": "^0.5.68",
-    "@volter/threejs-runtime": "^0.5.68",
+    "@volter/editor-project": "^0.5.70",
+    "@volter/game-runtime": "^0.5.70",
+    "@volter/threejs-runtime": "^0.5.70",
     "react": "~19.2.4",
     "react-dom": "~19.2.4",
     "three": "^0.180.0",
-    "zod": "^4.3.6",
-    "@pixi/react": "8.0.5",
-    "pixi.js": "^8.6.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@colyseus/ws-transport": "^0.17.9",
@@ -42,13 +40,13 @@
     "@types/react-dom": "^19.2.3",
     "@types/three": "^0.180.0",
     "@vitejs/plugin-react": "^5.1.4",
-    "@volter/editor-core": "^0.5.68",
-    "@volter/editor-game": "^0.5.68",
-    "@volter/editor-live": "^0.5.68",
-    "@volter/editor-sdk": "^0.5.68",
-    "@volter/editor-threejs": "^0.5.68",
-    "@volter/game-editor": "^0.5.68",
-    "@volter/game-live": "^0.5.68",
+    "@volter/editor-core": "^0.5.70",
+    "@volter/editor-game": "^0.5.70",
+    "@volter/editor-live": "^0.5.70",
+    "@volter/editor-sdk": "^0.5.70",
+    "@volter/editor-threejs": "^0.5.70",
+    "@volter/game-editor": "^0.5.70",
+    "@volter/game-live": "^0.5.70",
     "colyseus": "^0.17.8",
     "storybook": "10.6.0",
     "tsx": "^4.23.0",