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.