2d71bf38c8
Triage unter Xcode 26.3: macOS + iOS-Device/Archive bauen sauber, das MLX-Macro wird fürs Host-Target gebaut. TestFlight ist nicht blockiert. Nur der iOS-Simulator-Build bricht (arm64 Host/Sim-Arch-Kollision) — betrifft nur den lokalen Dev-Loop, kein Dep-Pin nötig. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
159 lines
8.6 KiB
Markdown
159 lines
8.6 KiB
Markdown
# pageta-native — Status
|
||
|
||
Letzter Stand: **2026-05-29**.
|
||
|
||
> **2026-05-29 — Release-Härtung + iOS-Build-Triage:**
|
||
> Build-Stand unter Xcode 26.3 verifiziert (sauberes DerivedData):
|
||
> - **macOS:** ✅ `BUILD SUCCEEDED`, reproduzierbar.
|
||
> - **iOS Device / Archive** (`generic/platform=iOS`): ✅ `BUILD
|
||
> SUCCEEDED`. Das Macro-Plugin `MLXHuggingFaceMacros` (transitiv via
|
||
> `ManaLLM` → `mlx-swift-lm`) wird hier korrekt fürs **Host-Target**
|
||
> (`arm64-apple-macos`) gebaut. **TestFlight ist nicht blockiert** —
|
||
> Archives bauen fürs Device.
|
||
> - **iOS Simulator:** ❌ „malformed response" beim Laden von
|
||
> `MLXHuggingFaceMacros` (`GemmaBackend.swift:127`). Ursache ist eine
|
||
> **simulator-spezifische** Arch-Kollision auf Apple Silicon: Host
|
||
> (arm64 macOS) und Simulator (arm64 iOS-Sim) haben dieselbe Arch,
|
||
> der Plugin-Loader greift die Simulator-Binary. Betrifft **nur den
|
||
> lokalen Sim-Dev-Loop**, nicht Device/Archive/Release. Workaround
|
||
> bis upstream-Fix: auf Device/„My Mac"-Destination entwickeln.
|
||
>
|
||
> Die ältere Behauptung „iOS-Sim grün, 38/38 Tests" (2026-05-25) galt
|
||
> für die damalige Toolchain; mit Xcode 26.3 ist der Sim-Pfad gebrochen.
|
||
> `mlx-swift-lm @ branch:main` bleibt konventionsgemäß (dokumentiert in
|
||
> `mana-swift-llm/CLAUDE.md`); kein Pin nötig, da Release-Pfad grün.
|
||
>
|
||
> **Fertig:** Die im 2026-05-25-Eintrag als offen notierten Write-Pfade
|
||
> im Markierungen-Tab (Note/Color/Delete) verschlucken Fehler nicht mehr
|
||
> — `MarkierungenTabView` zeigt sie jetzt als Alert (`writeError`),
|
||
> analog zu Lese-Liste/Reader.
|
||
|
||
> **2026-05-25 — Event-Sync auf geteilte Lib `ManaEventSync` migriert:**
|
||
> Die hand-gebaute Plumbing (Envelope/JSONValue/ULID/JWT/Storage/HTTP/
|
||
> Engine/Crypto/Vault, 9 Dateien ~900 LOC) ist raus; pageta konsumiert
|
||
> jetzt `mana-swift-event-sync` (`../mana-swift-event-sync`). Domäne
|
||
> (EventPayloads/States/Reducers/Coordinator) bleibt. Der Coordinator
|
||
> baut Events via `engine.makeEnvelope` — **kein `currentUserId()` mehr**,
|
||
> die Engine besitzt die Identität (Vorbereitung für Local-First ohne
|
||
> Login, E-4.5). Store-Name `pageta-event-sync` + App-Group unverändert
|
||
> → bestehende lokale Daten intakt. iOS-Sim-Build + 38/38 Tests grün.
|
||
> Erst-Adopter der Lib; wordeck folgt.
|
||
|
||
> **2026-05-25 — Markieren-Redesign (Books-Stil) + Fehler sichtbar:**
|
||
> Auswahl im Reader öffnet jetzt eine schwebende Farb-Palette direkt an
|
||
> der Auswahl (`HighlightSelectionPalette`) statt Edit-Menü → Bottom-
|
||
> Sheet; System-Edit-Menü unterdrückt, „Kopieren" lebt in der Palette.
|
||
> Ursache für „Markieren tut nichts": Schreibfehler (typisch *nicht
|
||
> eingeloggt* / stale `softFirst`-Session) wurden in `loadState`
|
||
> geschrieben, dessen UI aber nur bei `article == nil` rendert → still
|
||
> verschluckt. `addHighlight` zeigt den Fehler jetzt als Alert. 38/38
|
||
> Tests grün, iOS-Sim-Build clean. Nicht-eingeloggt-Fall führt jetzt
|
||
> über `ManaAuthGate.require` direkt ins Login-Sheet und holt die
|
||
> Markierung nach erfolgreichem Login automatisch nach (Alert bleibt
|
||
> Fallback für Rest-Fehler / stale `.signedIn`-Session). **Offen:**
|
||
> Markieren ganz ohne Login (Local-First/anon, eigener Umbau); System-
|
||
> Menü-Suppression + Palette-Platzierung am Gerät verifizieren; übrige
|
||
> Write-Pfade (Note/Color/Status) verschlucken Fehler noch genauso.
|
||
|
||
## Phase
|
||
|
||
**π-0..π-9 + π-11 ✅** — App baut iOS-Sim warning-frei, 38/38 Tests
|
||
grün (28 alt + 10 EventSync-Reducer). User-owned-CRUD läuft seit π-11
|
||
gegen `sync2.mana.how` (Event-Sourcing); HTTP-only bleiben Feed,
|
||
Extract-Preview und Widget-Snapshot. Nur π-10 (ASC) offen.
|
||
|
||
> **2026-05-20 — Phase π-11 (Event-Sync-Migration):** Reagiert auf
|
||
> pageta-api G-3 (retired articles-route, 2026-05-19), die alle
|
||
> user-owned-Article-Routen mit 410 antwortet. Native-App spricht
|
||
> jetzt direkt mit `sync2.mana.how`, mit lokaler SwiftData-Projection
|
||
> + Outbox + 60s-Polling. Surface von `PagetaAPI` bleibt identisch —
|
||
> UI unverändert. Pattern 1:1 aus nutriphi-native ν-14, reduziert auf
|
||
> Article + Highlight (Preferences-Aggregate ist offen, sobald
|
||
> Onboarding-UI dafür landet).
|
||
>
|
||
> **Design-Fix nebenbei:** Listentitel auf `.primary` umgestellt
|
||
> (statt `PagetaTheme.foreground` = dunkles Sepia). Im iOS-Dark-Mode
|
||
> sahen die Titel sonst muddy-orange aus, weil der paper-Theme-
|
||
> Foreground gegen schwarzen System-Background gerendert wurde.
|
||
>
|
||
> **Offen:** macOS-Build hängt am Mac-Provisioning-Profile, das die
|
||
> `Associated-Domains`-Capability nicht hat (Apple-Dev-Portal-TODO,
|
||
> nicht code-bezogen). π-10 (ASC + TestFlight) noch offen.
|
||
|
||
- **π-0**: paper-Theme, ManaAuthGate (Cross-App-SSO `ev.mana.session`),
|
||
AppIcon (Eselsohr-Page), AASA auf pageta.com.
|
||
- **π-1**: Feed-Tab via GET /api/v1/feed.
|
||
- **π-2**: Lese-Liste-Tab mit Status-SegmentedControl + Swipe-Actions.
|
||
- **π-3**: Reader-Detail (Plain-Text-Spike), Auto-`unread→reading`.
|
||
- **π-4**: Highlights Paragraph-Granularität via Tool-Endpoint + Tag-Sheet.
|
||
- **π-5**: Universal Links + pageta:// scheme → Sheet mit Reader.
|
||
7 URL-Router-Tests (Drift-Guard gegen pageta.mana.how).
|
||
- **π-6**: ShareExt (URL → App-Group-Queue → Launch-Flush an pageta-api).
|
||
Pattern aus herbatrium-native η-8.3.
|
||
|
||
## Phasen-Roadmap
|
||
|
||
| Phase | Status | Inhalt |
|
||
|---|---|---|
|
||
| π-0 | ✅ 2026-05-18 | Repo-Skelett, Login, Theme, Tab-Placeholder |
|
||
| π-1 | ✅ 2026-05-18 | Feed-Tab mit Pull-to-Refresh aus `GET /api/v1/feed` |
|
||
| π-2 | ✅ 2026-05-18 | Lese-Liste-Tab mit Status-Filter aus `GET /api/v1/articles` |
|
||
| π-3 | ✅ 2026-05-18 | Reader-Detail (Plain-Text-Spike + Toolbar) — Risiko-Spike entschieden zugunsten Plain-Text |
|
||
| π-4 | ✅ 2026-05-18 | Highlights (Paragraph-Granularität, 4 Farben) + Tag-Sheet — via Tool-Endpoints |
|
||
| π-5 | ✅ 2026-05-18 | Universal Links (pageta.com/article/:id) + pageta:// scheme → Sheet mit Reader |
|
||
| π-6 | ✅ 2026-05-18 | ShareExt (URL → App-Group-Queue → Launch-Flush) |
|
||
| π-7 | ✅ 2026-05-18 | WidgetKit Small/Medium/Large (App-Group-Snapshot, pageta:// Deep-Link) |
|
||
| π-8 | ✅ 2026-05-18 | Spotlight-Index für saved Articles + AppShortcuts (OpenFeed, SaveURL) |
|
||
| π-9 | ✅ 2026-05-18 | macOS-Adapt (NavigationSplitView + Sidebar + ⌘R Refresh + SceneStorage-Persistence) |
|
||
| π-10 | offen | ASC + TestFlight |
|
||
| π-11 | ✅ 2026-05-20 | Event-Sync-Migration auf `sync2.mana.how` (Article + Highlight Aggregate) — nutriphi-ν-14-Pattern |
|
||
|
||
**MVP-Cut**: π-0..π-4 (App + Login + Feed + Lese-Liste + Reader mit
|
||
Highlights). Phase 2: π-5..π-10.
|
||
|
||
## Vollständiger Plan
|
||
|
||
[`../mana/docs/playbooks/PAGETA_NATIVE_GREENFIELD.md`](../mana/docs/playbooks/PAGETA_NATIVE_GREENFIELD.md).
|
||
|
||
## Server-Pre-Conditions (alle ✅ vor π-0)
|
||
|
||
- ✅ AASA live auf `pageta.com/.well-known/apple-app-site-association`
|
||
- ✅ Widget-Snapshot-Endpoint `GET /api/v1/snapshot/widget` (JWT-gated)
|
||
- ✅ Primary-Switch zu pageta.com (Manifest base_url + PAGETA_PUBLIC_URL env)
|
||
|
||
## Apple-Dev-Portal-TODO
|
||
|
||
Till's manuelle Aktion vor erstem TestFlight-Build:
|
||
|
||
- [ ] Bundle-ID `ev.mana.pageta` registrieren (Team QP3GLU8PH3)
|
||
- [ ] **Bundle-ID `ev.mana.pageta.share`** (ShareExt, π-6 live im Code)
|
||
- [ ] **Bundle-ID `ev.mana.pageta.widget`** (Widget, π-7 live im Code)
|
||
- [ ] App-Group `group.ev.mana.pageta` für App **+ ShareExt + Widget** aktivieren
|
||
- [ ] **Keychain-Sharing-Group `ev.mana.session`** (Cross-App-SSO mit
|
||
anderen mana-Apps — Eintrag muss exakt matchen, sonst OSStatus
|
||
-34018 errSecMissingEntitlement beim ersten Token-Write)
|
||
- [ ] Capabilities: Associated Domains, App Groups, Keychain Sharing
|
||
- [ ] ASC-App-Eintrag (kommt mit π-10)
|
||
|
||
## Offene Punkte
|
||
|
||
- **π-3 Iteration 2** (deferred): Plain-Text-Render ist brauchbar,
|
||
aber lässt Headings/Bilder/Quotes/Code-Blocks/Links flach werden.
|
||
Wenn echte Content-Strukturen wichtig werden, Server-Markdown-
|
||
Convert (`turndown`) im pageta-api ergänzen + Native via
|
||
swift-markdown rendern.
|
||
- **π-4 Iteration 2** (deferred): Echte Text-Selection statt
|
||
Paragraph-Granularität. Brauchst UITextView-Bridge oder iOS-18+
|
||
Selection-Hook. Hat aber UX-Kosten (Long-Press-Auswahl muss
|
||
zuverlässig sein). Aktuell ist Tap-on-Paragraph der pragmatische
|
||
Cut.
|
||
- **Tag-Read-back fehlt server-seitig**: pageta-api hat keinen
|
||
`GET /api/v1/articles/:id/tags` und kein `tags`-Field im
|
||
Article-DTO. Native kann Tags hinzufügen, sieht sie aber nicht.
|
||
Web hat das gleiche Manko.
|
||
- **FeedItem-Tap** triggert noch keinen Save-Flow. Aktuell ist Feed
|
||
read-only. Save-from-Feed als Sub-Sprint (kleines Feature, kein
|
||
eigener π).
|
||
- **Reading-Progress-Persistierung** nicht implementiert. Scroll-
|
||
Offset wird nicht zum Server zurückgesynct. Status wird beim Open
|
||
auf `reading` gesetzt, aber kein granular Progress-Tracking.
|