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