@bitmagic/cli 0.1.18 → 0.1.19

package/README.md

@@ -35,6 +35,7 @@ bitmagic publish              # verify-gate, build, and ship — private by defa
 | `bitmagic init [dir] [--template <id>] [--name <name>] [--idea "<pitch>"] [--env <env>] [--force]` | Scaffold a new project: mints a game, downloads the vendored engine, writes `AGENTS.md`, `GAME-DESIGN.md` and templates. `--idea` seeds the design doc's pitch. |
 | `bitmagic check` | Typecheck (`tsc --noEmit`) against the vendored engine. Fast; does not prove the game runs. |
 | `bitmagic dev [--port <port>]` | Build, then serve with `tsc --watch` + `vite`, default port 3010. |
+| `bitmagic edit [--port <port>] [--editor-port <port>]` | Everything `dev` does, plus a visual scene editor at `http://localhost:3011/`: click an object, drag the gizmo, and the new transform is written to `src/work/world.json`. See **Editing the scene visually** below. |
 | `bitmagic verify [--timeout <ms>]` | Build, boot the game in a headless browser, click the engine's Play button like a player would, and report what broke. A game without the button passes as long as gameplay starts by itself (auto-starting genres, custom start UIs); a run where gameplay never starts fails. `--timeout` is settle time in ms measured after gameplay starts, so the screenshot captures gameplay. Writes the artifacts the publish gate reads (see below). |
 | `bitmagic build` | Bundle the game into one self-contained `.bitmagic/build/index.html`. Rarely needs to be run by hand — `publish` builds automatically when the project changed. |
 | `bitmagic publish [--visibility public\|private] [--name <name>] [--description <desc>] [--force]` | Verify-gate, build if needed, and upload straight to GCS. **Private unless `--visibility public` is passed.** |
@@ -88,6 +89,37 @@ Re-running on an unchanged design generates nothing and costs nothing — it rep
 cover. Edit the design and run again, or pass `--force`, to replace it. Because it writes
 `world.json`, it invalidates a passing verify: run it before `bitmagic verify`, not after.
 
+## Editing the scene visually
+
+Some things are faster with a mouse. `bitmagic edit` runs everything `bitmagic dev` runs and adds a
+local editor on a second port:
+
+```bash
+bitmagic edit
+#   Serving the game at http://localhost:3010/
+#   Editor ready at      http://localhost:3011/
+```
+
+Open the editor URL in your normal browser. The game loads paused, with a free-flying camera, the
+scene hierarchy and the transform gizmo — the same editor the web Creator uses, which already ships
+inside `engine/`. Click an object to select it, then move, rotate, scale, snap it to the ground,
+edit its numbers in the inspector, delete it, or right-click to add one from the project's assets.
+
+**Every change is saved to `src/work/world.json` as you make it.** There is no Save button and no
+unsaved state: your agent reads the same file, and `git diff` is the record of what you moved.
+Saves are surgical — one entry per object touched, nothing else in the file is rewritten.
+
+If your agent edits `world.json` while the editor is open, the editor says so and offers a reload
+rather than silently reloading over work in progress.
+
+Both ports must fall between 3000 and 3199. That is the window the asset CDN allows as an origin;
+outside it the game loads with no terrain and no error.
+
+What it does **not** do yet: terrain and voxel sculpting. Clicking the ground still opens the
+engine's terrain tools, but saving them needs an asset upload this command does not perform, so the
+editor warns you as soon as you change a voxel and offers to discard it. Use the web Creator for
+terrain work.
+
 ## Publishing
 
 `bitmagic publish` is two gated steps in one command:

package/dist/cli.d.ts

@@ -95,6 +95,16 @@ declare const rawCommands: {
             readonly description: "Port to serve on (default 3010).";
         };
     }>;
