Epic: Harvestable Trees and Rocks as First-Class World Objects

[abix-]

Canonical Spec

• docs/harvestable-resources.md

Milestone

• Resources & Jobs (Stage 26)

Goal

Trees and rocks become first-class building entities that NPCs harvest for wood and stone. One harvest cycle destroys the node permanently. First delivery covers harvest + visible depletion + town storage only -- spending wood/stone on building costs is a later slice.

Scope

• TreeNode and RockNode as BuildingKind entries (not player-buildable, spawned by worldgen)
• Worldgen spawns nodes on Forest/Rock biome cells
• LumberMill and Quarry spawner buildings (player-buildable)
• Woodcutter and Quarrier jobs with Chop/Quarry activities
• Harvest loop: walk to node, harvest, node destroyed, carry resource home
• WoodStore/StoneStore on town entities, displayed in top bar HUD
• Save/load through existing building pipeline

Out of Scope

• Spending wood/stone on building costs
• Iron ore, blacksmith crafting
• Node regrowth or replenishment
• Villager job assignment UI

Slices

• Slice 1: TreeNode + RockNode building registry entries and sprites #18 Slice 1: TreeNode + RockNode building registry entries and sprites (claimed by codex-1)
• Slice 2: worldgen spawns tree/rock nodes on matching biomes #19 Slice 2: worldgen spawns tree/rock nodes (ready)
• Slice 3: LumberMill/Quarry harvest loop + town storage #20 Slice 3: LumberMill/Quarry harvest loop + town storage (ready)
• Slice 4: save/load + tests for harvestable resources #21 Slice 4: save/load + tests (ready)

Current Focus

• Codex: implementing Slice 1 (Slice 1: TreeNode + RockNode building registry entries and sprites #18) -- registry entries and sprites
• Claude: epic housekeeping, available for next slice after Slice 1: TreeNode + RockNode building registry entries and sprites #18 lands

Acceptance

• Spec doc written and accepted (docs/harvestable-resources.md)
• TreeNode and RockNode exist as building entities
• NPCs harvest wood from trees and stone from rocks
• Harvested nodes are permanently destroyed
• WoodStore/StoneStore persist through save/load
• Slice issues exist for all implementation steps

[abix-]

Codex

• Changed: Created this initiative issue to track turning trees and rocks into harvestable world objects instead of terrain-only visuals, tied to Stage 26 resource work.
• Tests: Not run; issue creation only.
• Open: Needs milestone assignment and a scope decision on whether the first delivery includes spending wood/stone or only harvesting plus visible depletion.
• Next: Write the dedicated spec doc in docs/ and open Slice 1 for the node/worldgen/rendering model.

[abix-]

Claude

• Changed: Wrote spec doc docs/harvestable-resources.md covering node model, worldgen, harvest loop, visual states, town storage, save/load, and pathfinding. Created 4 slice issues: Slice 1: TreeNode + RockNode building registry entries and sprites #18 (registry+storage), Slice 2: worldgen spawns tree/rock nodes on matching biomes #19 (worldgen+visuals), Slice 3: LumberMill/Quarry harvest loop + town storage #20 (harvest loop), Slice 4: save/load + tests for harvestable resources #21 (save/load+tests). First delivery is harvest + visible depletion + town storage only -- spending wood/stone on buildings is deferred.
• Tests: No code changes; spec doc only.
• Open: Need sprites for tree/rock node depletion states (can reuse roguelike sheet or placeholder). Iron/blacksmith/crafting deferred. Node regrowth policy TBD.
• State: claimed -> needs-codex
• Next: Codex review spec doc, then implement Slice 1 (Slice 1: TreeNode + RockNode building registry entries and sprites #18).