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

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

@@ -1,202 +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.
- */
-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. Flags and refusals for every command 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 \`generate model|prop\`, \`assets add\` and
-   \`generate character\` keep 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 (\`forge\`, \`generate model|prop|vehicle\`, \`assets add *.glb\` 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\` 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 --prompt "..."\` (\`--city\`, \`--dungeon\`, \`--platformer\`, \`--freeform\` or \`--vessel\`, at most one) | 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; \`--edit --level <id>\` changes a forged level, \`--resume <jobId>\` after a failure. 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 generate character --name <id> --prompt "..."\` | 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. \`--head-scale\` / \`--mesh-model\` always forge. \`--apply-to-player\` sets the player |
-| \`... --library-only\` | prototype; a close-enough body will do | free, instant | Nearest stored body, or fails and charges nothing |
-| \`... --no-library\` | polished; exactly this one | ~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 --prompt "..." --height <m>\` | a new named structure the code places | ~3 sparks; ~10 s voxel, minutes for a mesh | Chrome in a voxel game; above 6 m stays hollow |
-| \`bitmagic generate prop --asset <id> --prompt "..."\` | 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 <file.glb>\` (\`--keep-glb\` for a mesh) | the creator has the model | free; seconds to a minute | Chrome to voxelize in a voxel game |
-
-### 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 --prompt "..." --name <id>\` | 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 <file>\` | the creator has a \`.glb\`/\`.vxl\` | free | |
-| 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 --preset <NAME>\` (\`--preset ?\` 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 --prompt "..."\` | 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 --prompt "..."\` | 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 --description "..."\` | a free-look or third-person camera | ~5 sparks; ~a minute | Usually earns its place in slice 1 |
-| \`bitmagic generate background --description "..."\` | 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 --name <id> --description "..."\` | the surface needs a real texture (\`--side-description\` for a second) | ~3 sparks (~6 with sides); seconds to a minute | Same \`--name\` replaces the entry |
-
-### Images, cover, reference
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| \`bitmagic assets add <png>\` | the creator has the picture | free | |
-| \`bitmagic generate image --name <id> --prompt "..."\` | 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\` / \`accept\` | the idea names a place or a look; the HUMAN accepts | ~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 --family gait ...\` or \`--spec <file>\` | a gait variant, a melee move, a key-pose one-shot | ~1 spark; ~1 s | Solved locally; the cheapest generator |
-| \`bitmagic generate animation --video <clip>\` (\`--video-prompt "..."\` generates the clip first) | a motion only footage captures | ~15 sparks (plus video seconds with \`--video-prompt\`); 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 <file.mp3/.opus>\` | the creator has the track | free | |
-| \`bitmagic generate sound --prompt "..."\` | they asked for a premium or generated effect | ~12 sparks; ~30 s | One prompt, one effect |
-| \`bitmagic generate music --prompt "..." --duration <s>\` | 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; \`--out --no-world\` for a trailer bed |
-
-### A cutscene or video
-
-| Route | Conditions | ~Cost | Notes |
-|---|---|---|---|
-| \`bitmagic generate video --prompt "..." --duration 5\` | 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\` |
-| \`... --image <png>\` | animate a still 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
-
-- Pass \`--original-prompt "<the creator's request, verbatim>"\` on every command.
-- 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, 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;IAUL,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoCjB,kBAAkB;;;;;;;;;;;;MAYjB,kBAAkB;MAClB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA4FI,kBAAkB;;;;;;;8CAOA,kBAAkB;;CAE/D,CAAC;AACF,CAAC"}