# reflect

Ejecuta una pasada acotada de consolidación y mantenimiento del ciclo de vida de la memoria con planificación dry-run y evidencia de auditoría.

- Canonical: https://docs.xmemo.dev/es/docs/tools/reflect
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 7afa4b8d44fff19ccfcb601c0e34865481552d9859f6c34ad606585ce7cba9a4
- Edition-Digest: 1608738310bf4efa309c890eb2431f5c5239f78124c8114c0f25265a3d9d05f4
- Source-Revision: sha256:fba63cf2a719e03b0aeff710b1b21a15473a175f8e5efc7000cc9bc6ebb7792a

## Tool Reference: `reflect`

### Purpose

Ejecuta una pasada acotada de mantenimiento Dream/Reflection que informa sobre la consolidación y las decisiones del ciclo de vida de la memoria, con posibilidad de aplicar las escrituras seleccionadas.

### Parameters

- `actions_csv` (string, optional, default: summarize,promote,expire,decay,archive): Acciones separadas por comas. Las acciones publicadas son summarize, promote, expire, decay y archive; el compactor normaliza alias como summary, promotion, expiry e importance_decay.
- `dry_run` (boolean, optional, default: false): Cuando es true, calcula candidatos y recuentos sin realizar escrituras de consolidación o ciclo de vida; es preferible para revisión.
- `time_window_hours` (number, optional, default: 24.0): Ventana positiva de consulta retrospectiva para seleccionar episodios de summarize/promote; since la sustituye cuando se proporciona.
- `since / until` (string, optional, default: empty): Límites ISO 8601 opcionales para la ventana de reflexión; se rechazan las marcas de tiempo mal formadas.
- `path_filter / owner_filter` (string, optional, default: % / authenticated owner): Filtros de ruta lógica y propietario. El servidor resuelve el filtro de propietario contra el contexto autenticado.
- `bucket / scope / team_id` (string, optional, default: % / empty / empty): Filtros opcionales del límite de memoria; un team_id explícito debe coincidir con el contexto de equipo vinculado/autenticado.
- `limit` (integer, optional, default: 500): Presupuesto máximo de candidatos que se pasa al compactor; la implementación lo limita a su rango admitido.

### Returns

El compactor genera un informe con dry_run, acciones normalizadas, filtros, summaries, promotions, detalles del ciclo de vida, counts.summarized/promoted/expired/decayed/archived y audit_record_ids. La respuesta de texto MCP comienza con '### Memory Reflect Report' y muestra Dry Run, Actions, los cinco counts, Audit Records y hasta los primeros 20 Audit IDs.

### Errors

- 401/403: el caller carece del scope de lectura para dry_run o del scope de escritura para una ejecución mutante, o el propietario/equipo/bound space solicitado no está autorizado.
- Validation failure: una acción no es compatible, time_window_hours no es positivo, since/until no es ISO 8601 o un valor de límite/limit no es válido.
- Team authorization failure: una mutación de ciclo de vida de equipo no autorizada se rechaza en lugar de aplicarse silenciosamente.
- Concurrency or audit failure: un cambio de memoria, una transición de estado incompleta o una auditoría de consolidación fallida se revierte o se informa como error.

### Examples

#### Previsualiza una pasada completa de mantenimiento



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

#### Aplica una acción del ciclo de vida autorizada explícitamente



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

### Related Tools

- [recall_context](/docs/tools/recall-context): Lee un paquete de contexto acotado antes de decidir si hace falta mantenimiento.
- [remember](/docs/tools/remember): Persiste un hecho durable solicitado explícitamente sin ejecutar una pasada de consolidación.
- [search_memory](/docs/tools/search): Busca memorias autorizadas cuando necesitas recuperación y no mantenimiento del ciclo de vida.

## Previsualiza antes de cambiar la memoria

Usa dry_run=true para inspeccionar las cinco acciones de reflexión publicadas, sus recuentos y los detalles de los candidatos antes de permitir una escritura de resumen, promoción, expiración, decaimiento o archivado.