feat: Add OpenAI API key onboarding and remove unused Assistant feature

BREAKING CHANGES:
- Removed Assistant feature (Whisper-based transcription)
- Removed chat functionality
- Application now focuses exclusively on Realtime Agent

Added:
- User-specific OpenAI API key management
- Onboarding flow for new users to configure API keys
- Settings page for managing API keys
- Secure API key storage (encrypted in database)

Removed:
- Assistant page and all related components
- AudioRecorder component
- AssistantController and AIService
- Whisper transcription endpoints
- Chat functionality
- Assistant-specific database tables (context_snapshots, conversations)

Changes:
- Dashboard now highlights Realtime Agent as the primary feature
- Updated navigation to remove Assistant references
- All OpenAI interactions now use user's personal API key
- Improved security by removing API key from browser in production

Technical details:
- Added migration for openai_api_key and has_completed_onboarding fields
- Created EnsureOnboardingCompleted middleware
- Added OnboardingController for API key setup flow
- Created migration to drop unused Assistant tables
- Cleaned up routes and removed unused endpoints

The application now provides a cleaner, more focused experience centered on the Realtime Agent feature with WebSocket-based voice conversations and real-time sales coaching.

Author: vijaythecoder

CLAUDE.md

@@ -2,6 +2,10 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Project Overview
+
+Clueless is an AI-powered meeting assistant that provides real-time transcription, intelligent analysis, and action item extraction from conversations. It's built as a desktop application using Electron/NativePHP with support for multiple AI providers (OpenAI, Anthropic, Gemini).
+
 ## Tech Stack
 
 - **Backend**: Laravel 12.0 (PHP 8.2+)
@@ -10,7 +14,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - **Build**: Vite 6
 - **Desktop**: NativePHP/Electron
 - **Testing**: Pest PHP
-- **Database**: SQLite (default)
+- **Database**: SQLite (dual database setup)
+- **Real-time**: OpenAI Realtime API, WebSockets
+- **AI Integration**: OpenAI PHP, multiple provider support
 
 ## Development Commands
 
@@ -69,22 +75,33 @@ php artisan test tests/Feature/DashboardTest.php
 
 # Run tests with coverage (if configured)
 php artisan test --coverage
+
+# Run tests in parallel
+php artisan test --parallel
+
+# Run only unit tests
+php artisan test --testsuite=Unit
+
+# Run only feature tests
+php artisan test --testsuite=Feature
 ```
 
 ## Project Architecture
 
 ### Directory Structure
 
 - `/app/` - Laravel backend logic
-  - `/Http/Controllers/` - Request handlers (Auth, Settings)
-  - `/Models/` - Eloquent models
+  - `/Http/Controllers/` - Request handlers (Auth, Conversations, Realtime, Settings)
+  - `/Models/` - Eloquent models (User, Conversation, Transcript, etc.)
+  - `/Services/` - Business logic (AIService, RealtimeRelayService, TranscriptionService)
   - `/Providers/` - Service providers
 - `/resources/js/` - Vue frontend application
   - `/components/` - Reusable Vue components
-  - `/components/ui/` - UI component library (shadcn/ui-inspired)
+  - `/components/ui/` - UI component library (Reka UI based, shadcn/ui-inspired)
   - `/pages/` - Inertia.js page components
-  - `/layouts/` - Layout components
-  - `/composables/` - Vue composables (e.g., useAppearance)
+  - `/layouts/` - Layout components (App, Auth, Settings)
+  - `/composables/` - Vue composables (useAppearance, useRealtime, etc.)
+  - `/services/` - Frontend services (audioCaptureService, realtimeClient)
   - `/types/` - TypeScript type definitions
 - `/routes/` - Application routing (web.php)
 - `/database/` - Migrations, factories, seeders
@@ -97,6 +114,8 @@ php artisan test --coverage
 3. **TypeScript**: Strict mode enabled, with path alias `@/` for `/resources/js/`
 4. **Authentication**: Built-in Laravel auth with custom Vue components
 5. **Theme Support**: Dark/light mode via `useAppearance` composable
+6. **Real-time Features**: WebSocket connections for live transcription using OpenAI Realtime API
+7. **Service Architecture**: Core business logic separated into service classes (AIService, TranscriptionService, etc.)
 
 ### Important Files
 
@@ -167,9 +186,34 @@ Example usage:
 - For Laravel docs: Use Context7 to get the latest Laravel 12 documentation
 - For any other library: First use `mcp__context7__resolve-library-id` to find the library
 
+## Working with Real-time Features
+
+The application uses OpenAI's Realtime API for live transcription:
+- Frontend audio capture: `/resources/js/services/audioCaptureService.ts`
+- WebSocket client: `/resources/js/services/realtimeClient.ts`
+- Backend relay service: `/app/Services/RealtimeRelayService.php`
+- Controllers: `/app/Http/Controllers/RealtimeController.php`
+
+## AI Provider Integration
+
+Multiple AI providers are supported through environment configuration:
+- OpenAI (GPT-4, Realtime API)
+- Anthropic (Claude)
+- Google (Gemini)
+- Configuration: Update `.env` with appropriate API keys
+
+## License & Usage
+
+This project uses MIT License with Commons Clause:
+- ✅ Free for personal and internal business use
+- ❌ Commercial use (SaaS, resale) requires commercial agreement
+- See `COMMONS_CLAUSE.md` for details
+
 ## Notes
 
 - ESLint ignores `/resources/js/components/ui/*` (third-party UI components)
 - Prettier formats all files in `/resources/` directory
 - NativePHP allows running as desktop application
-- Concurrently runs multiple processes in development (server, queue, logs, vite)
+- Concurrently runs multiple processes in development (server, queue, logs, vite)
+- Built primarily for macOS desktop usage
+- Uses Pusher for additional real-time features

app/Console/Commands/NativeConfigCommand.php

@@ -27,6 +27,7 @@ public function handle()
     {
         // Return empty JSON to satisfy NativePHP expectations
         echo json_encode([]);
+
         return 0;
     }
-}
+}

app/Console/Commands/NativePhpIniCommand.php

@@ -32,6 +32,7 @@ public function handle()
             'post_max_size' => '50M',
         ];
         echo json_encode($settings);
+
         return 0;
     }
-}
+}