@docyrus/animaguru 0.20.0 → 0.23.0

package/NOTICE.md

@@ -1473,7 +1473,7 @@ SOFTWARE.
 
 Video style sources and notices
 
-The executable studies and preview art are original AnimaGuru procedural 2D/2.5D work. Material/motion guidance was adapted from the pinned repositories below. No external creator video, sample music or demo font is bundled. Third-party demo assets retain their own licenses.
+The executable studies and preview art are original AnimaGuru procedural 2D/2.5D work. Material/motion guidance was adapted from the pinned repositories below. The Machine Anatomy geometry kit (src/kit/anatomy/iso-kit.ts) is a verbatim copy from anatomy; its MIT notice is also in src/kit/anatomy/LICENSE. No external creator video, sample music or demo font is bundled. Third-party demo assets retain their own licenses.
 
 lemo-opuscar
 MIT License
@@ -1527,6 +1527,30 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
+anatomy
+MIT License
+
+Copyright (c) 2026 Ryan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
 ## Art Motion references
 
 English adaptations of Huashu Art Motion (https://github.com/alchaincyf/huashu-art-motion). Source revision and coverage are in skills/animaguru-art-motion/references/coverage.json.

package/README.md

@@ -41,9 +41,11 @@ CLI versions before 0.16.2 need one manual update to gain enforcement. Publish t
 
 ## Create an animation video project
 
+CLI 0.23.0 adds eight evidence styles, in which real data, imagery or scans carry the film: Satellite Briefing, Engineering Briefing Board, LiDAR Survey, White Model Projection, Data Physicalization, Exploded Teardown, Microscope Story and Archive Light Table. Their skills ask for the user's own data first, list licence-clean sources, keep `production/FACTS.md` and `production/CREDITS.md`, and never let a generated image stand in for evidence. Each has a runnable study (`npm run example -- satellite-briefing`).
+
 CLI 0.16.2 also installs `animaguru-art-motion` for Codex and Claude Code: one skill with 36 English art-treatment references and nine explainer motion grammars, plus AnimaGuru generation, timing, camera and review guidance. Request it explicitly for a custom film treatment; its references are separate from the gallery presets. Source coverage and the upstream MIT notice are included in the skill.
 
-CLI 0.5.2 includes a complete local PixiJS video workspace with 31 visual styles:
+CLI 0.5.2 includes a complete local PixiJS video workspace, now with 40 visual styles:
 
 ```sh
 animaguru templates
@@ -59,13 +61,15 @@ Open the generated folder in **Codex or Claude Code**, then describe the video y
 - Agent instructions that first ask **Explainer, Advertisement or General Video**, then offer the available visual styles and [the preview gallery](https://animaguru.com/animation-styles), then gather a short creative brief. Each choice is saved before continuing.
 - `film.config.json`, editable TypeScript scenes, localized copy, local asset/production folders, portable HTML5 ZIP export for iframe embedding, and `npm run export:mp4` with exact frame capture and output verification.
 
-New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The 31 visual styles cover cutout, type, vector, technical, character, print, paper, material and cinematic treatments. Every style skill ships with the project, including its relevant visual interview and review criteria. Categories describe purpose and templates describe appearance and motion. The brief establishes audience, tone, message, story, duration and any CTA.
+New projects leave category and template unset in `animaguru.project.json`. `animaguru.templates.json` lists categories, styles and their installed skills. The 40 visual styles cover cutout, type, vector, technical, evidence, character, print, paper, material and cinematic treatments. Every style skill ships with the project, including its relevant visual interview and review criteria. Categories describe purpose and templates describe appearance and motion. The brief establishes audience, tone, message, story, duration and any CTA.
+
+CLI 0.23.0 also adds **Machine Anatomy** (`machine-anatomy`): an idea explained as a working isometric machine of many small shaded parts in a framed figure card with a live readout. Adapted from the MIT-licensed [Anatomy](https://github.com/wheresryan22/anatomy) skill, it bundles that skill's geometry kit in `src/kit/anatomy/` with a PixiJS adapter, and `npm run example -- machine-anatomy` installs its original study.
 
 Scaffolding requires no AnimaGuru sign-in and spends no generation credits; dependency installation requires npm access. `npm run dev` previews the project, and `npm run build` checks and bundles it. To export, run `npm run export:mp4`, open its local URL and wait for the verified MP4, or use HTML5 export for embedding. The starter demo is silent; the agent creates narration and music when in scope.
 
 The official PixiJS skills are vendored with their MIT license and a hashed provenance manifest. Skills and template files ship in both the npm package and macOS installer; `create` does not fetch agent instructions from a remote repository at runtime.
 
-CLI 0.16.1 also installs **AnimaGuru Cutcraft** in both agent skill folders. Ask your agent to use `$animaguru-cutcraft` for tactile paper-collage explainers with exact editorial lettering, one narrator and purposeful cutout motion. Its generation adapter checks the server's enabled models, tracks asynchronous jobs and supports controlled animation of generated transparent artwork when precise placement is needed or video providers are unavailable. Cutcraft is an additional skill; the gallery retains its 31 visual styles.
+CLI 0.16.1 also installs **AnimaGuru Cutcraft** in both agent skill folders. Ask your agent to use `$animaguru-cutcraft` for tactile paper-collage explainers with exact editorial lettering, one narrator and purposeful cutout motion. Its generation adapter checks the server's enabled models, tracks asynchronous jobs and supports controlled animation of generated transparent artwork when precise placement is needed or video providers are unavailable. Cutcraft is an additional skill, not a gallery style.
 
 ## Install the project skill
 
@@ -84,6 +88,19 @@ Running `init` again refreshes an existing skill with the bundled version withou
 
 The default server is https://animaguru.com. Use `--url http://localhost:5190` on the leaf command or `ANIMAGURU_URL` to override it. HTTP is allowed only for loopback development. Authentication is stored separately per server in `~/.config/animaguru/credentials.json`, with file permissions 0600. Set `ANIMAGURU_CONFIG_DIR` for an isolated configuration directory. Browser login uses a ten-minute, single-use device code and receives a seven-day revocable Better Auth session. `auth login --no-browser` prints the URL for manual use. `auth logout` revokes the token. `ANIMAGURU_TOKEN` supports secret injection by agent runners; do not put tokens in arguments or commit them.
 
+## Call the API directly
+
+CLI 0.22.0 adds `animaguru curl` for API endpoints that have no command of their own. It takes curl's flags but no host and no `Authorization` header: it calls only the signed-in server (`--server` or `ANIMAGURU_URL`) and adds the session's token itself, so the token never appears in a command line.
+
+```sh
+animaguru curl /api/v1/me
+animaguru curl -X PATCH /api/v1/projects/prj_123 -d '{"name":"Launch film"}'
+animaguru curl -T film.mp4 /api/v1/some/upload        # streams the file with PUT and Content-Type: video/mp4
+animaguru curl /api/v1/some/download -o film.mp4      # saves to a new file and prints a JSON summary
+```
+
+`-d`/`--data` and `--json` take text, `@FILE` or `@-` (JSON text is sent as `application/json`); `-T` streams a file with `PUT` unless `-X` says otherwise; `-H` adds headers; `-i` prints the status line and headers. Redirects are not followed. Unlike plain curl, an HTTP 4xx or 5xx prints the body and exits non-zero; `--no-fail` exits 0. Video, images and other binary responses go to a file with `-o`, which never overwrites one.
+
 ## Personal and team projects
 
 CLI 0.7.1 can select a cloud workspace for project listing, project creation, and credit balances:
@@ -255,6 +272,18 @@ animaguru assets generate PROJECT_ID --type video --model fal/minimax-h3-max \
 
 H3 takes fractions of a second (`--seconds 6.5`). Lip-sync, recast, relight and 3d-to-video last as long as their speech or video, and `--seconds` doesn't apply to them. Reference images, clips and audio past fal's included allowance add to the cost; so do the references 3d-to-video draws. Their `--dry-run` asks the server, which measures the saved files. `--resolution` and `--mode` default to the first the workflow offers.
 
+CLI 0.21.0 adds Black Forest Labs' FLUX 3 Max on fal.ai (`fal/flux-3-max`). It films from an image (optionally ending on `--end-reference`) or from text, for 5–20 whole seconds at 720p (default) or 1080p, and makes its own sound; it takes no `--soundtrack`. `--workflow keyframes-to-video` passes through up to ten saved images at chosen moments:
+
+```sh
+# Pass through three images: the start, a pose at 2.5 seconds, and the end.
+animaguru assets generate PROJECT_ID --type video --model fal/flux-3-max \
+  --workflow keyframes-to-video --name "Hat on" \
+  --prompt "She picks up the hat, puts it on and smiles at the camera" \
+  --keyframes "0,START_SHA;2.5,POSE_SHA;6,END_SHA" --seconds 6 --dry-run
+```
+
+`--keyframes` takes 1–10 `seconds,SHA` pairs, separated by semicolons, of this project's images or sprite art. Each is reached at its second, within `--seconds`; the clip has 24 frames a second and each keyframe needs a frame of its own. `--aspect-ratio auto` (default) follows the first keyframe, or give a ratio. FLUX 3 Max always works through the prompt before filming: `--prompt-expansion quality` asks for its thorough, slower level, any other value its light one. It takes `--seed`. Its dry runs are local estimates.
+
 Images have a full background by default; `--transparent` requests a cutout. CLI 0.17.0 adds `--references`, `--mask` and the 16:9 and 9:16 shapes. `--aspect-ratio` is 1:1 (default, 1024×1024), 3:2 (1536×1024), 2:3 (1024×1536), 16:9 (1536×864) or 9:16 (864×1536). `--references` takes up to four comma-separated blob SHAs of this project's images (including attached uploads) or sprite art, and the new image follows them: generate a character sheet once, then reference it in every scene to keep the character consistent. Refer to them in the prompt as Image 1, Image 2 and so on, and say what to take from each. Each reference adds a little to the estimate. `--mask` edits only part of Image 1, the first reference: give up to eight rectangles as `x,y,width,height` fractions of its size from the top left, separated by semicolons (`0,0,1,0.4` is the top 40%). The rest of the image is kept, and the result keeps Image 1's shape, which must be one of the five above. Gemini speech's `--prompt` is the verbatim transcript, and `--delivery` controls how it sounds without being spoken. Gemini speech supports both `gemini-3.8-flash-tts` and `gemini-3.8-flash-lite-tts`. Music uses Lyria. Google audio requires the server's `AI_PROVIDER_KEY_GOOGLE` secret; no provider keys are stored in the CLI.
 
 Preview a validated request and its estimated credits with `--dry-run`, without spending credits; most dry runs work offline without signing in: