docs(22-01): complete add-to-collection flow plan

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.planning/phases/22-add-from-catalog-thread-integration/22-01-SUMMARY.md

@@ -0,0 +1,101 @@
+---
+phase: 22-add-from-catalog-thread-integration
+plan: 01
+subsystem: ui
+tags: [react, zustand, sonner, toast, modal, catalog]
+
+requires:
+  - phase: 21-catalog-search-overlay
+    provides: CatalogSearchOverlay component with stub add handler, FAB menu, global item detail page
+provides:
+  - AddToCollectionModal component with category, notes, purchase price fields
+  - UIStore modal states for addToCollectionModal, addToThreadModal, catalogSessionThreadId
+  - Sonner toast system at root layout
+  - Wired add-to-collection flow from catalog search and global item detail page
+  - "Add to Thread" button on global item detail page (modal built in Plan 02)
+affects: [22-02-add-to-thread-modal]
+
+tech-stack:
+  added: [sonner]
+  patterns: [modal-via-uistore, toast-feedback-on-mutation]
+
+key-files:
+  created:
+    - src/client/components/AddToCollectionModal.tsx
+  modified:
+    - src/client/stores/uiStore.ts
+    - src/client/routes/__root.tsx
+    - src/client/components/CatalogSearchOverlay.tsx
+    - src/client/routes/global-items/$globalItemId.tsx
+
+key-decisions:
+  - "Sonner for toast notifications -- lightweight, accessible, matches minimalist design"
+  - "All Phase 22 modal states added in one UIStore extension for Plan 02 readiness"
+
+patterns-established:
+  - "Toast feedback: use toast.success() from sonner after successful mutations"
+  - "Modal dispatch: UIStore openX(globalItemId, globalItemName) pattern for catalog actions"
+
+requirements-completed: [CATFLOW-03]
+
+duration: 7min
+completed: 2026-04-06
+---
+
+# Phase 22 Plan 01: Add-to-Collection Flow Summary
+
+**AddToCollectionModal with category/notes/price fields, sonner toasts, and wired catalog search + detail page entry points**
+
+## Performance
+
+- **Duration:** 7 min
+- **Started:** 2026-04-06T13:49:46Z
+- **Completed:** 2026-04-06T13:57:00Z
+- **Tasks:** 2
+- **Files modified:** 5
+
+## Accomplishments
+- Extended UIStore with addToCollectionModal, addToThreadModal, and catalogSessionThreadId states for full Phase 22 support
+- Built AddToCollectionModal following CreateThreadModal pattern with category dropdown, notes textarea, and purchase price input
+- Installed sonner and rendered Toaster at root layout for success feedback
+- Replaced handleAddStub in CatalogSearchOverlay with mode-aware dispatch to collection or thread modals
+- Added both "Add to Collection" (primary) and "Add to Thread" (secondary) buttons on global item detail page
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: UIStore extension + sonner setup + AddToCollectionModal** - `f309c73` (feat)
+2. **Task 2: Wire CatalogSearchOverlay and global item detail page for collection mode** - `ed76236` (feat)
+
+## Files Created/Modified
+- `src/client/components/AddToCollectionModal.tsx` - Modal with category, notes, purchase price; calls useCreateItem with globalItemId
+- `src/client/stores/uiStore.ts` - Added addToCollectionModal, addToThreadModal, catalogSessionThreadId states
+- `src/client/routes/__root.tsx` - Added Toaster and AddToCollectionModal to root layout
+- `src/client/components/CatalogSearchOverlay.tsx` - Replaced stub with mode-aware handleAdd dispatching to modals
+- `src/client/routes/global-items/$globalItemId.tsx` - Added "Add to Collection" and "Add to Thread" buttons wired to UIStore
+
+## Decisions Made
+- Used sonner for toast notifications (lightweight, accessible, clean styling)
+- Added all Phase 22 UIStore states in Task 1 so Plan 02 can consume addToThreadModal and catalogSessionThreadId immediately
+- closeCatalogSearch now resets catalogSessionThreadId to null for clean session state
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+- Service tests (item.service.test.ts, thread.service.test.ts) hang on execution -- pre-existing issue unrelated to client-side changes. Build verification confirms no type errors or regressions.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+- Plan 02 can immediately build AddToThreadModal consuming addToThreadModal and catalogSessionThreadId from UIStore
+- "Add to Thread" button on detail page already wired to openAddToThread
+- CatalogSearchOverlay already dispatches to openAddToThread in thread mode
+
+---
+*Phase: 22-add-from-catalog-thread-integration*
+*Completed: 2026-04-06*