@bitmagic/cli 0.1.65-dev.8 → 0.1.65

package/dist/editor/shell-page.js

@@ -2166,6 +2166,11 @@ ${ASSET_DETAIL_HTML}
   var assetLoadTimer = null;
   // The asset the overlay is showing, for the Edit voxels action. Null whenever it is closed.
   var assetDetailAsset = null;
+  // The rigged GLB the built-in clip pills play on — empty for everything that is not a character.
+  var assetClipUrl = '';
+  // Triangles arrive with the viewer's READY, and the clip pills reopen the viewer more than once
+  // per dialog. Without this the fact list grows a duplicate row on every trip back to Model.
+  var assetTriangleShown = false;
 
   var IMAGE_TYPES = { image: true, skybox: true };
   var AUDIO_TYPES = { audio: true, sound: true, 'sound-effect': true };
@@ -2216,6 +2221,7 @@ ${ASSET_DETAIL_HTML}
       + (asset.type || 'unknown');
 
     assetFacts.textContent = '';
+    assetTriangleShown = false;
     fact('Size', formatSize(asset.size));
     fact('Length', typeof asset.durationSeconds === 'number' && asset.durationSeconds > 0
       ? asset.durationSeconds.toFixed(1) + 's' : '');
@@ -2235,6 +2241,14 @@ ${ASSET_DETAIL_HTML}
     // The asset's own file, for the types a browser can show without a renderer.
     var direct = typeof asset.url === 'string' ? asset.url : '';
 
