box-map

Box map

When to invoke

The user is packing, unpacking, sorting through storage, or asks "what's in box 3" / "where did I put the X". Also useful as a final step after a decluttering pass — once items are sorted into "keep / sell / donate / discard" piles, label boxes and persist the mapping.

Modes

1. Build mode — pack items into boxes

Walk the user through assigning items to boxes:

• Ask for a box label (e.g. BOX-12, kitchen-overflow-A, parents-garage-3).
• The user names items as they pack; for each, look up or create the item in inventory/master.json and set box = <label> and location = <room/site>.
• Optionally accept a photo of the box's contents — Read it, extract items via OCR, batch-assign.

2. Lookup mode — "where is X"

Given an item name (or fuzzy match), find all items matching and print their box and location. If multiple matches, list each.

3. Manifest mode — print what's in a box

Given a box label, print all items assigned to it. Write a per-box manifest at <workspace>/box-maps/<box-label>.md with columns: name, qty, condition, est_value, notes.

4. Reorganize mode

Suggest box reorganizations — boxes with mixed unrelated categories, boxes that are over-full, or items that should travel with related items (e.g. a charger that's in a different box from the device).

Output

• Updated box / location fields in inventory/master.json.
• Per-box manifest files in <workspace>/box-maps/.
• Optional master index at <workspace>/box-maps/_index.md listing every box with a one-line summary.

Offer to render any manifest or the full index as PDF labels via generate-action-list (mode = box labels) — useful for printing and taping to the actual box.