# 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.

# Phase 1 — Project Setup (No Xcode IDE) — COMPLETE

• Package.swift — executable target ZyquoAtlas (Foundation/SwiftUI/WebKit/CryptoKit + swift-markdown), zyquo-verify launcher target, ZyquoAtlasTests (swift-testing)
• Makefile — SDKROOT pinned to MacOSX26.sdk; dev/build/bundle/run/universal/release/icon/verify/test/clean
• scripts/write-info-plist.sh — browser Info.plist: CFBundleURLTypes http/https, NSUserActivityTypeBrowsingWeb, ATS NSAllowsArbitraryLoadsInWebContent (web content only; app API calls stay HTTPS), productivity category
• Resources/ZyquoAtlas.entitlements — Hardened-Runtime-ready draft (network client + allow-jit; finalized Phase 8)
• scripts/test.sh — CLT-only test runner (symlinks Testing.framework)
• @main Main.swift (sync main, --verify hook) + ZyquoAtlasApp.swift (SwiftUI App, NSApplicationDelegate activation) + RootPlaceholderView
• Clean release build (24s, zero warnings), make dev assembles + ad-hoc signs Zyquo Atlas.app, launches and renders a window (verified by screenshot: teal→indigo gradient, "Zyquo Atlas", hidden title bar)
• swift test green (1 suite); header sweep passes on all code files; plutil -lint OK
• README.md build docs

Phase 1 summary (2026-07-30): SPM project builds and launches as Zyquo Atlas.app without Xcode. Toolchain pinned to SDK 26 in the Makefile (SDK 27's SwiftUI macros need Xcode). Browser Info.plist registers http/https URL schemes + browsing-web activity and sets the correct ATS posture (arbitrary loads only inside WKWebView content). @main uses a synchronous entry with a --verify hook so the Phase 7 harness can run headlessly on the ported provider clients. Verify/test targets and a CLT-only test runner are wired. All files carry the mandatory header. Phase 1 gate PASSED (buildable, launchable, single window; browser core is Phase 2).