@bitmagic/cli 0.1.15 → 0.1.17

package/README.md

@@ -18,6 +18,7 @@ bitmagic --version
 bitmagic login             # device-code auth in your browser
 bitmagic init my-game      # scaffold a new project into ./my-game
 cd my-game
+bitmagic cover              # generate cover art from GAME-DESIGN.md
 bitmagic check              # typecheck against the vendored engine
 bitmagic dev                 # build, then serve with live rebuilds
 bitmagic verify              # boot the game in a real browser and report what broke
@@ -31,14 +32,15 @@ bitmagic publish              # verify-gate, build, and ship — private by defa
 | `bitmagic login [--env <env>]` | Device-code auth against Auth0; stores credentials per environment. |
 | `bitmagic logout [--env <env>]` | Remove stored credentials for an environment. |
 | `bitmagic whoami [--env <env>]` | Show the identity the CLI is authenticated as. |
-| `bitmagic init [dir] [--template <id>] [--name <name>] [--env <env>] [--force]` | Scaffold a new project: mints a game, downloads the vendored engine, writes `AGENTS.md` and templates. |
+| `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 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.** |
-| `bitmagic upgrade [--engine <version>] [--force]` | Refresh vendored platform files to the currently published engine. Refuses a dirty git tree unless `--force`. |
+| `bitmagic upgrade [--engine <version>] [--force]` | Refresh vendored platform files and the CLI's own skills to the currently published engine. Refuses a dirty git tree unless `--force`. |
 | `bitmagic generate <skybox\|sound\|image\|character\|animation> ...` | Generate one asset directly into `src/work/world.json`. Costs sparks. |
+| `bitmagic cover [--prompt "..."] [--force] [--no-start-screen]` | Generate the game's cover art from `GAME-DESIGN.md`: sets the start screen, saves `.bitmagic/cover.webp`, becomes the publish thumbnail. Costs sparks. |
 | `bitmagic forge --prompt "..." [--city\|--dungeon\|--platformer\|--freeform] [--name <name>] [--resume <jobId>]` | Design and bake a whole playable level into `world.json`. Slow and expensive; supports `--resume`. |
 
 Every command exits non-zero on failure with a single-line message (no stack trace) and, where a
@@ -56,16 +58,35 @@ my-game/
   src/work/          # your game — Game.ts, game.json, world.json
   engine/             # vendored engine, read-only, replaced wholesale by `bitmagic upgrade`
   AGENTS.md            # guidance for the agent editing this project
+  GAME-DESIGN.md        # what the game is — yours to write; bitmagic cover reads it
   .bitmagic/
+    cover.webp           # bitmagic cover's artwork — the publish thumbnail when present
+    cover.json            # its URL and the design hash it was generated from
     build/
-      index.html        # bitmagic build's output bundle
-      manifest.json      # engineVersion, fingerprint, bytes, sha256, builtAt
+      index.html            # bitmagic build's output bundle
+      manifest.json          # engineVersion, fingerprint, bytes, sha256, builtAt
     verify/
-      result.json         # bitmagic verify's verdict — ok, failures, warnings, fingerprint, at
-      screenshot.png        # becomes the publish thumbnail
-      console.log            # captured browser console output
+      result.json              # bitmagic verify's verdict — ok, failures, warnings, fingerprint, at
+      screenshot.png            # the publish thumbnail when there is no cover art
+      console.log                # captured browser console output
 ```
 
+## Cover art
+
+`bitmagic cover` generates the game's cover from `GAME-DESIGN.md` — the same artwork the web
+Creator's Planning Mode produces, from the same style direction. It sets `hud.startScreen.imageUrl`
+so the image appears in the game itself, saves `.bitmagic/cover.webp`, and hands that to
+`bitmagic publish` as the portal thumbnail.
+
+Run it **early** — right after the design doc says what the game is, before implementing it. The
+first build takes a while, and the cover is what there is to look at meanwhile. In iTerm2, WezTerm
+and Konsole it is drawn straight into the terminal; everywhere else the path and URL are printed
+and `.bitmagic/cover.webp` is there to open (`BITMAGIC_NO_INLINE_IMAGE=1` turns the drawing off).
+
+Re-running on an unchanged design generates nothing and costs nothing — it reports the existing
+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.
+
 ## Publishing
 
 `bitmagic publish` is two gated steps in one command:
