This commit is contained in:
Lars committed 2026-08-25 13:57:23 +02:00
1 parent a8caeb0dd4
commit fd7102e3b3
95 files changed
+16520 -193

No files matched your search

@@ -13,7 +13,7 @@ Dieses Dokument dient dazu, für weitere Konzeptarbeit nur die tatsächlich ben
## 1. Root-Dokumente
- `handover.md` – Session-Bootstrap und aktueller Arbeitsstand; verweist für Details auf die kanonischen Fachkapitel und ersetzt sie nicht.
- `handover.md` – Session-Bootstrap für die **Konzept-/Interviewarbeit**; nicht der Code-Stand. Implementierungsstand und Fit-Gap: `mvp_stand_und_abgleich.md`.
- `fachliche_zielarchitektur.md` – Governance, Dokumentationsprinzipien, Querschnittsinvarianten, Dateistruktur.
- `produktvision_und_produktidentitaet.md` – Vision, Identität, Scope, Produktprinzipien und Nicht-Ziele.
- `interview_plan.md` – Kapitelplan, Interviewmethode, Fortschritt und nächster Interviewblock.
@@ -34,6 +34,9 @@ Dieses Dokument dient dazu, für weitere Konzeptarbeit nur die tatsächlich ben
| `reflection_outputs.md` | Journal/Memory/Knowledge/Action Outputs |
| `integrations.md` | Jinkendo-Produktgrenzen und Integrationen |
| `guardrails.md` | Privacy Gateway, Pseudonymisierung, externe KI |
| `mvp.md` | Erster vertikaler Slice (dialoggeführtes Journal) |
| `implementation_foundation.md` | Verbindliche Leitplanke zwischen Zielmodell und Slice |
| `mvp_stand_und_abgleich.md` | **Kanonische Fit-Gap-Analyse** (2026-08-25): Code gegen Foundation, MVP-Slice und Gesamtziel; Gaps, Ungenauigkeiten, Prüfbrief für Gegenlesung |
## 3. Empfohlene Context Bundles
@@ -68,6 +71,20 @@ Dieses Dokument dient dazu, für weitere Konzeptarbeit nur die tatsächlich ben
3. `reflection_outputs.md`
4. das jeweils betroffene Fachkapitel
### MVP-Journal-Slice / Fit-Gap
Kanonisches Home der Fit-Gap-Analyse ist `mvp_stand_und_abgleich.md`. Es ersetzt weder `mvp.md` noch die Foundation noch die Produktvision.
**Technische Umsetzung** (wie der Slice gebaut ist, nicht der fachliche Abgleich): `../technical/mvp_implementation.md`.
1. `mvp.md`
2. `implementation_foundation.md`
3. `mvp_stand_und_abgleich.md`
4. `writing_profile_and_journaling.md`
5. `guardrails.md`
6. bei Gegenlesung gegen das Gesamtziel zusätzlich `produktvision_und_produktidentitaet.md`
7. technisch: `../technical/mvp_implementation.md` und `../technical/documentation_index.md` Bundle „MVP-Journal-Slice / technische Umsetzung“
### Datenschutz / externe KI
1. `fachliche_zielarchitektur.md`
@@ -82,8 +99,12 @@ Seit 2026-08-19 existiert eine vorläufige technische Rahmenarchitektur unter `.
Sie übernimmt den Produktrahmen **weitgehend von Mitai**. Datenschutz, Privacy Gateway und Guardrails sind fachlich bereits Invariante und technisch bindend. Dialog-, Memory- und MVP-Schnitte bleiben Arbeitsstand; Phasen F–I führen sie weiter. Encryption, Löschen und DSFA (Phase H1) sind Ausprägung, nicht Ersatz der Invariante.
Technische Umsetzung des gebauten Journal-Slices: `../technical/mvp_implementation.md`. Fit-Gap bleibt fachlich: `mvp_stand_und_abgleich.md`.
## 5. Ladeprinzip
> **Nicht alle Kanshō-Dokumente gleichzeitig laden.** Root-Dokumente plus die 2–4 fachlich betroffenen Dateien bilden den Standardkontext.
Code-Stand, Slice-Gaps und Abstand zum Gesamtziel nicht aus einzelnen technischen „Implementierungsstand“-Abschnitten rekonstruieren. Dafür `mvp_stand_und_abgleich.md` laden.
Vor größeren Querschnittsentscheidungen wird zusätzlich über `migration_mapping.md` und die relevanten Invarianten geprüft, ob andere Kapitel betroffen sind.
@@ -262,8 +262,13 @@ reflection_outputs.md
integrations.md
guardrails.md
migration_mapping.md
mvp.md
implementation_foundation.md
mvp_stand_und_abgleich.md
```
`mvp_stand_und_abgleich.md` ist das **kanonische Home der Fit-Gap-Analyse**: Code gegen Implementation Foundation, gegen den freigegebenen MVP-Slice und gegen das Gesamtziel. Es ersetzt weder `mvp.md` noch `implementation_foundation.md` noch `produktvision_und_produktidentitaet.md`. Technische Kapitel führen lokale Implementierungsstände; der Abgleich liegt hier.
Die unveränderten Quelldokumente vor der Aufteilung liegen im Verzeichnis `checkpoint_originals/`.
Die **technische** Zielarchitektur liegt parallel unter `docs/architecture/technical/` und beginnt mit `technische_zielarchitektur.md`. Sie ist der Fachdoku nachgeordnet, ersetzt keine Fachkapitel und darf unfertige Interviewblöcke nicht als entschieden darstellen.
+2
View File
@@ -15,6 +15,8 @@ canonical_docs_path: "docs/architecture/functional/"
Dieses Dokument ist der **vollständige fachliche Aufsatzpunkt für eine neue Kanshō-Konzept-Session**.
**Implementierungsstand (Code)** steht nicht hier, sondern in `mvp_stand_und_abgleich.md` (2026-08-25): Slice gegen Foundation, MVP-Text und Gesamtziel. Dieses Handover bleibt der Konzept-/Interview-Bootstrap.
Es soll ermöglichen, die Arbeit ohne Rückgriff auf den langen bisherigen Chat fortzusetzen und dabei insbesondere verhindern, dass:
- bereits getroffene Entscheidungen erneut diskutiert werden,
@@ -0,0 +1,229 @@
---
title: "Kanshō – Implementation Foundation"
status: "Baseline / verbindliche Implementierungsleitplanke"
date: "2026-08-21"
product_family: "Jinkendo"
document_role: "Kompakte Leitplanke zwischen fachlichem Zielmodell und vertikaler Implementierung"
---
# Kanshō – Implementation Foundation
## 1. Zweck
Dieses Dokument ist **nicht** die vollständige Kanshō-Spezifikation.
Es enthält nur die Architekturregeln, die ein Implementierungsagent kennen muss, damit ein kleiner MVP nicht durch frühe Vereinfachungen spätere Kernfähigkeiten verbaut.
Die ausführlichen Fachkapitel bleiben Source of Truth für das Zielmodell. Sie sind **Referenz**, aber kein Auftrag, alle dort beschriebenen Fähigkeiten jetzt zu implementieren.
Code-Stand und Abgleich gegen diese Foundation plus `mvp.md` und das Gesamtziel: `mvp_stand_und_abgleich.md` (2026-08-25). Dieses Dokument ersetzt die Foundation nicht.
Leitgedanke:
> **Groß genug denken, um teure Sackgassen zu vermeiden. Klein genug bauen, um früh ein real nutzbares Produkt zu erhalten.**
Für jeden Implementierungsschritt gilt:
> **Implementiere nur den aktuellen Slice. Respektiere dabei die Foundation. Baue das Target Model nicht vorsorglich vor.**
---
## 2. Verbindliche Core-Regeln
### Datenhoheit und Historie
1. **Original Source bleibt kanonisch.**
User Messages, AI Messages und relevante Originaleingaben werden verlässlich erhalten.
2. **Derived ersetzt Source nie.**
Summaries, Insights, Memories, Patterns oder andere Ableitungen dürfen Originalquellen nicht überschreiben oder ersetzen.
3. **Stabile Identitäten von Anfang an.**
Sessions, Messages und die im jeweiligen Slice tatsächlich benötigten langlebigen Fachobjekte erhalten stabile IDs.
4. **Zeit und Provenance sind Core-Daten.**
Relevante Quellen und Ableitungen müssen auf Ursprung und Zeitpunkt zurückführbar sein.
5. **Current Validity und History sind getrennt.**
Eine neue Sicht, Korrektur oder Neubewertung darf einen früheren fachlich relevanten Zustand nicht unkenntlich machen.
6. **User Correction hat Vorrang vor Modellinferenz.**
Eine korrigierte Ableitung darf nicht weiter stillschweigend als aktuelle Wahrheit verwendet werden.
### KI-Ableitungen und persönliches Modell
7. **AI Hypothesis ist kein User Fact.**
Eine vom Modell erzeugte Interpretation wird nicht automatisch zu bestätigtem persönlichem Wissen.
8. **Current expressed state ist kein stabiles Self Model.**
Zeitgebundene Emotionen, Bewertungen oder spontane Selbstbeschreibungen werden nicht automatisch als dauerhafte Identitätsaussagen behandelt.
9. **Model proposes; policy decides; source preserves.**
Das Hauptmodell darf Signale oder Kandidaten liefern; die Anwendung entscheidet über Writes und spätere Promotion.
### Reflection Context
10. **Reflection Space ist ein Bedeutungs- und Kontextobjekt, kein bloßer Ordner.**
11. **Primary und Related Spaces müssen architektonisch möglich bleiben.**
Related Spaces müssen im ersten MVP nicht zwingend sichtbar oder vollständig automatisiert sein.
12. **Assignment ist nicht Identity.**
Mehrfachzuordnung erzeugt keine Kopie desselben fachlichen Objekts.
13. **Existing before new.**
Bestehende langlebige Strukturen werden bevorzugt angereichert, bevor neue erzeugt werden.
### Context und Retrieval
14. **Reflection Space first, Long-Term Memory on demand.**
Der normale Dialog beginnt im aktuellen Reflexionskontext, nicht mit globaler autobiografischer Suche.
15. **Context Builder ist eine eigene Verantwortlichkeit.**
Kontextselektion darf nicht unkontrolliert über Prompts, UI-Komponenten und Featurecode verteilt werden.
16. **Minimum sufficient context.**
Aktiviert wird nur der kleinste ausreichend relevante Kontext für den nächsten sinnvollen Reflexionsschritt.
17. **Retrieval ist Hilfsstruktur, nicht Source of Truth.**
Suchindizes, Embeddings und ähnliche Strukturen müssen austauschbar beziehungsweise rebuildable bleiben.
18. **Provider State ist Optimierung, nicht Memory Ownership.**
Langfristige Dialog- und Memory-Kontinuität bleibt unter Kontrolle von Kanshō.
### Verarbeitung und Erweiterbarkeit
19. **Ein wesentlicher generativer Hauptmodell-Call pro Turn ist der Normalfall.**
Zusätzliche Modellaufrufe sind begründete Ausnahme- oder Enrichment-Pfade.
**Umsetzung:** Der Dialogzug hat einen maskierten Modell-Call (Operation + Impuls). Der Journalentwurf ist ein zweiter, ausdrücklich getrennter Call. Maskierung entscheidet keine Operation. Erzählregister wird lokal gesetzt.
20. **Write Evaluation ist signal-driven, nicht exhaustive.**
Nicht jede Message löst die vollständige Analyse aller möglichen Memory-, Pattern- oder Self-Model-Objekte aus.
21. **Variable Policies nicht quer im Code hardcoden.**
Änderbare Write-, Promotion- oder Routing-Entscheidungen erhalten eine klar erkennbare zentrale Decision-/Policy-Grenze. Eine umfassende Policy Engine ist dafür im MVP nicht erforderlich.
22. **Interne Reichhaltigkeit rechtfertigt keine komplexe UI.**
Die sichtbare Oberfläche bleibt deutlich einfacher als das mögliche interne Zielmodell.
23. **Neue Abstraktionen brauchen aktuellen Nutzen.**
Eine Target Capability wird nicht allein deshalb implementiert, weil sie im Fachkonzept beschrieben ist.
24. **Nicht implementiert ist ein zulässiger Zustand.**
Spätere Fähigkeiten bleiben bewusst offen, solange der aktuelle Entwurf ihre spätere Ergänzung nicht strukturell verbaut.
---
## 3. Foundation Cut vor dem ersten vertikalen Slice
Vor dem ersten echten Produkt-Slice müssen nur die Strukturen vorhanden oder verbindlich entschieden sein, deren spätere Änderung eine teure grundlegende Refaktierung verursachen würde.
### Muss vorhanden sein
- persistente Session- und Message-Quellen,
- stabile IDs,
- Zeitbezug und grundlegende Provenance,
- klare Trennung `Source` / `Derived`,
- Reflection-Space-Grundmodell mit stabiler Identität,
- Primary-Space-Zuordnung,
- Datenmodell darf Related Spaces später zulassen,
- einfache Current-State-/History-Fähigkeit für bereits verwendete veränderliche Objekte,
- Nutzerkorrektur muss Current Validity beeinflussen können,
- zentrale Context-Builder-Schnittstelle,
- austauschbare Retrieval-Schnittstelle,
- Provider-Abstraktion,
- kleine zentrale Write-/Decision-Policy-Grenze.
### Nur bauen, wenn der erste Slice es wirklich benötigt
- Thread,
- Open Question,
- Insight,
- Experience Candidate,
- sichtbare Related Spaces,
- automatische Space-Erkennung,
- semantisches Retrieval,
- Session Summary,
- zusätzliche Enrichment-Verarbeitung.
Das Datenmodell darf diese Fähigkeiten später zulassen; sie müssen nicht vorsorglich funktionsfähig gebaut werden.
---
## 4. Explizite Non-Goals vor dem ersten MVP
Folgende Target Capabilities sind **kein Foundation-Auftrag**:
- vollständiger Reflection Graph,
- Graphdatenbank allein wegen des Reflection-Graph-Konzepts,
- automatische langfristige Pattern-Erkennung,
- ausgereiftes Self Model,
- Landmark-Experience-Engine,
- adaptive Policy- oder Threshold-Learning-Engine,
- automatische komplexe Space-Merges,
- vollständige mindnet-Synchronisation,
- komplexe Resurfacing Engine,
- longitudinale Persönlichkeitsanalyse,
- elf technische Intent Engines,
- umfangreiche Admin-/Governance-Oberfläche,
- Graphvisualisierung,
- komplexe Dashboard-Landschaft.
Ein Coding-Agent darf diese Funktionen nicht vorsorglich implementieren, wenn sie nicht Bestandteil eines ausdrücklich freigegebenen Slices sind.
---
## 5. Arbeitsregel für Coding-Agenten
Vor einer neuen Core-Abstraktion sind drei Fragen zu beantworten:
1. **Braucht der aktuelle Slice diese Abstraktion jetzt?**
2. **Würde ein späteres Nachrüsten ohne diese Vorbereitung eine grundlegende Refaktierung der bereits kanonischen Daten oder Verantwortlichkeiten erzwingen?**
3. **Ist die vorgeschlagene Lösung mit den Core-Regeln dieses Dokuments vereinbar?**
Wenn 1 und 2 beide mit **Nein** beantwortet werden, wird die Abstraktion nicht vorgebaut.
Wenn eine Entscheidung eine Foundation-Regel berührt oder unklar ist, wird gezielt das betreffende Fachkapitel unter `docs/architecture/functional/` konsultiert. Es sollen nicht vorsorglich sämtliche Kanshō-Dokumente in jeden Coding-Kontext geladen werden.
---
## 6. Iterationsprinzip
Die bevorzugte Entwicklung ist vertikal:
> **Foundation → kleiner real nutzbarer Slice → echte Nutzung → Abgleich mit Zielarchitektur → kleinste notwendige Erweiterung**
Das Ziel ist nicht, vor dem ersten Release die gesamte Kanshō-Intelligenz zu implementieren.
Das Ziel ist, **jede kleine Version bereits auf einer Foundation aufzubauen, die die bekannten teuren Sackgassen vermeidet**.
---
## 7. Rolle der Nutzungssituationen / Intents
Die bisher beschriebenen Nutzungssituationen bleiben wertvolle fachliche Szenarien.
Sie sind jedoch:
- kein Critical-Path-Gate für den ersten MVP,
- keine Verpflichtung zu elf technischen Betriebsmodi,
- kein Grund, vor dem ersten Slice eine universelle Intent Engine zu bauen.
Sie dienen später insbesondere als:
- UX-Szenarien,
- Acceptance Cases,
- Architektur-Validierung,
- Testkatalog für neue vertikale Slices.
---
## 8. Nächster Schritt
Nach dieser Foundation wird der erste vertikale MVP-Slice separat spezifiziert.
Aktuell bevorzugter Kandidat:
> **Journal / Daily Reflection als bewusst einfache Day-One-artige Keimzelle auf Kanshō-Foundations.**
Die konkrete Nutzeranwendung, UX, Datenflüsse, In-/Out-of-Scope-Funktionen und Acceptance Criteria gehören in die MVP-Spezifikation und nicht in dieses Dokument.
+951
View File
@@ -0,0 +1,951 @@
---
title: "Kanshō – MVP"
status: "MVP-Spezifikation / freigegebener erster vertikaler Slice"
date: "2026-08-21"
product_family: "Jinkendo"
document_role: "Konkrete MVP-Spezifikation auf Basis der Implementation Foundation"
---
# Kanshō – MVP
## 1. Zweck und Scope
Dieses Dokument spezifiziert den **ersten vertikalen, real nutzbaren Kanshō-Slice**.
Der MVP ist bewusst kleiner als das vollständige Kanshō-Zielmodell. Er soll:
- früh real nutzbar sein,
- die Implementation Foundation respektieren,
- keine später teuren strukturellen Sackgassen erzeugen,
- aber nicht vorsorglich das gesamte Target Model implementieren.
Leitgedanke:
> **Ein dialoggeführtes persönliches Tagebuch, bei dem Kanshō aus dem Gespräch über einen Tag einen Tagebucheintrag im Stil und möglichst mit den Worten des Nutzers erzeugt.**
Der Nutzer kann den erzeugten Eintrag anschließend redigieren, mit Medien anreichern und später chronologisch wiederfinden.
Der besondere Kanshō-Mehrwert gegenüber einem klassischen Journal ist:
> **Der Dialog berücksichtigt den bereits erzählten Tagesverlauf, den aktuellen Reflection Space, relevante frühere Aussagen und die typische Erzählweise des Nutzers, sodass die Gesprächsführung nicht auf generischen Standardfragen basiert.**
---
# 2. Produktversprechen des MVP
Der MVP unterstützt den folgenden Kernablauf:
> **Erzählen → Reflektieren → Tagebucheintrag generieren → redigieren → bewahren → später wiederfinden**
Dabei bleibt der Dialog die primäre Erfassungs- und Reflexionsform.
Der erzeugte Tagebucheintrag ist eine aus dem Dialog abgeleitete, lesbare autobiografische Darstellung.
---
# 3. Sichtbare fachliche Einheiten
## 3.1 Reflection Space
Ein Reflection Space bildet den übergeordneten Kontext.
Beispiele:
- `Lošinj 2026`
- `Kleinwalsertal 2026`
- `Alltag`
Für den MVP ist ein Reflection Space sichtbar und auswählbar.
Ein Reflection Space kann mehrere Journal Days und Journal Entries enthalten.
Reflection Spaces werden im MVP nicht als komplexe Graph- oder Wissensstruktur dargestellt.
### MVP-Funktionen
Der Nutzer kann:
- Reflection Space erstellen,
- Reflection Space umbenennen,
- Reflection Space auswählen,
- chronologische Journal Entries dieses Spaces anzeigen.
---
## 3.2 Journal Day
Der Journal Day ist die **chronologische Bezugseinheit eines Tages**.
Beispiel:
> Donnerstag, 20. August 2026
Wichtig:
> **Journal Day ist nicht Thread.**
Ein Journal Day beschreibt den Tag, über den erzählt wird.
Der Zeitpunkt des Dialogs kann davon abweichen.
Beispiel:
- Journal Day: `2026-08-20`
- Dialogfortsetzung: `2026-08-21 07:15`
Damit kann der Nutzer einen Tag am selben Abend, in mehreren Phasen oder am Folgetag ergänzen.
---
## 3.3 Dialog / Source
Der Originaldialog ist die primäre Quelle.
Er enthält insbesondere:
- User Messages,
- AI Messages,
- Session-/Message-Zeitpunkte,
- Bezug zum Journal Day,
- Bezug zum Reflection Space,
- gegebenenfalls Medien oder weitere Quellen.
Der Originaldialog bleibt erhalten und wird durch generierte Journaltexte nicht ersetzt.
Der Nutzer kann ein Gespräch ausdrücklich aus dem Tag entfernen. Das löscht diese Dialogquelle, nicht einen bereits bewahrten Journal Entry. Eine Zusammenführung mehrerer Gespräche wird nur im Moment der Generierung angeboten, nicht als Dauerzustand auf der Seite.
---
## 3.4 Journal Draft
Ein Journal Draft ist eine von Kanshō aus dem relevanten Dialog erzeugte Fassung.
Er ist:
- Derived,
- noch nicht automatisch die kanonische Nutzerfassung,
- veränderbar,
- erneut generierbar.
Ein neuer Draft darf eine bereits gespeicherte Nutzerfassung nicht stillschweigend überschreiben.
---
## 3.5 Journal Entry
Ein Journal Entry entsteht, sobald der Nutzer eine erzeugte oder bearbeitete Fassung als Tagebucheintrag übernimmt beziehungsweise speichert.
Der Journal Entry:
- besitzt stabile Identität,
- gehört zu einem Reflection Space,
- besitzt einen Journal Day,
- besitzt eine Versionshistorie,
- kann Medien enthalten,
- verweist auf seine zugrunde liegenden Quellen/Dialoge.
Ein Journal Entry bleibt später bearbeitbar.
---
# 4. Mehrere Dialoge am selben Tag
## 4.1 Mehrere Dialogphasen im selben Reflection Space
Mehrere zeitlich getrennte Dialoge können denselben Journal Day betreffen.
Beispiel:
- morgens erste Erzählung,
- abends Fortsetzung,
- am Folgetag Ergänzung.
Sie müssen nicht automatisch einen einzigen Dialogthread bilden.
### Konsolidierungsregel
Wenn mehrere Dialogverläufe:
- dieselbe oder sehr ähnliche Erzählweise besitzen,
- denselben narrativen Typ besitzen,
- vergleichbare Tiefe besitzen,
- inhaltlich eng zusammengehören,
kann Kanshō eine **Konsolidierung zu einem gemeinsamen Tagebucheintrag anbieten**.
Beispiel:
- chronologischer Bericht morgens,
- chronologische Fortsetzung abends.
### Getrennt lassen
Wenn Dialogverläufe deutlich unterschiedliche:
- Tiefen,
- Fokusse,
- Erzählweisen,
- Reflexionsmodi
besitzen, bleiben sie standardmäßig getrennt.
Beispiel:
- chronologischer Urlaubsbericht,
- separate tiefe emotionale Selbstreflexion.
### Verbindliche Regel
> **Konsolidierung wird angeboten, nicht erzwungen.**
---
## 4.2 Gleicher Tag in unterschiedlichen Reflection Spaces
Dialoge oder Journal Entries desselben Kalendertags in unterschiedlichen Reflection Spaces bleiben im MVP **standardmäßig getrennt**.
Beispiel:
- `Lošinj 2026` → chronologischer Urlaubstag
- `Meditationsreise` → tiefe Reflexion über eine Meditation am selben Tag
Eine gemeinsame Quelle oder dasselbe Erlebnis darf später referenziell verbunden werden, ohne die beiden Journal-Kontexte automatisch zusammenzuführen.
---
# 5. Dialogführung
## 5.1 Ziel
Kanshō führt keinen Tagebuch-Fragebogen.
Die Gesprächsführung soll sich wie ein **kontextsensitiver Reflexionspartner** anfühlen.
Der nächste Gesprächsimpuls entsteht aus:
- dem bereits erzählten Teil des Journal Day,
- der aktuellen Erzählweise,
- relevanten früheren Aussagen im Reflection Space,
- bekannten Plänen und Erwartungen,
- wiederkehrenden Aktivitäten,
- auffälligen Veränderungen,
- emotionalen Signalen,
- narrativen Lücken,
- der typischen Erzählweise des Nutzers.
MVP-Umsetzung des Space-Kontexts: keine Content Memory, sondern die letzten gespeicherten Journal Entries desselben Spaces als Recency-Ausschnitte. Der laufende Journal Day bleibt die führende Quelle des Impulses.
---
## 5.2 Allgemeine Dialogoperationen
Für den MVP werden keine Intent-Graphen oder elf technischen Dialogmodi gebaut.
Kanshō kann stattdessen wenige allgemeine Dialogoperationen verwenden:
1. **Fortführen**
Den aktuellen Erzählfluss sinnvoll weiterführen.
2. **Konkretisieren**
Relevante fehlende Person-, Orts-, Zeit- oder Zusammenhangsinformation klären.
3. **Plan oder Erwartung aufgreifen**
Bekannte Vorhaben zeitlich passend vor oder nach dem Ereignis aufgreifen.
4. **Abweichung erkunden**
Eine relevante Veränderung gegenüber bisherigem Verlauf oder wiederkehrender Aktivität vorsichtig ansprechen.
5. **Erleben vertiefen**
Emotion, Wahrnehmung oder persönliche Wirkung aufgreifen, wenn der Nutzer selbst entsprechende Signale setzt.
6. **Bedeutung erkunden**
Einen erkennbar bedeutsamen Punkt weiterführen, ohne künstlich Tiefe zu erzwingen.
Diese Operationen sind keine getrennten Nutzungsmodi.
---
## 5.3 Auswahl-Policy für Folgeimpulse
Kanshō soll den Gesprächsimpuls wählen, der:
> **den aktuellen Erzählmodus respektiert und zugleich den höchsten zusätzlichen autobiografischen oder reflexiven Wert besitzt.**
Dabei gelten für den MVP folgende Regeln:
1. Erzählfluss respektieren.
2. Bei ausführlichem Erzählen wenig unterbrechen.
3. Pro Antwort höchstens einen dominanten Anschlussimpuls setzen.
4. Lokal an das zuletzt Erzählte anschließen.
5. Nicht redundant fragen und nicht nacherzählen: schon Gesagtes nicht als Impuls umformulieren.
6. Starke emotionale oder bedeutungsvolle Signale bevorzugen, wenn der Nutzer selbst diese Ebene geöffnet hat.
7. Bekannte Pläne und Erwartungen zeitlich passend aufgreifen.
8. Relevante Abweichungen vorsichtig formulieren.
9. **Nicht erwähnt bedeutet nicht nicht geschehen.**
10. Ein unspektakulärer Tag darf unspektakulär bleiben.
11. Nicht jede Antwort muss eine Frage enthalten.
12. Generische Standardfragen sind nur Fallback.
13. Bei hoher Erzählaktivität begleitet Kanshō stärker, statt den Nutzer zu interviewen.
14. Ein starker emotionaler oder narrativer Wendepunkt darf einen rein chronologischen Anschluss überstimmen.
15. Bereits ausdrücklich beantwortete emotionale Informationen werden nicht erneut trivial abgefragt; Kanshō kann stattdessen Ursache, Bedeutung oder Spannung vertiefen.
16. Wenn der Nutzer den Tag oder die Szene selbst schließt, hält Kanshō den Schluss. Keine neue Frage, keinen Tagesbogen nacherzählen.
### 5.3.1 Internes Register (MVP-Umsetzung)
Ein zweites generatives Modell nur für Ton und Erzählmodus ist nicht der MVP-Weg. Kanshō bestimmt Dichte, Plan, Erleben und Schluss lokal (`register_hint`) und gibt sie zusammen mit einem Writing-Profile-Hinweis in denselben Dialog-Prompt. Die sichtbaren Operationen bleiben die sechs allgemeinen; keine Intent-Engines.
Die Stimme ist die eines Vertrauten im natürlichen Gesprächsfluss, nicht die einer Maschine, eines Interviewprotokolls oder einer App. Interne Register- und Operationsworte gehören nicht in den Impuls. Für die Tagesreflexion: ein kurzer Impuls zum nächsten Gedanken und abgeleitete Denkanstöße sind erwünscht. Nacherzählen nur bei Widerspruch oder Logikbruch, um ihn zu klären. Lokale Wächter greifen bei erfundenem Vollzug, erfundener Empfindung, bei Nacherzählen ohne solchen Bruch (auch als Zusammenfassung plus Anschlussfrage), bei Systemfloskeln und bei Frage beziehungsweise Tagesbogen nach einem selbst gesetzten Schluss – nicht bei einer knappen Anschlussfrage ohne Zusammenfassung. Wenn der Impuls lokal ersetzt wird, lädt Kanshō zur Fortsetzung ein („Ich bin gespannt, wie es weitergeht.“ / „Erzähl bitte weiter.“), statt Anwesenheit zu melden; bei selbst gesetztem Schluss bleibt der Schluss.
### 5.3.2 Drei Schichten (MVP, später wiederverwendbar)
Maskierung, Dialogzug und Journalentwurf sind getrennte Verantwortungen. „Detect“ entscheidet keine Operation. „Generate“ meint im Produkt den Journalentwurf, nicht den Dialogzug.
| Schicht | Aufgabe | Aufruf |
|---|---|---|
| Maskierung | nur schützenswerte Muster (Namen, benannte Orte) | Muster + Wörterbuch; Testphase: OpenRouter-Detect; Produktivziel: lokal / Ollama |
| Dialogzug | eine Operation + ein Impuls, Ton und Tiefe | ein maskierter Modell-Call (`mvp.dialogue_turn`) |
| Journalentwurf | Tagebuchtext aus den Worten der Person | zweiter maskierter Call, nur explizit (`mvp.journal_generate`) |
Die Maskierung gilt unabhängig vom späteren Dialogtyp. Neue Dialoge bekommen eigene Prompts, nicht eine zweite Maskierungs-Logik.
Es gibt keinen dritten Call, der nach der Operation noch einmal antwortet. Intern in der Testspur ist die lokale Klartext-Vorlage des Dialogzugs, nicht ein eigener KI-Call. Egress ist dieselbe Vorlage, maskiert. Die sichtbare Kanshō-Zeile ist das Feld `impulse` aus diesem einen Dialogzug. In der Testphase darf Detect Klartext über OpenRouter sehen; das ist ein bewusster Übergang, nicht der Produktivpfad.
---
## 5.4 Beispiel: bekannter Tagesplan
Wenn am Vortag im selben Reflection Space festgehalten wurde:
> „Morgen wollen wir nach Cres fahren.“
kann Kanshō abhängig vom Zeitpunkt beispielsweise fragen:
### Vor dem Ereignis
> „Heute steht doch eure Fahrt nach Cres an. Seid ihr schon bei den Vorbereitungen?“
oder bei vorher erkennbarer emotionaler Spannung:
> „Heute ist eure Fahrt nach Cres. Gestern klangst du gleichzeitig gespannt und etwas nervös – wie fühlt es sich jetzt an?“
### Nach dem Ereignis
> „Heute stand doch eure Fahrt nach Cres an. Wie war sie schließlich?“
---
## 5.5 Beispiel: wiederkehrende Aktivität
Wenn in mehreren bisherigen Morgenbeschreibungen desselben Reflection Space Japanischlernen vorkam und es heute bisher nicht erwähnt wurde, darf Kanshō dies vorsichtig aufgreifen.
Geeignet:
> „Die letzten Tage hast du morgens häufig Japanisch gelernt. Heute ist es bisher noch nicht zur Sprache gekommen. War der Morgen heute anders oder ist es nur noch nicht erwähnt worden?“
Nicht geeignet:
> „Warum hast du heute kein Japanisch gelernt?“
---
## 5.6 Beispiel: emotionaler Bericht
Wenn der Nutzer sagt:
> „Ich war erst richtig sauer und habe dann gemerkt, dass ich eigentlich eher enttäuscht war.“
soll Kanshō nicht erneut trivial fragen:
> „Wie hast du dich gefühlt?“
Sinnvoller kann sein:
> „Was war für dich enttäuschender – das konkrete Verhalten oder dass du in diesem Moment etwas anderes erwartet hattest?“
---
# 6. Start eines Journal-Dialogs
Ein neuer Journal-Dialog beginnt nicht zwingend mit:
> „Erzähl mir von deinem Tag.“
Wenn relevanter Kontext verfügbar ist, soll Kanshō daraus einen sinnvolleren Einstieg erzeugen.
Mögliche Kontextquellen:
- bereits bekannte Tagespläne,
- vorher angekündigte Ereignisse,
- laufende Erzählung desselben Journal Day,
- relevante wiederkehrende Aktivitäten im Reflection Space,
- offene narrative Punkte.
Nur wenn kein sinnvoller Kontext verfügbar ist, wird ein neutraler Einstieg verwendet.
Der erste Gesprächsimpuls unterliegt derselben Dialog-Policy wie spätere Folgeimpulse.
---
# 7. Unterbrechen und Fortsetzen
Der Nutzer kann einen Journal-Dialog jederzeit unterbrechen.
Beim späteren Öffnen desselben Journal Day berücksichtigt Kanshō:
- was bereits erzählt wurde,
- welche Abschnitte des Tages schon abgedeckt sind,
- relevante offene narrative Punkte,
- gegebenenfalls inzwischen zeitlich eingetretene geplante Ereignisse.
Eine Fortsetzung am Folgetag bleibt dem ursprünglichen Journal Day zugeordnet, sofern der Nutzer über diesen Tag weitererzählt.
---
# 8. Generierung des Tagebucheintrags
## 8.1 Nutzersteuerung
Die Erzeugung eines Journal Draft erfolgt im MVP **explizit durch den Nutzer**.
Beispiel:
> **Tagebucheintrag generieren**
Kanshō generiert nicht automatisch nach jeder Session einen fertigen Tagebuchtext.
---
## 8.2 Eingaben für die Generierung
Für die Generierung dürfen verwendet werden:
1. die relevanten Originaldialoge des Journal Day, einschließlich der Kanshō-Impulse als Gesprächskontext (nicht als Erlebtes),
2. der aktuelle Reflection-Space-Kontext, soweit er für Verständnis und Kohärenz nötig ist,
3. das Writing Profile,
4. gegebenenfalls ausgewählte eigene Stilbeispiele,
5. bei einer Aktualisierung ein bereits bestehender Draft oder Journal Entry, sofern dies explizit Teil des gewünschten Vorgangs ist.
Im MVP ist der Space-Kontext im Dialogzug die letzten gespeicherten Journal Entries desselben Spaces als kurze Recency-Ausschnitte, keine inhaltliche Space-Memory (keine Threads, keine wiederkehrenden Aktivitäten, keine Relevanzauswahl). Für den laufenden Tag ist der Dialog des Journal Day die führende Quelle. Ein Space Content Memory bleibt später.
---
## 8.3 Generierungsprinzip
Priorität:
> **Eigene Formulierungen des Nutzers erhalten → sprachlich verbinden → Struktur verbessern → Writing Profile anwenden.**
Kanshō soll nicht zuerst den Inhalt abstrakt extrahieren und anschließend vollständig in generischem KI-Stil neu schreiben.
Ein leeres oder nur aus Formhinweisen bestehendes Writing Profile rechtfertigt kein bloßes Durchreichen des Dialogs. Verbinden, Glätten, Absätze und eine Überschrift bleiben Pflicht. Der Quelldialog des zu erzeugenden Tages wird nicht ein zweites Mal als Stil-Exzerpt in den Brief gelegt.
Wenn das Modell den Dialog trotzdem nur durchreicht (gleicher Wortlaut, ein Block), formt eine lokale Nachbereitung Absätze an Phasengrenzen. Sie ändert den Wortlaut nicht und erfindet nichts. Wiederholte Personennamen in einer Passage (nach Demaskierung) werden lokal auf ein- bis zwei Nennungen plus Pronomen zurückgeführt, anhand der Pronomen im user-Text; indirekte Rede wird nicht in den Namen zurückgebogen.
Wenn das Writing Profile substanzielle finale Fassungen oder Importe enthält, kommt die **Formulierung** aus dieser Stimme, der **Inhalt** weiter nur aus den user-Zeilen. Kurze oder stichwortartige Passagen dürfen zu ganzen Sätzen ausformuliert werden; es werden keine Fakten, Gefühle oder Zeiten erfunden. Fehlt das Profile, bleiben Verbinden und Glätten der user-Formulierungen der Weg.
Kanshō-Zeilen im Quelldialog erklären, worauf eine user-Zeile antwortet. Sie werden nicht als Geschehen in den Eintrag übernommen.
### Kanshō darf
- Wiederholungen reduzieren,
- fragmentierte Erzählteile und denselben Erzählstrang verbinden,
- Uhrzeiten und zeitliche Anschlüsse aus dem Gesagten zusammenführen, ohne Zeiten zu erfinden,
- Grammatik und Lesbarkeit glätten,
- chronologische Struktur verbessern,
- sinnvolle Absätze bilden,
- eine Überschrift vorschlagen,
- vom Nutzer selbst eingeführte Reflexionen sinnvoll integrieren.
### Kanshō darf nicht
- Ereignisse erfinden,
- fehlende Details plausibel auffüllen,
- nicht geäußerte Gefühle hinzufügen,
- Motivationen erfinden,
- Unsicherheit in Gewissheit umwandeln,
- den Ton unnötig dramatisieren,
- den Nutzertext in einen generischen KI-Schreibstil überführen,
- Kanshō-Impulse als Geschehen in den Eintrag schreiben,
- Pronomen durch ständige Wiederholung des Namens ersetzen,
- in der indirekten Rede den Namen einsetzen, wo die Person von sich als sie/er spricht.
---
# 9. Writing Profile im MVP
## 9.1 Ziel
Der generierte Journal Entry soll sich zunehmend wie ein eigener Text des Nutzers lesen.
Das Writing Profile darf aus mehreren Quellen entstehen.
### Quellenpriorität
1. **vom Nutzer final redigierte Journal Entries**
2. **vom Nutzer ausdrücklich importierte eigene frühere Texte**
3. **charakteristische Formulierungen und Erzählmerkmale aus dem Dialog**
4. **KI-generierter Draft**
Der KI-generierte Draft ist **keine positive Stilreferenz**, solange er nicht durch den Nutzer als eigene Fassung übernommen beziehungsweise redigiert wurde.
Verbindliche Regel:
> **Finale Nutzerfassungen sind die stärkste Stilquelle. KI-Text darf nicht unbeaufsichtigt auf sich selbst zurücklernen.**
---
## 9.2 Initialisierung
Der Nutzer kann vorhandene eigene Texte bereitstellen.
Diese dienen als Bootstrap-Material für ein erstes Writing Profile.
Der Nutzer muss jedoch nicht zwingend Alttexte importieren.
Ohne Import kann sich das Writing Profile schrittweise aus:
- Dialogstil,
- ersten Journal Entries,
- Nutzerkorrekturen
entwickeln.
---
## 9.3 Lernsignale
Für den MVP können insbesondere berücksichtigt werden:
- bevorzugter Detailgrad,
- chronologische versus stärker thematische Erzählweise,
- typische Satzlänge,
- Grad emotionaler Reflexion,
- Humor und Witz,
- Umgang mit Namen,
- Nutzung von Uhrzeiten und konkreten Details,
- typische Übergänge,
- Wortwahl,
- Verhältnis von sachlicher Beschreibung und Reflexion.
Eine vollständige Persönlichkeitsmodellierung ist dafür nicht erforderlich.
## 9.4 Implementierungsstand
**Status: Code vorhanden (2026-08-25).**
Der Current Brief wird lokal zusammengesetzt, ohne zusätzlichen Modell-Call:
1. Erzählmerkmale als lokale Heuristik aus Nutzertext (Satzlänge, Chronologie, Uhrzeiten, Reflexionsanteil, Humor). Keine Diagnose, kein Self Model.
2. Exzerpte finaler Journal Entries, dann Importe, dann charakteristische `user:`-Zeilen.
3. Ein rollierender `dialogue_style`-Eintrag pro Profil, nach jedem Dialogzug aktualisiert. Vor der Journalgenerierung werden die Quellgespräche dieses Entwurfs aus den Stil-Exzerpten ausgenommen; Formhinweise aus demselben Text dürfen bleiben. Sobald finale Journal Entries existieren, gehen Dialog-Exzerpte nicht mehr in den Brief; sie bleiben höchstens ein Hinweis.
4. Der Dialogzug selbst erhält nur die Formhinweise (Erzählmerkmale), keine Dialog-Exzerpte anderer Tage und nicht den gerade offenen Turn. Exzerpte bleiben der Journalgenerierung vorbehalten.
5. KI-Drafts bleiben ausgeschlossen.
Finale Nutzerfassungen haben höheres Gewicht (mehr und längere Exzerpte, Stimme vor Dialog). Ohne Import ist der erste Generate-Tag nicht stil-leer (Formhinweise), aber nicht eine zweite Kopie desselben Dialogs.
---
# 10. Journal Editor
Nach der Generierung kann der Nutzer den Journal Draft im Bearbeitungsmodus redigieren.
Der Nutzer kann:
- Text ändern,
- Text ergänzen,
- Passagen löschen,
- Absätze formatieren (Absatz, Überschrift, Zwischenüberschrift, Listen),
- markierte Bereiche formatieren (fett, kursiv, unterstrichen),
- Überschrift des Eintrags ändern,
- Bilder und Videos an der Schreibmarke einbetten und im Fließtext verschieben,
- Zeichnungen beziehungsweise Bilddateien ergänzen,
- Bildunterschriften ergänzen.
Der Eintrag wird im Fließtext redigiert und als Markdown gespeichert. Medien liegen als lokale Dateien in `media_assets`; im Text stehen Referenzen `![Unterschrift](kansho-media:<id>)`. Alte Marker `[[media:<id>|…]]` werden beim Speichern nach Markdown überführt. Referenzen gehen nicht an externe Modelle. Unterschriften zählen als Nutzerwortlaut.
Bilder (JPEG, PNG, GIF, WebP) und einzelne Videos (MP4, WebM, MOV) werden im Editor direkt dargestellt. Dateien verlassen die Local Trusted Zone nicht.
Nicht Bestandteil des MVP:
- komplexe Audioverwaltung,
- Videobibliothek oder Schnitt,
- Dokumentarchive,
- Karten-/GPS-Timelines.
Einzelne, vom Nutzer eingebettete Videos im Journaltext sind damit Teil des Slices; eine Videoverwaltung ist es nicht.
---
## 10.1 Tagesstichpunkte (Arbeitsstand)
Während der Tagesreflexion kann der Mensch eine kurze Stichpunktliste **parallel** zum Dialog führen: sich nicht verlieren, Inhalte nicht vergessen, abhaken wenn erzählt.
Das ist **kein** Aufgabenmanager und **keine** Abschluss-Checkliste. Reflexion bleibt das Gespräch.
**Bevorzugte Richtung (2026-08-24):** Die Liste ist lokal, nur für die Person, Klasse A. Sie geht nicht in Dialogzug, Journalentwurf, Writing Profile oder Recency-Ausschnitte. Return erzeugt eine neue leere Zeile und setzt den Cursor dorthin.
**Offen:** Ob eine spätere, bewusst gewählte und maskierte Nutzung als Gesprächskontext sinnvoll ist. Nicht stillschweigend einschalten. Solange unklar, Fail Closed: kein Egress.
---
# 11. Versionierung und Schutz vor unbeabsichtigter Änderung
## 11.1 Version History
Sobald ein Journal Entry gespeichert wurde, werden spätere gespeicherte Änderungen versioniert.
Beispiel:
- v1 – generierter Draft / erste übernommene Fassung
- v2 – Nutzerredaktion
- v3 – Textkorrektur und Bilder
- v4 – spätere Ergänzung
Frühere gespeicherte Versionen bleiben wiederherstellbar. Die aktuell geladene Fassung darf in der Liste stehen, wird dort aber nicht wiederhergestellt. Offene, noch nicht gespeicherte Editoränderungen können lokal verworfen werden („Alle Änderungen rückgängig machen“). Verlassen des Editors mit solchen Änderungen wird bestätigt, nicht still verworfen.
---
## 11.2 Kein stilles Überschreiben
Kanshō darf eine gespeicherte Nutzerfassung nicht automatisch durch eine neue KI-Fassung ersetzen.
Eine erneute Generierung erzeugt:
- einen neuen Draft,
- oder eine neue vorgeschlagene Version.
Die bestehende Journal-Version bleibt erhalten, bis der Nutzer eine Änderung ausdrücklich übernimmt. Die Oberfläche öffnet den neuen Entwurf (`?draft=1`), nicht still die gespeicherte Fassung. Übernehmen schreibt eine neue Version des bestehenden Entry; Speichern aus dem Entwurf kann auch einen weiteren Entry anlegen.
---
## 11.3 Löschen
Versehntliches endgültiges Löschen soll verhindert werden.
Für den MVP:
- Entfernen eines Journal Entry führt zunächst zu Soft Delete / Papierkorb,
- endgültiges Löschen ist eine separate explizite Aktion,
- Version History schützt zusätzlich vor unbeabsichtigten Textänderungen.
---
# 12. Journal als Nachschlagewerk
## 12.1 MVP-Navigation
Retrieval wird im ersten MVP bewusst klein gehalten.
Der Nutzer erhält primär Navigation statt intelligenter Langzeitsuche.
Mindestens verfügbar:
- chronologische Liste der erzeugten Journal Entries,
- Navigation nach Reflection Space,
- Datum,
- Journal Entry öffnen,
- vom Journal Entry zum zugrunde liegenden Quelldialog wechseln.
---
## 12.2 Nicht im MVP
Noch nicht erforderlich:
- semantische Freitextsuche über die gesamte Biografie,
- Natural-Language-Questions über Jahre,
- Personen- oder Themencluster,
- automatische Jahresrückblicke,
- komplexes Source-oriented Retrieval,
- Graphnavigation.
Die technische Foundation soll späteres Retrieval ermöglichen, ohne es jetzt vollständig zu implementieren.
---
# 13. MVP-Screens
Der MVP soll bewusst wenige sichtbare Bereiche besitzen.
## 13.1 Journal / Reflection Spaces
Zeigt:
- verfügbare Reflection Spaces,
- chronologische Journal Entries des ausgewählten Spaces,
- Möglichkeit, neuen Space anzulegen,
- Möglichkeit, bestehenden Space umzubenennen,
- Möglichkeit, einen Journal Day zu öffnen oder zu starten.
---
## 13.2 Journal Day / Dialog
Zeigt:
- Bezugstag,
- Reflection Space,
- bisherigen Dialog,
- Eingabefeld,
- optionale persönliche Stichpunkte parallel zum Gespräch (nicht KI-Kontext, siehe §10.1),
- Medienoptionen soweit für Dialogquellen nötig,
- Aktion `Tagebucheintrag generieren`,
- vorhandenen Draft-/Entry-Status.
Der Dialog soll sich wie ein natürlicher Chat anfühlen.
---
## 13.3 Journal Editor
Zeigt:
- generierten beziehungsweise gespeicherten Journaltext,
- Überschrift,
- Fließtexteditor mit Absatz- und Auswahlformaten,
- eingebettete Bilder und Videos samt Unterschrift,
- Speichern,
- Versionshistorie,
- gegebenenfalls neue Draft-Fassung übernehmen.
---
## 13.4 Source Dialog
Vom Journal Entry kann der Nutzer auf den zugrunde liegenden Originaldialog wechseln.
Diese Ansicht dient:
- Nachvollziehbarkeit,
- persönlichem Nachlesen,
- Provenance,
- späterem Re-Grounding.
Eine komplexe technische Provenance-UI ist im MVP nicht erforderlich.
---
# 14. Minimaler technischer/fachlicher Datenbedarf des Slices
Die konkrete technische Implementierung bleibt der technischen Architektur vorbehalten.
Der MVP benötigt fachlich mindestens:
- User
- Reflection Space
- Journal Day
- Session / Dialog
- Message / Source
- Journal Draft
- Journal Entry
- Journal Entry Version
- Media Reference
- grundlegende Source References
- Writing Profile beziehungsweise Writing-Style-Kontext
Threads, Open Questions, Experiences und Insights müssen für den ersten Slice nicht als sichtbare oder vollständige produktive Objektmodelle implementiert werden.
---
# 15. MVP Acceptance Cases
## A. Einfacher Journal Day
Der Nutzer führt einen Dialog über seinen Tag.
Er löst `Tagebucheintrag generieren` aus.
Kanshō erstellt einen lesbaren Journal Draft.
Der Nutzer korrigiert einige Formulierungen und speichert den Journal Entry.
**Bestanden, wenn:**
- Originaldialog erhalten bleibt,
- Journal Entry lesbar und quellentreu ist,
- Nutzeränderungen gespeichert werden,
- der Entry chronologisch im Reflection Space erscheint.
---
## B. Mehrphasiger Tag
Der Nutzer:
- erzählt morgens,
- setzt den Dialog abends fort,
- ergänzt am Folgetag noch einen Punkt.
Alle Beiträge beziehen sich auf denselben Journal Day.
**Bestanden, wenn:**
- Journal Day und tatsächliche Message-Zeitpunkte getrennt bleiben,
- alle relevanten Quellen einem Journal Entry zugrunde liegen können,
- genau der gewünschte Tag chronologisch angezeigt wird.
---
## C. Kontextsensitiver Dialog
Ein Tagesplan wurde zuvor im selben Reflection Space erwähnt.
Oder eine Aktivität ist in mehreren vorherigen Tagen wiederholt aufgetreten.
**Bestanden, wenn:**
- Kanshō einen relevanten Plan oder eine relevante Abweichung sinnvoll aufgreifen kann,
- keine generische Standardfrage nötig ist,
- Kanshō `nicht erwähnt` nicht mit `nicht geschehen` verwechselt.
---
## D. Ausführliche Erzählung
Der Nutzer erzählt mehrere Absätze mit hoher Informationsdichte.
**Bestanden, wenn:**
- Kanshō nicht jede Einzelinformation mit einer Frage beantwortet,
- höchstens ein dominanter Folgeimpuls gesetzt wird,
- der Erzählfluss nicht unnötig unterbrochen wird.
---
## E. Emotionaler Abschnitt
Der Nutzer benennt selbst eine emotionale Veränderung oder Bedeutung.
**Bestanden, wenn:**
- Kanshō keine bereits beantwortete triviale Gefühlsfrage wiederholt,
- eine Vertiefung nur erfolgt, wenn sie zum Erzählfluss passt,
- Kanshō keine zusätzliche emotionale Bedeutung erfindet.
---
## F. Unterschiedliche Dialogtypen am selben Tag
Am selben Tag entstehen:
- ein chronologisch-autobiografischer Dialog,
- ein deutlich tieferer emotionaler Reflexionsdialog.
**Bestanden, wenn:**
- Kanshō diese nicht automatisch konsolidiert,
- der Nutzer getrennte Journal Entries beziehungsweise Darstellungen behalten kann.
---
## G. Ähnliche Dialoge am selben Tag
Morgens und abends entstehen zwei chronologisch zusammengehörige Dialogphasen.
**Bestanden, wenn:**
- Kanshō eine Konsolidierung anbieten kann,
- der Nutzer entscheidet,
- keine Konsolidierung erzwungen wird.
---
## H. Unterschiedliche Reflection Spaces
Am selben Tag existieren Inhalte in zwei Reflection Spaces.
**Bestanden, wenn:**
- beide standardmäßig getrennt bleiben,
- keine automatische Zusammenführung allein aufgrund des Datums erfolgt.
---
## I. Persönlicher Stil
Der Nutzer hat eigene frühere Texte importiert und/oder bereits Journal Entries redigiert.
**Bestanden, wenn:**
- finale Nutzerfassungen stärker gewichtet werden als KI-Drafts,
- typische Erzählmerkmale erkennbar berücksichtigt werden,
- eigene Formulierungen aus dem Dialog soweit sinnvoll erhalten bleiben,
- der erzeugte Text nicht in generischen KI-Stil driftet.
---
## J. Versionsschutz
Der Nutzer bearbeitet einen bestehenden Journal Entry mehrfach.
**Bestanden, wenn:**
- frühere gespeicherte Fassungen erhalten bleiben,
- eine frühere Version wiederhergestellt werden kann,
- eine neue KI-Generierung die aktuelle Nutzerfassung nicht stillschweigend überschreibt.
---
## K. Nachschlagen
Der Nutzer möchte einen früheren Urlaubstag wieder ansehen.
**Bestanden, wenn:**
- der Eintrag über Reflection Space und chronologische Liste auffindbar ist,
- er nach Datum geöffnet werden kann,
- vom Entry auf den Quelldialog gewechselt werden kann.
---
# 16. Explizite Non-Goals des MVP
Nicht Bestandteil dieses MVP sind:
- sichtbares Self Model,
- langfristige Pattern-Ansicht,
- Insights-Verwaltung,
- sichtbare Thread-Verwaltung,
- Open-Question-Verwaltung,
- vollständiger Reflection Graph,
- automatische Lebensanalyse,
- Values-Ansicht,
- komplexe Resurfacing Engine,
- mindnet-Frontend,
- elf technische Intent Engines,
- Mood Tracking,
- Habit Tracking,
- Gamification,
- komplexe Dashboards,
- Kalender-/Taskmanagement,
- semantische Langzeitsuche,
- Natural-Language-Biografieabfragen,
- automatische Jahres- oder Lebensrückblicke,
- komplexe Admin-/Governance-Oberfläche,
- automatische langfristige Persönlichkeitsanalyse.
Kanshō darf im Dialog einfache relevante Wiederholungen oder Abweichungen erkennen, ohne daraus bereits ein sichtbares Habit-, Pattern- oder Self-Model-Modul zu machen.
---
# 17. Scope-Freeze
Mit dieser Spezifikation gilt der erste Kanshō-MVP fachlich als ausreichend definiert.
Neue Funktionen werden vor Beginn der Implementierung nur aufgenommen, wenn:
1. sie für einen der beschriebenen Acceptance Cases zwingend erforderlich sind,
2. ihr späteres Nachrüsten sonst eine grundlegende Refaktierung kanonischer Daten oder Verantwortlichkeiten verursachen würde,
3. oder ein echter Widerspruch zur Implementation Foundation entdeckt wird.
Ansonsten gilt:
> **Nicht weiter horizontal konzipieren. Den vertikalen Slice bauen, real nutzen und aus der Nutzung lernen.**
Der nächste Schritt ist die Ableitung eines konkreten technischen Implementierungsplans aus:
- `implementation_foundation.md`
- dieser `mvp.md`
- und nur den jeweils dafür benötigten kanonischen Fachkapiteln.
Der erste vertikale Slice ist im Code vorhanden. Der Abgleich von Code gegen diese Spezifikation, die Foundation und das Gesamtziel steht in `mvp_stand_und_abgleich.md` (2026-08-25). Er ersetzt diese Spezifikation nicht.
@@ -0,0 +1,567 @@
---
title: "Kanshō – MVP-Stand und Abgleich gegen Foundation, Slice und Gesamtziel"
status: "Abgleich / Arbeitsstand"
date: "2026-08-25"
product_family: "Jinkendo"
document_role: "Ist-Stand des ersten vertikalen Slices gegen Implementation Foundation, MVP-Spezifikation und Produktziel; Gaps und Ungenauigkeiten"
parent_document: "mvp.md"
---
# Kanshō – MVP-Stand und Abgleich
**Stand:** 2026-08-25, gegen den lokalen Code unter `frontend/` und `backend/`, inklusive Architecture-Correction-Pass am selben Tag.
Dieses Dokument **ersetzt** weder `mvp.md` noch `implementation_foundation.md` noch `produktvision_und_produktidentitaet.md`. Es sagt, was gebaut ist, was welche Spezifikation verlangt, und wo Doku, Tests oder UI den Code überzeichnen.
Es ist der **Prüfbericht für eine unabhängige Gegenlesung**: Slice gegen freigegebenen MVP-Text, Foundation gegen teure Sackgassen, Code gegen das langfristige Gesamtziel. Der Slice darf das Gesamtziel nicht erfüllen; er darf es nicht verbauen und nicht als schon erreicht verkaufen.
---
# 0. Für den prüfenden Agenten
## 0.1 Auftrag dieses Dokuments
Ein zweiter Agent soll damit prüfen:
1. ob der gebaute Slice zum **Gesamtziel** (Personal Reflection Companion) noch als Keimzelle passt oder schon als Tagebuch-App driftet,
2. ob die **Implementation Foundation** gehalten wird,
3. ob der **freigegebene MVP-Text** in `mvp.md` eingelöst, untererfüllt oder überzeichnet ist,
4. welche Lücken **Slice-Gaps** sind (jetzt schließen oder Spec korrigieren) und welche **Zielmodell-Lücken** (bewusst später).
Nicht Auftrag: das Target Model nachbauen, den Slice horizontal erweitern, oder offene Fachinterviews als Implementierungsauftrag lesen.
## 0.2 Drei Ebenen, nicht vermischen
| Ebene | Quelle | Frage |
|---|---|---|
| **Gesamtziel** | `produktvision_und_produktidentitaet.md`, Guardrails, Memory/Self/Dialog-Kapitel | Wird Kanshō der dialogische Reflexionsraum der Jinkendo-Familie? |
| **Erster Slice** | `mvp.md` + `implementation_foundation.md` | Ist ein dialoggeführtes Journal auf der Foundation real nutzbar, ohne Sackgassen? |
| **Code** | `frontend/`, `backend/` | Was tut die laufende Anwendung tatsächlich? |
Der MVP-Leitgedanke in `mvp.md` §1 ist bewusst kleiner als die Vision: *dialoggeführtes persönliches Tagebuch, Entwurf aus dem Gespräch*. Die Vision in der Produktidentität ist größer: *Wahrnehmen → Reflektieren → Verstehen → Einordnen*, langfristige Kontinuität, Werte, offene Fäden, vorsichtige Zusammenhänge. **Beides ist wahr.** Der Slice ist die Keimzelle, nicht das Produkt.
## 0.3 Was laden (Context Bundle)
Pflicht:
1. dieses Dokument (Fit-Gap)
2. `mvp.md`
3. `implementation_foundation.md`
4. `produktvision_und_produktidentitaet.md` (Identität, Prinzipien, Nicht-Ziele)
5. `guardrails.md` (Invariante Datenschutz)
6. **technische Umsetzung:** `../technical/mvp_implementation.md`
7. Vertiefung: `../technical/privacy_gateway.md` §9.1–9.2, `../technical/memory_storage_and_offline.md` §6.2, `../technical/frontend_pwa_shell.md` §6.1, `../technical/backend_and_api.md` §5.1
Nur bei Bedarf, nicht vorsorglich den ganzen Ordner:
- `writing_profile_and_journaling.md` – Stil und zweistufige Generierung (Ziel, nicht Slice)
- `dialogue_model.md` – Contextual Continuation als Default-IA
- `memory_and_context.md` – Schichten Working / Thread / Episodic
- `reflection_outputs.md` – Journal vs Memory vs Knowledge vs Action
- `integrations.md` – Kairo / mindnet / Obsidian
## 0.4 Was der prüfende Agent nicht tun soll
- Foundation-Regel 24 ignorieren („nicht implementiert ist zulässig“) und fehlendes Self Model, Resurfacing oder mindnet als Slice-Bug werten.
- Recency-Ausschnitte (letzte fünf Entries × 400 Zeichen) als semantisches Gedächtnis oder Space Content Memory lesen.
- Admin-Testspur, Prompt-DB und `/dialog` als produktive Nutzer-IA lesen.
- Acceptance-Tests C/D/E als Beweis für Begleiter-Qualität lesen; sie sind oft Prompt- oder Call-Proxies.
- Detect über OpenRouter als erfüllte Guardrail-Produktivlage lesen; das ist Testphase.
- Empfehlen, das Target Model in diesem Slice vorzubauen.
## 0.5 Statuswörter
| Wort | Bedeutung |
|---|---|
| **Erfüllt** | Anforderung im Code und in der nutzbaren Oberfläche vorhanden |
| **Teilweise** | Kern da, fachliche Schärfe oder UI fehlt |
| **Gap** | Anforderung der jeweiligen Ebene nicht erfüllt |
| **Ungenauigkeit** | Spezifikation, Test oder Kommentar behauptet mehr als der Code leistet |
| **Bewusst offen** | Non-Goal, später, oder Foundation-Regel 24 |
| **Abweichung** | weicht vom technischen Zielrahmen ab, ohne die Foundation zu brechen |
| **Spannung** | Slice und Gesamtziel ziehen auseinander, ohne dass der Slice deshalb falsch ist |
---
# 1. Was der Slice heute ist
Kanshō ist lokal ein dialoggeführtes Journal auf FastAPI + SQLite und einer React/Vite-PWA-Shell.
**Kernablauf, der geht:** Space anlegen → Journal Day öffnen → Dialog führen → Entwurf explizit erzeugen → redigieren, Medien im Text, speichern als neue Version des bestehenden Eintrags (optional eigener Eintrag) → Versionen wiederherstellen oder lokale Edits verwerfen → Quelldialog öffnen. Parallel: lokale Stichpunkte (Checkliste), die Kanshō nicht sieht; Return erzeugt eine neue Zeile und setzt den Cursor dorthin. Ungespeicherte Editoränderungen werden beim Verlassen bestätigt.
**Technische Keimzelle:** Auth-Sessions, Prompt-DB, Platzhalter, Feature-Check, Privacy Gateway, zwei Provider-Rollen (Maskierung / Sprachmodell), Context Builder, Retrieval als SQL-Schnittstelle, Writing Profile ohne Extra-LLM, Pronomenbindung nur im Dialogzug.
**Nicht gebaut und nicht behauptet als gebaut:** Space Content Memory, Threads-UI, semantisches Retrieval, Self Model, Insights, Related Spaces in der Nutzung, Papierkorb-UI, PostgreSQL, lokales Detect-Modell, Voice, Offline-Sync, Obsidian/mindnet/Kairo-Handoff, Contextual Continuation als Start, zweistufige Journalgenerierung.
**Produktidentität im Slice:** der Kern ist *Erzählen → reflektierender Impuls → Journalentwurf*. Das ist eine legitime Keimzelle von „Personal Reflection Companion“, noch kein Begleiter über Monate, keine Wertearbeit, keine offenen Fäden.
---
# 2. Delta seit 2026-08-24
Additiv zum vorigen Abgleich, nicht an seiner Stelle:
| Thema | Änderung im Code | Wirkung auf den Abgleich |
|---|---|---|
| Generate → Entwurf | UI öffnet `?draft=1`, nicht still den gespeicherten Entry | Case J / §11.2 klarer erfüllt |
| Speichern aus Entwurf | Default: neue **Version desselben** Entry (`accepted_draft`); optional eigener Eintrag | Keine stillen Doppel-Entries mehr als Normalpfad |
| Titel | `clean_title` / `entryTitle` entfernen führendes `#` | Editor und Versionen zeigen denselben Titel |
| Versionen-UI | Aktuelle Fassung in der Liste als **Aktuell**, ohne Restore. Bei Dirty: **Alle Änderungen rückgängig machen** (lokal, keine DB-Version) | §11.1 eingelöst |
| Dirty-Flag | Snapshot nach Laden/Speichern; In-App-Navigation, Abmelden, Tab-Schließen fragen nach | Schutz vor stillem Verlust; Browser-Zurück nicht hart blockiert |
| Writing Profile | Finale Entries stärker (mehr/längere Exzerpte); Dialog-Exzerpte entfallen, sobald Entries existieren | §9 Priorität näher am Text |
| Journal-Prompt / Shape | Szenen verbinden, Stimme aus dem Brief; lokale Namensausdünnung nach Demask (`naturalize_person_mentions`) | Qualität modellabhängig, Shape nur lokal |
| Pronomen | Bindung `er`/`sie` nur im **Dialogzug**; Journalentwurf ungebunden, sonst Demask-Klarnamen-Flut | Guardrail-fein, nicht Identity-Mapping |
| Stichpunkte | Return erzeugt leere Folgezeile **und** fokussiert sie; „Punkt hinzufügen“ ebenso | UX von §10.1 |
| `local_hold` | Fallback-Impuls nicht mehr „Ich bin noch da“, sondern Fortsetzungsbitte | Dialogqualität, kein Architekturwechsel |
Historische Doppel-Entries aus der Zeit, als Speichern aus dem Entwurf neue Einträge anlegte, bleiben in der DB getrennt. Das ist Altbestand, kein aktueller Normalpfad.
---
# 2.1 Architecture Correction Pass (2026-08-25)
Additiv zu Abschnitt 2. Kein horizontaler Slice, kein Target-Model-Vorbau. Korrigierter **Ist-Stand** vs. bewusst offene Target-Fähigkeiten:
| Thema | Korrigierter Ist-Stand | Bewusst offen |
|---|---|---|
| Provenance Draft/Version | Relationale `journal_*_source_refs`; JSON-Listen werden verlustfrei migriert. Source unverändert. | Provenance-UI, Re-Grounding |
| Context Selection | Context Builder fordert Specs (`day_messages`, `space_entries`, `space_recent_sources`, `writing_profile`). Recency ist Retrieval-Implementierung, keine fachliche API. | Semantisches Retrieval, Minimum-sufficient nach Relevanz |
| Space-Source im Dialogzug | Begrenzte jüngere Original-Conversations desselben Space; aktuelle Conversation bleibt primär; Geschwister desselben Days werden nicht pauschal voll geladen. | Globales/semantisches Retrieval, Session-Summaries |
| Detect | Externes Klartext-Detect nur Development/Test. Produktiv: Muster oder lokale Detect-URL. | Lokales Detect-Modell (Ollama) |
| Response Validation | Blockiert Klartext-Identität in der Rohantwort vor Demask. | Quasi-Identifikatoren, Platzhalter-Vollständigkeit, Audit |
| Konsolidierung | Lokale Signale `narrative_mode` / `reflection_depth` / `current_focus` aus dem Hauptcall, kein Extra-LLM. Angebot nur bei hinreichender Ähnlichkeit; Nutzer entscheidet. | Narrative Typ-Engine, UI-Feinheiten |
| `/dialog` | Nicht in der Produkt-Nav; Admin-only Dev/Test-Harness. | Start = offener Journal Day (Stub-Home bleibt) |
| Writing vs Interaction | `WritingProfile` nur Journal-Stil. Dialogue Kernel nutzt `register_hint` plus leeren `interaction_hint`-Slot. | Interaction-Profile-Engine, UI, Persistenz |
| Reflection Space | Conversation kann `space_id` ohne `journal_day_id` tragen. Space ist nicht Journal-Container. | Space-Typen, Related Spaces, Intents pro Space |
| Dialogue Kernel | Sechs Operationen bleiben allgemeine Gesprächsoperationen. Konsolidierung und Tages-Coverage liegen in Journal-Policy/Context. | Intent-Engines, Contextual Continuation |
Tests: `backend/tests/test_architecture_correction.py` plus Anpassungen in `test_mvp_journal.py` und `test_privacy_detect.py`.
---
# 2.2 Profile Governance (2026-08-25)
Additiv zu 2.1. Keine neue allgemeine Architekturphase.
| Thema | Ist-Stand | Bewusst offen |
|---|---|---|
| Writing Profile | Facets + Governance `learning`/`advising`/`frozen`. Brief abgeleitet. Bootstrap aus gespeicherten Entries. Kein Blind-Overwrite. | Große Profile-UI, zeitliche Versionierung des Fachkapitels |
| Interaction Profile | Persistenz, gelabelte Produktdefaults, Hint-Slot, Default `advising`. Lernen nur explizit/manuell/angenommener Vorschlag. | Volle Feedback-UI, Analytics, Intent-Engine |
| Dialogue State | Bleibt automatisch; zusätzlich `emotional_intensity`, `long_story` | already_covered, known_plan, Intent-Taxonomie |
| JSON-Portabilität | Export/Restore von Writing-, Interaction- oder Sammeldokument (`format_version` 1). Restore ist ausdrücklich und ersetzt Facets/Prefs. | Vollständiger Account-Export, Journal-Portabilität |
Persönliche Längen-/Impulsregeln liegen nicht mehr anonym im Dialog-Prompt, sondern im sichtbaren Interaction-Hint.
Tests: `backend/tests/test_profile_governance.py`.
---
# 2.3 Profile Review Pipeline (2026-08-25)
Additiv zu 2.2. Keine Review-Calls nach jedem Dialog, keine neue große Profil-Engine.
| Thema | Ist-Stand | Bewusst offen |
|---|---|---|
| Writing Review | Lokale Drift/Evidence, Queue, gebündelte semantische Review nur explizit. API und Copy/Paste derselben Paket-/Ergebnis-Verträge. Versionen nachvollziehbar. | Periodische Batch-UI, Interaction-AI-Review, zeitliche Facet-Historie im Fachkapitel |
| Governance-Übernahme | `learning` wendet unlocked Review-Änderungen an; `advising` queued; `frozen` nicht, außer explizites Paket ohne Apply | Getrennter Bestätigungsschritt in der UI für `learning` |
| Interaction | Weiter nur explizit/manuell/angenommener Vorschlag. Dialog-Sample ist Writing-Evidence, kein Preference-Lernen. | Beobachtungs-Candidates in der Settings-UI |
Tests: `backend/tests/test_profile_review.py`.
---
# 2.4 Writing-Profile-Hülle und Initial Build (2026-08-25)
Additiv zu 2.2 und 2.3. Das statische Facet-Raster ist nicht die Profilstruktur.
| Thema | Ist-Stand | Bewusst offen |
|---|---|---|
| Hülle | Core, optionale Facets, dynamische Traits, Evidence, Exemplare, Governance, Versionen. Seed-Keys nur Ordnungshilfe. | Output-Facets jenseits Journal/Reflexion, zeitliche Trait-Historie im Fachkapitel |
| Initial Build | Historischer Korpus mit Zeitbezug; Existing-before-New; Confirm vor kontinuierlichem Lernen | Batch-Import-UI für Dateiordner, Gewichtung als Nutzersteuerung |
| Quellenarten | Urlaubstagebuch → `autobiographical_journal`; Core nur bei gemischten Arten | Weitere context/output-Facets aus dem Fachkapitel |
| Heuristik | Lokal als Drift-/Triggerhilfe, nicht als persistierte Traits | — |
Tests: `backend/tests/test_profile_governance.py`, `backend/tests/test_profile_review.py`.
---
# 3. Abgleich gegen das Gesamtziel
Quelle: `produktvision_und_produktidentitaet.md`, ergänzt um Dialog-, Memory- und Output-Kapitel. Das ist **keine** Slice-Checkliste. Ein „Gap“ hier heißt: das Zielmodell ist nicht da — erwartet, solange Foundation-Regel 23/24 gilt. Die spannenden Zeilen sind **Spannung** und **Drift-Risiko**.
## 3.1 Identität und Prinzipien
| Prinzip / Grenze | Slice-Stand | Befund für die Gesamtziel-Prüfung |
|---|---|---|
| Personal Reflection Companion, nicht Tagebuch-App | **Spannung** | Der sichtbare Kern *ist* ein dialoggeführtes Journal. Der Dialog ist Erfassung plus Impuls, nicht langfristige Begleitung. Drift-Risiko: UI und Sprache dürfen nicht als „KI-Tagebuch“ festgeschrieben werden. Der Slice bleibt zulässig, wenn Generate/Editor dem Gespräch nachgeordnet bleiben. |
| Kernkette Wahrnehmen → Reflektieren → Verstehen → Einordnen | **Teilweise** | Wahrnehmen und ein kurzes Reflektieren im Turn. Verstehen/Einordnen über Tage und Werte: nicht gebaut. Journalentwurf verdichtet den Tag, ist aber keine Erkenntnis-Schicht. |
| Dialog vor Formular | **Erfüllt** im Tag | Journal Day ist Chat. Settings-Import und Editor sind nachgelagert. Start `/` ist kein Dialog. |
| Kontext vor generischer Frage | **Teilweise** | Derselbe Day-Transcript geht in den nächsten Zug. Space ist Recency, nicht Relevanz. Kanshō eröffnet nicht. Neutraler Start ist Default, in der Vision Fallback. |
| Erinnerung mit Herkunft | **Teilweise** | Messages bleiben. Draft/Entry-Version tragen relationale Source-Refs (API weiterhin ID-Listen). Nutzer sieht „zum Quelldialog“, keine Provenance-Kette, kein Re-Grounding. |
| Hypothese statt Gewissheit | **Teilweise** | Impulse sind Nachrichten, nicht Fakten. Keine Hypothesen-Objekte, keine Confidence, keine Bestätigung vor Self-Aussagen (kein Self Model). |
| Mensch entscheidet über Identität | **Erfüllt** als Abwesenheit | Kein Self-Model-Schreibpfad. Writing Profile ist als Formhinweis gekennzeichnet. |
| Persönliche Sprache | **Teilweise** | Lokaler Brief + Exzerpte. Keine Wortwahl-/Übergangs-Signale. Eine generative Stufe, nicht Inhalt/Stil getrennt. |
| Reflection before Action | **Bewusst offen** | Keine Action Candidates, keine Kairo-Übergabe. Scratch ist lokale Merkhilfe, kein Aufgabenmanager — Grenze gehalten. |
| Keine Jinkendo-Duplikation | **Erfüllt** im Slice | Kein Tracker, keine Diagnose-UI, kein Kairo-Todo. `/dialog` ist Admin-Harness, kein zweiter produktiver Gesprächsraum. |
| Menschenlesbares Langzeitarchiv (Obsidian) | **Gap** zum Ziel | Entries liegen in SQLite. Kein Export. |
| Langfristige Kontinuität | **Teilweise** | Transcript und versionierte Entries überdauern Sitzungen. Kein Thread Memory, keine offenen Fragen, kein Point-in-Time Self. |
| Einfache UX, differenzierter Kern | **Spannung** | UX ist einfach. Der Kern ist noch nicht differenziert (ein Call, Recency, Regex-Register). Das ist Slice-angemessen; es darf nicht als „der Kern *ist* Recency“ kanonisch werden. |
| Start = Kontinuität des Dialogs, kein Dashboard | **Gap** zur Identität | `/` ist ein Stub mit Link zum Journal. `/dialog` ist nicht mehr Teil der Nutzer-IA. Primärstart ist nicht der offene Day. |
## 3.2 Dialog-IA (Ziel vs Slice)
Ziel (`dialogue_model.md`): Contextual Continuation als Default, Free Reflection, Explicit Navigation; Intent ≠ Dialogführung; Fäden intern möglich.
Slice: der Mensch schreibt die erste Zeile; Kanshō antwortet mit einem Impuls aus einem Call `{operation, impulse}`. Keine Entry-IA, keine Fortsetzung eines gestern offenen Fadens, keine Saturation, keine Wiedervorlage.
**Prüffrage:** Bleibt der Journal Day ein Gespräch über *diesen* Kalendertag? `/dialog` ist Admin-Testrest, nicht Ziel-IA.
## 3.3 Memory und Context (Ziel vs Slice)
Ziel: Working / Thread / Episodic, Space als Bedeutung, mindnet langfristig, Re-Grounding gegen Verdichtungsdrift.
Slice: Working Context ≈ aktuelle Conversation (Day-Cap) + begrenzte Recency-Ausschnitte finaler Space-Entries + begrenzte Original-Ausschnitte jüngerer Space-Conversations + Formhinweise nur beim Journalentwurf. Generate sieht **keine** Prior-Entries, nur Day-Dialog + Writing Profile. Scratch und Identity-Mapping sind Klasse A, kein Egress.
**Prüffrage:** Ist Recency als *Hilfsstruktur* erkennbar (`retrieval.py` nach `kind`), oder wird sie in Prompts/UI als „Kanshō erinnert sich“ verkauft? Der Code ist austauschbar; die Produktstimme darf das nicht überzeichnen.
## 3.4 Outputs und Integrationen (Ziel vs Slice)
Ziel: Journal Entry (Obsidian), Reflection Memory (mindnet), Knowledge Delta (mindnet), Action Candidate (Kairo). Tagesreflexion muss kein Artefakt erzeugen; Journal-Default im Ziel: bei substanzieller Reflexion dezent anbieten.
Slice: einziges sichtbares Derived-Produkt ist Journal Draft/Entry. Generate nur explizit (Button), nicht automatisch am Gesprächsende. Das weicht vom späteren Journal-Default der Tagesreflexion ab und hält Foundation „model proposes; policy decides“.
**Prüffrage:** Explizites Generate ist für den Slice richtig. Es darf nicht so verbaut werden, dass ein späteres dezenten Angebot am Abschluss den Entry still überschreibt (§11.2).
## 3.5 Privacy (Ziel vs Slice)
Ziel: Identität lokal, minimierter pseudonymisierter Egress, Detect lokal, Response-Validierung, Audit ohne Prompt, ZDR.
Slice: Gateway-Pfad existiert und ist nicht abschaltbar. Maskierung + Generate. Detect: Muster immer; externes Klartext-Detect nur Development/Test, Produktiv fällt auf Muster zurück. Minimale Response Validation vor Demask (Klartext-Identität). Keine inhaltliche Minimierung über Caps hinaus, keine Quasi-Identifikatoren, Mapping unverschlüsselt.
**Das ist der größte Abstand zum Gesamtziel, der schon im Slice operativ relevant ist** — nicht weil das Target Model fehlt, sondern weil Testdaten persönlich sein können.
## 3.6 Nutzungssituationen (Zieltypologie vs Slice)
Von elf Situationen ist nur ein Pfad gebaut: Tagesreflexion als Journal Day plus optionales Festhalten im Entry. „Erleben festhalten“ geht nur als Dialogtext, nicht als Voice. „Früheren Faden fortsetzen“, Tiefe Reflexion, Entscheidung, Revue, Nachschlagen jenseits Space→Tag→Entry: nicht als eigene IA.
Nachschlagen im Slice = Chronologie im Space. Das erfüllt MVP-Case K, nicht Natural-Language-Biografie.
## 3.7 Gesamtziel: Kurzurteil
Der Slice ist eine **zulässige vertikale Keimzelle**: Dialogquelle bleibt kanonisch, Journal ist Derived, Gateway sitzt vor Egress, Space/Day/Assignment sind trennbar, Retrieval ist austauschbar.
Er ist **noch nicht Kanshō im Sinne der Vision**. Die gefährlichen Drifts sind nicht die fehlenden Target-Module, sondern:
1. Journal-Editor und Medien als Produktmitte statt Dialog,
2. Recency und Regex als Ersatz für Context/Memory,
3. `/dialog` als Admin-Harness (geschlossen für die Nutzer-IA; Stub-Home bleibt),
4. Detect-Klartext als Gewohnheit im Produktivmodus (Development/Test bleibt erlaubt),
5. Stub-Home statt Kontinuität.
---
# 4. Abgleich Implementation Foundation
## 4.1 Core-Regeln
| # | Regel | Stand | Befund |
|---|---|---|---|
| 1 | Original Source bleibt kanonisch | **Erfüllt** | `messages` bleiben bei Generate und Entry-Save. Löschen eines Gesprächs ist ausdrücklich und hart (Nachrichten weg). |
| 2 | Derived ersetzt Source nie | **Erfüllt** | Drafts und Entries sind eigene Tabellen. Generate prüft, dass `current_version_id` unangetastet bleibt. |
| 3 | Stabile Identitäten | **Erfüllt** | UUIDs für Profile, Spaces, Days, Conversations, Messages, Drafts, Entries, Versionen, Media. |
| 4 | Zeit und Provenance | **Erfüllt** im Datenmodell | Message-`created` ≠ `journal_days.calendar_date`. Drafts/Entries tragen relationale Source-Refs. **Gap:** keine nutzbare Provenance-Ansicht jenseits „zum Quelldialog“. |
| 5 | Current Validity und History getrennt | **Erfüllt** | `journal_entry_versions`; Restore hängt eine neue Version an. Offene Editor-Edits sind kein History-Write; Verwerfen ist lokal. |
| 6 | User Correction vor Modellinferenz | **Erfüllt** für Journal | Nutzerfassung ist Current. KI-Draft ist nicht Stilquelle. **Teilweise** für Derived-Hülle: `derived_records` werden bei Entry-Korrektur nicht invalidiert (im Slice ungenutzt). |
| 7 | AI Hypothesis ist kein User Fact | **Erfüllt** im Dialogpfad | Impulse sind `assistant:`-Nachrichten, nicht Entries. Generate: Impulse sind Kontext, nicht Erlebtes. |
| 8 | Expressed state ist kein Self Model | **Erfüllt** | Kein Self-Model-Schreibpfad. Writing Profile sind Formhinweise, als „keine Diagnose“ gekennzeichnet. |
| 9 | Model proposes; policy decides; source preserves | **Erfüllt** | Generate nur explizit (`journal_policy.require_explicit_generate`). Speichern nur per Nutzer. Übernehmen aus Entwurf schreibt eine Version, überschreibt History nicht. |
| 10 | Space ist Bedeutungskontext, kein Ordner | **Teilweise** | Space ist nutzbar und Isolationseinheit; Conversation kann dem Space ohne Journal Day zugeordnet werden. Inhaltlich bleibt er eine Liste von Tagen plus Recency-Ausschnitten. Keine Space-Bedeutungsschicht. |
| 11 | Primary und Related Spaces möglich | **Teilweise** | Primary Assignment: `conversations.space_id` / `journal_day_id`. Junction `thread_spaces` existiert. **Gap:** Related Spaces weder Datenmodell für Journal-Spaces noch UI. `conversations.space_id` ohne FK. |
| 12 | Assignment ist nicht Identity | **Erfüllt** | Conversation-ID bleibt; Space/Day sind Assignment-Felder. |
| 13 | Existing before new | **Teilweise** | Denselben Kalendertag im Space wiederzuverwenden öffnet denselben Day. Speichern aus Entwurf versioniert den bestehenden Entry. Recurring Activities erzeugen keinen bestehenden Faden, sondern nichts. |
| 14 | Space first, Long-Term Memory on demand | **Erfüllt** | Kein globales autobiografisches Retrieval. Dialog sieht den Day plus letzte Space-Entries. |
| 15 | Context Builder eigene Verantwortlichkeit | **Erfüllt** | `context_builder.py` + `retrieval.py`. Frontend baut keinen Prompt. |
| 16 | Minimum sufficient context | **Teilweise** | Day-Cap und Space-Ausschnitte sind Recency-Implementierung hinter Selection-Specs. **Ungenauigkeit:** das ist keine Relevanz. |
| 17 | Retrieval ist Hilfsstruktur | **Erfüllt** | SQL-Funktionen nach `kind`, keine Embeddings als Wahrheit. |
| 18 | Provider State ist nicht Memory | **Erfüllt** | Kontinuität in SQLite. Provider sieht maskierten Prompt. |
| 19 | Ein generativer Hauptcall pro Turn | **Erfüllt** | Ein Dialogzug-Call; optional ein lokaler Repair-Call. Detect ist Maskierung, nicht Operation. Journalentwurf getrennt und explizit. |
| 20 | Write Evaluation signal-driven | **Erfüllt** | Kein exhaustives Memory-/Pattern-Write nach jeder Message. `remember_dialogue_style` ist lokal und schmal. |
| 21 | Variable Policies nicht quer hardcoden | **Teilweise** | `journal_policy.py` ist die Journal-Grenze inkl. Konsolidierungsangebot aus lokalen Signalen. Register, Guards, UNMASKABLE liegen als Heuristiken im Code. Für den MVP laut Foundation keine Policy-Engine nötig. **Ungenauigkeit:** „Policy“ im Dialog ist Prompt + Regex, keine zentrale Decision-Tabelle. |
| 22 | Interne Reichhaltigkeit, einfache UI | **Teilweise** | Journal-UI ist schmal. `/dialog` ist Admin-Harness, nicht Produkt-Nav. Admin-Bereich (Prompts, Provider, Nutzer, Diagnose) bleibt Mitai-Rahmen. |
| 23 | Neue Abstraktionen brauchen Nutzen | **Erfüllt** | Threads/Derived/Handoffs sind Hüllen, ohne Nutzer-IA. |
| 24 | Nicht implementiert ist zulässig | **Erfüllt** | Space Memory, Related Spaces, semantisches Retrieval bewusst offen. |
## 4.2 Foundation Cut: muss vorhanden sein
| Muss | Stand | Befund |
|---|---|---|
| Persistente Session- und Message-Quellen | **Erfüllt** | `usage_sessions`, `conversations`, `messages`; Auth-`sessions` getrennt |
| Stabile IDs | **Erfüllt** | |
| Zeitbezug und grundlegende Provenance | **Erfüllt** | siehe Regel 4 |
| Trennung Source / Derived | **Erfüllt** | |
| Reflection-Space-Grundmodell | **Erfüllt** | `spaces.visibility='user'` |
| Primary-Space-Zuordnung | **Erfüllt** | Assignment-Felder; Journal-Day erzwingt Space |
| Datenmodell darf Related später zulassen | **Teilweise** | `thread_spaces` ja; Journal-Space-Related fehlt |
| Current-State-/History für verwendete Objekte | **Erfüllt** | Entries + Versionen; Dirty-State ist Session-UI, nicht History |
| Nutzerkorrektur beeinflusst Current Validity | **Erfüllt** | |
| Context-Builder-Schnittstelle | **Erfüllt** | |
| Austauschbare Retrieval-Schnittstelle | **Erfüllt** | |
| Provider-Abstraktion | **Erfüllt** | `providers.py`, Rollen generate/detect |
| Kleine Write-/Decision-Policy-Grenze | **Erfüllt** | `journal_policy.py` |
## 4.3 Foundation: nur bauen wenn der Slice es braucht
| Gegenstand | Im Code | Bewertung |
|---|---|---|
| Thread | Tabelle + Junction, visibility internal | Hülle, keine UI. **Kein Gap**, solange nicht als Produkt verkauft. |
| Open Question / Insight / Experience | Derived-Kind-Registry, keine Nutzung | **Bewusst offen** |
| Sichtbare Related Spaces | nein | **Bewusst offen** |
| Automatische Space-Erkennung | nein | **Bewusst offen** |
| Semantisches Retrieval | nein | **Bewusst offen** |
| Session Summary | nein | **Bewusst offen** |
| Zusätzliche Enrichment-Calls | Detect in Development/Test optional remote | **Abweichung** gegenüber Produktivziel „Detect lokal“; Produktivmodus lässt externes Klartext-Detect nicht als normalen Pfad zu |
## 4.4 Foundation Non-Goals
Nicht vorsorglich gebaut: Reflection Graph, Graph-DB, Pattern-Engine, Self Model, Landmark-Engine, Policy-Learning, Space-Merges, mindnet-Sync, Resurfacing, Persönlichkeitsanalyse, Intent-Engines, Graph-UI, Dashboards.
**Spannung, kein Slice-Gap:** Es gibt eine Admin-Oberfläche (Nutzer, Prompts, Platzhalter, Features, Provider, Dialogdiagnose). Das MVP-Non-Goal „komplexe Admin-/Governance-Oberfläche“ meint die Produkt-IA. Der Mitai-Produktrahmen sieht Operator-Admin vor. Die Testspur am Dialog ist bewusst Testphase, nicht Default-UX.
Foundation-Verletzungen, die ein Refactor erzwingen würden, sind **nicht** gefunden: Source/Derived, IDs, Space-Assignment, Context Builder, Gateway vor Egress, explizites Generate, Versionierung ohne History-Overwrite.
---
# 5. Abgleich MVP-Spezifikation
## 5.1 Produktversprechen (`mvp.md` §1–2)
| Anforderung | Stand | Befund |
|---|---|---|
| Dialoggeführtes Journal, Entwurf aus dem Gespräch | **Erfüllt** | Explizites Generate, Öffnen als Entwurf |
| Redigieren, Medien, chronologisch wiederfinden | **Teilweise** | Editor mit Absätzen, Listen, Inline-Bild/Video und Unterschrift. Navigation über Tage, nicht eine Entry-Liste |
| Dialog berücksichtigt Tagesverlauf, Space, frühere Aussagen, Erzählweise | **Teilweise** | Tagesverlauf: voller Day-Dialog. Erzählweise: Formhinweise. Space/Früheres: Recency-Ausschnitte gespeicherter Entries, 5×400 Zeichen. **Ungenauigkeit** von §1 gegenüber der Umsetzung in §5.1 letzter Absatz und §8.2 |
## 5.2 Sichtbare Einheiten
| Einheit | Stand | Befund |
|---|---|---|
| Space anlegen, umbenennen, auswählen | **Erfüllt** | |
| Chronologische Entries des Spaces | **Teilweise** | Space-Seite zeigt **Tage**. Entries liegen unter dem Tag. |
| Journal Day ≠ Dialogzeit | **Erfüllt** | |
| Originaldialog erhalten | **Erfüllt** | |
| Gespräch aus dem Tag entfernen | **Erfüllt** | Hartes Löschen der Conversation. **Ungenauigkeit:** härter als Entry-Soft-Delete; kein Papierkorb für Dialoge |
| Draft Derived, erneut generierbar, überschreibt Entry nicht | **Erfüllt** | UI öffnet den neuen Entwurf; Übernehmen ist explizit und versioniert den bestehenden Entry. |
| Entry mit Versionen, Space, Day, Quellen | **Erfüllt** | Medien am Entry; Position und Unterschrift im Body-Token |
## 5.3 Mehrere Dialoge (`mvp.md` §4)
| Anforderung | Stand | Befund |
|---|---|---|
| Mehrere Conversations pro Day | **Erfüllt** | |
| Konsolidierung anbieten, nicht erzwingen | **Erfüllt** im Slice-Schnitt | Angebot nur bei hinreichend ähnlichen lokalen Signalen (`narrative_mode`, `reflection_depth`, `current_focus`). UI: dieses Gespräch / alle des Tages. Nutzer entscheidet über `conversation_ids`. |
| Getrennte Tiefen nicht automatisch mergen | **Erfüllt** | Ohne Auswahl nur die letzte Conversation |
| Gleicher Kalendertag, verschiedene Spaces getrennt | **Erfüllt** | Unique `(space_id, calendar_date)` |
## 5.4 Dialogführung (`mvp.md` §5–7)
| Anforderung | Stand | Befund |
|---|---|---|
| Kein Fragebogen; Reflexionspartner | **Teilweise** | Prompt und Stimme zielen darauf. Qualität ist modellabhängig. Lokale Wächter gegen Recap, erfundenen Vollzug, erfundene Empfindung, Systemfloskeln, Schluss-Wiederöffnung. `local_hold` bittet um Fortsetzung statt Floskel. |
| Sechs Operationen, keine Intent-Engines | **Erfüllt** | Ein Call, JSON `{operation, impulse}`; sichtbar ist `impulse` |
| Register lokal, kein zweites Modell | **Erfüllt** | `infer_register` |
| Bekannter Tagesplan (Cres-Beispiel) | **Teilweise / Ungenauigkeit** | Plan kann aus begrenzten Recency-Ausschnitten **gespeicherter Entries** oder **jüngerer Original-Conversations** desselben Space kommen. Kein Plan-Objekt, keine zeitliche Vor/Nach-Logik, kein semantisches Retrieval. |
| Wiederkehrende Aktivität (Japanisch-Beispiel) | **Gap** | Keine Zählung über Morgenbeschreibungen. Recency kann den Treffer zufällig enthalten oder nicht. |
| Keine triviale Gefühlsfrage nach selbst benannter Emotion | **Teilweise** | Prompt + `is_unearned_stance`. Kein Dialogzustand „bereits beantwortet“. |
| Kontextsensitiver Einstieg statt „Erzähl von deinem Tag“ | **Gap** | Nutzer schreibt die erste Zeile. Kanshō eröffnet nicht aus Plan/Space. Neutraler Start ist der Default, nicht der Fallback. |
| Unterbrechen und Fortsetzen am selben Day | **Erfüllt** | Transcript bleibt. **Teilweise:** keine lokale Karte „welche Tagesabschnitte schon da sind“. |
| Folgetag-Fortsetzung dem ursprünglichen Day zuordnen | **Erfüllt** | Nutzer öffnet den Day; Message-Zeit ist unabhängig. |
## 5.5 Generierung (`mvp.md` §8)
| Anforderung | Stand | Befund |
|---|---|---|
| Nur explizit | **Erfüllt** | |
| Quellen: Day-Dialog inkl. Impulse als Kontext | **Erfüllt** | `user:` Erlebtes, `assistant:` Anschluss |
| Space-Kontext soweit nötig | **Teilweise** | Generate bekommt **keinen** Prior-Entry-Block; nur Writing Profile + Day-Dialog. Dialogzug sieht Prior-Entries. |
| Writing Profile | **Erfüllt** | Lokal, ohne Extra-LLM |
| Bestehenden Text einbeziehen | **Teilweise** | API `include_existing`. **Gap:** UI setzt das Flag nicht. |
| Verbinden, nicht durchreichen | **Teilweise** | Prompt: Szenen verbinden und Stimme aus dem Writing Profile; kurze Passagen ausformulieren ohne neue Fakten. `journal_shape` formt 1:1-Kopien und dünnt Namenswiederholungen. Qualität modellabhängig. Zweistufige Generierung (Inhalt, dann Stil) aus dem Fachkapitel: **nicht** gebaut, ein Call. |
| Nicht erfinden | **Teilweise** | Prompt; keine lokale Faktenprüfung gegen den Dialog |
## 5.6 Writing Profile (`mvp.md` §9)
| Anforderung | Stand | Befund |
|---|---|---|
| Priorität Entries > Import > Dialog | **Erfüllt** | Finale Entries: mehr/längere Exzerpte; Dialog-Exzerpte entfallen, sobald Entries existieren. |
| KI-Draft keine Stilquelle | **Erfüllt** | |
| Import optional | **Erfüllt** | Settings |
| Formhinweise ohne Self Model | **Erfüllt** | Heuristik |
| Semantische Review | **Erfüllt** als expliziter Pfad | Gebündelt, API oder Copy/Paste, nicht nach jedem Dialog. Siehe 2.3. |
| Profilhülle / dynamische Traits | **Erfüllt** als Keim | Core + Facets + datengetriebene Traits. Kein festes Raster. Siehe 2.4. |
| Initial Profile Build | **Erfüllt** als expliziter Pfad | Historischer Korpus, Confirm vor Continuous Learning. |
| Lernsignale §9.3 vollständig | **Teilweise** | Satzlänge, Chronologie vs. Thema, Uhrzeiten, Reflexionsanteil, Humor. **Gap:** Umgang mit Namen, typische Übergänge, Wortwahl als eigene Signale. |
| Dialogzug ohne Stil-Exzerpte des offenen Turns | **Erfüllt** | |
## 5.7 Editor, Versionen, Nachschlagen, Screens
| Anforderung | Stand | Befund |
|---|---|---|
| Text ändern, Absätze, Überschrift | **Erfüllt** | Fließtext; Absatz/Überschrift/Liste; Fett/Kursiv/Unterstrichen auf der Markierung |
| Bilder ergänzen, anordnen | **Erfüllt** | Fließtext, Einfügen an der Schreibmarke, Ziehen im Text, Unterschrift. Alte Galerie-Dateien ohne Referenz: „Noch nicht im Text“. |
| Videos im Eintrag darstellen | **Erfüllt** | MP4/WebM/MOV, lokal, direkt abspielen. Keine Videobibliothek. Metadaten in Video-Containern werden **nicht** gestrippt (**Gap** / bewusst dünn). |
| Zeichnungen als Bilddatei | **Erfüllt** | als Upload |
| Soft Delete / Papierkorb | **Teilweise** | `deleted_at` + DELETE-API. Editor-Text: „In den Papierkorb“. **Gap:** keine Papierkorb-UI, kein Wiederherstellen Gelöschter, kein zweiter Schritt „endgültig löschen“. |
| Version History sichtbar, Restore | **Erfüllt** | Aktuelle Fassung ohne Restore auf sich selbst; offene Edits lokal verwerfen. Navigation mit Dirty-Flag bestätigt (Links, Abmelden, `beforeunload`). Browser-Zurück nicht hart blockiert. |
| Generate überschreibt Nutzerfassung nicht | **Erfüllt** | |
| Chronologische Liste, Space, Datum, Entry, Quelldialog | **Teilweise** | Über Space → Tage → Tag/Editor/Source. Keine Entry-Indexseite. |
| Screen Journal/Spaces | **Erfüllt** | |
| Screen Journal Day / Dialog | **Teilweise** | Chat + Generate + lokale Stichpunkte (Return fokussiert neue Zeile). **Gap:** keine Medienoption am Dialog (MVP §13.2 Dialogquellen). Draft/Entry nur Links. |
| Screen Editor | **Erfüllt** | Fließtexteditor, Markdown, Inline-Medien, Restore, Dirty-Schutz |
| Screen Source Dialog | **Erfüllt** | |
| Start = Kontinuität des Dialogs | **Gap** zur Produktidentität | `/` ist ein Stub. Primärstart ist nicht der offene Day. `/dialog` ist Admin-Harness, nicht Nutzer-IA. |
| Tagesstichpunkte §10.1 | **Erfüllt** als lokale Liste | Klasse A, kein Egress (Test). Kein Aufgabenmanager. Offen bleibt eine spätere bewusste, maskierte Nutzung als Kontext. |
## 5.8 Acceptance Cases
| Case | Stand | Was der Code prüft vs. was die Spezifikation meint |
|---|---|---|
| **A** Einfacher Day | **Erfüllt** | Dialog, Generate, Save, Space-Chronologie. Lesbarkeit/Quelltreue des Entwurfs ist modellabhängig, Shape nur bei 1:1-Paste. |
| **B** Mehrphasiger Tag | **Erfüllt** | Gleicher Day, spätere Messages, Kalenderdatum stabil. |
| **C** Kontextsensitiver Dialog | **Teilweise / Ungenauigkeit** | Test prüft, dass „Hafen“ im Prompt steht und die Regel „nicht geschehen“ im Template ist. Er prüft nicht, dass Kanshō den Plan als Impuls aufgreift. Wiederkehrende Aktivität: **Gap**. |
| **D** Ausführliche Erzählung | **Teilweise** | Ein Call, dichtes Register. Ob der Impuls nicht interviewt, ist modell- + wächterabhängig. Tests erzwingen keine inhaltsleere Fragefreiheit. |
| **E** Emotionaler Abschnitt | **Teilweise** | Prompt + Stance-Wächter. Test sucht die Phrase „Motivationen erfinden“ im Prompt, nicht das Dialogverhalten. |
| **F** Unterschiedliche Dialogtypen | **Erfüllt** im Schnitt | Zwei Conversations möglich, kein Zwangsmerge. Lokale Signale trennen Chronik und tiefe Reflexion; Angebot bleibt aus. |
| **G** Ähnliche Dialoge, Angebot | **Erfüllt** im Schnitt | Angebot nur bei ähnlichen Signalen. Nutzer entscheidet über `conversation_ids`. |
| **H** Zwei Spaces, gleicher Tag | **Erfüllt** | |
| **I** Persönlicher Stil | **Teilweise** | Import und Entries im Brief; Formhinweise. „Nicht in KI-Stil driftet“ ist Promptziel, nicht messbar erfüllt. |
| **J** Versionsschutz | **Erfüllt** | Restore hängt Version an; Generate ändert Entry nicht; Entwurf öffnet separat; Übernehmen versioniert. |
| **K** Nachschlagen | **Erfüllt** | Space → Datum → Entry → Source. |
---
# 6. Ungenauigkeiten (Doku, Tests, UI)
1. **`mvp.md` §1 und §5.1** versprechen „relevante frühere Aussagen“ und „wiederkehrende Aktivitäten“. Der Code liefert Recency-Ausschnitte finaler Entries plus begrenzte Original-Ausschnitte jüngerer Space-Conversations. Der klarstellende Absatz in §5.1 und §8.2 ist der gültige Implementierungsstand; die Beispiele §5.4–5.5 und Case C bleiben **schärfer als der Code** (kein Plan-Objekt, keine Wiederholungszählung).
2. **`mvp.md` §17** sprach vom „nächsten Schritt: technischen Plan ableiten“. Der Slice ist gebaut. Dieses Dokument ist der Abgleich; die Formulierung in §17 bleibt historisch.
3. **`mvp.md` §4.1 Konsolidierung** beschreibt narrative Kriterien. Der Slice nutzt lokale Signale derselben Dimensionen, keine LLM-Typklassifikation.
4. **`mvp.md` §6 Einstieg** verlangt einen kontextsensitiven ersten Impuls. Implementiert ist: der Mensch beginnt.
5. **`mvp.md` §8.2 Punkt 2** Space-Kontext bei der Generierung: Generate sieht Prior-Entries nicht.
6. **`mvp.md` §9.3** listet Lernsignale, von denen nur ein Teil heuristisch existiert.
7. **`mvp.md` §11.3 / §13.1–13.2** Papierkorb-UI und Dialog-Medien fehlen weiter. Inline-Medien, Unterschriften, Versions-UI und Dirty-Schutz im Editor sind vorhanden.
8. **Acceptance-Tests C/D/E** sind oft Prompt- oder Call-Zähl-Proxies, keine fachlichen Verhaltensbeweise.
9. **`backend_and_api.md`** beschreibt PostgreSQL als Rahmen; der Slice läuft auf **SQLite**. **Abweichung** vom technischen Ziel, lokal zulässig.
10. **Fehlerformat:** Rahmen will `{detail: string}`. Viele Router liefern `{detail: {code, message}}`.
11. **Nav `/dialog`** ist aus der Produkt-IA entfernt (Admin-Harness). Stub-Home bleibt.
12. **Detect über OpenRouter** darf Klartext nur in Development/Test sehen. Produktivmodus fällt auf Muster oder lokale Detect-URL zurück. Guardrail-Abstand zum lokalen Detect-Modell bleibt.
13. **Home `/`** widerspricht der Produktidentität „Kontinuität des Dialogs, kein Funktions-Dashboard“ nur schwach (Stub), erfüllt sie aber nicht.
14. **`handover.md`** ist Konzept-Bootstrap (Interviewstand 2026-08-19) und **kein** Code-Stand. Code-Stand ist dieses Dokument.
15. **Zweistufige Journalgenerierung** im Fachkapitel Writing Profile ist Zielmodell. Der Slice hat einen Generate-Call. `mvp.md` verlangt das Zweistufenmodell nicht zwingend; das Fachkapitel schon. Nicht als Slice-Bug lesen, nicht als erfüllt behaupten.
16. **Tagesreflexion-Journal-Default** (Hintergrund-Entwurf am Abschluss, dezent anbieten) ist Fachstand der Nutzungssituation, nicht MVP-Text. Der Slice verlangt den Button. Kein Widerspruch, solange später kein stilles Überschreiben entsteht.
---
# 7. Bewusst offen (kein Gap des Slices)
Zielmodell und Non-Goals, nicht „vergessen im MVP“:
- Space Content Memory, Threads-UI, Open Questions, Insights, Experiences
- Semantisches Retrieval, Session-Summaries, Related Spaces
- Self Model, Pattern-Ansicht, Resurfacing, mindnet, Obsidian-Ablage, Kairo-Handoff
- Voice, Videobibliothek, Dokumentarchive, Karten
- Video-Metadaten (GPS im Container) strippen
- Tagesstichpunkte als Dialogkontext (bewusst lokal, siehe `mvp.md` §10.1)
- Encryption at rest, DSFA, Multi-Gerät-Sync, PWA-Offline-Ausprägung
- Lokales Detect-Modell (Ollama) als Ablösung der Testphase
- `include_existing` in der UI (API existiert)
- Zweistufige Journalgenerierung (Inhalt, dann Stil)
- Contextual Continuation als Start-IA
- Browser-Zurück als harter Unsaved-Blocker (Data-Router)
---
# 8. Zwei Listen: Slice schließen vs. Gesamtziel später
Keine neue Horizontal-Konzeption. Getrennt halten, sonst baut ein Agent das Target Model in den Slice.
## 8.1 Distanz zum **freigegebenen MVP-Text** (`mvp.md`)
1. **Kontextsensitiver Einstieg und Case C** – Plan/Wiederholung nur, wenn sie wirklich im Space-Kontext liegen; sonst ehrlich kein Cres-Beispiel, oder §5.4–5.5 an Recency anpassen.
2. **Generate und Space-Ausschnitte** – klären, ob Generate Prior-Entries braucht oder §8.2 korrigiert bleibt (Day-Dialog reicht).
3. **Editor-Lücken** – Papierkorb oder zweiter Löschschritt; Dialog-Medien oder Streichung in §13.2.
4. **Startlogik** – offenen Journal Day statt Stub-Home.
5. **Lokales Detect-Modell** – Klartext an externe Detect-Provider ist in Production blockiert; Ollama als Ablösung der Dev/Test-Phase bleibt offen.
6. **`include_existing`** – UI oder Flag aus der Spezifikation nehmen.
## 8.2 Distanz zum **Gesamtziel** (nicht jetzt bauen)
1. Memory-Schichten und Space als Bedeutung, nicht Recency-Liste.
2. Contextual Continuation, Saturation, Wiedervorlage, Fäden.
3. Outputs jenseits Journal (Memory, Knowledge, Action) und Integrationen.
4. Self Model mit Bestätigung; Point-in-Time Self.
5. Re-Grounding und Provenance-UI.
6. Privacy Security Layer (Minimierung, lokales Detect, Response-Validierung, Audit, Encryption).
7. Voice, Offline, Obsidian.
Ein Agent, der 8.2 in diesem Slice „schließt“, verletzt Foundation-Regeln 22–24.
---
# 9. Dateikarte für die Gegenprüfung
## 9.1 Fachlich führend
| Datei | Rolle in der Prüfung |
|---|---|
| `produktvision_und_produktidentitaet.md` | Gesamtziel, Prinzipien, Nicht-Ziele |
| `mvp.md` | Freigegebener Slice |
| `implementation_foundation.md` | Sackgassen-Verbot |
| dieses Dokument | Ist-Stand |
| `guardrails.md` | Datenschutz-Invariante |
| `writing_profile_and_journaling.md` | Stilziel; Zweistufenmodell ist Ziel, nicht Slice |
## 9.2 Code, der den Slice trägt
| Pfad | Verantwortung |
|---|---|
| `backend/privacy_gateway.py`, `entity_detect.py`, `pronoun_bind.py`, `identity_store.py` | Egress, Maskierung, Dialog-Pronomen |
| `backend/context_builder.py`, `retrieval.py`, `conversation_signals.py` | Interner Kontext, Selection-Specs, lokale Dialogsignale |
| `backend/dialogue_turn.py` | Ein Call, Operation/Impuls, lokale Wächter; kein Writing-Profile-Kernel |
| `backend/journal_generate.py`, `journal_shape.py`, `journal_body.py` | Entwurf, Shape, Titel/Markdown |
| `backend/journal_store.py`, `journal_policy.py` | Entries, Versionen, Scratch, explizites Generate |
| `backend/writing_profile_store.py` | Lokaler Brief |
| `backend/media_store.py` | Lokale Medien, Token im Body |
| `frontend/src/pages/JournalDayPage.jsx` | Dialog + Generate + Scratch |
| `frontend/src/pages/JournalEditorPage.jsx` | Editor, Versionen, Dirty |
| `frontend/src/context/UnsavedChanges.jsx` | Navigationsschutz |
| `frontend/src/components/DayScratch.jsx` | Lokale Checkliste |
| `frontend/src/journal/document.js` | Markdown ↔ TipTap |
## 9.3 Tests und ihre Grenze
| Suite | Was sie trägt | Was sie nicht trägt |
|---|---|---|
| `backend/tests/test_mvp_journal.py` | Day, Generate ändert Entry nicht, Scratch nicht im Egress, Spaces isoliert, Konsolidierung nach Signalen | Dialogqualität, Stil, Case C Verhalten |
| `backend/tests/test_architecture_correction.py` | Provenance-Migration, Space ohne Day, Space-Source-Plan, Detect-Env, Kernel-Grenzen | — |
| `backend/tests/test_privacy_detect.py` | Maskierung, Pronomen Dialog vs Journal, Response Validation, Production-Detect | Quasi-Identifikatoren, Provider-ZDR |
| `backend/tests/test_journal_shape.py` | Namensausdünnung | Quelltreue des Modells |
| `backend/tests/test_writing_profile.py` | Quellenpriorität | „klingt wie die Person“ |
| `backend/tests/test_frame.py` | Auth, Prompts, Rahmen | Journal-IA |
| `frontend/src/journal/document.test.js` | Markdown-Runde | Editor-UX, Dirty-Flag |
Laufzeit lokal: Frontend Port **5188**, Backend **8018**, SQLite `backend/data/kansho.sqlite`. Prompt-Templates in der DB werden bei unangetasteten Seeds durch `init_db` aktualisiert; nach Prompt-Änderungen Backend neu starten.
---
# 10. Empfohlene Prüffragen (für den zweiten Agenten)
Nicht als Implementierungsbacklog, sondern als Gegenlesung:
1. Wird im Code oder in der UI etwas als Erinnerung, Verständnis oder Identität verkauft, das nur Recency, Regex oder ein Writing-Brief ist?
2. Bleibt der Dialog die Primärquelle, oder zieht der Editor (Medien, Versionen) die Produktmitte auf das Journal?
3. Ist das Gateway vor jedem persönlichen Generate-Call, und ist Detect-Klartext als Testphase kenntlich — in Admin-UI und Doku?
4. Kann ein späteres Thread Memory / Related Space / Re-Grounding an IDs, Assignment und Retrieval andocken, ohne Messages oder Entries umzuschlüsseln?
5. Welche der Lücken in Abschnitt 8.1 sind echte Spec-Schulden, welche sollten in `mvp.md` auf den Code zurückgeschrieben werden, damit Vision und Slice nicht weiter auseinanderlaufen?
6. Drift-Risiko Stub-Home: bleibt die Startlogik gegen „Kontinuität des Dialogs“ dünn, obwohl `/dialog` nicht mehr in der Nutzer-IA liegt?
7. Scratch: bleibt die Grenze „kein Aufgabenmanager, kein Egress“ in Copy und Tests klar?
Wenn diese sieben Punkte tragfähig beantwortet sind, ist der Slice gegen das Gesamtziel **als Keimzelle** prüfbar — ohne das Target Model einzufordern.
@@ -47,6 +47,14 @@ Echte Mapping-Tabelle nur soweit eine besonders berechtigte Rolle es braucht (`g
Nicht übernehmen: Mitai-Admin für Körpertarife, Coupons, Training Types als Kanshō-Kern. Feature-Admin nur als Muster, wenn Entitlements genutzt werden.
## 4.1 Implementierungsstand (Schnittstellen)
**Status: Code vorhanden.** Admin-Seite `/admin/providers` und `GET/PUT /api/admin/providers`. Zeigt URL, Modell, ZDR, No-Train, `ready` und `key_present` – niemals den Secret. Key-Schreiben aktualisiert nur `backend/.env`. Generate bleibt fail-closed ohne Key/ZDR/No-Train. Kein Gateway-Bypass.
## 4.2 Implementierungsstand (Dialog-Testspur)
**Status: Code vorhanden, Testphase.** Nach jedem Dialogzug und nach Generate erhält die Admin-Rolle `decision` und `trace` in der API-Antwort. Die Journal- und Dialogseite zeigen Zweck, Prompt, Provider/Modell, Detect, maskierten Egress und Antworten. Klasse-A-Mapping bleibt unsichtbar. Ohne Admin-Rolle fehlen diese Felder. Nicht persistiert, nicht für den Regelbetrieb gedacht.
## 5. Entscheidungsstand
| Thema | Stand | Status |
@@ -83,6 +83,32 @@ Konkreter Pfad: offen, Muster übernommen.
| OpenAPI als dokumentierter Vertrag | später | offen |
| Interne service-Schicht vs. fette Router | service-Schicht | bevorzugte Richtung |
## 5.1 Implementierungsstand (MVP-Journal-API)
**Status: Code vorhanden.** Router: `backend/routers/journal.py`, Prefix `/api/journal`. Zusammenhängende Umsetzung: `mvp_implementation.md`.
Produkt-Endpunkte hinter Session-Auth, Isolation über `profile_id`:
- Spaces: `GET/POST /spaces`, `GET/PATCH /spaces/{id}`, `POST /spaces/{id}/days`
- Days: `GET /days/{id}` inkl. Conversations, Current Draft, Entries, `consolidation_offer`
- Dialog: `POST /days/{id}/conversations`, `POST /conversations/{id}/turn` (ein Modell-Call, bei Erzähler-Fortsetzung einmal Korrektur), `GET /conversations/{id}`, `DELETE /conversations/{id}` (Profil-isoliert; Nachrichten und Derived dieser Conversation gehen mit)
- Status: `GET /egress-status` (Provider bereit / fail-closed)
- Derselbe Zug auch unter `POST /api/dialogue/conversations/{id}/turn`
- Admin-Antwort zusätzlich `decision` und `trace` (Testphase)
- Generate: `POST /days/{id}/generate` nur explizit; optionale `conversation_ids`; ohne Auswahl kein stilles Mergen
- Entries: `POST /entries`, `GET /entries/{id}`, Versionen, Restore, Soft-Delete. Speichern aus einem Entwurf mit `entry_id` + `origin=accepted_draft` legt eine neue Version desselben Entry an.
- Media: Upload/GET/DELETE; Bilder und einzelne Videos; Position/Unterschrift im Entry-Body als Markdown `![…](kansho-media:<id>)`
- Tagesstichpunkte: `PATCH /days/{id}/scratch` — lokal, nicht Context-Builder
- Writing Profile: `GET /writing-profile`, Import (optional `occurred_at`, `context_hint`), Korpus `GET/POST /writing-profile/corpus`, Rebuild, `PATCH` Governance, Facet-Edit/Lock, Trait-Edit `PATCH /writing-profile/traits/{slug}`, Vorschläge annehmen/verwerfen. Brief ist eine abgeleitete Sicht aus Traits und zeitgestempelten Quellen. Media-Token werden vor dem Brief entfernt. JSON-Export/Restore: `GET /writing-profile/export`, `POST /writing-profile/restore`. Review: `GET /writing-profile/review`, `POST /writing-profile/review/paste`, `POST /writing-profile/review/api`, `POST /writing-profile/review/import`. Initial Build: `POST /writing-profile/initial-build/paste`, `POST /writing-profile/initial-build/api`. API und Copy/Paste nutzen denselben Vertrag `kansho.profile_review_package` / `kansho.profile_review_result` (`mode`, `corpus`, `existing_before_new`).
- Interaction Profile: `GET /interaction-profile`, `PATCH` Governance und Präferenzen, Vorschläge annehmen/verwerfen. Keine Ableitung aus Nicht-Widersprechen. Der Slot liegt unter `/api/journal` nur als Settings-Nachbar, nicht als Journal-Artefakt. JSON-Export/Restore: `GET /interaction-profile/export`, `POST /interaction-profile/restore`.
- Beide Profile: `GET /profiles/export`, `POST /profiles/restore` (`kind: kansho.profiles`). Kein Journal-Backup.
`/api/dialogue/*` bleibt Low-Level-Source und Admin-Diagnose, nicht die Produkt-IA. Context Builder und Retrieval liegen nicht im Frontend.
## 5.2 Implementierungsstand (Provider-Admin)
**Status: Code vorhanden.** `GET /api/admin/providers`, `PUT /api/admin/providers/{generate|detect}`. Session-Admin. Body darf einen write-only `key` enthalten; die Antwort enthält ihn nicht. Persistenz: URL/Modell/Flags in `provider_settings`, Key in `backend/.env`.
## 6. Offene Fragen
1. Internes API für mindnet/Kairo: synchron REST vs. Events? → `integrations_technical.md`
@@ -11,6 +11,8 @@ parent_document: "technische_zielarchitektur.md"
Für technische Arbeit nur die benötigten Dateien laden. Fachliche Homes nicht durch technische Kurzfassungen ersetzen. Dialog-/MVP-Stand nicht als final behandeln. **Datenschutz und Guardrails** (`../functional/guardrails.md`) sind verbindliche Invariante. Mitai-Produktrahmen weitgehend übernehmen, Gateway nicht umgehen.
**Technische Umsetzung (kanonisches Home):** `mvp_implementation.md`. **Fit-Gap-Analyse (fachlich):** `../functional/mvp_stand_und_abgleich.md` (2026-08-25). Technische Kapitel enthalten lokale Implementierungsstände; sie ersetzen weder die Umsetzungsbeschreibung noch die Fit-Gap-Analyse.
## 1. Root-Dokumente
Technisch:
@@ -41,6 +43,7 @@ Fachlich zusätzlich immer bei Querschnittsentscheidungen:
| `admin_diagnostics.md` | Diagnoseansicht |
| `voice_and_media.md` | Sprache und Transkription |
| `security.md` | Security-Baseline |
| `mvp_implementation.md` | **Kanonisches Home der technischen MVP-Umsetzung** (Laufzeit, Module, Daten, API, Pfade). Fit-Gap bleibt fachlich. |
## 3. Empfohlene Context Bundles
@@ -97,6 +100,21 @@ Fachlich zusätzlich immer bei Querschnittsentscheidungen:
3. fachlich: `../functional/fachliche_zielarchitektur.md` §2.7
4. `../functional/reflection_spaces.md` (Admin-/Developer View)
### MVP-Journal-Slice / technische Umsetzung
Kanonisches Home **wie** der Slice gebaut ist: `mvp_implementation.md`. Fachliches Fit-Gap-Home bleibt `../functional/mvp_stand_und_abgleich.md`.
1. `mvp_implementation.md`
2. `memory_storage_and_offline.md` §6.2
3. `backend_and_api.md` §5.1
4. `privacy_gateway.md` §9.1–9.2
5. `frontend_pwa_shell.md` §6.1
6. fachlich: `../functional/mvp.md`
7. `../functional/implementation_foundation.md`
8. `../functional/mvp_stand_und_abgleich.md`
9. bei Gegenlesung gegen das Gesamtziel: `../functional/produktvision_und_produktidentitaet.md`
10. bei Bedarf: `../functional/writing_profile_and_journaling.md`, `../functional/guardrails.md`
### Voice / PWA-Offline
1. `frontend_pwa_shell.md`
@@ -113,5 +131,5 @@ Vor Vereinfachungen die Invariantenliste in `technische_zielarchitektur.md` §3.
## 5. Code-Gerüst
Lokaler Produktrahmen in `frontend/` und `backend/`. Auth, Nutzerverwaltung, Prompt-DB, Platzhalter, Feature-Check, Privacy-Gateway-Stub. **Dialog-Layer 0:** Conversations/Messages/`usage_sessions`, Thread-/Space-Identität, Derived-Hülle mit Provenance. Keine Dialog-IA, keine Domain-Prompts, kein Stripe. SQLite nur lokal.
Lokaler Produktrahmen in `frontend/` und `backend/`. Zusammenhängende technische Umsetzung: `mvp_implementation.md`. Auth, Nutzerverwaltung, Prompt-DB, Platzhalter, Feature-Check, Privacy Gateway. **Dialog-Layer 0:** Conversations/Messages/`usage_sessions`, Thread-/Space-Identität, Derived-Hülle mit Provenance. **MVP-Journal-Slice:** nutzersichtbare Spaces, Journal Days, Dialogzug (ein Call), explizite Draft-Generierung, versionierte Entries (Übernehmen = neue Version, Dirty-Schutz im Editor), Inline-Medien, lokale Stichpunkte ohne Egress, Writing Profile (Hülle mit dynamischen Traits, Initial Profile Build). Fit-Gap: `../functional/mvp_stand_und_abgleich.md` (2026-08-25). Konfigurierbare Prompts `mvp.dialogue_turn`, `mvp.journal_generate`, `mvp.entity_detect`, `mvp.profile_review`. Provider-URL/Modell/Policy unter Admin → Schnittstellen; Keys nur in `backend/.env`. Schichten: Maskierung, Dialogzug, Journalentwurf, explizite Profile-Review. Admin-Testspur am Dialogzug (Egress, Antwort, Operation). Privacy-Pfad durchgängig, Security Layer nicht vollständig (`privacy_gateway.md` §9.2). Kein Stripe, keine Threads-UI, kein semantisches Retrieval. SQLite nur lokal.
@@ -74,6 +74,26 @@ Business-Logik bleibt im Backend (`backend_and_api.md`).
| Kanshō-Startroute / endgültige IA | folgt späterem Fachstand | offen |
| Desktop-Mehrspalten | späterer Fach-/UX-Stand | offen |
## 6.1 Implementierungsstand (MVP-Journal-Routen)
**Status: Code vorhanden, keine finale Start-IA.** Technische Umsetzung der Routen: `mvp_implementation.md` §6. Fit-Gap zu Produktstart und `/dialog`: `../functional/mvp_stand_und_abgleich.md`.
Die Shell-Nav bleibt Start / Dialog / Journal / Einstellungen. Der MVP-Slice füllt `/journal`:
- `/journal` Space-Liste
- `/journal/:spaceId` Chronologie
- `/journal/:spaceId/:dayId` Dialog, Generate und lokale Tagesstichpunkte
- `/journal/:spaceId/:dayId/entry` Fließtexteditor (Markdown, Inline-Bild/Video, Versionen, Dirty-Flag)
- `/journal/:spaceId/:dayId/source/:conversationId` Quelldialog
`/` bleibt dünn und verweist auf das Journal. `/dialog` ruft in der Testphase denselben Dialogzug auf wie der Journal Day (`POST .../turn`), bleibt aber ohne Space-Chronologie und ist nicht die zweite Produkt-IA. Home wird kein Dashboard. Der Journal-Editor führt ein Dirty-Flag; In-App-Navigation mit ungespeicherten Änderungen wird bestätigt. Stichpunkte: Return erzeugt eine neue Zeile und fokussiert sie.
Admin sieht unter dem Gespräch eine **Testspur**: intern gerenderter Prompt, maskierter Egress, Rohantwort, demaskierte Antwort, gewählte Dialogoperation. Keine Mapping-Tabelle. Nicht die produktive Nutzer-IA.
Die Dialogfläche bleibt in der Inhaltsäule der Shell. Lange Nachrichten und die Testspur umbrechen oder scrollen intern; sie dürfen die Seite nicht in der Breite aufweiten.
Mobile (unter 1024px): Bottom-Nav, Kopfzeile, volle Breite, Safe-Area, Gespräche als kompakte Umschalter oben, Verlauf scrollt, Eingabe darunter in Daumennähe, Stichpunkte unter dem Dialog. Desktop (ab 1024px): Sidebar, Lesespalte für Standardseiten, Dialogfläche voll in der Inhaltsäule, Stichpunkte rechts daneben. Kein weiterer Breakpoint. Der Journal-Tag zeigt den Dialog zuerst; Draft und Einträge nur als kurze Verweise. Mehrere Gespräche werden erst beim Erzeugen des Tagebuchs zur Wahl gestellt.
## 7. Offene Fragen
1. Welche Platzhalter-Routen bleiben in der ersten Rahmen-Kopie sichtbar, welche werden ausgeblendet, bis Fachseiten existieren?
@@ -136,6 +136,30 @@ Layer-0-Tabellen `usage_sessions` (nicht Auth-`sessions`), `conversations`, `mes
Nicht enthalten: Entry-IA, Fadenerkennung, Thread-Enum, Summaries über das Gateway.
## 6.2 Implementierungsstand (MVP-Journal-Slice)
**Status: Code vorhanden für den ersten vertikalen Slice.** Technische Umsetzung: `mvp_implementation.md`. Fachhome: `../functional/mvp.md`. Foundation: `../functional/implementation_foundation.md`. Fit-Gap (Code gegen Slice und Gesamtziel): `../functional/mvp_stand_und_abgleich.md`.
Zusätzlich zu Layer 0:
- `spaces` mit `visibility='user'` ist der sichtbare Reflection Space (anlegen, umbenennen, auswählen).
- `journal_days` ist die chronologische Bezugseinheit `(space_id, calendar_date)`. Kalendertag und `messages.created` bleiben getrennt. `scratch_json` hält optionale Tagesstichpunkte (lokal, kein KI-Kontext).
- `conversations.space_id` / `journal_day_id` sind Primary Assignment, nicht Identität. Alte Conversations ohne Assignment bleiben außerhalb des Journals.
- `journal_drafts` sind Derived: neue Generierung historisiert den vorigen Draft und lässt `journal_entries.current_version_id` unangetastet.
- `journal_entries` + `journal_entry_versions` tragen Current Validity und History; Soft-Delete über `deleted_at`. Übernehmen eines Entwurfs schreibt eine neue Version des bestehenden Entry (`origin=accepted_draft`), sofern nicht ausdrücklich ein weiterer Entry angelegt wird. Die aktuelle Fassung steht in der Versionsliste ohne Restore auf sich selbst.
- `media_assets` verweisen auf lokale Dateien unter `backend/data/media/`. Einbettung und Unterschrift stehen im Entry-Body als Markdown, nicht als eigene Caption-Tabelle.
- `writing_profiles` / `writing_profile_sources` halten den Current Brief. Quellenpriorität: finale Nutzerfassungen, Importe, Dialogstil (`dialogue_style` aus `user:`-Zeilen). Quellen tragen `occurred_at` und `context_hint`. KI-Drafts sind keine Stilquelle. Der Brief ist eine abgeleitete Sicht.
- `writing_profiles.lifecycle` (`uninitialized` | `initial_pending` | `confirmed`) trennt Korpus-Sammlung vom kontinuierlichen Lernen. `writing_profile_traits` / `writing_profile_trait_refs` sind die dynamischen semantischen Merkmale inkl. Evidence und Exemplaren. `writing_profile_facets` bleiben Layer-Hüllen (Core/context/output), kein festes Stilraster.
- `writing_profiles.governance` (`learning` | `advising` | `frozen`) und Locks verhindern stilles Voll-Überschreiben. `writing_profile_suggestions` trägt advising-Vorschläge (auch `trait_slug` / `action`).
- `writing_profiles.version` / `review_ready` / `last_reviewed` plus `writing_profile_evidence`, `writing_profile_reviews`, `writing_profile_versions` tragen die Review-Pipeline: lokale Evidenz, gebündelte Pakete, API- oder Paste-Kanal, nachvollziehbare Facet-Stände. Kein Re-Infer nach jedem Save.
- Portable JSON-Dokumente (`kansho.writing_profile`, `kansho.interaction_profile`, `kansho.profiles`) exportieren Facets/Prefs/Governance, nicht Journalquellen oder Identity-Mapping.
- `interaction_profiles` / `interaction_preferences` / `interaction_suggestions` sind getrennt vom Writing Profile. Default-Governance `advising`. Starke Quellen nur explizit/manuell/angenommener Vorschlag.
- `conversations.emotional_intensity` / `long_story` sind operative Dialogue-State-Felder, kein User-Fakt.
`derived_records` bleibt die generische Layer-0-Hülle und ist nicht der Journal-Store. `handoffs.target='journal'` ist kein Schreibpfad für Einträge.
Nicht enthalten: Threads-UI, Related Spaces, semantisches Retrieval, Session-Summaries, Voice, Space Content Memory. Der Dialogzug sieht denselben Journal Day vollständig und dazu die letzten Journal Entries des Spaces als Recency-Ausschnitte. Die Journalgenerierung bekommt denselben Tagesdialog inklusive Kanshō-Impulse als Gesprächskontext, nicht als Erlebtes.
## 7. Offene Fragen
1. IndexedDB vs. SQLite-WASM vs. nur Service-Worker-Queue?
@@ -0,0 +1,323 @@
---
title: "Kanshō – Technische Umsetzung des MVP-Journal-Slices"
status: "Arbeitsstand"
date: "2026-08-25"
product_family: "Jinkendo"
document_role: "Technical Chapter / MVP Implementation How-To / Module and Runtime Map"
parent_document: "technische_zielarchitektur.md"
---
# Kanshō – Technische Umsetzung des MVP-Journal-Slices
**Kanonisches Home** dafür, *wie* der erste vertikale Slice gebaut ist: Laufzeit, Module, Daten, API, Pfade.
Nicht dieses Dokument:
- Fachlicher Lieferumfang → `../functional/mvp.md`
- Foundation-Regeln → `../functional/implementation_foundation.md`
- Fit-Gap (Spec, Abweichungen, offene Punkte gegen Slice und Gesamtziel) → `../functional/mvp_stand_und_abgleich.md`
Kapiteldetails (Auth, Gateway-Verfahren, Shell-Muster) bleiben in den jeweiligen technischen Homes. Hier die zusammenhängende Umsetzung.
**Stand:** 2026-08-25, Code unter `frontend/` und `backend/`. Architecture-Correction-Pass am selben Tag (relationale Source-Refs, Selection-Specs, begrenztes Space-Source-Retrieval, Detect-Env, Response Validation, Konsolidierungssignale, `/dialog` als Admin-Harness).
---
# 1. Laufzeit
Lokal, eine Instanz, ein Profil-Nutzer nach Setup:
| Prozess | Stack | Port | Einstieg |
|---|---|---|---|
| Frontend | React 18, Vite, React Router 6, PWA-Plugin | **5188** (`strictPort`) | `frontend/` → `npm run dev` |
| Backend | FastAPI, Python 3.12, Uvicorn | **8018** | `backend/` |
| Persistenz | **SQLite** Datei | — | `backend/data/kansho.sqlite` |
| Medien | lokale Dateien | — | `backend/data/media/<profile_id>/` |
| Secrets | Env | — | `backend/.env` (Keys nie in der DB) |
Proxy: Vite leitet `/api` an 8018. CORS erlaubt `localhost:5188`.
**Abweichung vom technischen Zielrahmen:** `product_frame_and_stack.md` nennt PostgreSQL. Der Slice läuft auf SQLite. Lokal zulässig; Prod-Pfad offen. Siehe Fit-Gap.
Health: `GET /api/health`.
---
# 2. Schichten und Invariante
```text
PWA (React)
→ /api Session-Cookie
FastAPI-Router (kein Prompt-Bau im Frontend)
→ journal_policy / stores
→ context_builder + retrieval (intern, Klartext, nie Egress)
→ privacy_gateway (einziger generativer Egress)
Policy → Maskierung → Detect (Testphase) → Generate-Call → Validierung → Demask
→ SQLite + media/
```
Persönlicher Kontext geht nicht direkt an OpenRouter. Router rufen kein LLM. Fail Closed: kein unsicherer Generate-Fallback.
Zwei Provider-Rollen (`provider_settings`): `detect` (Maskierung) und `generate` (Dialogzug und Journalentwurf). URL/Modell/Flags in der DB, Key in `.env`. Admin: Schnittstellen.
---
# 3. Backend-Module
Einstieg: `backend/main.py` (Router: auth, users, dialogue, journal, prompts, placeholders, subscription, admin).
| Modul | Verantwortung |
|---|---|
| `routers/journal.py` | Produkt-API `/api/journal` |
| `routers/dialogue.py` | Low-Level-Source `/api/dialogue`; derselbe Turn-Pfad |
| `dialogue_turn.py` | Ein generativer Call, JSON `{operation, impulse}`, lokale Register-/Wächter, optional Repair |
| `journal_generate.py` | Expliziter Draft-Call |
| `journal_store.py` | Days, Drafts, Entries, Versionen, Scratch |
| `journal_policy.py` | Explizites Generate, Origins, Konsolidierungsangebot aus lokalen Signalen |
| `journal_body.py` / `journal_shape.py` | Titel, Markdown-Body, lokale Nachformung |
| `context_builder.py` | Interner Prompt-Kontext über Selection-Specs, keine Recency-API |
| `retrieval.py` | Austauschbare Specs: `day_messages`, `space_entries`, `space_recent_sources`, `writing_profile`. Recency/SQL-Kappen sind Implementierung. |
| `conversation_signals.py` | Lokale operative Metadaten (`narrative_mode`, `reflection_depth`, `current_focus`), kein Extra-LLM |
| `privacy_gateway.py` | Egress; Response Validation vor Demask |
| `entity_detect.py` / `pronoun_bind.py` / `identity_store.py` | Detection, Dialog-Pronomen, Mapping (Klasse A) |
| `writing_profile_store.py` | Lokaler Journal-Stilbrief, Facets, Governance, kein Extra-LLM, keine Dialogsteuerung |
| `profile_review.py` | Lokale Evidence-/Drift-Erkennung, Review-Pakete, API- und Paste-Kanal; kein Call nach jedem Dialog |
| `writing_profile_infer.py` | Lokale Heuristik für Facets, kein LLM |
| `media_store.py` | Upload, Datei, Token im Body |
| `providers.py` / `provider_settings.py` | Provider-Rollen |
| `db.py` + `schema.sql` | SQLite, Migrationen |
Prompts in der DB, nicht im Anwendungscode: `mvp.dialogue_turn`, `mvp.journal_generate`, `mvp.entity_detect`, `mvp.profile_review`. Seed: `backend/config/prompts.seed.json`. Unangetastete Templates aktualisiert `init_db`.
---
# 4. Daten (Ist, nicht Ziel-PostgreSQL)
Schema: `backend/schema.sql`. Isolation über `profile_id`.
**Rahmen / Layer 0:** `profiles`, Auth-`sessions`, `usage_sessions`, `conversations`, `messages`, Thread-/Space-Hüllen, `derived_records` (ungenutzt für Journal-Writes), `identity_mappings`, Prompt-/Feature-/Provider-Tabellen.
**Journal-Slice:**
| Tabelle | Rolle |
|---|---|
| `spaces` | Sichtbarer Reflection Space (`visibility='user'`) |
| `journal_days` | `(space_id, calendar_date)`; `scratch_json` lokal |
| `journal_drafts` | Derived; neue Generierung historisiert den Draft |
| `journal_entries` | Current über `current_version_id`; Soft-Delete `deleted_at` |
| `journal_entry_versions` | History; Restore hängt eine Version an |
| `journal_draft_source_refs` / `journal_entry_version_source_refs` | Relationale Provenance (Conversation/Message-IDs). JSON-Listen sind Altbestand und werden beim Start migriert. |
| `media_assets` | Datei + Kind; Referenz nur im Body `![…](kansho-media:<id>)` |
| `writing_profiles` / `writing_profile_sources` | Current Brief |
| `writing_profile_evidence` / `writing_profile_reviews` / `writing_profile_versions` | Review-Pipeline: lokale Evidenz, Paket/Ergebnis, Versionen |
Assignment: `conversations.space_id` / `journal_day_id` sind Felder, nicht Identität. `space_id` ohne `journal_day_id` ist zulässig (Space ≠ Journal-Container). `conversations.space_id` ohne FK. Kalendertag ≠ `messages.created`. Operative Dialogsignale liegen als Felder auf `conversations`, nicht als Writing Profile.
Details: `memory_storage_and_offline.md` §6.1–6.2.
---
# 5. API (Produkt)
Prefix `/api/journal`, Session-Auth, Router `backend/routers/journal.py`. Vollständige Liste: `backend_and_api.md` §5.1.
Kernpfade:
1. **Dialogzug** `POST /days/{id}/conversations/{cid}/turn` und `POST /api/dialogue/conversations/{id}/turn`
Context Builder → Gateway (`purpose=dialogue_turn`) → ein Generate-Call → Impuls speichern. Pronomenbindung nur hier in `user:`-Zeilen.
2. **Journalentwurf** `POST /days/{id}/generate`
Nur explizit. Optional `conversation_ids`. Ohne Auswahl kein stilles Mergen. Gateway `purpose=journal_generate`. Pronomen ungebunden. Entry-`current_version_id` bleibt unangetastet. UI öffnet `?draft=1`.
3. **Speichern** `POST /entries`
Mit `entry_id` + `origin=accepted_draft`: neue Version desselben Entry. Sonst neuer Entry oder `user_edit`.
4. **Restore** `POST /entries/{id}/restore` → neue Version, Origin `restore`.
5. **Scratch** `PATCH /days/{id}/scratch` → nicht im Context Builder, Test: Token nicht im Egress.
6. **Media** Upload/GET/DELETE unter dem Entry.
7. **Profile Review** `GET/POST /writing-profile/review…` → lokale Evidenz, explizite API- oder Paste-Review, kein Call am Dialogzug.
`include_existing` existiert in der API, die UI setzt es nicht.
Fehlerkörper oft `{detail: {code, message}}`, Rahmen will `{detail: string}` — Abweichung, Fit-Gap.
---
# 6. Frontend-Umsetzung
Shell: `frontend/src/App.jsx`, Nav `config/appNav.js` (Start / Journal / Einstellungen; Admin extra). `/dialog` ist nicht in der Produkt-Nav. Breakpoint 1024px: Bottom-Nav vs Sidebar. Details: `frontend_pwa_shell.md` §6.1.
| Route | Seite | Technik |
|---|---|---|
| `/` | `HomePage.jsx` | Stub, Link zum Journal |
| `/dialog` | `DialoguePage.jsx` | **Admin-only Dev/Test-Harness**, nicht in der Produkt-Nav. Unzugeordnete Conversations. |
| `/journal` … `/journal/:spaceId/:dayId` | Spaces, Space, `JournalDayPage.jsx` | Chat, Generate, `DayScratch.jsx` |
| `…/entry` | `JournalEditorPage.jsx` | TipTap, Markdown in `journal/document.js`, Dirty-Flag `context/UnsavedChanges.jsx` |
| `…/source/:conversationId` | `JournalSourcePage.jsx` | Quelldialog |
| `/settings` | `SettingsPage.jsx` | Writing/Interaction, Review-Paket (API oder Copy/Paste) |
Editor speichert Markdown, nicht HTML. Medien-Token bleiben lokal. Dirty: In-App-Links, Abmelden, `beforeunload`; Browser-Zurück nicht hart blockiert.
---
# 7. Zwei fachliche Calls, drei technische Schichten
| Schicht | Rolle | Call |
|---|---|---|
| Maskierung | `detect` | Muster immer. Externes Klartext-Detect nur Development/Test (`KANSHO_ENV`). Produktiv: Muster oder lokale Detect-URL. |
| Dialogzug | `generate` | Operation + Impuls |
| Journalentwurf | `generate` | Explizit, getrennt |
Explizite Writing-Profile-Review ist ein weiterer Generate-Zweck (`profile_review`), nicht der Dialogzug und nicht nach jedem Turn.
Interner Context-Builder (Klartext, lokal): fordert Selection-Specs an (`day_messages`, `space_entries`, `space_recent_sources`, `writing_profile`). Recency-Kappen (Day 80 Messages; 5 Space-Entries × 400 Zeichen; 3 Space-Source-Conversations × 400 Zeichen User-Ausschnitt) liegen in `retrieval.py`, nicht in der Context-Builder-API. Dialogzug: aktuelle Conversation primär, plus begrenzte frühere Original-Conversations desselben Space (ohne denselben Journal Day voll zu laden). Generate ohne Prior-Entries, mit Writing Profile. `WritingProfile` steuert Journaltext, nicht den Dialogue Kernel; der Turn hat einen leeren `interaction_hint`-Slot. Retrieval austauschbar, keine Embeddings.
Gateway-Verfahren und offener Security Layer: `privacy_gateway.md` §9.1–9.2.
---
# 8. Tests (technisch)
| Suite | Ort |
|---|---|
| Rahmen, Auth | `backend/tests/test_frame.py` |
| Journal-Slice, Scratch-Egress, Versionsschutz | `backend/tests/test_mvp_journal.py` |
| Architecture Correction (Provenance, Space-Source, Detect-Env, Kernel-Grenzen) | `backend/tests/test_architecture_correction.py` |
| Detect, Pronomen Dialog vs Journal, Response Validation | `backend/tests/test_privacy_detect.py` |
| Shape / Namen | `backend/tests/test_journal_shape.py` |
| Writing Profile | `backend/tests/test_writing_profile.py` |
| Profile Governance | `backend/tests/test_profile_governance.py` |
| Profile Review Pipeline | `backend/tests/test_profile_review.py` |
| Writing-Profile-Hülle / Initial Build | `backend/tests/test_profile_review.py`, `backend/tests/test_profile_governance.py` |
| Markdown-Runde | `frontend/src/journal/document.test.js` |
Tests beweisen API-Verträge und Invarianten, nicht Dialogqualität.
---
# 9. Technische Abweichungen und nicht gebaut
Nur die **technische** Lage. Bewertung gegen Spec und Vision: Fit-Gap.
| Thema | Ist | Zielrahmen / Produktiv |
|---|---|---|
| DB | SQLite Datei | PostgreSQL |
| Detect | Muster immer; externes Klartext-Detect nur Development/Test; Produktiv fällt auf Muster zurück. Lokales HTTP-Detect bleibt Provider-Rolle. | lokales Modell (Ollama) als Ziel |
| Fehlerkörper | oft Objekt | `{detail: string}` |
| `/dialog` | Admin-Harness, aus der Produkt-Nav entfernt | nicht MVP-Screen |
| Response Validation | blockiert Klartext-Identität in der Rohantwort vor Demask; keine Quasi-Identifikatoren | `privacy_gateway.md` §9.2 voll |
| Security Layer | Pfad da; Minimierung/Audit/Encryption fehlen weiter | `privacy_gateway.md` §9.2 |
| Offline-Sync, Voice-Egress, Compose-Prod | ungebaut | jeweiliges Kapitel |
Nicht im Code: Threads-UI, semantisches Retrieval, Session-Summaries, Related-Space-UI, Papierkorb-UI, lokales Detect-Modell, Obsidian/mindnet/Kairo-Handoff.
---
# 11. Korrigierter Ist-Stand vs. bewusst offene Target-Fähigkeiten
Additiv zum Slice, 2026-08-25. Kein Target-Model-Vorbau.
**Korrigiert im Ist:**
- Provenance von Draft und Entry-Version ist relational (`journal_*_source_refs`); JSON-ID-Listen werden verlustfrei migriert. Source-Messages bleiben unangetastet.
- Context Builder spricht Selection-Specs; Recency bleibt die aktuelle Retrieval-Heuristik, nicht die fachliche API.
- Dialogzug kann begrenzte jüngere Original-Conversations desselben Space sehen, ohne denselben Journal Day voll zu laden.
- Externes Klartext-Detect ist kein Produktmodus (`KANSHO_ENV=production` fällt auf Muster zurück). Lokales Detect bleibt austauschbare Rolle.
- Response Validation blockiert Klartext-Identität vor Demask.
- Konsolidierung nutzt lokale Signale, nicht `count >= 2`.
- `/dialog` ist Admin-Harness, nicht Produkt-IA.
- `WritingProfile` hängt nicht am Dialogue Kernel; `interaction_hint` ist ein leerer Slot.
- Conversation kann einem Space ohne Journal Day zugeordnet werden.
**Bewusst offen (nicht in diesem Pass gebaut):**
- Semantisches/globales Retrieval, Threads, Self Model, Related Spaces, mindnet
- Interaction-Profile-Engine, UI und Persistenz
- Reflection-Space-Typen, Journal-Default am Gesprächsabschluss
- Lokales Detect-Modell, Audit ohne Prompt, Encryption, inhaltliche Minimierung
- Stub-Home / Contextual Continuation als Start-IA
---
# 12. Profile Governance (2026-08-25)
Additiv zu §11. Kein Self Model, keine Intent-Engine, kein ML-Training.
**Writing Profile**
- Ein Profil als Hülle: Core, optionale Facets, dynamische Traits. Die früheren Stilschlüssel sind Seed, nicht Schema. `compiled_brief` bleibt abgeleitete Sicht aus Traits und zeitgestempelten Quellen.
- Governance `learning` | `advising` | `frozen`. Automatische Pfade (Turn, Save, Import, Bootstrap) überschreiben keine Locks und keine manuellen/angenommenen Facets. `frozen` hält Facet-Werte. Explizites Rebuild ehrt Locks.
- Rückwirkender Bootstrap aus gespeicherten Current-Entries. Unredigierte Drafts bleiben keine Stilquelle. Dialog ist schwächer und entfällt als Stimme, sobald Entries existieren.
**Interaction Profile**
- Getrennt, Default `advising`. Produktdefaults (Antwortlänge, ein Anschlussimpuls, Zuhören bei Erzählung) sind gelabelt und überschreibbar.
- `{{interaction_hint}}` füllt sich aus Defaults + persönlichen Prefs + aktuellem Dialogue State. Nicht-Widersprechen ist kein Lernsignal. `propose_observation` legt höchstens Suggestions an und wird nicht aus `run_turn` aufgerufen.
- Keine Intent-Taxonomie. Reflection Intent bleibt ungebaut. Dialogue State (`narrative_mode`, `reflection_depth`, `current_focus`, `emotional_intensity`, `long_story`) bleibt automatisch.
Kleine Settings-Erweiterung: Lifecycle/Initial Build, dynamische Traits statt festem Facet-Raster, Prefs, Vorschläge. Keine Profile-Management-App.
JSON-Portabilität (additiv): `kind` `kansho.writing_profile` / `kansho.interaction_profile` / `kansho.profiles`, `format_version` 1. Restore ersetzt Facets/Prefs und Governance ausdrücklich; Journalquellen, Dialoge und Identity-Mapping gehören nicht ins Dokument.
---
# 13. Profile Review Pipeline (2026-08-25)
Additiv zu §12. Keine neue Profil-Engine.
Nach Save/Import/Turn werden semantische Traits **nicht** neu berechnet. Der frühere Bootstrap-Infer über Zählfacetten entfällt; Quellen werden nur assembliert. Kontinuierliche Queue erst nach bestätigtem Initial Build (§14). Danach:
1. lokale Evidence-/Drift-Erkennung (billig, ohne LLM)
2. Review Candidates in `writing_profile_evidence`
3. semantische AI Review nur explizit, Evidenzen gebündelt
4. Governance entscheidet die Übernahme (`learning` wendet unlocked an, `advising` queued Suggestions, `frozen` nicht)
5. `writing_profile_versions` hält den Stand nachvollziehbar
Writing-Trigger: starke User-Änderung eines AI-Drafts, heuristische Abweichung, Stichprobe längerer Dialogtexte (Cooldown, kein LLM), periodische Bereitschaft nach Zeit/Volumen, explizite Nutzer-Review.
AI Review vergleicht Evidenz mit dem bestehenden Profil und liefert Änderungsvorschläge (`keep`/`update`), kein komplettes neues Profil. Paket unterscheidet `core` und `facet` und darf repräsentative Source-Beispiele an Merkmalen führen.
API (`POST /writing-profile/review/api`) und Copy/Paste (`POST .../paste` plus `.../import`) nutzen denselben Vertrag: `kansho.profile_review_package` / `kansho.profile_review_result`. Paste erzeugt lokal einen kopierbaren Prompt; das Ergebnis kommt strukturiert zurück. Interaction-Präferenzen entstehen nicht aus fehlendem Widerspruch oder normalem Gesprächsverlauf.
Das statische Facet-Raster aus §12 ist **nicht** die Profilstruktur. Semantische Traits und der Initial Profile Build: §14.
---
# 14. Writing-Profile-Hülle und Initial Build (2026-08-25)
Additiv zu §12 und §13. Keine neue große Engine.
Stabile Hülle, nicht ein geschlossenes Merkmalsraster:
1. Core
2. optionale context/output-Facets
3. darin dynamische semantische Traits (datengetriebene Slugs)
4. Evidence References
5. Representative Exemplars
6. Governance
7. Versioning
`rhythm`, `humor`, `detail`, `chronology` und verwandte Keys bleiben **Seed-/Ordnungshilfe** (`seed_catalog`). UI, Persistenz und Review binden sich nicht an diese Liste. Lokale Heuristiken (`writing_profile_infer`) sind Mess- und Triggerhilfe; sie schreiben keine Traits.
Lifecycle: `uninitialized` → `initial_pending` → `confirmed`. Quellen (Journal und Import) tragen `occurred_at` und `context_hint`. Neuere Texte wiegen stärker für die aktuelle Ausprägung, ältere belegen Langzeitmerkmale. Urlaubstagebücher mappen auf `autobiographical_journal`. Ein globaler Core wird nur geschrieben, wenn der Korpus unterschiedliche Quellenarten trägt.
Initial Profile Build liest den historischen Korpus (nicht nur zwei Entries). Review-Aktionen folgen Existing-before-New: bestätigen, präzisieren, Scope ändern, zusammenführen/aufteilen, erst dann neu anlegen. Kontinuierliches Learning/Advising (Queue, Drift, Dialog-Sample) startet erst nach bestätigtem Build.
API additiv: `POST /writing-profile/corpus`, `GET /writing-profile/corpus`, `PATCH /writing-profile/traits/{slug}`, `POST /writing-profile/initial-build/paste`, `POST /writing-profile/initial-build/api`. Paketvertrag bleibt `format_version` 1 mit zusätzlichen Feldern `mode`, `corpus`, `existing_before_new`, `seed_catalog`.
Tests: `backend/tests/test_profile_governance.py`, `backend/tests/test_profile_review.py`.
---
# 10. Querverweise
- Fit-Gap: `../functional/mvp_stand_und_abgleich.md`
- API-Liste: `backend_and_api.md` §5.1
- Tabellen: `memory_storage_and_offline.md` §6
- Egress: `privacy_gateway.md` §9
- Routen: `frontend_pwa_shell.md` §6.1
- Stack-Ziel: `product_frame_and_stack.md`
- Ports: `runtime_and_deploy.md`
@@ -109,7 +109,7 @@ Fachliche Reflexions-Workflows (Tagesreflexion, Journal-Entwurf, …) werden **s
- Debug-Responses mit Klarnamen oder vollem Internal Context.
- Vermischung von `{{key}}` (Kontext) und `[[ROLE]]` (Privacy).
Modellname darf vorerst Env-Default sein; Routing-Policy später über Konfiguration, nicht über neue Executoren.
Modellname und Endpoint-URL liegen in Admin-Konfiguration (`provider_settings`); Secrets bleiben Env. Routing-Policy später über Konfiguration, nicht über neue Executoren.
---
@@ -123,6 +123,7 @@ Ziel wie Mitai: **Einfachheit in der Nutzer-UX, Differenzierung in administrierb
- Feature-Definitionen und Limits (wenn Entitlements genutzt werden)
- UI-Katalog: welche Karten/Nav-Beiträge sichtbar, Layout-Overrides
- System-Prompts vs. Instanz-Anpassungen (Reset auf Default)
- Provider-URL, Modell und ZDR/No-Train für Generate und Detect (`provider_settings`, Admin Schnittstellen)
- später: Privacy-Profile (Strict/Balanced), sobald fachlich konkret
### 4.2 Code / Env (nicht pro Klick im Admin)
+49 -1
View File
@@ -101,7 +101,55 @@ Interview H1 (Encryption at rest, vollständiges Löschen, Portabilität, DSFA b
| OpenRouter | Kandidat, nicht Gateway-Ersatz | entschieden |
| EU-Routing | bevorzugt | offen in Ausprägung |
| Encryption at rest, Delete, DSFA | Phase H | offen |
| Implementierung Entity Detection | deterministisch vs. KI-gestützt | offen |
| Implementierung Entity Detection | Wörterbuch + optionaler Detect-Provider; Qualität offen | bevorzugte Richtung im Code, nicht abgeschlossen |
## 9.1 Implementierungsstand (MVP-Egress)
**Status: Code vorhanden. Zwei getrennt konfigurierbare Provider.** Fit-Gap und Guardrail-Abstand (Detect-Testphase, Security Layer): `../functional/mvp_stand_und_abgleich.md`.
`backend/privacy_gateway.py` ist die einzige Stelle für den **generativen** Egress. Reihenfolge: Policy-Check → lokale Wörterbuch-Maskierung mit Wortgrenzen (kein Teilstring, kein `ich` in `nicht`) → Entity Detection nur auf user-Zeilen (Muster + Wörterbuch, in der Testphase zusätzlich OpenRouter-Detect) → Remaskierung: im Dialogzug nur `user:`/`assistant:`-Zeilen, beim Journalentwurf der ganze Prompt → ein Generative-Call nur mit Platzhaltern → Antwortprüfung → Demaskierung.
Detect-Vorschläge werden nur gespeichert, wenn das Wort im user-Text steht, kein Funktions- oder Stoffwort ist und nicht zum Promptvokabular gehört. `mit` plus Allerweltsnomen (`mit Getöse`) ist kein Personenname; `mit Anna` bleibt einer. Bereits gespeicherte unzulässige Labels werden beim nächsten Detect entfernt.
Intern in der Testspur ist keine dritte Anfrage, sondern die lokale Klartext-Vorlage desselben Dialogzugs. Detect und Dialogzug bleiben getrennte Calls.
Pronomen werden nicht als eigene Detect-Treffer gespeichert. Nach der Namensmaskierung bindet eine lokale Schicht **im Dialogzug** in `user:`-Zeilen `er`/`sie`/`ihm`/`ihr` an das letzte kompatible Person-Token, damit das Sprachmodell dieselbe Person sieht. **Beim Journalentwurf bleiben diese Pronomen ungebunden**, sonst macht die Demaskierung aus jedem Bezug den Klarnamen. Anrede-`ihr` und pluralisches `sie` bleiben ungebunden. Dieselbe Person behält ein Token; `PERSON:KURZ` ist kein Mapping. Ein Personenname, der auch eine Sache ist, wird bei Verwandtschaftswort maskiert und bei Verben wie essen/kochen/kaufen davor oder danach als Sache stehen gelassen (`Sushi essen`, `esse Sushi`).
Zwei Provider, getrennt konfigurierbar (`providers.py`, Admin **Schnittstellen**):
Drei Schichten, zwei technische Endpunkte (`provider_settings`-Rollen `generate` / `detect` sind Implementierungsnamen):
- **Maskierung** (Rolle `detect`): nur schützenswerte Muster. Keine Operation, kein Impuls, kein Journaltext. Testphase: OpenRouter-Detect auf user-Zeilen. Produktivziel: Muster + lokales Modell. Wiederverwendbar für spätere Dialogtypen.
- **Sprachmodell** (Rolle `generate`): maskierter Kontext. Dient zwei fachlichen Calls: **Dialogzug** (Operation + Impuls) und **Journalentwurf** (explizit). Das größere Modell gehört hierhin, nicht an die Maskierung.
URL, Modell und Policy liegen in `provider_settings` (Seed `config/providers.seed.json`, Admin `GET/PUT /api/admin/providers`). Keys nur in `backend/.env`, nie in der DB und nie in der API-Antwort. Env überschreibt Admin-Werte, wenn gesetzt.
Lokale URLs (localhost / 127.0.0.1) brauchen keine ZDR-Flags. Die Mapping-Tabelle bleibt Klasse A und lokal; neue Treffer werden dort persistiert, damit der nächste Prompt dieselben Platzhalter per Muster nutzen kann, ohne Detection-Call.
Klasse A verlässt die Zone nicht. Mapping wird nicht mitgeschickt. Kein stiller Fallback auf einen unsicheren Generate-Provider.
Prompts für Dialog, Journal, Detection und Profile-Review liegen in der DB (`mvp.dialogue_turn`, `mvp.journal_generate`, `mvp.entity_detect`, `mvp.profile_review`), nicht im Anwendungscode.
`mvp.dialogue_turn` bleibt ein generativer Call (Foundation: ein Hauptcall pro Turn). Ton, Tiefe und Erzählmodus kommen lokal als `register_hint` plus Writing-Profile-Hinweis in denselben Prompt, nicht als zweites Modell. JSON `{operation, impulse}`. Persistiert wird nur `impulse`.
Admin-Testspur (`trace`) zeigt intern gerenderten Prompt und maskierten Egress. Das ist ein bewusster Test-Einblick, nicht der fachliche Default aus §2 (Diagnose ohne volle Prompts). Mapping-Tabelle bleibt ausgeschlossen.
## 9.2 Offene Implementierungspunkte (Security Layer)
**Status: bewusst offen.** Der MVP-Pfad ist durchgängig, der fachliche Security Layer aus `../functional/guardrails.md` ist **nicht vollständig** implementiert. Für Testdaten akzeptabel; nicht als abgeschlossen führen.
Noch offen im Code:
1. **Inhaltliche Context Minimization.** Es geht der zusammengebaute Dialog, nur durch eine Zeichenkappe begrenzt. Minimum-sufficient-context nach Aufgabe fehlt.
2. **Robuste Entity Detection.** Wörterbuch plus Muster plus Detect-Call. Testphase: externes kleines Modell über OpenRouter. Ziel: lokales Ollama. Keine belastbare Erkennung von Quasi-Identifikatoren (Beruf + Ort + Familie, seltene Konstellationen).
3. **Response Validation.** Es wird nur auf leere Antworten geprüft. Keine Prüfung, ob Platzhalter erhalten blieben oder das Modell Klarnamen erraten hat.
4. **Audit ohne Prompt-Inhalt.** Es gibt keine persistente Audit-Spur (Request-ID, Policy, Provider, ZDR-Status, maskierte Entitätstypen) ohne volle Prompts oder Mapping.
5. **Mapping-Härtung.** `identity_mappings` ist lokal, aber unverschlüsselt; keine Pflege-UI; keine Verschlüsselung at rest.
6. **Detect-Klartext in der Testphase.** Der Detect-Provider darf Klartext sehen. Bei externem Detect (OpenRouter) ist das ein bewusster Übergang, nicht der Zielpfad. Produktiv nur lokales Modell.
7. **Weitere Egress-Klassen.** Tool-, Web- und Speech-Egress bleiben getrennt und ungebaut.
8. **Löschen, Export, DSFA.** Kein Hard-Delete, keine Portabilität, keine Datenschutz-Folgenabschätzung.
Diese Punkte dürfen nicht stillschweigend als erledigt gelten, nur weil Generate bereits maskiert.
## 10. Offene Fragen
+2
View File
@@ -63,6 +63,8 @@ Krisengrenzen und medizinische Hochrisikothemen sind **nicht** dieses Kapitel (`
2. Backup-Verschlüsselung und Schlüsselhaltung.
3. DSFA und Retention, sobald Mehrbenutzer über den privaten Betrieb hinausgeht.
Der implementierte Privacy-Pfad ist durchgängig, aber nicht der vollständige Security Layer. Offene Implementierungspunkte (Minimierung, Detection-Qualität, Antwortprüfung, Audit, Mapping-Härtung, Detect-Klartext in der Testphase) stehen in `privacy_gateway.md` §9.2.
## 8. Querverweise
- `auth_identity_and_roles.md`, `privacy_gateway.md`, `runtime_and_deploy.md`
@@ -63,6 +63,8 @@ Der aus Mitai übernommene Produktrahmen (PWA, Auth, Rollen, Layout-Shell, Deplo
Ein späterer MVP bleibt eine fachliche Entscheidung (Interview Phase I). Die dort genannte kleine Reflexionsschleife ist **aktueller Arbeitsstand**, kein technisch eingefrorener Lieferumfang. Die leere oder fast leere Mitai-Shell ist Infrastruktur, nicht der MVP.
**Additiv 2026-08-25:** Der erste vertikale Journal-Slice ist im Code vorhanden. Der fachliche Lieferumfang bleibt `../functional/mvp.md`. Die **technische Umsetzung** (Laufzeit, Module, API, Daten) steht in `mvp_implementation.md`. Der Ist-Stand gegen Spec und Gesamtziel (Fit-Gap) steht in `../functional/mvp_stand_und_abgleich.md`. Technische „Implementierungsstand“-Abschnitte in den Einzelkapiteln sind Ausschnitte; sie ersetzen diese beiden Homes nicht. Der MVP-Schnitt in der Tabelle unten bleibt als *fachliche* Freeze-Frage Arbeitsstand; er ist nicht „nicht gebaut“.
---
## 3. Dokumentationsprinzipien
@@ -188,6 +190,7 @@ integrations_technical.md
admin_diagnostics.md
voice_and_media.md
security.md
mvp_implementation.md
```
| Datei | Kanonisches Thema | Reife v0.1 |
@@ -206,6 +209,7 @@ security.md
| `admin_diagnostics.md` | Diagnoseansicht | Mitai-Admin-Realm; Kanshō-Inhalte später |
| `voice_and_media.md` | Sprache / Transkription | Bedarf im Fachstand, Ausprägung offen |
| `security.md` | Rate Limit, Secrets, Encryption | Teil entschieden, Rest offen |
| `mvp_implementation.md` | Technische Umsetzung des Journal-Slices (Ist-Code) | Code 2026-08-25 |
---
@@ -43,6 +43,12 @@ Nicht entschieden, daher kein Implementierungszwang in v0.1:
- Fail Closed: kein unsicherer Cloud-Speech-Fallback.
- Journal- und Writing-Profile laufen auf Text nach Korrektur, nicht auf Roh-ASR-Fehlern als „persönlicher Stil“.
## 4.1 Journal-Medien (nicht Voice)
Spracheingabe bleibt offen. Davon getrennt: im Journal-Editor eingebettete Bilder und Videos sind lokale Dateien (`media_assets`), Auslieferung nur an die Session, kein Provider-Egress. EXIF bei JPEG/PNG wird gestrippt. Video-Container-Metadaten (einschließlich GPS) werden derzeit **nicht** entfernt.
Das ist keine Videoverwaltung und kein Ersatz für Transkription.
## 5. Entscheidungsstand
| Thema | Stand | Status |