| name | box-map |
| description | Manage box maps — track which items are in which physical boxes (or rooms / shelves / storage units) so the user can find things without opening every box. Reads/writes the box and location fields on items in inventory/master.json and produces a per-box manifest, plus a reverse "where is X" lookup. |
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.