@@ -76,7 +97,8 @@ my-game/
    record stale immediately, while an unmodified project stays fresh no matter how much time has
    passed. There is no way to check freshness except running `bitmagic verify` again.
    `.git/`, `node_modules/`, `dist/`, `.bitmagic/` and `.vite-cache/` are excluded, so committing
-   between `bitmagic verify` and `bitmagic publish` does **not** invalidate the verify.
+   between `bitmagic verify` and `bitmagic publish` does **not** invalidate the verify. Neither
+   does editing `GAME-DESIGN.md`, which no build step reads.
 2. **The build.** If the project has changed since the last `.bitmagic/build/manifest.json`,
    publish rebuilds automatically; a prior manual `bitmagic build` is never required, only useful
    if you want to inspect `.bitmagic/build/index.html` before it ships.
@@ -89,9 +111,9 @@ service, so a previously-public game re-published bare is gone from bitmagic.ai
 publicly again.
 
 `--force` overrides a **stale or failed** verify verdict. It does **not** override a missing
-verify record — publish's thumbnail comes from the verify screenshot, so `bitmagic verify` must
-have produced at least one `.bitmagic/verify/screenshot.png`, ever, before `--force` has anything
-to work with.
+verify record — a project with no cover art has only the verify screenshot to publish a thumbnail
+from, so `bitmagic verify` must have produced at least one `.bitmagic/verify/screenshot.png`, ever,
+before `--force` has anything to work with.
 
 `--name` and `--description` apply to that one publish call only. They are never written back to
 `src/work/game.json`, so pass them again on every future `bitmagic publish` if you want them to
@@ -115,11 +137,23 @@ invalidate the verify you just checked.
 
 ## Upgrading
 
-`bitmagic upgrade` refreshes the vendored `engine/`, the generated config files, and `index.html`
-to the currently published engine version. It never touches `src/`, `world.json`, `game.json`,
-`package.json`, or the agent guidance files (`AGENTS.md`, `CLAUDE.md`, `.claude/skills/`) — those
-are yours. It refuses to run against a dirty git working tree unless `--force`, so the upgrade
-always shows up as its own reviewable diff.
+`bitmagic upgrade` refreshes the vendored `engine/`, the generated config files, `index.html`, and
+**the skills this CLI ships** (`.claude/skills/`) to the currently published engine version. It
+refuses to run against a dirty git working tree unless `--force`, so the upgrade always shows up as
+its own reviewable diff.
+
+What is yours and never touched: `src/`, `world.json`, `game.json`, `package.json`, `AGENTS.md`,
+`CLAUDE.md`, `GAME-DESIGN.md`, `.gitignore`, and any skill you wrote yourself.
+
+The shipped skills are on the refreshed side deliberately. They describe what the **CLI** can do,
+not what your game is, so a project holding the version that came with its scaffold has an agent
+that cannot discover anything added since — which is exactly what happened when `bitmagic cover`
+shipped. The cost is that edits to *our* skill files are lost on upgrade; put your own guidance in
+`AGENTS.md` or a skill of your own, both of which are left alone.
+
+Where an upgrade leaves a project unable to use something the CLI can now do, it says so rather
+than fixing it silently: a project with no `GAME-DESIGN.md` is told what to write and that
+`bitmagic cover` needs it.
 
 `upgrade` **reports** missing or outdated dependencies rather than installing them — it prints the
 exact install command to run, using your project's own package manager (detected from

package/dist/cli.d.ts

@@ -52,6 +52,10 @@ declare const rawCommands: {
             readonly type: "string";
             readonly description: "Game name.";
         };
+        readonly idea: {
+            readonly type: "string";
+            readonly description: "One-line pitch, seeded into GAME-DESIGN.md. Optional — you can write it yourself.";
+        };
         readonly env: {
             readonly type: "string";
             readonly description: "Environment (dev, prod, local).";
@@ -108,6 +112,28 @@ declare const rawCommands: {
         };
     }>;
     generate: CommandDef<ArgsDef>;
