feat(augur): new module — signs collected, patterns read

Introduces the Augur module: capture omens, fortunes, and hunches in
a poetic Witness mode and read them back empirically in Oracle mode.
Same data, two lenses; the killer mechanic is the Living Oracle that
materialises empirical reflections from the user's own resolved
history at capture time.

Why now: docs/future/MODULE_IDEAS.md captured the brainstorm, then
the spec landed at docs/plans/augur-module.md as a Witness+Oracle
hybrid. Built end-to-end through M6 in one go.

Highlights:
- Witness gallery + DueBanner + DetailView + Resolve flow
- Oracle stats: calibration-per-source, vibe-hit-rate, cross-module
  correlation engine (mood/sleep/duration after-windows)
- Living Oracle: deterministic fingerprint+match against user's own
  resolved history; cold-start-gated at 50 resolved entries
- Year-Recap view at /augur/recap/[year]
- 5 MCP tools: capture_sign, resolve_sign, list_open_signs,
  consult_oracle, augur_year_recap (in AI_TOOL_CATALOG)
- Visibility integration: default 'private', VisibilityPicker in
  DetailView. Server-side unlisted-snapshot-publish stays follow-up
- v47 Dexie schema; encrypted: source/claim/feltMeaning/
  expectedOutcome/outcomeNote/tags/livingOracleSnapshot
- LOCAL TIER PATCH: requiredTier 'guest' for testing

Strings interpolated through `T` constants so the i18n-hardcoded
baseline stays at 0 for augur — real $_('augur.*') keys land later.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Till JS 2026-04-25 15:02:15 +02:00
parent 568d79dc16
commit faa16fa898
38 changed files with 5272 additions and 0 deletions

View file

