Maintenance

Ces outils entretiennent la mémoire plutôt que de l'enrichir : auditer son hygiène, lister et réparer les constats, entretenir la carte de codebase, migrer le schéma ou déplacer le vault, vérifier la version disponible, obtenir l'aide des commandes.

Quatre lisent seulement (mem_health_scan, mem_health_tasks, mem_check_update, mem_help). mem_health_repair, mem_codebase_repair et mem_migrate sont des essais à blanc sauf apply: true ; mem_vault_migrate l'est sauf confirm: true ; il déplace le vault entier, .git compris, et aucun commit ne le suit. mem_codebase_scan est en lecture seule sur le contenu de la carte, mais avance sa propre ancre dans topology.md.

Pour les demander en parlant à votre agent, voir Entretenir la mémoire.

En pratique

Vous demandez à l’agent

« Fais un état de santé de la mémoire. »

→ L’agent appellemem_health_scan

Vous demandez à l’agent

« Montre-moi ce que la réparation automatique corrigerait, sans rien écrire. »

→ L’agent appellemem_health_repair

Les outils

mem_health_scan

Audite l'hygiène du vault sur toutes ses catégories, énumérées au schéma. Lecture seule : aucune écriture, en aucune circonstance. Chaque constat porte son étage de réparation — stage : app (mem_health_repair le répare), agent (task_id, voir mem_health_tasks) ou none (reason dit pourquoi) — et by_stage les compte. Les catégories non évaluées sont nommées avec leur motif.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
category	string	non / no	Restreint l'audit à une seule catégorie. L'une de : malformed-frontmatter | stray-zone-md | empty-md-at-root | missing-zone-index | missing-display | dangling-wikilinks | orphan-atoms | missing-archeo-hashes | mcp-tool-spec-drift | skill-description-too-long | missing-zone-index-entry | missing-universal-frontmatter | missing-archeo-context-origin | archeo-derived-orphan | topology-archives-out-of-sync | archeo-archive-incomplete-frontmatter | non-canonical-slug | legacy-slug-filename | stale-repo-topology-path | stale-codebase-map | frontmatter-key-hors-schema | contexte-sans-resume | orphan-images | unclassified-note | unresolved-relation | concept-cycle. Absent = toutes.

mem_health_tasks

Liste les tâches d'agent du plan de santé : les constats qui demandent du jugement — résumé à composer, atome orphelin à rattacher, wikilien sans cible sûre, conflit de fusion, dépôt déplacé. Chaque tâche porte le problème, les indices mesurés (candidats lexicaux classés), les outils MCP à employer et son critère de fin : le constat disparaît de mem_health_scan. Lecture seule. Traiter chaque tâche avec les outils qu'elle nomme, puis relancer mem_health_scan pour vérifier.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
cursor	string	non / no	Identifiant de la dernière tâche reçue (next_cursor de l'appel précédent) : les tâches sont rendues par identifiant croissant, et la page suivante commence après lui.
kind	string	non / no	Restreint à un genre : compose-summary | attach-orphan | resolve-wikilink | resolve-merge-conflict | locate-repo | review-frontmatter-key. Absent = tous.
limit	integer	non / no	Nombre maximal de tâches rendues (défaut 30).

mem_health_repair

Applique l'étage app du plan de santé : les correctifs dont la réponse est unique et sûre, constat par constat. Catégories dotées d'un réparateur déterministe : missing-display, missing-zone-index-entry, non-canonical-slug, missing-universal-frontmatter, orphan-atoms, frontmatter-key-hors-schema, dangling-wikilinks, topology-archives-out-of-sync, stale-repo-topology-path, missing-archeo-context-origin — un constat dont la condition de sûreté ne tient pas descend à l'étage agent ou reste signalé, jamais réparé au mieux. À blanc par défaut : la réponse porte plan_id, planned_fix_count, files_to_modify et planned — rien n'est écrit. apply: true écrit, avec le plan_id du plan à blanc OBLIGATOIRE — sans lui, ou si le plan a changé entre-temps, rien n'est écrit — et répond fixes_applied, files_modified, failed. Tout autre paramètre (dry_run compris) est refusé. Rien n'est jamais supprimé.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
apply	boolean	non / no	Faux (défaut) : rendre le plan sans rien écrire. Vrai : appliquer les correctifs.
plan_id	string	non / no	Obligatoire avec apply : l'empreinte rendue par le plan à blanc. Absente, ou si le plan a changé depuis, rien n'est écrit.

mem_codebase_scan

Diagnostique la carte de codebase d'UN projet : ancre du dernier scan, couverture (fichiers décrits sur fichiers suivis par Git), entrées périmées (contenu changé), références mortes (fichier disparu), candidats non décrits (touchés depuis la dernière ancre, aucune entrée). Lecture seule sur le contenu de la carte ; avance sa propre ancre sur topology.md.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
project	string	oui / yes	Slug du projet à diagnostiquer.

mem_codebase_repair

Répare mécaniquement la carte de codebase d'UN projet : retire une référence morte (fichier disparu) SI l'entrée garde au moins une autre citation vivante. Ne touche JAMAIS une entrée périmée (contenu changé) : sautée avec son motif, comme un fichier qui serait sa seule citation. À blanc par défaut — apply est requis pour écrire.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
apply	boolean	non / no	Faux (défaut) : décrire le plan sans rien écrire. Vrai : appliquer.
project	string	oui / yes	Slug du projet à réparer.

mem_migrate

Traverse les migrations de schéma dont la version cible dépasse celle du vault, dans l'ordre. À blanc par défaut — apply est requis pour écrire. Une sauvegarde précède toute application, sauf renoncement explicite, et une étape en échec arrête la chaîne.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
apply	boolean	non / no	Faux (défaut) : décrire les étapes sans rien écrire. Vrai : les appliquer.
skip_backup	boolean	non / no	Vrai : renoncer à la sauvegarde préalable du vault. À n'employer qu'en connaissance de cause, ou quand le vault dépasse le plafond de sauvegarde automatique.

mem_vault_migrate

Déplace le vault entier vers un nouvel emplacement, puis fait suivre la configuration de l'application, les sept memory-kit.json par client, les répertoires autorisés de Claude Code et l'argument --vault des clients MCP déployés. Toutes les cibles d'écriture sont validées AVANT le moindre mouvement. À blanc par défaut — confirm est requis.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
confirm	boolean	non / no	Faux (défaut) : rendre le plan sans rien muter. Vrai : déplacer et réécrire.
target	string	oui / yes	Emplacement d'arrivée du vault, en chemin absolu.

mem_check_update

Compare la version de ce binaire à la dernière publiée par le dépôt du projet. Cache d'une heure, appel borné en délai, renoncement par variable d'environnement. Un réseau absent ou lent rend un motif, jamais une erreur.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
force_refresh	boolean	non / no	Vrai : ignorer le cache et interroger le réseau.

mem_help

Rend l'inventaire des outils groupés par catégorie, ou l'aide d'une commande : sa description, ses paramètres et ses voisines. Dérivée du catalogue, elle ne peut pas diverger de ce que le serveur expose.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
command	string	non / no	Commande dont rendre l'aide, sous l'une ou l'autre forme (mem_help ou mem-help). Absente = l'inventaire général.
lang	string	non / no	Langue du chrome : en, fr, es, de ou ru. Absente ou inconnue = anglais.