@volter/game-editor 0.5.67 → 0.5.69

package/template/IDIOMS.md

@@ -11,7 +11,7 @@ Legend: **ERROR** fails every run; **WARN** prints but fails only with
 
 - The source is the document. Three roots are ordinary R3F TSX, Canvas roots
   are ordinary Pixi/React source, and DOM roots are ordinary React. The world
-  node is the entity; no mirror ECS, registration layer, or vgai runtime API
+  node is the entity; no mirror ECS, registration layer, or volter runtime API
   belongs in gameplay components. **LOOK**
 - A DOM HUD is a manifest `dom` root and reads the project's own React
   context/store. A timer repeatedly copying game state into React state is a
@@ -60,7 +60,7 @@ Legend: **ERROR** fails every run; **WARN** prints but fails only with
   behavior being judged. The tester's repertoire grows in the slice that adds
   each mechanic. **LOOK**
 - `src/tools/` is literal contribution TSX. The unfinished Tester/Data/Analytics stubs
-  emit `VGAI_STUB_UNIMPLEMENTED`; replacing or honestly deleting the relevant
+  emit `VOLTER_STUB_UNIMPLEMENTED`; replacing or honestly deleting the relevant
   stub is required before completion. **ERROR E6**
 - Tester holds live QA state, controller ownership, goals/mind, setup cheats,
   and judgment readings. Analytics holds historical session data. Data holds
@@ -76,7 +76,7 @@ Legend: **ERROR** fails every run; **WARN** prints but fails only with
 - Playtesting is interactive: arrange, direct the tester, advance sim time,
   observe, read the log, redirect. No committed route, test file, test-runner
   dependency, or test script belongs in a game project. **ERROR E12**
-- Do not boot a private Playwright harness, reach through `window.__vgai`, or
+- Do not boot a private Playwright harness, reach through `window.__volter`, or
   add `?bot=` boot plumbing. Use the editor-owned session and the game's
   running modules. **ERROR E1–E4**
 - Gameplay source must not accumulate for many commits before the first Play

package/template/LICENSE

@@ -2,13 +2,13 @@ MIT License
 
 Copyright (c) 2026 Volter AI, Inc.
 
-This MIT license covers the vgai game-project template (this directory) — the
+This MIT license covers the Volter game-project template (this directory) — the
 starter code scaffolded into your project. It is intentionally permissive so that
-the game you build with vgai, and anything you generate from this template, is
+the game you build with Volter, and anything you generate from this template, is
 YOURS, free of any obligations to us. You may relicense your generated game
 under any terms you choose.
 
-(The vgai engine and tooling — everything outside this directory — are licensed
+(The Volter engine and tooling — everything outside this directory — are licensed
 per component: Apache-2.0 core, AGPL-3.0 editor. See the repository LICENSE.md.)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

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
@@ -18,7 +18,7 @@ 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 +26,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 +50,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 +76,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
@@ -105,7 +105,7 @@ 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-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
@@ -117,7 +117,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 +147,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 +166,7 @@ const SKIP_DIRS = new Set([
   '.github',
   'dist',
   'build',
-  '.vgai',
+  '.volter',
   'coverage',
   '.turbo',
 ]);
@@ -347,7 +347,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 +380,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 +393,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 +403,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 +477,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 +509,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 +550,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,9 +710,9 @@ 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.
+// The volter CLI mirrors this exact measurement (source path, gameplay
+// pathspecs, threshold, silent-on-unaskable) as `volter-game-editor status`'s ambient
+// bot-drift line — engine repo, packages/volter-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.
 
@@ -848,7 +848,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/create-volter-project/src/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 +859,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 +900,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 +943,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 +957,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 +969,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.",
       );
     }
@@ -1087,7 +1087,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
@@ -1121,7 +1121,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 +1141,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.',
+      '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 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.',
+      '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 volter -- status` reports the same counts from the live editor meanwhile.',
     );
     return;
   }