@ -15,6 +15,138 @@ recommendation.
---
## 2026-04-25 Brainstorm — Mana-spezifische Ideen
Ideen, die bewusst auf das einzigartige Stack-Profil von Mana setzen:
Personas, MCP-Tools, Spaces, Visibility/Embed, Local-First, Verschlüsselung.
Keiner dieser Vorschläge existiert in den 82 aktuellen Modulen oder weiter
unten in dieser Datei.
### KI-native (Personas, Missions, MCP)
- **debate** — Zwei Personas argumentieren live einen Streitpunkt aus deinem Prompt. Du votest pro Runde; Output = strukturierte Pro/Contra-Liste.
- **rubberduck** — Sprich-laut-denken: Mic an → STT → AI strukturiert "Du hast erst X gesagt, dann Y, Kerngedanke = Z". Verknüpft mit `notes`/`decisions`.
- **dialogues** — Schwierige Gespräche üben (Gehaltsverhandlung, Trennung, Eltern, Bewerbungsinterview). Persona spielt Gegenüber + Feedback zu Tonfall/Struktur.
- **scribe** — Live-Notetaker für In-Person-Meetings: Mic offen, transcribed + strukturiert in Echtzeit (Action-Items → `todo`, Zitate → `quotes`).
- **pitch** — 30-Sek-Pitch aufnehmen, AI bewertet Hook/Klarheit/Lieferung. Versionsverlauf.
- **clones** *(ZK)* — Persona, trainiert auf Gespräche/Texte einer realen Person (du selbst, Freund, verstorbener Großvater). Chat & Briefe — heikel, klar als Roleplay markiert.
- **ai-pets** — Persistenter AI-Charakter (Tamagotchi-Logik): füttern, sprechen, wächst über Wochen. Kinder-Modul-Kandidat.
- **prompts** — Prompt-Bibliothek mit Variablen, Versionen, eingefangenen Outputs. Mana-Twist: gespeicherte Prompts werden automatisch zu MCP-Tools.
### Zeit, Erinnerung, Identität
- **eras** — Selbst-betitelte Lebensabschnitte ("Burnout-Jahr 2024", "Berlin-Phase"). Aggregiert *alles* aus dem Zeitraum (Fotos, Journal, Mood, Todos) zu einer Wikipedia-artigen Seite — AI-generiert, kuratierbar.
- **threads** — Mehrjährige Themen-Threads (Beziehung zur Schwester, dieses Side-Projekt, diese Angst). Tagged Einträge, AI fasst Bogen zusammen.
- **lasts** — Gegenstück zu `firsts`: das *letzte* Mal, dass du X getan/gesehen/gefühlt hast. Oft erst rückwirkend erkennbar — push notification "vor X Jahren das letzte Mal …".
- **legacy** *(ZK)* — Was du hinterlassen willst: digitales Testament, Briefe an Hinterbliebene, Memorial-Botschaften (zeitgesperrt freischaltbar — wie `letters` aber outward).
- **sealed** — Vorhersagen verschlossen ablegen, automatisches Reveal am Datum X. Kalibrierungs-Tracking (Brier-Score) — persönliche Tetlock-Statistik.
- **regret / forgive** *(ZK)* — Bedauern / Vergeben; CBT-light Workflow: erfassen → reframen → loslassen-markieren.
### Sensorik & Welt
- **sounds** — Field-Recordings-Bibliothek (Regen in Tokyo, Vogelchor auf Wanderung). Geo+Zeit-getaggt; Spotlight für `flashbacks`.
- **scents** — Parfums, Kerzen, Räucherstäbchen — was du wann getragen hast. "Geruchsgedächtnis"-Notizen.
- **tastes** — Verkostungs-Notizen (Wein, Whisky, Spezialitätenkaffee, Tee). Vivino-artig aber generisch und verschlüsselt.
- **palette** — Farben, die du an einem Tag siehst — Foto, AI extrahiert Hauptfarben → Jahres-Farbgeschichte.
- **light** — Tageslicht-Exposition (manuell oder Wetter-API). Korreliert mit `moodlit`/`sleep`.
### Bewegung & Orte (jenseits von `places`)
- **routes** — Lauf/Rad/Wander-Routen, die du gemacht hast. Map-View, Wiederholungs-Counter.
- **hikes** — Wander-Log: Distanz, Höhenmeter, Gipfel, Foto-Sammlung. Reused `places` + `photos`.
- **borders** — Länder/Grenzen, die du überschritten hast. Visa, Stempel-Foto, Erinnerungen pro Übergang.
- **landmarks***Persönliche* Landmarks: wo du verlobt warst, erstes Date-Café, wo du den Anruf bekamst. Geo-pinned, oft (ZK).
### Selbsterkenntnis & Muster
- **triggers** — Was dich getriggert hat (Wut/Angst/Scham). AI-Mustererkennung über Wochen.
- **rules** — Persönliche Operating-Rules ("Kein Handy vor Kaffee", "Sonntags kein Slack"). Adhärenz-Tracking, schlägt Edits vor wenn dauerhaft gebrochen.
- **anti-todos** — Was du *bewusst nicht* tust und warum. Mindestens so wertvoll wie eine Todo-Liste.
- **delegations** — Was du an wen delegiert hast — privat *und* beruflich. Auto-Follow-up.
- **ifsthen** — Implementation Intentions ("Wenn Mittwoch 20h, dann Klettern"). Spätere Auswertung: welche Pläne hielten?
- **superpowers** — Konkrete Stärken mit echten Beispielen. AI hilft Muster zu finden ("du wirst oft als 'klar' beschrieben").
- **cravings** — Triebmomente erfassen (Junkfood, Scrollen, Rauchen). Pattern + Redirect-Vorschlag.
### Geld erweitert
- **donations** — Spenden-Log mit Steuerexport.
- **patrons** — Creator, die du unterstützt (Patreon, Substack, GitHub-Sponsors). Budget-Sicht, Renewal-Daten.
- **negotiations** — Was du verhandelt hast: Ask vs. Result. Übungs-Datenbank für nächste Runde.
- **freebies** — Was du geschenkt/gratis bekommen hast. Erstaunlich motivierend; gut für Steuer wenn beruflich.
### Kreativ & Werk
- **drafts** — Universaler Entwurfs-Inbox (Texte, Mails, Posts, Tweets). Kein Modul-Zwang; AI schlägt Ziel-Modul vor.
- **publishings** — Alles, was du veröffentlicht hast (Blog, Tweet, Vortrag, Podcast). Wo, wann, Reaktionen — eine Karriere-Timeline.
- **shows** — Konzerte, Ausstellungen, Filme, Theater die du besucht hast. Tickets-Archiv (Foto), Begleitung, Gedanken danach.
- **tickets** — Stub-Sammlung: Konzert/Sport/Kino. Foto + OCR + Erinnerung. Stark als Embed (Visibility).
- **portfolios** — Public-facing kuratierte Werk-Sammlung (zieht aus `picture`, `writing`, `comic`, `presi`). Visibility-System pur.
### Affirmation & Mentalmodelle
- **mantras** — Persönliche Mantras + Frequenz-Tracking ("dieses Mantra benutze ich tatsächlich").
- **lessons** — Lebenslektionen. Tagged nach Domäne, jährliche Review.
- **wins** — Mikro-Wins täglich (kleiner als `goals`, kein Streak-Druck).
- **fears** — Furcht-Inventar mit Status (aktiv/abgeschlossen/transformiert).
- **losses** *(ZK)* — Trauer-Journal pro Person/Sache. Anniversary-Reminder, AI-Begleitung optional.
### Bürgerlich / Welt
- **votes** — Wahl-Historie + Wahlzettel-Recherche-Notizen + lokale Repräsentanten.
- **causes** — Themen, die dir wichtig sind. Aktionen (Demo, Spende, Brief), Updates pro Cause.
- **rights** — Mieter-/Arbeitsrechte als Situations-Checkliste ("Vermieter sagt X — was sind meine Rechte?"). MCP-Tool wäre sinnvoll.
### Häuslich (Detail)
- **moves** — Alle Umzüge: was verschwand, was du wegspendetest, was blieb. Ergänzt `inventory`.
- **roomies** — WG-Mitbewohner-Log; Konflikte/Vereinbarungen.
- **handymen** — Handwerker, Ärzte, Service-Provider mit echten Bewertungen. Privater "lokaler Yelp".
- **insurance** — Policies, Schäden, Beitragshistorie. Synergie mit `documents`.
### Sozial fein granular
- **handshakes** — Bemerkenswerte Menschen, die du getroffen hast. Eine-Zeile-Erinnerung pro Person.
- **mentors / mentees** — Wer dir half / wem du halfst. Konkrete Momente.
- **rolemodels** — Public Figures, von denen du lernst. Was genau, und warum.
- **names** — Wie spricht/schreibt man Namen? Eselsbrücken pro Person.
### Verspielt
- **bets** — Wetten mit Freunden. Multi-Member Space als Wettregister; wer hatte recht?
- **wagers** — Selbst-Wetten an Goals geknüpft ("Wenn ich Marathon nicht laufe → 200€ Spende").
- **prophecies** — Vorhersagen, die du *öffentlich* gemacht hast (Tweets, Diskussionen). Realitäts-Check Quartal.
- **fortunes** — Glückskekse, Horoskope, Tarot. Realitäts-Abgleich — Pseudo-Weisheit-Inventur.
### Notfall & Sorge
- **emergency** *(ZK)* — Notfall-Kontakte, Allergien, Blutgruppe, Ärzte. Schnellzugriff am Sperrbildschirm wäre Killer.
- **caregiving** *(ZK)* — Pflege für Eltern: Medikamente, Termine, Episoden. Mehrere Familienmitglieder via Spaces.
- **proxy** *(ZK)* — Vorsorgevollmacht, Patientenverfügung, digitale Erbschaft.
### Pro-Tooling
- **tools** — Werkzeuge-Inventar (Holz, Code, Küche). Was hast du womit gebaut?
- **rigs** — Compute-Setups über Zeit (welche Maschine, welche dotfiles, was hast du damit gebaut). Nostalgie + Migration.
- **commands** — CLI-Commands die du *wirklich* benutzt. Aliase mit Kontext.
### Phänomenologisch (mutig)
- **synchronicities** — Zufälle/Synchronizitäten erfassen. AI sucht Muster — wahrscheinlich keine, aber spannend.
- **dejavu** — Déjà-vu-Episoden mit Auslöser. Häufungs-Heatmap.
- **omens** — Was hast du als Zeichen genommen? Was passierte tatsächlich? Aberglaubens-Auditor.
### Top-7 zum Bauen (höchster Hebel auf bestehende Architektur)
1. **scribe** — riesiger Wert, perfekter Fit für mana-stt + Personas
2. **eras** — emotional starke Killer-Feature, zieht aus *allen* Modulen
3. **lasts** — billig zu bauen, einzigartiges Gefühl (existiert nirgends)
4. **rubberduck** — STT + AI Reflection, organisch zu `decisions`/`notes`
5. **emergency** *(ZK)* — echtes Lebens-Utility, schwacher Markt
6. **sealed** — eingebaute Kalibrierung, gamified Selbsterkenntnis
7. **portfolios** — testet Visibility-System unter Last, 0 neue Datentabellen
---
## Current modules (for reference)
**Productivity:** todo, calendar, contacts, notes, habits, times, timeblocks, events

