6.3 KB · updated 2026-07-31 · md

doctor.fr.md

docs/i18n/doctor.fr.md

`tesserae doctor` — bilans de santé du projet

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

tesserae doctor inspecte un espace de travail Tesserae de bout en bout — initialisation, intégrité du graphe, cohérence du registre, fraîcheur, verrous, connexion LLM et hygiène disque — et affiche une checklist. Il est en lecture seule par défaut ; --fix n’applique que les réparations sûres à relancer et ne peut jamais détruire un état vivant.

tesserae doctor                 # check the current project
tesserae doctor --fix           # apply the safe repairs, then re-check
tesserae doctor --all --json    # every registered project, JSON report
tesserae doctor --project ~/src/other

Ce qu’il vérifie

Vingt vérifications, regroupées par catégorie :

Vérification	Catégorie	Ce qu’elle vérifie	Action `--fix`
`project_initialized`	core	`.tesserae/` existe et ressemble à un espace de travail Tesserae	rapport seulement (suggère `tesserae init`)
`graph_parse`	core	`graph.json` se parse et a la forme attendue	rapport seulement (suggère `tesserae compile`)
`config_valid`	core	`.tesserae/config.json` se parse et se valide contre le modèle d’init	rapport seulement
`vault_configured`	core	le chemin de vault configuré se résout	SAFE : crée le répertoire de vault résolu lorsqu’il vit à l’intérieur du projet
`registry_consistent`	registry	les entrées de `~/.tesserae/registry.json` pointent vers de vraies racines de projet	SAFE : élague les entrées dont la racine a disparu, supprime la clé héritée `active` ; un graphe manquant reste rapport seulement
`graph_staleness`	freshness	delta git depuis le `git_head` enregistré par la dernière compilation	rapport seulement (suggère `tesserae refresh` — les compilations sont lourdes)
`site_search_index`	freshness	le site statique / `search-index.json` est plus récent que `graph.json`	SAFE : reconstruit le site
`backend_artifacts`	freshness	les artefacts RAG-Anything sont à jour	rapport seulement (leur rafraîchissement est lourd en LLM/réseau)
`session_chunks`	freshness	la couverture des chunks de session quotidiens n’a pas de trous dans la fenêtre récente	rapport seulement (suggère `tesserae sessions chunk-backfill`)
`wiki_lint`	graph	dérive graphe ⇄ wiki + constats de lint trivialement corrigeables	SAFE : applique les corrections triviales du lint (`fix_trivial`)
`compile_lock`	processes	si un verrou de compilation vivant est détenu, et par quel pid	rapport seulement — doctor ne tue jamais et ne supprime jamais un verrou vivant
`daemon_pid`	processes	`daemon.pid` pointe vers un processus moteur vivant	SAFE : supprime le pidfile quand son propriétaire est mort
`llm_login`	environment	le backend LLM configuré est réellement utilisable (CLI claude/codex connectée, ou clé API présente)	rapport seulement (suggère `claude /login` / `codex login`)
`optional_deps`	environment	statut des dépendances optionnelles (memex, raganything)	rapport seulement (les installations passent par le réseau)
`embedding_backend`	environment	un vrai backend d’embeddings sémantiques est disponible	rapport seulement (suggère `pip install tesserae[semantic]`)
`environment`	environment	résumé de détection d’environnement en bloc	section rapport seulement
`build_history`	hygiene	taille et forme de `.build-history`	SAFE : le tronque, en préservant toujours l’entrée `git_head` la plus récente (la vérification de staleness en dépend)
`idempotence`	hygiene	le fil-piège `idempotence_suspect` du snapshot de sortie	rapport seulement (c’est un signal de bug, pas quelque chose à auto-réparer)
`orphan_worktrees`	hygiene	enregistrements `git worktree` périmés	SAFE : `git worktree prune` ; la suppression de répertoires reste rapport seulement
`hook_log_bloat`	hygiene	croissance de `.tesserae/.session-*-hook.log`	SAFE : fait tourner/tronque les logs au-delà de 10 Mo

Une vérification qui plante est rapportée comme un constat d’erreur — doctor lui-même ne lève jamais d’exception.

Politique `--fix`

--fix exécute uniquement les vérifications marquées SAFE ci-dessus, puis re-détecte pour que le rapport reflète l’état après correction.
Chaque correction est idempotente : lancer doctor --fix deux fois laisse le second passage propre.
Doctor ne tue jamais un processus et ne supprime jamais un verrou de compilation vivant — un verrou détenu est rapporté avec son pid propriétaire et laissé tranquille.
Les opérations lourdes ou réseau (recompilations, installations de dépendances, rafraîchissements de backend) ne sont jamais intégrées à --fix ; doctor affiche la commande à lancer vous-même.

Codes de sortie

Même convention que tesserae lint :

Code de sortie	Signification
`0`	sain — aucun constat au-dessus de OK
`1`	avertissements présents
`2`	erreurs présentes

Artefacts de rapport

Chaque exécution écrit les deux formes de rapport dans l’espace de travail :

.tesserae/doctor-report.md      # human checklist
.tesserae/doctor-report.json    # structured findings

--json affiche en plus le rapport JSON sur stdout à la place de la checklist markdown. --all itère sur chaque projet du registre (en ignorant --project) et rapporte projet par projet.

MCP : `doctor_report`

Le serveur MCP expose le même rapport via l’outil doctor_report (à l’image de lint_report, y compris son plafond d’octets sur le contenu retourné), afin qu’un agent puisse vérifier la santé de l’espace de travail en pleine conversation sans passer par le shell. Il requiert une racine de projet — passez graph_path/project ou configurez un graphe par défaut.