Archive et session

Ces outils gèrent la vie d'une session de travail : l'archiver, annuler la dernière archive, ranger un projet terminé, poser la phase ou le résumé d'un projet, tenir le journal de la semaine.

Ils écrivent dans le vault, sauf mem_archive_rewrite_paths, qui ne réécrit que si confirm vaut vrai (sans lui, c'est un essai à blanc). mem_worklog écrit aussi, mais seulement dans sa phase persist : sa phase collect, par défaut, est en lecture seule. mem_rollback_archive supprime la dernière archive et son entrée de history.md ; le context.md n'est pas restauré.

Pour les demander en parlant à votre agent, voir Archiver une session.

En pratique

Vous demandez à l’agent

« Passe la phase du projet kessho-docs à « rédaction », sans toucher au reste du contexte. »

→ L’agent appellemem_archive

• slug = kessho-docs
• mode = incremental
• phase = rédaction

Vous demandez à l’agent

« Pose ce résumé sur kessho-docs : « Documentation bilingue de Kessho, référence MCP dérivée du catalogue. » »

→ L’agent appellemem_set_summary

• slug = kessho-docs
• summary = Documentation bilingue de Kessho, référence MCP dérivée du catalogue.

Les outils

mem_archive

Archive une session. Mode incrémental : réécrit context.md seul, en cours de session. Mode complet : crée une archive horodatée, préfixe history.md et réinitialise context.md.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
archive_aliases	array<string>	non / no	Mode complet : autres mots par lesquels cette archive sera cherchée plus tard — le vocabulaire VÉCU, pas celui du correctif (« barre de menus » pour systray, « l'app est toute blanche » pour un écran vide). Écrits en aliases, clé de frontmatter répandue (Obsidian la lit aussi), et pesés comme une désignation au classement de mem_search.
archive_body_md	string	non / no	Mode complet : corps de l'archive.
archive_extra_fm	object	non / no	Frontmatter additionnel fusionné à celui de l'archive : les listes tags sont concaténées sans doublon, toute autre clé est remplacée. Le paramètre était accepté sans être déclaré — donc indécouvrable.
archive_subject	string	non / no	Mode complet : sujet court de l'archive.
context_md	string	non / no	Nouveau corps de context.md, qui REMPLACE l'actuel. Omis (ou null) : le corps actuel est gardé tel quel — c'est ainsi qu'on ajoute une archive ou pose une phase sans toucher au contexte. Une chaîne vide ou faite d'espaces est refusée, rien n'est écrit : pour garder le contexte, omettre le champ.
derive	array<object>	non / no	Mode complet : les faits durables à ÉCRIRE comme atomes curatés. L'outil les crée dans leur zone, pose le lien retour vers cette session, et ajoute leurs wikiliens à derived_atoms — un seul appel au lieu d'un par fait. Un nom déjà pris fait REFUSER l'archivage en entier, sans suffixe ni écrasement.
derive[].body	string	oui / yes	Pourquoi il est vrai, et ce que coûte de l'ignorer.
derive[].fact	string	oui / yes	Le fait, qui nomme l'atome et par lequel on le retrouvera.
derive[].kind	string	oui / yes	principle | goal | knowledge — les trois zones curatées.
derived_atoms	array<string>	non / no	Mode complet, OBLIGATOIRE sauf si no_derived_because est donné : ce que la session laisse de durable — un principe qui contraindra le travail futur, un but posé ou changé, une connaissance qui a coûté à acquérir. Un fait resté dans une archive se retrouve en 4 à 6 tentatives, contre 1 à 3 pour un atome curaté.
expect_decisions	array<string>	non / no	Décisions cumulatives devant survivre au nouveau corps.
mode	string	non / no	'incremental' (défaut) ou 'full'.
no_derived_because	string	non / no	Mode complet, OBLIGATOIRE si et seulement si derived_atoms est vide : pourquoi cette session ne laisse rien de durable. Un simple « rien de durable ce soir » suffit — ce qui est refusé est le SILENCE, pas la brièveté. Une question sautée est indiscernable d'une réponse vide.
phase	string	non / no	Nouvelle phase, écrite seulement si fournie.
slug	string	oui / yes	Slug du projet ou domaine.
source_hint	string	non / no	'archeo-git' pour valider le frontmatter d'archive archéo.

mem_rollback_archive

Annule la dernière archive d'un projet : la supprime et retire sa ligne de history.md. context.md n'est pas restauré.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
slug	string	oui / yes	Slug du projet ou domaine.

mem_historize

Déplace un projet terminé vers 10-episodes/archived/, ou l'en ramène avec revive. Corrige la phase, archived_at et le suffixe d'affichage.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
revive	boolean	non / no	Ramener le projet parmi les actifs.
slug	string	oui / yes	Slug du projet.

mem_update_phase

Met à jour la phase du context.md d'un projet en préservant son corps mot pour mot. Une chaîne vide efface la phase.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
phase	string	oui / yes	Nouvelle phase. Chaîne vide pour l'effacer.
slug	string	oui / yes	Slug du projet ou domaine.

mem_set_summary

Pose le résumé court d'un projet ou domaine dans le frontmatter de son context.md, en préservant le reste du fichier. À appeler après chaque archivage ou point de contrôle mémoriel. Le résumé est ÉCRIT par l'agent : le vault ne sait pas le deviner, et aucune extraction n'est fiable. Borné à 300 caractères — un champ libre sans borne devient un journal.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
slug	string	oui / yes	Slug du projet ou domaine.
summary	string	oui / yes	Le résumé, en une phrase ou deux. 300 caractères au plus. Les retours à la ligne sont écrasés.

mem_worklog

Rassemble les archives de la semaine ISO et leur proration horaire. Phase collect en lecture seule, phase persist écrit le worklog en trois niveaux de verbosité.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
amplitude_hours	number	non / no	Heures travaillées par jour (défaut 7).
brief_md	string	non / no
detailed_md	string	non / no
digest_md	string	non / no
include_weekend	boolean	non / no	Inclure samedi et dimanche.
phase	string	non / no	'collect' (défaut) ou 'persist'.
week_of	string	non / no	Date d'ancrage AAAA-MM-JJ. Vide : aujourd'hui.

mem_archive_rewrite_paths

Réécrit les chemins absolus des archives d'un projet en sigils <repo>/… . Essai à blanc par défaut.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
confirm	boolean	non / no	Sans confirm, l'appel est un essai à blanc.
include_context_history	boolean	non / no	Réécrire aussi context.md et history.md (défaut vrai).
old_root	string	non / no	Ancienne racine absolue. Défaut : le repo_path courant.
slug	string	oui / yes	Slug du projet.