+    // A built-in clip needs a rigged body to play on, and a character asset is exactly that: a
+    // GLB on the standard Mixamo skeleton. Every other type keeps the row out of sight rather
+    // than disabled, for the reason Edit voxels does.
+    var characterJob = type === 'character' ? glbJobFor(asset) : null;
+    assetClipUrl = characterJob === null ? '' : characterJob.url;
+    document.getElementById('asset-clips').classList.toggle('hidden', assetClipUrl === '');
+    setActiveClip('');
+
     // '=== true' rather than a truthy read: a type of 'constructor' would otherwise find
     // Object.prototype's own property and pass for an image.
     if (IMAGE_TYPES[type] === true && direct) {
@@ -2312,6 +2326,7 @@ ${ASSET_DETAIL_HTML}
   function closeAssetDetail() {
     if (!assetOverlay.classList.contains('show')) return false;
     assetDetailAsset = null;
+    assetClipUrl = '';
     assetOverlay.classList.remove('show');
     if (assetLoadTimer) clearTimeout(assetLoadTimer);
     // about:blank rather than hiding it: an idle iframe would hold a WebGL context and a render
@@ -2346,7 +2361,8 @@ ${ASSET_DETAIL_HTML}
     if (message.type === 'ASSET_PREVIEW_READY') {
       if (assetLoadTimer) clearTimeout(assetLoadTimer);
       assetNote.classList.add('hidden');
-      if (typeof message.triangles === 'number' && message.triangles > 0) {
+      if (typeof message.triangles === 'number' && message.triangles > 0 && !assetTriangleShown) {
+        assetTriangleShown = true;
         fact('Triangles', message.triangles.toLocaleString());
       }
     } else if (message.type === 'ASSET_PREVIEW_FAILED') {
@@ -2394,6 +2410,52 @@ ${ASSET_DETAIL_HTML}
     post('EDIT_VOXEL_ASSET', { assetId: assetId });
   }
 
+  /**
+   * The built-in animation pills — the dev view's answer to "what does this character look like
+   * moving?", which a still mesh cannot show.
+   *
+   * The pills carry NAMES, not URLs, and /animation-preview resolves them against the project's
+   * own engine/AnimationAssets.js. That is deliberate: the animation library lives in a
+   * datetime-stamped folder that changes on every publish, and which of the two tables is live is
+   * the engine's decision. A copy of either here would go stale with nothing to catch it, and
+   * would show a creator a clip their game does not actually play.
+   *
+   * The empty name is the Model pill: back to the still asset viewer, which is what the dialog
+   * opens on. Reset view goes with it — it speaks to the orbit viewer only, and a dead button on
+   * a playing clip is worse than no button.
+   */
+  function setActiveClip(name) {
+    var pills = document.querySelectorAll('#asset-clip-row button');
+    for (var i = 0; i < pills.length; i++) {
+      // The accent, not --pressed: this is a tab-like selector, and DESIGN.md spends aquamarine on
+      // the active tab. --pressed reads as the same dark pill as its neighbours at this size, which
+      // left the creator with no way to tell which clip was playing. Edit voxels is hidden for a
+      // character asset, so this is still the one primary on the surface.
+      pills[i].classList.toggle('bm-pill--primary', pills[i].getAttribute('data-clip') === name);
+    }
+  }
+
+  function playAssetClip(name) {
+    if (assetClipUrl === '') return;
+    setActiveClip(name);
+    assetNote.classList.add('hidden');
+    if (assetLoadTimer) clearTimeout(assetLoadTimer);
+    assetImage.classList.add('hidden');
+    assetResetButton.classList.toggle('hidden', name !== '');
+    assetFrame.classList.remove('hidden');
+    assetFrame.src = name === ''
+      ? '/asset-preview?kind=glb&url=' + encodeURIComponent(assetClipUrl)
+      : '/animation-preview?character=' + encodeURIComponent(assetClipUrl)
+        + '&clip=' + encodeURIComponent(name);
+    assetLoadTimer = setTimeout(function () {
+      showAssetNote('Still loading. If this does not clear, check the dev server output.');
+    }, 12000);
+  }
+
+  document.getElementById('asset-clip-row').addEventListener('click', function (event) {
+    var button = event.target.closest('button[data-clip]');
+    if (button) playAssetClip(button.getAttribute('data-clip'));
+  });
   document.getElementById('asset-edit-voxels').addEventListener('click', function () {
     void startVoxelEditFromOverlay();
   });

package/dist/editor/shell-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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EAAE;;;;;;;;0BAQF,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4hCvC,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA01C1C,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmChB,CAAC;AACF,CAAC"}
+{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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EAAE;;;;;;;;0BAQF,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4hCvC,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAw5C1C,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmChB,CAAC;AACF,CAAC"}

package/dist/forge/prune-store.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Forge-store housekeeping — the job directories under `.bitmagic/forge` that
+ * nothing will read again are removed once a forge has landed.
+ *
+ * Every edit is a NEW job and the level keeps only its newest job's id, so a
+ * level edited a dozen times leaves a dozen finished job directories behind
+ * (dev-games/alien held 13, 6 MB, after one afternoon). A job is kept while
+ * anything could still want it:
+ *
+ *  - an asset of the world names it as its forge job (`parentForgeJobId`, the
+ *    same reading `--edit` uses) — that is the parent an edit reuses bakes from;
+ *  - it is the job that just ran;
+ *  - it never finished (no `persisted` record) — an unfinished job is what
+ *    `--resume` continues, and its local bakes are the progress a resume keeps.
+ *
+ * The server's copy of every job is untouched: it is what a resume or an edit
+ * from another machine reads, and its lifetime is the server's call. The
+ * resolution is pure over world.json and a listing, so the rules are testable
+ * without a project on disk; the removal is best-effort, since a directory
+ * that will not delete must never fail a forge that has already landed.
+ */
+import { type JsonObject } from '../project/world-json.js';
+export interface ForgeJobDir {
+    jobId: string;
+    /** The job wrote its `persisted` record: world.json has what it built. */
+    finished: boolean;
+}
+/** The job ids the world's assets name — the jobs an edit could reuse bakes from. */
+export declare function referencedForgeJobs(world: JsonObject): Set<string>;
+/** Of `jobs`, the finished ones neither the world nor `keep` refers to, in listing order. */
+export declare function staleForgeJobs(world: JsonObject, jobs: ReadonlyArray<ForgeJobDir>, keep: ReadonlyArray<string>): string[];
+/** `<root>/.bitmagic/forge/worlds/v3/forged-work` — the store's job directories, by the shared key layout. */
+export declare function forgeJobsDir(projectRoot: string): string;
+/** The store's job directories, finished or not; an absent store lists nothing. */
+export declare function listForgeJobDirs(projectRoot: string): ForgeJobDir[];
+/**
+ * Remove the finished jobs the project no longer refers to. One line when
+ * something was removed, a warning when something would not go; silent otherwise.
+ */
+export declare function pruneForgeStore(options: {
+    projectRoot: string;
+    world: JsonObject;
+    /** Jobs to keep whatever the world says — the one that just ran. */
+    keep: ReadonlyArray<string>;
+    log: (message: string) => void;
+}): string[];

package/dist/forge/prune-store.js

@@ -0,0 +1,86 @@
+/**
+ * Forge-store housekeeping — the job directories under `.bitmagic/forge` that
+ * nothing will read again are removed once a forge has landed.
+ *
+ * Every edit is a NEW job and the level keeps only its newest job's id, so a
+ * level edited a dozen times leaves a dozen finished job directories behind
+ * (dev-games/alien held 13, 6 MB, after one afternoon). A job is kept while
+ * anything could still want it:
+ *
+ *  - an asset of the world names it as its forge job (`parentForgeJobId`, the
+ *    same reading `--edit` uses) — that is the parent an edit reuses bakes from;
+ *  - it is the job that just ran;
+ *  - it never finished (no `persisted` record) — an unfinished job is what
+ *    `--resume` continues, and its local bakes are the progress a resume keeps.
+ *
+ * The server's copy of every job is untouched: it is what a resume or an edit
+ * from another machine reads, and its lifetime is the server's call. The
+ * resolution is pure over world.json and a listing, so the rules are testable
+ * without a project on disk; the removal is best-effort, since a directory
+ * that will not delete must never fail a forge that has already landed.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { forgeArtifactKey, parentForgeJobId } from '@bitmagic/world-forger/pipeline/index.js';
+import { FORGE_STORE_DIR } from './local-store.js';
+import { isJsonObject } from '../project/world-json.js';
+/** The job ids the world's assets name — the jobs an edit could reuse bakes from. */
+export function referencedForgeJobs(world) {
+    const assets = Array.isArray(world.assets) ? world.assets.filter(isJsonObject) : [];
+    const jobs = new Set();
+    for (const asset of assets) {
+        const jobId = parentForgeJobId(asset);
+        if (jobId !== null)
+            jobs.add(jobId);
+    }
+    return jobs;
+}
+/** Of `jobs`, the finished ones neither the world nor `keep` refers to, in listing order. */
+export function staleForgeJobs(world, jobs, keep) {
+    const referenced = referencedForgeJobs(world);
+    for (const jobId of keep)
+        referenced.add(jobId);
+    return jobs.filter((job) => job.finished && !referenced.has(job.jobId)).map((job) => job.jobId);
+}
+/** `<root>/.bitmagic/forge/worlds/v3/forged-work` — the store's job directories, by the shared key layout. */
+export function forgeJobsDir(projectRoot) {
+    const oneJob = path.dirname(forgeArtifactKey('job', 'persisted'));
+    return path.join(projectRoot, FORGE_STORE_DIR, path.dirname(oneJob));
+}
+/** The store's job directories, finished or not; an absent store lists nothing. */
+export function listForgeJobDirs(projectRoot) {
+    const dir = forgeJobsDir(projectRoot);
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => ({
+        jobId: entry.name,
+        finished: fs.existsSync(path.join(projectRoot, FORGE_STORE_DIR, forgeArtifactKey(entry.name, 'persisted'))),
+    }));
+}
+/**
+ * Remove the finished jobs the project no longer refers to. One line when
+ * something was removed, a warning when something would not go; silent otherwise.
+ */
+export function pruneForgeStore(options) {
+    const { projectRoot, world, keep, log } = options;
+    const stale = staleForgeJobs(world, listForgeJobDirs(projectRoot), keep);
+    const removed = [];
+    for (const jobId of stale) {
+        const dir = path.join(forgeJobsDir(projectRoot), jobId);
+        try {
+            fs.rmSync(dir, { recursive: true, force: true });
+            removed.push(jobId);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            log(`warning: could not remove the finished forge job ${jobId} from ${FORGE_STORE_DIR} (${detail}); it is safe to delete by hand.`);
+        }
+    }
+    if (removed.length > 0) {
+        log(`Removed ${removed.length} finished forge job${removed.length === 1 ? '' : 's'} from ${FORGE_STORE_DIR} that no level refers to any more.`);
+    }
+    return removed;
+}
+//# sourceMappingURL=prune-store.js.map

package/dist/forge/prune-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-store.js","sourceRoot":"","sources":["../../src/forge/prune-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAmB,MAAM,0BAA0B,CAAC;AAQzE,qFAAqF;AACrF,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,IAAgC,EAAE,IAA2B;IAC7G,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,IAAI;QAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClG,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAChD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;KAC5G,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAM/B;IACC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IACzE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,GAAG,CAAC,oDAAoD,KAAK,SAAS,eAAe,KAAK,MAAM,kCAAkC,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,WAAW,OAAO,CAAC,MAAM,sBAAsB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,eAAe,oCAAoC,CAAC,CAAC;IAClJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generate/character-body.d.ts

@@ -0,0 +1,79 @@
+export interface CharacterArgs {
+    name: string;
+    prompt: string;
+    applyToPlayer?: boolean;
+    headScale?: string;
+    /** `--fresh`: forge a new one, never substitute a stored body. */
+    fresh?: boolean;
+    /**
+     * citty's negative boolean: `--no-library` arrives as `false`; the flag has no positive form.
+     * The deprecated spelling of `--fresh`, kept working because every scaffolded AGENTS.md
+     * written before the rename teaches it.
+     */
+    library?: boolean;
+    /** `--library-only`: take the closest stored body, never forge, never charge. */
+    libraryOnly?: boolean;
+    /** A row a prior search returned, which `bitmagic character add --id` adds verbatim. */
+    libraryPick?: {
+        sid: string;
+        assetUrl: string;
+        description?: string;
+        similarity: number;
+    };
+    /** Absent = the generator's default (true); the command fills it from the project's art style. */
+    voxelize?: boolean;
+    /** Asset Forger image-to-mesh model; absent = the Forger default. */
+    meshModel?: string;
+}
+/**
+ * The character default a project's art style implies: a low-poly game keeps the textured rig.
+ * Read from the cwd's project like every other generate command; outside a project the answer
+ * is "declares nothing", so the generator's own default (voxelize) stands and `loadProjectContext`
+ * reports the missing project on the very next line.
+ */
+export declare function defaultVoxelizeForProject(): boolean | undefined;
+export declare function buildCharacterBody(args: CharacterArgs): Record<string, unknown>;
+export declare const NAME_ARG: {
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "Unique name for the character.";
+};
+export declare const PROMPT_ARG: {
+    readonly type: "string";
+    readonly required: true;
+    readonly description: "Description of the character.";
+};
+export declare const APPLY_TO_PLAYER_ARG: {
+    readonly type: "boolean";
+    readonly description: "Set this character as the PLAYER. Omit to use the generator default (true).";
+};
+export declare const HEAD_SCALE_ARG: {
+    readonly type: "string";
+    readonly description: "Head size as a percentage of normal, 50-300. Omit to use the generator default.";
+};
+export declare const FRESH_ARG: {
+    readonly type: "boolean";
+    readonly description: string;
+};
+export declare const VOXELIZE_ARG: {
+    readonly type: "boolean";
+    readonly description: "Voxelize the rigged body. Omit to follow game.json artStyle: voxel games voxelize, low-poly games keep the textured rig.";
+    readonly negativeDescription: "Keep the textured low-poly rig instead of voxelizing it.";
+};
+export declare const MESH_MODEL_ARG: {
+    readonly type: "string";
+    readonly description: "Image-to-mesh model. Low-poly characters already default to 'runware-rodin-gen-2', which bills 60 sparks and takes ~3 min; pass 'unified-trellis' to put one back on the cheap lane at 15 sparks. Voxel characters ignore the default and use the Forger's.";
+};
+/**
+ * The deprecated spelling of `--fresh`.
+ *
+ * Kept declared because citty derives `--no-library` from an argument NAMED
+ * `library`, so there is no way to accept the old flag without it — and no way
+ * to hide it either: citty's `ArgDef` has no `hidden` field (only `CommandMeta`
+ * does). So it stays visible and says what it is.
+ */
+export declare const LIBRARY_ARG: {
+    readonly type: "boolean";
+    readonly description: "Deprecated and unnecessary — the library is consulted by default. Use --fresh to skip it.";
+    readonly negativeDescription: "Deprecated spelling of --fresh. Always makes a new character.";
+};

package/dist/generate/character-body.js

@@ -0,0 +1,100 @@
+/**
+ * The character request: its flags, and the body they map onto.
+ *
+ * Lives here rather than in either command because TWO commands present it —
+ * `bitmagic character generate` and the deprecated `bitmagic generate character`
+ * it replaced — and a deprecated alias whose flags have drifted from the command
+ * it aliases is worse than no alias at all. One definition, imported by both.
+ *
+ * Field names are exactly what `characterParamsSchema`
+ * (shared/asset-core/src/generators/character.ts) expects, and a flag the
+ * creator did not pass is OMITTED rather than sent as `undefined` or as a
+ * restated default — the generator owns its defaults.
+ */
+import { findProjectRootOrNull } from '../project/context.js';
+import { readArtStyleDeclaration } from '../project/art-style.js';
+import { parseNumberFlag } from '../commands/number-flag.js';
+/** Drops the keys an absent flag left `undefined`; `false` and `0` are deliberate values. */
+function withoutAbsentFlags(fields) {
+    return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
+}
+/**
+ * The character default a project's art style implies: a low-poly game keeps the textured rig.
+ * Read from the cwd's project like every other generate command; outside a project the answer
+ * is "declares nothing", so the generator's own default (voxelize) stands and `loadProjectContext`
+ * reports the missing project on the very next line.
+ */
+export function defaultVoxelizeForProject() {
+    const root = findProjectRootOrNull();
+    if (root === null)
+        return undefined;
+    return readArtStyleDeclaration(root).artStyle === 'low-poly' ? false : undefined;
+}
+export function buildCharacterBody(args) {
+    return withoutAbsentFlags({
+        name: args.name,
+        prompt: args.prompt,
+        applyToPlayer: args.applyToPlayer,
+        headScale: parseNumberFlag('head-scale', args.headScale, { min: 50, max: 300 }),
+        // `--fresh` and the deprecated `--no-library` are the same request. Neither
+        // passed leaves the field absent, so the generator's default (search first)
+        // stands rather than being restated here.
+        useLibrary: args.fresh === true ? false : args.library,
+        libraryOnly: args.libraryOnly,
+        libraryPick: args.libraryPick,
+        voxelize: args.voxelize,
+        meshModel: args.meshModel,
+    });
+}
+// ============================================================================
+// Flag definitions, shared by `character generate` and the deprecated alias
+// ============================================================================
+export const NAME_ARG = {
+    type: 'string',
+    required: true,
+    description: 'Unique name for the character.',
+};
+export const PROMPT_ARG = {
+    type: 'string',
+    required: true,
+    description: 'Description of the character.',
+};
+export const APPLY_TO_PLAYER_ARG = {
+    type: 'boolean',
+    description: 'Set this character as the PLAYER. Omit to use the generator default (true).',
+};
+export const HEAD_SCALE_ARG = {
+    type: 'string',
+    description: 'Head size as a percentage of normal, 50-300. Omit to use the generator default.',
+};
+export const FRESH_ARG = {
+    type: 'boolean',
+    description: 'Forge a new character even when the library has a close match. '
+        + 'Use it when you want this exact brief made rather than the nearest ready-made body.',
+};
+export const VOXELIZE_ARG = {
+    type: 'boolean',
+    description: 'Voxelize the rigged body. Omit to follow game.json artStyle: voxel games voxelize, low-poly games keep the textured rig.',
+    negativeDescription: 'Keep the textured low-poly rig instead of voxelizing it.',
+};
+export const MESH_MODEL_ARG = {
+    type: 'string',
+    description: "Image-to-mesh model. Low-poly characters already default to 'runware-rodin-gen-2', which bills 60 sparks and takes ~3 min; pass 'unified-trellis' to put one back on the cheap lane at 15 sparks. Voxel characters ignore the default and use the Forger's.",
+};
+/**
+ * The deprecated spelling of `--fresh`.
+ *
+ * Kept declared because citty derives `--no-library` from an argument NAMED
+ * `library`, so there is no way to accept the old flag without it — and no way
+ * to hide it either: citty's `ArgDef` has no `hidden` field (only `CommandMeta`
+ * does). So it stays visible and says what it is.
+ */
+export const LIBRARY_ARG = {
+    type: 'boolean',
+    // Both forms get a description, because citty renders a positive row for any
+    // boolean arg whether or not the flag is meant to be used. Left undescribed it
+    // was a blank line in `--help` sitting next to `--fresh`.
+    description: 'Deprecated and unnecessary — the library is consulted by default. Use --fresh to skip it.',
+    negativeDescription: 'Deprecated spelling of --fresh. Always makes a new character.',
+};
+//# sourceMappingURL=character-body.js.map

package/dist/generate/character-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-body.js","sourceRoot":"","sources":["../../src/generate/character-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,6FAA6F;AAC7F,SAAS,kBAAkB,CAAC,MAA+B;IACzD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;AAC/F,CAAC;AAyBD;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,OAAO,kBAAkB,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC/E,4EAA4E;QAC5E,4EAA4E;QAC5E,0CAA0C;QAC1C,UAAU,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;QACtD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,gCAAgC;CACrC,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,+BAA+B;CACpC,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,6EAA6E;CAClF,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iFAAiF;CACtF,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,iEAAiE;UAC1E,qFAAqF;CACjF,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,0HAA0H;IACvI,mBAAmB,EAAE,0DAA0D;CACvE,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,6PAA6P;CAClQ,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,6EAA6E;IAC7E,+EAA+E;IAC/E,0DAA0D;IAC1D,WAAW,EAAE,2FAA2F;IACxG,mBAAmB,EAAE,+DAA+D;CAC5E,CAAC"}

package/dist/mobile/asset-hosts.d.ts

@@ -12,18 +12,16 @@
  * that redirection: which hosts are ours to fetch on the browser's behalf, and the reversible path
  * that carries one.
  *
- * The host suffixes are the same environment classification `rehost-imported-assets.ts` uses in
- * game-play-agent: `bitmagic.ai` is prod (`mini.bitmagic.ai`, `forged-assets.bitmagic.ai`, ...) and
- * `bitmagic.cloud` is dev/sandbox (`beta.portal.bitmagic.cloud`,
- * `magic-mesh-gen.sandbox.dev.bitmagic.cloud`, ...). Everything else is deliberately left alone:
- * `esm.sh` serves the import map's modules and already answers `*`, and an unrecognised host is
- * more likely to be a creator's own endpoint than an asset we should be relaying.
+ * The host allowlist itself lives in `@bitmagic/asset-core` (`managed-hosts.ts`) and is
+ * re-exported here, because api-server needs the same answer when it decides whether a
+ * caller-supplied library `assetUrl` may be stored — and two copies of a security-relevant
+ * allowlist drift. `esm.sh` and everything else is deliberately left alone: it serves the import
+ * map's modules and already answers `*`.
  */
+import { isManagedAssetHost, MANAGED_HOST_SUFFIXES } from '@bitmagic/asset-core';
+export { isManagedAssetHost, MANAGED_HOST_SUFFIXES };
 /** The bridge route every proxied asset is fetched through. Trailing slash included. */
 export declare const CDN_PROXY_PREFIX = "/__bm/cdn/";
-/** Host suffixes that identify a bitmagic-controlled asset host. See the file header. */
-export declare const MANAGED_HOST_SUFFIXES: readonly ["bitmagic.ai", "bitmagic.cloud"];
-export declare function isManagedAssetHost(hostname: string): boolean;
 /**
  * The same-origin path that stands in for `url`, or null when the URL is not ours to proxy.
  *

package/dist/mobile/asset-hosts.js

@@ -12,25 +12,16 @@
  * that redirection: which hosts are ours to fetch on the browser's behalf, and the reversible path
  * that carries one.
  *
- * The host suffixes are the same environment classification `rehost-imported-assets.ts` uses in
- * game-play-agent: `bitmagic.ai` is prod (`mini.bitmagic.ai`, `forged-assets.bitmagic.ai`, ...) and
- * `bitmagic.cloud` is dev/sandbox (`beta.portal.bitmagic.cloud`,
- * `magic-mesh-gen.sandbox.dev.bitmagic.cloud`, ...). Everything else is deliberately left alone:
- * `esm.sh` serves the import map's modules and already answers `*`, and an unrecognised host is
- * more likely to be a creator's own endpoint than an asset we should be relaying.
+ * The host allowlist itself lives in `@bitmagic/asset-core` (`managed-hosts.ts`) and is
+ * re-exported here, because api-server needs the same answer when it decides whether a
+ * caller-supplied library `assetUrl` may be stored — and two copies of a security-relevant
+ * allowlist drift. `esm.sh` and everything else is deliberately left alone: it serves the import
+ * map's modules and already answers `*`.
  */
+import { isManagedAssetHost, MANAGED_HOST_SUFFIXES } from '@bitmagic/asset-core';
+export { isManagedAssetHost, MANAGED_HOST_SUFFIXES };
 /** The bridge route every proxied asset is fetched through. Trailing slash included. */
 export const CDN_PROXY_PREFIX = '/__bm/cdn/';
-/** Host suffixes that identify a bitmagic-controlled asset host. See the file header. */
-export const MANAGED_HOST_SUFFIXES = ['bitmagic.ai', 'bitmagic.cloud'];
-/** A hostname with no port and no credentials — what a proxy path's first segment may hold. */
-const HOSTNAME = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/;
-export function isManagedAssetHost(hostname) {
-    const host = hostname.toLowerCase();
-    if (!HOSTNAME.test(host))
-        return false;
-    return MANAGED_HOST_SUFFIXES.some((suffix) => host === suffix || host.endsWith(`.${suffix}`));
-}
 /**
  * The same-origin path that stands in for `url`, or null when the URL is not ours to proxy.
  *

package/dist/mobile/asset-hosts.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-hosts.js","sourceRoot":"","sources":["../../src/mobile/asset-hosts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,gBAAgB,CAAU,CAAC;AAEhF,+FAA+F;AAC/F,MAAM,QAAQ,GAAG,mEAAmE,CAAC;AAErF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACxF,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,GAAG,gBAAgB,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,WAAW,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"asset-hosts.js","sourceRoot":"","sources":["../../src/mobile/asset-hosts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;AAErD,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACxF,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,GAAG,gBAAgB,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,WAAW,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/project/character-search.d.ts

@@ -0,0 +1,30 @@
+export declare function characterSearchPath(root: string): string;
+/** One row as the search displayed it. The shape `libraryPick` needs, plus the caption. */
+export interface CharacterCandidate {
+    sid: string;
+    assetUrl: string;
+    description: string;
+    subject: string | null;
+    similarity: number;
+}
+export interface CharacterSearchRecord {
+    /** The prompt that produced this list — `add --id` reuses it as the asset's brief. */
+    prompt: string;
+    /** Which shelf was searched. `add` sends the matching `voxelize` so the media cannot cross. */
+    representation: 'voxel' | 'lowpoly';
+    /** The floor automatic substitution would have applied, for the "auto" column. */
+    threshold: number;
+    searchedAt: string;
+    candidates: CharacterCandidate[];
+}
+/** The last search, or null when there is none to trust. */
+export declare function readCharacterSearch(root: string): CharacterSearchRecord | null;
+export declare function writeCharacterSearch(root: string, record: CharacterSearchRecord): void;
+/**
+ * The cached row with this id, or null.
+ *
+ * Case-insensitive on the id because a creator reads it off a table and retypes
+ * it, and the corpus uses one case throughout — so a capital letter is a typo
+ * with an obvious intent, not a different character.
+ */
+export declare function findCachedCandidate(record: CharacterSearchRecord, sid: string): CharacterCandidate | null;

package/dist/project/character-search.js

@@ -0,0 +1,82 @@
+/**
+ * The candidates the last `bitmagic character search` returned, so
+ * `bitmagic character add --id <sid>` can name one of them.
+ *
+ * The search already fetched every row it displayed — sid, URL, caption and
+ * score. Keeping them means `add --id` needs nothing but the id: no second
+ * query, no re-ranking, and no asking the creator to retype the prompt that
+ * produced the list they are looking at. It also means `add` cannot drift from
+ * what was on screen, which a re-search could (the catalogue grows).
+ *
+ * Lives under `.bitmagic/` like `reference.json` and `cover.json`: generated,
+ * machine-written state. NOT in `bitmagic.json`, deliberately — that file is
+ * inside the publish fingerprint (shared/asset-core's publish-source.ts), so
+ * recording a search there would invalidate a passing `bitmagic verify` every
+ * time somebody browsed the shelf.
+ *
+ * Readers are lenient, like `readCoverRecord` and the reference records: a
+ * corrupt or absent file reads as "no search yet", because the worst case is one
+ * re-run of a free command, and a hard error would wedge the very command that
+ * would have replaced the bad file.
+ *
+ * There is deliberately no expiry. The catalogue only changes when someone
+ * promotes to it, and a stale row fails loudly and harmlessly (the URL 404s) —
+ * where a timeout would expire a list the creator is still reading. `add` prints
+ * the search's own timestamp instead, so age is visible rather than enforced.
+ */
+import * as path from 'path';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+const SEARCH_FILE = path.join('.bitmagic', 'character-search.json');
+export function characterSearchPath(root) {
+    return path.join(root, SEARCH_FILE);
+}
+function isCandidate(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const row = value;
+    return typeof row.sid === 'string' && row.sid !== ''
+        && typeof row.assetUrl === 'string' && row.assetUrl !== ''
+        && typeof row.similarity === 'number';
+}
+/** The last search, or null when there is none to trust. */
+export function readCharacterSearch(root) {
+    const raw = readJsonFile(characterSearchPath(root));
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const record = raw;
+    if (typeof record.prompt !== 'string')
+        return null;
+    if (record.representation !== 'voxel' && record.representation !== 'lowpoly')
+        return null;
+    if (!Array.isArray(record.candidates))
+        return null;
+    const candidates = record.candidates.filter(isCandidate).map((row) => ({
+        sid: row.sid,
+        assetUrl: row.assetUrl,
+        description: typeof row.description === 'string' ? row.description : '',
+        subject: typeof row.subject === 'string' ? row.subject : null,
+        similarity: row.similarity,
+    }));
+    return {
+        prompt: record.prompt,
+        representation: record.representation,
+        threshold: typeof record.threshold === 'number' ? record.threshold : 0,
+        searchedAt: typeof record.searchedAt === 'string' ? record.searchedAt : '',
+        candidates,
+    };
+}
+export function writeCharacterSearch(root, record) {
+    writeJsonAtomic(characterSearchPath(root), record);
+}
+/**
+ * The cached row with this id, or null.
+ *
+ * Case-insensitive on the id because a creator reads it off a table and retypes
+ * it, and the corpus uses one case throughout — so a capital letter is a typo
+ * with an obvious intent, not a different character.
+ */
+export function findCachedCandidate(record, sid) {
+    const wanted = sid.trim().toLowerCase();
+    return record.candidates.find((row) => row.sid.toLowerCase() === wanted) ?? null;
+}
+//# sourceMappingURL=character-search.js.map