コンテンツにスキップ

Memory Orchestration End-to-End 仕様書

最終更新: 2026-08-23

1. 目的

本仕様は、Sparse Evo-MemoryLM における MemoryOrchestrator の end-to-end 実行経路を定義する。 対象は request normalization, retrieval, context fusion, model execution, learning update, writeback, failure handling である。

2. 実行フロー

  1. 入力を受け取り、InputNormalizer で正規化する。
  2. transaction_started と retrieval_started を記録する。
  3. semantic context を抽出し、retrieval を実行する。
  4. retrieval 結果を prune/fusion し、MemoryContextPayload を作る。
  5. retrieval 結果と入力文から causal_context を抽出する。
  6. ExecutionPolicy で実行方針を決める。
  7. モデル推論を実行し、必要時は fallback を適用する。
  8. consolidation でなければ learning update と writeback を実行する。
  9. 成功時は commit、失敗時は rollback/degraded を返す。

3. ID 分離契約 (tenant/user/client)

  • tenant_id, user_id, client_id を MemoryOrchestrator.process_request(...) に伝播する。
  • 互換モード (既定): tenant_id 未指定時は public を補完し、user_id と client_id は省略可能。
  • strict モード: 環境変数 EVOSPIKENET_IDENTITY_STRICT=true の場合、API は tenant_id/user_id/client_id 未指定を 400 で拒否する。
  • retrieval と writeback は tenant 境界を必須キーとして扱い、異なる tenant 間の混在を防ぐ。
  • 永続フォールバックスナップショットは tenant サブディレクトリ (<persistent_fallback_dir>/<tenant_id>/) に保存する。

4. 失敗時契約

  • fail-fast (fail_fast=true) では OrchestrationRuntimeError を送出する。
  • degraded (fail_fast=false) では構造化 FailureHandlingResult を返す。
  • エラーコード:
  • MLI-REQ-001 request normalization
  • MLI-RET-001 memory retrieval
  • MLI-EXE-001 model execution
  • MLI-LRN-001 learning update
  • MLI-WRB-001 memory writeback

5. 永続フォールバック

persistent_fallback_dir を設定している場合、degraded failure 時に JSON スナップショットを保存する。

保存項目:

  • request/session/source/status
  • failure_type/failed_stage/error_code/message
  • 構造化 failure オブジェクト
  • memory event trail

6. スキーマ

  • MemoryContextPayload
  • semantic_context, retrieved_memories, causal_context, generated_output
  • FailureHandlingResult
  • failure_type, failed_stage, error_code, retryable, safe_mode
  • OrchestrationResponse
  • status, failure, metadata, causal_context

7. 関連ドキュメント

  • EvoSpikeNet-Core/specs/system_orchestration_spec.md
  • EvoSpikeNet-Core/specs/system_orchestration_spec.ja.md
  • SPARSE_EVO_MEMORYLM_SYSTEM_REVIEW.md