@bitmagic/cli 0.1.1 → 0.1.3

package/dist/cli.d.ts

@@ -63,6 +63,36 @@ declare const rawCommands: {
         };
     }>;
     generate: CommandDef<ArgsDef>;
+    forge: CommandDef<{
+        readonly prompt: {
+            readonly type: "string";
+            readonly description: "Describe the level, e.g. \"a ruined desert temple with a central courtyard\".";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly description: "Name for the level. Derived from the prompt when omitted.";
+        };
+        readonly resume: {
+            readonly type: "string";
+            readonly description: "Resume a job id printed by an earlier run; completed steps are skipped.";
+        };
+        readonly city: {
+            readonly type: "boolean";
+            readonly description: "Build a city (street grid, buildings, landmarks).";
+        };
+        readonly dungeon: {
+            readonly type: "boolean";
+            readonly description: "Build an enclosed dungeon of rooms and corridors.";
+        };
+        readonly platformer: {
+            readonly type: "boolean";
+            readonly description: "Build a third-person platformer journey.";
+        };
+        readonly freeform: {
+            readonly type: "boolean";
+            readonly description: "Build a custom place (arena, fortress, camp).";
+        };
+    }>;
 };
 type CommandName = keyof typeof rawCommands;
 export declare const subCommands: Record<CommandName, CommandDef<ArgsDef>>;

package/dist/cli.js

@@ -8,6 +8,7 @@ import { checkCommand } from './commands/check.js';
 import { devCommand } from './commands/dev.js';
 import { verifyCommand } from './commands/verify.js';
 import { generateCommand } from './commands/generate.js';
+import { forgeCommand } from './commands/forge.js';
 // citty's runMain() catches every error thrown from a command's `run()` internally and calls
 // process.exit() itself — it never rejects the promise it returns, so the `.catch()` below
 // never runs for those. For anything that isn't citty's own internal CLIError class, its catch
@@ -18,6 +19,18 @@ import { generateCommand } from './commands/generate.js';
 // "every entry of subCommands is wrapped" structurally, by reference, instead of maintaining a
 // separate list of command names that could drift out of sync with the real map.
 const wrappedRuns = new WeakSet();
