Rappel et lecture
Ces outils servent à retrouver ce que la mémoire sait : reprendre un projet, lire son contexte, son historique ou une archive, chercher dans tout le vault, résumer les dernières sessions, situer un fichier du dépôt et explorer les liens d'une note.
Aucun n'écrit dans le vault : le catalogue les déclare tous en lecture seule.
Pour les demander en parlant à votre agent, voir Reprendre un projet et Chercher dans la mémoire.
En pratique
« On reprend le projet kessho-docs. »
« Montre-moi le contexte courant de kessho-docs, sans le briefing. »
« Où a-t-on parlé de la synchronisation Git ? Cherche dans toute la mémoire. »
« Résume les cinq dernières sessions de kessho-docs. »
« Avant de modifier ce fichier, dis-moi ce que la mémoire en sait : src/domain/session.rs. »
Les outils
mem_recall
Charge le contexte d'un projet ou d'un domaine pour reprendre une session sans re-briefing. Sans slug, rend l'inventaire du vault pour désambiguïsation.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
slug | string | non / no | Slug du projet ou domaine à charger. Omis : inventaire du vault. |
mem_read_context
Lit le context.md d'un projet ou d'un domaine. Plus léger que mem_recall : instantané courant sans synthèse de briefing.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
slug | string | oui / yes | Slug du projet ou domaine. |
mem_read_history
Lit le history.md d'un projet ou d'un domaine : frontmatter, corps et nombre d'entrées de session détectées.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
slug | string | oui / yes | Slug du projet ou domaine. |
mem_read_archive
Lit une archive nommée d'un projet : frontmatter et corps. Lecture seule, restreinte au dossier archives/ du projet.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
filename | string | oui / yes | Nom de l'archive, avec ou sans l'extension .md. |
slug | string | oui / yes | Slug du projet ou domaine. |
mem_search
Recherche plein texte dans tout le vault, une correspondance par ligne avec son contexte. Le motif est une expression régulière.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
case_insensitive | boolean | non / no | Ignorer la casse (vrai par défaut). |
fold_accents | boolean | non / no | Replier les accents des deux côtés — « reglage » trouve « réglage », « moya zametka » trouve « моя заметка » (vrai par défaut). |
fold_separators | boolean | non / no | Rendre espaces, tirets et soulignés interchangeables — « deploy kit » trouve deploy-kit, deploy_kit et deploykit. Sans effet sur un motif contenant un métacaractère de regex (vrai par défaut). |
include_archived | boolean | non / no | Inclure 10-episodes/archived/ (exclu par défaut). |
limit | number | non / no | Nombre maximal de correspondances rendues (défaut 50, max 500). |
query | string | oui / yes | Motif recherché (syntaxe regex). |
search_names | boolean | non / no | Faire correspondre aussi le NOM du fichier, pour les atomes dont seul le nom porte le motif — « systray » trouve systray.md même si son corps dit « plateau système ». Ces correspondances portent line_number 0 et matched_in_name true (vrai par défaut). |
zone | string | non / no | Restreint à une zone : 00-inbox, 10-episodes, 20-knowledge… |
mem_digest
Synthétise les N archives les plus récentes d'un projet ou d'un domaine : date, sujet et extrait de corps.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
from_archived | boolean | non / no | Autoriser la synthèse d'un projet archivé (refusé par défaut). |
n | number | non / no | Nombre d'archives récentes à inclure (défaut 5, max 50). |
slug | string | oui / yes | Slug du projet ou domaine à synthétiser. |
mem_about_path
Rend ce que le vault sait déjà d'un fichier du dépôt, avant qu'on ne le modifie : les faits de carte qui le décrivent, le manifeste qui a établi sa techno, le document de cadrage qui le concerne. À APPELER AVANT de toucher un fichier qu'on ne connaît pas — ce que la mémoire sait ne sert que si on le demande au moment où il compte. Ne rien savoir n'est pas une erreur : la réponse porte alors combien d'atomes du vault citent un fichier quelconque, ce qui distingue « le vault ne sait rien de celui-ci » de « personne ne lui a jamais rien dit ».
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
path | string | oui / yes | Chemin RELATIF à la racine du dépôt, tel qu'on l'écrirait dans un commit : « src-tauri/src/domain/session.rs ». Un chemin absolu est refusé — les atomes citent des chemins relatifs et aucun ne pourrait y correspondre. |
mem_relations
Explore les liens d'une note dans la mémoire : ce qui est plus général qu'elle (up : son projet, son domaine, les concepts dont elle relève), ce qui est plus précis (down : ses notes, ses concepts fils) et ce qui lui est voisin (side : les frères du même parent, les notes liées par related ou par un [[lien]]). Chaque relation porte son type (broader, member_of, related, links_to, sibling) et sa profondeur ; un parcours qui dépasse 200 notes est marqué tronque, un cycle est signalé. Les relations déclarées dont la cible n'existe pas ou est ambiguë sont nommées (pendantes). Lecture seule. À APPELER pour situer une note avant de la classer ou de la relier.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
depth | integer | non / no | Profondeur du parcours, de 1 à 6 (défaut 2). |
direction | string | non / no | up (plus général), down (plus précis), side (frères et voisins) ou all (défaut). |
path | string | oui / yes | Chemin de la note relatif au vault, avec ou sans .md : « 20-knowledge/runner ». |
mem_graph_export
Exporte le graphe de la mémoire : les notes (nœuds, avec leur niveau domaine, concept, projet, note ou archive, et leur degré) et leurs relations (arêtes typées), plus le nombre de relations pendantes et de liens morts. Les archives de session sont repliées par défaut dans leur projet, qui en porte le compte. La charge est volumineuse (de l'ordre de 100 Ko pour 400 notes) : levels ne garde que les niveaux demandés pour la réduire. Lecture seule.
| Paramètre / Parameter | Type | Requis / Required | Description (catalogue) |
|---|---|---|---|
fold_archives | boolean | non / no | Vrai (défaut) : replier les archives de session dans leur projet. Faux : les rendre une à une. |
levels | array<string> | non / no | Ne garder que ces niveaux : domaine, concept, projet, note, archive. Absent = tous. Les relations dont un bout est écarté le sont aussi. |