Tesserae v0.18.0 — ask répond, le moteur se souvient, doctor répare

<!-- translations:start -->

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

<!-- translations:end -->

Publié 2026-07-10 · PyPI · GitHub release · pip install --upgrade tesserae==0.18.0

Une révision complète de la surface de commandes, guidée par une observation : tesserae ask "what happened recently?" renvoyait auparavant des pages de concepts statiques et un haussement d'épaules honnête. Le thème : les commandes font désormais ce que leurs noms promettent.

ask planifie sa récupération — et répond par défaut

tesserae ask n'a plus besoin de --llm : le modèle lit d'abord votre question, planifie quelles primitives du graphe de connaissances peuvent y répondre (chronologie, sessions récentes, digest d'activité, faits temporels, pages wiki), exécute ce plan, et synthétise une réponse citée. Les questions temporelles obtiennent des preuves datées au lieu d'une soupe de pages de concepts. --no-llm force la recherche seule ; TESSERAE_QUERY_DRY_RUN et le chemin BM25 classique restent le repli déterministe en cas d'échec. La récupération brute — résultats BM25, recherche sémantique, et les backends explicites raganything/cognee — vit désormais dans tesserae query.

Chunks de session quotidiens : rappel par plage temporelle 20× plus rapide

Le tailer de sessions du moteur écrit maintenant chaque tour observé dans un store de chunks quotidiens (.tesserae/session_chunks.db), et refresh le remplit incrémentalement sous un verrou skip-if-held. Les lectures fenêtrées (summary, decisions, la récupération d'activité de ask, MCP) servent les jours couverts depuis les chunks — 2,3 s mesurées contre 48,8 s sur un projet de 45k nœuds — avec un repli par scan brut à parité garantie, de sorte qu'une base de chunks manquante ou corrompue ne peut jamais changer les résultats, seulement la vitesse. tesserae sessions chunk-backfill [--since] construit l'historique à la demande.

tesserae doctor

Vingt vérifications de santé en environ deux secondes : parsing init/graphe/config, cohérence du registre, obsolescence, verrous actifs, état de connexion, hygiène. --fix n'applique que les réparations prouvées sûres (pidfiles obsolètes, journaux de hooks surdimensionnés, élagage du registre, reconstructions du site) et ne touche jamais un verrou de compilation actif. Les rapports persistent dans .tesserae/doctor-report.{md,json} et sont servis via MCP sous doctor_report.

init est l'installation tout entière

tesserae init détecte les CLI LLM sur votre machine, vérifie qu'elles sont réellement connectées, et vous laisse choisir — y compris un endpoint compatible claude personnalisé (--llm-provider custom --llm-base-url … --llm-api-key … --llm-model …). Les clés se résolvent env → projet → global (ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, TESSERAE_LLM_MODEL) ; une clé persistée en clair avertit une seule fois. Une ré-init fusionne votre config au lieu de l'écraser.

Des backends plus légers, des flags honnêtes

cognee est désormais désactivé par défaut, silencieux quand il est utilisé, installable via tesserae[cognee], et le mode codex_cognify a disparu (−556 LOC). understand-anything ne s'auto-adopte plus sur la simple présence d'artefacts. Et une passe adversariale sur les 26 commandes a renommé ou supprimé chaque flag mensonger — summary --project→--name (avec validation stricte du nom), context --synthesize→--llm, refresh --skip-sessions→--no-sessions, vault --poll-interval→--interval, ingest --exact→--full, flags morts supprimés — chaque ancienne orthographe affiche un pointeur d'une ligne vers la nouvelle et sort avec le code 2. Des corrections de comportement accompagnent le tout : un sessions import vide ne peut plus effacer le store, ingest --dry-run est vraiment à sec, serve --dry-run s'exécute avant les builds, et le serveur MCP rapporte enfin sa vraie version.

Changements incompatibles

Chaque flag/commande supprimé ou renommé affiche son remplacement et sort avec le code 2 — rien n'échoue silencieusement. La table complète : 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.