diff --git a/MEMORY.md b/MEMORY.md index 3667039..efd7864 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -12,11 +12,9 @@ canonical implemented-features list in `docs/development-status.md`. `docs/screens/refs/` always passes the sidecar licence + privacy gate and `CREDITS.md`. - **AI-assisted asset review loop (2026-11-04):** head/face shape decisions use a concept + judge loop — generate a target concept (`generate_textures.generate_image`, Seedream) and use - `tools/describe_image.py` as the vision judge, iterating on the mesh until the judge's specific - fixes converge. This is what picked the MakeHuman head over the procedural displacement head - (`_head_proto` oscillates between "decorated egg" and "spiky wedges" at ~3/5 on the coarse - sphere). Review page: `docs/screens/head-review/README.md`; methodology note: - `docs/3d-model-review.md` §AI-driven head rework. + `tools/describe_image.py` as the vision judge, iterating until the judge's specific fixes + converge. Review pages: `docs/screens/head-review/README.md`, `docs/3d-model-review.md` + §AI-driven head rework. - **Project agent skills (2026-11-03):** two tracked skills live in `.agents/skills/`: `gig-line-blender-asset-contract` and `gig-line-release-qa`. They are guidance only, add no runtime dependency and are referenced from `tools/README.md`. The third-party @@ -193,54 +191,6 @@ canonical implemented-features list in `docs/development-status.md`. - Localization target languages beyond English. - macOS notarization approach for broad distribution. -## Handoff - -### 2026-11-05 — NPC plan pivot and tmp cleanup - -**What changed:** the NPC character direction was rewritten around the researched CC0 -Quaternius character. ADR-0017 supersedes the generator-first decision in ADR-0015. `PLAN.md`, -`TODO.md`, `MEMORY.md`, `README.md`, `CREDITS.md`, the architecture/asset/review docs and the -docs index now point to the Quaternius base. The old MPFB/MakeHuman body tracks were closed and -their plans removed from `TODO.md`; the MakeHuman head and procedural `npc_base` remain tested -fallbacks only. - -**Cleanup:** `tmp/` was reduced from ~2.9 GB to 4.7 MB. Removed the MPFB/MakeHuman scripts, -review renders, map scratch output and logs. Kept only the three researched Quaternius GLBs, -the Quaternius mirror HTML/README/licence, `prototype_quaternius.py`, and a local -`tmp/npc-research/quaternius/README.md` with hashes and re-download links. Do not delete that -folder while the migration is active. - -**Implementation status:** planning and documentation only. No character GLB, code, manifest, -AO map or test was changed. The 12 shipped NPC GLBs still use the old procedural bodies. - -**Next task (start here):** `TODO.md` → *Quaternius NPC base migration* → §1 Intake and -canonical base. First concrete step: inventory the four meshes, 62 joints, 24 clips and -material names in each of the three GLBs, then build a welded, grounded, animation-free -`quaternius_base.glb` at 1.81 m with front on Blender −Y. - -**Main risk:** the source is a 62-joint T-pose with realistic proportions (research measured -~0.96 m hip, ~1.68 m arm span, ~0.153 m shoulder offset), while the runtime contract is an -arm-down 13-core rig with a 0.62 m hip and 0.27 m wrist targets. The Stage 1 proportion warp is -the make-or-break step. Judge the Quaternius result directly; do not reuse the old MPFB arm -warp. If the warp fails the silhouette/gear gate, stop and write the Stage 2 62-joint ADR. - -**Key paths:** -- Source GLBs: `tmp/npc-research/quaternius/{Casual,Casual_Hoodie,Worker}.glb` -- Source hashes and inventory: `docs/npc-model-sourcing.md` -- Decision: `docs/adr/0017-quaternius-npc-base.md` -- Contract: `docs/architecture.md#character-and-gear-asset-contract` -- Runtime selector/fallback: `src/game/npc_avatar.gd`, `assets/models/blender/` -- Current library builder/fallback: `tools/blender_assets.py`, `tools/npc_pipeline.py`, - `assets/models/generated/npc_base.glb` - -**Useful checks:** `python3 tools/check_docs.py`; `pytest -q tools/tests`; -`python3 tools/blender_assets.py audit|fit`; Blender headless: -`flatpak run org.blender.Blender --background --python "$PWD/tools/blender_assets.py" -- inspect --category npc --file "$PWD/.glb"`. -This session ran `check_docs` and `git diff --check` after the doc rewrite; Python tests were -last green at 167/167. Godot tests were not rerun because no runtime file changed. - -**Commit:** `2c90743 Rewrite NPC plans around the Quaternius base`. Working tree clean. - ## Current State The playable build covers the three venues, tutorial/campaign/checkpoints, the 0.9.3–0.9.6