+    edit: CommandDef<{
+        readonly port: {
+            readonly type: "string";
+            readonly description: "Port to serve the game on (default 3010).";
+        };
+        readonly 'editor-port': {
+            readonly type: "string";
+            readonly description: "Port to serve the editor on (default 3011).";
+        };
+    }>;
     verify: CommandDef<{
         readonly timeout: {
             readonly type: "string";

package/dist/cli.js

@@ -8,6 +8,7 @@ import { initCommand } from './commands/init.js';
 import { upgradeCommand } from './commands/upgrade.js';
 import { checkCommand } from './commands/check.js';
 import { devCommand } from './commands/dev.js';
+import { editCommand } from './commands/edit.js';
 import { verifyCommand } from './commands/verify.js';
 import { buildCommand } from './commands/build.js';
 import { generateCommand } from './commands/generate.js';
@@ -102,6 +103,7 @@ const rawCommands = {
     upgrade: upgradeCommand,
     check: checkCommand,
     dev: devCommand,
+    edit: editCommand,
     verify: verifyCommand,
     build: buildCommand,
     generate: generateCommand,

package/dist/cli.js.map

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

package/dist/commands/edit.d.ts

@@ -0,0 +1,10 @@
+export declare const editCommand: import("citty").CommandDef<{
+    readonly port: {
+        readonly type: "string";
+        readonly description: "Port to serve the game on (default 3010).";
+    };
+    readonly 'editor-port': {
+        readonly type: "string";
+        readonly description: "Port to serve the editor on (default 3011).";
+    };
+}>;

package/dist/commands/edit.js

@@ -0,0 +1,142 @@
+/**
+ * `bitmagic edit` — `dev` plus a visual scene editor.
+ *
+ * Everything `dev` does (build, `tsc --watch`, vite) plus a loopback sidecar that serves the editor
+ * shell and writes scene edits into `src/work/world.json`. Deliberately a superset rather than a
+ * flag on `dev`: `dev` is the plain run-the-game loop and must stay offline, minimal and boring,
+ * while `edit` opens a second port and a write path into the creator's project.
+ */
+import { defineCommand } from 'citty';
+import { spawn, spawnSync } from 'child_process';
+import { CliError } from '../errors.js';
+import { loadProjectContext, projectBin } from '../project/context.js';
+import { startEditorServer } from '../editor/server.js';
+import { CORS_ALLOWED_PORT_MAX, CORS_ALLOWED_PORT_MIN } from '../local-port.js';
+import { waitForServer } from '../verify/wait-for-server.js';
+const DEFAULT_GAME_PORT = 3010;
+const DEFAULT_EDITOR_PORT = 3011;
+/**
+ * Both ports must sit inside the CDN's CORS window.
+ *
+ * The game port for the reason `local-port.ts` documents at length: a project fetches its forged
+ * level and its GLBs cross-origin from the portal CDN, which allowlists `localhost:3000`-`3199`
+ * and nothing else. Outside it the fetch is blocked, the world loads with no terrain, and the
+ * symptom reads as a broken game rather than a blocked request.
+ *
+ * The editor port is checked too, even though the shell itself fetches nothing from the CDN,
+ * because the two are adjacent by default and a creator who moves one will move the other — being
+ * told the rule once, at the point of the mistake, beats discovering it as a terrain-less world.
+ */
+function parsePort(value, fallback, flag) {
+    if (value === undefined)
+        return fallback;
+    const port = Number(value);
+    if (!Number.isInteger(port)) {
+        throw new CliError(`\`${flag}\` must be a whole number, got "${value}".`);
+    }
+    if (port < CORS_ALLOWED_PORT_MIN || port > CORS_ALLOWED_PORT_MAX) {
+        throw new CliError(`\`${flag}\` must be between ${CORS_ALLOWED_PORT_MIN} and ${CORS_ALLOWED_PORT_MAX}. `
+            + 'The asset CDN only allows those origins; outside that window the game loads with no terrain.');
+    }
+    return port;
+}
+export const editCommand = defineCommand({
+    meta: {
+        name: 'edit',
+        description: 'Serve the game with a visual scene editor, saving edits to world.json.',
+    },
+    args: {
+        port: { type: 'string', description: `Port to serve the game on (default ${DEFAULT_GAME_PORT}).` },
+        'editor-port': { type: 'string', description: `Port to serve the editor on (default ${DEFAULT_EDITOR_PORT}).` },
+    },
+    async run({ args }) {
+        const context = loadProjectContext();
+        const tsc = projectBin(context.root, 'tsc');
+        const vite = projectBin(context.root, 'vite');
+        const gamePort = parsePort(args.port, DEFAULT_GAME_PORT, '--port');
+        const editorPort = parsePort(args['editor-port'], DEFAULT_EDITOR_PORT, '--editor-port');
+        if (gamePort === editorPort) {
+            throw new CliError('`--port` and `--editor-port` must differ — the game and the editor are two servers.');
+        }
+        // Build to completion first, exactly as `dev` does: every alias resolves into dist/, so serving
+        // before the first emit 404s every module.
+        console.log('Building…');
+        const build = spawnSync(tsc, [], { cwd: context.root, stdio: 'inherit' });
+        if (build.error) {
+            throw new CliError(`Could not run the TypeScript compiler: ${build.error.message}`);
+        }
+        if (build.status !== 0) {
+            throw new CliError('Build failed. Fix the errors above, then run `bitmagic edit` again.', build.status ?? 1);
+        }
+        // Before the children, so a port clash fails fast rather than after vite has claimed its port.
+        const editor = await startEditorServer({
+            root: context.root,
+            gameId: context.metadata.gameId,
+            gamePort,
+            port: editorPort,
+            log: (message) => console.log(message),
+        });
+        const children = [
+            {
+                name: 'tsc --watch',
+                process: spawn(tsc, ['--watch', '--preserveWatchOutput'], { cwd: context.root, stdio: 'inherit' }),
+            },
+            {
+                name: 'vite',
+                process: spawn(vite, ['--port', String(gamePort), '--strictPort'], { cwd: context.root, stdio: 'inherit' }),
+            },
+        ];
+        let shuttingDown = false;
+        let requestedByUser = false;
+        const shutdown = () => {
+            if (shuttingDown)
+                return;
+            shuttingDown = true;
+            for (const child of children)
+                child.process.kill('SIGTERM');
+            void editor.close();
+        };
+        process.on('SIGINT', () => {
+            requestedByUser = true;
+            shutdown();
+        });
+        process.on('SIGTERM', () => {
+            requestedByUser = true;
+            shutdown();
+        });
+        void waitForServer(gamePort, 30_000)
+            .then(() => {
+            console.log(`\nServing the game at ${`http://localhost:${gamePort}/`}`);
+            console.log(`Editor ready at      ${editor.url}`);
+            console.log('\nOpen the editor URL, click an object and drag the gizmo.');
+            console.log('Every change is saved to src/work/world.json.');
+        })
+            .catch(() => {
+            // The child-exit watcher below reports a vite that never comes up.
+        });
+        const failure = await new Promise((resolve) => {
+            let exitedCount = 0;
+            for (const child of children) {
+                child.process.on('error', (error) => {
+                    shutdown();
+                    resolve({ name: child.name, detail: `could not start: ${error.message}` });
+                });
+                child.process.on('exit', (code, signal) => {
+                    exitedCount += 1;
+                    if (!requestedByUser && !shuttingDown) {
+                        shutdown();
+                        resolve({ name: child.name, detail: `exited with code ${code}${signal ? ` (signal ${signal})` : ''}` });
+                    }
+                    else if (exitedCount === children.length) {
+                        resolve(undefined);
+                    }
+                });
+            }
+        });
+        await editor.close();
+        if (failure) {
+            throw new CliError(`${failure.name} ${failure.detail}. \`bitmagic edit\` stopped.`);
+        }
+    },
+});
+//# sourceMappingURL=edit.js.map

package/dist/commands/edit.js.map

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

package/dist/editor/save.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Turn the game engine's own scene-editing replies into a `WorldJsonModification[]`.
+ *
+ * This is the CLI lane's counterpart to the Creator's `useSave.ts saveSceneModifications` and the
+ * spawn-point/world-config half of `useTabSwitching.ts deactivateScene`. The web lane posts its
+ * modifications to `POST /api/edit-world-config`, which rebuilds `predicateField`/`predicateValue`
+ * into real predicates server-side because functions cannot cross HTTP. Here there is no server:
+ * the shell page posts the engine's replies VERBATIM to the local sidecar, and this module — which
+ * runs in Node, in the same process that writes the file — builds the predicates directly.
+ *
+ * That split is deliberate. Everything that knows what world.json means lives on this side, so it
+ * is plain, synchronous, dependency-free code that can be unit-tested without a browser; the shell
+ * stays a dumb relay of `SCENE_HAS_CHANGES` and `SCENE_EDITING_STATUS`.
+ */
+import type { WorldJsonModification, WorldJsonShape } from '@bitmagic/world-forger/pipeline/index.js';
+/** The engine's `SCENE_HAS_CHANGES` reply (`CreatorMessageHandler.ts`, `CHECK_SCENE_CHANGES`). */
+export interface SceneChangeReport {
+    hasChanges?: boolean;
+    modifiedObjectIds?: string[];
+    deletedObjectIds?: string[];
+    fullSaveNeeded?: boolean;
+    pendingWorldConfig?: {
+        settings: unknown;
+        path: string[];
+        title?: string;
+    } | null;
+    pendingSpawnPoints?: Array<Record<string, unknown>> | null;
+}
+/** The engine's `SCENE_EDITING_STATUS` reply (`CreatorMessageHandler.ts`, line ~1463). */
+export interface SceneEditingStatus {
+    unlocked?: boolean;
+    environmentObjects?: Array<Record<string, unknown>>;
+    /**
+     * WHICH level `environmentObjects` covers. `serializeEnvironmentObjects()` walks the LIVE scene
+     * and a multi-level game only instantiates one level, so a non-null id means the array is this
+     * level plus untagged globals — never the whole world. `null` (single-level or legacy) means it
+     * genuinely is the whole world.
+     */
+    activeLevelId?: string | null;
+    markers?: Array<Record<string, unknown>>;
+}
+/** What the shell POSTs to `/api/scene/save`. Just the two engine replies, plus one flag. */
+export interface ScenePayload {
+    changes: SceneChangeReport;
+    status: SceneEditingStatus;
+    /** Set by the shell when the engine posted `ADD_MARKER` / `UPDATE_MARKER` since the last save. */
+    markersDirty?: boolean;
+}
+/**
+ * Build the write for one scene-editing flush. Returns `[]` when there is nothing to persist, so
+ * the caller can skip the file write entirely.
+ *
+ * `world` is the CURRENT parsed world.json, needed only to resolve the levels registry. Everything
+ * else comes from the engine, which is the source of truth for scene state — this never invents a
+ * position, rotation or scale.
+ */
+export declare function buildSceneModifications(payload: ScenePayload, world: WorldJsonShape): WorldJsonModification[];

package/dist/editor/save.js

@@ -0,0 +1,144 @@
+/**
+ * `EditorManager.markFullSaveNeeded()` pushes this sentinel into the same `Set` that holds real
+ * object ids, so it arrives in `modifiedObjectIds` and must be filtered out before any id is
+ * matched against an object. `fullSaveNeeded` carries the actual signal.
+ */
+const FULL_SAVE_SENTINEL = '__FULL_SAVE__';
+/** Spawn markers are tracked in the same modified-id set but persist through `pendingSpawnPoints`. */
+const SPAWN_ID_PREFIX = 'spawn_';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Match an array item by its `id`, the predicate every environmentObjects write uses. */
+function byId(id) {
+    return (item) => isRecord(item) && item.id === id;
+}
+/**
+ * The spawn-point half, mirroring `useTabSwitching.ts deactivateScene` lines 234-303.
+ *
+ * The rule that matters: in a levels game the spawns belong to the ACTIVE level's entry, and the
+ * flat `spawnPoints` / `playerSpawn*` fields are only mirrored when that level is the start level.
+ * Published games carry frozen template code that reads only the flat fields, so the mirror cannot
+ * be dropped — but writing it from a non-start level would make the wrong level's spawn the one
+ * every published build uses.
+ */
+function spawnPointModifications(spawnPoints, activeLevelId, world) {
+    const player = spawnPoints.find((point) => point.type === 'player');
+    const globals = [
+        { type: 'set', path: ['spawnPoints'], value: spawnPoints },
+    ];
+    if (player?.position !== undefined) {
+        globals.push({ type: 'set', path: ['playerSpawnPosition'], value: player.position });
+    }
+    // Only when present: writing `undefined` would drop the key on stringify for a game that had a
+    // rotation before, silently resetting the player's facing.
+    if (player?.rotationY !== undefined) {
+        globals.push({ type: 'set', path: ['playerSpawnRotationY'], value: player.rotationY });
+    }
+    const levels = world.worldProfileData?.levels ?? [];
+    if (levels.length === 0)
+        return globals;
+    const firstLevel = levels[0];
+    if (firstLevel === undefined)
+        return globals;
+    const startLevelId = world.worldProfileData?.startLevelId ?? firstLevel.id;
+    const targetId = activeLevelId ?? startLevelId;
+    const level = levels.find((entry) => entry.id === targetId);
+    // No matching entry means the engine reported a level this world.json does not know about.
+    // Falling back to the globals keeps the edit rather than dropping it on the floor.
+    if (level === undefined)
+        return globals;
+    const levelModification = {
+        type: 'update',
+        path: ['levels'],
+        predicate: (item) => isRecord(item) && item.id === level.id,
+        // An updater rather than a `{ ...level, spawnPoints }` snapshot (which is what the Creator
+        // builds): the snapshot was read before the write and would silently revert any other field
+        // the agent changed on this level in between.
+        value: (item) => ({ ...(isRecord(item) ? item : {}), spawnPoints }),
+    };
+    return level.id === startLevelId ? [levelModification, ...globals] : [levelModification];
+}
+/**
+ * Build the write for one scene-editing flush. Returns `[]` when there is nothing to persist, so
+ * the caller can skip the file write entirely.
+ *
+ * `world` is the CURRENT parsed world.json, needed only to resolve the levels registry. Everything
+ * else comes from the engine, which is the source of truth for scene state — this never invents a
+ * position, rotation or scale.
+ */
+export function buildSceneModifications(payload, world) {
+    const { changes, status } = payload;
+    const environmentObjects = status.environmentObjects ?? [];
+    const activeLevelId = status.activeLevelId ?? null;
+    const deletedObjectIds = changes.deletedObjectIds ?? [];
+    const modifiedObjectIds = (changes.modifiedObjectIds ?? []).filter((id) => id !== FULL_SAVE_SENTINEL && !id.startsWith(SPAWN_ID_PREFIX));
+    const modifications = [];
+    // Deletions first: order is the contract for `applyModificationsToWorld`, and an id that is both
+    // deleted and re-added in the same flush must end up added.
+    for (const id of deletedObjectIds) {
+        modifications.push({
+            type: 'removeRoot',
+            path: ['environmentObjects'],
+            predicate: byId(id),
+        });
+    }
+    if (changes.fullSaveNeeded === true) {
+        if (activeLevelId === null) {
+            // The array genuinely is the whole world, so replacing it wholesale is safe — and it is the
+            // only form that can DROP an object the engine no longer has but never reported deleting.
+            modifications.push({
+                type: 'setRoot',
+                path: ['environmentObjects'],
+                value: environmentObjects,
+            });
+        }
+        else {
+            // Deliberate divergence from the Creator, which issues a `setRoot` here. In a levels game the
+            // array holds only the active level plus globals, so a `setRoot` deletes every other level's
+            // scenery. Upserting each object writes exactly what the engine reported and touches nothing
+            // else.
+            for (const object of environmentObjects) {
+                const id = object.id;
+                if (typeof id !== 'string')
+                    continue;
+                modifications.push({
+                    type: 'upsertRoot',
+                    path: ['environmentObjects'],
+                    predicate: byId(id),
+                    value: object,
+                });
+            }
+        }
+    }
+    else {
+        const modifiedIds = new Set(modifiedObjectIds);
+        for (const object of environmentObjects) {
+            const id = object.id;
+            if (typeof id !== 'string' || !modifiedIds.has(id))
+                continue;
+            modifications.push({
+                type: 'upsertRoot',
+                path: ['environmentObjects'],
+                predicate: byId(id),
+                value: object,
+            });
+        }
+    }
+    if (changes.pendingWorldConfig) {
+        const { path, settings } = changes.pendingWorldConfig;
+        if (Array.isArray(path) && path.length > 0) {
+            modifications.push({ type: 'set', path, value: settings });
+        }
+    }
+    if (changes.pendingSpawnPoints && changes.pendingSpawnPoints.length > 0) {
+        modifications.push(...spawnPointModifications(changes.pendingSpawnPoints, activeLevelId, world));
+    }
+    if (payload.markersDirty === true) {
+        // Whole-array `set` rather than push/update: `SCENE_EDITING_STATUS` returns the live
+        // `markerSystem.serializeMarkers()` output, which already reflects adds, edits and removals.
+        modifications.push({ type: 'set', path: ['markers'], value: status.markers ?? [] });
+    }
+    return modifications;
+}
+//# sourceMappingURL=save.js.map

package/dist/editor/save.js.map

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

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/scaffold/project-files.js

@@ -369,6 +369,18 @@ compile that dies on load — a missing asset, a bad \`world.json\` value, a nul
 \`bitmagic verify\` after a change you cannot eyeball: it loads the game in a headless browser and
 fails with what actually broke, leaving a console log and a screenshot in \`.bitmagic/verify/\`.
 
+## The human may be moving objects too
+
+\`bitmagic edit\` gives this project's owner a visual scene editor — they click an object and drag
+a gizmo, and the new transform is written straight into \`src/work/world.json\`, one entry per
+object touched. So \`world.json\` is shared ground, not yours alone:
+
+- **Re-read \`src/work/world.json\` before editing it.** The copy you read earlier in the session
+  may be stale, and a whole-file rewrite from that copy silently reverts what they just placed.
+- Prefer changing the entries you mean to change over regenerating \`environmentObjects\`
+  wholesale, so their placements survive your edit.
+- \`git diff src/work/world.json\` shows what they moved; there is no separate edit history.
+
 ## Publishing
 
 \`\`\`

package/dist/scaffold/project-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/scaffold/project-files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/scaffold/project-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,2BAA2B,EAAE,SAAS;IACtC,2BAA2B,EAAE,SAAS;IACtC,kBAAkB,EAAE,QAAQ;IAC5B,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,kCAAkC,EAAE,QAAQ;IAC5C,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,UAAU;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,aAAa,EAAE,UAAU;IACzB,cAAc,EAAE,UAAU;IAC1B,8FAA8F;IAC9F,cAAc,EAAE,QAAQ;IACxB,4FAA4F;IAC5F,mFAAmF;IACnF,eAAe,EAAE,SAAS;IAC1B,UAAU,EAAE,QAAQ;IACpB,IAAI,EAAE,QAAQ;IACd,wBAAwB,EAAE,QAAQ;CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG;IACjB,uBAAuB;IACvB,oCAAoC,aAAa,WAAW;IAC5D,kDAAkD,aAAa,2CAA2C;IAC1G,8CAA8C,aAAa,uCAAuC;IAClG,gDAAgD,aAAa,wCAAwC;CACtG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEX,oGAAoG;AACpG,MAAM,WAAW,GAA2B;IAC1C,2FAA2F;IAC3F,4FAA4F;IAC5F,4FAA4F;IAC5F,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,wBAAwB,aAAa,SAAS;IAC9D,WAAW,EAAE,wBAAwB,aAAa,MAAM;IACxD,2FAA2F;IAC3F,6FAA6F;IAC7F,+FAA+F;IAC/F,4FAA4F;IAC5F,6FAA6F;IAC7F,6FAA6F;IAC7F,eAAe,EAAE,yBAAyB,aAAa,UAAU;IACjE,qBAAqB,EAAE,yBAAyB,aAAa,gBAAgB;IAC7E,QAAQ,EAAE,wBAAwB,aAAa,GAAG;IAClD,2BAA2B,EAAE,iDAAiD;IAC9E,2BAA2B,EAAE,iDAAiD;IAC9E,OAAO,EAAE,+BAA+B;IACxC,kCAAkC,EAAE,uDAAuD;IAC3F,kBAAkB,EAAE,uCAAuC;IAC3D,MAAM,EAAE,6BAA6B;CACtC,CAAC;AAEF,sFAAsF;AACtF,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,UAAU,CAAC;QAChB,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,cAAc;YACrB,GAAG,EAAE,MAAM;SACZ;QACD,YAAY,EAAE,YAAY;QAC1B,eAAe,EAAE,gBAAgB;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC;QAChB,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;YACtB,OAAO,EAAE,GAAG;YACZ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,aAAa,EAAE;YACtB,gBAAgB,EAAE,SAAS;YAC3B,MAAM,EAAE,IAAI;YACZ,wBAAwB,EAAE,IAAI;YAC9B,0BAA0B,EAAE,KAAK;YACjC,oBAAoB,EAAE,IAAI;YAC1B,eAAe,EAAE,IAAI;YACrB,eAAe,EAAE,OAAO;YACxB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,4BAA4B,EAAE,IAAI;YAClC,gCAAgC,EAAE,IAAI;YACtC,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,IAAI;YACvB,SAAS,EAAE,IAAI;YACf,wFAAwF;YACxF,yFAAyF;YACzF,wFAAwF;YACxF,0FAA0F;YAC1F,sFAAsF;YACtF,yFAAyF;YACzF,gFAAgF;YAChF,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,SAAS,EAAE,CAAC,cAAc,EAAE,qBAAqB,EAAE,wCAAwC,CAAC;SAC7F;QACD,OAAO,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;QACpC,uFAAuF;QACvF,uFAAuF;QACvF,oFAAoF;QACpF,wFAAwF;QACxF,wDAAwD;QACxD,OAAO,EAAE;YACP,cAAc;YACd,MAAM;YACN,qBAAqB;YACrB,0BAA0B;YAC1B,kBAAkB;YAClB,uBAAuB;YACvB,oBAAoB;SACrB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,YAAY,EAAE,CAAC;IACpD,6FAA6F;IAC7F,yFAAyF;IACzF,MAAM,gBAAgB,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,iBAAiB,CAAC;IACrE,0FAA0F;IAC1F,0FAA0F;IAC1F,wFAAwF;IACxF,2FAA2F;IAC3F,mDAAmD;IACnD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BP,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;;;iCAG5B,gBAAgB;;;CAGhD,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB;IACzB,OAAO,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,UAAU,GAAG,OAAO,MAAM,GAAG,CAAC;SACrD,IAAI,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO;;;;;;;;;;;EAWP,OAAO;;;;;;;CAOR,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BP,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAiBD,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0NR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DR,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3B,OAAO;;EAEP,KAAK;QACH,CAAC,CAAC,8GAA8G;QAChH,CAAC,CAAC,0KAA0K;;;;EAI9K,KAAK,IAAI,iEAAiE;;;;;;;;;;;;;;CAc3E,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Build Bitmagic games from your own agent tool",
   "type": "module",
   "bin": {
@@ -19,8 +19,8 @@
     "citty": "^0.2.2",
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
-    "@bitmagic/asset-core": "0.1.1",
-    "@bitmagic/world-forger": "0.1.3"
+    "@bitmagic/world-forger": "0.1.3",
+    "@bitmagic/asset-core": "0.1.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",