Dream / Reflection

Dream プレビューアーキテクチャと明示的なレビューワークフロー

Dream は https://xmemo.dev/me#dream の Memory Console で利用可能な、ユーザーが確認する独立した Preview 機能です。これは reflect メンテナンスツール（MCP/API 経由でオンデマンドでプログラムによる統合パスを実行するツール；/docs/tools/reflect を参照）とは異なります。Dream はバックグラウンドでサイレントな変更を実行するのではなく、ユーザーがレビューして保存することを選択したものを優先し、散在する会話コンテキストをソースに裏付けられた候補に整理します。

• コンソールワークスペース: https://xmemo.dev/me#dream の Memory Console では、Dream は「"Review recurring patterns before they become long-term memory."」というサブタイトルのもとで対話型のプレビューワークスペースを提供します。
• ユーザー主導のレビュー: Dream がバックグラウンドで永続メモリを変更することは決してありません。宛先への書き込みが発生する前に、すべての候補アイテムに対して明示的な人間の検査と確認が必要です。
• reflect との相違点: Dream はユーザーによる検査のために候補が生成され、明示的な人間の確認なしには何も保存されない独立したプレビュー機能です。これに対して、reflect メンテナンスパス（/docs/tools/reflect）は内部ツールであり、その summarize アクションはアクティブなエピソードメモリを読み取り、reflections/episodic 配下にソースに基づいた要約を書き込みます。繰り返される事実に対して、reflect は平均重要度 0.35 以上かつ平均信頼度 0.6 以上を必要とするエピソードからセマンティックへの promote アクションを提供します。そのライフサイクルアクションは expire、decay、archive を実行し、dry_run により宛先への書き込みを伴わない安全な計画立案を提供します。
• アーキテクチャ境界: Dream 候補生成は厳密にプレビューメカニズムであり、投機的な Light、REM、Deep マルチパスアーキテクチャや自律的なバックグラウンド変更は実装していません。
• 安全な障害姿勢: 実行が停止したり問題が発生したりした場合でも、既存のメモリには一切影響しません（「"Dream stopped safely. Existing memory was not changed."」）。

アカウントの提供状況、プランカタログのステータス、およびプレビューの境界

Dream はアカウントで Dream が有効になっている場合にのみ厳格に動作します。本番環境ではすべてのランタイム制御がデフォルトでオフになっています。公開ドキュメントでは内部構成フラグの露出を避けています。

• アカウントの提供状況: Dream はアカウントで Dream が有効になっている場合にのみ厳格に動作します。ワークスペースでこの機能がアクティブでない場合、コンソールには「"Dream is not enabled for this workspace yet. Your memory remains unchanged."」と表示されます。
• カタログのステータス: 製品プランカタログでは Dream は Free ティアに含まれておらず、Plus ティアには Dream 機能が記載されています。しかし、商用エンフォースメントが無効な場合はパーソナルフォールバックプロバイダーがアクセスを拒否するため、ドキュメントでは Plus によって現在実際に Dream が利用可能になるとは主張していません。
• 不具合の境界: Dream は現在プレビュー段階であり、アカウントに対してまだ候補が生成されない場合があります。モデルベースの統合は提供されたワーカー環境で直接実行することはできず、候補の確認はサーバーのキャパシティ構成に依存します。
• 厳格な人間の確認: システムは厳格な人間の確認境界を適用します。ドキュメントでは自動保存やバックグラウンド追加に関する一切の主張を否定しており、提案されたすべてのアイテムにはユーザーの手動による同意が必要です。

実行ライフサイクル、証拠の適格性、およびフィルター理由コード

Dream の実行では、ソースレコードを変更することなく繰り返されるパターンを特定するために、設定可能な観察ウィンドウ（デフォルトは 30 日間）にわたって適格なメモリ証拠をレビューします：

• 証拠収集: プレビュー実行では、観察ウィンドウ（--window-days により最大 365 日までカスタマイズ可能）内に作成されたアクティブで想起可能なエピソードメモリを検査します。
• 裏付けのある候補: 適格な証拠は繰り返されるテーマにグループ化され、ソース系統と信頼度スコア（「"Confidence Score"」）とともに表示される候補アイテムが生成されます。
• 証拠が除外された理由: コンソールでは、標準化された理由チップを使用して、実行サマリーが「"Why evidence was filtered"」を報告します：score below threshold、insufficient occurrences、insufficient evidence days、insufficient query contexts、duplicate candidate、source not episodic、source inactive、および contradiction detected。
• コンテンツを含まない実行サマリー: 完了した実行には、「"Dream reviewed {{considered}} signals, generated {{generated}} grounded candidates, and saved {{promoted}} confirmed memories."」というレビューサマリーが表示され、安全性の保証「"This report is review-only and never becomes Dream evidence."」が添えられます。

コンソールの動作モードとスケジューリングプリセット

Dream 設定では、コンソールの設定ドロワー内で実行モードと評価スケジュールをきめ細かく制御できます：

