Compact MEMORY.md: drop the redundant session handoff, trim the AI-review entry
This commit is contained in:
1 parent
deb74c53af
commit
1049d8631e
1 file changed
+3
-53
@@ -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
|
||||
|
||||
Reference in new issue
Block a user