Tesserae v0.4.0 — Extraktions-Feedback-Schleife, Recherche-Modus, standardmäßig aktive Evolution

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français

<!-- translations:end -->

Veröffentlicht am 2026-05-26 · PyPI · GitHub-Release · pip install --upgrade tesserae==0.4.0

Tesserae 0.4.0 macht die Wissensbasis zu etwas, das der Nutzer korrigieren, wachsen lassen und dem er standardmäßig vertrauen kann. Das Hauptthema ist eine Extraktions-Feedback-Schleife: Korrekturen, die der Nutzer im Obsidian-Vault vornimmt, werden als typisierte FeedbackEvents gesammelt, zu LLM-formulierten Leitlinien geclustert und in die nächste Extraktion zurückgespeist, sodass die Engine aufhört, denselben Fehler zu machen. Daneben wird der Recherche-Modus (tesserae project research) ausgeliefert — eine agentische Schleife im dzhng-Stil aus Planen → Suchen → Reflektieren → Synthetisieren, die typisierte OpenQuestion / SessionHypothesis-Knoten erzeugt, damit ein Recherche-Strang Kompilierungen übersteht. Zwei Evolutionsdurchläufe, die in v0.3.0 optional waren — Community-Zusammenfassungen und der Prosa-zu-Code-discusses-Linker — sind jetzt standardmäßig aktiv, und das LLM-Backend erhält eine Reihe von Robustheitskorrekturen (automatische Erkennung von ~/.claude*-Anmeldedaten, anmutige Behandlung, wenn die Claude-CLI nicht angemeldet ist). Alles additiv, keine Breaking Changes.

Inhaltsverzeichnis:

1. Extraktions-Feedback-Schleife (Feature E)
2. MD0 — agentischer Recherche-Modus (Feature G)
3. Evolution standardmäßig aktiv — Community + Insight-Verknüpfung
4. LLM-Backend-Robustheit + Grundlagen der Graph-Ansicht
5. Upgrade von v0.3.0
6. Strategischer Kontext

1. Extraktions-Feedback-Schleife (Feature E)

Was es ist

Eine geschlossene Korrekturschleife zwischen Nutzer und Extraktor. Wenn Sie einen Knoten-Body im Obsidian-Vault bearbeiten — einen falschen Typ korrigieren, einen halluzinierten Fakt löschen, eine verworrene Erkenntnis umformulieren — zeichnet Tesseraes Vault-Overlay die Bearbeitung als typisiertes FeedbackEvent in einem deduplizierten JSONL-Store auf. Diese Ereignisse werden geclustert, ein LLM formuliert jedes Cluster zu einer kurzen Extraktionsleitlinie (mit einem Negativfilter, damit Rauschen nicht zur Regel wird), und diese Leitlinie wird zerteilt und beim nächsten Kompilieren in den Prompt injiziert. Nettoeffekt: Eine einmal gemachte Korrektur hört auf wiederzukehren, statt nach jeder Neu-Extraktion erneut angewendet werden zu müssen.

Die Schleife hat vier bewegliche Teile:

Verwendung

Die Schleife ist in den normalen Vault-Roundtrip eingebunden. Bearbeiten Sie Knoten in Obsidian, führen Sie ein obsidian-sync (oder die Refresh-Kette) aus, und die Korrekturen werden automatisch gesammelt. Beim nächsten tesserae project compile sind die angesammelten Leitlinien im Spiel.

# 1. Knoten-Bodies im Obsidian-Vault bearbeiten (Typen korrigieren, Halluzinationen ausmerzen)
# 2. Vault zurücksynchronisieren — Korrekturen werden als FeedbackEvents gesammelt
tesserae project obsidian-sync

# 3. Neu kompilieren — die geclusterten Leitlinien werden in die Extraktion injiziert
tesserae project compile

Wann aktivieren

• Sie kuratieren den Vault von Hand und sind es leid, dass derselbe Extraktionsfehler nach jeder Kompilierung wieder auftaucht.
• Ihr Korpus hat domänenspezifische Formulierungen, die der generische Extraktor immer wieder falsch typisiert — ein paar Korrekturen bringen ihm Ihre Konventionen bei.

Wo es lebt

Kernimplementierung: tesserae/feedback/ (das FeedbackEvent-Modell, der JSONL-Store, der Leitlinien-Aufbau/-Rendern/-Parsen/-Zerteilen) und der Sammelpfad des Vault-Overlays. Die Designspezifikation und der 7-Aufgaben-TDD-Plan wurden mit Codex erarbeitet und in PR #20 gemergt.

Vorbehalte

