@volter/editor-game 0.5.68 → 0.5.69

package/src/react/react-world-authoring-adapter.ts

@@ -1052,7 +1052,7 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     this.matchedCssRules =
       opts.matchedCssRules ??
       ((el) => getMatchedCssRules(el as MatchableElement) as CssRuleTarget[]);
-    // Game CSS is SCOPED (`@scope ([data-vgai-game-styles])`, measured:
+    // Game CSS is SCOPED (`@scope ([data-volter-game-styles])`, measured:
     // a project stylesheet's `:root { --x }` never reaches the editor page's
     // root), so the document root sees no game token — the adapter's OWN
     // mounted root is inside the scope and inherits them all. Fall back to
@@ -1060,13 +1060,13 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     const tokenStyle = () => {
       const root = this.root as unknown as Element;
       // Tokens inherit DOWNWARD from each game-CSS scope root
-      // (`[data-vgai-game-styles]`), which sits BELOW this adapter's layer —
+      // (`[data-volter-game-styles]`), which sits BELOW this adapter's layer —
       // so read the first scope root's computed style, not the layer's
       // (measured: the layer sees none of the game's custom properties).
       const el =
         typeof Element !== 'undefined' && root instanceof Element
-          ? (root.querySelector('[data-vgai-game-styles]') ??
-            root.closest?.('[data-vgai-game-styles]') ??
+          ? (root.querySelector('[data-volter-game-styles]') ??
+            root.closest?.('[data-volter-game-styles]') ??
             root)
           : typeof document !== 'undefined'
             ? document.documentElement
@@ -1422,8 +1422,8 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
   private elementLabel(n: OidNode, tree: OidTree): string {
     // Preserve the explicit escape hatch, but make ordinary DOM semantics
     // sufficient by default. Authored React should not need component splits
-    // or `data-vgai-name` merely to produce a legible hierarchy.
-    const editorLabel = normalizeElementText(n.el.getAttribute('data-vgai-name'));
+    // or `data-volter-name` merely to produce a legible hierarchy.
+    const editorLabel = normalizeElementText(n.el.getAttribute('data-volter-name'));
     if (editorLabel) return editorLabel;
 
     const labelledBy = n.el.getAttribute('aria-labelledby');
@@ -1489,10 +1489,10 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     const parent = n.parentId ? tree.nodes.get(n.parentId) : null;
     const parentComponent = parent ? this.componentName(parent) : null;
     const isComponentBoundary = component !== null && component !== parentComponent;
-    const crossSurfaceId = n.el.getAttribute('data-vgai-hierarchy-id');
-    const crossSurfaceParentId = n.el.getAttribute('data-vgai-hierarchy-parent-id');
-    const crossSurfaceOrderAttribute = n.el.getAttribute('data-vgai-hierarchy-order');
-    const crossSurfaceGroupLabel = n.el.getAttribute('data-vgai-hierarchy-group-label');
+    const crossSurfaceId = n.el.getAttribute('data-volter-hierarchy-id');
+    const crossSurfaceParentId = n.el.getAttribute('data-volter-hierarchy-parent-id');
+    const crossSurfaceOrderAttribute = n.el.getAttribute('data-volter-hierarchy-order');
+    const crossSurfaceGroupLabel = n.el.getAttribute('data-volter-hierarchy-group-label');
     const crossSurfaceOrder =
       crossSurfaceOrderAttribute === null ? undefined : Number(crossSurfaceOrderAttribute);
     const node: EditorNode = {
@@ -1525,10 +1525,10 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     const semanticIds = new Set<string>();
     for (const node of tree.nodes.values()) {
       if (
-        node.el.getAttribute('data-vgai-hierarchy-id') !== null ||
-        node.el.getAttribute('data-vgai-hierarchy-parent-id') !== null ||
-        node.el.getAttribute('data-vgai-hierarchy-order') !== null ||
-        node.el.getAttribute('data-vgai-hierarchy-group-label') !== null
+        node.el.getAttribute('data-volter-hierarchy-id') !== null ||
+        node.el.getAttribute('data-volter-hierarchy-parent-id') !== null ||
+        node.el.getAttribute('data-volter-hierarchy-order') !== null ||
+        node.el.getAttribute('data-volter-hierarchy-group-label') !== null
       ) {
         semanticIds.add(node.id);
       }
@@ -1545,10 +1545,10 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
           [
             node.id,
             parentId,
-            node.el.getAttribute('data-vgai-hierarchy-id'),
-            node.el.getAttribute('data-vgai-hierarchy-parent-id'),
-            node.el.getAttribute('data-vgai-hierarchy-order'),
-            node.el.getAttribute('data-vgai-hierarchy-group-label'),
+            node.el.getAttribute('data-volter-hierarchy-id'),
+            node.el.getAttribute('data-volter-hierarchy-parent-id'),
+            node.el.getAttribute('data-volter-hierarchy-order'),
+            node.el.getAttribute('data-volter-hierarchy-group-label'),
           ],
         ];
       }),
@@ -2653,7 +2653,7 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
     // boundary the scoped stylesheet paints — falling back to the document
     // for a fixture element outside any scope.
     const scope =
-      (typeof el.closest === 'function' ? el.closest('[data-vgai-game-styles]') : null) ??
+      (typeof el.closest === 'function' ? el.closest('[data-volter-game-styles]') : null) ??
       el.ownerDocument;
     return tokens.map((name) => {
       let count = 0;
@@ -3592,7 +3592,7 @@ export class ReactRootAuthoringAdapter implements AuthoringAdapter {
   }
 
   // A class GETTER, not a field initializer — see `ui-authoring-adapter.ts`/
-  // `vgai-scene-authoring-adapter.ts` for why (field initializers run before the
+  // `volter-scene-authoring-adapter.ts` for why (field initializers run before the
   // constructor body assigns `this.writeBackend`).
   get persistence(): PersistenceProvider {
     const backend = this.writeBackend;

package/src/react/story-documents/story-documents.tsx

@@ -746,7 +746,7 @@ export function StoryDocsDocumentContent({ documentId }: WorkspaceDocumentConten
     <article
       data-testid="story-docs-document"
       // §2.31 P2 amendment: docs prose reads over a local frost layer.
-      className="vgai-content-frost"
+      className="volter-content-frost"
       style={{
         // §2.31: no root fill — the dock document surface shows through.
         flex: 1,
@@ -975,7 +975,7 @@ function ArgRow({ id, name, value }: { id: string; name: string; value: unknown
       </span>
       {typeof value === 'boolean' ? (
         <Checkbox
-          className="vgai-checkbox"
+          className="volter-checkbox"
           data-testid={`story-arg-${name}`}
           checked={value}
           onChange={(e) => setStoryArgOverride(id, name, e.target.checked)}
@@ -983,7 +983,7 @@ function ArgRow({ id, name, value }: { id: string; name: string; value: unknown
       ) : typeof value === 'number' ? (
         <TextInput
           type="number"
-          className="vgai-input"
+          className="volter-input"
           data-testid={`story-arg-${name}`}
           value={value}
           onChange={(e) => {
@@ -1002,7 +1002,7 @@ function ArgRow({ id, name, value }: { id: string; name: string; value: unknown
       ) : typeof value === 'string' ? (
         <TextInput
           type="text"
-          className="vgai-input"
+          className="volter-input"
           data-testid={`story-arg-${name}`}
           value={value}
           onChange={(e) => setStoryArgOverride(id, name, e.target.value)}

package/src/react/ui-component-board.ts

@@ -67,6 +67,6 @@ export const uiComponentBoard: ComponentBoard = {
     `This project has no ${UI_COMPONENTS_TITLE} board (${UI_COMPONENTS_DOCUMENT_ID}): board ` +
     "presence keys on STORIES, not on roots, and none of this project's stories declares the " +
     '"dom" medium. Declare it — a manifest root entry naming the story\'s module, or a ' +
-    `\`vgai.adapter.ts\` regionInclude that covers it — and the board appears. ${commandLine('console')} ` +
+    `\`volter.adapter.ts\` regionInclude that covers it — and the board appears. ${commandLine('console')} ` +
     'names every story it could not place.',
 };

package/src/runtime/adapter/audio-meter.ts

@@ -2,7 +2,7 @@
  * Meter arithmetic over an `AudioAdapter`'s `AudioMeterFrame.level` — the one
  * place a linear RMS level becomes dBFS and a bar fill. Lives beside the
  * adapter because both readers of a level (the editor's header meter and the
- * `@vgai/game` audio debugger) are consumers of the adapter, and neither may
+ * `@volter/game` audio debugger) are consumers of the adapter, and neither may
  * import the other.
  */
 

package/src/runtime/adapter/ingest/contract-debug-adapter.ts

@@ -1,5 +1,5 @@
 /**
- * Projects a game's DECLARED system surface (`window.vgaiGame.systems`, see
+ * Projects a game's DECLARED system surface (`window.volterGame.systems`, see
  * `game-contract.ts`) onto the host's existing {@link DebugAdapter} — the one
  * seam `game.commands()` / `game.state()` / `game.providers()` already read
  * through for first-party content (`command-listener.ts`'s
@@ -9,7 +9,7 @@
  * game must not have to learn a parallel vocabulary. A first-party game
  * registers verbs with `ctx.debug.registerCommand`; an ingested game declares
  * them in its entry shim. Both arrive at the SAME `DebugAdapter`, so every
- * consumer downstream — the CLI's `vgai eval`, `@vgai/e2e`'s `GameClient`, the
+ * consumer downstream — the CLI's `volter-game-editor eval`, `@volter/e2e`'s `GameClient`, the
  * editor's Debug Console and State Watch panels — works unchanged and unaware
  * of the provenance.
  *
@@ -23,7 +23,7 @@
  *   emitted), not a stub standing in for a missing feature.
  */
 
-import type { VgaiGameSystems } from '@volter/editor-project/adapter/ingest/game-contract';
+import type { VolterGameSystems } from '@volter/editor-project/adapter/ingest/game-contract';
 import type {
   DebugAdapter,
   DebugCommandInfo,
@@ -39,7 +39,7 @@ import { DebugError } from '../../debug-registry';
  * when the truth is "this game declared nothing".
  */
 export function createContractDebugAdapter(
-  systems: VgaiGameSystems | undefined | null,
+  systems: VolterGameSystems | undefined | null,
 ): DebugAdapter | null {
   const commandList = systems?.commands ?? [];
   const providerList = systems?.state ?? [];

package/src/runtime/adapter/ingest/contract-system-adapters.ts

@@ -1,6 +1,6 @@
 /**
- * Projects a game's declared {@link VgaiGameSystemAdapters}
- * (`window.vgaiGame.systems.systemAdapters`) onto the host's ordinary
+ * Projects a game's declared {@link VolterGameSystemAdapters}
+ * (`window.volterGame.systems.systemAdapters`) onto the host's ordinary
  * {@link SystemAdapters} bag — the ingest-realm counterpart of a first-party
  * world's `ctx.registerSystemAdapter`, and the sibling of
  * `contract-debug-adapter.ts` (which owns the `debug` slot).
@@ -55,9 +55,9 @@ export type {
 } from '@volter/editor-project/adapter/ingest/contract-system-slots';
 
 import type {
-  VgaiGameSystemAdapters,
-  VgaiGameSystemEmpty,
-  VgaiGameSystems,
+  VolterGameSystemAdapters,
+  VolterGameSystemEmpty,
+  VolterGameSystems,
 } from '@volter/editor-project/adapter/ingest/game-contract';
 import { GAME_SYSTEM_ADAPTERS_SHAPE } from '@volter/editor-project/adapter/ingest/game-contract-seams';
 import {
@@ -70,7 +70,7 @@ import {
 } from '@volter/editor-project/adapter/system-seam-contract';
 
 /** The slots a game may declare through the contract (`debug` is projected from
- *  `commands`/`state` instead — see {@link VgaiGameSystemAdapters}). */
+ *  `commands`/`state` instead — see {@link VolterGameSystemAdapters}). */
 export type { ContractSystemSlot } from '@volter/editor-project/adapter/ingest/contract-system-slots';
 
 /**
@@ -132,7 +132,7 @@ const EMPTY_PROJECTION: ContractSystemAdapterProjection = {
   malformed: [],
 };
 
-function isEmptyRecord(value: object): value is VgaiGameSystemEmpty {
+function isEmptyRecord(value: object): value is VolterGameSystemEmpty {
   return (value as { present?: unknown }).present === false;
 }
 
@@ -198,7 +198,7 @@ function classifyDeclaredSlot(
     };
   }
   if (isEmptyRecord(value)) {
-    const evidence = (value as VgaiGameSystemEmpty).evidence;
+    const evidence = (value as VolterGameSystemEmpty).evidence;
     // An empty claim with no evidence is exactly the "wrong empty claim" the
     // bar calls a defect — it asserts an absence nobody can re-check.
     if (typeof evidence !== 'string' || evidence.trim() === '') {
@@ -231,7 +231,7 @@ function classifyDeclaredSlot(
  * header for what it buys and why its absence checks nothing.
  */
 export function projectContractSystemAdapters(
-  systems: VgaiGameSystems | undefined | null,
+  systems: VolterGameSystems | undefined | null,
   surface?: ContractSurface | undefined,
 ): ContractSystemAdapterProjection {
   const declared = systems?.systemAdapters;

package/src/runtime/adapter/ingest/merge-debug-adapters.ts

@@ -3,9 +3,9 @@
  *
  * Two feeders exist today and they are peers, not layers: the game's own
  * declared system surface (`contract-debug-adapter.ts`, from
- * `window.vgaiGame.systems`) and its adapter module's observation table
+ * `window.volterGame.systems`) and its adapter module's observation table
  * (`observation-debug-adapter.ts`). Both project onto the ONE runtime door the
- * editor and `vgai eval` already read (`SystemAdapters.debug`), so the merge
+ * editor and `volter-game-editor eval` already read (`SystemAdapters.debug`), so the merge
  * belongs here rather than in a second slot — a consumer must not be able to
  * tell a name's provenance, which is the whole point of both projections.
  *

package/src/runtime/adapter/ingest/observation-debug-adapter.ts

@@ -7,7 +7,7 @@
  *
  * This is the SIBLING of `contract-debug-adapter.ts` and deliberately the same
  * shape: a projection rather than a second door. The two differ only in WHO
- * declared the surface — the game itself, on `window.vgaiGame.systems`, or the
+ * declared the surface — the game itself, on `window.volterGame.systems`, or the
  * game's adapter module beside it — and a consumer downstream must not be able
  * to tell them apart. `merge-debug-adapters.ts` is what folds both onto the one
  * slot.

package/src/runtime/adapter/native-debug-module.ts

@@ -5,7 +5,7 @@
  *
  *   export { debug } from './commands';
  *
- * The command module imports no vgai API. Its functions are the application's
+ * The command module imports no volter API. Its functions are the application's
  * own functions over its own stores; the native adapter merely projects that
  * existing registry onto the session debug/input doors after the root mounts.
  * Loading through the root entry is load-bearing: the functions close over the
@@ -13,7 +13,7 @@
  * copy of its stores.
  */
 
-import type { VgaiGameSystemAdapters } from '@volter/editor-project/adapter/ingest/game-contract';
+import type { VolterGameSystemAdapters } from '@volter/editor-project/adapter/ingest/game-contract';
 import type {
   NativeCommandEntry,
   NativeDebugBinding,
@@ -407,12 +407,12 @@ export function installNativeDebugBindings(
 //   export { debug, systems } from './commands';
 //
 // — whose slots are the ONE declarable carrier both realms share,
-// `VgaiGameSystemAdapters` (`ingest/game-contract.ts`; the native engine is
+// `VolterGameSystemAdapters` (`ingest/game-contract.ts`; the native engine is
 // the premade 100% implementation of that contract). Validation is the SAME
 // projection the ingest realm uses (`ingest/contract-system-adapters.ts`), so
 // there is one shape law, not two. This door is what retires
 // `ctx.registerSystemAdapter` from component code (ARCHITECTURE-CORE §System
-// adapters: "a project's `vgai.adapter.ts` binds app-owned systems through
+// adapters: "a project's `volter.adapter.ts` binds app-owned systems through
 // declared native exports … Components never call `registerSystemAdapter`").
 //
 // Native-realm difference from ingest: a malformed slot THROWS (this is our
@@ -437,7 +437,7 @@ export function nativeSystemsBindingFromEntryModule(
   }
   rejectUnknownKeys(raw, CONTRACT_SYSTEM_SLOTS, `Root "${rootId}" systems export`);
   const projection = projectContractSystemAdapters(
-    { systemAdapters: raw as VgaiGameSystemAdapters },
+    { systemAdapters: raw as VolterGameSystemAdapters },
     surface,
   );
   if (projection.malformed.length > 0) {

package/src/runtime/audio/pose-guard.ts

@@ -19,7 +19,7 @@ interface GuardState {
 
 // The editor bundle and source-served runtime can load this helper separately
 // while sharing Three. Installation belongs to the actual prototype identity.
-const GUARD_STATE = Symbol.for('vgai.audio-pose-guard');
+const GUARD_STATE = Symbol.for('volter.audio-pose-guard');
 type AudioPrototype = {
   updateMatrixWorld: UpdateMatrixWorld;
   [GUARD_STATE]?: GuardState;

package/src/runtime/core/game-scoped-slot.ts

@@ -11,7 +11,7 @@ export function createGameScopedSlot<T>(name: string): {
   set(owner: object, value: T): void;
   get(owner: object): T | null;
 } {
-  const key = Symbol.for(`@vgai/game-runtime/game-scoped/${name}`);
+  const key = Symbol.for(`@volter/game-runtime/game-scoped/${name}`);
 
   return {
     set(owner, value) {

package/src/runtime/create-runtime.ts

@@ -299,7 +299,7 @@ export interface RootsRuntimeConfig {
    */
   headless?: boolean | undefined;
   /**
-   * `vgai.project.json`'s `rendering.antialias` — whether every three root's
+   * `volter.project.json`'s `rendering.antialias` — whether every three root's
    * WebGL context is built with a multisampled drawing buffer.
    *
    * It is a RUNTIME-CONFIG option rather than a world's own
@@ -315,7 +315,7 @@ export interface RootsRuntimeConfig {
    *  world's `mount()`/`setup()` runs (this function constructs the Game
    *  first — see `createRootsGameRuntime`). The manifest-aware boot path
    *  (`mount-manifest.ts`'s `mountManifestRoots`) is the real caller that
-   *  resolves this from `manifest.determinism`/`?vgai-seed=`/its own
+   *  resolves this from `manifest.determinism`/`?volter-seed=`/its own
    *  explicit-config leg; a caller building `RootsRuntimeConfig` by hand
    *  (a test, a bespoke host) may also set it directly. Omitting it falls
    *  back to `createGame`'s own fixed default. */
@@ -326,7 +326,7 @@ export interface RootsRuntimeConfig {
   /**
    * Test-only overrides for the render-control seam this host now wires up
    * for EVERY session (see `createRootsGameRuntime`): `location` is where
-   * `?vgai-render=1` is read from (defaults to the real `window.location`;
+   * `?volter-render=1` is read from (defaults to the real `window.location`;
    * a Node test has no `window` and must inject one to exercise the seam),
    * `target` is where the harness publishes (defaults to the real `window`
    * — override in a unit test to avoid touching the global object; mirrors
@@ -673,7 +673,7 @@ async function mountOneReactRoot(
  */
 
 /**
- * Dev/e2e-only `window.__vgaiScene`/`__vgaiCamera` exposure for the roots
+ * Dev/e2e-only `window.__volterScene`/`__volterCamera` exposure for the roots
  * path's default world — split out of `createRootsGameRuntime` purely
  * to keep that function's own cyclomatic complexity down. It uses the
  * "first three world, else none" rule: a non-Three default world publishes
@@ -687,7 +687,7 @@ function installDefaultRootDevGlobals(game: GameInternal): () => void {
   if (defaultMounted.kind !== 'three') return () => {};
   const scene = defaultMounted.scene;
   const w = window as unknown as Record<string, unknown>;
-  w['__vgaiScene'] = scene;
+  w['__volterScene'] = scene;
   // An ACCESSOR, not a value read once: a world may replace its camera after
   // mount (fiber's `set({ camera })` — drei's `makeDefault`, or a translated
   // Godot world installing the camera its `.tscn` authors), and a snapshot
@@ -697,15 +697,15 @@ function installDefaultRootDevGlobals(game: GameInternal): () => void {
   // rule the value comparison was.
   const readCamera = (): THREE.PerspectiveCamera =>
     defaultMounted.camera as THREE.PerspectiveCamera;
-  Object.defineProperty(w, '__vgaiCamera', {
+  Object.defineProperty(w, '__volterCamera', {
     get: readCamera,
     configurable: true,
     enumerable: true,
   });
   return () => {
-    if (w['__vgaiScene'] === scene) delete w['__vgaiScene'];
-    if (Object.getOwnPropertyDescriptor(w, '__vgaiCamera')?.get === readCamera)
-      delete w['__vgaiCamera'];
+    if (w['__volterScene'] === scene) delete w['__volterScene'];
+    if (Object.getOwnPropertyDescriptor(w, '__volterCamera')?.get === readCamera)
+      delete w['__volterCamera'];
   };
 }
 
@@ -845,7 +845,7 @@ function installSessionRenderHarness(
     target,
   });
   return () => {
-    delete target['__vgaiRender'];
+    delete target['__volterRender'];
   };
 }
 
@@ -920,14 +920,14 @@ async function createRootsGameRuntime(config: RootsRuntimeConfig): Promise<GameS
   stacked.forEach((entry, i) => {
     const isReact = kindById.get(entry.id) === 'dom';
     const surface = document.createElement(isReact ? 'div' : 'canvas') as HTMLElement;
-    surface.dataset['vgaiRootSurface'] = 'true';
+    surface.dataset['volterRootSurface'] = 'true';
     // WHICH ROOT THIS SURFACE PRESENTS — the host mounted it, so the host
     // knows, and stamping it here is the difference between a declaration and
     // the guess every late reader had to make instead ("the first <canvas> in
     // DOM order is the game's"). Read by `packages/editor/src/presentation-
     // surface.ts`, which is the one door the capture/staleness/screenshot
     // sites now ask (ARCHITECTURE-CORE §The editor protocol, zero inference).
-    surface.dataset['vgaiRootId'] = entry.id;
+    surface.dataset['volterRootId'] = entry.id;
     if (!isReact) {
       const canvas = surface as unknown as HTMLCanvasElement;
       canvas.width = w;
@@ -961,7 +961,7 @@ async function createRootsGameRuntime(config: RootsRuntimeConfig): Promise<GameS
 
   const assets = createAssetCache();
   // Every manifest/host-mounted game is a deterministic-capture candidate —
-  // the render-control seam (`?vgai-render=1`, render-control.ts) is wired
+  // the render-control seam (`?volter-render=1`, render-control.ts) is wired
   // HERE, at the one host every boot path shares (mountManifestRoots and
   // direct createGameRuntime callers both reach this function), instead of asking every project's entry page to install it
   // the way the e2e fixtures do. Production-protected twice over:
@@ -1030,7 +1030,7 @@ async function createRootsGameRuntime(config: RootsRuntimeConfig): Promise<GameS
   // Expose the default Three root's scene and camera for dev/e2e tooling.
   const retractDevGlobals = installDefaultRootDevGlobals(game);
 
-  // G3/FT-11 — publish `window.__vgaiRender` for the deterministic capture
+  // G3/FT-11 — publish `window.__volterRender` for the deterministic capture
   // host. Installed at the TAIL of the mount (same position as
   // mount-manifest.ts's debug bridge): every world's `mount()`/`setup()` has
   // resolved by now, so the harness's `scene` readiness hook reporting ready

package/src/runtime/debug-bridge.ts

@@ -1,15 +1,15 @@
 /**
- * The standalone in-page debug bridge. Query-gated `window.__vgai`, the same
+ * The standalone in-page debug bridge. Query-gated `window.__volter`, the same
  * production-protection-lives-in-the-installer pattern `render-control.ts`'s
- * `installRenderControlHarness` established for `?vgai-render=1` (production
+ * `installRenderControlHarness` established for `?volter-render=1` (production
  * protection lives HERE, not just at whatever call site invokes this — a
  * caller that calls {@link maybeInstallDebugBridge} unconditionally on every
  * boot still only ever gets a handle when the gate below actually passes).
  *
  * D17: this is door (a) of the seam's three doors — the SAME `DebugAdapter`
- * names/JSON the editor relay (door b) and `@vgai/live` (door c, which
+ * names/JSON the editor relay (door b) and `@volter/live` (door c, which
  * drives door (a) itself over Playwright) all read. D18: the bridge installs
- * only when the page opts in (`?vgai-debug=1`) AND is either a dev build
+ * only when the page opts in (`?volter-debug=1`) AND is either a dev build
  * (`import.meta.env.DEV`) or the project's manifest explicitly opts a
  * production build in (`manifest.debug.allowInProduction`, the described
  * field whose runtime reader THIS module is).
@@ -23,7 +23,7 @@ import { runTicksWhenSettled } from './run-ticks-settled';
 /** Query-param name that opts a standalone page into the debug bridge (D18) —
  *  mirrors `render-seed.ts`'s `RENDER_MODE_QUERY_PARAM` naming/shape, own
  *  const because this is a different call site with a different flag. */
-export const DEBUG_MODE_QUERY_PARAM = 'vgai-debug';
+export const DEBUG_MODE_QUERY_PARAM = 'volter-debug';
 
 /** The subset of `ResolvedGameManifest` the D18 gate reads — typed narrowly
  *  (not imported from `manifest/load.ts`) so this module doesn't need the
@@ -40,7 +40,7 @@ export interface DebugBridgeManifest {
  *  resolution function, `debug-registry.ts`'s `resolveInputRootId`) — never
  *  "whichever root happened to register last". An explicit `worldId`
  *  reaches that root's door specifically. */
-export interface VgaiDebugInputHandle {
+export interface VolterDebugInputHandle {
   setVirtualAction(
     action: string,
     value: boolean | number | { x: number; y: number },
@@ -100,7 +100,7 @@ export interface VgaiDebugInputHandle {
  *  every field reflects the exact same instant (AC-B1.2's batched-read
  *  primitive: a probe polling this never sees `time` from one tick and
  *  `state` from another). */
-export interface VgaiDebugSnapshot {
+export interface VolterDebugSnapshot {
   /** `loopLiveness` (issue #175): the REAL `GameLoop.liveness` behind this
    *  session — `'loop-starved'` when no recent host rAF progress was observed,
    *  `null` only when no loop is wired at all (a bare debug-registry test
@@ -112,11 +112,11 @@ export interface VgaiDebugSnapshot {
   pageErrors: string[];
 }
 
-/** The frozen `window.__vgai` shape (D18/spec §3.4) — version it if it ever
+/** The frozen `window.__volter` shape (D18/spec §3.4) — version it if it ever
  *  needs a breaking change; `providers`/`state`/`stateAll`/`commands`/`events`
  *  are straight off the game's `DebugAdapter`, `invoke` re-checks D18 gating
  *  (belt-and-braces, AC-A1.7), and `input`/`snapshot` are bridge-only. */
-export interface VgaiDebugHandle {
+export interface VolterDebugHandle {
   readonly version: 1;
   providers: DebugAdapter['providers'];
   state: DebugAdapter['state'];
@@ -124,12 +124,12 @@ export interface VgaiDebugHandle {
   commands: DebugAdapter['commands'];
   invoke(name: string, args: unknown[]): Promise<unknown>;
   events: DebugAdapter['events'];
-  input: VgaiDebugInputHandle;
+  input: VolterDebugInputHandle;
   /** See `DebugAdapter.events`'s doc comment for `sinceSeq`'s contract
    *  (run-4 friction #5) — `snapshot`'s `events` member is filtered the exact
    *  same way, just batched with `time`/`state`/`pageErrors` into one
    *  synchronous read. */
-  snapshot(sinceSeq?: number): VgaiDebugSnapshot;
+  snapshot(sinceSeq?: number): VolterDebugSnapshot;
   /**
    * D15/T-D15.4 door (a): synchronously drive `n` fixed gameplay ticks via the
    * live `Game`'s `GameInternal.runTicks` (`runtime/game.ts`) — reached through
@@ -148,7 +148,7 @@ export interface VgaiDebugHandle {
    * (`DebugRegistry.registerWorldSettledProbe`, declared by the game's `debug.settled` entry
    * export) — so a tick never races a scene remount's async commit, and WHICH tick first runs
    * a freshly reloaded world is a function of the sim rather than wall timing. Session tick
-   * drivers (`@vgai/live`'s fastForward) prefer this door; with no probe registered it behaves
+   * drivers (`@volter/live`'s fastForward) prefer this door; with no probe registered it behaves
    * exactly like {@link runTicks}. Bounded: throws `WORLD_UNSETTLED_TIMEOUT` if a probe never
    * settles.
    */
@@ -159,7 +159,7 @@ export interface VgaiDebugHandle {
    * this is the honest human-input-path proof) → `input.clearVirtualActions()`
    * into ONE async bridge call, as a TOP-LEVEL method (not under `input`)
    * because it needs the sim clock, not just the input target. Was 15+
-   * transport round trips over the editor relay (`@vgai/live`'s old
+   * transport round trips over the editor relay (`@volter/live`'s old
    * `GameInput.hold`: set → a 150ms-interval `waitSimTime` snapshot poll loop
    * → clear); now one `page.evaluate`/relay call that runs the wait
    * in-process on the page.
@@ -185,7 +185,7 @@ export interface VgaiDebugHandle {
   /**
    * Defect 5 fix — undo everything THIS install did: remove the
    * `error`/`unhandledrejection` window listeners it added, and delete
-   * `window.__vgai` so the registry is no longer reachable from the page.
+   * `window.__volter` so the registry is no longer reachable from the page.
    * Idempotent (a second call is a harmless no-op). `mountManifestRoots`
    * wires this into its session's `stop()`; a caller mounting more
    * directly (a hand-rolled host) should call it on its own teardown path.
@@ -218,7 +218,7 @@ export interface MaybeInstallDebugBridgeOptions {
    *  its `getVirtualInputTarget()` backs `input.*`. */
   readonly registry: DebugRegistry;
   readonly manifest: DebugBridgeManifest;
-  /** Where to read `?vgai-debug=1` from. Defaults to `window.location` when a
+  /** Where to read `?volter-debug=1` from. Defaults to `window.location` when a
    *  real `window` exists; a headless caller with no `window` at all (and no
    *  override) gets no bridge — there's nowhere to read a URL from. */
   readonly url?: { readonly search: string } | undefined;
@@ -231,13 +231,13 @@ export interface MaybeInstallDebugBridgeOptions {
 const PAGE_ERROR_CAP = 100;
 
 /** `holdFor`'s in-process poll interval — this loop never leaves the page
- *  (no transport round trip per poll, unlike `@vgai/live`'s old
+ *  (no transport round trip per poll, unlike `@volter/live`'s old
  *  `waitSimTime`), so it can afford to be tighter than that loop's 150ms. */
 const HOLD_FOR_POLL_MS = 50;
 
 /** Consecutive `HOLD_FOR_POLL_MS` polls with the tick unchanged before
  *  `holdFor` gives up waiting and treats the game as stopped — mirrors
- *  `@vgai/live`'s `WAIT_FOR_STALL_POLL_LIMIT` reasoning (`wait-for.ts`:
+ *  `@volter/live`'s `WAIT_FOR_STALL_POLL_LIMIT` reasoning (`wait-for.ts`:
  *  a genuinely frozen sim clock must never poll forever), scaled to this
  *  faster in-process interval so the wall-clock grace period (~5s) lands in
  *  the same neighborhood. */
@@ -266,7 +266,7 @@ const STARVED_DRIVE_MAX_BATCHES = 2000;
  *  string. */
 export const HOLD_STARVED_NO_DRIVER_REASON =
   "the host loop reported liveness 'loop-starved' and this session has no way to drive " +
-  'ticks — no recent rAF progress was observed. Check `vgai status` for the separate ' +
+  'ticks — no recent rAF progress was observed. Check `volter-game-editor status` for the separate ' +
   'visibility readings; foreground/reload the editor, or start play to wire the run-ticks ' +
   'target, then retry.';
 
@@ -394,7 +394,7 @@ function buildDebugHandle(opts: {
   registry: DebugRegistry;
   manifest: DebugBridgeManifest;
   window: DebugBridgeWindowTarget;
-}): VgaiDebugHandle {
+}): VolterDebugHandle {
   const { registry, manifest } = opts;
   const adapter = registry.adapter;
 
@@ -474,7 +474,7 @@ function buildDebugHandle(opts: {
         requireInputTarget('injectPointerPosition', worldId).injectPointerPosition(sourceId, value),
     },
     snapshot(sinceSeq) {
-      // One synchronous pass — see VgaiDebugSnapshot's doc comment.
+      // One synchronous pass — see VolterDebugSnapshot's doc comment.
       return {
         time: adapter.state('time') as {
           simSeconds: number;
@@ -528,13 +528,13 @@ function buildDebugHandle(opts: {
     uninstall() {
       opts.window.removeEventListener?.('error', onWindowError);
       opts.window.removeEventListener?.('unhandledrejection', onWindowRejection);
-      delete opts.window['__vgai'];
+      delete opts.window['__volter'];
     },
   };
 }
 
 /**
- * Install `window.__vgai` iff the page opted in (`?vgai-debug=1`) AND D18's
+ * Install `window.__volter` iff the page opted in (`?volter-debug=1`) AND D18's
  * gate passes (dev build, or manifest `debug.allowInProduction`). When the
  * param is present but the gate fails, warns once (this single call IS the
  * "once" — there is exactly one install attempt per boot) and installs
@@ -543,7 +543,7 @@ function buildDebugHandle(opts: {
  */
 export function maybeInstallDebugBridge(
   opts: MaybeInstallDebugBridgeOptions,
-): VgaiDebugHandle | undefined {
+): VolterDebugHandle | undefined {
   const url = opts.url ?? (hasRealWindow() ? window.location : undefined);
   if (!url) return undefined;
   if (!isDebugModeRequested(url)) return undefined;
@@ -555,7 +555,7 @@ export function maybeInstallDebugBridge(
   if (!isDebugAllowed(opts.manifest)) {
     // biome-ignore lint/suspicious/noConsole: structured, greppable D18 signal — mirrors debug-registry.ts's own console.warn idiom.
     console.warn(
-      '[debug] ?vgai-debug=1 ignored: production build without debug.allowInProduction (D18)',
+      '[debug] ?volter-debug=1 ignored: production build without debug.allowInProduction (D18)',
     );
     return undefined;
   }
@@ -565,6 +565,6 @@ export function maybeInstallDebugBridge(
     manifest: opts.manifest,
     window: windowTarget,
   });
-  windowTarget['__vgai'] = handle;
+  windowTarget['__volter'] = handle;
   return handle;
 }