@bitmagic/cli 0.1.17 → 0.1.19

package/dist/editor/server.d.ts

@@ -0,0 +1,17 @@
+export interface EditorServerOptions {
+    /** The project root — the directory holding `bitmagic.json`. */
+    root: string;
+    /** The game this project owns, from `bitmagic.json`. */
+    gameId: string;
+    /** Port vite serves the game on; the shell iframes it. */
+    gamePort: number;
+    /** Port to bind. Fails loudly if taken — the URL is meant to be stable and bookmarkable. */
+    port: number;
+    log?: (message: string) => void;
+}
+export interface EditorServer {
+    /** The URL to open, e.g. `http://localhost:3011/`. */
+    readonly url: string;
+    close(): Promise<void>;
+}
+export declare function startEditorServer(options: EditorServerOptions): Promise<EditorServer>;

package/dist/editor/server.js

@@ -0,0 +1,185 @@
+/**
+ * The editor sidecar: a loopback HTTP server that gives the shell page the two things a browser
+ * cannot do for itself — read the project's game data off disk, and write scene edits back to
+ * `src/work/world.json`.
+ *
+ * It is deliberately NOT part of the project's vite server. Vite serves `<projectRoot>` and its
+ * config is a file the creator owns (`vite.config.js`, scaffolded once and never upgraded), so
+ * putting a save endpoint there would freeze this protocol at whatever version the project was
+ * scaffolded with. Running it from the CLI instead means `bitmagic edit` ships its own shell and
+ * its own endpoints, and an old project gets the new editor by upgrading the CLI alone.
+ *
+ * Bound to 127.0.0.1 for the obvious reason: it writes files in the creator's project. It must not
+ * be reachable off the machine. CORS is answered explicitly because the shell (this origin) and the
+ * game (vite's origin) are different ports — only the shell talks to these endpoints, but the
+ * preflight has to succeed either way.
+ */
+import * as fs from 'fs';
+import * as http from 'http';
+import { CliError } from '../errors.js';
+import { applyModificationsToWorld } from '../forge/apply-modifications.js';
+import { readProjectGameData } from '../forge/browser-host.js';
+import { projectWorldJsonPath } from '../forge/run-pipeline.js';
+import { renderEditorShell } from './shell-page.js';
+import { buildSceneModifications } from './save.js';
+/** Bodies are a scene snapshot, not an upload — a megabyte is already generous. */
+const MAX_BODY_BYTES = 8 * 1024 * 1024;
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = '';
+        req.on('data', (chunk) => {
+            body += String(chunk);
+            if (body.length > MAX_BODY_BYTES) {
+                reject(new Error('Request body too large'));
+                req.destroy();
+            }
+        });
+        req.on('end', () => resolve(body));
+        req.on('error', reject);
+    });
+}
+function writeCors(res) {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+}
+function sendJson(res, status, body) {
+    res.writeHead(status, { 'Content-Type': 'application/json' }).end(JSON.stringify(body));
+}
+/**
+ * Modification time of world.json, or 0 when it cannot be read.
+ *
+ * This is how the shell tells the creator's own saves apart from an edit their agent made while
+ * the editor was open. The server records the mtime it produced on every write; a value that does
+ * not match is someone else's write, and the shell offers a reload rather than silently continuing
+ * against a scene that no longer matches the file.
+ */
+function worldMtimeMs(worldPath) {
+    try {
+        return fs.statSync(worldPath).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+function readWorld(worldPath) {
+    const parsed = JSON.parse(fs.readFileSync(worldPath, 'utf-8'));
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new CliError(`${worldPath} does not contain a world object.`);
+    }
+    return parsed;
+}
+export async function startEditorServer(options) {
+    const log = options.log ?? (() => { });
+    const worldPath = projectWorldJsonPath(options.root);
+    const shell = renderEditorShell({ gamePort: options.gamePort, gameId: options.gameId });
+    /** The mtime our own last write produced. Anything else is an external edit. */
+    let lastWrittenMtimeMs = worldMtimeMs(worldPath);
+    const handleSave = async (req, res) => {
+        let payload;
+        try {
+            payload = JSON.parse(await readBody(req));
+        }
+        catch {
+            sendJson(res, 400, { ok: false, error: 'Request body must be JSON' });
+            return;
+        }
+        if (payload?.status?.unlocked !== true) {
+            // Not an error: the engine reports the scene locked until the world has loaded, and the
+            // shell's poll can land in that window.
+            sendJson(res, 200, { ok: true, applied: 0, skipped: 'scene editing is locked' });
+            return;
+        }
+        let modifications;
+        try {
+            modifications = buildSceneModifications(payload, readWorld(worldPath));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            log(`[editor] could not read ${worldPath}: ${message}`);
+            sendJson(res, 500, { ok: false, error: message });
+            return;
+        }
+        if (modifications.length === 0) {
+            sendJson(res, 200, { ok: true, applied: 0, worldMtimeMs: lastWrittenMtimeMs });
+            return;
+        }
+        try {
+            const outcome = applyModificationsToWorld(worldPath, modifications);
+            lastWrittenMtimeMs = worldMtimeMs(worldPath);
+            for (const line of outcome.summary)
+                log(`[editor] ${line}`);
+            sendJson(res, 200, {
+                ok: true,
+                applied: outcome.applied,
+                summary: outcome.summary,
+                worldMtimeMs: lastWrittenMtimeMs,
+            });
+        }
+        catch (error) {
+            // `applyModificationsToWorld` writes nothing when it throws, so world.json still holds
+            // whatever it had. Report it rather than swallowing: the shell surfaces it, because a save
+            // that silently did nothing is the worst outcome for an autosaving editor.
+            const message = error instanceof Error ? error.message : String(error);
+            log(`[editor] save refused: ${message}`);
+            sendJson(res, 422, { ok: false, error: message });
+        }
+    };
+    const server = http.createServer((req, res) => {
+        void (async () => {
+            writeCors(res);
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204).end();
+                return;
+            }
+            const url = (req.url ?? '/').split('?')[0];
+            if (req.method === 'GET' && (url === '/' || url === '/index.html')) {
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' }).end(shell);
+                return;
+            }
+            if (req.method === 'GET' && url === '/api/game-data') {
+                try {
+                    sendJson(res, 200, {
+                        gameId: options.gameId,
+                        // The same merge the forge browser uses: `GameEngine.loadGame` reads
+                        // `worldProfileData` from world.json and `gameGenre` from game.json, and refuses to
+                        // load with either missing.
+                        gameData: readProjectGameData(options.root, { gameId: options.gameId }),
+                        worldMtimeMs: worldMtimeMs(worldPath),
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    sendJson(res, 500, { ok: false, error: message });
+                }
+                return;
+            }
+            if (req.method === 'GET' && url === '/api/state') {
+                sendJson(res, 200, {
+                    worldMtimeMs: worldMtimeMs(worldPath),
+                    lastWrittenMtimeMs,
+                });
+                return;
+            }
+            if (req.method === 'POST' && url === '/api/scene/save') {
+                await handleSave(req, res);
+                return;
+            }
+            sendJson(res, 404, { ok: false, error: `No route for ${req.method ?? '?'} ${url}` });
+        })();
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', (error) => {
+            reject(error.code === 'EADDRINUSE'
+                ? new CliError(`Port ${options.port} is already in use, so the editor cannot start. `
+                    + 'Stop whatever is using it, or pass `--editor-port`.')
+                : new CliError(`The editor server could not start: ${error.message}`));
+        });
+        server.listen(options.port, '127.0.0.1', resolve);
+    });
+    return {
+        url: `http://localhost:${options.port}/`,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/editor/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/editor/server.ts"],"names":[],"mappings":"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"}

package/dist/editor/shell-page.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The editor shell: the page that plays the Creator's role for a CLI-lane project.
+ *
+ * The whole feature rests on one fact — the visual editor is ALREADY in every scaffolded project.
+ * `VENDORED_DIRS` in `scaffold/project.ts` ships `engine/editor/` and `engine/debug/`, and
+ * `GameEngine` constructs `EditorManager` unconditionally, building the transform gizmo, the object
+ * inspector and the scene hierarchy into a hidden `#debug-container`. What the pro lane lacked was
+ * a parent frame speaking the Creator's `postMessage` protocol. This page is that frame, and
+ * nothing under `game/` changes to support it.
+ *
+ * Rendered from TypeScript rather than shipped as a `.html` asset because the package builds with
+ * plain `tsc`, which copies no static files. `smoke/harness.ts` and `scaffold/project-files.ts`
+ * both do the same.
+ *
+ * ── Four things that fail silently if changed ────────────────────────────────────────────────
+ *
+ *  1. `?source=creator` on the iframe URL. Without it `isCreatorMode` is false
+ *     (`game/src/engine/CreatorMode.ts`), the engine never registers its message listener, and
+ *     every message below is discarded with no error anywhere.
+ *  2. `GAME_TEMPLATE_READY` must arrive before `LOAD_GAME` is posted. The engine registers its
+ *     listener only after `await initI18n()`, and a `LOAD_GAME` landing before that is DROPPED,
+ *     not queued — the symptom is a game that never loads, pointing at the wrong culprit.
+ *  3. `REQUEST_ASSETS` / `ADD_OBJECT` / `MARK_OBJECT_MODIFIED` use a FLAT envelope
+ *     (`{ type, assets }`), not the `{ type, data }` one the rest of the protocol uses. That is
+ *     the Creator's existing shape (`useIframeMessages.ts:1149`, `:332`) and the engine reads the
+ *     fields off the message directly.
+ *  4. The autosave poll, rather than an event. `TransformControlsManager`'s mouseUp reaches
+ *     `EditorManager.commitTransformChange()`, which only mutates a `Set` — the engine posts
+ *     nothing. Polling `CHECK_SCENE_CHANGES` is what the Creator does too, just on tab switch
+ *     instead of on a timer, and it covers drags, deletes, adds and inspector edits with one path.
+ */
+export interface EditorShellOptions {
+    /** Port vite serves the game on. */
+    gamePort: number;
+    /** The game this project owns. */
+    gameId: string;
+}
+export declare function renderEditorShell(options: EditorShellOptions): string;

package/dist/editor/shell-page.js

@@ -0,0 +1,339 @@
+/**
+ * The editor shell: the page that plays the Creator's role for a CLI-lane project.
+ *
+ * The whole feature rests on one fact — the visual editor is ALREADY in every scaffolded project.
+ * `VENDORED_DIRS` in `scaffold/project.ts` ships `engine/editor/` and `engine/debug/`, and
+ * `GameEngine` constructs `EditorManager` unconditionally, building the transform gizmo, the object
+ * inspector and the scene hierarchy into a hidden `#debug-container`. What the pro lane lacked was
+ * a parent frame speaking the Creator's `postMessage` protocol. This page is that frame, and
+ * nothing under `game/` changes to support it.
+ *
+ * Rendered from TypeScript rather than shipped as a `.html` asset because the package builds with
+ * plain `tsc`, which copies no static files. `smoke/harness.ts` and `scaffold/project-files.ts`
+ * both do the same.
+ *
+ * ── Four things that fail silently if changed ────────────────────────────────────────────────
+ *
+ *  1. `?source=creator` on the iframe URL. Without it `isCreatorMode` is false
+ *     (`game/src/engine/CreatorMode.ts`), the engine never registers its message listener, and
+ *     every message below is discarded with no error anywhere.
+ *  2. `GAME_TEMPLATE_READY` must arrive before `LOAD_GAME` is posted. The engine registers its
+ *     listener only after `await initI18n()`, and a `LOAD_GAME` landing before that is DROPPED,
+ *     not queued — the symptom is a game that never loads, pointing at the wrong culprit.
+ *  3. `REQUEST_ASSETS` / `ADD_OBJECT` / `MARK_OBJECT_MODIFIED` use a FLAT envelope
+ *     (`{ type, assets }`), not the `{ type, data }` one the rest of the protocol uses. That is
+ *     the Creator's existing shape (`useIframeMessages.ts:1149`, `:332`) and the engine reads the
+ *     fields off the message directly.
+ *  4. The autosave poll, rather than an event. `TransformControlsManager`'s mouseUp reaches
+ *     `EditorManager.commitTransformChange()`, which only mutates a `Set` — the engine posts
+ *     nothing. Polling `CHECK_SCENE_CHANGES` is what the Creator does too, just on tab switch
+ *     instead of on a timer, and it covers drags, deletes, adds and inspector edits with one path.
+ */
+/** How often the shell asks the engine whether anything changed. A `Set` read; effectively free. */
+const POLL_INTERVAL_MS = 500;
+/** Attribute-safe. `gameId` comes from `bitmagic.json`, but it lands inside an HTML attribute. */
+function escapeAttr(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/"/g, '"')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+export function renderEditorShell(options) {
+    const gameUrl = `http://localhost:${options.gamePort}/?source=creator&gameId=${encodeURIComponent(options.gameId)}`;
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>bitmagic edit — ${escapeAttr(options.gameId)}</title>
+<style>
+  :root { color-scheme: dark; }
+  * { box-sizing: border-box; }
+  /* Flex column rather than calc() heights: the banners come and go, and two of them at once
+     must not push the viewport into a scrollbar. */
+  body { margin: 0; height: 100vh; display: flex; flex-direction: column;
+         background: #101014; color: #e6e6ea; font: 13px/1.45 ui-sans-serif, system-ui, sans-serif; }
+  #bar { display: flex; align-items: center; gap: 12px; height: 36px; flex: none; padding: 0 12px;
+         background: #17171d; border-bottom: 1px solid #26262e; }
+  #bar .id { color: #8a8a99; font-family: ui-monospace, monospace; }
+  #bar .spacer { flex: 1; }
+  #status { display: flex; align-items: center; gap: 6px; }
+  #dot { width: 8px; height: 8px; border-radius: 50%; background: #4a4a57; }
+  #dot.saving { background: #d9a441; }
+  #dot.saved  { background: #4caf72; }
+  #dot.error  { background: #e0564f; }
+  button { background: #26262e; color: #e6e6ea; border: 1px solid #34343f; border-radius: 5px;
+           padding: 4px 10px; font: inherit; cursor: pointer; }
+  button:hover { background: #30303a; }
+  .banner { display: none; align-items: center; gap: 12px; flex: none; padding: 8px 12px;
+            background: #3a2c12; border-bottom: 1px solid #574018; color: #f0d9a8; }
+  .banner.show { display: flex; }
+  #terrain-banner { background: #3d1f1c; border-bottom-color: #6b2f28; color: #f3c3bd; }
+  #frame { display: block; flex: 1; width: 100%; border: 0; min-height: 0; }
+</style>
+</head>
+<body>
+  <div id="bar">
+    <strong>bitmagic edit</strong>
+    <span class="id">${escapeAttr(options.gameId)}</span>
+    <span class="spacer"></span>
+    <span id="status"><span id="dot"></span><span id="status-text">Loading…</span></span>
+    <button id="reload" type="button">Reload</button>
+  </div>
+  <div id="banner" class="banner">
+    <span>src/work/world.json changed on disk — this scene is out of date.</span>
+    <button id="banner-reload" type="button">Reload scene</button>
+  </div>
+  <div id="terrain-banner" class="banner">
+    <span><strong>Terrain edits are not saved yet.</strong>
+      Sculpting the ground needs an asset upload that <code>bitmagic edit</code> does not do — these
+      voxel changes will be lost. Discard them, or press Cancel in the terrain toolbar.</span>
+    <button id="terrain-discard" type="button">Discard terrain edits</button>
+  </div>
+  <iframe id="frame" allow="autoplay; fullscreen; xr-spatial-tracking; clipboard-write"></iframe>
+<script>
+(function () {
+  'use strict';
+  var GAME_URL = ${JSON.stringify(gameUrl)};
+  var POLL_MS = ${POLL_INTERVAL_MS};
+
+  var frame = document.getElementById('frame');
+  var dot = document.getElementById('dot');
+  var statusText = document.getElementById('status-text');
+  var banner = document.getElementById('banner');
+  var terrainBanner = document.getElementById('terrain-banner');
+
+  var loaded = false;
+  var saving = false;
+  var markersDirty = false;
+  var lastKnownMtime = 0;
+  var pollTimer = null;
+  var waiters = [];
+  // Bumped by reload(). Every async step checks it, so a reload triggered mid-boot cannot leave
+  // two polling loops running against one iframe.
+  var generation = 0;
+
+  function setStatus(kind, text) {
+    dot.className = kind || '';
+    statusText.textContent = text;
+  }
+
+  function post(type, data) {
+    if (frame.contentWindow) frame.contentWindow.postMessage({ type: type, data: data }, '*');
+  }
+
+  // The flat envelope — see note 3 in this file's header.
+  function postFlat(message) {
+    if (frame.contentWindow) frame.contentWindow.postMessage(message, '*');
+  }
+
+  /** Resolve on the next message of this type, or null after timeoutMs. Never rejects. */
+  function await_(type, timeoutMs) {
+    return new Promise(function (resolve) {
+      var waiter = { type: type, resolve: resolve, timer: null };
+      waiter.timer = setTimeout(function () {
+        var i = waiters.indexOf(waiter);
+        if (i !== -1) waiters.splice(i, 1);
+        resolve(null);
+      }, timeoutMs);
+      waiters.push(waiter);
+    });
+  }
+
+  window.addEventListener('message', function (event) {
+    var message = event.data;
+    if (!message || typeof message.type !== 'string') return;
+
+    for (var i = waiters.length - 1; i >= 0; i--) {
+      if (waiters[i].type === message.type) {
+        clearTimeout(waiters[i].timer);
+        waiters[i].resolve(message);
+        waiters.splice(i, 1);
+      }
+    }
+
+    switch (message.type) {
+      case 'REQUEST_ASSETS':
+        // Re-read rather than serving the copy captured at boot: an agent may have generated an
+        // asset since this page loaded, and a stale list is an empty asset palette with no
+        // explanation.
+        fetch('/api/game-data').then(function (r) { return r.json(); }).then(function (payload) {
+          var data = payload && payload.gameData;
+          postFlat({ type: 'ASSETS_RESPONSE', assets: (data && data.assets) || [] });
+        }).catch(function () {
+          postFlat({ type: 'ASSETS_RESPONSE', assets: [] });
+        });
+        break;
+
+      case 'ADD_OBJECT':
+        // The engine already placed the object; all the host owes it is a dirty mark so the next
+        // poll picks the new id up. (The Creator also sets environmentObjectsManuallyEdited here —
+        // that flag exists only to gate the web lane's world-edit CLI and has no meaning for a
+        // project whose agent edits world.json directly.)
+        if (message.objectId) postFlat({ type: 'MARK_OBJECT_MODIFIED', objectId: message.objectId });
+        break;
+
+      case 'ADD_MARKER':
+      case 'UPDATE_MARKER':
+        markersDirty = true;
+        break;
+
+      // No other tabs exist here, and asset re-baking is a "bitmagic generate" concern.
+      case 'SWITCH_TO_TAB':
+      case 'OPEN_ASSET_ACTION':
+        break;
+    }
+  });
+
+  async function boot(gen) {
+    loaded = false;
+    markersDirty = false;
+    banner.classList.remove('show');
+    terrainBanner.classList.remove('show');
+    setStatus('', 'Loading…');
+
+    var response = await fetch('/api/game-data');
+    if (gen !== generation) return;
+    if (!response.ok) {
+      setStatus('error', 'Could not read the project');
+      return;
+    }
+    var project = await response.json();
+    lastKnownMtime = project.worldMtimeMs || 0;
+
+    // Both waits are armed BEFORE navigation: either signal can arrive while the page loads.
+    var templateReady = await_('GAME_TEMPLATE_READY', 60000);
+    var gameLoaded = await_('GAME_LOADED', 120000);
+    frame.src = GAME_URL;
+
+    var ready = await templateReady;
+    if (gen !== generation) return;
+    if (!ready) {
+      setStatus('error', 'The game never finished booting — try "bitmagic verify"');
+      return;
+    }
+    post('LOAD_GAME', { gameId: project.gameId, gameData: project.gameData, skipMenu: true });
+    var started = await gameLoaded;
+    if (gen !== generation) return;
+    if (!started) {
+      setStatus('error', 'The world never loaded — try "bitmagic verify"');
+      return;
+    }
+
+    // Mirrors the Creator's enterEditorMode(): pause, turn the editor on (this is what unpacks
+    // InstancedMeshes so clicks can hit an individual instance), then configure the free camera
+    // and hide the HUD.
+    post('SET_PAUSE', { paused: true });
+    post('SET_EDITOR_MODE', { enabled: true });
+    post('SET_EDITOR_TAB', { tab: 'scene' });
+
+    loaded = true;
+    setStatus('saved', 'Ready');
+  }
+
+  async function flush() {
+    if (!loaded || saving) return;
+
+    post('CHECK_SCENE_CHANGES');
+    var changes = await await_('SCENE_HAS_CHANGES', 2000);
+    if (!changes) return;
+    if (!changes.hasChanges && !markersDirty) return;
+
+    post('GET_SCENE_EDITING_STATUS');
+    var status = await await_('SCENE_EDITING_STATUS', 5000);
+    if (!status) return;
+
+    saving = true;
+    setStatus('saving', 'Saving…');
+    try {
+      var response = await fetch('/api/scene/save', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ changes: changes, status: status, markersDirty: markersDirty })
+      });
+      var result = await response.json();
+      if (!response.ok || !result.ok) {
+        setStatus('error', result.error || 'Save failed');
+        return;
+      }
+      lastKnownMtime = result.worldMtimeMs || lastKnownMtime;
+      markersDirty = false;
+      // Only once the write landed: clearing earlier would drop the edit on a failed save.
+      post('CLEAR_SCENE_CHANGES');
+      setStatus('saved', result.applied > 0 ? 'Saved to world.json' : 'Ready');
+    } catch (error) {
+      setStatus('error', 'Save failed: ' + error.message);
+    } finally {
+      saving = false;
+    }
+  }
+
+  /**
+   * Terrain sculpting is out of scope for this command, but it is not out of REACH: clicking the
+   * ground drops the engine straight into a whole-terrain voxel session (EditorManager.selectObject
+   * routes every terrain-chunk hit to startTerrainVoxelSession, with no lock to stop it). Its
+   * "Save & Exit" uploads the terrain VXL to a signed URL that only the web lane and the forge can
+   * mint — here saveToS3 fails, logs a console warning, and marks the session committed. The
+   * creator would lose the work with no visible sign.
+   *
+   * So say so, within one poll of the first voxel edit, and offer the revert the engine already
+   * implements. hasUnsavedTerrainChanges() is false for a session that was merely opened, so
+   * clicking the ground by accident stays silent.
+   */
+  async function checkTerrainEdits() {
+    if (!loaded) return;
+    post('CHECK_TERRAIN_CHANGES');
+    var terrain = await await_('TERRAIN_HAS_CHANGES', 2000);
+    if (!terrain) return;
+    terrainBanner.classList.toggle('show', terrain.hasChanges === true);
+  }
+
+  async function checkExternalEdits() {
+    if (!loaded || saving) return;
+    try {
+      var state = await (await fetch('/api/state')).json();
+      // Anything other than the mtime our own last write produced is someone else's edit — most
+      // likely the creator's agent. Offer a reload rather than taking one: an unprompted reload
+      // would discard a drag in progress.
+      if (state.worldMtimeMs && state.worldMtimeMs !== lastKnownMtime
+          && state.worldMtimeMs !== state.lastWrittenMtimeMs) {
+        banner.classList.add('show');
+      }
+    } catch (error) {
+      // The sidecar is this page's own server; if it is gone the reload button is the only
+      // meaningful action left, and the poll below will keep trying.
+    }
+  }
+
+  // One serial loop rather than two timers: a flush and an mtime check must never overlap, or the
+  // check reads the mtime of a write that has not finished being accounted for.
+  async function loop(gen) {
+    if (gen !== generation) return;
+    await flush();
+    await checkTerrainEdits();
+    await checkExternalEdits();
+    if (gen !== generation) return;
+    pollTimer = setTimeout(function () { loop(gen); }, POLL_MS);
+  }
+
+  function start() {
+    if (pollTimer) clearTimeout(pollTimer);
+    var gen = ++generation;
+    boot(gen).then(function () { loop(gen); });
+  }
+
+  document.getElementById('reload').addEventListener('click', start);
+  document.getElementById('banner-reload').addEventListener('click', start);
+  document.getElementById('terrain-discard').addEventListener('click', function () {
+    post('REVERT_TERRAIN_CHANGES');
+    terrainBanner.classList.remove('show');
+  });
+
+  start();
+})();
+</script>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=shell-page.js.map

package/dist/editor/shell-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,oGAAoG;AACpG,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,kGAAkG;AAClG,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC;AASD,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,OAAO,GAAG,oBAAoB,OAAO,CAAC,QAAQ,2BAA2B,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACpH,OAAO;;;;yBAIgB,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA8B5B,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;mBAmB9B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;kBACxB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+OjC,CAAC;AACF,CAAC"}

package/dist/project/context.d.ts

@@ -3,6 +3,8 @@ export interface ProjectMetadata {
     engineVersion: string;
     genre: string;
     template: string;
+    /** See the same field in scaffold/project-files.ts. Absent on projects scaffolded before it. */
+    agentsMdHash?: string;
 }
 export interface ProjectContext {
     root: string;

package/dist/project/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/project/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/project/context.ts"],"names":[],"mappings":"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"}