[Finance Data] Add a unified multi-provider financial data gateway #22

Background

Folio 要成为真正可用的金融 Copilot，不能把某一家行情/财务数据供应商的 SDK、字段命名和返回结构直接泄漏到 Agent、Research workflow 和 UI。后续一定会同时接入多种行情、财务、新闻和公司行动数据源，因此需要先建立统一的数据访问边界。

目标是形成一个 provider-agnostic financial data gateway：上层只依赖 Folio 自己的 canonical contract，具体供应商通过 adapter 接入。

Requirements

1. Canonical data contracts

首版至少为以下能力定义稳定的 typed contract：

• instrument/company profile；
• quote / snapshot；
• historical OHLCV / bars；
• key fundamentals / financial statements；
• company/news feed；
• corporate actions（provider 支持时）；
• market/calendar/session metadata（provider 支持时）。

contract 中必须包含必要的 provenance/freshness metadata，不允许只返回裸 number/string。

2. Provider adapters

• 当前已有数据源迁移到统一 adapter；
• 至少再接入 1 个不同 provider，证明 gateway 不是为单一供应商硬编码；
• provider-specific SDK/type 只能存在于 adapter boundary 内；
• Agent/tool/UI 不应 import provider-specific response types。

3. Capability matrix

不同 provider 能力不同，需要显式描述：

• 支持的数据类型；
• 支持的市场/交易所；
• live / delayed / EOD 能力；
• fundamental/history depth；
• quota/rate-limit 特性（可配置）。

调用不存在的能力时返回明确的 machine-readable unsupported_capability，不能静默返回空数据。

4. Provider selection

Gateway 应允许显式指定 provider，也应为后续 routing/fallback 预留统一接口。provider 选择结果必须进入 provenance，不允许最终答案无法知道数据来自哪里。

Acceptance Criteria

• 存在独立、稳定、provider-agnostic 的 finance data interfaces/types。
• 至少两个真实 provider 通过 adapter 接入同一 contract。
• Agent / Research / UI 不直接依赖 provider-specific SDK response types。
• quote、historical bars、fundamentals 至少各有一个真实调用链路经过 gateway。
• unsupported capability 有结构化错误，而不是 null/空数组伪装成功。
• 每个 normalized result 能追踪到实际 provider 和 retrieval metadata。
• provider adapters 有 contract tests；相同上层调用可以切换 provider 而无需修改 Agent/UI 代码。
• PR 必须附至少两个真实 provider 的实际运行结果与 normalization 对比；仅 mock adapter 不算完成。

Non-goals

• 本 Issue 不负责跨 provider 冲突裁决策略；单独处理。
• 不要求首版覆盖所有市场和所有数据字段；先建立可扩展边界。