+    cover: CommandDef<{
+        readonly prompt: {
+            readonly type: "string";
+            readonly description: "Describe the game for this call only, instead of reading GAME-DESIGN.md. Never written to the file.";
+        };
+        readonly force: {
+            readonly type: "boolean";
+            readonly description: "Generate a new cover even when the design has not changed since the last one.";
+        };
+        readonly 'start-screen': {
+            readonly type: "boolean";
+            readonly negativeDescription: "Leave hud.startScreen.imageUrl alone — still saves the cover and uses it as the publish thumbnail.";
+        };
+        readonly 'reference-image-url': {
+            readonly type: "string";
+            readonly description: "Style/composition reference image URL forwarded to the image model.";
+        };
+        readonly json: {
+            readonly type: "boolean";
+            readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";
+        };
+    }>;
     forge: CommandDef<{
         readonly prompt: {
             readonly type: "string";

package/dist/cli.js

@@ -11,6 +11,7 @@ import { devCommand } from './commands/dev.js';
 import { verifyCommand } from './commands/verify.js';
 import { buildCommand } from './commands/build.js';
 import { generateCommand } from './commands/generate.js';
+import { coverCommand } from './commands/cover.js';
 import { forgeCommand } from './commands/forge.js';
 import { publishCommand } from './commands/publish.js';
 // citty's runMain() catches every error thrown from a command's `run()` internally and calls
@@ -88,7 +89,7 @@ export function isWrappedWithCleanErrors(command) {
     if (!subs)
         return false;
     const entries = Object.values(subs);
-    return entries.length > 0 && entries.every((sub) => isWrappedWithCleanErrors(sub));
+    return entries.length > 0 && entries.every(isWrappedWithCleanErrors);
 }
 // 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
@@ -104,6 +105,7 @@ const rawCommands = {
     verify: verifyCommand,
     build: buildCommand,
     generate: generateCommand,
+    cover: coverCommand,
     forge: forgeCommand,
     publish: publishCommand,
 };

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

@@ -0,0 +1,100 @@
+import { Buffer } from 'buffer';
+import { type WorldPatch } from '@bitmagic/asset-core';
+import type { GenerationOutcome } from '../generate/stream.js';
+import { type GenerateRunDeps } from './generate.js';
+/** The design document `bitmagic init` scaffolds and the coding agent maintains. */
+export declare const GAME_DESIGN_FILE = "GAME-DESIGN.md";
+export declare function coverImagePath(root: string): string;
+export interface CoverRecord {
+    /** The public image URL, as written into world.json. */
+    url: string;
+    /** Hash of the design text this cover was drawn from — see `readCoverRecord`. */
+    designHash: string;
+    generatedAt: string;
+}
+/**
+ * Identifies the design text a cover was generated from, so a repeat `bitmagic cover` on an
+ * unchanged design can decline to spend sparks on the same picture twice. This is the local
+ * equivalent of `PLAN_COVER_CACHE` in game-play-agent's PromptToGameController, which does the
+ * same for Planning Mode, keyed the same way — on the design text rather than the game.
+ */
+export declare function hashDesign(designText: string): string;
+export declare function readCoverRecord(root: string): CoverRecord | null;
+/**
+ * The prose the cover is drawn from: `--prompt` when given, otherwise GAME-DESIGN.md.
+ *
+ * `--prompt` is a one-call override and is never written to the file — the design document belongs
+ * to the creator, and a flag silently rewriting it would be a surprise the next `bitmagic cover`
+ * inherits.
+ *
+ * The error path matters as much as the happy one: projects scaffolded before GAME-DESIGN.md
+ * existed have no such file, and an agent that only sees "not found" cannot tell whether it should
+ * create one or has run the command in the wrong place. So the message says both what to write and
+ * what to run instead.
+ */
+export declare function resolveDesignText(options: {
+    promptFlag?: string | undefined;
+    root: string;
+    readFile?: (file: string) => string;
+}): string;
+/**
+ * The generated image's URL, read back out of the patch the image generator returned.
+ *
+ * The generator's terminal frame carries only `{ success, message, patches }` — the URL is not a
+ * separate field on the wire — so the patch it upserts into `assets[]` is where it lives. Matched
+ * on the patch's own shape rather than on the message text, which is prose and not a contract.
+ */
+export declare function coverUrlFromPatches(patches: WorldPatch[]): string | null;
+/**
+ * The patch that puts the cover behind the game's start screen.
+ *
+ * `set`, NOT `setRoot`: `set` addresses a path inside `worldProfileData`, which is where the
+ * engine's GameRuntimeController reads `hud.startScreen.imageUrl` from. A root-level write would
+ * land somewhere nothing ever looks and report success — the exact trap apply-patches.ts documents.
+ */
+export declare function startScreenPatch(url: string): WorldPatch;
+export interface CoverArgs {
+    prompt?: string;
+    force?: boolean;
+    'reference-image-url'?: string;
+    /** citty's negative form of the boolean flag: `--no-start-screen` arrives here as `false`. */
+    'start-screen'?: boolean;
+    json?: boolean;
+}
+export interface CoverRunDeps extends GenerateRunDeps {
+    /**
+     * Seam over `runAssetGeneration`, so a test can drive this without a network or a token.
+     *
+     * Deliberately narrower than `runAssetGeneration`'s own signature: it omits that function's
+     * `json` parameter, because this command always passes `false` there. Under `--json` stdout must
+     * carry exactly one document, and this command emits its own.
+     */
+    generate: (type: string, label: string, body: Record<string, unknown>, json: boolean, deps: GenerateRunDeps) => Promise<GenerationOutcome>;
+    /** Returns whether the terminal actually drew the image. */
+    renderImage: (bytes: Buffer) => boolean;
+    /** The machine-readable result, emitted only under `--json`. */
+    result: (value: unknown) => void;
+}
+export declare function runCover(args: CoverArgs, deps?: CoverRunDeps): Promise<void>;
+export declare const coverCommand: import("citty").CommandDef<{
+    readonly prompt: {
+        readonly type: "string";
+        readonly description: "Describe the game for this call only, instead of reading GAME-DESIGN.md. Never written to the file.";
+    };
+    readonly force: {
+        readonly type: "boolean";
+        readonly description: "Generate a new cover even when the design has not changed since the last one.";
+    };
+    readonly 'start-screen': {
+        readonly type: "boolean";
+        readonly negativeDescription: "Leave hud.startScreen.imageUrl alone — still saves the cover and uses it as the publish thumbnail.";
+    };
+    readonly 'reference-image-url': {
+        readonly type: "string";
+        readonly description: "Style/composition reference image URL forwarded to the image model.";
+    };
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";
+    };
+}>;

package/dist/commands/cover.js

@@ -0,0 +1,321 @@
+/**
+ * `bitmagic cover` — generate this game's cover art from its design document.
+ *
+ * The web lane's Planning Mode does this automatically for every game it builds, which is why a
+ * game made in Creator arrives with real artwork and a game made here arrived with whatever
+ * `bitmagic verify` happened to screenshot. This is the pro lane's equivalent, with one deliberate
+ * difference: it is a command the creator (or their agent) runs, not something `bitmagic init`
+ * fires. At init there is no design yet, and a cover generated from nothing is generic.
+ *
+ * Run it EARLY — as soon as GAME-DESIGN.md says what the game is, before implementing it. The art
+ * then exists during the long first coding pass rather than after it, which is the other half of
+ * what Planning Mode's cover is for.
+ *
+ * It is built entirely on the existing `generate image` lane (`runAssetGeneration`), so ownership,
+ * spark billing, the SSE keepalive and the server-side deadline all behave identically to every
+ * other generation. Only two things differ, and both are this side of the wire: the prompt is
+ * composed by `@bitmagic/asset-core`'s `buildCoverArtPrompt` (the same one the web lane uses, so
+ * covers from both lanes look like the same product), and the result is additionally written to
+ * the start screen, saved locally, and picked up by `bitmagic publish` as the thumbnail.
+ */
+import { defineCommand } from 'citty';
+import { Buffer } from 'buffer';
+import { createHash } from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildCoverArtPrompt, isUpsertRootPatch } from '@bitmagic/asset-core';
+import { CliError } from '../errors.js';
+import { loadProjectContext } from '../project/context.js';
+import { aliasSourceDir } from '../scaffold/aliases.js';
+import { applyPatchesToWorld } from '../generate/apply-patches.js';
+import { runAssetGeneration } from './generate.js';
+import { renderInlineImage } from '../render/inline-image.js';
+import { createOutput } from '../output.js';
+/** The design document `bitmagic init` scaffolds and the coding agent maintains. */
+export const GAME_DESIGN_FILE = 'GAME-DESIGN.md';
+/**
+ * The `assets[]` entry name the cover is stored under. Fixed, not derived from the game name,
+ * because the image generator upserts on `['name', 'type']` — a stable name means regenerating
+ * REPLACES the previous cover instead of leaving a trail of orphaned images in world.json.
+ */
+const COVER_ASSET_NAME = 'cover_art';
+/** Square, matching the web lane's cover size. The portal card and start screen both crop to fit. */
+const COVER_SIZE = 1024;
+/** Under `.bitmagic/`: gitignored, and excluded from the publish fingerprint. */
+const COVER_IMAGE_FILE = path.join('.bitmagic', 'cover.webp');
+const COVER_RECORD_FILE = path.join('.bitmagic', 'cover.json');
+export function coverImagePath(root) {
+    return path.join(root, COVER_IMAGE_FILE);
+}
+function coverRecordPath(root) {
+    return path.join(root, COVER_RECORD_FILE);
+}
+/**
+ * Identifies the design text a cover was generated from, so a repeat `bitmagic cover` on an
+ * unchanged design can decline to spend sparks on the same picture twice. This is the local
+ * equivalent of `PLAN_COVER_CACHE` in game-play-agent's PromptToGameController, which does the
+ * same for Planning Mode, keyed the same way — on the design text rather than the game.
+ */
+export function hashDesign(designText) {
+    return createHash('sha256').update(designText.trim(), 'utf-8').digest('hex');
+}
+export function readCoverRecord(root) {
+    let raw;
+    try {
+        raw = fs.readFileSync(coverRecordPath(root), 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // A corrupt record is not worth an error: the worst case is one regeneration.
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const { url, designHash, generatedAt } = parsed;
+    if (typeof url !== 'string' || typeof designHash !== 'string' || typeof generatedAt !== 'string') {
+        return null;
+    }
+    return { url, designHash, generatedAt };
+}
+function writeCoverRecord(root, record) {
+    fs.writeFileSync(coverRecordPath(root), `${JSON.stringify(record, null, 2)}\n`);
+}
+// ============================================================================
+// Design text
+// ============================================================================
+/**
+ * The prose the cover is drawn from: `--prompt` when given, otherwise GAME-DESIGN.md.
+ *
+ * `--prompt` is a one-call override and is never written to the file — the design document belongs
+ * to the creator, and a flag silently rewriting it would be a surprise the next `bitmagic cover`
+ * inherits.
+ *
+ * The error path matters as much as the happy one: projects scaffolded before GAME-DESIGN.md
+ * existed have no such file, and an agent that only sees "not found" cannot tell whether it should
+ * create one or has run the command in the wrong place. So the message says both what to write and
+ * what to run instead.
+ */
+export function resolveDesignText(options) {
+    const flag = options.promptFlag?.trim();
+    if (flag)
+        return flag;
+    const readFile = options.readFile ?? ((file) => fs.readFileSync(file, 'utf-8'));
+    const designPath = path.join(options.root, GAME_DESIGN_FILE);
+    let contents;
+    try {
+        contents = readFile(designPath);
+    }
+    catch {
+        throw new CliError(`No ${GAME_DESIGN_FILE} at ${designPath}, and no --prompt given. Cover art is generated from ` +
+            'the game design, so there must be one or the other.\n' +
+            `Write ${GAME_DESIGN_FILE} describing the pitch, the core loop and — most usefully for the ` +
+            'artwork — the world and its look, then run `bitmagic cover` again. To generate from a ' +
+            'one-off description instead, run `bitmagic cover --prompt "..."`.');
+    }
+    if (!contents.trim()) {
+        throw new CliError(`${designPath} is empty. Describe the game — especially its world and look — or pass ` +
+            '`bitmagic cover --prompt "..."` to generate from a one-off description.');
+    }
+    return contents;
+}
+// ============================================================================
+// Reading the result
+// ============================================================================
+/**
+ * The generated image's URL, read back out of the patch the image generator returned.
+ *
+ * The generator's terminal frame carries only `{ success, message, patches }` — the URL is not a
+ * separate field on the wire — so the patch it upserts into `assets[]` is where it lives. Matched
+ * on the patch's own shape rather than on the message text, which is prose and not a contract.
+ */
+export function coverUrlFromPatches(patches) {
+    for (const patch of patches) {
+        if (!isUpsertRootPatch(patch))
+            continue;
+        if (patch.path.join('.') !== 'assets')
+            continue;
+        const value = patch.value;
+        if (typeof value !== 'object' || value === null)
+            continue;
+        const url = value.url;
+        if (typeof url === 'string' && url.length > 0)
+            return url;
+    }
+    return null;
+}
+/**
+ * The patch that puts the cover behind the game's start screen.
+ *
+ * `set`, NOT `setRoot`: `set` addresses a path inside `worldProfileData`, which is where the
+ * engine's GameRuntimeController reads `hud.startScreen.imageUrl` from. A root-level write would
+ * land somewhere nothing ever looks and report success — the exact trap apply-patches.ts documents.
+ */
+export function startScreenPatch(url) {
+    return { type: 'set', path: ['hud', 'startScreen', 'imageUrl'], value: url };
+}
+function defaultDeps(json) {
+    const output = createOutput(json);
+    return {
+        fetch: globalThis.fetch,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        log: output.info,
+        result: output.result,
+        generate: runAssetGeneration,
+        renderImage: (bytes) => renderInlineImage(bytes),
+    };
+}
+/**
+ * Download the generated image so the agent driving this CLI can look at it, and so
+ * `bitmagic publish` has bytes to upload as the thumbnail.
+ *
+ * Best-effort by design: the URL is already in world.json by the time this runs, so a failed
+ * download costs the local copy and nothing else. It must not turn a paid, successful generation
+ * into a failed command.
+ */
+async function saveCoverImage(root, url, deps) {
+    try {
+        const response = await deps.fetch(url);
+        if (!response.ok) {
+            deps.log(`  could not download the image for a local copy (HTTP ${response.status}).`);
+            return null;
+        }
+        const bytes = Buffer.from(await response.arrayBuffer());
+        fs.mkdirSync(path.dirname(coverImagePath(root)), { recursive: true });
+        fs.writeFileSync(coverImagePath(root), bytes);
+        return bytes;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        deps.log(`  could not download the image for a local copy: ${message}`);
+        return null;
+    }
+}
+/** Prints the cover's location, and draws it where the terminal can show it. */
+function reportCover(root, url, bytes, deps) {
+    if (bytes)
+        deps.log(`Cover art: ${coverImagePath(root)}`);
+    deps.log(`  ${url}`);
+    // Plain lines first, always: they are what an agent reads, and the image is strictly extra.
+    if (bytes)
+        deps.renderImage(bytes);
+}
+export async function runCover(args, deps = defaultDeps(args.json === true)) {
+    const context = loadProjectContext(deps.startDir);
+    const root = context.root;
+    const designText = resolveDesignText({ promptFlag: args.prompt, root });
+    const designHash = hashDesign(designText);
+    // Same design, same picture: decline rather than bill for it twice. The local image has to be
+    // there too — without it there is nothing for `bitmagic publish` to upload, and "up to date"
+    // would be a lie.
+    const existing = readCoverRecord(root);
+    if (args.force !== true &&
+        existing?.designHash === designHash &&
+        fs.existsSync(coverImagePath(root))) {
+        deps.log('Cover art is already up to date for this design.');
+        reportCover(root, existing.url, fs.readFileSync(coverImagePath(root)), deps);
+        deps.log('Pass --force to generate a new one anyway.');
+        // `generated: false` is the whole point of this branch for an automated caller: the command
+        // succeeded, nothing was billed, and there is no new picture to look at.
+        deps.result({
+            ok: true,
+            generated: false,
+            url: existing.url,
+            imagePath: coverImagePath(root),
+            startScreenSet: false,
+        });
+        return;
+    }
+    const body = {
+        name: COVER_ASSET_NAME,
+        prompt: buildCoverArtPrompt(designText),
+        width: COVER_SIZE,
+        height: COVER_SIZE,
+        ...(args['reference-image-url'] !== undefined
+            ? { referenceImageUrl: args['reference-image-url'] }
+            : {}),
+    };
+    // 'image' is the wire type; everything past this point is what makes it a COVER rather than one
+    // more entry in the assets catalog. `false` suppresses the generator's own result document —
+    // this command emits the one, and its prose is already routed by the deps it hands over.
+    const outcome = await deps.generate('image', 'cover art', body, false, deps);
+    const url = coverUrlFromPatches(outcome.patches);
+    if (url === null) {
+        throw new CliError('The cover image was generated and added to world.json, but the response carried no image ' +
+            'URL, so the start screen was not set and no local copy was saved. Re-run `bitmagic cover ' +
+            '--force`; if it happens again, report it.');
+    }
+    const setsStartScreen = args['start-screen'] !== false;
+    if (setsStartScreen) {
+        const worldPath = path.join(root, aliasSourceDir('work'), 'world.json');
+        applyPatchesToWorld(worldPath, [startScreenPatch(url)]);
+        // A full sentence, not a bullet: it lands after runAssetGeneration's own patch summary has
+        // already closed with "world.json updated", where another bullet would read as part of that list.
+        deps.log("Set as the game's start screen (hud.startScreen.imageUrl).");
+    }
+    const bytes = await saveCoverImage(root, url, deps);
+    if (bytes) {
+        writeCoverRecord(root, { url, designHash, generatedAt: new Date().toISOString() });
+    }
+    reportCover(root, url, bytes, deps);
+    deps.log(bytes
+        ? 'This is now the publish thumbnail as well — `bitmagic publish` prefers it over the verify screenshot.'
+        : 'No local copy was saved, so `bitmagic publish` will still use the verify screenshot as the thumbnail.');
+    // Said plainly, and NOT conditional on --start-screen: the generation writes the image into
+    // `assets[]` either way, so world.json — and the fingerprint the verify gate checks — has moved
+    // regardless. An agent that publishes next would otherwise hit exit 3 and have to work out why.
+    deps.log('world.json changed — run `bitmagic verify` again before publishing.');
+    deps.result({
+        ok: true,
+        generated: true,
+        url,
+        // Null, not omitted: a caller that wanted to display the art needs to know it is not there,
+        // and an absent key reads as "look at the default path" rather than "there is no file".
+        imagePath: bytes ? coverImagePath(root) : null,
+        startScreenSet: setsStartScreen,
+        verifyStale: true,
+    });
+}
+export const coverCommand = defineCommand({
+    meta: {
+        name: 'cover',
+        description: "Generate the game's cover art from GAME-DESIGN.md and set it as the start screen.",
+    },
+    args: {
+        prompt: {
+            type: 'string',
+            description: `Describe the game for this call only, instead of reading ${GAME_DESIGN_FILE}. Never written to the file.`,
+        },
+        force: {
+            type: 'boolean',
+            description: 'Generate a new cover even when the design has not changed since the last one.',
+        },
+        'start-screen': {
+            type: 'boolean',
+            negativeDescription: 'Leave hud.startScreen.imageUrl alone — still saves the cover and uses it as the publish thumbnail.',
+        },
+        'reference-image-url': {
+            type: 'string',
+            description: 'Style/composition reference image URL forwarded to the image model.',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Print the result as JSON on stdout; all progress goes to stderr.',
+        },
+    },
+    async run({ args }) {
+        await runCover({
+            prompt: args.prompt,
+            force: args.force,
+            'start-screen': args['start-screen'],
+            'reference-image-url': args['reference-image-url'],
+            json: args.json,
+        });
+    },
+});
+//# sourceMappingURL=cover.js.map

package/dist/commands/cover.js.map

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