@call-me-sensei/toonlab 0.4.23 → 0.5.0

package/NPM-LIBRARY.md

@@ -1,7 +1,7 @@
 # ToonLab npm library guide
 
 This guide is included in `@call-me-sensei/toonlab`. It is the package-first
-reference for version 0.4.23 and does not require access to the source
+reference for version 0.5.0 and does not require access to the source
 repository.
 
 ## Install
@@ -89,9 +89,10 @@ import {
 } from '@call-me-sensei/toonlab/toon';
 
 const settings = createToonSettings({
-  rimLight: { intensity: 0.35, mode: 'depth' },
-  outline: { thickness: 1.6 },
-  skinTone: { skinShadowBrightness: 0.94 },
+  preset: 'call_me_sensei',
+  rim: { intensity: { hair: 0.35 }, mode: 'depth' },
+  outline: { width: { cloth: 0.006 } },
+  ramp: { tone: { skin: [0.93, 0.74, 0.68] } },
 });
 
 applyToonShader(characterRoot, { settings });
@@ -142,7 +143,7 @@ surface detail, not displacement that replaces a geometric high-to-low bake.
 
 ## Load Nature Reference Rocks
 
-Version 0.4.23 understands both the original `rock-0001`–`rock-0480`
+Version 0.5.0 understands both the original `rock-0001`–`rock-0480`
 identities and the Nature Reference Rocks catalog. Acquiring an asset
 directly returns its realistic PBR GLB. The one-call placement path additionally
 loads that asset's reviewed geology maps and `call_me_sensei` material settings
