[geaflow/ai-memory] Define `RetrievalMode` contract

[kitalkuyo-gita]

Priority: P0
Difficulty: Starter

Context: GraphMemoryServer currently iterates over configured index stores. There is no explicit Basic, Vector, Graph, or Hybrid mode contract.

Scope:

• Add enum or contract for BASIC, VECTOR, GRAPH, HYBRID.
• Define required inputs, allowed indexes, and expected outputs for each mode.
• Add tests that each mode can be selected explicitly.

Constraints:

• Do not implement router ranking in this issue.
• Do not change answer synthesis.

Acceptance Criteria:

• Calling unsupported mode fails with typed error.
• Mode selection is visible in retrieval trace.

Suggested paths:

• geaflow-ai/src/main/java/org/apache/geaflow/ai/retrieval

[linhongyu510]

我愿意实现这个 issue。在开始修改公共检索契约前，想先确认以下最小设计。

当前 GraphMemoryServer.search(VectorSearch) 会根据 IndexStore 的运行时类型依次执行 SessionOperator 和 EmbeddingOperator，目前没有显式模式或 trace。

建议方案：

• 新增 RetrievalMode { BASIC, VECTOR, GRAPH, HYBRID }。
• 保留现有 search(VectorSearch)，并委托给默认模式，避免破坏兼容性。
• 新增显式模式入口及不可变 RetrievalTrace，记录 requested/effective mode 和实际选择的索引类型。
• 对无法满足所选模式的输入或索引组合抛出类型化异常。
• 本 issue 不实现排序、融合、rerank 或答案生成。
• 使用离线单测覆盖四种模式、旧入口兼容性、缺失输入/索引以及不支持模式。

需要维护者确认三个边界：

1. 现有同时运行关键词/图扩展和 embedding 的行为是否应作为 HYBRID 默认值？
2. 当前 EntityAttributeIndexStore + SessionOperator 应归为 BASIC 还是 GRAPH？如果两者不同，Phase 1 中各自应映射到哪个现有执行路径？
3. [geaflow/ai-memory] Define RetrievalMode contract #859 是否应同时把模式接入 GraphMemoryServer.search，还是只冻结 enum/request/trace 契约，把实际路由留给后续 issue？

确认后我会先提交契约级失败测试，再实现最小兼容改动。