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

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":"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"}

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

@@ -1,42 +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 or
- *   a `bitmagic character` verb exists with no row here (deprecated aliases excepted), 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 — but a RENAMED flag can: the day this shipped, `--no-library` had just
- *   become `--fresh` and `--library-only` had become `character search` + `add`, and every test
- *   passed. That is why the sheet names COMMANDS ONLY and tells the agent to read `--help` —
- *   a flag written here is a flag that will be wrong.
- * - 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;

package/dist/scaffold/asset-pipeline-skill-files.js

@@ -1,207 +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 or
- *   a `bitmagic character` verb exists with no row here (deprecated aliases excepted), 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 — but a RENAMED flag can: the day this shipped, `--no-library` had just
- *   become `--fresh` and `--library-only` had become `character search` + `add`, and every test
- *   passed. That is why the sheet names COMMANDS ONLY and tells the agent to read `--help` —
- *   a flag written here is a flag that will be wrong.
- * - 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.
- */
-import { PRIMARY_SKILLS_DIR } from './agent-targets.js';
-export function renderAssetPipelinesSkill() {
-    return `---
-name: choosing-asset-pipelines
-description: Pick the lane that makes a given thing for this Bitmagic game — a whole level, a character, a building, a small prop, a vehicle, a weapon, the sky, block textures, an image or cover, an animation, audio, a cutscene — choosing between the free built-in, bitmagic generate, bitmagic forge, a Blender build, a Unity port and the creator's own files, with approximate sparks and wall-clock minutes per option and the rule for when to ask the creator first. Use before any generation, forge or Blender build, and whenever two routes could make the same thing.
----
-
-# Choosing an asset pipeline
-
-Most things this game needs can be made three or four ways, and the ways differ by a hundred
-sparks and by twenty minutes. This file is the routing table: find the need, take the first row
-whose conditions hold, say which you took. It names commands without their flags on purpose —
-**run \`<command> --help\` before using one.** Flags move between releases; the help does not lie.
-Flags and refusals in prose are in \`${PRIMARY_SKILLS_DIR}/generating-assets/SKILL.md\`; this file only decides.
-
-Costs are **approximate** — sparks are rounded and times are typical, not promised. \`bitmagic
-usage\` is the truth about what was actually spent.
-
-## Know these four things first
-
-1. **Art style** — \`artStyle\` in \`src/work/game.json\`: \`voxel\` (default) or \`low-poly\`. A declared
-   switch, not a per-asset flag: in a low-poly game models, props, added files and characters keep
-   their meshes instead of voxelizing (and a character costs four times more), the Blender level
-   route opens, and built-in weapons should use their \`_lowpoly\` twins. Set it before the first cover.
-2. **Your model class** — frontier (Claude Fable / Opus 5, GPT-6 class) or not. Only the Blender
-   route depends on it; its §0 says "if you are not sure you are one, you are not".
-3. **Local tooling** — Google Chrome (the forge, generated models, props and vehicles, added \`.glb\`
-   files in a voxel game, \`verify\`); Blender 4.2+ (Blender levels); \`ffmpeg\` (\`trailer\`, video
-   contact sheets); a Unity project to port. Probe once with the checks each skill gives.
-4. **Purpose** — **prototype** (slice 1, prove the loop, the creator will iterate) or **polished**
-   ("final", "ship it", "make it look great", publishing). Take it from their words. Unsaid:
-   assume prototype for slice 1 and note the upgrade as a backlog item.
-
-## Decide, say so, ask only when it is expensive
-
-Default: you decide, and state the assumption in one line before running anything:
-
-> Assuming *prototype*: using \`<route>\` (~N sparks, ~T). Say "polished" and I will use \`<alt>\`.
-
-Ask first only when BOTH hold: the recommended option is expensive — tens of sparks or many
-minutes (a forge, a low-poly character, a video-to-motion animation, a long music track, a Blender
-build) — AND the creator has not said prototype or polished. Recommended option first, answerable
-in a word:
-
-> \`<need>\`: I recommend \`<A>\` (~N sparks, ~T) because \`<why>\`; the alternative is \`<B>\` (~N, ~T).
-> Which — or just say prototype / polished and I will pick?
-
-Never ask about a free or seconds-long option, never ask twice for the same need, never run two
-paid options to compare. If the allowance is nearly gone
-(\`${PRIMARY_SKILLS_DIR}/checking-usage/SKILL.md\`), say so before an expensive one.
-
-## By need
-
-Rows are in recommended order: take the first whose conditions hold.
-
-### A whole level
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| The baseline's procedural voxel terrain (already there) | prototype, or the terrain is not the mechanic | free, instant | Slice 1's world unless the game cannot be played without its shape (planning skill) |
-| \`bitmagic forge\` — natural terrain by default, or one of its modes: city, dungeon, platformer, freeform, vessel | Chrome; terrain IS the mechanic (skiing, a circuit, open-world driving, an enclosed dungeon) or polished | usage-priced, tens of sparks; many minutes (the bake alone can take twenty) | One forge per game; it can edit a forged level in place and resume a failed job — see its help. AGENTS.md "Forging a whole level" |
-| \`${PRIMARY_SKILLS_DIR}/building-levels-in-blender/SKILL.md\` | frontier model AND Blender 4.2+ AND \`artStyle: "low-poly"\`; a DESIGNED place (interior, station, set), not natural terrain | free in sparks; an hour or more of your time | Its §0 is the gate; audited with ray casts, loaded by \`MeshLevel\` |
-| \`${PRIMARY_SKILLS_DIR}/converting-unity-levels/SKILL.md\` | the creator has a Unity scene to bring over | free in sparks; minutes to hours | Reuses their prefabs, FBX, colliders; not a way to make a level from nothing |
-
-### A character (player or NPC)
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| A block character built in code (the default) | any; recolours, outfits, a blocky knight/robot/wizard | free, seconds | \`character-system.md\`, \`npc-appearance.md\`. Highres and block **never coexist** — going highres means the whole cast goes |
-| \`bitmagic character search\` then \`bitmagic character add\` | prototype; any plausible ready-made body will do | free, instant | \`search\` lists the closest library bodies and changes nothing; \`add\` takes one and never forges. Judge the match yourself — a score says "plausible", not "right" |
-| \`bitmagic character generate\` | the look is genuinely custom; the whole cast will be highres | free and seconds on a library match; else ~15 sparks, ~1.5–4 min (voxel) or ~60 sparks, ~3 min (low-poly) | Library-first by default; a custom head scale or mesh model always forges. It can set the player directly |
-| \`bitmagic character generate\`, forced fresh | polished; exactly this one, no library substitute | ~15 (voxel) / ~60 (low-poly) sparks; minutes | The costly row: ask first if purpose is unknown |
-
-### A building or landmark
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| A structure a forge already placed, or a \`building\` hotspot | the level was forged | free | \`environment-objects.md\` |
-| \`bitmagic generate model\` | a new named structure the code places | ~3 sparks; ~10 s voxel, minutes for a mesh | Chrome in a voxel game; give it a height — above 6 m stays hollow |
-| \`bitmagic generate prop\` | a placeholder or forge asset is already placed and looks bad | ~3 sparks; ~10 s | REPLACES that asset; every placed instance upgrades. Never for a new object |
-| \`bitmagic assets add\` | the creator has the model | free; seconds to a minute | Chrome to voxelize in a voxel game; can keep the mesh instead |
-
-### A small prop (a crate, a lantern, a pickup)
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| An asset already in \`assets[]\` (\`bitmagic assets list\`) | one fits | free | The same object twice is the commonest waste |
-| \`bitmagic generate model\` | a new object the code spawns or places | ~3 sparks; ~10 s voxel | Cheap enough not to ask. \`environmentObjects[]\` or \`engine.spawnAsset()\` — \`environment-objects.md\` |
-| \`bitmagic assets add\` | the creator has a \`.glb\`/\`.vxl\` | free | Same voxelize rule as above |
-| Plain three.js geometry in code | a marker, trigger or debug prop nobody looks at | free, no browser | Do not hand-build what a 3-spark model makes better |
-
-### A vehicle
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| \`bitmagic generate vehicle\` from a preset (its help lists them) | no bespoke look needed; prototype | free; ~a minute (Chrome) | Physics, lights, AI built in either way; spawn via \`engine.getVehicleSpawner().spawnAndEnterFromAsset(...)\` |
-| \`bitmagic generate vehicle\` from a description | the look is the point | usage-priced, several sparks; several minutes | NEW asset each run; ask first when purpose is unknown |
-
-### A weapon
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| A built-in id (\`sword\`, \`assault_rifle\`, \`bow\`…) or its \`_lowpoly\` twin via \`weaponStyleId(base, 'lowpoly')\` | any; match the twin to \`artStyle\` | free, instant | Wired into damage, animations, pickups, NPC use. \`weapon-visuals.md\`, \`combat-system.md\` |
-| \`bitmagic generate model\` | a genuinely custom look | ~3 sparks; ~10 s | A mesh only — still wire it to a built-in's combat behaviour |
-
-### The sky
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| The engine's default sky | prototype; no strong setting | free | |
-| \`bitmagic generate skybox\` | a free-look or third-person camera | ~5 sparks; ~a minute | Usually earns its place in slice 1 |
-| \`bitmagic generate background\` | a fixed sidescroller or top-down camera | ~5 sparks; ~a minute | SAME field as skybox; the second run silently replaces the first |
-
-### Block textures
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| A built-in block name (\`stone\`, \`grass\`, \`sand\`, \`marble\`…) | one fits | free | \`custom-block-types.md\` |
-| A plain-colour \`customBlockTypes[]\` entry by hand | prototype; a colour is enough | free | snake_case, never a built-in's name |
-| \`bitmagic generate block-type\` | the surface needs a real texture (a second one for the sides is optional) | ~3 sparks (~6 with sides); seconds to a minute | The same name replaces the entry |
-
-### Images, cover, reference
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| \`bitmagic assets add\` | the creator has the picture | free | |
-| \`bitmagic generate image\` | a portrait, icon, poster, HUD art | ~3 sparks; ~30 s | |
-| \`bitmagic cover\` | always, early — after \`artStyle\` is set, before \`verify\` | ~6 sparks; minutes | Prompt comes from \`GAME-DESIGN.md\`; an unchanged design regenerates nothing |
-| \`bitmagic reference make\`, then the HUMAN accepts | the idea names a place or a look | ~6 sparks per candidate; ~a minute | Steers every later skybox, block, cover and forge |
-
-### Animation
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| A built-in clip (\`mGenIdle01\`, \`mGenWalk01\`, \`mKicking01\`, \`mPunching01\`…) | one fits | free, instant | \`animation-assets.md\`; locomotion auto-plays |
-| \`bitmagic generate animation\` from an authored spec (gait, melee, one-shot) | a gait variant, a melee move, a key-pose one-shot | ~1 spark; ~1 s | Solved locally; the cheapest generator |
-| \`bitmagic generate animation\` from a video | a motion only footage captures | ~15 sparks (plus video seconds if it generates the clip); minutes | Ask first when purpose is unknown |
-
-### Audio
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| None | the creator has not asked for sound | free | Audio is added only on request — never by default |
-| Web Audio synthesis in code | ordinary SFX: a beep, a hit, a pickup | free | \`audio-system.md\` |
-| \`bitmagic assets add\` | the creator has the track | free | |
-| \`bitmagic generate sound\` | they asked for a premium or generated effect | ~12 sparks; ~30 s | One prompt, one effect |
-| \`bitmagic generate music\` | they asked for original music | ~0.25 sparks/s (30 s ≈ 8, 120 s ≈ 30); ~a minute | Ask first for a long track when purpose is unknown; it can write a file instead of a world asset, for a trailer bed |
-
-### A cutscene or video
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| \`bitmagic generate video\` from a prompt | a story beat played by \`engine.playVideo()\` | ~1.35 sparks/s (5 s ≈ 7); ~40 s | Read the frame sheet before wiring; needs a user gesture to play. \`video-cutscenes.md\` |
-| \`bitmagic generate video\` from a still | animate a picture you have (cover, reference) | same sparks; ~3 min | Comes back in the image's shape, not 16:9 |
-| \`bitmagic trailer\` (\`${PRIMARY_SKILLS_DIR}/making-a-trailer/SKILL.md\`) | a trailer or highlight reel of real gameplay | free apart from an optional music bed; \`ffmpeg\` | Cut from a recording, not generated |
-
-## After you have chosen
-
-- \`<command> --help\` first, then pass the creator's request verbatim the way AGENTS.md says.
-- Each generation writes \`src/work/world.json\`; re-read it if you hold a copy.
-- One generation per decision. Decide the prompt, run it once, use what comes back.
-- Flags in prose, reference-image rules, refusals: \`${PRIMARY_SKILLS_DIR}/generating-assets/SKILL.md\`.
-  What it cost: \`bitmagic usage\`.
-`;
-}
-//# sourceMappingURL=asset-pipeline-skill-files.js.map

package/dist/scaffold/asset-pipeline-skill-files.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset-pipeline-skill-files.js","sourceRoot":"","sources":["../../src/scaffold/asset-pipeline-skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;uCAW8B,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoCpD,kBAAkB;;;;;;;;;;;;MAYjB,kBAAkB;MAClB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA4FI,kBAAkB;;;;;;;uDAOS,kBAAkB;;CAExE,CAAC;AACF,CAAC"}