@genex-ai/cli-demo 1.32.2 → 1.32.3-dev.680

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.32.2",
+  "version": "1.32.3-dev.680",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-ai-character/SKILL.md

@@ -180,7 +180,13 @@ second paid request. In the default lane, `--user-approved` and
 the real images. When the player explicitly requested a custom character,
 never add `--user-approved` until they have actually seen and selected the
 candidate, and never add `--approve-remesh <faces>` until they have seen the
-four high-detail views and measured face count.
+four high-detail views and measured face count. Every character lane —
+concept, preview, finalize, animate — counts against the same asset allowance
+`npx genex budget` prints for the rest of the belt, the quote each stage
+prints is exactly what it charges against that allowance, and a stage refused
+past it is a question for the player with the number (the wallet is not empty;
+`npx genex budget --assets <credits> --user-approved` raises it on their
+word), never an out-of-credits fallback to the VRM avatar.
 
 Before handoff, capture idle, walk, run, crouch-idle, crouch-move, and jump.
 Inspect shoulders, elbows, wrists, and hands as well as the feet. Reject

package/templates/skills/genex-ai-model/SKILL.md

@@ -306,6 +306,18 @@ scene is a ghost: players and objects pass straight through it.
   with a procedurally-coded placeholder (a simple Three.js primitive-based stand-in
   mesh) and mark the spot with `// TODO(genex): regenerate when credits refill` so
   the real asset is one command away later. Do not stop the session over this.
+- **Refused by the build's asset allowance** (the command prints the allowance,
+  what this build has spent, and this generation's price) — the build, not the
+  account, is at its limit: every build has an asset allowance sized from the
+  wallet, and this generation would take it past that. The wallet is not empty
+  and nothing was charged, so this is not the out-of-credits case above and the
+  placeholder-and-refill route is wrong here. Tell the user the numbers the CLI
+  printed (`npx genex budget` shows them again) and ask whether to raise the
+  allowance — only their explicit approval does: `npx genex budget --assets
+  <credits> --user-approved`. While you wait, or if no answer comes, code-build
+  the piece (`$genex-threejs-procedural-assets`) to the same bar and record
+  `Generation: none — allowance` on its row. Never re-run the command hoping for
+  a different answer, and never report this as being out of credits.
 - **"Email not verified" (`email_verification_required`)** — generation credits
   unlock after the account's email is verified. Give the user the verify link the
   CLI printed, wait for them to confirm, then re-run the command.

package/templates/skills/genex-ai-texture/SKILL.md

@@ -225,7 +225,7 @@ first one is the one a screenshot of the whole arena will not show you.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -203,7 +203,7 @@ evidence detective game, a video-book. The pattern that makes it hold together:
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
   The measured false-positive class is anatomy being pierced or entered

package/templates/skills/genex-game-director/SKILL.md

@@ -126,7 +126,7 @@ vendored code from memory of another engine.
 
 | Work needed | Load |
 | --- | --- |
-| **your first `npx genex model` or `npx genex character` this session** — the command, what comes back, how to scale and ground it, and what to do when a lane is dead. One page, thirty seconds. The full lanes below are long; measured across 105 generation-lane invocations, 94% ran without the owning skill open, and placement is where that showed | `$genex-lane-card` |
+| **your first `npx genex model` or `npx genex character` this session** — the command, what comes back, how to scale and ground it, what the build may spend, and what to do when a lane is dead. One page, thirty seconds. The full lanes below are long; measured across 105 generation-lane invocations, 94% ran without the owning skill open, and placement is where that showed | `$genex-lane-card` |
 | shot composition, chase/side/orbit rigs, camera handoffs, projection ownership, pointer look, mouse-aimed action, mouse-look, the screen-direction contract for hand-rolled steering/pan/look input signs, floating origins | `$genex-threejs-camera-direction` |
 | on-foot player movement: walk/run/jump/crouch, third-person character, slopes, stairs, moving platforms, the player's body loader, directional locomotion, transitions, action motion | `$genex-threejs-character-controller` |
 | **attacking, casting, aiming or reloading WHILE moving** — any action the legs must keep running under; a weapon carry stance over stock locomotion; a wind-up the character holds while walking | `$genex-threejs-character-controller` (`references/animations.md`, upper-body layering) |
@@ -204,18 +204,30 @@ its local path for code-built ones — the table is where the per-object decisio
 lives, and a table with no generated row records
 `Generation: none — <why code alone reaches the bar here>` beside it. Mixing
 both in one scene is the normal way to build, never a fallback. In focused