• Der deterministische Basis-Extraktor honoriert Leitlinien bislang nur über den LLM-Pfad; bei ausgeschaltetem LLM-Backend werden Korrekturen aufgezeichnet, aber noch nicht erneut injiziert. (Das Honorieren von Leitlinien auf dem deterministischen Pfad wird als spätere Arbeit verfolgt.)
• Leitlinien werden gecacht; eine große Änderung in Ihren Korrekturmustern kann ein bis zwei Kompilierungen dauern, bis sie sich vollständig widerspiegelt, während sich die Cluster neu bilden.

2. tesserae project research — agentischer Recherche-Modus (Feature G)

Was es ist

Ein neuer Subbefehl tesserae project research <query>, der eine breiten-/tiefenbegrenzte Schleife aus Planen → Suchen → Reflektieren → Synthetisieren gegen den kompilierten Graphen ausführt und einen zitierten Markdown-Bericht nach .tesserae/research/<slug>.md schreibt. Er ist dem Deep-Research-Muster von dzhng nachempfunden, aber in Ihrer eigenen Wissensbasis verankert statt im offenen Web.

Entscheidend ist, dass die Schleife typisierte Knoten und Kanten im Vorbeigehen erzeugt, sodass eine spätere Kompilierung den Recherche-Strang wiederherstellen kann:

• ein OpenQuestion pro Teilfrage (mit metadata.parent_question_id für Folgefragen und derived_from-Kanten),
• ein SessionHypothesis pro vom LLM generierter Hypothese, mit references-Kanten zu den Beleg-Knoten-IDs, auf die sie sich stützte,
• und (wenn ein WebFetcher-Backend verdrahtet ist) ein SourceDocument pro Web-Ergebnis.

Alle Backends werden über Protocols injiziert, sodass die Schleife unter Test vollständig deterministisch ist und niemals das Netzwerk berührt, sofern Sie keinen Fetcher verdrahten.

Verwendung

tesserae project research "Wie ranked unser Retrieval-Stack Kandidaten?"
# → schreibt .tesserae/research/...md und erzeugt OpenQuestion / SessionHypothesis-Knoten,
#   die bei der nächsten Kompilierung wiederherstellbar sind

Die Web-Suche ist in v1 bewusst zurückgestellt: --no-web ist ein vorwärtskompatibler No-op, bis ein WebFetcher-Backend ausgeliefert wird.

Wann aktivieren

• Sie wollen eine zitierte Synthese über Ihren eigenen Graphen, kein Einzelknoten-Lookup und keine flache ask-Antwort.
• Sie wollen, dass Recherche-Fragen und -Hypothesen als Graph-Knoten persistieren, damit künftige Sitzungen darauf aufbauen statt erneut zu fragen.

Wo es lebt

Kernimplementierung: tesserae/research/ (wiederverwendet LLMJsonClient, LLMWikiMCPServer.search_nodes, ResearchGraphBuilder und stable_id). CLI-Verdrahtung: der research-Subparser in tesserae/cli.py. Zwölf Tests decken Planen/Suchen/Reflektieren/Synthetisieren, die Graph-Verdrahtung, das max_iters-Limit und die Fallbacks bei Planer-/Synthese-Fehlern ab. Gemergt in PR #18.

Vorbehalte

• v1 synthetisiert nur über den lokalen Graphen; die Web-Ebene ist ein vorwärtskompatibler No-op, bis ein Fetcher-Backend landet.
• Atomare Festplatten-Schreibvorgänge verwenden das PID-+-Zufalls-Temp-Suffix-Muster aus batch._write_manifest, sodass nebenläufige Recherche-Läufe nicht kollidieren.

3. Evolution standardmäßig aktiv — Community + Insight-Verknüpfung

Zwei Durchläufe, die in v0.3.0 optional waren, sind jetzt standardmäßig aktiv, sodass der out-of-the-box-Graph ohne zusätzliche Flags reicher ist:

• Community-Zusammenfassungen (PR #14) — die Louvain-Community-Erkennung plus LLM-Zusammenfassungen laufen jetzt in der Standard-Kompilierung, statt hinter einem Flag zu stehen. Der Graph liefert standardmäßig Cluster-Übersichten.
• Prosa-zu-Code-discusses-Linker (PR #13) — der Insight-Symbol-Linker des Features H aus v0.3.0 (TESSERAE_INSIGHT_SYMBOL_LINK) ist in v0.4.0 standardmäßig aktiv, sodass Session-Findings mit den von ihnen erwähnten Code-Symbolen verknüpft werden, ohne dass Sie die Umgebungsvariable setzen müssen. (Sie können ihn weiterhin explizit deaktivieren, wenn Ihr Korpus überwiegend Prosa mit wenig Code-Diskussion ist.)

Die Absicht ist, dass eine erste Kompilierung einen Graphen erzeugt, der bereits Community-Übersichten und Prosa-zu-Code-Kanten hat, im Einklang mit der Mission „sich selbst verbessernde Basis, bereit zur Übergabe an Agenten", statt vom Nutzer zu verlangen, jeden Durchlauf zu entdecken und umzuschalten.

4. LLM-Backend-Robustheit + Grundlagen der Graph-Ansicht

Eine Reihe von Zuverlässigkeitskorrekturen am LLM-Backend, plus eine Spezifikation für die kommende Graph-Ansicht:

• Automatische Erkennung von ~/.claude*-Anmeldedaten (PR #19) — der Standard-LLM-Pfad findet jetzt Claude-Anmeldedaten über die ~/.claude*-Verzeichnisse und füllt die Umgebung für das Standard-Backend, sodass die Ersteinrichtung auf Multi-Account-Maschinen weniger umständlich ist.
• Anmutiges „Claude-CLI nicht angemeldet" (PR #17) — wenn die Claude-CLI installiert, aber nicht authentifiziert ist, degradiert Tesserae sauber mit einer umsetzbaren Meldung, statt mitten in der Kompilierung abzustürzen.
• PostToolUse-sync-code-Hook (PR #15) — ergänzt den SessionStart-sync-code-Hook aus v0.3.0, sodass der Code-Graph auch nach Tool-Bearbeitungen innerhalb einer Sitzung aktualisiert wird.
• Graph-Ansicht-v1-Spezifikation — das Design, das die HypePaper-Kodierung und eine Knoten-Schublade auf die Tesserae-Site portiert, wurde mit Codex erarbeitet und landete als Spezifikation + Plan, was die folgende visuelle Graph-Arbeit vorbereitet.

Upgrade von v0.3.0

pip install --upgrade tesserae==0.4.0

Das ist das gesamte Upgrade — v0.4.0 ist additiv, ohne Breaking Changes. Die einzige Verhaltensänderung, die man kennen sollte, ist, dass Community-Zusammenfassungen und der Prosa-zu-Code-discusses-Linker jetzt standardmäßig laufen; wenn Sie sich zuvor darauf verlassen haben, dass sie aus sind, deaktivieren Sie sie explizit.

Neuer CLI-Subbefehl für Ihr Muskelgedächtnis:

tesserae project research "<Frage>"   # agentisches Planen→Suchen→Reflektieren→Synthetisieren über Ihren Graphen

Jetzt standardmäßig aktives Verhalten (zuvor optional):

• Community-Zusammenfassungen (Louvain + LLM).
• Prosa-zu-Code-discusses-Kanten (der TESSERAE_INSIGHT_SYMBOL_LINK-Durchlauf aus v0.3.0).

Alles andere — graph_ppr, hybrides search_nodes, sync-code, der Live-SessionStart-Hook, embedding_status, fresh_insights, Decay-Scoring, supersedes, schema-drift, die Slash-Befehle, die Wiki-/Obsidian-Projektion — bleibt unverändert von v0.3.0.

Strategischer Kontext

v0.3.0 verband prosaische Entscheidungen mit den Code-Symbolen, die sie implementieren. v0.4.0 ist das Release, in dem die Basis beginnt, sich selbst zu korrigieren und zu wachsen: Die Extraktions-Feedback-Schleife schließt die Lücke zwischen „der Nutzer hat es einmal korrigiert" und „der Extraktor hat es gelernt", und der Recherche-Modus lässt den Agenten den Graphen mit seinen eigenen typisierten Fragen und Hypothesen wachsen lassen, statt nur aufzunehmen, was bereits existiert. Community-Zusammenfassungen und den discusses-Linker standardmäßig zu aktivieren, ist von der Produktseite dasselbe Thema — die Engine sollte Agenten eine reiche Basis übergeben, ohne den Nutzer nach Flags suchen zu lassen.

Dies ist das Brücken-Release. v0.3.0 bewies den typisierten Prosa-zu-Code-Graphen; v0.5.0 verwandelt das Ganze in eine kontinuierlich laufende Engine mit einem Kontext-Compiler auf Abruf. v0.4.0 ist der Ort, an dem die Selbstverbesserungs-Säule ihre erste echte Oberfläche erhält (Feedback-Korrekturen, agentische Recherche-Stränge), im Vorfeld des v0.5.0-Rückgrats, das all dies kontinuierlich laufen lässt.

Siehe auch:

• v0.3.0-Release-Notes — Prosa-zu-Code-Verknüpfungen, polyglotter Code-Graph, Live-Sync
• Kontext-Engine-Roadmap — der Phasenplan, den v0.5.0 liefert
• Kontext-Engine-Audit — die Lückenanalyse, die diese Releases schließen
• Architektur-Überblick — Modulkarte und Pipeline
• MCP-Integration — vollständige MCP-Tool-Liste