v0.18.0 End-to-End Test Documentation & UX Review

[kovtcharov]

Summary

Before shipping v0.17.0, validate the full end-to-end experience across all supported platforms and document the testing approach. Identify and file friction points as follow-up issues.

Test Matrix

Platform Testing

Platform	Installer	Agent UI	Initialization	Chat	File System	Docs Q&A
Windows 11
macOS (ARM)
macOS (Intel)
Ubuntu 22.04

Hardware Profile Testing

Profile	Detection	Model Download	Capability Set	Performance
Strix Point 16GB
Strix Halo

User Flow Testing

• Fresh install → first launch → initialization → first chat
• Document upload → Q&A → follow-up questions
• File system navigation → file reading → bookmarking
• Web browsing → content extraction → analysis
• Onboarding interview → MCP server installation
• App restart → session persistence → resume chat

UX Review Checklist

• Time from download to first successful chat < 10 minutes
• No error messages without actionable guidance
• All loading states have progress indicators
• Keyboard navigation works throughout
• Screen reader compatibility (basic)
• Error recovery paths tested (network failure, disk full, model corrupt)

Acceptance Criteria

• End-to-end install flow tested on all supported platforms
• Initialization flow tested on both hardware profiles
• Onboarding interview tested with varied app configurations
• Test cases documented in tests/ or docs/
• UX review completed; friction points identified and filed as follow-up issues
• Known gaps or deferred items logged