@@ -1175,7 +1175,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 +1349,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 +1448,7 @@ function checkSceneFolderContract(): void {
 checkPlaywrightImports();
 checkPackageJsonScripts();
 checkNoTestFurniture();
-checkWindowVgai();
+checkWindowVolter();
 checkBotParam();
 checkPollingPump();
 checkColyseusStaticImport();
@@ -1470,7 +1470,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 +1479,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,9 +24,9 @@
     "@colyseus/sdk": "^0.17.34",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.1",
-    "@volter/editor-project": "^0.5.67",
-    "@volter/game-runtime": "^0.5.67",
-    "@volter/threejs-runtime": "^0.5.67",
+    "@volter/editor-project": "^0.5.69",
+    "@volter/game-runtime": "^0.5.69",
+    "@volter/threejs-runtime": "^0.5.69",
     "react": "~19.2.4",
     "react-dom": "~19.2.4",
     "three": "^0.180.0",
@@ -40,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.67",
-    "@volter/editor-game": "^0.5.67",
-    "@volter/editor-live": "^0.5.67",
-    "@volter/editor-sdk": "^0.5.67",
-    "@volter/editor-threejs": "^0.5.67",
-    "@volter/game-editor": "^0.5.67",
-    "@volter/game-live": "^0.5.67",
+    "@volter/editor-core": "^0.5.69",
+    "@volter/editor-game": "^0.5.69",
+    "@volter/editor-live": "^0.5.69",
+    "@volter/editor-sdk": "^0.5.69",
+    "@volter/editor-threejs": "^0.5.69",
+    "@volter/game-editor": "^0.5.69",
+    "@volter/game-live": "^0.5.69",
     "colyseus": "^0.17.8",
     "storybook": "10.6.0",
     "tsx": "^4.23.0",

package/template/server/loopback.ts

@@ -5,7 +5,7 @@
  * scaffolded project so a multiplayer game can prove itself headlessly:
  * a test under `tests/logic/` seats two peers and drives them. Driving a
  * second peer against the
- * RUNNING game is a different job, and its door is `vgai eval`.
+ * RUNNING game is a different job, and its door is `volter-game-editor eval`.
  *
  * Starts the REAL `startColyseus` bootstrap (`./colyseus-setup.js`) with the
  * shipped room registry (`./rooms.js` — `ArenaRoom` + `GameRoom`) on an

package/template/server/main.ts

@@ -2,7 +2,7 @@
  * `npm run server` entry point — boots the Colyseus multiplayer server
  * (rooms.ts's registry, on ws://localhost:2567).
  *
- * The project runs it as its `server` configuration (`vgai.project.json`), and Play starts it
+ * The project runs it as its `server` configuration (`volter.project.json`), and Play starts it
  * through `play + server`, before the game's client half (`src/net/`) joins `game_room`. Both
  * arrive with the `server` addition; a project without it keeps these rooms and has neither.
  *
@@ -29,9 +29,9 @@
 import { startColyseus } from './colyseus-setup.js';
 import { rooms } from './rooms.js';
 
-// The editor's `server` configuration sets VGAI_ROOM_MONITOR so its Network inspector can read
+// The editor's `server` configuration sets VOLTER_ROOM_MONITOR so its Network inspector can read
 // the server's side through Colyseus Monitor; a production start leaves it unset.
-const handle = await startColyseus({ rooms, monitor: process.env['VGAI_ROOM_MONITOR'] === '1' }).catch((err: NodeJS.ErrnoException) => {
+const handle = await startColyseus({ rooms, monitor: process.env['VOLTER_ROOM_MONITOR'] === '1' }).catch((err: NodeJS.ErrnoException) => {
   // The refusal below already says everything a reader needs; a raw stack
   // around it would be noise.
   if (err?.code !== 'EADDRINUSE') throw err;
@@ -43,7 +43,7 @@ const handle = await startColyseus({ rooms, monitor: process.env['VGAI_ROOM_MONI
   console.error(
     'Colyseus: the server port is already in use — this server did not start.\n' +
       '  Another `npm run server` in a second terminal is the likely holder. Stop\n' +
-      '  whatever holds the port and re-run (`vgai sessions` lists live editors).',
+      '  whatever holds the port and re-run (`volter-game-editor sessions` lists live editors).',
   );
   process.exit(1);
 });