# reflect

Execute uma etapa limitada de consolidação e manutenção do ciclo de vida da memória com planejamento dry-run e evidências de auditoria.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/reflect
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 7afa4b8d44fff19ccfcb601c0e34865481552d9859f6c34ad606585ce7cba9a4
- Edition-Digest: 82297688dcb4abf6b6e87c2edeace98378faa69009834ca1dbbb2841b492f980
- Source-Revision: sha256:fba63cf2a719e03b0aeff710b1b21a15473a175f8e5efc7000cc9bc6ebb7792a

## Tool Reference: `reflect`

### Purpose

Execute uma etapa limitada de manutenção de Dream/Reflection que informa decisões de consolidação e do ciclo de vida da memória, aplicando opcionalmente as gravações selecionadas.

### Parameters

- `actions_csv` (string, optional, default: summarize,promote,expire,decay,archive): Ações separadas por vírgula. As ações publicadas são summarize, promote, expire, decay e archive; aliases como summary, promotion, expiry e importance_decay são normalizados pelo compactor.
- `dry_run` (boolean, optional, default: false): Quando true, calcula candidatos e contagens sem gravações de consolidação ou do ciclo de vida; prefira-o para revisão.
- `time_window_hours` (number, optional, default: 24.0): Janela positiva de consulta retroativa para seleção episódica de summarize/promote; since a substitui quando fornecido.
- `since / until` (string, optional, default: empty): Limites ISO 8601 opcionais para a janela de reflexão; timestamps malformados são rejeitados.
- `path_filter / owner_filter` (string, optional, default: % / authenticated owner): Filtros de caminho lógico e proprietário. O servidor resolve o filtro de proprietário no contexto autenticado.
- `bucket / scope / team_id` (string, optional, default: % / empty / empty): Filtros opcionais de limite da memória; um team_id explícito precisa corresponder ao contexto de equipe vinculado/autenticado.
- `limit` (integer, optional, default: 500): Orçamento máximo de candidatos passado ao compactor; a implementação o limita ao intervalo compatível.

### Returns

O compactor monta um relatório com dry_run, ações normalizadas, filtros, resumos, promoções, detalhes do ciclo de vida, counts.summarized/promoted/expired/decayed/archived e audit_record_ids. A resposta de texto MCP começa com '### Memory Reflect Report' e renderiza Dry Run, Actions, as cinco contagens, Audit Records e até os primeiros 20 Audit IDs.

### Errors

- 401/403: o chamador não possui escopo de leitura para dry_run ou escopo de gravação para uma execução mutável, ou o owner/equipe/bound space solicitado não é autorizado.
- Falha de validação: uma ação não é compatível, time_window_hours não é positivo, since/until não está em ISO 8601 ou um valor de limite/paginação é inválido.
- Falha de autorização de equipe: uma alteração do ciclo de vida de uma equipe não autorizada é rejeitada, em vez de ser aplicada silenciosamente.
- Falha de concorrência ou auditoria: uma memória alterada, uma transição de status incompleta ou uma auditoria de consolidação com falha é revertida ou informada como erro.

### Examples

#### Faça uma prévia de uma etapa completa de manutenção



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

#### Aplique uma ação de ciclo de vida explicitamente autorizada



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

### Related Tools

- [recall_context](/docs/tools/recall-context): Leia um pacote de contexto limitado antes de decidir se a manutenção é necessária.
- [remember](/docs/tools/remember): Persista um fato duradouro explicitamente solicitado sem executar uma etapa de consolidação.
- [search_memory](/docs/tools/search): Pesquise memórias autorizadas quando precisar de recuperação, não de manutenção do ciclo de vida.

## Faça uma prévia antes de alterar a memória

Use dry_run=true para inspecionar as cinco ações de reflexão liberadas, suas contagens e os detalhes candidatos antes de permitir uma gravação de resumo, promoção, expiração, decaimento ou arquivamento.