@bitmagic/cli 0.1.18 → 0.1.20

package/dist/editor/server.js

@@ -0,0 +1,306 @@
+/**
+ * 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';
+import { deriveSceneEvents, EditorJournal } from './journal.js';
+import { findPropAsset } from '../generate/prop.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 isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * The command the agent should run to fulfil an HQ request. One definition, quoted for a shell,
+ * so the journal line, the HTTP reply and the editor's own confirmation cannot drift apart.
+ */
+export function hqCommand(assetId, prompt) {
+    const quoted = prompt.replace(/"/g, '\\"');
+    return `bitmagic generate prop --asset ${assetId} --prompt "${quoted}" --json`;
+}
+/**
+ * Whether `bitmagic generate prop` could actually regenerate this asset. Answered by the command's
+ * own precondition (`findPropAsset`), so the two cannot disagree about what is regenerable.
+ */
+function hasFitBox(worldPath, assetId) {
+    try {
+        findPropAsset(JSON.parse(fs.readFileSync(worldPath, 'utf-8')), assetId);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+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 });
+    const journal = new EditorJournal({ root: options.root, log });
+    /** 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;
+        let events;
+        try {
+            // One read serves both: the modification builder needs the levels registry, and the journal
+            // needs the pre-edit transforms to report what each object moved FROM.
+            const before = readWorld(worldPath);
+            modifications = buildSceneModifications(payload, before);
+            events = deriveSceneEvents(before, payload);
+        }
+        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);
+            // Journalled AFTER the write lands, never before: an agent reading a `object.moved` line
+            // must be able to trust that world.json already says so.
+            journal.append(...events);
+            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 });
+        }
+    };
+    /**
+     * The "Generate high-quality version" button.
+     *
+     * The editor deliberately does not run the generation. Producing the mesh means calling the
+     * Asset Forger with credentials that are server-side only and never reach a creator's machine,
+     * so the editor's job is to capture the human's INTENT precisely and hand it to the agent, which
+     * is the thing in this lane that runs long, paid jobs.
+     *
+     * The confirmed text is saved onto the asset before anything else. That mirrors the Creator, and
+     * for the same reason: a forger placeholder often carries no description at all, and the
+     * description the human just wrote is worth keeping whether or not a generation ever follows.
+     */
+    const handleHqRequest = async (req, res) => {
+        let body;
+        try {
+            body = JSON.parse(await readBody(req));
+        }
+        catch {
+            sendJson(res, 400, { ok: false, error: 'Request body must be JSON' });
+            return;
+        }
+        const { assetId, prompt } = body;
+        if (typeof assetId !== 'string' || typeof prompt !== 'string' || prompt.trim() === '') {
+            sendJson(res, 400, { ok: false, error: 'assetId and a non-empty prompt are required' });
+            return;
+        }
+        const assetName = typeof body.assetName === 'string' && body.assetName !== '' ? body.assetName : assetId;
+        const description = prompt.trim();
+        try {
+            applyModificationsToWorld(worldPath, [{
+                    type: 'updateRoot',
+                    path: ['assets'],
+                    predicate: (item) => isRecord(item) && item.id === assetId,
+                    // An updater, not a replacement: the asset carries fitBox, sourceGlbUrl and the rest, and
+                    // the generation the agent runs later depends on every one of them.
+                    value: (item) => ({ ...(isRecord(item) ? item : {}), description }),
+                }]);
+            lastWrittenMtimeMs = worldMtimeMs(worldPath);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            log(`[editor] could not save the description for ${assetId}: ${message}`);
+            sendJson(res, 422, { ok: false, error: message });
+            return;
+        }
+        // Only forge-baked assets carry a fitBox, and without one there is no envelope to voxelize
+        // to — `bitmagic generate prop` refuses. The engine offers its button on any asset flagged
+        // `placeholder`, so that combination is reachable, and handing the agent a command that cannot
+        // succeed is worse than saying so. The description is kept either way: it is what the human
+        // meant this object to be, and the asset agent reads it.
+        const generatable = hasFitBox(worldPath, assetId);
+        if (!generatable) {
+            log(`[editor] ${assetName} has no fitBox — description saved, but it cannot be regenerated.`);
+            sendJson(res, 200, {
+                ok: true,
+                canGenerate: false,
+                reason: 'This asset has no fitBox, so there is no size to generate it to. '
+                    + 'Only forge-baked assets can be regenerated.',
+                worldMtimeMs: lastWrittenMtimeMs,
+            });
+            return;
+        }
+        journal.append({
+            event: 'hq.requested',
+            assetId,
+            assetName,
+            prompt: description,
+            command: hqCommand(assetId, description),
+        });
+        sendJson(res, 200, {
+            ok: true,
+            canGenerate: true,
+            command: hqCommand(assetId, description),
+            worldMtimeMs: lastWrittenMtimeMs,
+        });
+    };
+    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;
+            }
+            if (req.method === 'POST' && url === '/api/editor/hq-request') {
+                await handleHqRequest(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);
+    });
+    const url = `http://localhost:${options.port}/`;
+    journal.append({
+        event: 'session.started',
+        gameId: options.gameId,
+        gameUrl: `http://localhost:${options.gamePort}/`,
+        editorUrl: url,
+    });
+    return {
+        url,
+        journalPath: journal.path,
+        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;