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
- Landscape: Arc / Arc Max & Dia, Perplexity Comet, Brave Leo, Edge Copilot, Opera Aria, SigmaOS, Chrome built-in AI
- Page content extraction for LLMs (Readability-style, WKWebView JS injection, selection, long pages)
- Chunking, context & long pages (map-reduce, refine, relevance selection, citations)
- AI surfaces & UX patterns (command bar, sidebar chat, selection actions, writing assist, AI search, tab summarization, agentic actions)
- Streaming & responsiveness (per-tab AI, cancel-on-navigation, 60fps)
- Multi-tab / multi-page reasoning
- Safety/privacy & correctness (consent, indicators, grounding, citation hygiene)
- Document written, every later AI feature traceable to it
0.B — docs/PROVIDER-REUSE.md
- Study Zyquo Cloud provider layer (ProviderProtocol, OpenAICompatibleClient, AnthropicClient, ProviderRegistry, StreamingService)
- Document exact API call formats per provider (base URLs, auth, Codable models, SSE handling)
- Complete model catalog inventory (ALL Cloud models available in Atlas)
- SecureKeyStore AES-256-GCM vault design (no Keychain) + vault format
- Provider-specific streaming quirks table
- Port plan: which files port verbatim, which need adaptation
Phase 0 gate
- 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.