@genex-ai/cli-demo 0.63.0-dev.149 → 0.64.0-dev.154

package/README.md

@@ -16,7 +16,9 @@ genex sfx "<prompt>"       # generate a sound fx  → prints an asset URL
 genex texture "<prompt>"   # generate a texture   → prints an asset URL
 genex image "<prompt>"     # generate an image    → prints an asset URL
 genex video "<prompt>"     # generate a video     → prints an asset URL
-genex character "<prompt>" # generate a controller-ready Meshy humanoid
+genex character "<brief>"  # generate 3 neutral-A-pose concept candidates
+genex character preview <concept-id> --candidate 1 --user-approved
+genex character finalize <preview-id> --user-approved --approve-remesh 10000
 genex character animate <id> --action <action-id>  # add a same-rig Meshy action
 genex animations search "<intent>" --json           # search the committed Meshy catalog locally
 genex wait <id>            # attach to a --no-wait generation and print its URL(s) when done
@@ -138,15 +140,31 @@ one call (`image-main` + `image-alt-N` URLs) — pick the best instead of re-rol
 
 ## Meshy characters and animations
 
-`genex character "<prompt>"` runs a controller-ready Meshy workflow through the
-same authenticated credit, BullMQ/Redis, and R2 generation pipeline. It defaults
-to a Meshy 6 textured A-pose humanoid with browser-oriented remeshing, rigging,
-and the immutable preview-reviewed neutral-v3 idle/walk/run/crouch/jump pack.
-Required native motion is checked without rewriting limb rotations; a rejected
-A-pose candidate retries the complete workflow once in T-pose before optional
-actions start. `--animation <id-or-query>` is repeatable;
-`--height`, `--polycount`, `--no-controller-pack`, and `--no-wait` adjust the
-request. The CLI prints an atomic component quote before enqueueing.
+The default Meshy lane is an approval-gated, three-command workflow through the
+same authenticated credit, BullMQ/Redis, and R2 generation pipeline:
+
+```bash
+genex character "<approved visual direction>"
+genex character preview <concept-id> --candidate <1|2|3> --user-approved
+genex character finalize <preview-id> --user-approved --approve-remesh 10000
+```
+
+The first command produces exactly three full-body neutral-A-pose concept
+images and a contact sheet, then stops. The second converts only the selected
+image into an unremeshed, textured Meshy 6 high-detail GLB, preserves it in R2,
+and returns front/back/left/right views plus its measured face count. The final
+command requires another explicit approval, creates a separate 10,000-face
+triangle remesh, rigs that exact remesh, and installs the immutable
+preview-reviewed neutral-v3 idle/walk/run/crouch/jump pack. There is no silent
+T-pose fallback in this guided lane. Native limb rotations are preserved; only
+horizontal root/hip translation may be normalized for Rapier ownership.
+
+`--animation <id-or-query>` is repeatable on the initial concept command or on
+`finalize`; requested actions run only after the controller pack succeeds.
+`--height` and `--no-wait` carry through the approval flow. The guided lane
+always installs neutral-v3. `genex character "<prompt>" --direct-text` is the
+explicit compatibility path; only that path accepts `--polycount` or
+`--no-controller-pack`, and its default polycount is also 10,000.
 
 Search before spending: