feat: Add quick occasion-based outfit generation

[IvanM9]

Summary

This PR implements a new quick outfit generation feature that allows users to generate complete outfits by simply providing an occasion (e.g., "casual Friday at work", "wedding reception"). This simplifies the existing category-based generation flow by eliminating manual base item and category selection.

Features Implemented

User Story 1: Quick Outfit Generation from Occasion (MVP)

• ✅ New endpoint: POST /api/combinations/generate-quick
• ✅ AI analyzes entire wardrobe and selects 3-10 appropriate items
• ✅ Minimum wardrobe validation (5 items required)
• ✅ Automatic retry logic with 2-second delay
• ✅ Comprehensive error handling with specific error codes

User Story 2: Save and Manage Quick-Generated Outfits

• ✅ Generated outfits can be saved with isAIGenerated: true flag
• ✅ Occasions array stored with each combination
• ✅ Proper metadata tracking for AI-generated outfits

User Story 3: Regenerate Alternative Outfits

• ✅ Session management using Keyv cache (in-memory + Redis)
• ✅ Request alternatives with requestAlternative: true
• ✅ Previously shown items excluded from subsequent generations
• ✅ Sessions automatically cleared when outfits are saved

Technical Details

Files Modified

• src/modules/wardrobe/dtos/combinations.dto.ts - Added QuickGenerateCombinationDto
• src/modules/wardrobe/interfaces/combinations.interface.ts - Added QuickGenerationResponse and GenerationSession
• src/modules/wardrobe/prompts/combinations.prompts.ts - Added generateQuickCombinationsPrompt()
• src/modules/wardrobe/services/combinations.service.ts - Core implementation with helpers and session management
• src/modules/wardrobe/controllers/combinations/combinations.controller.ts - New generate-quick endpoint

Key Implementation Highlights

• No database migrations required (existing schema supports all features)
• Leverages existing AI service abstraction (Google/OpenAI/Ollama/LMStudio)
• Uses existing two-tier cache system (Keyv with in-memory + Redis)
• Full TypeScript type safety
• Follows NestJS and project architectural patterns

API Usage

Generate First Outfit

POST /api/combinations/generate-quick
{
  "occasion": "casual Friday at work",
  "requestAlternative": false
}

Request Alternative

POST /api/combinations/generate-quick
{
  "occasion": "casual Friday at work",
  "requestAlternative": true
}

Testing

• ✅ TypeScript compilation successful
• ✅ Swagger documentation generated
• ✅ Rate limiting applies (existing guards)
• ⏳ Manual testing with running server pending

Related Documentation

• Feature specification: specs/001-quick-outfit-generation/spec.md
• Implementation plan: specs/001-quick-outfit-generation/plan.md
• Task breakdown: specs/001-quick-outfit-generation/tasks.md
• API contract: specs/001-quick-outfit-generation/contracts/quick-generate-endpoint.yaml

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com