97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
|
# Alfred Mobile - Development Progress
|
||
|
|
|
||
|
|
## ✅ Phase 1: Project Setup & Build (COMPLETE)
|
||
|
|
- [x] Android project scaffolding (Jetpack Compose, Material 3, Hilt DI)
|
||
|
|
- [x] Build system configuration (Gradle 8.2, API 26-34, Java 17)
|
||
|
|
- [x] Wireless ADB deployment to tablet
|
||
|
|
- [x] Basic UI placeholder to verify app stability
|
||
|
|
- [x] Gitea repository setup
|
||
|
|
|
||
|
|
## ✅ Phase 2: OAuth Authentication (COMPLETE)
|
||
|
|
- [x] OAuth configuration with Authentik
|
||
|
|
- [x] AppAuth integration for OAuth 2.0 flow
|
||
|
|
- [x] OAuthConfig - Endpoints and configuration
|
||
|
|
- [x] AuthManager - OAuth flow orchestration
|
||
|
|
- [x] OAuthCallbackActivity - Handle redirect URI
|
||
|
|
- [x] LoginScreen UI - Clean Material 3 login interface
|
||
|
|
- [x] MainScreen UI - Post-login placeholder
|
||
|
|
- [x] Token storage (SharedPreferences)
|
||
|
|
- [x] State management (mutableState in MainActivity)
|
||
|
|
- [x] **Critical Bug Fix:** Token expiry validation (5min → 1min buffer)
|
||
|
|
- [x] End-to-end OAuth flow working
|
||
|
|
|
||
|
|
**OAuth Flow:**
|
||
|
|
1. User taps "Sign In with Authentik" → Browser opens
|
||
|
|
2. User authenticates → Browser redirects to `alfredmobile://oauth/callback`
|
||
|
|
3. App receives callback → Parses code & state
|
||
|
|
4. App exchanges code for tokens → Stores access token
|
||
|
|
5. UI updates → Shows "Logged In!" screen
|
||
|
|
|
||
|
|
**Key Learnings:**
|
||
|
|
- AppAuth `fromIntent()` doesn't work with browser redirects (requires manual parsing)
|
||
|
|
- Authentik issues 5-minute tokens (buffer must be <5 minutes)
|
||
|
|
- `mutableStateOf` needs to be class-level to persist across recomposition
|
||
|
|
|
||
|
|
## 🚧 Phase 3: WebSocket Connection (NEXT)
|
||
|
|
- [ ] WebSocket client implementation (OkHttp)
|
||
|
|
- [ ] OpenClaw protocol integration
|
||
|
|
- [ ] Message serialization/deserialization
|
||
|
|
- [ ] Connection state management
|
||
|
|
- [ ] Auto-reconnect logic
|
||
|
|
- [ ] Token-based authentication (pass OAuth token)
|
||
|
|
- [ ] Basic chat UI for testing
|
||
|
|
|
||
|
|
**WebSocket Endpoint:** `wss://alfred-app.dnspegasus.net`
|
||
|
|
**Authentication:** OAuth token from Phase 2
|
||
|
|
|
||
|
|
## 📋 Phase 4: Chat Interface (PLANNED)
|
||
|
|
- [ ] Message list (LazyColumn)
|
||
|
|
- [ ] Input field with send button
|
||
|
|
- [ ] Message bubbles (user vs Alfred)
|
||
|
|
- [ ] Typing indicators
|
||
|
|
- [ ] Error handling & retry
|
||
|
|
- [ ] Offline message queue
|
||
|
|
|
||
|
|
## 📋 Phase 5: Voice Features (PLANNED)
|
||
|
|
- [ ] Wake word detection (Porcupine SDK)
|
||
|
|
- [ ] Voice input (Android SpeechRecognizer)
|
||
|
|
- [ ] Voice output (Android TTS or ElevenLabs)
|
||
|
|
- [ ] Push-to-talk vs always-listening modes
|
||
|
|
- [ ] Voice activity UI indicators
|
||
|
|
|
||
|
|
## 📋 Phase 6: Polish & Features (PLANNED)
|
||
|
|
- [ ] Proper launcher icon (replace placeholder)
|
||
|
|
- [ ] Splash screen
|
||
|
|
- [ ] Settings screen
|
||
|
|
- [ ] Notification support
|
||
|
|
- [ ] Background service for wake word
|
||
|
|
- [ ] Dark/light theme toggle
|
||
|
|
- [ ] Release build configuration
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Current Status
|
||
|
|
**Last Updated:** February 2, 2026 08:29 PST
|
||
|
|
**Phase:** OAuth Complete ✅ → Starting WebSocket 🚀
|
||
|
|
**Build:** Debug APK installed on tablet
|
||
|
|
**Login:** Fully functional OAuth flow with Authentik
|
||
|
|
|
||
|
|
## Technical Stack
|
||
|
|
- **Language:** Kotlin
|
||
|
|
- **UI:** Jetpack Compose + Material 3
|
||
|
|
- **DI:** Hilt
|
||
|
|
- **Networking:** Retrofit (HTTP), OkHttp (WebSocket)
|
||
|
|
- **OAuth:** AppAuth library
|
||
|
|
- **Database:** Room (for future message persistence)
|
||
|
|
- **Authentication:** Authentik OAuth 2.0
|
||
|
|
- **Gateway:** OpenClaw at alfred-app.dnspegasus.net
|
||
|
|
|
||
|
|
## Repository
|
||
|
|
- **Location:** https://repo.anhonesthost.net/jknapp/alfred-mobile
|
||
|
|
- **Branch:** main
|
||
|
|
- **Commits:** 6 (as of Phase 2 completion)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Next Session:** Implement WebSocket client and establish connection to Alfred gateway! 🚀
|