@bitmagic/cli 0.1.65-dev.18 → 0.1.65-dev.2

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

@@ -1,46 +0,0 @@
-/**
- * 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

@@ -1,86 +0,0 @@
-/**
- * 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

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

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

@@ -1,36 +0,0 @@
-/**
- * The forge store with a server behind it.
- *
- * The CLI keeps every forge artifact in the project's `.bitmagic/forge` (see
- * local-store.ts). This wraps that storage so the artifacts the BROWSER steps
- * write are also PUT to api-server, and anything missing locally is fetched
- * from it — so a job can be resumed, and a forged level edited, from a
- * machine that never ran the original forge. The server owns `input`, `spec`
- * and `forge` and refuses a client write of them; those are written locally
- * only (they arrive on the forge's terminal frame anyway).
- *
- * The mirror is best-effort by design: the local write is the one the run
- * depends on, and a server that cannot be reached must not fail a bake that
- * has already been paid for. A failed mirror is said once, plainly, because
- * its cost is real — the artifact will not be there for another machine.
- * Reads that fall through to the server are cached locally, so a resumed job
- * reads from disk from then on.
- */
-import type { ForgeStorageEnv } from '@bitmagic/world-forger/pipeline/index.js';
-import type { Environment } from '../config/environments.js';
-export interface RemoteForgeStoreDeps {
-    environment: Environment;
-    /**
-     * Resolved on the FIRST remote call, not when the store is built: the store
-     * is created before the command's cheap pre-request checks, and a run that
-     * never leaves the machine (a fresh forge with every artifact local) must
-     * not demand a login it would not otherwise need until the request.
-     */
-    accessToken: () => Promise<string>;
-    fetch: typeof globalThis.fetch;
-    /** Where a failed mirror or fetch is said. */
-    warn: (message: string) => void;
-}
-export declare function forgeArtifactUrl(environment: Environment, jobId: string, name: string): string;
-/** Wrap a local storage env so forged-work artifacts are mirrored to, and fetched from, the server. */
-export declare function createMirroredForgeStorage(local: ForgeStorageEnv, deps: RemoteForgeStoreDeps): ForgeStorageEnv;

package/dist/forge/remote-store.js

@@ -1,113 +0,0 @@
-/**
- * The forge store with a server behind it.
- *
- * The CLI keeps every forge artifact in the project's `.bitmagic/forge` (see
- * local-store.ts). This wraps that storage so the artifacts the BROWSER steps
- * write are also PUT to api-server, and anything missing locally is fetched
- * from it — so a job can be resumed, and a forged level edited, from a
- * machine that never ran the original forge. The server owns `input`, `spec`
- * and `forge` and refuses a client write of them; those are written locally
- * only (they arrive on the forge's terminal frame anyway).
- *
- * The mirror is best-effort by design: the local write is the one the run
- * depends on, and a server that cannot be reached must not fail a bake that
- * has already been paid for. A failed mirror is said once, plainly, because
- * its cost is real — the artifact will not be there for another machine.
- * Reads that fall through to the server are cached locally, so a resumed job
- * reads from disk from then on.
- */
-import { CLIENT_FORGE_ARTIFACTS, parseForgeArtifactKey } from '@bitmagic/world-forger/pipeline/index.js';
-import { apiServerHeaders } from '../telemetry/request-headers.js';
-export function forgeArtifactUrl(environment, jobId, name) {
-    return `${environment.apiUrl}/api/cli/v1/forge/jobs/${encodeURIComponent(jobId)}/artifacts/${encodeURIComponent(name)}`;
-}
-/** Wrap a local storage env so forged-work artifacts are mirrored to, and fetched from, the server. */
-export function createMirroredForgeStorage(local, deps) {
-    const said = new Set();
-    const warnOnce = (key, message) => {
-        if (said.has(key))
-            return;
-        said.add(key);
-        deps.warn(message);
-    };
-    const headers = async () => ({
-        ...apiServerHeaders(),
-        Authorization: `Bearer ${await deps.accessToken()}`,
-    });
-    const failure = (error) => (error instanceof Error ? error.message : String(error));
-    const client = {
-        async putObject(params) {
-            const written = await local.storageClient.putObject(params);
-            const parsed = parseForgeArtifactKey(params.key);
-            if (parsed === null || !CLIENT_FORGE_ARTIFACTS.includes(parsed.name))
-                return written;
-            const body = typeof params.body === 'string' ? params.body : new TextDecoder().decode(params.body);
-            try {
-                const response = await deps.fetch(forgeArtifactUrl(deps.environment, parsed.jobId, parsed.name), {
-                    method: 'PUT',
-                    headers: { ...(await headers()), 'Content-Type': 'application/json' },
-                    body,
-                });
-                if (!response.ok) {
-                    warnOnce(`put:${parsed.name}`, `Could not mirror the forge's "${parsed.name}" record to api-server (HTTP ${response.status}). The run continues from `
-                        + 'the local copy, but resuming or editing this level from another machine will re-bake it.');
-                }
-            }
-            catch (error) {
-                warnOnce(`put:${parsed.name}`, `Could not mirror the forge's "${parsed.name}" record to api-server (${failure(error)}). The run continues from `
-                    + 'the local copy, but resuming or editing this level from another machine will re-bake it.');
-            }
-            return written;
-        },
-        async headObject(params) {
-            if (await local.storageClient.headObject(params))
-                return true;
-            const parsed = parseForgeArtifactKey(params.key);
-            if (parsed === null)
-                return false;
-            try {
-                const response = await deps.fetch(forgeArtifactUrl(deps.environment, parsed.jobId, parsed.name), {
-                    method: 'HEAD',
-                    headers: await headers(),
-                });
-                return response.ok;
-            }
-            catch (error) {
-                warnOnce('head', `Could not ask api-server for the job's saved state (${failure(error)}) — working from the local copy only.`);
-                return false;
-            }
-        },
-        async getObject(params) {
-            const here = await local.storageClient.getObject(params);
-            if (here !== null)
-                return here;
-            const parsed = parseForgeArtifactKey(params.key);
-            if (parsed === null)
-                return null;
-            try {
-                const response = await deps.fetch(forgeArtifactUrl(deps.environment, parsed.jobId, parsed.name), {
-                    method: 'GET',
-                    headers: await headers(),
-                });
-                if (response.status === 404)
-                    return null;
-                if (!response.ok) {
-                    warnOnce(`get:${parsed.name}`, `api-server refused the job's "${parsed.name}" record (HTTP ${response.status}) — working from the local copy only.`);
-                    return null;
-                }
-                const bytes = new Uint8Array(await response.arrayBuffer());
-                // Cached locally so the rest of the run, and the next one, read from disk.
-                await local.storageClient.putObject({
-                    bucket: params.bucket, key: params.key, body: bytes, contentType: 'application/json', cacheControl: 'no-store, max-age=0',
-                });
-                return bytes;
-            }
-            catch (error) {
-                warnOnce('get', `Could not fetch the job's saved state from api-server (${failure(error)}) — working from the local copy only.`);
-                return null;
-            }
-        },
-    };
-    return { ...local, storageClient: client };
-}
-//# sourceMappingURL=remote-store.js.map

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

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

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

