Clean stale tuft density comment

This commit is contained in:
2026-08-03 14:20:18 +08:00
parent a6be274ced
commit f569d45e74
7 changed files with 88 additions and 5 deletions

View File

@@ -0,0 +1,2 @@
{"file": ".trellis/spec/blender/index.md", "reason": "Check the generate_scene.py edit remains within Blender layer constraints."}
{"file": ".trellis/spec/guides/artifact-parity-guide.md", "reason": "Verify D3 is removed only after the stale comment is corrected."}

View File

@@ -0,0 +1,2 @@
{"file": ".trellis/spec/blender/index.md", "reason": "Blender layer constraints and validation expectations for generate_scene.py changes."}
{"file": ".trellis/spec/guides/artifact-parity-guide.md", "reason": "Contains the D3 known-defect entry and parity guidance for comment-only changes."}

View File

@@ -0,0 +1,51 @@
# Clean stale tuft density comment
## Goal
Clean up the documented D3 comment debt around `tuft_density_wave()` so the
code and Trellis specs no longer reference a deleted hedge-banding comparison.
This is a documentation/comment correction only. It should not change Blender
scene generation behavior or generated artifacts.
## Background
- `.trellis/spec/guides/artifact-parity-guide.md` records D3:
`generate_scene.py` `tuft_density_wave` has a stale comment comparing lawn
tuft density with deleted hedge banding.
- `blender/generate_scene.py:354` defines `tuft_density_wave(x, y)`.
- The current function body is still valid deterministic scatter logic; only
the explanatory comment is stale.
## Requirements
1. Update the comment above `tuft_density_wave()` to describe the current lawn
tuft spacing intent without referencing removed hedge banding behavior.
2. Remove or update the D3 entry in
`.trellis/spec/guides/artifact-parity-guide.md` so it no longer lists this
as an outstanding known defect after the code comment is corrected.
3. Do not change `tuft_density_wave()` math, tuft sampling thresholds, grass
material behavior, object names, counts, or scene output.
4. Do not change D1 or D2.
5. Do not change parity ignore lists.
## Acceptance Criteria
- [ ] `blender/generate_scene.py` no longer has a stale hedge-banding
comparison near `tuft_density_wave()`.
- [ ] `.trellis/spec/guides/artifact-parity-guide.md` no longer records D3 as
outstanding.
- [ ] `python3 -m py_compile blender/generate_scene.py` passes.
- [ ] `python3 -m unittest blender/tests/test_pure.py` passes.
- [ ] `git diff` shows no change to `tuft_density_wave()` executable code.
## Out Of Scope
- Any Blender/Cesium artifact-changing behavior.
- Full parity capture, because the task is comment/spec-only and acceptance
explicitly verifies no executable code changed.
- D1 / D2 cleanup.
## Open Questions
None.

View File

@@ -0,0 +1,26 @@
{
"id": "clean-tuft-density-comment",
"name": "clean-tuft-density-comment",
"title": "Clean stale tuft density comment",
"description": "",
"status": "in_progress",
"dev_type": null,
"scope": null,
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-08-03",
"completedAt": null,
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [],
"notes": "",
"meta": {}
}