+/**
+ * The command's subcommand map, or `undefined` if it has none. Every `subCommands` value in this
+ * CLI is a plain synchronous object literal (never a citty Promise/function Resolvable), so
+ * narrowing it this way is safe for this codebase's actual usage even though citty's own type
+ * allows more.
+ */
+function subCommandsOf(command) {
+    const subs = command.subCommands;
+    if (!subs || typeof subs !== 'object')
+        return undefined;
+    return subs;
+}
 export function withCleanErrors(command) {
     const originalRun = command.run;
     const wrapped = { ...command };
@@ -43,12 +56,10 @@ export function withCleanErrors(command) {
     // unrecursed, a CliError thrown from one of those would clear this command's own (nonexistent)
     // run untouched and hit citty's default handling instead — a raw stack trace, the exact thing
     // this wrapper exists to prevent. Recurse so every depth gets the same clean single-line
-    // treatment. Every subCommands value in this CLI is a plain synchronous object literal (never a
-    // citty Promise/function Resolvable), so narrowing it that way here is safe for this codebase's
-    // actual usage even though citty's own type allows more.
-    if (command.subCommands && typeof command.subCommands === 'object') {
-        const rawSubCommands = command.subCommands;
-        wrapped.subCommands = Object.fromEntries(Object.entries(rawSubCommands).map(([name, sub]) => [name, withCleanErrors(sub)]));
+    // treatment.
+    const subs = subCommandsOf(command);
+    if (subs) {
+        wrapped.subCommands = Object.fromEntries(Object.entries(subs).map(([name, sub]) => [name, withCleanErrors(sub)]));
     }
     return wrapped;
 }
@@ -62,11 +73,11 @@ export function isWrappedWithCleanErrors(command) {
     if (command.run !== undefined) {
         return wrappedRuns.has(command.run);
     }
-    if (command.subCommands && typeof command.subCommands === 'object') {
-        const entries = Object.values(command.subCommands);
-        return entries.length > 0 && entries.every((sub) => isWrappedWithCleanErrors(sub));
-    }
-    return false;
+    const subs = subCommandsOf(command);
+    if (!subs)
+        return false;
+    const entries = Object.values(subs);
+    return entries.length > 0 && entries.every((sub) => isWrappedWithCleanErrors(sub));
 }
 // Wrapping happens once here, over the whole map, rather than per-entry at each call site —
 // a future command added to `rawCommands` is wrapped automatically, so there is no per-command
@@ -80,6 +91,7 @@ const rawCommands = {
     dev: devCommand,
     verify: verifyCommand,
     generate: generateCommand,
+    forge: forgeCommand,
 };
 export const subCommands = Object.fromEntries(Object.entries(rawCommands).map(([name, command]) => [name, withCleanErrors(command)]));
 // This module only builds `main` and exports it (along with `subCommands` and `withCleanErrors`)

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/forge.d.ts

@@ -0,0 +1,107 @@
+import { type ForgeJobInput } from '@bitmagic/world-forger/pipeline/index.js';
+/** The four scene approaches the forger supports. Exactly one may be chosen; none = terrain. */
+declare const MODE_FLAGS: readonly ["city", "dungeon", "platformer", "freeform"];
+type ModeFlag = (typeof MODE_FLAGS)[number];
+/**
+ * The level's name. Always sent EXPLICITLY to the server, even when derived: api-server's
+ * `resolveLevelName` falls back to its own derivation from the prompt when `name` is absent, and
+ * this lane also freezes an `input` artifact locally (see `seedForgeStore`). Two independent
+ * derivations of the same name would be a drift waiting to happen, so the CLI decides once and
+ * the server receives the answer rather than recomputing it.
+ */
+export declare function deriveLevelName(explicit: string | undefined, prompt: string): string;
+/** The single selected mode, or undefined for plain terrain. */
+export declare function selectMode(args: Record<string, unknown>): ModeFlag | undefined;
+/**
+ * Resolve the frozen request for this run.
+ *
+ * On a fresh run it comes from the flags. On a resume it comes from the job's LOCAL frozen
+ * `input` artifact where one exists, so the resumed request re-sends exactly what the original
+ * sent — which also lets `--resume` stand alone, without repeating the prompt. api-server freezes
+ * its own copy and never overwrites it, so a resume that did send different flags would produce a
+ * level whose geometry came from the original design but whose name and prompt came from the new
+ * invocation. Reading the frozen copy back removes that divergence rather than documenting it.
+ */
+export declare function resolveJobInput(options: {
+    frozen: ForgeJobInput | null;
+    prompt: string | undefined;
+    name: string | undefined;
+    mode: ModeFlag | undefined;
+    gameId: string;
+    resumeJobId: string | null;
+}): ForgeJobInput;
+/** The request body for `POST /api/cli/v1/forge/stream`. */
+export declare function buildForgeRequestBody(input: ForgeJobInput, resumeJobId: string | null): Record<string, unknown>;
+export interface ForgeRunDeps {
+    fetch: typeof globalThis.fetch;
+    sleep: (ms: number) => Promise<void>;
+    now?: () => number;
+    /** Test-only override; production omits it and loadProjectContext walks up from process.cwd(). */
+    startDir?: string;
+    /** Test-only override; production omits it and the credential helpers read ~/.bitmagic. */
+    baseDir?: string;
+    log: (message: string) => void;
+}
+/**
+ * The whole command. Failure wording is the contract here — see the file header.
+ *
+ *  - Anything before step 5's apply leaves world.json untouched, and says so.
+ *  - A server-side failure additionally says whether resuming can help; see
+ *    `classifyForgeFailure`, which is the difference between "try again" and "change your prompt".
+ *  - A failure AFTER the design and geometry landed but before (or during) the local write is the
+ *    expensive case: the forge has been billed, and the message says the work is saved under a job
+ *    id rather than lost.
+ */
+export declare function runForge(args: {
+    prompt?: string;
+    name?: string;
+    resume?: string;
+} & Record<string, unknown>, deps?: ForgeRunDeps): Promise<void>;
+/**
+ * Decorate a steps 3-5 failure with the job id, REGARDLESS of its class.
+ *
+ * The class check `generate.ts` uses would be wrong here, and the difference is not stylistic:
+ * steps 3-5 come from `@bitmagic/world-forger` and throw plain `Error`/`ForgeStepError`, not
+ * `CliError` — the bake timeout (`voxelize-level.ts`), the placement timeout
+ * (`place-and-persist-level.ts`), a missing artifact (`artifact-store.ts`) and the archetype
+ * timeout (`create-level-archetypes.ts`) are all third-party classes. Passing those through
+ * untouched sends them past `withCleanErrors` into citty's raw stack dump, with no job id and no
+ * world.json statement — in the exact window where the design and geometry are already paid for.
+ * A creator seeing `Error: Level voxelization timed out` and a stack has no way to know that
+ * resuming is free, and will re-run with `--prompt` and pay for a second design.
+ *
+ * `generate.ts` gets away with the class check only because nothing in its span throws a
+ * third-party error class.
+ */
+export declare function decorateBrowserStepError(error: unknown, jobId: string): unknown;
+export declare const forgeCommand: import("citty").CommandDef<{
+    readonly prompt: {
+        readonly type: "string";
+        readonly description: "Describe the level, e.g. \"a ruined desert temple with a central courtyard\".";
+    };
+    readonly name: {
+        readonly type: "string";
+        readonly description: "Name for the level. Derived from the prompt when omitted.";
+    };
+    readonly resume: {
+        readonly type: "string";
+        readonly description: "Resume a job id printed by an earlier run; completed steps are skipped.";
+    };
+    readonly city: {
+        readonly type: "boolean";
+        readonly description: "Build a city (street grid, buildings, landmarks).";
+    };
+    readonly dungeon: {
+        readonly type: "boolean";
+        readonly description: "Build an enclosed dungeon of rooms and corridors.";
+    };
+    readonly platformer: {
+        readonly type: "boolean";
+        readonly description: "Build a third-person platformer journey.";
+    };
+    readonly freeform: {
+        readonly type: "boolean";
+        readonly description: "Build a custom place (arena, fortress, camp).";
+    };
+}>;
+export {};

package/dist/commands/forge.js

@@ -0,0 +1,393 @@
+/**
+ * `bitmagic forge` — design, build and install a playable level, in one command.
+ *
+ * Five steps, split across two hosts:
+ *
+ *   1. design the scene with an LLM  ┐ api-server, over `POST /api/cli/v1/forge/stream`
+ *   2. forge geometry + upload GLBs  ┘ (paid, and the private half of the forger)
+ *   3. create the archetype assets   ┐
+ *   4. bake the level to voxels      ├ HERE, driving a headless Chrome that runs the real engine
+ *   5. place instances + persist     ┘
+ *
+ * Steps 3-5 are not pure compute: they drive the game engine over `postMessage`, and the round
+ * trip through the engine is the only source of the instance ids step 5 persists. So this command
+ * builds the project, serves it, opens it in Chrome, and runs the shared pipeline against that
+ * page — then applies what step 5 returns to the project's own world.json.
+ *
+ * Every failure path states explicitly whether world.json changed. A creator (or the agent driving
+ * this CLI) who does not know has to go and look, and a forge costs enough that "did I pay for
+ * nothing, and is my project still intact?" is the first question.
+ */
+import { defineCommand } from 'citty';
+import { spawn, spawnSync } from 'child_process';
+import { createForgedWorkStore, } from '@bitmagic/world-forger/pipeline/index.js';
+import { CliError } from '../errors.js';
+import { loadProjectContext, projectBin } from '../project/context.js';
+import { resolveEnvironment, resolveAuth0ClientId } from '../config/environments.js';
+import { readDefaultEnvironment } from '../config/credentials.js';
+import { getAccessToken } from '../auth/session.js';
+import { waitForServer } from '../verify/wait-for-server.js';
+import { ForgeBrowserHost, readProjectGameData } from '../forge/browser-host.js';
+import { startUploadProxy } from '../forge/upload-proxy.js';
+import { reserveCorsAllowedPort, CORS_ALLOWED_PORT_MIN, CORS_ALLOWED_PORT_MAX } from '../local-port.js';
+import { createBakeProgressPrinter } from '../forge/bake-progress.js';
+import { createLocalForgeStorage } from '../forge/local-store.js';
+import { describeForgeFailure, requestForge } from '../forge/stream.js';
+import { buildCliForgeDeps, createConsoleForgeLogger, readFrozenInput, runForgePipeline, seedForgeStore, } from '../forge/run-pipeline.js';
+/** Mirrors api-server's `FORGE_JOB_ID_PATTERN` so a typo is rejected here, before a round trip. */
+const JOB_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+/**
+ * The command that resumes a job. One definition because `decorateBrowserStepError` decides
+ * whether to append its advice by looking for this exact string — two spellings would make that
+ * check silently miss.
+ */
+function resumeCommand(jobId) {
+    return `bitmagic forge --resume ${jobId}`;
+}
+/** The four scene approaches the forger supports. Exactly one may be chosen; none = terrain. */
+const MODE_FLAGS = ['city', 'dungeon', 'platformer', 'freeform'];
+/** `cityMode`, `dungeonMode`, … — the body fields `ForgeJobInput` declares. */
+function modeField(mode) {
+    return `${mode}Mode`;
+}
+/**
+ * The level's name. Always sent EXPLICITLY to the server, even when derived: api-server's
+ * `resolveLevelName` falls back to its own derivation from the prompt when `name` is absent, and
+ * this lane also freezes an `input` artifact locally (see `seedForgeStore`). Two independent
+ * derivations of the same name would be a drift waiting to happen, so the CLI decides once and
+ * the server receives the answer rather than recomputing it.
+ */
+export function deriveLevelName(explicit, prompt) {
+    if (explicit !== undefined && explicit.trim().length > 0)
+        return explicit.trim();
+    const derived = prompt.trim().split(/\s+/).slice(0, 6).join(' ').slice(0, 48).trim();
+    return derived.length > 0 ? derived : 'level';
+}
+/** The single selected mode, or undefined for plain terrain. */
+export function selectMode(args) {
+    const chosen = MODE_FLAGS.filter((mode) => args[mode] === true);
+    if (chosen.length > 1) {
+        // No "world.json is unchanged." here: `prepareForgeRequest` appends it to every CliError
+        // raised in the pre-request span, so stating it again would print it twice.
+        throw new CliError(`Choose at most one scene type — got ${chosen.map((m) => `--${m}`).join(' and ')}. `
+            + 'Omit them all for natural terrain.');
+    }
+    return chosen[0];
+}
+/**
+ * A free port INSIDE the CORS-allowed window, never an OS-assigned ephemeral one.
+ *
+ * The bake browser itself would not care — it runs with `--disable-web-security`. The project
+ * served here outlives the bake though: this is the same build a creator then loads with
+ * `bitmagic dev` or `bitmagic verify` in an ordinary browser, and from an out-of-window origin the
+ * CDN refuses the forged `.vwld`, the engine initialises an empty voxel world, and the level has
+ * no terrain to stand on. See local-port.ts.
+ */
+async function freePort() {
+    const port = await reserveCorsAllowedPort();
+    if (port === null) {
+        throw new CliError(`No free port between ${CORS_ALLOWED_PORT_MIN} and ${CORS_ALLOWED_PORT_MAX}, which is the `
+            + 'range the asset CDN allows as an origin. Stop whatever is holding them and forge again.');
+    }
+    return port;
+}
+/**
+ * Resolve the frozen request for this run.
+ *
+ * On a fresh run it comes from the flags. On a resume it comes from the job's LOCAL frozen
+ * `input` artifact where one exists, so the resumed request re-sends exactly what the original
+ * sent — which also lets `--resume` stand alone, without repeating the prompt. api-server freezes
+ * its own copy and never overwrites it, so a resume that did send different flags would produce a
+ * level whose geometry came from the original design but whose name and prompt came from the new
+ * invocation. Reading the frozen copy back removes that divergence rather than documenting it.
+ */
+export function resolveJobInput(options) {
+    const { frozen, prompt, name, mode, gameId, resumeJobId } = options;
+    if (frozen !== null && prompt === undefined)
+        return frozen;
+    if (prompt === undefined || prompt.trim().length === 0) {
+        throw new CliError(resumeJobId === null
+            ? '--prompt is required. Describe the level you want, e.g. `bitmagic forge --prompt "a ruined desert temple with a central courtyard"`.'
+            : `This machine has no saved record of job "${resumeJobId}" (it was started elsewhere, or `
+                + '`.bitmagic/` was cleared), so --prompt is required to resume it. Pass the SAME prompt '
+                + 'the original run used — the server forges what it froze, but the level name and '
+                + 'description saved into world.json come from this invocation.');
+    }
+    const trimmed = prompt.trim();
+    return {
+        name: deriveLevelName(name, trimmed),
+        prompt: trimmed,
+        gameId,
+        ...(mode ? { [modeField(mode)]: true } : {}),
+    };
+}
+/** The request body for `POST /api/cli/v1/forge/stream`. */
+export function buildForgeRequestBody(input, resumeJobId) {
+    return {
+        ...input,
+        ...(resumeJobId !== null ? { jobId: resumeJobId } : {}),
+    };
+}
+/** Print the level the forge produced, and what to do next. */
+function reportSummary(summary, changes, log) {
+    log('');
+    log(`Level "${summary.asset_name}" is in your project.`);
+    for (const line of changes)
+        log(`  - ${line}`);
+    const { x, y, z } = summary.player_start;
+    log(`Player start: (${x.toFixed(1)}, ${y.toFixed(1)}, ${z.toFixed(1)})`);
+    if (summary.library_assets.length > 0) {
+        log(`Library assets: ${summary.library_assets.map((a) => `${a.name} x${a.instances}`).join(', ')}`);
+    }
+    if (summary.markers.length > 0) {
+        log(`Markers: ${summary.markers.map((m) => m.name).join(', ')}`);
+    }
+    log('');
+    log('Run `bitmagic dev` and walk the level to check it.');
+}
+function defaultDeps() {
+    return {
+        fetch: globalThis.fetch,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        log: (message) => console.log(message),
+    };
+}
+/** Build the project to completion. Every alias resolves into dist/, so serving before the first
+ *  emit 404s every module — a failure that reads as "the engine is broken", not "not built". */
+function buildProject(context, log) {
+    const tsc = projectBin(context.root, 'tsc');
+    log('Building the project…');
+    const build = spawnSync(tsc, [], { cwd: context.root, stdio: 'inherit' });
+    if (build.error) {
+        throw new CliError(`Could not run the TypeScript compiler: ${build.error.message} world.json is unchanged.`);
+    }
+    if (build.status !== 0) {
+        throw new CliError('Build failed, so the game cannot be loaded to bake the level. Fix the errors above and '
+            + 'resume this forge — world.json is unchanged.', build.status ?? 1);
+    }
+}
+/**
+ * Steps 3-5: serve the project, drive a headless Chrome through it, and apply the result.
+ *
+ * Split out so the browser + server lifecycle has exactly one `finally` that owns tearing both
+ * down, however this exits — an orphaned vite on a random port and a headless Chrome holding a
+ * temp profile are both silent, and both outlive the terminal.
+ */
+async function runBrowserSteps(options) {
+    const { context, environment, jobId, token, deps } = options;
+    const { log } = deps;
+    buildProject(context, log);
+    const port = await freePort();
+    const vite = projectBin(context.root, 'vite');
+    let server;
+    let host;
+    let uploadProxy;
+    try {
+        server = spawn(vite, ['--port', String(port), '--strictPort'], {
+            cwd: context.root,
+            stdio: ['ignore', 'ignore', 'pipe'],
+        });
+        let viteStderr = '';
+        server.stderr?.on('data', (chunk) => {
+            viteStderr += String(chunk);
+        });
+        try {
+            await waitForServer(port, 30_000);
+        }
+        catch {
+            throw new CliError(`The project's dev server did not come up on port ${port}, so the level cannot be baked.`
+                + (viteStderr.trim() ? `\n${viteStderr.trim()}` : '')
+                + `\nFix that, then resume with \`${resumeCommand(jobId)}\`. world.json is unchanged.`);
+        }
+        log(`Serving the project on http://localhost:${port}/ for the bake.`);
+        uploadProxy = await startUploadProxy({
+            apiUrl: environment.apiUrl,
+            token,
+            gameId: context.metadata.gameId,
+            log,
+        });
+        host = new ForgeBrowserHost({
+            gamePort: port,
+            gameId: context.metadata.gameId,
+            gameData: readProjectGameData(context.root, context.metadata),
+            // api-server, NOT game-play-agent: the engine reads this back as `window.AI_AGENT_URL` and
+            // uses it to reach `POST /api/cli/v1/uploads/signed-url` for every GLB and .vwld it writes.
+            // The LOCAL proxy, not api-server directly. The engine calls a hardcoded
+            // `${agentUrl}/api/generate-upload-url` with no Authorization header, which api-server
+            // neither serves nor would accept unauthenticated — see forge/upload-proxy.ts.
+            agentUrl: uploadProxy.url,
+            log,
+        });
+        await host.launch();
+        await host.loadGame();
+        // The bake's own chunk counts, throttled. Subscribed before the pipeline starts so no
+        // progress is missed, and left subscribed for the whole run — steps 3 and 5 post no
+        // progress of this type, so there is nothing for it to pick up outside the bake.
+        const stopBakeProgress = host.onPageMessage(createBakeProgressPrinter(log));
+        const storage = createLocalForgeStorage(context.root);
+        const store = createForgedWorkStore(jobId, storage);
+        const forgeDeps = buildCliForgeDeps({
+            projectRoot: context.root,
+            storage,
+            transport: host.transport,
+            logger: createConsoleForgeLogger(log),
+        });
+        try {
+            const result = await runForgePipeline({
+                projectRoot: context.root,
+                store,
+                deps: forgeDeps,
+                log,
+            });
+            if (result.applied) {
+                reportSummary(result.summary, result.changes, log);
+            }
+            else {
+                log(`Level "${result.summary.asset_name}" was already applied to world.json by an earlier run.`);
+            }
+        }
+        finally {
+            stopBakeProgress();
+        }
+    }
+    finally {
+        await host?.close().catch(() => {
+            // Closing a browser that already died is not a forge failure, and letting it mask the real
+            // error would be. The temp profile directory is under the OS temp dir either way.
+        });
+        server?.kill('SIGTERM');
+        await uploadProxy?.close().catch(() => {
+            // Same reasoning as the browser above: a proxy that is already down must not mask the real
+            // failure. It is a loopback listener in this process either way.
+        });
+    }
+}
+/**
+ * The whole command. Failure wording is the contract here — see the file header.
+ *
+ *  - Anything before step 5's apply leaves world.json untouched, and says so.
+ *  - A server-side failure additionally says whether resuming can help; see
+ *    `classifyForgeFailure`, which is the difference between "try again" and "change your prompt".
+ *  - A failure AFTER the design and geometry landed but before (or during) the local write is the
+ *    expensive case: the forge has been billed, and the message says the work is saved under a job
+ *    id rather than lost.
+ */
+export async function runForge(args, deps = defaultDeps()) {
+    const prepared = await prepareForgeRequest(args, deps);
+    const { context, environment, storage, input, resumeJobId, token } = prepared;
+    deps.log(resumeJobId !== null
+        ? `Resuming forge job ${resumeJobId} for game ${context.metadata.gameId}.`
+        : `Forging a level for game ${context.metadata.gameId}: "${input.prompt}"`);
+    deps.log('[1-2/5] Designing the scene and forging its geometry (this runs on the server)…');
+    const outcome = await requestForge(environment, token, buildForgeRequestBody(input, resumeJobId), { fetch: deps.fetch, onProgress: (message) => deps.log(`  ${message}`) });
+    if (!outcome.success) {
+        throw new CliError(describeForgeFailure(outcome));
+    }
+    const { jobId, artifact, platformerMovement } = outcome;
+    deps.log(`[1-2/5] Geometry forged (job ${jobId}).`);
+    // From here on the design and the geometry are PAID FOR and saved server-side. Every failure
+    // below must therefore point at the resume rather than at re-running from scratch.
+    await seedForgeStore(createForgedWorkStore(jobId, storage), artifact, input, platformerMovement);
+    try {
+        await runBrowserSteps({ context, environment, jobId, token, deps });
+    }
+    catch (error) {
+        throw decorateBrowserStepError(error, jobId);
+    }
+}
+async function prepareForgeRequest(args, deps) {
+    try {
+        const context = loadProjectContext(deps.startDir);
+        const mode = selectMode(args);
+        const resumeJobId = typeof args.resume === 'string' && args.resume.length > 0 ? args.resume : null;
+        if (resumeJobId !== null && !JOB_ID_PATTERN.test(resumeJobId)) {
+            throw new CliError('--resume takes a job id of 1-64 characters (letters, digits, "_" or "-") — the one printed '
+                + 'by the run you are resuming.');
+        }
+        const storage = createLocalForgeStorage(context.root);
+        const frozen = resumeJobId !== null ? await readFrozenInput(storage, resumeJobId) : null;
+        const input = resolveJobInput({
+            frozen,
+            prompt: args.prompt,
+            name: args.name,
+            mode,
+            gameId: context.metadata.gameId,
+            resumeJobId,
+        });
+        const environment = resolveEnvironment({ storedDefault: readDefaultEnvironment(deps.baseDir) });
+        const clientId = resolveAuth0ClientId(environment);
+        const token = await getAccessToken(environment, clientId, { fetch: deps.fetch, sleep: deps.sleep, now: deps.now }, deps.baseDir);
+        return { context, environment, storage, input, resumeJobId, token };
+    }
+    catch (error) {
+        // Only a CliError is decorated, exactly as `generate.ts` does: anything else is a genuine bug
+        // rather than a condition we designed a message for, and citty's stack trace is the right
+        // output for it. (The one plain-Error condition worth naming in this span — a `.bitmagic/`
+        // that cannot be created — raises a CliError of its own in `createLocalForgeStorage`.)
+        //
+        // Deliberately UNLIKE the steps 3-5 boundary below, which decorates every error class. The
+        // difference is what is at stake: nothing has been spent yet here, so a stack trace costs a
+        // creator only clarity, whereas after the forge is billed it costs them a second design.
+        throw error instanceof CliError
+            ? new CliError(`${error.message} world.json is unchanged.`, error.exitCode)
+            : error;
+    }
+}
+/**
+ * Decorate a steps 3-5 failure with the job id, REGARDLESS of its class.
+ *
+ * The class check `generate.ts` uses would be wrong here, and the difference is not stylistic:
+ * steps 3-5 come from `@bitmagic/world-forger` and throw plain `Error`/`ForgeStepError`, not
+ * `CliError` — the bake timeout (`voxelize-level.ts`), the placement timeout
+ * (`place-and-persist-level.ts`), a missing artifact (`artifact-store.ts`) and the archetype
+ * timeout (`create-level-archetypes.ts`) are all third-party classes. Passing those through
+ * untouched sends them past `withCleanErrors` into citty's raw stack dump, with no job id and no
+ * world.json statement — in the exact window where the design and geometry are already paid for.
+ * A creator seeing `Error: Level voxelization timed out` and a stack has no way to know that
+ * resuming is free, and will re-run with `--prompt` and pay for a second design.
+ *
+ * `generate.ts` gets away with the class check only because nothing in its span throws a
+ * third-party error class.
+ */
+export function decorateBrowserStepError(error, jobId) {
+    const message = error instanceof Error ? error.message : String(error);
+    // Skip only when the message already carries the RESUME COMMAND (the dev-server failure prints
+    // its own), never merely the job id. The shared package puts the jobId in its own text —
+    // `artifact-store.ts` says `… missing for job <jobId> — cannot continue` — so a bare
+    // `includes(jobId)` check would silently drop the advice from exactly the third-party errors
+    // this function exists to decorate.
+    if (message.includes(resumeCommand(jobId)))
+        return error;
+    const exitCode = error instanceof CliError ? error.exitCode : 1;
+    return new CliError(`${message}\nThe scene design and geometry for this level are saved and already billed — `
+        + `resume from them with \`${resumeCommand(jobId)}\` rather than starting a new `
+        + 'forge. Nothing already completed will be re-run or re-billed.', exitCode);
+}
+export const forgeCommand = defineCommand({
+    meta: {
+        name: 'forge',
+        description: 'Design, build and install a whole playable level from a prompt.',
+    },
+    args: {
+        prompt: {
+            type: 'string',
+            description: 'Describe the level, e.g. "a ruined desert temple with a central courtyard".',
+        },
+        name: {
+            type: 'string',
+            description: 'Name for the level. Derived from the prompt when omitted.',
+        },
+        resume: {
+            type: 'string',
+            description: 'Resume a job id printed by an earlier run; completed steps are skipped.',
+        },
+        city: { type: 'boolean', description: 'Build a city (street grid, buildings, landmarks).' },
+        dungeon: { type: 'boolean', description: 'Build an enclosed dungeon of rooms and corridors.' },
+        platformer: { type: 'boolean', description: 'Build a third-person platformer journey.' },
+        freeform: { type: 'boolean', description: 'Build a custom place (arena, fortress, camp).' },
+    },
+    async run({ args }) {
+        await runForge(args);
+    },
+});
+//# sourceMappingURL=forge.js.map

package/dist/commands/forge.js.map

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