@@ -1,79 +0,0 @@
-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

@@ -1,100 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/project/character-search.d.ts

@@ -1,30 +0,0 @@
-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

@@ -1,82 +0,0 @@
-/**
- * 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

package/dist/project/character-search.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"character-search.js","sourceRoot":"","sources":["../../src/project/character-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;AAEpE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AAsBD,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE;WAC/C,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;WACvD,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC;AAC1C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,MAAM,CAAC,cAAc,KAAK,OAAO,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACrE,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QACvE,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC7D,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACtE,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;QAC1E,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAA6B;IAC9E,eAAe,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA6B,EAC7B,GAAW;IAEX,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AACnF,CAAC"}

package/dist/scaffold/asset-pipeline-skill-files.d.ts

@@ -1,38 +0,0 @@
-/**
- * `<skills dir>/choosing-asset-pipelines/SKILL.md` — WHICH lane makes a given thing, before any
- * command runs.
- *
- * Exists because the GDK grew several ways to make the same thing — a level from the baseline
- * terrain, `bitmagic forge` (five modes), a Blender script or a Unity port; a character from the
- * free block default, a free library hit, a voxel forge or a low-poly forge at four times the
- * price — and the routing knowledge sat in five places: the per-command reference in
- * `generating-assets`, the "one forge" rule in `planning-a-game`, the Blender skill's §0 gate, the
- * hosted Creator agent's GLB-vs-voxel rules (which never reach a CLI project at all), and code
- * comments. An agent took the first lane it remembered, and a creator had to know Bitmagic's
- * internals to steer it. This file is the table by NEED: conditions (art style, model class,
- * local tooling, prototype vs polished), rough cost, rough time, recommended order — and the rule
- * for when the agent decides alone versus asks the creator with a recommendation.
- *
- * It is a shipped skill so that `bitmagic upgrade` re-renders it in every project with every CLI
- * release — that is the whole update mechanism; nothing here is hand-maintained in a creator's
- * project. Same file-layout contract as `skill-files.ts`: a pure function returning the markdown
- * as a template literal, every backtick inside escaped as \` and every `${` escaped, except the
- * `${PRIMARY_SKILLS_DIR}` interpolations, which are the point (sibling skills are cited by the
- * fixed path every agent's project has, never by a vendor path). Imports only `agent-targets.js`
- * so `project.ts` can import this without a cycle.
- *
- * What keeps it honest, and what does not:
- * - `__tests__/asset-pipeline-skill-files.test.ts` fails when a `bitmagic generate` subcommand
- *   exists with no row here, when a row names a subcommand or a skill directory that does not
- *   exist, or when one of the need sections or the two defaults (audio opt-in, block characters)
- *   disappears. So a new generator cannot ship without a row.
- * - Prices and timings are NOT test-checked. Sparks come from `api-server/src/llm/llm_cost.json`
- *   (`toolCosts`, 1 spark = $0.01): glb/model/prop 3, voxel character 15, low-poly character 60,
- *   library-only 0, skybox and background 5, image 3, cover and reference 6, block-type 3, sound
- *   12, music 0.25/s, video 1.35/s, authored animation 1, video-to-motion 15; forge and vehicle
- *   are usage-priced, presets free. Timings are observed. The CLI cannot import that file, so a
- *   price, flag or backend change is invisible to the test — which is why the release checklist
- *   (`.claude/skills/generate-release-checklist`) asks for this file to be re-read whenever a
- *   generator or `toolCosts` changes. Every figure is written as approximate for the same reason.
- */
-export declare function renderAssetPipelinesSkill(): string;