# Zyquo Atlas — Phase Plan & Progress ## Pre-Phase-0 — Provider key verification (done 2026-07-30) All 12 provider API keys were verified through Zyquo Cloud's Phase 7 harness — the exact production provider clients Atlas will port. **202/202 tests green** (live `/models` diff, chat completion on every catalog model, streaming, vision). Full table: `../zyquo-cloud/docs/VERIFICATION.md`. Keys live in `zyquo-cloud/.env.keys` (gitignored). Toolchain finding (2026-07-30): the CLT's default `MacOSX.sdk` → macOS 27.0 beta SDK, whose SwiftUI requires the `SwiftUIMacros` compiler plugin that CLT does not ship — every SwiftUI compile fails ("plugin for module 'SwiftUIMacros' not found"). Fix verified on a minimal repro: build with `SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX26.5.sdk`. Atlas's Makefile must pin this SDKROOT for all builds (Phase 1). ## Phase 0 — Research (IN PROGRESS) ### 0.A — docs/AI-BROWSER-RESEARCH.md - [x] Landscape: Arc / Arc Max & Dia, Perplexity Comet, Brave Leo, Edge Copilot, Opera Aria, SigmaOS, Chrome built-in AI - [x] Page content extraction for LLMs (Readability-style, WKWebView JS injection, selection, long pages) - [x] Chunking, context & long pages (map-reduce, refine, relevance selection, citations) - [x] AI surfaces & UX patterns (command bar, sidebar chat, selection actions, writing assist, AI search, tab summarization, agentic actions) - [x] Streaming & responsiveness (per-tab AI, cancel-on-navigation, 60fps) - [x] Multi-tab / multi-page reasoning - [x] Safety/privacy & correctness (consent, indicators, grounding, citation hygiene) - [x] Document written, every later AI feature traceable to it ### 0.B — docs/PROVIDER-REUSE.md - [x] Study Zyquo Cloud provider layer (ProviderProtocol, OpenAICompatibleClient, AnthropicClient, ProviderRegistry, StreamingService) - [x] Document exact API call formats per provider (base URLs, auth, Codable models, SSE handling) - [x] Complete model catalog inventory (ALL Cloud models available in Atlas) - [x] SecureKeyStore AES-256-GCM vault design (no Keychain) + vault format - [x] Provider-specific streaming quirks table - [x] Port plan: which files port verbatim, which need adaptation ### Phase 0 gate - [x] Both documents complete → Phase 0 done, phase summary written here **Phase 0 summary (2026-07-30):** Both research docs complete. `docs/AI-BROWSER-RESEARCH.md` synthesizes the 2026 landscape (Arc/Dia, Comet, Leo, Edge, Opera, SigmaOS, Chrome, ChatGPT Atlas), the Defuddle+Readability extraction pipeline with a 4-tier fallback ladder, the stuff-first long-context calculus (map-reduce only for small models/multi-tab), the full AI-UX surface set with a feature→pattern traceability table, 60fps streaming + cancel-on-navigation, and an injection-safe privacy model. `docs/PROVIDER-REUSE.md` maps Zyquo Cloud's 2-client provider layer, 170-model catalog, and AES-256-GCM vault to a verbatim/adapt port plan (no GeminiClient — Gemini uses the OpenAI-compat endpoint). Key decisions: Atlas is read-oriented (not agentic); BYO-key + all Cloud models is the differentiator; extraction quality is the product. Toolchain pinned to SDK 26.5. **Phase 0 gate PASSED.**