记忆修正

修正记录，不要追加矛盾

修正通过 PATCH /v1/memories/{memory_id} 修改已有记忆。MemoryUpdateRequest 的每个字段都是可选的，包含 content、path、metadata、source、provenance、memory_type、status、expires_at、scope 和 team_id。这样修正会附着在同一个 memory reference 上，并让服务器应用其版本化路径。

PATCH /v1/memories/<memory-id>
X-API-Key: <your-assigned-api-key>
Content-Type: application/json

{
  "content": "The corrected deployment decision was verified on 2026-09-02.",
  "provenance": {
    "correction": "owner-confirmed"
  },
  "merge_provenance": true,
  "detect_conflicts": true
}

版本和冲突控制属于请求的一部分

更新 contract 包含 merge_metadata、merge_provenance 和 detect_conflicts，默认值都为 true，另有 supersession_reason。持久化路径会递增 memory version，并在公开 memory contract 中保留 status、superseded_by 和 conflict evidence；应将返回的 implementation data 作为当前结果读取，而 OpenAPI response 仍未类型化。

• 如果修正应保留已有证据，请合并 metadata 和 provenance。
• 如果并发编辑或竞争版本很重要，请保持 detect_conflicts 启用。
• 如果修正有意取代早期版本，请使用 supersession_reason。

验证修正后的 scope

修正后执行一次 scoped read，并检查返回的 version、status、provenance 和 conflict fields。Retrieval 仍遵循已认证的 scope 与 memory status filters；PATCH 成功本身不能证明预期的 scoped 结果已经可见。

GET /v1/memories/search?query=corrected%20deployment%20decision&scope=memory-os&status=active&limit=5
X-API-Key: <your-assigned-api-key>