• 動作モード: ユーザーは 2 つの動作モードから選択します：「"Preview only"」（書き込み権限なしで証拠を評価しレビュー可能な候補を生成）および「"Allow explicit confirmation"」（確認インターフェースを有効にして、ユーザーが個々の候補をレビューし選択してコミットできるようにする）。
• スケジューリングプリセット: 実行頻度は 3 つのプリセットで設定されます：「"Manual only"」（コンソールで「"Run Preview"」を選択するか CLI プレビューコマンドを発行したオンデマンド時のみ実行）、「"Daily around 03:00"」（ユーザーの現地タイムゾーンで 03:00 頃に評価されるスケジュールされた毎日の実行）、および「"Weekly on Monday around 03:00"」（ユーザーの現地タイムゾーンで月曜日の 03:00 頃に評価されるスケジュールされた毎週の実行）。
• スケジュール実行の制限: スケジュールされた実行は preview only モードで動作します。バックグラウンドスケジュールの評価がメモリ書き込みをコミットしたり人間のレビューをバイパスしたりすることは決してありません。
• タイムゾーンの基準: スケジュールされた実行にはユーザーのブラウザのローカルタイムゾーンが使用されます。

確認ワークフロー、型付き成果物、および宛先ライフサイクル

候補のコミットは追記専用（append-only）であり、ユーザーの明示的なアクションが必要です。コンソールは単一アイテムの確認とオプションの型付き成果物をサポートしています：

• コアの確認: 標準のプレビューモードで候補カードの「"Confirm and save"」ボタンをクリックすると、セマンティックキー dream:confirmed:... を持つパス dream/confirmed/... 配下に新しいメモリレコードが作成されます。ソースメモリが編集されたり上書きされたりすることは決してありません。
• 型付き成果物の設定: 型付き成果物が利用可能な場合、設定ドロワーに質問「"What should Dream prepare?"」と案内「"Choose what to generate. Turning a type off keeps existing drafts and saved content."」が表示されます。
• 6 つの生成選択肢: (1) Preferences: "Clarify your preferences"; (2) Knowledge: "Distill knowledge worth keeping"; (3) Skills: "Turn experience into reusable skills"; (4) Projects: "Organize project memory"; (5) Patterns: "Discover lasting patterns"; (6) Durable Memory: "Build reusable long-term memory"。
• 生成スイッチと宛先の同意の違い: 生成スイッチを有効にしても宛先への同意が付与されたことにはなりません。準備されたすべての結果は「"Prepared for your review"」配下に表示され、手動レビューが必要です。
• 候補レビューアクション: レビュアーは「"Save edits"」を選択して提案されたタイトルやコンテンツを変更したり、「"Review later"」で保留したり、「"Reject"」で破棄したり、対象の宛先に受け入れたりできます。
• 宛先ごとの受け入れ: Knowledge は「"Add draft to knowledge base"」経由で選択したナレッジベースに DRAFT として受け入れられます（検索インデックス状態：「"Saved. Preparing for search."」、「"Search index is ready. Publication is a separate choice."」、「"Saved, but indexing needs another attempt."」）；Skill は「"Add draft to Cloud Skills"」経由で DRAFT として受け入れられます；Project は「"Confirm project organization"」経由で受け入れられます（プロジェクト関連付けの成果物は、既存のメモリをプロジェクトワークスペースに再割り当てする唯一のパスです）；Memory は「"Save as memory"」経由で受け入れられます。
• 削除: 確認された結果は、それぞれのストア内の標準メモリ、ナレッジドラフト、またはスキルのドラフトになります。これらは標準のコンソールまたは API の削除アクションを使用して削除されます。Dream 固有のロールバックや元に戻すメカニズムはありません。

ワークスペースの分離、チームの境界、および CLI 操作

ワークスペース権限と CLI ツールは、厳格なマルチテナント境界とロール機能を適用します：

• ワークスペースのスコープ指定: コンソールヘッダーは、アクティブなワークスペースを「"Personal space"」または「"Team space"」として識別します。
• チーム権限: Team 空間では、Team の所有者と管理者のみが Dream 設定を変更し、アクティブな実行をキャンセルし、候補メモリを確認できます（「"Only Team owners and admins can change Dream settings."」）。
• チーム型付き成果物の制限: 型付き成果物は Team 空間では利用できません。Team ワークスペースは preview-only または v1 メモリ確認モードで動作します。
• 検証済みの CLI コマンド: xmemo CLI（固定コミット d412c7866b7a4c8eedb3a0cf40748c6aef8707ec、src/commands/dream.js）は 3 つの検証済みコマンドをサポートしています：xmemo dream preview [--window-days <n>] [--wait] [--json]（プレビューをトリガーします；プレビューが無効な場合は「"Dream preview is disabled; CLI will not change Dream settings."」でフェイルクローズします）、xmemo dream show <run-id> [--wait] [--json]（候補アイテムを表示します；開封確認のための --receipt-out をサポート）、および xmemo dream apply <run-id> --item <id> --from <view.json> --yes [--json]（v1 confirm エンドポイントを使用して候補を確認します）。
• CLI 運用の境界: CLI は Dream 構成設定を変更できず（設定はコンソールで管理する必要があります）、dream apply は排他的に v1 メモリ確認で動作します（型付き成果物の変更は実行しません）。

# Trigger a candidate preview across a 30-day window
xmemo dream preview --window-days 30 --wait --json

# Inspect candidate proposals and record a read receipt
xmemo dream show <run-id> --receipt-out receipt.json

# Confirm a candidate proposal into memory via v1 confirmation
xmemo dream apply <run-id> --item <item-id> --from view.json --yes