@bitmagic/cli 0.1.52-dev.0 → 0.1.52-dev.2

package/dist/browser-gl.js

@@ -37,18 +37,25 @@
 /** Chrome falls back to SwiftShader on its own; these force it, for machines with no GPU at all. */
 const SOFTWARE_GL_ARGS = ['--enable-unsafe-swiftshader', '--use-gl=angle', '--use-angle=swiftshader'];
 /**
- * Chrome flags for the GL backend, given the environment and platform.
+ * Whether software GL is in force rather than the machine's real GPU.
  *
- * Software GL is used when `CI=true` (GitHub-hosted runners have no GPU, and asking ANGLE for a
- * Vulkan device there just wastes the startup) or when `BITMAGIC_BROWSER_SOFTWARE_GL=true`, the
- * escape hatch for a machine whose driver makes the GPU path worse than the software one.
+ * True on CI (GitHub-hosted runners have no GPU, and asking ANGLE for a Vulkan device there just
+ * wastes the startup), and under `BITMAGIC_BROWSER_SOFTWARE_GL=true` — the escape hatch for a
+ * machine whose driver makes the GPU path worse than the software one.
+ */
+function usesSoftwareGl(env) {
+    return env.CI === 'true' || env.BITMAGIC_BROWSER_SOFTWARE_GL === 'true';
+}
+/**
+ * Chrome flags for the GL backend, given the environment and platform.
  *
- * Everywhere else the real GPU is requested. The Vulkan flags are Linux-only because they are only
- * a fix there: macOS headless already reaches the GPU through ANGLE's Metal backend, and asking it
- * for Vulkan would take that away.
+ * Software GL is forced wherever `usesSoftwareGl` holds. Everywhere else the real GPU is
+ * requested. The Vulkan flags are Linux-only because they are only a fix there: macOS headless
+ * already reaches the GPU through ANGLE's Metal backend, and asking it for Vulkan would take that
+ * away.
  */
 export function browserGlArgs(env, platform = process.platform) {
-    if (env.CI === 'true' || env.BITMAGIC_BROWSER_SOFTWARE_GL === 'true')
+    if (usesSoftwareGl(env))
         return [...SOFTWARE_GL_ARGS];
     if (platform !== 'linux')
         return ['--enable-unsafe-swiftshader'];
@@ -88,31 +95,52 @@ export function browserRendererArgs(env, renderer, platform = process.platform)
  */
 function mergeEnableFeatures(args, features) {
     const PREFIX = '--enable-features=';
-    const merged = [];
-    for (const arg of args) {
-        if (!arg.startsWith(PREFIX))
-            continue;
-        for (const value of arg.slice(PREFIX.length).split(',')) {
-            if (value !== '' && !merged.includes(value))
-                merged.push(value);
-        }
-    }
-    for (const value of features) {
-        if (!merged.includes(value))
-            merged.push(value);
-    }
-    return [...args.filter((arg) => !arg.startsWith(PREFIX)), `${PREFIX}${merged.join(',')}`];
+    const present = args
+        .filter((arg) => arg.startsWith(PREFIX))
+        .flatMap((arg) => arg.slice(PREFIX.length).split(','));
+    const merged = new Set([...present, ...features].filter((value) => value !== ''));
+    return [...args.filter((arg) => !arg.startsWith(PREFIX)), `${PREFIX}${[...merged].join(',')}`];
+}
+/** An off-screen position keeps the headed window out of sight without occluding-throttle risk. */
+const HEADED_OFFSCREEN_ARGS = [
+    '--window-position=-2400,-2400',
+    '--disable-backgrounding-occluded-windows',
+];
+function hasDisplay(env) {
+    return Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
+}
+export function browserLaunchPlan(env, renderer, platform = process.platform) {
+    const args = browserRendererArgs(env, renderer, platform);
+    const headedWebgpu = renderer === 'webgpu'
+        && platform === 'linux'
+        && !usesSoftwareGl(env)
+        && hasDisplay(env);
+    if (!headedWebgpu)
+        return { headless: true, args };
+    return {
+        headless: false,
+        args: [...args.filter((arg) => arg !== '--disable-gpu-compositing'), ...HEADED_OFFSCREEN_ARGS],
+    };
+}
+/**
+ * The plan for the automatic software-GL re-run: `browserLaunchPlan` as if
+ * `BITMAGIC_BROWSER_SOFTWARE_GL=true` had been set.
+ *
+ * Both verify paths (one-shot and `--watch`) relaunch through this after `shouldRetrySoftwareGl`
+ * says the machine's GPU stack is the likely culprit, so neither has to know which env var forces
+ * the fallback.
+ */
+export function softwareGlLaunchPlan(env, renderer, platform = process.platform) {
+    return browserLaunchPlan({ ...env, BITMAGIC_BROWSER_SOFTWARE_GL: 'true' }, renderer, platform);
 }
 /**
  * Whether a failed run is worth one automatic re-run on software GL.
  *
  * A lost WebGL context is a property of the machine's GPU/driver/compositor stack, not of the
  * game (see the file header) — the software path sidesteps that stack entirely. Pointless when
- * software GL was already in effect, which is what the env checks establish.
+ * software GL was already in effect, which is what `usesSoftwareGl` establishes.
  */
 export function shouldRetrySoftwareGl(observations, env) {
-    return (observations.webglContextLost
-        && env.CI !== 'true'
-        && env.BITMAGIC_BROWSER_SOFTWARE_GL !== 'true');
+    return observations.webglContextLost && !usesSoftwareGl(env);
 }
 //# sourceMappingURL=browser-gl.js.map

package/dist/browser-gl.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-gl.js","sourceRoot":"","sources":["../src/browser-gl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAUH,oGAAoG;AACpG,MAAM,gBAAgB,GAAG,CAAC,6BAA6B,EAAE,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;AAEtG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAuC,EACvC,WAAqB,OAAO,CAAC,QAAQ;IAErC,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,IAAI,GAAG,CAAC,4BAA4B,KAAK,MAAM;QAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC;IACnG,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACjE,OAAO;QACL,oBAAoB;QACpB,0BAA0B;QAC1B,6FAA6F;QAC7F,uEAAuE;QACvE,wBAAwB;QACxB,cAAc;QACd,2FAA2F;QAC3F,mBAAmB;QACnB,2BAA2B;QAC3B,6BAA6B;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAuC,EACvC,QAAwB,EACxB,WAAqB,OAAO,CAAC,QAAQ;IAErC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,mBAAmB,CAAC,CAAC,GAAG,IAAI,EAAE,wBAAwB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,IAAc,EAAE,QAAkB;IAC7D,MAAM,MAAM,GAAG,oBAAoB,CAAC;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QACtC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACxD,IAAI,KAAK,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAA2C,EAC3C,GAAuC;IAEvC,OAAO,CACL,YAAY,CAAC,gBAAgB;WAC1B,GAAG,CAAC,EAAE,KAAK,MAAM;WACjB,GAAG,CAAC,4BAA4B,KAAK,MAAM,CAC/C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"browser-gl.js","sourceRoot":"","sources":["../src/browser-gl.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -229,6 +229,7 @@ declare const rawCommands: {
         };
     }>;
     generate: CommandDef<ArgsDef>;
