@volter/editor-game 0.5.67 → 0.5.69

package/src/host/components/HeaderTelemetry.tsx

@@ -172,13 +172,13 @@ function AudioTelemetry() {
         : 'Audio quiet';
 
   return (
-    <div className="vgai-header-audio" data-muted={muted || undefined} data-available={!!adapter}>
+    <div className="volter-header-audio" data-muted={muted || undefined} data-available={!!adapter}>
       <Button
         ref={buttonRef}
         type="button"
         variant="ghost"
         size="compact"
-        className="vgai-header-telemetry-button"
+        className="volter-header-telemetry-button"
         data-testid="header-audio-telemetry"
         aria-label={`${stateLabel}; open audio controls`}
         aria-haspopup="menu"
@@ -187,7 +187,7 @@ function AudioTelemetry() {
         onClick={() => setMenuOpen((open) => !open)}
       >
         <EditorIcon icon={muted ? faVolumeXmark : faVolumeHigh} size="sm" />
-        <span className="vgai-audio-vu" aria-hidden="true">
+        <span className="volter-audio-vu" aria-hidden="true">
           {Array.from({ length: AUDIO_METER_SEGMENTS }, (_, index) => (
             <i key={index} data-filled={index < filled || undefined} />
           ))}
@@ -268,7 +268,7 @@ function PerformanceTelemetry() {
       type="button"
       variant="ghost"
       size="compact"
-      className="vgai-header-telemetry-button vgai-header-performance"
+      className="volter-header-telemetry-button volter-header-performance"
       data-testid="header-performance-telemetry"
       data-performance-tone={tone}
       disabled={!source}
@@ -277,24 +277,24 @@ function PerformanceTelemetry() {
       onClick={() => profilerView.open('profiler')}
     >
       <svg
-        className="vgai-performance-graph"
+        className="volter-performance-graph"
         aria-hidden="true"
         viewBox="0 0 72 18"
         width="72"
         height="18"
       >
         <line
-          className="vgai-performance-budget"
+          className="volter-performance-budget"
           x1="0"
           x2="72"
           y1={18 - (FRAME_BUDGET_60_FPS_MS / 50) * 18}
           y2={18 - (FRAME_BUDGET_60_FPS_MS / 50) * 18}
         />
-        {points && <polyline className="vgai-performance-sparkline" points={points} />}
+        {points && <polyline className="volter-performance-sparkline" points={points} />}
       </svg>
-      <span className="vgai-performance-readout">
-        <strong className="vgai-header-fps">{fps ?? '—'} FPS</strong>
-        <span className="vgai-header-frame-ms">{frameMs?.toFixed(1) ?? '—'} ms</span>
+      <span className="volter-performance-readout">
+        <strong className="volter-header-fps">{fps ?? '—'} FPS</strong>
+        <span className="volter-header-frame-ms">{frameMs?.toFixed(1) ?? '—'} ms</span>
       </span>
     </Button>
   );
@@ -322,7 +322,7 @@ export function HeaderTelemetry() {
   if (activeChromeRegions().telemetry === 'hidden') return null;
   return (
     <Inline
-      className="vgai-header-telemetry vgai-chrome-island vgai-glass-island"
+      className="volter-header-telemetry volter-chrome-island volter-glass-island"
       data-island-scale="compact"
       align="center"
       gap={1}

package/src/host/components/PixiIsolationSceneContent.tsx

@@ -184,8 +184,8 @@ export function PixiIsolationSceneContent({
       ref={containerRef}
       data-testid="scene-document-pixi-isolation"
       data-document-id={documentId}
-      data-vgai-backdrop-color={active ? CANVAS_SCENE_BACKGROUND : undefined}
-      data-vgai-backdrop-policy={active ? 'dark-frost' : undefined}
+      data-volter-backdrop-color={active ? CANVAS_SCENE_BACKGROUND : undefined}
+      data-volter-backdrop-policy={active ? 'dark-frost' : undefined}
       onPointerDown={() => setActiveScope('viewport')}
       style={{
         position: 'absolute',
@@ -197,7 +197,7 @@ export function PixiIsolationSceneContent({
       }}
     >
       <CanvasSceneBackdrop view={view} documentId={documentId} />
-      {adapter ? <RootSelectionOverlay adapter={adapter} view={view} transformModeAware /> : null}
+      {adapter ? <RootSelectionOverlay adapter={adapter} view={view} transformModeAware presentationId={documentId} /> : null}
       <CanvasSceneControls
         active={active}
         {...(adapter ? { adapter } : {})}

package/src/host/components/ResolutionPicker.tsx

@@ -42,14 +42,14 @@ export function ResolutionPicker({
   const label = isFill ? 'Fill' : `${resolution.width}×${resolution.height}`;
 
   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-resolution-picker-menu' : undefined}
+        aria-controls={open ? 'volter-resolution-picker-menu' : undefined}
         onClick={() => setOpen((value) => !value)}
         title={title}
       >
@@ -63,9 +63,9 @@ export function ResolutionPicker({
       </Button>
       {open && (
         <AnchoredMenu
-          id="vgai-resolution-picker-menu"
+          id="volter-resolution-picker-menu"
           anchorRef={ref}
-          className="vgai-resolution-menu"
+          className="volter-resolution-menu"
           gap={4}
           onDismiss={() => setOpen(false)}
         >

package/src/host/components/scene-document.tsx

@@ -3,7 +3,7 @@
  * `Scene` (the subject, not its entry file — see SCENE_DOCUMENT_TITLE),
  * closeable and discoverable in Content, content = the world root's stage.
  *
- * Transcribed from the Scene half of vgai's `components/CenterDocuments.tsx`.
+ * Transcribed from the Scene half of volter's `components/CenterDocuments.tsx`.
  * The kit keeps the other half (`@volter/editor-core/components/CenterDocuments`
  * `useCenterDocuments`): it binds the Game document's tab, reports the
  * live/stopped edge and closes every document on session teardown. What moved
@@ -195,7 +195,7 @@ export class ViewportErrorBoundary extends Component<
     editorConsole.error(`Viewport failed to start: ${error.message}`, 'editor');
     // Keep the component stack in the browser console for developer diagnosis.
     // biome-ignore lint/suspicious/noConsole: renderer startup failures need their React component stack in developer tools as well as the user-facing editor Console entry
-    console.error('[vgai] Viewport failed to start', error, info.componentStack);
+    console.error('[volter] Viewport failed to start', error, info.componentStack);
 
     if (isTransientRendererStartupFailure(error) && this.autoRetryCount < MAX_AUTO_RETRIES) {
       this.clearPendingRetry();
@@ -251,7 +251,7 @@ export class ViewportErrorBoundary extends Component<
         </div>
         <Button
           type="button"
-          className="vgai-btn"
+          className="volter-btn"
           data-testid="retry-viewport"
           onClick={this.handleManualRetry}
         >

package/src/host/components/world-root-stage-binding.tsx

@@ -3,7 +3,7 @@
  * (`@volter/editor-threejs/kit/components/world-root-binding`): the world's surface,
  * its stage, and the overlays the stage shows only over a world.
  *
- * `Overlays` is the world-root half of vgai's `stage-overlay-set.tsx` — every
+ * `Overlays` is the world-root half of volter's `stage-overlay-set.tsx` — every
  * part it rendered only when `worldRoot` held (the root selection layer, the
  * camera-authoring pin, the scene's
  * surface-state card). The rest of that overlay set is the kit's

package/src/host/components/world-root-stage.ts

@@ -454,7 +454,7 @@ export function installWorldRootStage(options: WorldRootStageOptions): WorldRoot
   // DEV/e2e hook: lets the per-game feature matrix assert the viewport camera
   // reframes (view presets / focus / orbit) on an ingested scene.
   if (import.meta.env.DEV) {
-    (window as unknown as Record<string, unknown>)['__vgaiViewport'] = viewport;
+    (window as unknown as Record<string, unknown>)['__volterViewport'] = viewport;
   }
 
   // --- Composer rebuild ---

package/src/host/coverage/authoring-read-probe.ts

@@ -510,7 +510,7 @@ function probeDocumentProviders(adapter: AuthoringAdapter, id: string, record: R
     record(
       'editor.assetDrop.accepts',
       'operation',
-      () => adapter.assetDrop?.accepts(id, '__vgai_read_probe__'),
+      () => adapter.assetDrop?.accepts(id, '__volter_read_probe__'),
       (value) => typeof value === 'boolean',
     );
   }

package/src/host/coverage/capability-coverage.ts

@@ -52,7 +52,7 @@ import type {
 } from '@volter/editor-project/adapter';
 import { WRITE_ANCHOR_KINDS } from '@volter/editor-project/adapter';
 import type { AdapterSurface } from '@volter/editor-project/adapter/adapter-surface';
-import type { VgaiGameContract } from '@volter/editor-project/adapter/ingest/game-contract';
+import type { VolterGameContract } from '@volter/editor-project/adapter/ingest/game-contract';
 import type { SystemAdapters } from '@volter/editor-project/adapter/system-adapter';
 import { SYSTEM_ADAPTERS_SHAPE } from '@volter/editor-project/adapter/system-seam-contract';
 import {
@@ -92,7 +92,7 @@ export {
  * gets a row.
  *
  * The rest are contract facts about an ingested game — declarations only a
- * `window.vgaiGame` can make — and they grow with the contract; nothing
+ * `window.volterGame` can make — and they grow with the contract; nothing
  * switches exhaustively on this type, so no consumer breaks when it does.
  */
 export type CapabilityCoverageSeam =
@@ -212,7 +212,7 @@ export interface SystemsPresence {
  * and this file never calls any of them.
  */
 export interface ContractPresence {
-  /** `readGameContract()` answered at all (a v1 `window.vgaiGame`). */
+  /** `readGameContract()` answered at all (a v1 `window.volterGame`). */
   readonly declared: boolean;
   readonly root: boolean;
   readonly start: boolean;
@@ -224,7 +224,7 @@ export interface ContractPresence {
 }
 
 /** Fold a read contract (or its absence) into presence flags. */
-export function measureGameContract(contract: VgaiGameContract | null): ContractPresence {
+export function measureGameContract(contract: VolterGameContract | null): ContractPresence {
   const systems = contract?.systems;
   return {
     declared: contract !== null,
@@ -276,7 +276,7 @@ export interface WriteReachFacts {
    * reads healthy while every one of the 12 belongs to one lane and a whole
    * other lane — a world's physics-placed cargo, or its level-data records —
    * goes unwritten and unexercised. A per-kind tally is what makes an
-   * exhaustive walk possible; `vgai doctor`'s edit-write phase is its reader.
+   * exhaustive walk possible.
    *
    * Optional, because callers older than the vocabulary supply none and a
    * fabricated zero for every kind would read as a measurement.
@@ -307,7 +307,7 @@ export interface DataWriterFacts {
  *    actually holds an adapter for this slot. That is the strongest available
  *    statement: it is the same object the editor's panels will call.
  *  - `empty` — the game POSITIVELY answered "I have no X" through
- *    `window.vgaiGame.systems.systemAdapters` (`evidence` is its own words).
+ *    `window.volterGame.systems.systemAdapters` (`evidence` is its own words).
  *  - `malformed` — a declaration that could not be honoured; `evidence` is the
  *    projection's reason. Reported so a broken shim is loud, never silently
  *    read as either of the two terminal states.
@@ -327,7 +327,7 @@ export interface SystemAdapterMeasurement {
    * shared default would state wrongly.
    *
    * This is what keeps the derivation provenance-NEUTRAL. The default fix text
-   * below names `window.vgaiGame.systems…`, which is true of a game that
+   * below names `window.volterGame.systems…`, which is true of a game that
    * declares a contract and false of a first-party one; rather than have the
    * row builder ask WHO produced the measurement, the measurement carries the
    * answer as a fact (`coverage/system-adapter-coverage.ts` supplies it for a
@@ -474,7 +474,7 @@ type ResolvedCoverageFacts = Required<CapabilityCoverageFacts>;
 
 /**
  * The route for a game whose bytes may not be touched — which is EVERY
- * repo-vendored ingest, by doctrine. "Declare `window.vgaiGame.root`" is the
+ * repo-vendored ingest, by doctrine. "Declare `window.volterGame.root`" is the
  * mechanism, but a game nobody may edit cannot declare anything, so a fix that
  * stopped there would be telling the reader to do something they are not
  * allowed to do. Both host-side carriers now exist, so this names them and
@@ -483,8 +483,8 @@ type ResolvedCoverageFacts = Required<CapabilityCoverageFacts>;
 const UNMODIFIABLE_ROUTE =
   'a game whose bytes must stay unmodified declares it from a host-side carrier ' +
   'instead — a contract shim beside the game (`ingest.contractShim` in its ' +
-  'vgai.project.json, injected ahead of the game`s entry module; see ' +
-  'public/ingest/simcity/vgai.shim.js) or a recorded patch';
+  'volter.project.json, injected ahead of the game`s entry module; see ' +
+  'public/ingest/simcity/volter.shim.js) or a recorded patch';
 
 const CONTRACT_FIX = (endpoint: string): string =>
   `declare ${endpoint} in the game's own entry; ${UNMODIFIABLE_ROUTE}`;
@@ -656,7 +656,7 @@ function loopRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
       missing:
         "nothing in this editor controls the game's frames: ▶/⏸ and Step do not stop it, and " +
         'Edit mode cannot be quiet — it keeps simulating while you author',
-      fix: CONTRACT_FIX('window.vgaiGame.lifecycle.pause + resume'),
+      fix: CONTRACT_FIX('window.volterGame.lifecycle.pause + resume'),
     };
   }
   // No verdict, and that is its own answer — never a gap. The caller supplies
@@ -681,7 +681,7 @@ function contractRootRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
         detail: `the game declares a root, but the seam failed — ${facts.contract.proof.root.detail}`,
         missing:
           'the host cannot trust that the declared element owns the game DOM rather than an unrelated or detached subtree',
-        fix: CONTRACT_FIX('window.vgaiGame.root'),
+        fix: CONTRACT_FIX('window.volterGame.root'),
       };
     }
     return {
@@ -703,7 +703,7 @@ function contractRootRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
       'the host adopts the bare canvas, so any DOM this game owns beside it (HUD, overlays, ' +
       'portals) is stranded at page level over the editor chrome instead of living in the ' +
       'game pane',
-    fix: CONTRACT_FIX('window.vgaiGame.root'),
+    fix: CONTRACT_FIX('window.volterGame.root'),
   };
 }
 
@@ -716,7 +716,7 @@ function contractStartRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
         detail: `lifecycle.start is declared but failed — ${facts.contract.proof.start.detail}`,
         missing:
           'the mount cannot prove it starts cold and enters a session only when Play requests one',
-        fix: CONTRACT_FIX('window.vgaiGame.lifecycle.start'),
+        fix: CONTRACT_FIX('window.volterGame.lifecycle.start'),
       };
     }
     return {
@@ -738,7 +738,7 @@ function contractStartRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
       'the mount cannot be COLD: this game runs its session side-effects (backend ' +
       'connections, audio, narrative) as it loads, so opening it in the editor starts ' +
       'playing it, and ▶ is a wire event the game may ignore',
-    fix: CONTRACT_FIX('window.vgaiGame.lifecycle.start'),
+    fix: CONTRACT_FIX('window.volterGame.lifecycle.start'),
   };
 }
 
@@ -792,7 +792,7 @@ function contractPauseRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
         status: 'gap',
         detail: `pause/resume is declared but failed — ${failed.detail}`,
         missing: pauseFallbackCost(facts),
-        fix: CONTRACT_FIX('window.vgaiGame.lifecycle.pause + resume'),
+        fix: CONTRACT_FIX('window.volterGame.lifecycle.pause + resume'),
       };
     }
     return {
@@ -814,7 +814,7 @@ function contractPauseRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
         ? 'a contract is declared, but it names no lifecycle.pause/resume'
         : 'no game→host contract is declared at all',
     missing: pauseFallbackCost(facts),
-    fix: CONTRACT_FIX('window.vgaiGame.lifecycle.pause + resume'),
+    fix: CONTRACT_FIX('window.volterGame.lifecycle.pause + resume'),
   };
 }
 
@@ -989,7 +989,7 @@ function systemsRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
         detail: `the systems carrier is declared but failed — ${facts.contract.proof.systems.detail}`,
         missing:
           '`game.commands()` / `game.providers()` cannot safely enumerate or invoke this carrier',
-        fix: CONTRACT_FIX('window.vgaiGame.systems (commands + state)'),
+        fix: CONTRACT_FIX('window.volterGame.systems (commands + state)'),
       };
     }
     return {
@@ -1013,7 +1013,7 @@ function systemsRow(facts: ResolvedCoverageFacts): CapabilityCoverageRow {
       'this game exposes no verbs and no state to drive or read it with: `game.commands()` and ' +
       '`game.providers()` enumerate nothing, so there is no `game.command(...)` to play it from ' +
       `${commandLine('eval')} and no \`game.state(...)\` for ${commandLine('status')} to see anything of what it is doing`,
-    fix: CONTRACT_FIX('window.vgaiGame.systems (commands + state)'),
+    fix: CONTRACT_FIX('window.volterGame.systems (commands + state)'),
   };
 }
 
@@ -1063,9 +1063,9 @@ function systemSlotFix(slot: SystemAdapterSlot): string {
     );
   }
   if (slot === 'debug') {
-    return CONTRACT_FIX('window.vgaiGame.systems (commands + state)');
+    return CONTRACT_FIX('window.volterGame.systems (commands + state)');
   }
-  return CONTRACT_FIX(`window.vgaiGame.systems.systemAdapters.${slot}`);
+  return CONTRACT_FIX(`window.volterGame.systems.systemAdapters.${slot}`);
 }
 
 /**
@@ -1571,7 +1571,7 @@ export function formatCapabilityCoverageBlocks(
  * The console door, ONCE PER MOUNT.
  *
  * The report is derived on demand (the status facet re-derives it on every
- * read, so `vgai status` never serves a verdict older than the question), which
+ * read, so `volter-game-editor status` never serves a verdict older than the question), which
  * makes "print it" a thing that could happen many times — per status poll, per
  * re-render, in the limit per frame. The guard is a mount token: the same
  * mount's report is emitted once and then never again, and a NEW mount emits

package/src/host/coverage/game-contract-seam-evidence.ts

@@ -7,9 +7,9 @@ import {
   type SeamEvidenceVerdict,
 } from '@volter/editor-project/adapter';
 import type {
-  VgaiGameContract,
-  VgaiGameLifecycle,
-  VgaiGameSystems,
+  VolterGameContract,
+  VolterGameLifecycle,
+  VolterGameSystems,
 } from '@volter/editor-project/adapter/ingest/game-contract';
 import {
   GAME_CONTRACT_SHAPE,
@@ -21,7 +21,7 @@ import { liveSeamEvidence } from '@volter/editor-sdk/kit/live-seam-evidence';
 const EPOCHS = new WeakMap<object, string>();
 let nextEpoch = 1;
 
-export function gameContractEpoch(contract: VgaiGameContract): string {
+export function gameContractEpoch(contract: VolterGameContract): string {
   const found = EPOCHS.get(contract);
   if (found) return found;
   const epoch = `contract-${nextEpoch++}`;
@@ -38,7 +38,7 @@ export interface GameContractEvidence {
 }
 
 export function inspectGameContractSeams(options: {
-  readonly contract: VgaiGameContract;
+  readonly contract: VolterGameContract;
   readonly subject?: string | undefined;
   readonly epoch?: string | undefined;
   readonly receipts?: readonly SeamEvidenceReceipt[] | undefined;
@@ -46,21 +46,21 @@ export function inspectGameContractSeams(options: {
   const subject = options.subject ?? 'game';
   const epoch = options.epoch ?? gameContractEpoch(options.contract);
   const receipts: SeamEvidenceReceipt[] = [
-    ...inspectSeamShape<VgaiGameContract>({
+    ...inspectSeamShape<VolterGameContract>({
       prefix: 'contract',
       value: options.contract,
       shape: GAME_CONTRACT_SHAPE,
       subject,
       epoch,
     }),
-    ...inspectSeamShape<VgaiGameLifecycle>({
+    ...inspectSeamShape<VolterGameLifecycle>({
       prefix: 'contract.lifecycle',
       value: options.contract.lifecycle,
       shape: GAME_LIFECYCLE_SHAPE,
       subject,
       epoch,
     }),
-    ...inspectSeamShape<VgaiGameSystems>({
+    ...inspectSeamShape<VolterGameSystems>({
       prefix: 'contract.systems',
       value: options.contract.systems,
       shape: GAME_SYSTEMS_SHAPE,

package/src/host/coverage/project-verb-coverage.ts

@@ -22,7 +22,7 @@
  * something the product itself already acts on:
  *
  *  - `export` reads what the export path ACTUALLY requires of a project, taken
- *    from the door's own source: `create-vgai-project/src/deploy.ts` runs
+ *    from the door's own source: `create-volter-project/src/deploy.ts` runs
  *    `npm run build` in the project (`runProjectBuild`) and stages the `dist/`
  *    that emits (`stageBuildOutput`). Ingest roots pass that door because the
  *    ingest project's own build is already its standalone game; arbitrary

package/src/host/coverage/system-adapter-coverage.ts

@@ -8,7 +8,7 @@
  * `editor.*` family — every mounted root, native or ingested, gets a row per
  * `AuthoringAdapter` provider. It deliberately keeps ONLY that family, on the
  * grounds that the remaining facts are "the ingested lane's own questions".
- * That is true of `contract.*` (a native game declares no `window.vgaiGame`
+ * That is true of `contract.*` (a native game declares no `window.volterGame`
  * and never will) and false of `system.*`: a `SystemAdapters` slot is read off
  * the editor's OWN live registry (`authoring/active-systems.ts`), which a
  * native game fills exactly as an ingested one does. So the slots went
@@ -31,7 +31,7 @@
  * `networking` is the exception, and it is the whole point. Nothing engine-side
  * builds it: a game registers a `NetworkingAdapter` itself. So its absence is
  * ruled out only by the PROJECT'S OWN FILE — no `server` block in
- * `vgai.project.json` means there is no room to describe. A game that DOES
+ * `volter.project.json` means there is no room to describe. A game that DOES
  * declare a room and binds nothing is `unanswered`, i.e. a standing warning.
  *
  * ## Provenance neutrality
@@ -59,7 +59,7 @@ import { inspectSystemAdapterSeam } from '@volter/editor-sdk/kit/system-seam-evi
  *  it. Both facts are read off things that already exist; neither is a guess. */
 export interface NativeProjectFacts {
   /**
-   * `vgai.project.json` declares a `server` block (a Colyseus room) — read from
+   * `volter.project.json` declares a `server` block (a Colyseus room) — read from
    * the active project view (`project-manager.ts`'s `ActiveProject.server`).
    * The decisive project-level declaration for whether this game is networked.
    */
@@ -118,7 +118,7 @@ export interface NativeProjectFacts {
  */
 const SLOT_LIBRARIES: Partial<Record<SystemAdapterSlot, readonly string[]>> = {
   physics: ['@react-three/rapier', '@dimforge/rapier3d-compat', '@dimforge/rapier2d-compat'],
-  networking: ['colyseus.js'],
+  networking: ['@colyseus/sdk', 'colyseus.js'],
   navigation: ['recast-navigation', '@recast-navigation/core'],
   audio: ['tone', 'howler'],
 };
@@ -213,7 +213,7 @@ function reasonAcknowledges(reason: string, library: string): boolean {
 
 /** The file fact that rules `networking` out, in the file's own terms. */
 const NO_SERVER_EVIDENCE =
-  "this project's vgai.project.json declares no `server` block, so there is no room for a " +
+  "this project's volter.project.json declares no `server` block, so there is no room for a " +
   'NetworkingAdapter to describe';
 
 /**
@@ -251,7 +251,7 @@ const ENGINE_OWNED_EVIDENCE: Partial<Record<SystemAdapterSlot, string>> = {
 };
 
 /** The fix a native game's author can actually act on, per slot. Never the
- *  ingested lane's `window.vgaiGame` text, which would be false here. */
+ *  ingested lane's `window.volterGame` text, which would be false here. */
 function nativeSlotFix(slot: SystemAdapterSlot, facts: NativeProjectFacts): string {
   if (!facts.mounted) {
     return 'nothing is mounted, so the live system registry has not been asked yet — enter Play, or open a project whose roots mount, and the slot reports its real state';
@@ -349,6 +349,19 @@ export function measureNativeSystemAdapters(
             : `declared absent by root "${absence.rootId}": ${absence.reason}${lastMountNote}`,
       };
     }
+    // A Colyseus client is the editor's to observe: Play binds its observer of the game's room
+    // sockets (`adapter-runtime-bindings.ts`'s `withObservedNetworking`), so an unbound slot while
+    // nothing plays is that observer not yet attached, not an adapter the game owes.
+    if (slot === 'networking' && libraries.length > 0) {
+      return {
+        slot,
+        state: 'empty',
+        attestedBy: 'host',
+        evidence:
+          `this project ships ${libraries.join(' + ')}; the editor observes its room sockets from ` +
+          'Play, and nothing is connected while editing',
+      };
+    }
     // Nothing declared, and the library IS here: the host's inference below
     // would print a confident absence over real evidence to the contrary. That
     // is an UNANSWERED question — the only state that is a work order — not a

package/src/host/game-location-guard.ts

@@ -9,14 +9,14 @@
  * ordinary game code and there is no cooperative way for a game to know better.
  *
  * So the game realm's `location` is a facade: reads of the game's own
- * query keep working, host control-plane keys (`play`, `project`, `vgai-*`,
+ * query keep working, host control-plane keys (`play`, `project`, `volter-*`,
  * …) are stripped from `search`/`href` (bubbo's `getUrlParam('play')` is a
  * debug skip-to-Game; the editor's `?play=1` autoplay is not that flag),
  * and every write that would NAVIGATE is refused with a `console.error`
  * naming the game, the exact assignment, and this mechanism. Refused, never
  * swallowed — a silent no-op would make "the quit button does nothing" an
  * unexplainable bug, and the console line is a real product door
- * (`vgai status` reports page console errors).
+ * (`volter-game-editor status` reports page console errors).
  *
  * `hash` is deliberately NOT refused: it changes the URL without leaving the
  * document, and games use it for their own state.
@@ -49,7 +49,7 @@ const HOST_SEARCH_KEYS = new Set([
 ]);
 
 function isHostSearchKey(key: string): boolean {
-  return HOST_SEARCH_KEYS.has(key) || key.startsWith('vgai');
+  return HOST_SEARCH_KEYS.has(key) || key.startsWith('volter');
 }
 
 /** The search string a game is allowed to read — host keys removed. */

package/src/host/game-module-access.ts

@@ -1,10 +1,10 @@
 import { commandLine } from '@volter/editor-sdk/kit/product-command';
 /**
- * THE MODULE LANE of `vgai eval` — reach the RUNNING mount's own module
+ * THE MODULE LANE of `volter-game-editor eval` — reach the RUNNING mount's own module
  * instances, by served path, using URLs retained by their owning realm.
  *
  * WHY THE MOUNT STAMP IS LOAD-BEARING. Project modules are served per mount
- * as `/<path>?vgai-mount=<id>` (`project-module-instance.ts` propagates the
+ * as `/<path>?volter-mount=<id>` (`project-module-instance.ts` propagates the
  * id through the whole project subtree), so browser module identity is
  * per-instance BY URL. A bare `import('/src/sim/host.ts')` therefore loads a
  * SECOND, never-ticked copy — the phantom-module trap the old string-command
@@ -25,15 +25,15 @@ import { commandLine } from '@volter/editor-sdk/kit/product-command';
 // with a guard test on the one true owner.
 /** Mirrors `project-module-url.ts`'s PROJECT_MOUNT_QUERY (guarded by test —
  *  the two must never drift). */
-const PROJECT_MOUNT_QUERY = 'vgai-mount';
+const PROJECT_MOUNT_QUERY = 'volter-mount';
 
 let focusedInstanceProvider: (() => string) | null = null;
 /** The packaged shell and source-served contributions share the host realm owner. */
 function moduleUrls(instanceId: string): readonly string[] {
   const host = globalThis as typeof globalThis & {
-    __vgaiGameModuleUrls?: (id: string) => readonly string[];
+    __volterGameModuleUrls?: (id: string) => readonly string[];
   };
-  return host.__vgaiGameModuleUrls?.(instanceId) ?? [];
+  return host.__volterGameModuleUrls?.(instanceId) ?? [];
 }
 
 /** Wired once by the editor shell (`command-listener.ts`) at boot. */
@@ -76,7 +76,7 @@ export function loadedGameModulePaths(instanceId: string): string[] {
 }
 
 /**
- * The `modules` binding of `vgai eval`'s `game.run` scope and of the
+ * The `modules` binding of `volter-game-editor eval`'s `game.run` scope and of the
  * `game-eval` op — a RESOLVER, `modules('src/sim/host.ts')`, that also
  * ENUMERATES what it can resolve.
  *

package/src/host/game-realm-page.ts

@@ -70,7 +70,7 @@ function captureOf(options?: boolean | AddEventListenerOptions | EventListenerOp
 
 /** Mark carrying the text this observer last wrote, so its own write is not
  *  re-scoped and a game's next rewrite is. */
-export const SCOPED_STYLE_MARK = 'vgaiScopedCss';
+export const SCOPED_STYLE_MARK = 'volterScopedCss';
 
 /**
  * The `@scope` rewriter, loaded on FIRST USE — the one page-side door to the
@@ -128,7 +128,7 @@ export function loadGameCssScoper(): Promise<(css: string) => string> {
  * `url.fileURLToPath/pathToFileURL`,
  * `source-map-js.SourceMapConsumer/SourceMapGenerator` — straight into the
  * game realm's console, which made the console-silence contract unreachable in
- * a fresh scaffold and every `vgai` verb exit non-zero (measured three times:
+ * a fresh scaffold and every `volter` verb exit non-zero (measured three times:
  * the donut, cold-barrel and lit-lanes probes). The chain was
  * `play-mode.enterPlayModeInner` -> `gated-globals.setGameSurface` ->
  * `GameRealmPage.surface` -> `observeInjectedStyles` -> `import('../server/
@@ -356,7 +356,7 @@ export class GameRealmPage {
     if (!surface) return null;
     if (!this.headElement || this.headElement.parentElement !== surface) {
       const head = document.createElement('div');
-      head.dataset['vgaiGameHead'] = '';
+      head.dataset['volterGameHead'] = '';
       head.hidden = true;
       surface.prepend(head);
       this.headElement = head;

package/src/host/game-realm-reclaim.ts

@@ -26,7 +26,7 @@ import { disposeGameRealm } from './gated-globals';
  *
  * The report is the point: a game that released everything it registered is
  * silent, and a game that did not is named, with the count, on the editor
- * console (and therefore in `vgai console`). The editor reclaims either way.
+ * console (and therefore in `volter-game-editor console`). The editor reclaims either way.
  */
 export function reclaimGameRealm(id: string, name: string): void {
   const released = disposeGameRealm(id);

package/src/host/gameplay-recording.ts

@@ -1,6 +1,6 @@
 /**
  * Live gameplay recording over the SAME clean game compositor used by
- * `vgai screenshot`: world canvases + DOM HUD, no editor chrome.
+ * `volter-game-editor screenshot`: world canvases + DOM HUD, no editor chrome.
  *
  * This is intentionally a browser primitive, not a CLI workflow. The page
  * owns `MediaRecorder` and the live pixels/audio, streams bounded chunks to
@@ -21,7 +21,7 @@
  * A counter for it was written, shipped and REMOVED in the same afternoon: it
  * keyed on `domOverlays === 0` and therefore reported a clean zero over clips
  * visibly missing their HUD. A measurement that can only ever say "fine" is
- * worse than none, so the limit is stated — here, and in the ack `vgai stop`
+ * worse than none, so the limit is stated — here, and in the ack `volter-game-editor stop`
  * prints — rather than counted. Read the world layer as complete evidence and
  * the HUD as present-when-present.
  */
@@ -62,7 +62,7 @@ export interface GameplayRecordingStartOptions {
   readonly canvasFrame?: CaptureOptions['canvasFrame'];
   readonly audio?: AudioRecordingHandle | null | undefined;
   /**
-   * The file this recording lands in, under the project's `.vgai/recordings/`.
+   * The file this recording lands in, under the project's `.volter/recordings/`.
    * During Play, absent is named after the Gameplay Session; outside one it
    * falls back to `play-latest.webm`. A name is the caller's own keepsake. The server owns the literals — see
    * `editor-server.ts`'s `/__editor/recording/start`.
@@ -211,7 +211,7 @@ interface FrameClock {
  * `setInterval` on the page is the obvious pacer and it is the wrong one for
  * the case this recorder exists to serve. Chrome clamps a background tab's
  * timers to 1 Hz, and to roughly 1/min once the tab has been hidden for five
- * minutes — and an agent's `vgai edit` tab is hidden BY DESIGN (worktree
+ * minutes — and an agent's `volter-game-editor edit` tab is hidden BY DESIGN (worktree
  * sessions open behind the human's window; see `after-paint.ts` for the same
  * fact stated for rAF). A 30 fps request would encode as a handful of frames.
  *
@@ -370,7 +370,7 @@ function samplePreviewFrame(recording: ActiveRecording, mediaTimeMs: number): vo
  *
  * The refusal this replaced ("show the editor tab, then start recording")
  * exempted exactly the sessions the recorder exists for: an agent's
- * `vgai edit` tab opens behind the human's window and stays hidden for the
+ * `volter-game-editor edit` tab opens behind the human's window and stays hidden for the
  * whole run, so every unattended playthrough — the ones with no human to
  * describe what happened — would have produced no evidence at all. What a
  * hidden tab actually costs is two things, and both are handled rather than