Entretenir la mémoire

Ce parcours sert à garder le dossier en bon état : repérer les défauts (lien cassé, note orpheline, frontmatter illisible…), les réparer, et ranger (renommer, déplacer, fusionner, retirer) sans casser les liens. L'application sait le faire seule pour une part ; l'agent prend le reste.

Ce que vous demandez à l'agent

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

Vous demandez à l’agent

« Applique cette réparation. »

→ L’agent appellemem_health_repair

• apply = true
• plan_id = 3f9a1c0e

Vous demandez à l’agent

« Quelles tâches de santé me reviennent ? Les résumés à composer, d'abord. »

→ L’agent appellemem_health_tasks

• kind = compose-summary

Vous demandez à l’agent

« Renomme le projet kessho-docs en kessho-documentation, et mets à jour les liens qui le visent dans tout le vault. »

→ L’agent appellemem_rename

• old_slug = kessho-docs
• new_slug = kessho-documentation
• rewrite_links = true

Vous demandez à l’agent

« Montre-moi ce que donnerait le déplacement de 20-knowledge/runner.md vers 20-knowledge/architecture/runner.md. »

→ L’agent appellemem_move

• path = 20-knowledge/runner.md
• to = 20-knowledge/architecture/runner.md

Vous demandez à l’agent

« Applique ce déplacement. »

→ L’agent appellemem_move

• path = 20-knowledge/runner.md
• to = 20-knowledge/architecture/runner.md
• apply = true

Vous demandez à l’agent

« Annule le dernier déplacement. »

→ L’agent appellemem_move_undo

Vous demandez à l’agent

« Retire la note 20-knowledge/note-de-test.md : c'est un doublon de runner.md. »

→ L’agent appellemem_remove

• path = 20-knowledge/note-de-test.md
• confirm = true
• reason = Doublon de runner.md.

Vous demandez à l’agent

« Finalement, remets cette note en place. »

→ L’agent appellemem_restore

• path = 20-knowledge/note-de-test.md

Ce que fait l'agent

Contrôler, puis réparer

1. mem_health_scan audite le vault. Lecture seule, en toutes circonstances. category restreint l'audit à une catégorie (la liste est dans la référence). Chaque constat dit qui peut le réparer : stage vaut app (l'étape de réparation automatique), agent (une tâche pour l'agent) ou none (avec la raison).
2. mem_health_repair applique les correctifs dont la réponse est unique et sûre. Par défaut c'est un essai à blanc : la réponse porte un plan_id, le nombre de corrections et les fichiers concernés, et rien n'est écrit. Avec apply: true, l'agent doit redonner ce plan_id : sans lui, ou si la mémoire a changé depuis, rien n'est écrit. Aucun autre paramètre n'est accepté (dry_run est refusé), et rien n'est jamais supprimé.
3. mem_health_tasks liste ce qui demande du jugement : résumé à composer, note orpheline à rattacher, lien sans cible sûre, conflit de fusion, dépôt déplacé. kind filtre par genre, limit (30 par défaut) et cursor paginent. Chaque tâche nomme les outils à employer et son critère de fin : le constat disparaît du scan. L'agent traite chaque tâche, puis relance mem_health_scan pour vérifier.

Ranger

Ces outils réécrivent aussi les liens qui visent ce qu'ils déplacent (wikiliens, liens Markdown, frontmatter), dans tout le vault. rewrite_links: false désactive cette réécriture pour mem_rename, mem_merge et mem_reclass.

• mem_move renomme ou déplace un fichier ou un dossier. Sans apply, il rend le plan sans rien écrire : fichiers déplacés, chaque lien avant et après, liens laissés, avertissements, empreinte. Avec apply: true, il applique ; si empreinte est donnée et que le vault a changé depuis, rien n'est écrit. Il refuse une cible occupée, un nom invalide, un dossier protégé, une opération git en cours, ou un plan qui casserait un lien.
• mem_rename renomme un projet ou un domaine (old_slug, new_slug) ; mem_merge fusionne deux projets ou deux domaines de même nature (source_slug, supprimé après fusion, dans target_slug) ; mem_reclass change la portée (scope) ou la zone (zone) d'une note. Ces trois outils écrivent dès l'appel : ils n'ont pas d'essai à blanc. Pour revenir en arrière, voir mem_move_undo ci-dessous.
• mem_move_undo annule la dernière opération de déplacement du vault (mem_move, mem_rename, mem_reclass, mem_merge, ou le même geste fait dans l'application) : fichiers et liens reviennent à leur état d'avant. Il refuse si un fichier touché a changé depuis.

Retirer

mem_remove déplace une note vers la corbeille du vault (.trash/), avec une note jointe (date, motif, ancien chemin) ; il ne supprime jamais. Ses gardes :

• une note créée par ce serveur pendant la session en cours se retire librement ; pour toute autre, confirm: true et reason (non vide) sont exigés ;
• une note citée par d'autres est refusée, avec la liste des citants ; force: true la retire quand même et rend chaque lien devenu pendant ;
• il refuse index.md, context.md, history.md, .obsidian/ et .trash/, et tout retrait pendant une opération git en cours ;
• il écrit une ligne d'audit dans 99-meta/migrations/removals.md. Une note déjà poussée reste dans l'historique git.

mem_restore la remet en place, octet pour octet, et refuse si un fichier occupe déjà son chemin d'origine : rien n'est jamais écrasé.

D'autres outils de rangement existent, par exemple mem_attach (rattacher une note orpheline à un projet ou un domaine) ou mem_accept_dangling (déclarer un lien mort volontaire) ; ils sont dans la Référence MCP.

Ce que vous voyez

• La santé. La barre d'état affiche la SANTÉ de la mémoire, et l'accueil porte le Score de santé de la mémoire. Il compte les anomalies et sépare ce que l'application répare seule de ce qui revient à un agent (« N tâches pour un agent », avec Copier la consigne). Préparer la réparation suit le même principe en deux temps que mem_health_repair : un plan, puis Appliquer ; un plan périmé est refusé. Voir Accueil.
• Ranger et retirer. Dans une zone, le menu d'une note propose Renommer, Déplacer et Retirer, avec l'aperçu des liens à mettre à jour et un bouton Annuler pour revenir en arrière ; Retirer envoie la note à la corbeille (.trash) et propose Retirer quand même quand d'autres notes la citent. Voir Zones.
• Ce que l'agent vient de changer. Le témoin de fraîcheur s'allume après chaque écriture d'agent et nomme la zone touchée ; Relire recharge l'écran (voir Zones).