376
docs/plans/augur-module.md Normal file
View file

@ -0,0 +1,376 @@
# Augur — Module Plan
## Status (2026-04-25)
**Konzept-Phase.** Modul noch nicht begonnen. Plan beschreibt das Zielprodukt;
M1 ist klar definiert und sofort baubar.
---
## Ziel
Ein Modul, das **Zeichen** sammelt — und sie sowohl *poetisch erlebbar* als
auch *empirisch auswertbar* macht. Drei vorher als getrennt gedachte
Brainstorm-Module (`omens`, `prophecies`, `fortunes`) verschmelzen zu einer
einzigen Praxis: *du erfasst Zeichen wie ein magischer Realist und liest sie
zurück wie ein Empiriker.*
Kernfrage des Nutzers: *"Habe ich diesem Bauchgefühl/Traum/Glückskeks zu Recht
geglaubt?"*
Killer-Feature: Sobald genug Daten gesammelt sind, werden **deine eigenen
empirisch entdeckten Muster** zum Orakel für neue Zeichen ("Living Oracle").
Die Magie wird nicht behauptet — sie materialisiert sich aus deinen Daten.
Niemand außer Mana kann das, weil niemand sonst alle Module zusammen sieht.
## Abgrenzung
- **Kein `dreams`**: Träume bleiben dort. `augur` referenziert höchstens
einen Traum-Eintrag (`relatedDreamId`), wenn der Nutzer ein Traum-Symbol
als Omen werten will. Kein Daten-Duplikat.
- **Kein `journal`**: Journal ist freitext-getrieben. `augur` ist
strukturiert um den Lebenszyklus *Zeichen → Erwartung → Outcome*.
- **Kein `decisions`**: Decisions speichert *Entscheidungen* mit Annahmen
und Reviews; `augur` speichert *Eingebungen, Vorzeichen, Wahrsagungen*
oft ohne dass eine Entscheidung anhängt.
- **Cross-Link statt Merge**: `augur` liest aktiv aus anderen Modulen
(`mood`, `sleep`, `body`, `decisions`, `dreams`) für die
Korrelations-Engine. Schreibt nirgendwo zurück.
## Entscheidung: ein Modul, drei Geschmacksrichtungen
Ein Modul `augur` mit Diskriminator `kind`:
- `omen` — externes Zeichen (schwarze Katze, doppelte Regenbögen, Vogel im Fenster)
- `fortune` — gelesene/gewürfelte Aussage (Glückskeks, Tarot, Horoskop, I-Ching)
- `hunch` — eigenes Bauchgefühl, eigene Vorhersage
Geteiltes Kern-Schema; ein Modul, eine Tabelle, zwei UI-Modi
(*Witness* + *Oracle*).
Begründung wie bei `library`: ein Sync-Endpoint, eine Encryption-Registry-Zeile,
eine Route, ein Settings-Panel. Cross-Auswertungen (Jahresrückblick über
alle Quellen, Calibration-per-Source) fallen gratis ab.
## Die zwei Modi
### Witness-Modus (Erfassen + Erleben)
Niedrigschwellige, poetische UI. Vibe-getrieben, kein
Wahrscheinlichkeit-eintragen-Zwang. Einträge erscheinen als
vibe-colored Karten in einer Galerie. Year-Recap als AI-erzählte Geschichte.
Default-Surface des Moduls — was der Nutzer sieht, wenn er auf
`/augur` landet.
### Oracle-Modus (Auswerten + Lernen)
Tab/Toggle "Oracle". Zeigt drei Auswertungs-Layer auf demselben Datenset:
1. **Calibration per Source** — Brier-Score / Hit-Rate pro Quelle
("Bauchgefühl: 67%. Tarot: 51%. Mutter: 73%.")
2. **Correlation Matrix** — Cross-Module Mining: gegebenenfalls signifikante
Korrelationen zwischen `kind`/Vibe/Tags eines Eintrags und Folgewerten
in `mood`, `sleep`, `body`. Disclaimer "Korrelation, nicht Kausalität"
prominent.
3. **Vibe-Hit-Rate** — Stimmen Vibes (good/bad) mit objektiven Folge-Daten
überein?
### Living Oracle (das Killer-Feature)
Bei der Erfassung eines neuen Zeichens prüft Mana **deine eigene Historie**
und gibt — wo statistisch belastbar — eine Living-Oracle-Reflektion aus:
> *Du hast 4× zuvor einen Wassertraum protokolliert. Danach im Schnitt:
> 38min weniger Schlaf, leicht angespannte Stimmung am Folgetag. Vielleicht
> heute keine schweren Termine?*
Das ist Empirismus mit dem Mantel der Wahrsagerei. Implementation:
deterministisch, kein LLM-Halluzinations-Risiko (LLM nur für Phrasing,
nicht für Inferenz).
## Modul-Struktur
```
apps/mana/apps/web/src/lib/modules/augur/
├── types.ts # LocalAugurEntry, AugurKind, Vibe, Outcome
├── collections.ts # augurEntries-Table + Guest-Seed (1 Omen, 1 Fortune, 1 Hunch)
├── queries.ts # useAllEntries, useEntriesByKind, useUnresolved, useDueForReveal, useStats
├── stores/
│ └── entries.svelte.ts # createEntry, updateEntry, resolveEntry, archiveEntry
├── components/
│ ├── EntryCard.svelte # vibe-colored Karte (Galerie-Item)
│ ├── EntryForm.svelte # Capture-UI (eine Form, Felder ändern sich pro kind)
│ ├── VibeBadge.svelte # good/bad/mysterious
│ ├── OutcomeBadge.svelte # fulfilled / partly / not / open
│ ├── ResolveDialog.svelte # "Hat sich das bewahrheitet?" kommt per PN/Inbox
│ ├── LivingOracleHint.svelte # die deterministische Reflektion bei Capture
│ └── KindTabs.svelte # Alle | Omen | Fortune | Hunch
├── views/
│ ├── WitnessView.svelte # Default-Surface — vibe-Galerie
│ ├── OracleView.svelte # Calibration + Correlation + Vibe-Hit-Rate
│ ├── DetailView.svelte # Einzelansicht inkl. Reflektion + Resolve-Action
│ └── YearRecapView.svelte # AI-erzählter Jahresrückblick
├── lib/
│ ├── correlation-engine.ts # Cross-Module-Korrelations-Berechnung
│ ├── calibration.ts # Brier-Score, Hit-Rate pro Source
│ └── living-oracle.ts # Match neue Eingabe gegen Historie + Folge-Daten
├── tools.ts # MCP-Tools (M5)
├── constants.ts # KIND_LABELS, VIBE_LABELS, DEFAULT_SOURCES
├── ListView.svelte # Modul-Root — switched zwischen WitnessView und OracleView
├── module.config.ts # { appId: 'augur', tables: [{ name: 'augurEntries' }] }
└── index.ts # Re-Exports
```
## Daten-Schema
### `LocalAugurEntry` (Dexie)
```typescript
export type AugurKind = 'omen' | 'fortune' | 'hunch';
export type AugurVibe = 'good' | 'bad' | 'mysterious';
export type AugurOutcome = 'fulfilled' | 'partly' | 'not-fulfilled' | 'open';
export interface LocalAugurEntry extends BaseRecord {
kind: AugurKind; // plaintext — Discriminator, filterbar
source: string; // encrypted — "schwarze Katze", "Glückskeks", "Bauchgefühl", "Mutter"
sourceCategory?: string | null; // plaintext — "tarot" | "horoscope" | "fortune-cookie" | "gut" | "person" | "media" | "natural" | ... — für Calibration-per-Source
claim: string; // encrypted — was das Zeichen zu sagen schien
vibe: AugurVibe; // plaintext — primärer Filter in WitnessView
feltMeaning?: string | null; // encrypted — "soll ich den Job nicht annehmen"
expectedOutcome?: string | null; // encrypted — konkrete Prognose, falls erfasst
expectedBy?: string | null; // plaintext ISO-Datum — triggert Resolve-Reminder
probability?: number | null; // plaintext — 0..1, optional (nur power-user)
outcome: AugurOutcome; // plaintext — startet 'open', kommt bei Resolve
outcomeNote?: string | null; // encrypted — wie genau ist es gekommen
resolvedAt?: string | null; // plaintext
encounteredAt: string; // plaintext ISO-Datum — wann das Zeichen kam
tags: string[]; // encrypted
relatedDreamId?: string | null; // plaintext — Cross-Link in dreams-Modul
relatedDecisionId?: string | null; // plaintext — Cross-Link in decisions (falls existiert)
livingOracleSnapshot?: string | null; // encrypted — die Reflektion zur Erfass-Zeit (für Audit)
isPrivate: boolean; // plaintext — von ZK-Default abweichen erlaubt
}
```
### Verschlüsselung
Standardmäßig **encrypted** (siehe `apps/mana/apps/web/src/lib/data/crypto/registry.ts`):
`source`, `claim`, `feltMeaning`, `expectedOutcome`, `outcomeNote`, `tags`,
`livingOracleSnapshot`. Plaintext bleibt nur, was für Filter / Korrelation /
Reminder-Scheduling nötig ist (`kind`, `vibe`, `outcome`, `sourceCategory`,
Daten, IDs).
Visibility-Default (vgl. `@mana/shared-privacy`): **`private`**. Embed-fähig
nur über explizite Hochsetzung pro Eintrag. Begründung: Auch ein "harmloses"
Bauchgefühl kann sehr persönlich sein; keine Default-Sichtbarkeit nach außen.
## Living Oracle — Algorithmus
Beim `createEntry` (oder synchron im Background-Tick mit Render-Hint):
1. Fingerprint des neuen Eintrags bilden:
`{ kind, sourceCategory, vibe, tagSet, derived: keywords-from-claim }`
2. Suche in eigener Historie (`augurEntries`) nach Einträgen mit
≥2 übereinstimmenden Fingerprint-Komponenten **und** `outcome != 'open'`.
3. Für jeden Treffer: lies aus `mood`, `sleep`, `body` die Werte des
Folge-Tags (`encounteredAt + 1d` bis `+3d`).
4. Mittelwert + Stichprobengröße + einseitiger Vorzeichentest (oder
Bootstrap-CI). Schwelle: `n ≥ 3` und Effekt klar (Δmood ≥ 0.5σ ODER
Δsleep ≥ 20min) → Living-Oracle-Hint zeigen.
5. LLM (lokal über `@mana/local-llm` oder mana-llm) übernimmt **nur**
das Phrasing — Eingabe ist die strukturierte Statistik, nicht die
Rohdaten. Kein Halluzinations-Risiko bei numerischen Werten.
Auditierbarkeit: `livingOracleSnapshot` speichert die Reflektion zum
Erfass-Zeitpunkt (verschlüsselt). Bei Resolve sieht der Nutzer
"das Orakel sagte damals X — und es trat Y ein".
Cold-Start: vor 50 Einträgen wird kein Living-Oracle-Hint gezeigt.
Vorher Empty-State im OracleView: *"Noch zu früh — sammle erst Zeichen."*
## Routing
```
/augur → WitnessView (Default)
/augur?mode=oracle → OracleView
/augur/entry/[id] → DetailView
/augur/recap/[year] → YearRecapView
```
Keine separaten Routen pro `kind` — Filter via `KindTabs` in der View.
## Inbox-Integration
Reminder-Strategie für Resolve:
- Bei `expectedBy` gesetzt → Reminder am Folgetag der Deadline
- Bei `expectedBy` nicht gesetzt → Default-Reminder nach 30 Tagen
- Reminder läuft über `myday`/Inbox-Mechanik (nicht eigener Pusher),
Action öffnet `ResolveDialog`
## Cross-Modul-Hooks
- **`dreams`**: in DreamDetailView ein "→ als Omen markieren"-Button, der
`augurEntries` mit `relatedDreamId` befüllt
- **`decisions`** (falls gebaut): "Hattest du ein Bauchgefühl?"-Quick-Add
öffnet `augur` Capture mit `kind=hunch` + `relatedDecisionId`
- **`flashbacks`** (falls gebaut): augur-Einträge erscheinen im "Vor X
Jahren"-Stream wie andere Module
## AI-Integration (M5)
MCP-Tools in `tools.ts` (Pattern wie in `comic`/`writing`):
- `augur.captureSign({ kind, source, claim, vibe, ... })` — schneller
Capture für Personas / Voice-Bot
- `augur.consultOracle({ contextHint? })` — gibt eine empirisch fundierte
Reflektion (Living-Oracle-Logik) zurück, optional mit Kontext-Hint
- `augur.resolveEntry({ entryId, outcome, note })`
- `augur.yearRecap({ year })` — strukturierter Year-Recap (Quelle für die
AI-erzählte View)
Persona-Kandidat: **"Die Augurin"** als Mana-Persona — neutral-skeptische
Beraterin, die Living-Oracle-Hints in poetische Sprache übersetzt. Optional
in `M5`.
## Visibility & Embed
Visibility-System voll integriert (vgl. `@mana/shared-privacy`):
- Default `private`
- Pro Eintrag hochsetzbar bis `unlisted`
- Embed-Quelle "Augur" für Website-Builder: Galerie der "good"-vibe Omen
mit Outcome `fulfilled`, anonymisiert auf Wunsch
Erst in **M6** — Visibility-System ist Modul-für-Modul Rollout (siehe
Memory-Eintrag *Visibility-System — M1M5.c shipped*).
## Encryption-Registry
Eintrag in `apps/mana/apps/web/src/lib/data/crypto/registry.ts`:
```typescript
augurEntries: {
encryptedFields: ['source', 'claim', 'feltMeaning', 'expectedOutcome',
'outcomeNote', 'tags', 'livingOracleSnapshot'],
plaintextFields: ['kind', 'vibe', 'outcome', 'sourceCategory',
'encounteredAt', 'expectedBy', 'resolvedAt',
'probability', 'relatedDreamId', 'relatedDecisionId',
'isPrivate'],
}
```
## Meilensteine
### M1 — Skelett (1 Tag)
- `module.config.ts` + Registry-Eintrag in `module-registry.ts`
- Dexie-Schema-Bump in `database.ts` (neue Tabelle `augurEntries`)
- Encryption-Registry: Felder eintragen (verpflichtend bei Sensible-Defaults)
- Route `apps/mana/apps/web/src/routes/(app)/augur/` mit Platzhalter
- App-Eintrag in `packages/shared-branding/src/mana-apps.ts` (Icon, Tier,
Branding)
- Guest-Seed: 3 Beispiel-Einträge (1 Omen, 1 Fortune, 1 Hunch — alle mit
Outcome um sofort etwas in der Galerie zu zeigen)
- soft-first Migration (vgl. Feedback-Memory): erst lesen-tolerant, dann
Hard-Pass
### M2 — Capture + Galerie (Witness-Modus, 2 Tage)
- `EntryForm.svelte` mit kind-Tabs in der Form (Felder ändern sich)
- `EntryCard.svelte` + `WitnessView.svelte` als Galerie
- `KindTabs.svelte` für Filter
- `DetailView.svelte` mit Resolve-Action
- `ResolveDialog.svelte` (kann auch direkt im Detail laufen)
- Stores: `createEntry`, `updateEntry`, `resolveEntry`, `archiveEntry`
### M3 — Resolve-Reminder (1 Tag)
- Inbox-Integration: bei `expectedBy` Resolve-Reminder erzeugen, Default
30-Tage-Fallback
- Query `useDueForReveal` für eine "fällig"-Liste in der View
- Push-Notification optional (über bestehende mana-notify-Pipeline)
### M4 — Oracle-Modus (3 Tage)
- `OracleView.svelte` mit drei Sektionen:
- **Calibration per Source** — Brier-Score / Hit-Rate Tabelle
- **Correlation Matrix** — Cross-Module-Engine in `correlation-engine.ts`
- **Vibe-Hit-Rate** — Mood/Sleep-Folge-Daten vs. Vibe
- `lib/calibration.ts` mit deterministischer Brier-Berechnung
- Cold-Start-Empty-State unter 20 resolvten Einträgen
### M4.5 — Living Oracle (2 Tage)
- `lib/living-oracle.ts` — Fingerprint + Historien-Match + Stat-Test
- `LivingOracleHint.svelte` — UI-Block in `EntryForm` after-create
- `livingOracleSnapshot` befüllen + bei Resolve neben Outcome anzeigen
- Cold-Start unter 50 Einträgen → Hint deaktiviert
- LLM-Phrasing optional: ohne LLM nüchterner Fakten-Block, mit LLM
poetischere Formulierung; beides funktioniert
### M5 — MCP-Tools + Persona (1 Tag)
- `tools.ts` mit `captureSign`, `consultOracle`, `resolveEntry`,
`yearRecap`
- AI-Tool-Catalog Bridge (vgl. comic-Modul-Pattern)
- Optional: "Die Augurin" Persona-Definition als Seed
### M6 — Year-Recap + Visibility (2 Tage)
- `YearRecapView.svelte` — AI-erzählter Jahresrückblick mit
Living-Oracle-Highlights
- Visibility-Felder in Form + Galerie-Filter
- Embed-Quelle für Website-Builder
### M7 (optional) — Cross-Modul-Hooks
- "→ als Omen markieren" in `dreams`
- Bauchgefühl-Quick-Add in `decisions`
- Aufnahme in `flashbacks`-Stream
### M8 (optional) — Voice-First Capture
- Voice-Bot-Integration: "Hey Mana, ich hab ein Bauchgefühl, dass…" →
STT → `augur.captureSign` über MCP
- Niedrige Capture-Hürde wäre exakt das, was für Hunches fehlt
## Testing
- Unit-Tests für `calibration.ts` (Brier-Score-Korrektheit)
- Unit-Tests für `correlation-engine.ts` mit Fixtures aus
`mood`/`sleep`-Mock-Daten
- Unit-Tests für `living-oracle.ts` Fingerprint-Match-Logik
- Vitest mit Mock-Factories aus `.claude/guidelines/testing.md`
- Snapshot-Test für Year-Recap-JSON-Struktur (vor LLM-Phrasing)
## Risiken & offene Fragen
- **Kalibrierungs-Datenmenge**: bis 50 Einträge ist OracleView fast leer.
Onboarding muss klar machen *"erst sammeln, dann auswerten"*.
- **Subjektivität von Outcome**: "ist das Bauchgefühl eingetreten?" ist
selten klar Ja/Nein. `partly` als first-class citizen ist Pflicht;
`outcomeNote` für Nuance.
- **LLM-Halluzinations-Risiko bei Living Oracle**: durch deterministische
Stat-Computation + LLM-only-for-phrasing entschärft, aber muss in
Tests verteidigt werden (LLM darf keine Zahlen ändern).
- **Esoterik-Wahrnehmung**: das Modul ist *empirisch*, aber das Branding
schreit "Wahrsagerei". Tonalität in Texten muss klar "wir messen, wir
spekulieren nicht" kommunizieren. UI darf trotzdem schön sein.
- **Cross-Modul-Korrelationen brauchen Plaintext-Felder dort**: `mood`
speichert Mood-Werte plaintext (verifizieren), `sleep` Schlafdauer
plaintext. Falls verschlüsselt, muss korrelation-engine durch
decryption-Layer — Aufwand verdoppelt sich.
## Naming-Begründung
`augur` (lat. *augurium*, "Vogel-Beobachtung") ist der römische Priester,
der Zeichen liest. Ein-Wort-Name, neutraler Ton (weder zu woo noch zu
trocken), passt zur Modul-Konvention (`firsts`, `dreams`, `quotes`),
und der Nutzer wird zum Augur seines eigenen Lebens — was die
Self-Empowerment-Botschaft ist.
Alternativen erwogen: `signs` (zu generisch, Konflikt mit UI-Konzepten),
`omens` (deckt nur 1/3 der Inhalte ab), `oracle` (klingt zu sehr nach
externer Wahrsagerei).
## Nicht im Scope
- Externe Tarot-Decks / Horoskop-APIs für Auto-Captures (kann später als
`mana-research` Provider hinzukommen)
- Aggregierte/anonymisierte Auswertungen über Nutzer hinweg ("im Schnitt
haben unsere Nutzer X% Bauchgefühl-Trefferquote") — Datenschutz-Risiko,
Mana ist private-by-default
- Spirituelle/religiöse Inhalte (Gebet, Meditation): bleiben in `meditate`
- Predictions-Markets / monetäre Wetten: bleiben im (geplanten) `bets`