# reflect

dry-run計画とaudit evidenceを伴う、boundedなconsolidationとmemory-lifecycle maintenance passを実行します。

- Canonical: https://docs.xmemo.dev/ja/docs/tools/reflect
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 7afa4b8d44fff19ccfcb601c0e34865481552d9859f6c34ad606585ce7cba9a4
- Edition-Digest: 16bcd39e8579974cc5b0e644cce26332b8d1eac1120b2e84db72e28d17bc9f3c
- Source-Revision: sha256:fba63cf2a719e03b0aeff710b1b21a15473a175f8e5efc7000cc9bc6ebb7792a

## Tool Reference: `reflect`

### Purpose

dry-run計画とaudit evidenceを伴う、boundedなDream/Reflection maintenance passを実行し、consolidationとmemory-lifecycleの判断を報告します。選択したwriteは任意で適用できます。

### Parameters

- `actions_csv` (string, optional, default: summarize,promote,expire,decay,archive): comma-separated actionです。shipped actionはsummarize、promote、expire、decay、archiveで、summary、promotion、expiry、importance_decayなどのaliasはcompactorがnormalizeします。
- `dry_run` (boolean, optional, default: false): trueの場合、consolidationやlifecycle writeを行わずcandidateとcountを計算します。reviewではこれを優先してください。
- `time_window_hours` (number, optional, default: 24.0): episodic summarize/promoteの選択に使う正のlookback windowです。指定されるとsinceが優先されます。
- `since / until` (string, optional, default: empty): reflection windowの任意のISO 8601 boundaryです。不正なtimestampは拒否されます。
- `path_filter / owner_filter` (string, optional, default: % / authenticated owner): logical pathとownerのfilterです。serverはowner filterを認証済みcontextに対して解決します。
- `bucket / scope / team_id` (string, optional, default: % / empty / empty): 任意のmemory boundary filterです。明示的なteam_idはboundまたは認証済みteam contextと一致する必要があります。
- `limit` (integer, optional, default: 500): compactorに渡すcandidate budgetの最大値です。implementationは対応範囲内に制限します。

### Returns

compactorはdry_run、normalized actions、filters、summaries、promotions、lifecycle details、counts.summarized/promoted/expired/decayed/archived、audit_record_idsを含むreportを構築します。MCP text responseは'### Memory Reflect Report'で始まり、Dry Run、Actions、5つすべてのcount、Audit Records、最大20件のAudit IDを表示します。

### Errors

- 401/403: dry_runに必要なread scope、mutating runに必要なwrite scopeがないか、要求されたowner/team/bound spaceが認可されていません。
- Validation failure: actionがunsupported、time_window_hoursがpositiveでない、since/untilがISO 8601でない、またはboundary/limit valueが無効です。
- Team authorization failure: 認可されていないteam lifecycle mutationは、暗黙に適用せず拒否されます。
- Concurrency or audit failure: memoryの変更、不完全なstatus transition、またはconsolidation auditのfailureはrollbackされるかerrorとして報告されます。

### Examples

#### maintenance pass全体をプレビューする



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

#### 明示的に認可したlifecycle actionを適用する



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

### Related Tools

- [recall_context](/docs/tools/recall-context): maintenanceが必要か判断する前にbounded context packを読みます。
- [remember](/docs/tools/remember): consolidation passを実行せず、明示的に依頼されたdurable factを1件保存します。
- [search_memory](/docs/tools/search): lifecycle maintenanceではなくretrievalが必要なとき、認可済みmemoryを検索します。

## 変更前にプレビューする

dry_run=trueを使って、5つのreleased reflection action、そのcount、candidate detailを確認してから、summary、promotion、expiry、decay、archiveのwriteを許可します。