@bitmagic/cli 0.1.65-dev.24 → 0.1.65-dev.3

package/dist/telemetry/creator-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"creator-prompt.js","sourceRoot":"","sources":["../../src/telemetry/creator-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,sGAAsG;AACtG,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oFAAoF;UAC7F,iEAAiE;CAC7D,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,MAAM,KAAK,GAAG,QAAQ,IAAI,cAAc,EAAE,EAAE,aAAa,CAAC;IAC1D,oFAAoF;IACpF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,gGAAgG;IAChG,8FAA8F;IAC9F,OAAO,eAAe,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,eAAe,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"creator-prompt.js","sourceRoot":"","sources":["../../src/telemetry/creator-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,sGAAsG;AACtG,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oFAAoF;UAC7F,iEAAiE;CAC7D,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,MAAM,KAAK,GAAG,QAAQ,IAAI,cAAc,EAAE,EAAE,aAAa,CAAC;IAC1D,oFAAoF;IACpF,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,gGAAgG;IAChG,8FAA8F;IAC9F,OAAO,eAAe,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,eAAe,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7G,CAAC"}

package/dist/telemetry/report.js

@@ -16,19 +16,11 @@
  *      bounded to {@link REPORT_TIMEOUT_MS} per request so a finished command is
  *      never held open by a sulking network (the same reasoning as
  *      update/check.ts). It never prints.
- *   2. Its ANALYTICS are categories, never messages: the command name, ok/failed,
- *      the exit code, a `CliError.code`, and a duration. A message can name a
- *      path; that does not belong in an analytics event. The game id keeps the
- *      rule (it is an id we minted) and so does the ask DIGEST (opaque by
- *      construction), and neither reaches GA4.
- *
- *      `creatorPrompt` is the one field that carries words, and it is not
- *      analytics: api-server posts it to an internal Slack channel and stores it
- *      nowhere — not GA4, not Postgres, not BigQuery. It is here because the
- *      commands that send prompt text to a route are the generators, and an
- *      agent building a GDK project spends most of its commands on the offline
- *      ones. `DO_NOT_TRACK` drops it with everything else. See
- *      {@link CommandProvenance}.
+ *   2. It sends categories, never messages: the command name, ok/failed, the
+ *      exit code, a `CliError.code`, and a duration. A message can name a path;
+ *      that does not belong in an analytics event. The two later additions keep
+ *      the rule: the project's game id is an id we minted, and the creator's ask
+ *      travels as an opaque DIGEST, never its words. See {@link CommandProvenance}.
  *   3. It is authenticated with the creator's own token, so the server can key
  *      the event to the account and look up their real Pro state. No token, no
  *      report — an anonymous beacon would be a spammable endpoint for nothing.
@@ -40,7 +32,7 @@ import { resolveAuth0ClientId } from '../config/environments.js';
 import { getAccessToken } from '../auth/session.js';
 import { readProjectGameIdOrNull } from '../project/context.js';
 import { apiServerHeaders } from './request-headers.js';
-import { creatorAskDigest, creatorAskText } from './creator-prompt.js';
+import { creatorAskDigest } from './creator-prompt.js';
 import { currentCommand, isTelemetryDisabled } from './command-context.js';
 // Re-exported because this is where the opt-out is enforced for a report that is already
 // under way; `beginCommand` consults the same predicate to skip collecting anything at all.
@@ -93,28 +85,21 @@ function defaultDeps() {
     return { fetch: globalThis.fetch, env: process.env };
 }
 /**
- * The game and the ask, when this command has either. Keys are omitted rather than sent as null:
- * api-server validates the body strictly, and an absent key is how "nothing to say" is spelled
- * everywhere else on this wire.
- *
- * Nothing is present unless the command declared `--original-prompt` AND the agent passed it —
- * `creatorAskDigest` reads the value `beginCommand` captured, which is also where `DO_NOT_TRACK`
- * already dropped it.
+ * The game and the ask, when this command has either. Both keys are omitted rather than sent as
+ * null: api-server validates the body strictly, and an absent key is how "nothing to say" is
+ * spelled everywhere else on this wire.
  *
- * `gameId` and `askDigest` are only sent TOGETHER: a digest with no game cannot be counted, and a
- * game with no digest is not an ask. `creatorPrompt` is independent of that pair, because the
- * channel it feeds wants the ask from a command run before a game exists just as much — the pair
- * is about counting, and counting needs a game to count against.
+ * The digest is only ever present when the command declared `--original-prompt` AND the agent
+ * passed it — `creatorAskDigest` reads the value `beginCommand` captured, which is also where
+ * `DO_NOT_TRACK` already dropped it. The pair is only sent together: a digest with no game
+ * cannot be counted, and a game with no digest is not an ask.
  */
 function provenance(deps) {
-    const creatorPrompt = creatorAskText();
-    if (creatorPrompt === undefined)
+    const askDigest = creatorAskDigest();
+    if (askDigest === undefined)
         return {};
     const gameId = readProjectGameIdOrNull(deps.cwd);
-    const askDigest = creatorAskDigest();
-    if (gameId === undefined || askDigest === undefined)
-        return { creatorPrompt };
-    return { creatorPrompt, gameId, askDigest };
+    return gameId === undefined ? {} : { gameId, askDigest };
 }
 /**
  * Report the running command's `report` to api-server. Resolves when the report

package/dist/telemetry/report.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.65-dev.24",
+  "version": "0.1.65-dev.3",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -25,9 +25,9 @@
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
     "ws": "^8.21.3",
-    "@bitmagic/animation-forger": "0.1.20-dev.24",
-    "@bitmagic/asset-core": "0.2.20-dev.24",
-    "@bitmagic/world-forger": "0.1.25-dev.24"
+    "@bitmagic/animation-forger": "0.1.20-dev.3",
+    "@bitmagic/asset-core": "0.2.20-dev.3",
+    "@bitmagic/world-forger": "0.1.25-dev.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",

package/assets/skills/trailer-craft.md

@@ -1,180 +0,0 @@
-# Trailer craft — structure, pacing, and on-screen text
-
-Read this before composing a cut or putting any text on screen. Compressed
-from Derek Lieu's trailer-editing essays (trailer editor for Half-Life: Alyx,
-Dead Cells, Spelunky 2) plus general trailer-typography guidance; sources at
-the bottom.
-
-## Ordering: Genre → Hook → Anchors → Content
-
-- **Genre** in 1–2 shots: the viewer must know what kind of game this is
-  within the first seconds. For our games one gameplay shot usually does it.
-- **Hook** — the thing only this game has — as soon as genre is established:
-  ideally inside the first 10–15 s, never later than the first third.
-  Showing generic-but-good content before the hook makes the game read as
-  "a lesser version of an old game".
-- **Anchors** — the features people expect from the genre (for a racer:
-  overtakes, drifts, crashes, varied tracks) fill the middle.
-- **Content** — breadth (levels, modes, vehicles) comes last, once the viewer
-  already cares.
-
-## Timeline layout: constraints first, footage last
-
-Lay the timeline out as a skeleton and only then hunt for footage — not the
-other way round:
-
-1. Write the section skeleton: **Cold open → Introduction → Escalation →
-   Climax → Breath → Button/End card**. Sections have different lengths and
-   energy; they are not equal slices.
-2. Reserve the **end card** first: 2–3 s, ONE card (logo + tagline + CTA),
-   never a sequence of closing screens.
-3. Place any **body title cards** next, as placeholders with their copy
-   written — each one names what the following footage must prove.
-4. Only now fill footage, chosen to demonstrate whatever the neighbouring
-   card or section claims.
-
-This turns "pick 15 great clips" (squishy, drifts toward sameness) into
-"find the one clip that proves this beat" (constrained, self-diversifying).
-
-## Pacing
-
-- Sections need **ebb and flow**: build to a peak, then give a deliberate
-  breathing shot (~5 s, calmer, wider) before the next build or the finale.
-  The stops emphasize the fast; the fast emphasizes the slow.
-- **Rule of three**: never more than three similar things in a row — three
-  crashes, three drift shots, three of anything. Viewers extrapolate after
-  two; the fourth is dead time.
-- **Do not cut on every beat.** Snap cuts to the grid, but vary clip lengths
-  (2, 3, 4, 6 beats) and sometimes let a musical moment land on an in-clip
-  action (a landing, an impact) instead of a cut. Constant per-beat cutting
-  reads as a sizzle reel, and gets nauseating.
-- Average shot length is a genre statement: ~1.3 s reads as AAA shooter,
-  ~4 s reads as contemplative indie. An arcade racer sits around 1.5–3 s
-  with a few longer holds where one continuous action is the payoff.
-- **More editing is not better editing.** A cut must clarify or escalate;
-  cutting fast to look "like a real trailer" hides the game. If a single
-  take shows the whole stunt, keep the take.
-- Total length: under 90 s unless there's a reason; 30–45 s is a sweet spot
-  for social/store use.
-
-## Variety — the five axes
-
-Audit the cut on each axis; the labels list in the shots file is the tool
-(read the labels top to bottom — repetition is visible in text before you
-ever re-watch):
-
-1. **Content** — different actions, not the same action in new places.
-   Escalate variants (jump → bigger jump) rather than repeating.
-2. **Composition** — vary camera distance and framing; chase cam all the way
-   through is monotone. Watch eye-trace: the viewer's focus point should not
-   teleport across the frame on a cut.
-3. **Energy** — intense vs. quiet moments; contrast matters more than speed.
-4. **Pacing** — vary section tempo, not just shot tempo.
-5. **Shot length** — vary beats-per-clip even inside a fast section.
-
-## Where the shots come from
-
-Played footage is the default and the bulk of any trailer: it is the only
-thing that shows what the game DOES, and a trailer of pure scenery reads as a
-tech demo however pretty it is. But two of the beats above are ones a chase
-camera almost never hands you:
-
-- the **cold open**, which wants the level to look composed and deliberate;
-- the **breath**, which wants one calm wide shot with nothing happening.
-
-Both are what an authored **camera fly-through** is for — a path through the
-level with the game running underneath, so traffic still drives and animations
-still play while the camera moves on rails. Recording one is cheap and nobody
-has to play it, so a fly-through is worth having even when there is plenty of
-gameplay: cut one or two of its shots into a gameplay trailer rather than
-building a trailer out of it.
-
-A fly-through alone is the right whole trailer in a narrow set of cases — a
-world reveal, an architectural or exploration piece, a level that is the
-feature — and whenever there is no one available to play. Otherwise it is a
-source of shots, not a substitute for showing the game.
-
-## On-screen text
-
-When to use text at all: only when footage cannot say it. A card that
-narrates what the next shot visibly shows is noise. Default for our
-gameplay trailers: **end card only**; add body cards only when they carry
-information the footage can't (game name early, a hook that isn't visual,
-release date).
-
-Writing the cards:
-- Copy must sound like this game and no other. Exercise: describe the game
-  in three words; build cards from what's left after cutting everything
-  generic.
-- ≤ 6 words per card. Evocative verbs beat feature lists ("Forge your own
-  path", not "Over 40 unique tracks").
-- Banned: content quantities ("5 unique levels"), genre-descriptor stacks
-  ("a 2D rogue-lite action adventure"), player-verb lists ("Race! Drift!
-  Win!"), and stock phrases ("In a world…", "Get ready…", "Experience…",
-  "…like never before").
-
-Showing the cards:
-- **Intercut, don't overlay**: a card gets its own beat between gameplay
-  shots (dimmed still or plain background). Never ask the viewer to read
-  while action plays — they do neither. Small persistent text (logo bug,
-  date) is the exception.
-- Reading time: ~0.5–0.7 s per word, minimum 2.5 s on screen; end card
-  2–3 s (ours may run longer over a music outro).
-- Cards ride the same beat grid as the cuts — a card is a clip.
-- Typography must match the game's art quality and universe: one typeface
-  family for the whole trailer, generous letter-spacing for all-caps,
-  strong contrast against footage (our title raster already adds shadow),
-  subtle animation only (fade/scale-in) — a static default-font card reads
-  as a last-minute add-on.
-
-## Structure template (30–45 s, gameplay-only, end card close)
-
-| Section | ~share | What goes here |
-|---|---|---|
-| Cold open | 5–15% | The single most striking moment; genre obvious at a glance |
-| Introduction | 15–20% | Clean, readable driving; establish look + one anchor |
-| Escalation | 35–45% | Varied action, rising energy, hook prominent early in it |
-| Climax | 15–20% | Densest, loudest stretch; biggest moments back to back |
-| Breath | ~5% | One calmer, wider shot; lets the climax land |
-| End card | 2–3 s+ | Logo, tagline, CTA — over the music's outro |
-
-## Selection rules already paid for
-
-These came out of review rounds on real cuts. They cost time to learn and
-nothing to apply, so apply them before the first render, not after.
-
-- **Never use slow motion.** On gameplay footage it reads as the game running
-  at a low framerate, not as drama. `speed` stays 1.0.
-- **Numbers are not interest.** Event `severity` / `impactSpeed` ranks
-  car-stops-dead-against-a-wall highest — the worst possible clip. A crash
-  earns its slot only if things visibly break (`destruction` events, debris)
-  and motion continues through the hit.
-- **Low speed can BE the drama.** Wheelspin recoveries throwing dirt or snow,
-  plowing back onto the track, being overtaken while struggling
-  (`position-change` with `gained: false`), `off-track` +
-  `hard-acceleration` clusters — these are among the best clips and score
-  near zero on any speed metric.
-- **"Some shots of X" means a few.** The failure mode is 0-or-100: one
-  standing start is an opener, five is a broken trailer.
-- **Quota check before rendering.** Read the shots list labels top to bottom.
-  Max one standing start; no more than three of any shot type in the whole
-  cut and never three similar in a row; vary track or biome, camera distance
-  and action type (the five axes above).
-- **Menu and selection clips need `"ui": false`** — the HUD replay only knows
-  the gameplay HUD and will paint it over menus.
-- **Verify on pixels.** Contact sheets and stills for every candidate, and
-  stills from the RENDERED file for anything you changed. The timeline knows
-  about events; it cannot see framing, occlusion or beauty.
-- **Iterate cheaply, keep history.** Editing the shots and re-rendering is
-  minutes, and revisions auto-version — so render rather than debate, and
-  compare against the previous `-rN` before delivering.
-
-## Sources
-
-- [How to Hook the Audience and How Quickly to Do it](https://www.derek-lieu.com/blog/2022/10/24/how-to-hook-the-audience-and-how-quickly-to-do-it)
-- [Step Two of Starting a Game Trailer Timeline](https://www.derek-lieu.com/blog/2023/2/19/step-two-of-starting-a-game-trailer-timeline)
-- [How to Think About Pacing in a Trailer](https://www.derek-lieu.com/blog/2020/11/16/how-to-think-about-pacing-in-a-trailer)
-- [Variety is the Spice of Trailers](https://www.derek-lieu.com/blog/2019/3/27/variety-is-the-spice-of-trailers)
-- [More Trailer Editing is not Better Trailer Editing](https://www.derek-lieu.com/blog/2023/4/23/more-trailer-editing-is-not-better-trailer-editing)
-- [How to Write Trailer Title Cards With Strong Messaging](https://www.derek-lieu.com/blog/2020/4/19/how-to-write-trailer-title-cards-with-strong-messaging)
-- [10 Common Indie Game Trailer Mistakes & How to Fix Them](https://www.derek-lieu.com/blog/2020/9/14/10-common-indie-game-trailer-mistakes-and-how-to-fix-them)

package/dist/commands/character.d.ts

@@ -1,18 +0,0 @@
-import { type CharacterSearchRecord } from '../project/character-search.js';
-import { type CharacterArgs } from '../generate/character-body.js';
-/**
- * What `bitmagic character add` will ask for, from its flags and the cached search.
- *
- * Pure, and separated from the command so the branch that matters — which of the
- * two forms was asked for, and whether the cache can answer it — is testable
- * without a project, a token or a network. It returns the character args rather
- * than a body so the shared `buildCharacterBody` still owns the wire shape.
- */
-export declare function resolveAddRequest(args: {
-    name: string;
-    id?: string;
-    prompt?: string;
-    applyToPlayer?: boolean;
-    record: CharacterSearchRecord | null;
-}): CharacterArgs;
-export declare const characterCommand: import("citty").CommandDef<import("citty").ArgsDef>;

package/dist/commands/character.js

@@ -1,268 +0,0 @@
-/**
- * `bitmagic character` — make one, look through the ready-made ones, or add one.
- *
- * Its own noun group rather than three flags on `bitmagic generate character`,
- * because the shelf and the forge are two different requests that happened to
- * share a command:
- *
- *   generate  costs sparks, makes a new body, may substitute a close stored one
- *   search    free, read-only, shows what the shelf has and how close it is
- *   add       free, puts a stored body in the game, never forges
- *
- * The old surface expressed "add" as `generate character --library-only`, a
- * command that generates nothing, and it carried two flags that existed only to
- * be refused on that path (`--head-scale` was accepted, reported and dropped;
- * `--mesh-model` was rejected outright). Both refusals disappear here, because a
- * command that never forges simply does not offer the flags that pick how a
- * forge runs.
- *
- * `search` exists because no similarity floor can do this job. Measured against
- * the live index, genuine matches score 0.624-0.831 while humanoid prompts the
- * shelf cannot answer score 0.552-0.698 — overlapping, so a threshold that keeps
- * the good ones keeps "a humanoid bee" for "a beekeeper" too. A person reading
- * three captions settles in a second what a number cannot settle at all.
- */
-import { defineCommand } from 'citty';
-import { CliError } from '../errors.js';
-import { createOutput } from '../output.js';
-import { apiGet } from '../http/client.js';
-import { resolveArtStyle } from '../project/art-style.js';
-import { findCachedCandidate, readCharacterSearch, writeCharacterSearch, } from '../project/character-search.js';
-import { ORIGINAL_PROMPT_FLAG, withParent } from '../telemetry/creator-prompt.js';
-import { JSON_FLAG, resolveRun, runAssetGeneration } from './generate.js';
-import { APPLY_TO_PLAYER_ARG, buildCharacterBody, defaultVoxelizeForProject, FRESH_ARG, HEAD_SCALE_ARG, LIBRARY_ARG, MESH_MODEL_ARG, NAME_ARG, PROMPT_ARG, VOXELIZE_ARG, } from '../generate/character-body.js';
-const generateCommand = defineCommand({
-    meta: {
-        name: 'generate',
-        description: 'Forge a new rigged character and add it to world.json assets. Costs sparks.',
-    },
-    args: {
-        name: NAME_ARG,
-        prompt: PROMPT_ARG,
-        'apply-to-player': APPLY_TO_PLAYER_ARG,
-        'head-scale': HEAD_SCALE_ARG,
-        fresh: FRESH_ARG,
-        library: LIBRARY_ARG,
-        voxelize: VOXELIZE_ARG,
-        'mesh-model': MESH_MODEL_ARG,
-        'original-prompt': ORIGINAL_PROMPT_FLAG,
-        json: JSON_FLAG,
-    },
-    async run({ args }) {
-        const body = buildCharacterBody({
-            name: args.name,
-            prompt: args.prompt,
-            applyToPlayer: args['apply-to-player'],
-            headScale: args['head-scale'],
-            fresh: args.fresh,
-            library: args.library,
-            voxelize: args.voxelize ?? defaultVoxelizeForProject(),
-            meshModel: args['mesh-model'],
-        });
-        await runAssetGeneration('character', 'character', withParent(body), args.json === true);
-    },
-});
-/** `62%` — the only form a similarity is ever shown in, so the table lines up. */
-function percent(value) {
-    return `${Math.round(value * 100)}%`;
-}
-function renderCandidates(candidates, threshold, log) {
-    const width = Math.max(2, ...candidates.map((row) => row.sid.length));
-    log('');
-    log(`  #  ${'id'.padEnd(width)}  match  auto  description`);
-    candidates.forEach((row, index) => {
-        // The "auto" column is why the floor is reported rather than applied: it
-        // says which of these automatic substitution would have taken, so a creator
-        // can see both that a body cleared the bar and that a weaker one exists.
-        const auto = row.similarity >= threshold ? ' yes' : '   -';
-        const label = row.subject ?? row.description ?? '';
-        log(`  ${String(index + 1).padStart(1)}  ${row.sid.padEnd(width)}  ${percent(row.similarity).padStart(5)}  ${auto}  ${label.slice(0, 60)}`);
-    });
-    log('');
-}
-const searchCommand = defineCommand({
-    meta: {
-        name: 'search',
-        description: 'List the ready-made characters closest to a description. Free; changes nothing.',
-    },
-    args: {
-        prompt: {
-            type: 'string',
-            required: true,
-            description: 'What the character should look like.',
-        },
-        limit: {
-            type: 'string',
-            description: 'How many candidates to list, 1-16. Default 5.',
-        },
-        representation: {
-            type: 'string',
-            description: "Which shelf to search: 'voxel' or 'lowpoly'. Omit to follow the project's art style.",
-        },
-        json: JSON_FLAG,
-    },
-    async run({ args }) {
-        const json = args.json === true;
-        const { output, runDeps, context, environment, token } = await resolveRun(json);
-        const representation = (() => {
-            const asked = args.representation;
-            // `resolveArtStyle` also reports a game.json value that is neither word,
-            // which is the same note every other art-style-aware command prints.
-            if (asked === undefined)
-                return resolveArtStyle(context.root, output.info) === 'low-poly' ? 'lowpoly' : 'voxel';
-            if (asked !== 'voxel' && asked !== 'lowpoly') {
-                throw new CliError("--representation must be 'voxel' or 'lowpoly'.", 1, 'invalid_flag');
-            }
-            return asked;
-        })();
-        const query = new URLSearchParams({
-            gameId: context.metadata.gameId,
-            prompt: args.prompt,
-            representation,
-        });
-        if (args.limit !== undefined)
-            query.set('limit', args.limit);
-        const response = await apiGet(environment, `/api/cli/v1/characters/search?${query.toString()}`, token, runDeps);
-        // Written even when empty: "the shelf has nothing like this" is a result a
-        // re-run should not have to rediscover, and an empty cache makes `add --id`
-        // say "search first" rather than "no such id".
-        writeCharacterSearch(context.root, {
-            prompt: response.prompt,
-            representation,
-            threshold: response.threshold,
-            searchedAt: new Date().toISOString(),
-            candidates: response.candidates,
-        });
-        if (response.candidates.length === 0) {
-            const nearest = response.topSimilarity !== undefined
-                ? ` The closest was ${percent(response.topSimilarity)}, which had no usable file.`
-                : '';
-            output.info(`No ready-made ${representation} character matches "${response.prompt}".${nearest}`);
-            output.info(`Forge one instead:  bitmagic character generate --name <name> --prompt "${response.prompt}"`);
-            output.result({ ok: true, kind: 'character search', representation, threshold: response.threshold, candidates: [], ...(response.reason ? { reason: response.reason } : {}) });
-            return;
-        }
-        output.info(`${response.candidates.length} ready-made ${representation} character(s) for "${response.prompt}":`);
-        renderCandidates(response.candidates, response.threshold, output.info);
-        const best = response.candidates[0];
-        if (best.similarity < response.threshold) {
-            // Said plainly rather than hidden: on this corpus a confident-looking
-            // caption can still be the wrong character, and the creator is the only
-            // one who can tell.
-            output.info(`None clears the ${percent(response.threshold)} bar automatic substitution requires — read the captions before adding one.`);
-        }
-        output.info(`Add one:  bitmagic character add --id ${best.sid} --name <name>`);
-        output.result({
-            ok: true,
-            kind: 'character search',
-            representation,
-            threshold: response.threshold,
-            candidates: response.candidates,
-        });
-    },
-});
-/**
- * What `bitmagic character add` will ask for, from its flags and the cached search.
- *
- * Pure, and separated from the command so the branch that matters — which of the
- * two forms was asked for, and whether the cache can answer it — is testable
- * without a project, a token or a network. It returns the character args rather
- * than a body so the shared `buildCharacterBody` still owns the wire shape.
- */
-export function resolveAddRequest(args) {
-    if (args.id === undefined) {
-        if (args.prompt === undefined) {
-            throw new CliError('Pass --id (from `bitmagic character search`) or --prompt to take the closest match.', 1, 'invalid_flag');
-        }
-        // The no-id form: the server searches with no floor and adds the best usable
-        // body, or fails without charging. Deliberately still available — "any of
-        // these will do" is a real request, and it is one call rather than two.
-        return {
-            name: args.name,
-            prompt: args.prompt,
-            applyToPlayer: args.applyToPlayer,
-            libraryOnly: true,
-            voxelize: defaultVoxelizeForProject(),
-        };
-    }
-    if (args.record === null) {
-        throw new CliError('No character search to pick from. Run `bitmagic character search --prompt "..."` first.', 1, 'no_search');
-    }
-    const candidate = findCachedCandidate(args.record, args.id);
-    if (candidate === null) {
-        const known = args.record.candidates.map((row) => row.sid).join(', ');
-        throw new CliError(`"${args.id}" was not in the last character search`
-            + (known === '' ? ' (it found nothing).' : `. It offered: ${known}.`)
-            + ' Run `bitmagic character search` again to pick from a fresh list.', 1, 'unknown_candidate');
-    }
-    return {
-        name: args.name,
-        // The CREATOR's brief, not the library row's own caption: this is what a
-        // regeneration re-drives, so it must describe what they asked for.
-        prompt: args.prompt ?? args.record.prompt,
-        applyToPlayer: args.applyToPlayer,
-        libraryPick: {
-            sid: candidate.sid,
-            assetUrl: candidate.assetUrl,
-            similarity: candidate.similarity,
-            ...(candidate.description ? { description: candidate.description } : {}),
-        },
-        // The shelf that produced the row decides the medium, not the project's art
-        // style at the moment of adding: mixing them would hand a low-poly game a
-        // pile of cubes.
-        voxelize: args.record.representation === 'voxel',
-    };
-}
-const addCommand = defineCommand({
-    meta: {
-        name: 'add',
-        description: 'Add a ready-made character from the library to world.json assets. Free; never forges.',
-    },
-    args: {
-        name: NAME_ARG,
-        id: {
-            type: 'string',
-            description: 'The id of a candidate from `bitmagic character search`. Omit to take the closest match to --prompt.',
-        },
-        prompt: {
-            type: 'string',
-            description: 'What the character should look like. Required without --id; with --id it defaults to the search that found it.',
-        },
-        'apply-to-player': APPLY_TO_PLAYER_ARG,
-        'original-prompt': ORIGINAL_PROMPT_FLAG,
-        json: JSON_FLAG,
-    },
-    async run({ args }) {
-        const json = args.json === true;
-        const { context } = await resolveRun(json);
-        const output = createOutput(json);
-        // Only the --id form consults the cache; the --prompt form is a fresh ask.
-        const record = args.id === undefined ? null : readCharacterSearch(context.root);
-        const request = resolveAddRequest({
-            name: args.name,
-            id: args.id,
-            prompt: args.prompt,
-            applyToPlayer: args['apply-to-player'],
-            record,
-        });
-        if (request.libraryPick) {
-            // The search's own date, not an expiry: age is worth seeing, and the
-            // catalogue only changes when somebody promotes to it.
-            output.info(`Adding ${request.libraryPick.sid} (${percent(request.libraryPick.similarity)} match`
-                + `${record?.searchedAt ? `, from the search on ${record.searchedAt.slice(0, 10)}` : ''}).`);
-        }
-        await runAssetGeneration('character', 'character', withParent(buildCharacterBody(request)), json);
-    },
-});
-export const characterCommand = defineCommand({
-    meta: {
-        name: 'character',
-        description: 'Forge a character, search the ready-made ones, or add one to your game.',
-    },
-    subCommands: {
-        generate: generateCommand,
-        search: searchCommand,
-        add: addCommand,
-    },
-});
-//# sourceMappingURL=character.js.map

package/dist/commands/character.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"character.js","sourceRoot":"","sources":["../../src/commands/character.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EAEzB,SAAS,EACT,cAAc,EACd,WAAW,EACX,cAAc,EACd,QAAQ,EACR,UAAU,EACV,YAAY,GACb,MAAM,+BAA+B,CAAC;AAcvC,MAAM,eAAe,GAAG,aAAa,CAAC;IACpC,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,6EAA6E;KAC3F;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,UAAU;QAClB,iBAAiB,EAAE,mBAAmB;QACtC,YAAY,EAAE,cAAc;QAC5B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,WAAW;QACpB,QAAQ,EAAE,YAAY;QACtB,YAAY,EAAE,cAAc;QAC5B,iBAAiB,EAAE,oBAAoB;QACvC,IAAI,EAAE,SAAS;KAChB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,IAAI,GAAG,kBAAkB,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,yBAAyB,EAAE;YACtD,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC3F,CAAC;CACF,CAAC,CAAC;AAEH,kFAAkF;AAClF,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAgC,EAChC,SAAiB,EACjB,GAA8B;IAE9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC5D,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAChC,yEAAyE;QACzE,4EAA4E;QAC5E,yEAAyE;QACzE,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QACnD,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9I,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,CAAC;AACV,CAAC;AAED,MAAM,aAAa,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iFAAiF;KAC/F;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,sCAAsC;SACpD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+CAA+C;SAC7D;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sFAAsF;SACpG;QACD,IAAI,EAAE,SAAS;KAChB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QAEhF,MAAM,cAAc,GAAG,CAAC,GAAmB,EAAE;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC;YAClC,yEAAyE;YACzE,qEAAqE;YACrE,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YAChH,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7C,MAAM,IAAI,QAAQ,CAAC,gDAAgD,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;YAC1F,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC;YAChC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc;SACf,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAC3B,WAAW,EACX,iCAAiC,KAAK,CAAC,QAAQ,EAAE,EAAE,EACnD,KAAK,EACL,OAAO,CACR,CAAC;QAEF,2EAA2E;QAC3E,4EAA4E;QAC5E,+CAA+C;QAC/C,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE;YACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,cAAc;YACd,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,KAAK,SAAS;gBAClD,CAAC,CAAC,oBAAoB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,6BAA6B;gBAClF,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,iBAAiB,cAAc,uBAAuB,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;YACjG,MAAM,CAAC,IAAI,CAAC,2EAA2E,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAC3G,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9K,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,eAAe,cAAc,sBAAsB,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;QACjH,gBAAgB,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAuB,CAAC;QAC1D,IAAI,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;YACzC,sEAAsE;YACtE,wEAAwE;YACxE,oBAAoB;YACpB,MAAM,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,6EAA6E,CAAC,CAAC;QAC3I,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,yCAAyC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;QAC/E,MAAM,CAAC,MAAM,CAAC;YACZ,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,kBAAkB;YACxB,cAAc;YACd,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAMjC;IACC,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,QAAQ,CAChB,qFAAqF,EACrF,CAAC,EACD,cAAc,CACf,CAAC;QACJ,CAAC;QACD,6EAA6E;QAC7E,0EAA0E;QAC1E,wEAAwE;QACxE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,yBAAyB,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAChB,yFAAyF,EACzF,CAAC,EACD,WAAW,CACZ,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,IAAI,QAAQ,CAChB,IAAI,IAAI,CAAC,EAAE,wCAAwC;cACjD,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,iBAAiB,KAAK,GAAG,CAAC;cACnE,mEAAmE,EACrE,CAAC,EACD,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;QACzC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,WAAW,EAAE;YACX,GAAG,EAAE,SAAS,CAAC,GAAG;YAClB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE;QACD,4EAA4E;QAC5E,0EAA0E;QAC1E,iBAAiB;QACjB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,KAAK,OAAO;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,aAAa,CAAC;IAC/B,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,uFAAuF;KACrG;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,EAAE,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qGAAqG;SACnH;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gHAAgH;SAC9H;QACD,iBAAiB,EAAE,mBAAmB;QACtC,iBAAiB,EAAE,oBAAoB;QACvC,IAAI,EAAE,SAAS;KAChB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;QAChC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAElC,2EAA2E;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,iBAAiB,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC;YACtC,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,qEAAqE;YACrE,uDAAuD;YACvD,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ;kBACnF,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,wBAAwB,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAC5F,CAAC;QACJ,CAAC;QACD,MAAM,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpG,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,yEAAyE;KACvF;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,UAAU;KAChB;CACF,CAAC,CAAC"}

package/dist/forge/edit-target.d.ts

@@ -1,30 +0,0 @@
-/**
- * `bitmagic forge --edit` — which level is being edited, and the request an
- * edit job is frozen with.
- *
- * Pure over the project's world.json so the resolution rules are testable
- * without a project on disk: `--level` names a level by id, by exact name, or
- * by a unique case-insensitive name; omitted, it means the ONE level this
- * project could edit, and anything else is refused with the candidates named.
- * A level can be edited when its `.vwld` asset records the forge job that
- * built it (or, for older levels, carries the job id in its source GLB key —
- * see `parentForgeJobId`).
- */
-import { type ForgeJobInput, type ForgeReusePlan, type ForgeArtifact } from '@bitmagic/world-forger/pipeline/index.js';
-import { type JsonObject } from '../project/world-json.js';
-export interface EditTarget {
-    levelId: string;
-    name: string;
-    vwldAssetId: string;
-    parentJobId: string;
-}
-export declare function resolveEditTarget(world: JsonObject, levelArg: string | undefined): EditTarget;
-/** The frozen request of an edit job: the level's own name, the parent it edits, the level it replaces. */
-export declare function buildEditJobInput(options: {
-    target: EditTarget;
-    editPrompt: string;
-    gameId: string;
-    groundPlane?: boolean;
-}): ForgeJobInput;
-/** A plan that reuses nothing — what a terminal frame without one means. */
-export declare function bakeEverythingPlan(artifact: ForgeArtifact, reason: string): ForgeReusePlan;