# Tasks: 001-pantry-meal-planner

*Created: 2026-08-18*

Dependency-ordered, checkable work items derived from the spec and plan.
Work top to bottom; a phase starts only when the one before it is done.

## Phases

### Setup

- [x] T1: Scaffold pantry_planner/ package with pytest harness and empty modules per plan Structure
- [x] T2: Define PantryItem/Recipe dataclasses in pantry_planner/planner.py and JSON load/save for pantry.json + recipes.json (Story 1 entities)

### Implementation

- [x] T3: Story 1 — pantry CRUD in planner.py + `pantry add/remove/list` in cli.py, test-first (acceptance: add 500 g rice + 2 cans tomatoes, list shows both)
- [ ] T4: Story 2 — 7-day plan generation with stock simulation in planner.py (test: no ingredient over-consumed across the week, R2/S2)
- [ ] T5: Story 3 — shopping list derivation (plan needs − stock, clamp 0) + `shoplist` command (acceptance: 3 onions needed, 1 in stock → "2 onions")

### Polish

- [ ] T6: Bundle 10-recipe starter set (R4), README for the example, full test run