Tesserae v0.18.0 — ask antwortet, die Engine erinnert sich, doctor heilt

<!-- translations:start -->

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

<!-- translations:end -->

Veröffentlicht 2026-07-10 · PyPI · GitHub release · pip install --upgrade tesserae==0.18.0

Eine vollständige Überarbeitung der Befehlsoberfläche, angetrieben von einer Beobachtung: tesserae ask "what happened recently?" lieferte früher statische Konzeptseiten und ein ehrliches Achselzucken. Das Leitthema: die Befehle tun jetzt, was ihre Namen versprechen.

ask plant seine Abfrage — und antwortet standardmäßig

tesserae ask benötigt kein --llm mehr: Das Modell liest zuerst Ihre Frage, plant, welche Knowledge-Graph-Primitive sie beantworten können (Timeline, aktuelle Sessions, Aktivitäts-Digest, temporale Fakten, Wiki-Seiten), führt diesen Plan aus und synthetisiert eine zitierte Antwort. Temporale Fragen erhalten datierte Belege statt Konzeptseiten-Suppe. --no-llm erzwingt reine Suche; TESSERAE_QUERY_DRY_RUN und der klassische BM25-Pfad bleiben der deterministische Fallback bei jedem Fehler. Rohe Abfragen — BM25-Treffer, semantische Suche und die expliziten raganything/cognee-Backends — leben jetzt in tesserae query.

Tägliche Session-Chunks: 20× schnellerer Zeitbereich-Abruf

Der Session-Tailer der Engine schreibt jetzt jeden beobachteten Turn in einen täglichen Chunk-Store (.tesserae/session_chunks.db), und refresh füllt ihn inkrementell unter einem Skip-if-held-Lock nach. Fensterbasierte Lesezugriffe (summary, decisions, die Aktivitätsabfrage von ask, MCP) bedienen abgedeckte Tage aus Chunks — gemessen 2,3s statt 48,8s bei einem Projekt mit 45k Knoten — mit einem paritätsgarantierten Raw-Scan-Fallback, sodass eine fehlende oder korrupte Chunk-Datenbank niemals die Ergebnisse ändern kann, nur die Geschwindigkeit. tesserae sessions chunk-backfill [--since] baut die Historie auf Abruf auf.

tesserae doctor

Zwanzig Gesundheitschecks in etwa zwei Sekunden: Init-/Graph-/Config-Parsing, Registry-Konsistenz, Staleness, aktive Locks, Login-Status, Hygiene. --fix wendet nur die nachweislich sicheren Reparaturen an (veraltete Pidfiles, übergroße Hook-Logs, Registry-Pruning, Site-Rebuilds) und rührt niemals einen aktiven Compile-Lock an. Berichte werden persistent in .tesserae/doctor-report.{md,json} abgelegt und über MCP als doctor_report bereitgestellt.

init ist die gesamte Installation

tesserae init erkennt die LLM-CLIs auf Ihrem Rechner, prüft, ob sie tatsächlich eingeloggt sind, und lässt Sie wählen — einschließlich eines benutzerdefinierten claude-kompatiblen Endpunkts (--llm-provider custom --llm-base-url … --llm-api-key … --llm-model …). Schlüssel werden aufgelöst über env → Projekt → global (ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, TESSERAE_LLM_MODEL); ein im Klartext persistierter Schlüssel warnt einmalig. Re-Init führt Ihre Konfiguration zusammen, statt sie zu überschreiben.

Schlankere Backends, ehrliche Flags

cognee ist jetzt standardmäßig deaktiviert, bei Verwendung stummgeschaltet, installierbar als tesserae[cognee], und der Modus codex_cognify ist entfernt (−556 LOC). understand-anything adoptiert nicht mehr automatisch bei Artefakt-Präsenz. Und ein adversarialer Durchgang über alle 26 Befehle hat jedes lügende Flag umbenannt oder entfernt — summary --project→--name (mit strikter Namensvalidierung), context --synthesize→--llm, refresh --skip-sessions→--no-sessions, vault --poll-interval→--interval, ingest --exact→--full, tote Flags gelöscht — jede alte Schreibweise gibt einen einzeiligen Hinweis auf die neue aus und beendet sich mit Exit-Code 2. Verhaltenskorrekturen kommen mit: Ein leeres sessions import kann den Store nicht mehr löschen, ingest --dry-run ist wirklich trocken, serve --dry-run läuft vor Builds, und der MCP-Server meldet endlich seine echte Version.

Breaking Changes

Jedes entfernte oder umbenannte Flag bzw. jeder Befehl gibt seinen Ersatz aus und beendet sich mit Exit-Code 2 — nichts schlägt stillschweigend fehl. Die vollständige Tabelle: ask --llm|--wiki|--backend|--cognee-*, query --llm|--no-llm|--model, summary|decisions --project, context --synthesize, refresh --skip-sessions, vault sync --poll-interval, vault export --vault, ingest --exact, research --no-web, compile --claude-timeout, config setup, wiki|projects activate.