# reflect

Exécutez une passe de maintenance délimitée de consolidation et de cycle de vie de la mémoire avec planification en simulation et preuves d'audit.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/reflect
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: 7afa4b8d44fff19ccfcb601c0e34865481552d9859f6c34ad606585ce7cba9a4
- Edition-Digest: 20518fd6d19680872a55514a826cd68e4aba19f9cc7d4ba9ca1694483d10240d
- Source-Revision: sha256:fba63cf2a719e03b0aeff710b1b21a15473a175f8e5efc7000cc9bc6ebb7792a

## Tool Reference: `reflect`

### Purpose

Exécuter une passe de maintenance délimitée Dream/Reflection qui rend compte des décisions de consolidation et de cycle de vie de la mémoire, avec application facultative des écritures sélectionnées.

### Parameters

- `actions_csv` (string, optional, default: summarize,promote,expire,decay,archive): Actions séparées par des virgules. Les actions prises en charge sont summarize, promote, expire, decay et archive ; les alias tels que summary, promotion, expiry et importance_decay sont normalisés par le compacteur.
- `dry_run` (boolean, optional, default: false): Lorsque vrai, calcule les candidats et les totaux sans écritures de consolidation ou de cycle de vie ; à privilégier pour examen.
- `time_window_hours` (number, optional, default: 24.0): Fenêtre rétrospective positive pour la sélection de résumé/promotion épisodique ; since a priorité lorsqu'il est fourni.
- `since / until` (string, optional, default: empty): Limites ISO 8601 facultatives pour la fenêtre de réflexion ; les horodatages malformés sont rejetés.
- `path_filter / owner_filter` (string, optional, default: % / authenticated owner): Filtres de chemin logique et de propriétaire. Le serveur résout le filtre de propriétaire par rapport au contexte authentifié.
- `bucket / scope / team_id` (string, optional, default: % / empty / empty): Filtres de limite de mémoire facultatifs ; un team_id explicite doit correspondre au contexte d'équipe lié/authentifié.
- `limit` (integer, optional, default: 500): Budget maximal de candidats transmis au compacteur ; l'implémentation le contraint à sa plage prise en charge.

### Returns

Le compacteur génère un rapport avec dry_run, actions normalisées, filtres, résumés, promotions, détails du cycle de vie, counts.summarized/promoted/expired/decayed/archived et audit_record_ids. La réponse textuelle MCP s'ouvre sur '### Memory Reflect Report' et affiche Dry Run, Actions, les cinq totaux, Audit Records et jusqu'aux 20 premiers Audit IDs.

### Errors

- 401/403 : jeton manquant ou autorisations insuffisantes pour les actions de cycle de vie demandées.
- Échec de validation : time_window_hours est négatif, la chaîne actions_csv contient des actions non reconnues ou la limite dépasse le maximum.
- Périmètre invalide : le filtre path_filter ou team_id demandé est en dehors des limites autorisées.
- Conflit de cycle de vie : un enregistrement cible a été modifié simultanément pendant la passe de consolidation.

### Examples

#### Prévisualiser une passe de maintenance complète



```typescript
reflect({
  actions_csv: "summarize,promote,expire,decay,archive",
  dry_run: true,
  time_window_hours: 24,
  limit: 500
})
```

#### Appliquer une action de cycle de vie explicitement autorisée



```typescript
reflect({
  actions_csv: "archive",
  dry_run: false,
  bucket: "personal",
  limit: 100
})
```

### Related Tools

- [recall_context](/docs/tools/recall-context): Lire un pack de contexte délimité avant de décider si une maintenance est nécessaire.
- [remember](/docs/tools/remember): Persister un fait durable explicitement demandé sans exécuter de passe de consolidation.
- [search_memory](/docs/tools/search): Rechercher des mémoires autorisées lorsque vous avez besoin d'une récupération plutôt que d'une maintenance de cycle de vie.

## Prévisualiser avant de modifier la mémoire

Exécutez d'abord avec dry_run: true. Inspectez les nombres d'éléments promus, résumés et expirés avant de planifier une passe d'écriture.