Phase 5: event-sourced inventory ledger model
inventory.py — shop-wide, append-only event log; current state derived by
folding (Codex's recommendation). Lean and plumbing-only.
- Events: purchase / consume / create_offcut / discard / adjustment /
build_recorded. Ledger.load/save to $XDG_DATA_HOME/woodshop/inventory.json.
- Primitives: purchase, adjust, consume_offcut, discard_offcut, record_build
(deducts consumed stock, keeps/discards each produced offcut).
- Derived: on_hand(), offcut_bin(), available_stock() (one Piece shape for full
stock + offcuts — the AvailableStock interface), builds(), stats() (spent,
units built, offcuts kept/burned/trashed, per-project units).
- plan_consumption(plan): derive consumed stock + reusable offcuts from a CutPlan.
- tests: purchase/consume, adjustment, keep/discard offcuts, consume removes
from bin, plan_consumption, available_stock, save/load, cross-project stats.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
rob
30a10adabc