Compact MEMORY.md: drop the redundant session handoff, trim the AI-review entry

This commit is contained in:
zwitschi committed 2026-11-05 20:38:26 +01:00
1 parent deb74c53af
commit 1049d8631e
1 file changed
+3 -53
+3 -53
View File
@@ -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/<file>.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