| |
1 | +<!-- |
| |
2 | + PLAN.md |
| |
3 | + Zyquo Atlas |
| |
4 | + Author: Simon-Pierre Boucher |
| |
5 | + Mail: contact@spboucher.ai |
| |
6 | +--> |
| |
7 | + |
| |
8 | +# Zyquo Atlas — Phase Plan & Progress |
| |
9 | + |
| |
10 | +## Pre-Phase-0 — Provider key verification (done 2026-07-30) |
| |
11 | + |
| |
12 | +All 12 provider API keys were verified through Zyquo Cloud's Phase 7 harness — the exact |
| |
13 | +production provider clients Atlas will port. **202/202 tests green** (live `/models` diff, |
| |
14 | +chat completion on every catalog model, streaming, vision). Full table: |
| |
15 | +`../zyquo-cloud/docs/VERIFICATION.md`. Keys live in `zyquo-cloud/.env.keys` (gitignored). |
| |
16 | +Toolchain finding (2026-07-30): the CLT's default `MacOSX.sdk` → macOS 27.0 beta SDK, whose |
| |
17 | +SwiftUI requires the `SwiftUIMacros` compiler plugin that CLT does not ship — every SwiftUI |
| |
18 | +compile fails ("plugin for module 'SwiftUIMacros' not found"). Fix verified on a minimal repro: |
| |
19 | +build with `SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX26.5.sdk`. Atlas's Makefile |
| |
20 | +must pin this SDKROOT for all builds (Phase 1). |
| |
21 | + |
| |
22 | +## Phase 0 — Research (IN PROGRESS) |
| |
23 | + |
| |
24 | +### 0.A — docs/AI-BROWSER-RESEARCH.md |
| |
25 | +- [ ] Landscape: Arc / Arc Max & Dia, Perplexity Comet, Brave Leo, Edge Copilot, Opera Aria, SigmaOS, Chrome built-in AI |
| |
26 | +- [ ] Page content extraction for LLMs (Readability-style, WKWebView JS injection, selection, long pages) |
| |
27 | +- [ ] Chunking, context & long pages (map-reduce, refine, relevance selection, citations) |
| |
28 | +- [ ] AI surfaces & UX patterns (command bar, sidebar chat, selection actions, writing assist, AI search, tab summarization, agentic actions) |
| |
29 | +- [ ] Streaming & responsiveness (per-tab AI, cancel-on-navigation, 60fps) |
| |
30 | +- [ ] Multi-tab / multi-page reasoning |
| |
31 | +- [ ] Safety/privacy & correctness (consent, indicators, grounding, citation hygiene) |
| |
32 | +- [ ] Document written, every later AI feature traceable to it |
| |
33 | + |
| |
34 | +### 0.B — docs/PROVIDER-REUSE.md |
| |
35 | +- [ ] Study Zyquo Cloud provider layer (ProviderProtocol, OpenAICompatibleClient, AnthropicClient, ProviderRegistry, StreamingService) |
| |
36 | +- [ ] Document exact API call formats per provider (base URLs, auth, Codable models, SSE handling) |
| |
37 | +- [ ] Complete model catalog inventory (ALL Cloud models available in Atlas) |
| |
38 | +- [ ] SecureKeyStore AES-256-GCM vault design (no Keychain) + vault format |
| |
39 | +- [ ] Provider-specific streaming quirks table |
| |
40 | +- [ ] Port plan: which files port verbatim, which need adaptation |
| |
41 | + |
| |
42 | +### Phase 0 gate |
| |
43 | +- [ ] Both documents complete → Phase 0 done, phase summary written here |
| |
44 | |