# reflect

Führen Sie einen begrenzten Konsolidierungs- und Speicherlebenszyklus-Wartungslauf mit Testlauf-Planung (Dry Run) und Auditnachweisen durch.

- Canonical: https://docs.xmemo.dev/de/docs/tools/reflect
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 7afa4b8d44fff19ccfcb601c0e34865481552d9859f6c34ad606585ce7cba9a4
- Edition-Digest: 7772d5040d506c71bfa4abd108600cf83c531ad1b4920e0fde3c8ccb94910dfc
- Source-Revision: sha256:fba63cf2a719e03b0aeff710b1b21a15473a175f8e5efc7000cc9bc6ebb7792a

## Tool Reference: `reflect`

### Purpose

Einen abgegrenzten Dream/Reflection-Wartungsdurchlauf ausführen, der Konsolidierungs- und Lebenszyklusentscheidungen protokolliert und optional ausgewählte Schreibvorgänge anwendet.

### Parameters

- `actions_csv` (string, optional, default: summarize,promote,expire,decay,archive): Kommagetrennte Liste der auszuführenden Aktionen: summarize, promote, decay, expire, archive.
- `dry_run` (boolean, optional, default: false): Simulationsmodus (Standard: true): Berechnet und meldet alle Aktionen, führt jedoch keine Änderungen aus.
- `time_window_hours` (number, optional, default: 24.0): Zeitfenster in Stunden zur Eingrenzung der zu analysierenden Erinnerungen.
- `since / until` (string, optional, default: empty): Optionale ISO-Zeitstempel zur expliziten zeitlichen Eingrenzung des Wartungsdurchlaufs.
- `path_filter / owner_filter` (string, optional, default: % / authenticated owner): Filterkriterien zur Beschränkung der Konsolidierung auf bestimmte Projektpfade oder Eigentümer.
- `bucket / scope / team_id` (string, optional, default: % / empty / empty): Bereichs- und Mandantenabgrenzung für den Reflexionsdurchlauf.
- `limit` (integer, optional, default: 500): Maximale Anzahl von Erinnerungskandidaten, die in einem Durchlauf verarbeitet werden.

### Returns

Der Kompaktor erstellt einen Bericht mit dry_run, normalisierten Aktionen, Filtern, Zusammenfassungen, Beförderungen, Lebenszyklusdetails, counts.summarized/promoted/expired/decayed/archived und audit_record_ids. Die MCP-Textantwort beginnt mit '### Memory Reflect Report' und zeigt Dry Run, Aktionen, alle fünf Zählerstände, Audit Records und bis zu 20 Audit-IDs an.

### Errors

- 401/403: Unzureichende Berechtigungen für Speicherbereiche oder schreibenden Wartungsmodus.
- Validierungsfehler: Unbekannte Aktionen in actions_csv oder ungültige Zeitfenstergrenzen.
- Sperrkonflikt: Ein anderer Wartungslauf ist für diesen Bereich derzeit bereits aktiv.
- Ressourcenlimit: Zu viele Kandidaten für einen einzelnen Batch; schränken Sie time_window_hours oder path_filter ein.

### Examples

#### Einen vollständigen Wartungsdurchlauf in der Vorschau prüfen



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

#### Eine explizit autorisierte Lebenszyklusaktion anwenden



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

### Related Tools

- [recall_context](/docs/tools/recall-context): Kontext vor dem Auslösen von Konsolidierungsregeln prüfen.
- [remember](/docs/tools/remember): Dauerhafte Zusammenfassungen manuell speichern, wenn automatische Konsolidierung nicht greift.
- [search_memory](/docs/tools/search): Kandidatenerinnerungen vor der Ausführung von reflect gezielt einsehen.

## Vorschau vor dem Ändern des Speichers anzeigen

Verwenden Sie dry_run=true, um die fünf freigegebenen Reflexionsaktionen, deren Anzahlen und Kandidatendetails zu prüfen, bevor Sie Schreibvorgänge für Zusammenfassung, Beförderung, Ablauf, Zerfall oder Archivierung zulassen.