@@ -228,7 +229,7 @@ it uses the disk workspace passed through `--workspace`; no account is needed.
       "command": "npx",
       "args": [
         "-y",
-        "--package=@call-me-sensei/toonlab@0.4.23",
+        "--package=@call-me-sensei/toonlab@0.5.0",
         "toonlab-mcp",
         "--workspace",
         "/absolute/path/to/your-game/.toonlab"

package/README.md

@@ -19,7 +19,7 @@ Use ToonLab as a focused runtime library (`@call-me-sensei/toonlab` on npm), as
 an asset/preset authoring workspace, or as an asset-discovery service—not as a
 one-shot world generator.
 
-## Versioned expectation: 0.4.23
+## Versioned expectation: 0.5.0
 
 For a correctly constructed and semantically labeled scene, one strict Call Me
 Sensei bundle application is expected to establish the supported visual
@@ -115,7 +115,7 @@ await inspector.setDomainEnabled(label.domain, false);
 **Run the labs locally** (this repo):
 
 ```bash
-git clone https://github.com/call-me-sensei/toonlab.git && cd toonlab
+git clone https://github.com/call-me-sensei-app/toonlab.git && cd toonlab
 npm install
 npm run setup
 npm run dev
@@ -125,7 +125,7 @@ Setup starts local Postgres with Docker Compose, applies schema migrations and
 official catalog seeds, and reports configured BYO-key providers. Set an
 external `DATABASE_URL` to use an existing Postgres service instead. Vite
 serves the labs at `http://127.0.0.1:5175`. See
-[Getting started](https://github.com/call-me-sensei/toonlab/blob/main/docs/getting-started.md) for a tour.
+[Getting started](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/getting-started.md) for a tour.
 
 ### Open the full documentation locally
 
@@ -153,7 +153,7 @@ Prerequisites:
 Install and configure:
 
 ```bash
-git clone https://github.com/call-me-sensei/toonlab.git
+git clone https://github.com/call-me-sensei-app/toonlab.git
 cd toonlab
 npm install
 cp .env.example .env
@@ -317,8 +317,8 @@ exported files; generate approved seeded recipes; and import assets into the
 project. Authored Gallery recipes are fetched with their public license and
 provenance instead of being copied into the npm package. The server uses stdio,
 requires no account or OAuth for public discovery, and keeps local work local.
-See [Local MCP and workspace](https://github.com/call-me-sensei/toonlab/blob/main/docs/mcp.md) and
-[Local database and public asset releases](https://github.com/call-me-sensei/toonlab/blob/main/docs/local-database-and-public-assets.md).
+See [Local MCP and workspace](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/mcp.md) and
+[Local database and public asset releases](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/local-database-and-public-assets.md).
 
 ## The labs
 
@@ -326,7 +326,7 @@ Lab UIs are development tools and are not published in the npm package. The
 Labs home (`/`) presents the 15 live user-facing Labs by the artifact they
 author. Every Lab can save and reopen its documented portable creation type;
 preview cameras, stages, lights, playback, and comparison helpers remain
-preview-only. See [The 15 live ToonLab Labs](https://github.com/call-me-sensei/toonlab/blob/main/docs/live-labs.md).
+preview-only. See [The 15 live ToonLab Labs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/live-labs.md).
 
 Focused ToonLab shaders, water, vegetation, generated assets, texture recipes,
 Gallery assets, and metadata are intended for supplied scene content. Complete
@@ -336,7 +336,7 @@ construction remain host responsibilities.
 Every lab also uses one shared 24-hour preview harness with Dawn, Day, Sunset,
 and Night captures. The Day reference must visibly show Call Me Sensei's
 cool/blue shadow response. See the
-[universal preview contract](https://github.com/call-me-sensei/toonlab/blob/main/docs/lab-preview-environment.md).
+[universal preview contract](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/lab-preview-environment.md).
 
 - **Shaders** — Character, Tree, Grass, Flower, Rock, Ground, Manufactured
   Surface, Water, Sky, Cloud, and integrated Sky & Cloud authoring.
@@ -345,8 +345,8 @@ cool/blue shadow response. See the
 
 Every card links to a working editor. Integration examples are documented as
 examples rather than additional Labs. See
-[Lab responsibilities](https://github.com/call-me-sensei/toonlab/blob/main/docs/lab-architecture.md) for scope rules and
-[Getting started](https://github.com/call-me-sensei/toonlab/blob/main/docs/getting-started.md) for current direct routes.
+[Lab responsibilities](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/lab-architecture.md) for scope rules and
+[Getting started](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/getting-started.md) for current direct routes.
 
 Sky, Cloud, and Water Labs author reusable rendering artifacts. Your application
 still supplies valid scene geometry, placement, current conditions, and the
@@ -362,7 +362,7 @@ retired after the verified commit. Static hosted builds
 fall back to browser storage. **Reset Lab** clears the current lab state.
 Point any model-aware lab at your own model with the Model URL input or
 `?model=` — see
-[Characters](https://github.com/call-me-sensei/toonlab/blob/main/docs/characters.md).
+[Characters](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/characters.md).
 
 ## What's inside
 
@@ -375,21 +375,21 @@ camera behavior, and game feel remain host-owned or pre-beta.
 
 | Cluster | Import | What you get |
 |---|---|---|
-| Styles and bundles | `@call-me-sensei/toonlab/styles` | Local, versioned style-bundle documents that coordinate domain profiles without storing asset identity or current scene state. Create, validate, serialize, parse, and resolve JSON with no account or database; hosts currently route explicitly labeled assets through each owning runtime. [Contract](https://github.com/call-me-sensei/toonlab/blob/main/docs/styles-and-bundles.md) |
-| Toon character shading | `@call-me-sensei/toonlab/toon` | Modern anime character shader: cel bands with art-directed face lighting, skin-tone shadow management, shadow-color HSV control, scene/self/contact shadows, average-shadow smoothing, rim light (fresnel or screen-space depth), stylized + anisotropic hair highlights, eye catchlights, role-aware specular, source map routing (normal/AO/emissive/MatCap/ramp/detail), inverted-hull outlines, glitter, stickers, perspective removal, shell fur, dither fades — 23 settings groups, all preset-serializable. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/toon-shading.md) |
-| Environment shading | `@call-me-sensei/toonlab/environment` | Modern anime-style scene shader for texture packs, standard glTF, and untextured scenes: material-role classification, wrapped lighting, packed-map hints, window cutouts, sun/lamp rigs, time-of-day, six-direction ambient probe, planar floor reflections, BVH vertex-AO baking, height fog, cloud shadows. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/environment.md) |
-| Water | `@call-me-sensei/toonlab/water` | Focused water treatment for a host-authored water footprint, continuous shore, and closed seabed: Gerstner waves, absorption color, refraction/caustics/foam, ripples, splashes, wakes, kelp, underwater treatment, and CPU buoyancy sampling. It does not design the coast or underwater habitat. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/water.md) |
-| Vegetation | `@call-me-sensei/toonlab/vegetation` | Tree/grass/flower construction and shader runtimes, including the focused procedural broadleaf `BranchTree` with deterministic branching, eight leaf silhouettes, caller-supplied leaf/bark textures, and a portable recipe. No authored tree asset collection is bundled or exported: reviewed tree recipes remain searchable Gallery assets delivered through MCP with their CC0 metadata. Package-generated trees preserve authored bark first and otherwise select a registered deterministic bark surface instead of a bare trunk. The experimental species roster remains repository-only. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/vegetation-sky.md) |
-| Rock shader | `@call-me-sensei/toonlab/rock-shader` | Detailed, versioned rock-material profiles with projected detail, distance tint, normal fading, striping, moss and optional top layers, plus explicit source-albedo and vertex-color/AO integration. Call Me Sensei is the default. Geometry generation remains separate in `rockgen`. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/rock-shader.md) |
-| Ground shader | `@call-me-sensei/toonlab/ground-shader` | Splat-weighted anime terrain with slope/cliff detail, shoreline and weather response, HDR sun/shade controls, safe shadow defaults, and flat-albedo ground-field output for vegetation adoption. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/ground-shader.md) |
-| Sky | `@call-me-sensei/toonlab/sky` | Reusable atmosphere, palette, sun, moon, stars, and god-ray settings authored by Sky Lab and Sky & Cloud Lab. Your application coordinates final lighting and scene state. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/sky.md) |
-| Cloud | `@call-me-sensei/toonlab/cloud` | Reusable cloud shape, erosion, density, lighting, wind, cirrus, haze, fade, style, and hero-cloud recipe controls authored by Cloud Shader Lab and Sky & Cloud Lab. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/cloud-shader.md) |
-| Post-processing | `@call-me-sensei/toonlab/post` | Optional single-pipeline compositor: character-aware bloom, color grade, LUT, vignette, screen outline, depth cue — schema-driven, preset-serializable. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/post-processing.md) |
-| Procedural textures | `@call-me-sensei/toonlab/texgen` | Seamless CPU-baked PBR texture generator: 25 tileable pattern/noise generators, layered detail + colored overlays (moss, rust, grime), five-stop cel-capable color ramp, cavity/sheen hand-painted read, derived normal/AO/roughness/metalness/height/ORM/emissive maps, 60+ presets, and a natural-language recipe mapper (offline keywords or BYO-key Gemini/OpenAI). [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/texture-lab.md) |
-| Character pipeline | `@call-me-sensei/toonlab/character` | High-level load/style/rig/animate lifecycle runtime, bone-role adapters for VRM/MMD/Mixamo/Rigify rigs, native-or-packaged locomotion fallback, and procedural freestyle swim. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/characters.md) |
+| Styles and bundles | `@call-me-sensei/toonlab/styles` | Local, versioned style-bundle documents that coordinate domain profiles without storing asset identity or current scene state. Create, validate, serialize, parse, and resolve JSON with no account or database; hosts currently route explicitly labeled assets through each owning runtime. [Contract](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/styles-and-bundles.md) |
+| Toon character shading | `@call-me-sensei/toonlab/toon` | Anime-game character shader: flat lit colour, per-surface shadow tones with a warm band at the terminator, face maps baked automatically from the face, a nose shadow, eye-white shade and stocking sheen derived from the model, environment-aware light (sun, sky, cast shade), scenery, character and hair-on-face shadows, depth rim, hair ring and masked specular, ink outlines coloured from the surface, source map routing (normal/AO/emissive/MatCap/detail), stickers, shell fur, dither fades — 14 settings groups, all preset-serializable. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/toon-shading.md) |
+| Environment shading | `@call-me-sensei/toonlab/environment` | Modern anime-style scene shader for texture packs, standard glTF, and untextured scenes: material-role classification, wrapped lighting, packed-map hints, window cutouts, sun/lamp rigs, time-of-day, six-direction ambient probe, planar floor reflections, BVH vertex-AO baking, height fog, cloud shadows. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/environment.md) |
+| Water | `@call-me-sensei/toonlab/water` | Focused water treatment for a host-authored water footprint, continuous shore, and closed seabed: Gerstner waves, absorption color, refraction/caustics/foam, ripples, splashes, wakes, kelp, underwater treatment, and CPU buoyancy sampling. It does not design the coast or underwater habitat. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/water.md) |
+| Vegetation | `@call-me-sensei/toonlab/vegetation` | Tree/grass/flower construction and shader runtimes, including the focused procedural broadleaf `BranchTree` with deterministic branching, eight leaf silhouettes, caller-supplied leaf/bark textures, and a portable recipe. No authored tree asset collection is bundled or exported: reviewed tree recipes remain searchable Gallery assets delivered through MCP with their CC0 metadata. Package-generated trees preserve authored bark first and otherwise select a registered deterministic bark surface instead of a bare trunk. The experimental species roster remains repository-only. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/vegetation-sky.md) |
+| Rock shader | `@call-me-sensei/toonlab/rock-shader` | Detailed, versioned rock-material profiles with projected detail, distance tint, normal fading, striping, moss and optional top layers, plus explicit source-albedo and vertex-color/AO integration. Call Me Sensei is the default. Geometry generation remains separate in `rockgen`. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/rock-shader.md) |
+| Ground shader | `@call-me-sensei/toonlab/ground-shader` | Splat-weighted anime terrain with slope/cliff detail, shoreline and weather response, HDR sun/shade controls, safe shadow defaults, and flat-albedo ground-field output for vegetation adoption. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/ground-shader.md) |
+| Sky | `@call-me-sensei/toonlab/sky` | Reusable atmosphere, palette, sun, moon, stars, and god-ray settings authored by Sky Lab and Sky & Cloud Lab. Your application coordinates final lighting and scene state. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/sky.md) |
+| Cloud | `@call-me-sensei/toonlab/cloud` | Reusable cloud shape, erosion, density, lighting, wind, cirrus, haze, fade, style, and hero-cloud recipe controls authored by Cloud Shader Lab and Sky & Cloud Lab. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/cloud-shader.md) |
+| Post-processing | `@call-me-sensei/toonlab/post` | Optional single-pipeline compositor: character-aware bloom, color grade, LUT, vignette, screen outline, depth cue — schema-driven, preset-serializable. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/post-processing.md) |
+| Procedural textures | `@call-me-sensei/toonlab/texgen` | Seamless CPU-baked PBR texture generator: 25 tileable pattern/noise generators, layered detail + colored overlays (moss, rust, grime), five-stop cel-capable color ramp, cavity/sheen hand-painted read, derived normal/AO/roughness/metalness/height/ORM/emissive maps, 60+ presets, and a natural-language recipe mapper (offline keywords or BYO-key Gemini/OpenAI). [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/texture-lab.md) |
+| Character pipeline | `@call-me-sensei/toonlab/character` | High-level load/style/rig/animate lifecycle runtime, bone-role adapters for VRM/MMD/Mixamo/Rigify rigs, native-or-packaged locomotion fallback, and procedural freestyle swim. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/characters.md) |
 | Scene surface runtime | `@call-me-sensei/toonlab/runtime` | One strict heightfield contract for grounded props/characters, terrain-aware meadow scatter, shoreline water bed/phase/state wiring, source-texture continuity, and actual labeled shadow-coverage readiness. The host still authors terrain and XZ layout. |
 | Scene collision runtime | `@call-me-sensei/toonlab/runtime` | Automatic reversible collision discovery for labeled static solids, lightweight walkable blockers by default, strict readiness diagnostics, and public Rapier/custom-adapter integration. |
-| Model loaders | `@call-me-sensei/toonlab/loaders` | Optional GLB/glTF, VRM 0+1, PMX/PMD, FBX, OBJ, and text-USDZ loading helpers. Kept off the root import so apps that do not load models avoid loader dependencies. [Docs](https://github.com/call-me-sensei/toonlab/blob/main/docs/characters.md) |
+| Model loaders | `@call-me-sensei/toonlab/loaders` | Optional GLB/glTF, VRM 0+1, PMX/PMD, FBX, OBJ, and text-USDZ loading helpers. Kept off the root import so apps that do not load models avoid loader dependencies. [Docs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/characters.md) |
 
 The main `vegetation` barrel exposes the complete runtime. Smaller consumers
 can import the same bindings from
@@ -573,7 +573,8 @@ Use the domain-specific runtimes below to implement each `apply` callback.
 Asset identity stays in project/library sourcing configuration; it is never
 embedded in the style bundle. Custom adapters and custom assets must be
 recorded in `.toonlab/reports/style-asset-gaps.json` and
-`TOONLAB_ASSET_GAPS.md`.
+`.toonlab/reports/asset-gaps.md`. These generated review records stay local and are
+excluded from source control.
 
 ### Individual clusters
 
@@ -582,8 +583,8 @@ import { applyToonShader, createToonSettings } from '@call-me-sensei/toonlab/too
 
 const settings = createToonSettings({
   preset: 'default',
-  skinTone: {
-    skinShadowBrightness: 0.94,
+  ramp: {
+    tone: { skin: [0.94, 0.82, 0.76] },
   },
 });
 
@@ -622,42 +623,42 @@ stack, with WebGL2 fallback through the same TSL path.
   MCP setup, the prompt cookbook, and the full settings reference. Hosted
   features are marked "Pro"; the extended hosted docs live at
   [toonlab.io/docs](https://toonlab.io/docs).
-- [Lab responsibilities](https://github.com/call-me-sensei/toonlab/blob/main/docs/lab-architecture.md) — the finalized artifact,
+- [Lab responsibilities](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/lab-architecture.md) — the finalized artifact,
   production-method, editor/library, and preview-state boundaries.
-- [The 15 live ToonLab Labs](https://github.com/call-me-sensei/toonlab/blob/main/docs/live-labs.md) — each user-facing editor, saved artifact, runtime, and generation workflow.
-- [Universal lab preview environment](https://github.com/call-me-sensei/toonlab/blob/main/docs/lab-preview-environment.md) —
+- [The 15 live ToonLab Labs](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/live-labs.md) — each user-facing editor, saved artifact, runtime, and generation workflow.
+- [Universal lab preview environment](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/lab-preview-environment.md) —
   shared 24-hour controls, four-state regression matrix, and required cool/blue
   daylight-shadow verification.
-- [Rock shader](https://github.com/call-me-sensei/toonlab/blob/main/docs/rock-shader.md) — the separate generator/material
+- [Rock shader](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/rock-shader.md) — the separate generator/material
   architecture, schema-defined public configuration, import policy, and bundle use.
-- [Styles, style bundles, and asset routing](https://github.com/call-me-sensei/toonlab/blob/main/docs/styles-and-bundles.md) —
+- [Styles, style bundles, and asset routing](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/styles-and-bundles.md) —
   rendering domains, required asset labels, fallback policy, bundle ownership,
   OSS application boundaries, and the shader/lab migration contract.
-- [Open asset library and scene coverage](https://github.com/call-me-sensei/toonlab/blob/main/docs/open-asset-library.md) —
+- [Open asset library and scene coverage](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/open-asset-library.md) —
   measurable scene-kit coverage, curated stylized generator base sets,
   CC0/CC-BY provenance, gallery routing, and generation fallback policy.
-- [Getting started](https://github.com/call-me-sensei/toonlab/blob/main/docs/getting-started.md) — clone, run, tour the labs,
+- [Getting started](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/getting-started.md) — clone, run, tour the labs,
   load your own models.
-- [Current capability status](https://github.com/call-me-sensei/toonlab/blob/main/docs/capability-status.md) — recommended
+- [Current capability status](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/capability-status.md) — recommended
   existing-scene, Gallery, MCP, and focused-authoring workflows versus
   experimental scene-construction claims.
-- [Toon character shading](https://github.com/call-me-sensei/toonlab/blob/main/docs/toon-shading.md)
-- [Manufactured environment materials](https://github.com/call-me-sensei/toonlab/blob/main/docs/urban-prop-surface-roles.md) —
+- [Toon character shading](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/toon-shading.md)
+- [Manufactured environment materials](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/urban-prop-surface-roles.md) —
   the layered classify-once contract for props, vehicles, buildings,
   interiors, and reusable material-aware shaders.
-- [Environment shading](https://github.com/call-me-sensei/toonlab/blob/main/docs/environment.md)
-- [Styles and bundles](https://github.com/call-me-sensei/toonlab/blob/main/docs/styles-and-bundles.md) — apply coordinated treatments to explicitly labeled scene targets.
-- [Current release notes](https://github.com/call-me-sensei/toonlab/blob/main/docs/release-notes.md)
-- [Water](https://github.com/call-me-sensei/toonlab/blob/main/docs/water.md)
-- [Sky system](https://github.com/call-me-sensei/toonlab/blob/main/docs/sky.md)
-- [Cloud shader](https://github.com/call-me-sensei/toonlab/blob/main/docs/cloud-shader.md)
-- [Vegetation](https://github.com/call-me-sensei/toonlab/blob/main/docs/vegetation-sky.md)
-- [Post-processing](https://github.com/call-me-sensei/toonlab/blob/main/docs/post-processing.md)
-- [Texture Lab and texgen](https://github.com/call-me-sensei/toonlab/blob/main/docs/texture-lab.md)
-- [Characters and animation](https://github.com/call-me-sensei/toonlab/blob/main/docs/characters.md)
-- [Settings reference](https://github.com/call-me-sensei/toonlab/blob/main/docs/settings-reference.md) — selected runtime and repository settings,
+- [Environment shading](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/environment.md)
+- [Styles and bundles](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/styles-and-bundles.md) — apply coordinated treatments to explicitly labeled scene targets.
+- [Current release notes](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/release-notes.md)
+- [Water](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/water.md)
+- [Sky system](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/sky.md)
+- [Cloud shader](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/cloud-shader.md)
+- [Vegetation](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/vegetation-sky.md)
+- [Post-processing](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/post-processing.md)
+- [Texture Lab and texgen](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/texture-lab.md)
+- [Characters and animation](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/characters.md)
+- [Settings reference](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/settings-reference.md) — selected runtime and repository settings,
   generated from the schemas (`node scripts/generate-settings-reference.mjs`).
-- [Shader constants](https://github.com/call-me-sensei/toonlab/blob/main/docs/shader-constants.md) — the deliberately unexposed
+- [Shader constants](https://github.com/call-me-sensei-app/toonlab/blob/main/docs/shader-constants.md) — the deliberately unexposed
   constants and where they live.
 
 ## Build with an AI coding agent

package/agents/PROMPTS.md

@@ -1,7 +1,7 @@
 # ToonLab agent prompts
 
 These prompts are included with the npm package. They use only the supported
-0.4.23 runtime, agent skills, and MCP workflows.
+0.5.0 runtime, agent skills, and MCP workflows.
 
 ## New playable game
 

package/agents/references/custom-gap-report.md

@@ -12,5 +12,5 @@ Custom work should be traceable instead of becoming an invisible fallback. Befor
 - Why the customization exists and what your team may want to revisit later.
 
 The MCP server maintains `.toonlab/reports/style-asset-gaps.json` and the
-project-level `TOONLAB_ASSET_GAPS.md`. Keep both with your project whenever it
-uses custom rendering or content outside the supported library.
+workspace report `.toonlab/reports/asset-gaps.md`. These are local review records; exclude
+them from source control when working with custom rendering or content.

package/agents/skills/claude/toon-shading/SKILL.md

@@ -11,7 +11,7 @@ References beginning `agents/` resolve from the installed ToonLab package root
 
 Use this skill when a developer wants ToonLab character toon materials, toon
 settings, preset documents, material-role handling, outlines, hair highlights,
-rim light, shadows, stickers, glitter, fur, or debug views in their app.
+rim light, shadows, shadow tones, face maps, stickers, fur, or debug views in their app.
 
 Public imports:
 - `@call-me-sensei/toonlab/toon`

package/agents/skills/codex/toon-shading/SKILL.md

@@ -11,7 +11,7 @@ References beginning `agents/` resolve from the installed ToonLab package root
 
 Use this skill when a developer wants ToonLab character toon materials, toon
 settings, preset documents, material-role handling, outlines, hair highlights,
-rim light, shadows, stickers, glitter, fur, or debug views in their app.
+rim light, shadows, shadow tones, face maps, stickers, fur, or debug views in their app.
 
 Public imports:
 - `@call-me-sensei/toonlab/toon`