+    assets: CommandDef<ArgsDef>;
     cover: CommandDef<{
         readonly prompt: {
             readonly type: "string";
@@ -251,6 +252,20 @@ declare const rawCommands: {
             readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";
         };
     }>;
+    judge: CommandDef<{
+        readonly genre: {
+            readonly type: "string";
+            readonly description: "Genre hint for the rubric: platformer, racing, shooter, combat, driving, tower-defense.";
+        };
+        readonly 'min-score': {
+            readonly type: "string";
+            readonly description: "Fail (exit 4) when the overall score is below this 1-10 bar. Without it the judge informs and exits 0.";
+        };
+        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";
@@ -280,6 +295,10 @@ declare const rawCommands: {
             readonly type: "boolean";
             readonly description: "Build a custom place (arena, fortress, camp).";
         };
+        readonly 'make-start': {
+            readonly type: "boolean";
+            readonly description: "Boot the game into this level. Without it, only a game's FIRST forge becomes the start level, so a later forge lands in the level list unseen.";
+        };
         readonly json: {
             readonly type: "boolean";
             readonly description: "Print the result as JSON on stdout; all progress goes to stderr.";

package/dist/cli.js

@@ -18,7 +18,9 @@ import { reloadCommand } from './commands/reload.js';
 import { verifyCommand } from './commands/verify.js';
 import { buildCommand } from './commands/build.js';
 import { generateCommand } from './commands/generate.js';
+import { assetsCommand } from './commands/assets.js';
 import { coverCommand } from './commands/cover.js';
+import { judgeCommand } from './commands/judge.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
@@ -184,7 +186,9 @@ const rawCommands = {
     verify: verifyCommand,
     build: buildCommand,
     generate: generateCommand,
+    assets: assetsCommand,
     cover: coverCommand,
+    judge: judgeCommand,
     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/assets.d.ts

@@ -0,0 +1,62 @@
+import { type AddAssetResult, type VoxelizeGlb } from '../assets/add.js';
+import { type AssetRow } from '../assets/list.js';
+/** The Creator's voxelize-dialog defaults (assetsVoxelizeDialog.ts), so a plain `add` bakes the same way. */
+export declare const DEFAULT_MIN_VOXEL_SIZE = 0.1;
+export declare const DEFAULT_MAX_VOXEL_SIZE = 0.5;
+export interface AssetsRunDeps {
+    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 getAccessToken/readDefaultEnvironment read ~/.bitmagic. */
+    baseDir?: string;
+    /** Test-only override for the headless bake, so the GLB path runs without Chrome. */
+    voxelize?: VoxelizeGlb;
+    log: (message: string) => void;
+}
+/**
+ * Whether to fill the model's interior with voxels.
+ *
+ * `--hollow` and `--solid` are explicit; otherwise this mirrors `generate prop`'s size rule
+ * (`shouldFillInterior`), which the web lane has always applied: prop-scale objects fill solid so
+ * nothing reads as a shell when the camera clips inside, while building-scale ones stay hollow
+ * because a solid-filled building is millions of wasted voxels. `assets add` has no `fitBox`, so
+ * the only size it knows is `--height` — enough to catch the case that actually hurts.
+ */
+export declare const SOLID_FILL_MAX_HEIGHT_M = 6;
+export interface AddOptions {
+    file: string;
+    name?: string;
+    assetId?: string;
+    keepGlb: boolean;
+    force: boolean;
+    voxelSize?: string;
+    maxVoxelSize?: string;
+    height?: string;
+    hollow: boolean;
+    solid: boolean;
+    json: boolean;
+    deps?: AssetsRunDeps;
+}
+export declare function runAssetsAdd(options: AddOptions): Promise<AddAssetResult>;
+export declare function runAssetsList(options: {
+    json: boolean;
+    deps?: AssetsRunDeps;
+}): Promise<AssetRow[]>;
+export interface RemoveOptions {
+    assetId: string;
+    force: boolean;
+    json: boolean;
+    deps?: AssetsRunDeps;
+}
+export interface RemoveResult {
+    assetId: string;
+    name: string;
+    /** Placed instances removed alongside the asset (only ever non-zero under --force). */
+    instancesRemoved: number;
+    /** References that remain, by path — under --force only. */
+    remainingReferences: string[];
+}
+export declare function runAssetsRemove(options: RemoveOptions): Promise<RemoveResult>;
+export declare const assetsCommand: import("citty").CommandDef<import("citty").ArgsDef>;

package/dist/commands/assets.js

@@ -0,0 +1,359 @@
+/**
+ * `bitmagic assets add | list | remove` — the game's asset registry, from the command line.
+ *
+ * `add` is the pro lane's answer to the Creator's Assets-tab upload: a creator's own `.glb`, `.vxl`,
+ * image, audio or JSON file goes into storage and into `src/work/world.json`. `list` and `remove`
+ * are local — they read and edit that file and talk to nobody.
+ *
+ * Same conventions as `bitmagic generate`: kebab-case flags, `--json` for the result document,
+ * prose through `log`, every pre-write failure ending "world.json is unchanged.", and the exit
+ * code / failure category of a CliError carried across untouched.
+ */
+import { defineCommand } from 'citty';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { createOutput } from '../output.js';
+import { loadProjectContext } from '../project/context.js';
+import { withJobRecord } from '../project/jobs.js';
+import { readWorldJson } from '../project/world-json.js';
+import { resolveEnvironmentForCommand, resolveAuth0ClientId } from '../config/environments.js';
+import { getAccessToken } from '../auth/session.js';
+import { addAssetFile } from '../assets/add.js';
+import { ACCEPTED_EXTENSIONS, classifyAssetFile, uploadFilename, validateAssetName } from '../assets/file-kind.js';
+import { formatAssetTable, summarizeAssets } from '../assets/list.js';
+import { planAssetRemoval } from '../assets/remove.js';
+import { applyModificationsToWorld } from '../forge/apply-modifications.js';
+import { projectWorldJsonPath } from '../forge/run-pipeline.js';
+import { removePreview } from '../editor/previews.js';
+/** The Creator's voxelize-dialog defaults (assetsVoxelizeDialog.ts), so a plain `add` bakes the same way. */
+export const DEFAULT_MIN_VOXEL_SIZE = 0.1;
+export const DEFAULT_MAX_VOXEL_SIZE = 0.5;
+function defaultDeps(json) {
+    const output = createOutput(json);
+    return {
+        fetch: globalThis.fetch,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        log: output.info,
+    };
+}
+/**
+ * Whether to fill the model's interior with voxels.
+ *
+ * `--hollow` and `--solid` are explicit; otherwise this mirrors `generate prop`'s size rule
+ * (`shouldFillInterior`), which the web lane has always applied: prop-scale objects fill solid so
+ * nothing reads as a shell when the camera clips inside, while building-scale ones stay hollow
+ * because a solid-filled building is millions of wasted voxels. `assets add` has no `fitBox`, so
+ * the only size it knows is `--height` — enough to catch the case that actually hurts.
+ */
+export const SOLID_FILL_MAX_HEIGHT_M = 6;
+function resolveFillInterior(options, targetHeight) {
+    if (options.solid)
+        return true;
+    if (options.hollow)
+        return false;
+    return targetHeight === undefined || targetHeight <= SOLID_FILL_MAX_HEIGHT_M;
+}
+/** Same contract as generate.ts's: only the message changes, exit code and category survive. */
+function decoratedError(error, decorate) {
+    return error instanceof CliError
+        ? new CliError(decorate(error.message), error.exitCode, error.code)
+        : error;
+}
+/**
+ * Resolve the project and read its world.json, with every failure carrying the lane's guarantee.
+ *
+ * Shared by all three subcommands: `list` and `remove` used to skip the decoration entirely, so a
+ * malformed world.json or a missing project answered them in different words than `add` — and
+ * `remove`'s schema-gate refusal, the one a caller most needs the guarantee on, carried none.
+ */
+function readProject(runDeps) {
+    try {
+        const context = loadProjectContext(runDeps.startDir);
+        return { context, world: readWorldJson(projectWorldJsonPath(context.root)) };
+    }
+    catch (error) {
+        throw decoratedError(error, unchanged);
+    }
+}
+/** Appends the unchanged-world guarantee unless the message already makes it. */
+function unchanged(message) {
+    return message.includes('world.json is unchanged') ? message : `${message} world.json is unchanged.`;
+}
+/**
+ * A decimal number and nothing else. `Number()` alone accepts `0x10` (16), `0b11`, `1e300`, `' 5 '`
+ * and `''` (0), so `--height 0x10` used to silently scale a model to 16 metres. Every rejection
+ * carries the unchanged-world guarantee, since these run before anything is read or uploaded.
+ */
+const DECIMAL = /^-?\d+(\.\d+)?$/;
+function parseNumberFlag(flagName, raw, options = {}) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!DECIMAL.test(trimmed)) {
+        throw new CliError(`--${flagName} must be a decimal number, got ${JSON.stringify(raw)}. world.json is unchanged.`);
+    }
+    const value = Number(trimmed);
+    if (!Number.isFinite(value)) {
+        throw new CliError(`--${flagName} must be a number, got ${JSON.stringify(raw)}. world.json is unchanged.`);
+    }
+    if (options.min !== undefined && value < options.min) {
+        throw new CliError(`--${flagName} must be at least ${options.min}, got ${value}. world.json is unchanged.`);
+    }
+    if (options.max !== undefined && value > options.max) {
+        throw new CliError(`--${flagName} must be at most ${options.max}, got ${value}. world.json is unchanged.`);
+    }
+    return value;
+}
+export async function runAssetsAdd(options) {
+    const output = createOutput(options.json);
+    const runDeps = options.deps ?? defaultDeps(options.json);
+    // Flags first: a typo costs nothing and names itself.
+    const minVoxelSize = parseNumberFlag('voxel-size', options.voxelSize, { min: 0.01, max: 1 }) ?? DEFAULT_MIN_VOXEL_SIZE;
+    const maxVoxelSize = parseNumberFlag('max-voxel-size', options.maxVoxelSize, { min: 0.01, max: 4 }) ?? DEFAULT_MAX_VOXEL_SIZE;
+    if (maxVoxelSize < minVoxelSize) {
+        throw new CliError(`--max-voxel-size (${maxVoxelSize}) must be at least --voxel-size (${minVoxelSize}). world.json is unchanged.`);
+    }
+    const targetHeight = parseNumberFlag('height', options.height, { min: 0.01, max: 1000 });
+    if (options.hollow && options.solid) {
+        throw new CliError('Pass either --hollow or --solid, not both. world.json is unchanged.');
+    }
+    if (options.assetId !== undefined && options.assetId.trim() === '') {
+        throw new CliError('--asset-id was given with an empty value. Pass a real asset id (see `bitmagic assets list`), '
+            + 'or omit the flag to mint a new one. world.json is unchanged.');
+    }
+    let context;
+    try {
+        context = loadProjectContext(runDeps.startDir);
+    }
+    catch (error) {
+        throw decoratedError(error, unchanged);
+    }
+    const environment = resolveEnvironmentForCommand({ cwd: context.root, baseDir: runDeps.baseDir });
+    let token;
+    try {
+        token = await getAccessToken(environment, resolveAuth0ClientId(environment), { fetch: runDeps.fetch, sleep: runDeps.sleep, now: runDeps.now }, runDeps.baseDir);
+    }
+    catch (error) {
+        throw decoratedError(error, unchanged);
+    }
+    // Refuse a format or name this lane cannot take BEFORE a job record exists: a `.gltf` typed by
+    // mistake should not leave a failed "upload" in `.bitmagic/jobs/` or nudge about `bitmagic dev`.
+    const filePath = path.resolve(options.file);
+    classifyAssetFile(filePath, { keepGlb: options.keepGlb });
+    uploadFilename(filePath);
+    if (options.name !== undefined)
+        validateAssetName(options.name);
+    const result = await withJobRecord({
+        root: context.root,
+        kind: 'upload',
+        label: path.basename(filePath),
+        ...(options.assetId !== undefined ? { assetId: options.assetId } : {}),
+        log: runDeps.log,
+    }, async (log) => {
+        try {
+            return await addAssetFile({
+                context,
+                environment,
+                token,
+                filePath,
+                ...(options.name !== undefined ? { name: options.name } : {}),
+                ...(options.assetId !== undefined ? { assetId: options.assetId } : {}),
+                keepGlb: options.keepGlb,
+                force: options.force,
+                voxel: {
+                    minVoxelSize,
+                    maxVoxelSize,
+                    ...(targetHeight !== undefined ? { targetHeight } : {}),
+                    fillInterior: resolveFillInterior(options, targetHeight),
+                },
+                fetchImpl: runDeps.fetch,
+                ...(runDeps.voxelize !== undefined ? { voxelize: runDeps.voxelize } : {}),
+                log,
+            });
+        }
+        catch (error) {
+            throw decoratedError(error, unchanged);
+        }
+    });
+    // A replacement reuses an id, and previews are keyed by id and never otherwise invalidated — so
+    // without this the dev view keeps drawing the OLD asset's thumbnail for the new one, forever.
+    // The same reason `assets remove` drops it.
+    if (result.replaced)
+        removePreview(context.root, result.assetId);
+    for (const note of result.notes)
+        runDeps.log(`note: ${note}`);
+    runDeps.log(`${result.replaced ? 'Replaced' : 'Added'} "${result.name}" (${result.type}, id ${result.assetId}) in world.json.`);
+    output.result({ ok: true, kind: 'asset', ...result });
+    runDeps.log('A running `bitmagic dev` reloads the browser by itself to show it.');
+    return result;
+}
+// ============================================================================
+// list
+// ============================================================================
+export async function runAssetsList(options) {
+    const output = createOutput(options.json);
+    const runDeps = options.deps ?? defaultDeps(options.json);
+    // Read-only, but it still carries the guarantee: an agent greps for this sentence to know it
+    // does not have to go and diff world.json itself.
+    const { world } = readProject(runDeps);
+    const rows = summarizeAssets(world);
+    const assets = Array.isArray(world.assets) ? world.assets : [];
+    if (options.json) {
+        // The raw records, not the table's summary of them: an agent reading this wants every field
+        // the engine will see (boundingBox, vehicleFitment, production, ...), plus the two counts —
+        // `placed` and the full `references` the remove command refuses on.
+        output.result({
+            ok: true,
+            count: rows.length,
+            assets,
+            placed: Object.fromEntries(rows.map((row) => [row.id, row.placed])),
+            references: Object.fromEntries(rows.map((row) => [row.id, row.references])),
+        });
+    }
+    else {
+        runDeps.log(formatAssetTable(rows));
+    }
+    return rows;
+}
+export async function runAssetsRemove(options) {
+    const output = createOutput(options.json);
+    const runDeps = options.deps ?? defaultDeps(options.json);
+    const { context, world } = readProject(runDeps);
+    const worldPath = projectWorldJsonPath(context.root);
+    const plan = planAssetRemoval(world, options.assetId, options.force);
+    try {
+        applyModificationsToWorld(worldPath, plan.modifications, { subject: 'Removing the asset' });
+    }
+    catch (error) {
+        throw decoratedError(error, unchanged);
+    }
+    removePreview(context.root, options.assetId);
+    const name = typeof plan.asset.name === 'string' ? plan.asset.name : options.assetId;
+    const remaining = plan.otherReferences.map((ref) => ref.path);
+    runDeps.log(`Removed "${name}" (${options.assetId}) from world.json`
+        + (plan.placedInstances > 0
+            ? ` along with ${plan.placedInstances} placed instance${plan.placedInstances === 1 ? '' : 's'}`
+            : '')
+        + '. The uploaded file stays in storage.');
+    for (const ref of remaining)
+        runDeps.log(`warning: ${ref} still names this asset — fix it or the game will not find it.`);
+    const result = {
+        assetId: options.assetId, name, instancesRemoved: plan.placedInstances, remainingReferences: remaining,
+    };
+    output.result({ ok: true, kind: 'asset-removed', ...result });
+    runDeps.log('A running `bitmagic dev` reloads the browser by itself.');
+    return result;
+}
+// ============================================================================
+// Subcommands
+// ============================================================================
+const JSON_FLAG = {
+    type: 'boolean',
+    description: 'Print the result as JSON on stdout; all progress goes to stderr.',
+};
+const addCommand = defineCommand({
+    meta: {
+        name: 'add',
+        description: `Upload one of your own files (${ACCEPTED_EXTENSIONS.map((e) => `.${e}`).join(' ')}) into the game's assets.`,
+    },
+    args: {
+        file: { type: 'positional', required: true, description: 'The file to add.' },
+        name: {
+            type: 'string',
+            description: 'Asset name; defaults to the filename without its extension.',
+        },
+        'asset-id': {
+            type: 'string',
+            description: 'Store under this asset_… id instead of minting one; re-running with the same id replaces the asset.',
+        },
+        'keep-glb': {
+            type: 'boolean',
+            description: 'Register a .glb as a polygon mesh instead of voxelizing it.',
+        },
+        'voxel-size': {
+            type: 'string',
+            description: `Finest voxel size in metres when voxelizing a .glb (default ${DEFAULT_MIN_VOXEL_SIZE}).`,
+        },
+        'max-voxel-size': {
+            type: 'string',
+            description: `Coarsest voxel size for flat areas (default ${DEFAULT_MAX_VOXEL_SIZE}; equal to --voxel-size for a uniform grid).`,
+        },
+        height: {
+            type: 'string',
+            description: 'Scale a .glb to this height in metres. Omit to keep its own size (2 m for --keep-glb).',
+        },
+        hollow: {
+            type: 'boolean',
+            description: 'Bake a .glb as a closed shell rather than filling its interior.',
+        },
+        solid: {
+            type: 'boolean',
+            description: `Fill a .glb's interior even when --height is over ${SOLID_FILL_MAX_HEIGHT_M} m (the default fills only below that).`,
+        },
+        force: {
+            type: 'boolean',
+            description: 'With --asset-id, replace a still-referenced asset even when the type changes.',
+        },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        await runAssetsAdd({
+            file: args.file,
+            // `!== undefined`, NOT truthiness. citty hands back `''` both for a flag given with no value
+            // and for one whose shell variable was empty (`--asset-id "$ID"` with ID unset), and a
+            // truthiness guard dropped the key entirely — so `--asset-id ''` silently minted a NEW id and
+            // ADDED a duplicate instead of replacing, and `--voxel-size ''` silently used the default.
+            // Passing `''` through lets the validators below reject it by name.
+            ...(args.name !== undefined ? { name: args.name } : {}),
+            ...(args['asset-id'] !== undefined ? { assetId: args['asset-id'] } : {}),
+            keepGlb: args['keep-glb'] === true,
+            force: args.force === true,
+            ...(args['voxel-size'] !== undefined ? { voxelSize: args['voxel-size'] } : {}),
+            ...(args['max-voxel-size'] !== undefined ? { maxVoxelSize: args['max-voxel-size'] } : {}),
+            ...(args.height !== undefined ? { height: args.height } : {}),
+            hollow: args.hollow === true,
+            solid: args.solid === true,
+            json: args.json === true,
+        });
+    },
+});
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List the assets in world.json: id, name, type, size, placed count.' },
+    args: { json: JSON_FLAG },
+    async run({ args }) {
+        await runAssetsList({ json: args.json === true });
+    },
+});
+const removeCommand = defineCommand({
+    meta: {
+        name: 'remove',
+        description: 'Remove an asset from world.json. The uploaded file stays in storage.',
+    },
+    args: {
+        'asset-id': { type: 'positional', required: true, description: 'The asset id (see `bitmagic assets list`).' },
+        force: {
+            type: 'boolean',
+            description: 'Remove even if the asset is still referenced; its placed instances are removed with it.',
+        },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        await runAssetsRemove({
+            assetId: args['asset-id'],
+            force: args.force === true,
+            json: args.json === true,
+        });
+    },
+});
+export const assetsCommand = defineCommand({
+    meta: {
+        name: 'assets',
+        description: 'Add your own files to the game\'s assets, list them, or remove one.',
+    },
+    subCommands: {
+        add: addCommand,
+        list: listCommand,
+        remove: removeCommand,
+    },
+});
+//# sourceMappingURL=assets.js.map