323 lines
7.7 KiB
Markdown
323 lines
7.7 KiB
Markdown
# Journal - dingkang (Part 1)
|
|
|
|
> AI development session journal
|
|
> Started: 2026-08-03
|
|
|
|
---
|
|
|
|
|
|
|
|
## Session 1: Initialize Trellis project guidelines
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Initialize Trellis project guidelines
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Initialized Trellis project scaffolding and replaced the incorrect frontend spec templates with project-specific pipeline, Blender, preview, config, and cross-layer guidance. Verified spec layers, placeholder cleanup, key-contract coverage, and Blender pure Python tests.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `4c5981c` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 2: Refactor Cesium material export contract
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Refactor Cesium material export contract
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Moved Cesium material export overrides into catalog-backed material contracts saved as Blender material custom properties. Kept legacy name-table fallback for old .blend files, updated Blender/spec guidance, and verified with unit tests, py_compile, diff check, and parity before/after comparison showing only expected cesium_export blend property diffs.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `0635c09` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 3: Archive osmassets refactor plan
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Archive osmassets refactor plan
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Moved durable conclusions from the temporary osmassets refactor plan into changelog and Trellis specs, removed docs/refactor-plan.md, and verified no live docs/spec references to the deleted plan remain.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `6882921` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 4: Extract fountain module
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Extract fountain module
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Moved fountain assembly from generate_scene.py into blender/osmassets/fountain.py, updated P2 refactor docs, and verified py_compile, 51 pure tests, and Blender/Cesium parity before/after with identical snapshots.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `6271055` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 5: Extract building module
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Extract building module
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Moved building assembly from generate_scene.py into blender/osmassets/building.py, updated P2 refactor docs so only roads remains in generate_scene.py, and verified py_compile, 51 pure tests, and Blender/Cesium parity before/after with identical snapshots.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `032922a` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 6: Extract road assembly module
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Extract road assembly module
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Moved Blender road GeoJSON assembly and OSM fallback roads into blender/osmassets/roads.py while preserving road_counts, Layer catalog warnings, scene metadata, and SCENE_DONE output. Verified py_compile, unittest, task validation, and Blender/Cesium parity before/after as identical for both sample areas.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `0f3c1ee` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 7: Add feature registry dispatch
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Add feature registry dispatch
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Introduced blender/osmassets/features.py with FeatureHandler and dispatch_ways for ordered OSM way feature dispatch. Converted generate_scene.py water/grass/scrub/tree_row/building branches into registry handlers while keeping material order, counts, road warning behavior, scene metadata, and SCENE_DONE unchanged. Verified py_compile, unittest, task validation, and Blender/Cesium parity before/after as identical for both sample areas.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `ff18217` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 8: Clean stale tuft density comment
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Clean stale tuft density comment
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Cleared stale D3 tuft_density_wave comment debt and updated parity guide known-defect records without changing executable scene generation logic. Verified py_compile, 51 pure tests, and task validation.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `f569d45` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 9: Improve Cesium cruise smoothness
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Improve Cesium cruise smoothness
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Reduced Cesium preview cruise stutter by lowering dense scrub bush nodes in nantaizi from 707 to 266, preserving scrub ground cover, and trimming preview route/follow hot-path overhead without lowering default visual clarity. Verified nantaizi blender/cesium/preview rebuild, node --check, py_compile, 51 pure tests, and task validation.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `0d2dc22` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 10: Reject low-poly scrub bush experiment
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Reject low-poly scrub bush experiment
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Tested user-supplied assets/models/custom/bush_low/bush_low.glb for nantaizi scrub edge bushes. Geometry dropped from 63,762 verts / 67,536 indices to 4,044 / 4,050 and GLB size dropped from 31.96 MB to 27.51 MB with 266 scrub bush nodes unchanged, but user validation found the visual effect unsatisfactory. Restored generate_scene.py to the original default bush asset, archived the task, and recorded the rejected experiment in changelog/spec without adding bush_low to git.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `e58a928` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 11: Adopt Shapespark vegetation
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Adopt Shapespark vegetation
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Adopted split Shapespark low-poly plants for nantaizi trees, scrub bushes, and lawn tufts; toned Cesium foliage export, removed retired vegetation assets/loaders, validated nantaizi blender/cesium/preview.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `dbb5705` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 12: Optional GLB compression stage
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Optional GLB compression stage
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Added an explicit compress stage and GLB compression script for nantaizi WebP review artifacts without replacing the baseline GLB.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `7ba8594` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 13: Fix OSM multipolygon buildings
|
|
|
|
**Date**: 2026-08-03
|
|
**Task**: Fix OSM multipolygon buildings
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Parsed building multipolygon relations, generated building holes, and respected explicit OSM height for nantaizi relation -65.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `95f8458` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 14: Add area diagnostics command
|
|
|
|
**Date**: 2026-08-04
|
|
**Task**: Add area diagnostics command
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Added a fast diagnose:area command for OSM structure, building relation health, artifact status, and GLB digest checks; shared area config normalization between build and diagnostics.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `d4c3baf` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|
|
|
|
|
|
## Session 15: Add GLB stage manifests
|
|
|
|
**Date**: 2026-08-04
|
|
**Task**: Add GLB stage manifests
|
|
**Branch**: `main`
|
|
|
|
### Summary
|
|
|
|
Added first-version cesium and compress stage manifests under _pipeline/stages, shared manifest helpers, and diagnose:area reporting for missing/stale manifests.
|
|
|
|
### Git Commits
|
|
|
|
| Hash | Message |
|
|
|------|---------|
|
|
| `2832383` | (see git log) |
|
|
|
|
### Status
|
|
|
|
[OK] **Completed**
|