@volter/editor-game 0.5.68 → 0.5.69

package/src/play/play-mode.ts

@@ -113,6 +113,7 @@ import {
   nodeKeyedPhysics,
   type TransformProvider,
 } from '@volter/editor-project/adapter';
+import { physicsOwnerOf } from '@volter/editor-project/adapter';
 import { assertNever } from '@volter/editor-project/adapter/adapter-surface';
 import { declaredRoots, rootById } from '@volter/editor-project/adapter/manifest-interpreter';
 import { readOidSourceAnchors } from '../three/authoring/oid-source-persistence';
@@ -151,7 +152,7 @@ export interface PlayModeContext {
  *
  * ITS IDENTITY IS THE MOUNT ID, and there is only ever one id for it.
  * `resolveAllRootEntries` opens a mount epoch; every project module of this
- * instance is served under it as `?vgai-mount=<id>`; browser module identity
+ * instance is served under it as `?volter-mount=<id>`; browser module identity
  * is per-url, so that id IS the module-graph boundary; and `gated-globals.ts`
  * resolves this instance's realm and input gate by reading the same id back
  * off the url. Registering it under any second name would be two identities
@@ -164,7 +165,7 @@ export interface PlayModeContext {
  * interleaved log streams and read, later, as a game bug.
  */
 interface PlayInstance {
-  /** The mount id — see above. What `?vgai-mount=` carries, what the realm and
+  /** The mount id — see above. What `?volter-mount=` carries, what the realm and
    *  input gate are keyed by, what `setActiveSystems` registers under and what
    *  the session wire addresses. Empty until a composition has resolved. */
   /** The element this instance mounted into (the primary's is the live
@@ -364,8 +365,8 @@ export function markRestartRequired(reason: string): void {
  *
  * They are kept because the unresolved-console ledger names conditions BY
  * THEIR TEXT, and a remount is the event that resolves them: measured
- * 2026-08-29, `vgai restart` reported "↻ Restarted — session ready" while its
- * own named warning stayed in `vgai console` forever, because the ledger's
+ * 2026-08-29, `volter-game-editor restart` reported "↻ Restarted — session ready" while its
+ * own named warning stayed in `volter-game-editor console` forever, because the ledger's
  * automatic clearing rule is a PAGE LOAD and a remount is not one — only
  * `game.reloadPage()` could silence a warning the named verb had already
  * fixed. `clearRestartRequired` now reports them resolved (ledger clearing
@@ -427,7 +428,7 @@ let _playEpoch = 0;
 //
 // PD-1: this used to be nulled by `exitPlayMode()`, which meant the errors of
 // a run that FAILED became invisible the instant the failed run rolled back —
-// `vgai status` reported `pageErrors: []` for a play that had just thrown, the
+// `volter-game-editor status` reported `pageErrors: []` for a play that had just thrown, the
 // exact "every diagnostic says healthy" symptom. The fence's job is to exclude
 // a PREVIOUS run's noise, and the next `enterPlayMode` re-stamping it does
 // that; dropping it on exit only ever hid the evidence of the last run.
@@ -437,7 +438,7 @@ let _playStartedAtMs: number | null = null;
 //
 // Why an end and not just a start: with an open-ended window every editor error
 // logged AFTER a run stopped still counted as "during the play run", so it fell
-// into the play-fenced `consoleErrors` facet — which `vgai status` renders only
+// into the play-fenced `consoleErrors` facet — which `volter-game-editor status` renders only
 // while play is live. One play run, and every later editor-frame error went
 // invisible again, which is the exact defect the session-lifetime facets exist
 // to close. Stamped at the END of `exitPlayMode`, so a FAILED run's errors (all
@@ -795,14 +796,14 @@ async function installPlayRootAuthoring(
   store.shell.notifyIngestEdit();
 
   // Dev/e2e diagnostic handle — the SAME pattern `ingest/mount-ingest-root.ts`'s
-  // `window.__vgaiIngest`/`window.__vgaiIngest2D` use:
+  // `window.__volterIngest`/`window.__volterIngest2D` use:
   // `store.saveNow()` (Ctrl/Cmd+S) and `_autoSave()` are both structurally
   // guarded OFF while ANY authoring override is active (`hasAuthoringOverride()`
   // / the play-state check) — the adapter's OWN `persistence.save()` is the
   // only way an override session's edits reach disk, so tests/tooling need a
   // handle to call it directly, exactly as the ingest sessions expose.
   if (import.meta.env.DEV) {
-    (window as unknown as Record<string, unknown>)['__vgaiMultiRoot'] = {
+    (window as unknown as Record<string, unknown>)['__volterMultiRoot'] = {
       adapter: composite,
       worldIds: children.map((c) => c.worldId),
       store,
@@ -838,7 +839,7 @@ function exitPlayRootAuthoring(store: EditorShellStore): void {
     _instance.journalSession = '';
   }
   if (import.meta.env.DEV) {
-    delete (window as unknown as Record<string, unknown>)['__vgaiMultiRoot'];
+    delete (window as unknown as Record<string, unknown>)['__volterMultiRoot'];
   }
 }
 /**
@@ -923,7 +924,7 @@ if (import.meta.hot) import.meta.hot.dispose(stopAssetReload);
 
 // --- Script HMR ---
 if (import.meta.hot) {
-  import.meta.hot.on('vgai:restart-required', (data: { file: string }) => {
+  import.meta.hot.on('volter:restart-required', (data: { file: string }) => {
     if (!_instance.session) return;
     const file = data.file.split('/').pop() ?? data.file;
     markRestartRequired(`${file} changed and cannot be applied safely while the game is running.`);
@@ -937,12 +938,12 @@ if (import.meta.hot) {
   // PlayBar's Restart button lights up (variant 'primary') carrying this
   // reason, and ONE click remounts every root from fresh source and
   // re-enters play (`enterPlayMode` re-imports the entry with a
-  // cache-busting query — see `loadProjectScripts`). `vgai status` reports
+  // cache-busting query — see `loadProjectScripts`). `volter-game-editor status` reports
   // the same pending-restart state via `collectState().restartRequired`, so
   // agents get the signal humans get. EDIT-mode behavior is unchanged
   // (`_instance.session` is null there; absorb-by-remount stays as landed — see
   // r3f-design-session.ts).
-  import.meta.hot.on('vgai:r3f-entry-update', (data: { file: string }) => {
+  import.meta.hot.on('volter:r3f-entry-update', (data: { file: string }) => {
     if (!_instance.session) return;
     const file = data.file.split('/').pop() ?? data.file;
     markRestartRequired(
@@ -950,7 +951,7 @@ if (import.meta.hot) {
     );
     warnRestartRequired(`Restart required: ${file} changed while playing.`);
   });
-  import.meta.hot.on('vgai:script-update', async (data: { file: string }) => {
+  import.meta.hot.on('volter:script-update', async (data: { file: string }) => {
     // Project-tool source belongs to editor chrome. The tool contribution
     // store re-imports and remounts it; no game root can become stale from an
     // editor-only document changing.
@@ -1010,7 +1011,7 @@ export function bindPlayMode(store: EditorShellStore): void {
   _ctx = { store, gameContainer: null! }; // set dynamically from the live document's container
   // THE BARE-KEY YIELD IS THE FRAME'S. While Play runs the game's keys are the
   // game's, and what decides is the workbench: our stage actions carry a
-  // `when` clause over `vgai.stage.focused`/`vgai.play`, so a bare key reaches
+  // `when` clause over `volter.stage.focused`/`volter.play`, so a bare key reaches
   // the game rather than a shell binding, and a ⌘-chord stays the workbench's.
   // The realm gate tracks the same predicate independently (`gated-globals.ts`
   // and `surface-keyboard.ts`), which is what keeps a game's raw
@@ -1031,7 +1032,7 @@ export function isPlayModeActive(): boolean {
  * Narrow relay accessor — the live play session's virtual input targets
  * and the Game root's loop, for `command-listener.ts`'s
  * `inject-input`/`set-time-scale`/`set-seed` cases. This is exactly the
- * accessor the vgai-sdk honest-gap jsdocs prescribed
+ * accessor the volter-sdk honest-gap jsdocs prescribed
  * (`play/input-operations.ts`, `play/control-operations.ts`): `_instance.session` is
  * module-private, so the relay needs this one exported read. Everything else
  * the relay reads (state providers, debug commands) flows through
@@ -1040,7 +1041,7 @@ export function isPlayModeActive(): boolean {
  * `getInputTarget(worldId?)` (D15/T-D15.5 — review objection 2's fix)
  * is one resolution for every input door: both the SAME `getDebugRegistry(game).getVirtualInputTarget(worldId)`
  * — one resolution function (`debug-registry.ts`'s `resolveInputRootId`),
- * so `inject-input` (this accessor) and `window.__vgai.input.*`
+ * so `inject-input` (this accessor) and `window.__volter.input.*`
  * (`debug-bridge.ts`) can never disagree about which world an unqualified
  * actuation targets again. `null` when nothing is registered for the
  * resolved id (or no `Game` is running at all); throws the registry's own
@@ -1048,7 +1049,7 @@ export function isPlayModeActive(): boolean {
  *
  * `runTicks` (D15/T-D15.4) is added the SAME way: reached via
  * `getDebugRegistry(game).getRunTicksTarget()` — the identical accessor
- * `runtime/debug-bridge.ts`'s `window.__vgai.runTicks` (door a) goes
+ * `runtime/debug-bridge.ts`'s `window.__volter.runTicks` (door a) goes
  * through, so the editor relay's `run-ticks` case (door b, → `play.runTicks`)
  * calls byte-identical behavior (D17). `null` only when no `Game` is running
  * at all (`_instance.session` is `null`) — a live `Game` always wires a run-ticks
@@ -1285,7 +1286,7 @@ export function resizeGame(width: number, height: number, pixelRatio?: number):
 
 /**
  * Serializes every `enterPlayMode()` invocation (the ghost-runtime bug:
- * `vgai play` on an already-playing/still-booting session left the
+ * `volter-game-editor play` on an already-playing/still-booting session left the
  * PREVIOUS runtime alive, ticking and rendering alongside the new one).
  *
  * Root cause: `enterPlayModeInner`'s own `if (_instance.session) exitPlayMode()`
@@ -1305,7 +1306,7 @@ export function resizeGame(width: number, height: number, pixelRatio?: number):
  * size exceeded` — not a hypothetical). In the field this window is entered
  * whenever a caller re-issues `play` before the browser has acked the first
  * (a slow scene boot outliving the relay's/SDK's own `play.start` timeout is
- * the documented trigger — `packages/vgai-sdk/src/play/transport.ts`'s
+ * the documented trigger — `packages/volter-sdk/src/play/transport.ts`'s
  * `PLAY_START_TIMEOUT_MS`/`editor-server.ts`'s `PLAY_COMMAND_TIMEOUT_MS` —
  * and `play.start`'s own contract is explicitly "start (or restart)", so a
  * caller retrying after a timeout is using the API as documented, not
@@ -1403,16 +1404,16 @@ async function startAutoLaunchedAdapterPlay(store: EditorShellStore): Promise<bo
 /**
  * Enter play mode: create a game canvas, start game, disable editor controls.
  *
- * `explicitSeed` (D15/T-D15.6, objection-4 fix — `vgai play --seed <n>`)
+ * `explicitSeed` (D15/T-D15.6, objection-4 fix — `volter-game-editor play --seed <n>`)
  * — the CLI's `play` command relays it through as `cmd['seed']`
  * (`command-listener.ts`'s `'play'` case); it is the "explicit config"
  * leg of `resolveDeterminismSeed`'s precedence (highest — beats
- * `manifest.determinism.defaultSeed`/`?vgai-seed=` on the editor's own
+ * `manifest.determinism.defaultSeed`/`?volter-seed=` on the editor's own
  * page URL), threaded into whichever mount path this play resolves to
  * below, exactly like `mountManifestRoots`'s own `opts.seed` already is
  * for a standalone boot.
  *
- * `runName` (optional — `vgai play --name <text>`) is FINDABILITY and nothing
+ * `runName` (optional — `volter-game-editor play --name <text>`) is FINDABILITY and nothing
  * else: the server slugifies it into this run's `logs/play-*.jsonl` filename
  * and its session-journal line, so "the run where I tested the boss fight" is
  * a grep instead of timestamp archaeology. No registry, no uniqueness check —
@@ -1469,7 +1470,7 @@ async function enterPlayModeInner(
   // `enterPlayMode` owns the begin/end pair; this function owns the marks.
   // Play must never start while the boot-time project bootstrap is still in
   // flight. Resolves immediately when no bootstrap is pending; gating HERE
-  // rather than in the Play button covers every caller — UI, `vgai play` relay,
+  // rather than in the Play button covers every caller — UI, `volter-game-editor play` relay,
   // SDK.
   markPlayBootPhase('waiting for the project bootstrap to settle');
   await projectBootstrapSettled();
@@ -1712,9 +1713,9 @@ async function enterPlayModeInner(
       entries,
       width: rw,
       height: rh,
-      // D15/T-D15.6 — `vgai play --seed`'s explicit config leg; `undefined`
+      // D15/T-D15.6 — `volter-game-editor play --seed`'s explicit config leg; `undefined`
       // (the overwhelmingly common case) leaves `mountManifestRoots`'s own
-      // manifest/`?vgai-seed=` precedence untouched.
+      // manifest/`?volter-seed=` precedence untouched.
       seed: explicitSeed,
       playtest,
     });
@@ -1733,7 +1734,7 @@ async function enterPlayModeInner(
     // PD-3 — close the window and report LOUDLY. A split does not stop the
     // game (both copies run; they just disagree), so this is an error-level
     // report rather than a throw: the failure mode being fixed is SILENCE,
-    // not a crash. `collectState` carries the same reports to `vgai status`,
+    // not a crash. `collectState` carries the same reports to `volter-game-editor status`,
     // and `editorConsole.error` reaches the editor console panel and the
     // play-log sink the CLI reads back.
     for (const split of endProjectModuleSplitWatch(project.rootPath)) {
@@ -1744,7 +1745,7 @@ async function enterPlayModeInner(
     // mount, and `mountManifestRoots` resolving IS that answer — including the
     // roots' own async setup, which it awaits. So every one of these roots
     // reports `declared`, and no measured wait stands anywhere behind them
-    // (`readiness.ts`; published as `vgai status`'s `readiness` facet).
+    // (`readiness.ts`; published as `volter-game-editor status`'s `readiness` facet).
     for (const rootId of _hostMountedReadyRootIds) {
       recordRootReadiness({ rootId, mechanism: 'host-mount', source: 'declared', state: 'ready' });
     }
@@ -1861,7 +1862,7 @@ async function enterPlayModeInner(
     store.setEcsSyncTransform((id, obj) => {
       // `commit` refuses an id this adapter cannot resolve rather than
       // returning as if the write landed — so ask before driving it.
-      if (!physics || physics.ownerOf(id) === 'unresolved') return;
+      if (!physics || physicsOwnerOf(physics, id) === 'unresolved') return;
       physics.commit(id, {
         position: obj.position.toArray() as [number, number, number],
         rotation: obj.quaternion.toArray() as [number, number, number, number],
@@ -1928,7 +1929,7 @@ async function enterPlayModeInner(
  * cardinality half of multiplayer authoring (see the `_additional` doc).
  *
  * Valid only while the primary is playing. The returned id is the instance's
- * mount id (what `?vgai-mount=` carries and what `game.instance(id)`
+ * mount id (what `?volter-mount=` carries and what `game.instance(id)`
  * addresses). This does the INSTANCE subset of `enterPlayModeInner` and none
  * of its session/focus work: it resolves its own mount epoch, mounts the roots
  * into `container`, registers a performance source and its System adapters
@@ -2483,7 +2484,7 @@ editorHost().live.register({
 });
 
 // What only Play knows of the state report (`host.session.reportFacet`):
-// `vgai status --json` spreads these beside the host's own fields.
+// `volter-game-editor status --json` spreads these beside the host's own fields.
 editorHost().session.reportFacet(() => ({
   // The live loop's time-scale, so `play.status` reports the real applied
   // value after a `set-time-scale` instead of an honest-gap null.

package/src/play/play-recording.ts

@@ -2,15 +2,15 @@
  * EVERY RELAYED PLAY RECORDS, AND AN IDLE RUN STOPS ITSELF.
  *
  * The defect this closes is not a missing feature — the recorder
- * (`gameplay-recording.ts`) already existed, behind `vgai eval
+ * (`gameplay-recording.ts`) already existed, behind `volter-game-editor eval
  * 'editor.recording.start()'`. The defect is that verifying a game through a
  * single screenshot answers a temporal question by luck, and a capability an
  * agent has to remember to switch on is one it does not use. So there is no
- * flag: `vgai play` starts a recording, full stop, and the evidence exists
+ * flag: `volter-game-editor play` starts a recording, full stop, and the evidence exists
  * whether or not anyone thought to ask for it.
  *
  * WHY THE RELAYED PLAY AND NOT THE PLAY BUTTON. The binding is in
- * `play.command.ts`'s `'play'` handler, so it covers `vgai play`, the SDK's
+ * `play.command.ts`'s `'play'` handler, so it covers `volter-game-editor play`, the SDK's
  * `play.start`, and nothing else. Clicking Play in the editor is a HUMAN at
  * the surface: they are the witness, the idle rule below ("no session
  * commands and no player input") is meaningless for them, and auto-stopping
@@ -21,11 +21,11 @@
  * script threw — leaves a growing file that nobody can open. The idle window
  * is what converts an abandoned run into finished evidence.
  *
- * WHAT RECORDING DOES *NOT* DO: gate the still (2026-08-29). `vgai screenshot`
+ * WHAT RECORDING DOES *NOT* DO: gate the still (2026-08-29). `volter-game-editor screenshot`
  * used to REFUSE while a recording was live, on the argument that a single
  * frame answers a temporal question by luck. The argument is right and the
- * refusal was still the defect: because play always records, one `vgai play`
- * killed `vgai screenshot` for the rest of the session — and "what does it
+ * refusal was still the defect: because play always records, one `volter-game-editor play`
+ * killed `volter-game-editor screenshot` for the rest of the session — and "what does it
  * look like" is a question a still answers exactly, and the one the whole
  * look/modeling lane asks (measured, cold fox #3: the loop is play → look).
  * Discouraging a wrong question by making a right one impossible is not a
@@ -56,7 +56,7 @@ import type { AudioRecordingHandle } from '@volter/editor-project/adapter';
  *
  * ONE constant, editor-side, and deliberately generous: the thing it must
  * never do is cut a run that someone is still working with. Two minutes is
- * longer than any gap between an agent's own commands (`vgai eval` round
+ * longer than any gap between an agent's own commands (`volter-game-editor eval` round
  * trips are seconds) and longer than a human's pause at the keyboard, while
  * still being short enough that an abandoned run becomes a readable file
  * inside the same working session rather than the next day.
@@ -100,7 +100,7 @@ let live: LivePlayRecording | null = null;
  * The recorder's own "already active" guard is released at the END of
  * `stopGameplayRecording` (it awaits the in-flight frame, the recorder's stop
  * event, and the chunk uploads). `live` is cleared at the START. So a restart —
- * `vgai play` over a running play, which tears down through `exitPlayMode`'s
+ * `volter-game-editor play` over a running play, which tears down through `exitPlayMode`'s
  * fire-and-forget teardown and then starts the next recording — would look
  * finished to this module while the recorder was still busy, and the next start
  * would refuse. This handle is what a start waits on; without it the second
@@ -169,7 +169,7 @@ export function lastPlayRecording(): GameplayRecordingCapture | null {
  * Two callers, and the pair is the whole definition of "idle": every relayed
  * session command (`host.session.onCommandDispatched`, subscribed below) and
  * every player input event (the listeners installed below). A run is idle only
- * when BOTH have gone quiet — an agent driving through `vgai eval` and a human
+ * when BOTH have gone quiet — an agent driving through `volter-game-editor eval` and a human
  * holding a movement key are each, alone, enough to keep it alive.
  */
 export function notePlayActivity(): void {
@@ -194,7 +194,7 @@ function installInputListeners(): () => void {
  *
  * Never throws: a browser that cannot record must not be a browser that cannot
  * PLAY. The failure is reported to the editor console (which is what
- * `vgai console` and every command's trailing console summary read) and play
+ * `volter-game-editor console` and every command's trailing console summary read) and play
  * continues with no clip, rather than an ack that refuses a working game
  * because its evidence path is unavailable.
  */
@@ -291,7 +291,7 @@ export async function endPlayRecording(
   return stop;
 }
 
-/** One sentence, used by both the auto-stop note and the `vgai screenshot`
+/** One sentence, used by both the auto-stop note and the `volter-game-editor screenshot`
  *  refusal, so the two doors cannot describe the same clip differently. */
 export function describeCapture(capture: GameplayRecordingCapture): string {
   const seconds = Math.round(capture.durationMs / 100) / 10;
@@ -329,7 +329,7 @@ async function autoStopIdlePlay(): Promise<void> {
 
 // HALF OF "IS THIS RUN IDLE" — the other half is player input, watched
 // above. Every relayed command counts: an agent that is still driving a game
-// through `vgai eval` is not idle, whatever the command was, and a stamp
+// through `volter-game-editor eval` is not idle, whatever the command was, and a stamp
 // filed per verb would quietly exclude whichever verb someone forgot.
 // No-op unless a recording is live.
 editorHost().session.onCommandDispatched(() => notePlayActivity());

package/src/play-bar/PlayBar.tsx

@@ -67,7 +67,7 @@ function SaveRegimeIndicator({ regime }: { regime: 'ephemeral' | null }) {
     <span
       role="img"
       aria-label={label}
-      className="vgai-play-edit-regime"
+      className="volter-play-edit-regime"
       data-testid="play-edit-regime"
       data-regime={regime}
       title={label}
@@ -141,7 +141,7 @@ export function PlayBarView({
     <Inline
       role="toolbar"
       aria-label="Game transport"
-      className="vgai-playbar"
+      className="volter-playbar"
       gap={2}
       align="center"
     >
@@ -231,7 +231,7 @@ export function PlayBar({ placement = 'launcher' }: { placement?: 'launcher' | '
       <Inline
         role="toolbar"
         aria-label="Game transport"
-        className="vgai-playbar"
+        className="volter-playbar"
         gap={2}
         align="center"
       >
@@ -336,7 +336,7 @@ function PlayOptions() {
   const { settings } = editorHost();
   const keepPanelsVisible = useSyncExternalStore(
     settings.subscribe,
-    () => settings.get('vgai.play.keepPanelsVisible') === true,
+    () => settings.get('volter.play.keepPanelsVisible') === true,
   );
   const [open, setOpen] = useState(false);
   const anchor = useRef<HTMLButtonElement>(null);
@@ -358,7 +358,7 @@ function PlayOptions() {
             role="menuitemcheckbox"
             aria-checked={keepPanelsVisible}
             onSelect={() => {
-              settings.set('vgai.play.keepPanelsVisible', !keepPanelsVisible);
+              settings.set('volter.play.keepPanelsVisible', !keepPanelsVisible);
               setOpen(false);
             }}
           >
@@ -420,14 +420,14 @@ function RunPicker({ run, disabled }: { readonly run: RunState; readonly disable
   const selected = run.configurations.find((c) => c.id === run.selectedId);
   const label = selected?.id === PLAY_ID ? 'Play' : (selected?.id ?? 'Play');
   return (
-    <div className="vgai-playbar-popover-anchor">
+    <div className="volter-playbar-popover-anchor">
       <Button
         ref={ref}
         variant="ghost"
         size="compact"
         aria-haspopup="menu"
         aria-expanded={open}
-        aria-controls={open ? 'vgai-run-configuration-menu' : undefined}
+        aria-controls={open ? 'volter-run-configuration-menu' : undefined}
         data-testid="run-configuration-picker"
         disabled={disabled}
         onClick={() => setOpen((value) => !value)}
@@ -438,7 +438,7 @@ function RunPicker({ run, disabled }: { readonly run: RunState; readonly disable
       </Button>
       {open && (
         <AnchoredMenu
-          id="vgai-run-configuration-menu"
+          id="volter-run-configuration-menu"
           anchorRef={ref}
           align="start"
           gap={4}

package/src/play-bar/PlayerCountPicker.tsx

@@ -55,14 +55,14 @@ export function InstanceCountPicker() {
 
   const count = playerCountFromExtras(extra);
   return (
-    <div className="vgai-playbar-popover-anchor">
+    <div className="volter-playbar-popover-anchor">
       <Button
         ref={ref}
         variant="ghost"
         size="comfortable"
         aria-haspopup="menu"
         aria-expanded={open}
-        aria-controls={open ? 'vgai-player-count-menu' : undefined}
+        aria-controls={open ? 'volter-player-count-menu' : undefined}
         onClick={() => setOpen((value) => !value)}
         title={`${instanceLabel(count)} — choose how many runtimes Play mounts side by side`}
       >
@@ -73,7 +73,7 @@ export function InstanceCountPicker() {
       </Button>
       {open && (
         <AnchoredMenu
-          id="vgai-player-count-menu"
+          id="volter-player-count-menu"
           anchorRef={ref}
           gap={4}
           onDismiss={() => setOpen(false)}

package/src/profiler/FrameDebuggerPanel.tsx

@@ -69,7 +69,7 @@ function DrawRow({
       data-testid="frame-draw-row"
       data-draw-index={draw.index}
       data-selected={selected || undefined}
-      className="vgai-frame-draw-row"
+      className="volter-frame-draw-row"
       onClick={onSelect}
     >
       <span style={{ ...MONO, color: themeVars.content.dim, width: 34, display: 'inline-block' }}>
@@ -381,7 +381,7 @@ export function FrameDebuggerPanel() {
       data-testid="frame-debugger"
       // §2.31 P2 amendment: text-dense output region reads over a local
       // frosted layer (inert for non-frost themes).
-      className="vgai-content-frost"
+      className="volter-content-frost"
       style={{ flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column', fontSize: 12 }}
     >
       {/* Header: capture control + honest scope statement + history strip */}

package/src/profiler/PerformancePanel.tsx

@@ -68,7 +68,7 @@ function downloadCapture(profiler: PerformanceProfiler): void {
   const url = URL.createObjectURL(new Blob([profiler.exportJSON()], { type: 'application/json' }));
   const anchor = document.createElement('a');
   anchor.href = url;
-  anchor.download = `vgai-performance-${new Date().toISOString().replaceAll(':', '-')}.json`;
+  anchor.download = `volter-performance-${new Date().toISOString().replaceAll(':', '-')}.json`;
   anchor.click();
   URL.revokeObjectURL(url);
 }
@@ -84,7 +84,7 @@ function downloadTrace(profiler: PerformanceProfiler, processName: string): void
   const url = URL.createObjectURL(new Blob([JSON.stringify(trace)], { type: 'application/json' }));
   const anchor = document.createElement('a');
   anchor.href = url;
-  anchor.download = `vgai-trace-${new Date().toISOString().replaceAll(':', '-')}.json`;
+  anchor.download = `volter-trace-${new Date().toISOString().replaceAll(':', '-')}.json`;
   anchor.click();
   URL.revokeObjectURL(url);
 }
@@ -874,7 +874,7 @@ export function PerformancePanel() {
 
   return (
     <div
-      className="vgai-content-frost"
+      className="volter-content-frost"
       style={{
         height: '100%',
         overflow: 'auto',
@@ -937,7 +937,7 @@ export function PerformancePanel() {
         <Button
           size="compact"
           data-testid="profiler-export-trace"
-          onClick={() => downloadTrace(profiler, source?.label ?? 'vgai')}
+          onClick={() => downloadTrace(profiler, source?.label ?? 'volter')}
         >
           Export Chrome trace
         </Button>

package/src/react/design-time-react-mount.ts

@@ -146,7 +146,7 @@ async function seedRootViewportFromManifest(): Promise<void> {
   const current = getRootCanvasViewport();
   if (current.width !== null || current.height !== null) return;
   try {
-    const text = await readProjectTextFile('vgai.project.json');
+    const text = await readProjectTextFile('volter.project.json');
     if (!text) return;
     const manifest = JSON.parse(text) as {
       resolution?: { width?: unknown; height?: unknown };
@@ -282,7 +282,7 @@ export async function mountReactDesignLayer(
   // The join is by component NAME, not function identity, and that is
   // measured rather than assumed: a story module is imported at its own
   // `/@fs/<path>?t=<now>` url (`story-discovery.ts`) while a root entry is
-  // imported at the mount epoch's `?vgai-mount=<n>` url
+  // imported at the mount epoch's `?volter-mount=<n>` url
   // (`project-module-url.ts`), and browser ES-module identity is per-url — so
   // the component object a story's meta holds is never the object the entry
   // loader returns. `pickComponentPreviewStory` (`story-registry.ts`) is the
@@ -328,7 +328,7 @@ export async function mountReactDesignLayer(
     // names an action that cannot be taken. Opening on the first story is that
     // board's documented behaviour, not a degraded one. Measured on the
     // repo-vendored `racing-game` ingest, whose manifest declares one ingest
-    // root and no dom root: a permanent unresolvable warning on every `vgai`
+    // root and no dom root: a permanent unresolvable warning on every `volter`
     // command, for a board that was working exactly as designed.
     if (candidate.path && !defaultPortableStory) {
       editorConsole.warn(
@@ -512,8 +512,8 @@ export async function mountReactDesignLayer(
       designTokens: () => {
         const content = board.activeContent();
         const scopeElement =
-          content.closest?.('[data-vgai-game-styles]') ??
-          content.querySelector?.('[data-vgai-game-styles]') ??
+          content.closest?.('[data-volter-game-styles]') ??
+          content.querySelector?.('[data-volter-game-styles]') ??
           content;
         return getDesignTokens(
           getComputedStyle(scopeElement) as unknown as Parameters<typeof getDesignTokens>[0],

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

@@ -24,7 +24,7 @@
  *    DIRECTLY and record the same write into an in-memory
  *    {@link DomStyleEdits} document that is never saved anywhere. (Until
  *    2026-08-02 that document was flushed to a per-world JSON sidecar under
- *    the project's `.vgai/`; the owner deleted that system outright — no
+ *    the project's `.volter/`; the owner deleted that system outright — no
  *    compat read, no replacement.) There is NO `SourceWriteBackend` import
  *    anywhere in this file and NO `/__ui-source` traffic of any kind, ever —
  *    this is the one hard invariant the design doc's §4 NOTs pin (AC-K7).
@@ -328,8 +328,8 @@ export class DomAuthoringAdapter implements AuthoringAdapter {
    * root: a fresh snapshot every call (same "the DOM is live and may
    * re-render, never cached" discipline as
    * `hierarchy.roots()`/`hierarchy.node()` above), not a count taken once at
-   * construction. Backs `__vgaiIngestReact.domEvidence().hierarchyNodeCount`
-   * — one of the four legs `vgai doctor`'s react-ingest MOUNTED bar requires
+   * construction. Backs `__volterIngestReact.domEvidence().hierarchyNodeCount`
+   * — one of the four legs the react-ingest MOUNTED bar requires
    * (`clearsReactIngestMountedBar`, `packages/editor/src/doctor/report.ts`).
    */
   nodeCount(): number {

package/src/react/react-inspector-section.tsx

@@ -415,7 +415,7 @@ function GradientRow({ prop, raw, disabled, testId, commit }: KindRowProps): Rea
         <Button
           type="button"
           variant="secondary"
-          className="vgai-field-trigger"
+          className="volter-field-trigger"
           data-testid={testId}
           disabled={disabled}
           onClick={() => commit(prop.path, composeGradient(DEFAULT_GRADIENT))}
@@ -601,7 +601,7 @@ function CheckboxRow({ prop, raw, disabled, testId, commit }: KindRowProps): Rea
       }}
     >
       <Checkbox
-        className="vgai-checkbox"
+        className="volter-checkbox"
         data-testid={testId}
         checked={raw !== false}
         disabled={disabled}