概述

完善 RAM-A-MEM 的输入参数和运行时配置约束，增强 Pipeline 与存储故障的可观测性，并补充记忆摄入、检索、幂等、Rerank 和日志行为的自动化验收用例。

主要变更

• 为 MCP 记忆摄入和检索接口的会话标识、消息标识、说话人、案例库、查询文本及集合大小增加 Unicode 字符数和 Schema 约束。
• 补充记忆摄入幂等性边界覆盖，包括 Principal/会话范围隔离、消息元数据变更冲突、缓存命中及仅上下文消息请求。
• 覆盖记忆类型和语气类型枚举、Evidence span 精确匹配、candidate Evidence 要求、Grounding 结果、超长记忆隔离及 fail_fast 行为。
• 为 HTTP 限制、Session Admission、Pipeline、检索模式和权重、Rerank、Provider、认证、图检索、案例库及持久化存储路径增加明确的运行时边界与关联配置校验。
• 保留 Provider 和 Pipeline 的原始错误位置，在 MCP 失败响应中返回请求关联标识，并区分 Embedding、幂等存储、SQLite、向量持久化、Rerank、Extract 和 Ground 等主要故障。
• 通过 RAM_A_LOG_FORMAT 支持 json 和 compact 日志格式，通过 RAM_A_LOG_SOURCE 控制源码位置输出；补充七阶段 Pipeline 事件、稳定诊断字段及敏感内容脱敏。
• 明确 Rerank 重试分类与 fail_open 行为；仅在显式启用 fail_open 时，Rerank 失败才返回 Rerank 前的 Hybrid 排序结果。
• 补充 RAM-A-MEM 完整配置、Pipeline/检索输入输出、日志设计及 RPM/Agent 自测流程文档。

兼容性与安全性

• 默认日志格式仍为 JSON，默认不输出源码位置。
• 已有合法配置继续使用文档中定义的默认值；非法或相互矛盾的运行时配置会在服务启动校验阶段失败。
• 日志不会记录 Bearer Token、API Key、消息正文、Evidence quote 或完整记忆正文。
• 本次提交不包含内部测试跟踪材料和本地执行产物。

验证结果

• cargo test -p memory-mcp：146 个测试通过。
• cargo test -p memory-pipeline：40 个测试通过。
• cargo check --workspace：通过。
• cargo clippy -p memory-mcp --all-targets -- -D warnings -A clippy::field-reassign-with-default -A clippy::items-after-test-module：通过。
• 修改涉及的 Rust 源文件通过 rustfmt --edition 2021 --check。
• git diff --check：通过。

当前分支基于最新的 upstream/master，领先 7 个提交，没有仅存在于上游的新增提交。