-work, stay inside the touched scope. Generate in batches you can finish. The first
-batch is the smallest set that makes the scene read — the player's body,
-whatever the request names, and the first thing they walk up to — enqueued
-together with `--no-wait` while you scaffold. Before a second batch starts,
-every id in the first is collected with `npx genex wait --all`, loaded from a
-file in `src/`, and seen in a capture. A batch begun while the previous one is
-still uncollected is how a game ends up with an asset library and an empty
-world. This is enforced, not merely advised: unshipped generations are counted
-and the generate commands refuse past a ceiling, which `npx genex preview`
-resets to zero. There is no total — preview between batches and generate as
-much as the game needs. Preserve every id, URL and wiring state across a
-compaction.
+work, stay inside the touched scope. Generate in batches you can finish, and
+generate what the wallet can carry: every build has an asset allowance, and
+`npx genex budget` prints it live with the price of each kind. Each Assets row
+carries its kind's price from that output, and the table's total is checked
+against the allowance before the first `--no-wait` is sent. A table that does
+not fit is trimmed from the bottom — the nice-to-have props — never from the
+top, which is what the request names; a trimmed row stays in the table as
+`Generation: none — allowance`, so the reason is legible, and the player is
+asked with the number before the trim — with no answer, the trim stands and
+the summary says so — since only their explicit approval raises the allowance
+(`npx genex budget --assets <credits> --user-approved`). The first batch is
+the smallest set that makes the scene read — the player's body, whatever the
+request names, and the first thing they walk up to — enqueued together with
+`--no-wait` while you scaffold. Before a second batch starts, every id in the
+first is collected with `npx genex wait --all`, loaded from a file in `src/`,
+and seen in a capture. A batch begun while the previous one is still
+uncollected is how a game ends up with an asset library and an empty world.
+Both are enforced, not merely advised: unshipped generations are counted and
+the generate commands refuse past a ceiling, which `npx genex preview` resets
+to zero, and a paid command that would take the build past its allowance is
+refused with the numbers, whatever the wallet holds. The ratchet has no total
+— preview between batches and generate as much as the game needs; the
+allowance is the total, and it is meant to be spent on the named things, not
+left over. Preserve every id, URL and wiring state across a compaction.
 
 ## 5. Execute by working mode
 

package/templates/skills/genex-getting-started/SKILL.md

@@ -161,7 +161,7 @@ downloads the game too, binary assets and all:
 
 ```bash
 mkdir my-game && cd my-game
-npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 npm install
 ```
 
@@ -225,7 +225,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-lane-card/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: genex-lane-card
-description: The asset belt on one page — the command, what comes back, how to place it so it is not a speck or a wall, and what to do when a lane is dead. Read this before your first `npx genex model` or `npx genex character`. The full lanes are `$genex-ai-model` and `$genex-ai-character`; this card is what you need to not get it wrong.
+description: The asset belt on one page — the command, what comes back, how to place it so it is not a speck or a wall, what the build may spend, and what to do when a lane is dead. Read this before your first `npx genex model` or `npx genex character`. The full lanes are `$genex-ai-model` and `$genex-ai-character`; this card is what you need to not get it wrong.
 ---
 
 # Genex · Lane card
@@ -51,10 +51,11 @@ The belt has a **shipping ratchet**: generations that have not been shown to the
 player are counted, and the count resets to zero every time you `npx genex
 preview`. Hit it and the command refuses with the number and the fix.
 
-It is not a spend limit and there is no total — preview between batches and
-generate as much as the game needs. What it stops is one thing: fanning out a
-whole cast or a shelf of props before the player has seen any of it. If you are
-refused, you are not out of anything. You have work that nobody has looked at.
+It is not a spend limit (that is the allowance, next section) and it has no
+total — preview between batches and generate as much as the game needs. What
+it stops is one thing: fanning out a whole cast or a shelf of props before the
+player has seen any of it. If you are refused, you are not out of anything.
+You have work that nobody has looked at.
 
 ```bash
 npx genex model "..." --no-wait   # a batch you can finish
@@ -63,6 +64,26 @@ npx genex wait --all              # collect it
 npx genex preview                 # free, seconds — and the count is zero again
 ```
 
+## Generate what the wallet can carry
+
+Every build also has an **asset allowance** — a slice of the account's credits,
+sized from the live balance the first time a paid command runs and held still
+after that. `npx genex budget` prints it live: balance, spendable, the
+allowance, spent this build, remaining, and the price of every kind. Run it
+before the first batch and after each preview.
+
+The allowance is the build's asset money and it is MEANT to go on what the
+brief names — leaving it unspent while you code-build the named things is as
+wrong as draining it on props. Plan the asset table against it: the named
+things first, then what makes the scene read, on the cheapest lane that reaches
+the bar. If the plan needs more than it holds, ask the player with the number
+BEFORE trimming; only their word raises it (`npx genex budget --assets
+<credits> --user-approved`). If no answer comes and the build must proceed,
+generate the named things first, code-build the rest, and say so in the
+summary. A refusal past the allowance means the build has reached its
+allowance, not that the account is empty; failed generations are refunded and
+do not count.
+
 ## The one rule
 
 An asset is not done when the command exits. It is done when something in

package/templates/skills/genex-updates/SKILL.md

@@ -38,7 +38,7 @@ update, so update immediately.)
 Run exactly the command the nudge printed, from the game project root:
 
 ```bash
-npm i -D @genex-ai/cli-demo@latest   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@dev   # the genex CLI (a dev dependency)
 npm i @genex-ai/embed-sdk@latest     # identity/saves SDK (ships inside the game)
 npm i @genex-ai/multiplayer@latest   # multiplayer SDK (only if the game uses it)
 ```