contracts: 新增 openapi/data-foundation-datasources + ICD（M2 数据源接入链 · 解 gateway#16 阻塞）

[uniquehole]

源起：讨论 #52（gateway 路由被阻塞）。WP1 / 总纲 §62 拆分项之一。父：#50。

背景

M2 数据源接入链（链①，锚点）的路径形状契约缺失。核对 contracts/registry.yaml 与 contracts/openapi/ 未见 data-foundation-datasources（producer 应为 data-foundation）。gateway 按「先改契约再改实现」铁律暂不能配 /api/datasources/* 路由（hashmatrix-gateway#16 被阻塞）。

要达成

• 新增 contracts/openapi/data-foundation-datasources-v1.yaml（producer=hashmatrix-data-foundation）
• 新增 contracts/icd/data-foundation-datasources-icd.md（凭据 D7：明文绝不入契约示例/响应；secret_ref 间接层语义）
• 登记 contracts/registry.yaml，consumers 含 hashmatrix-gateway、hashmatrix-webui
• 连接器中立（D8）：MySQL 为第一个 SPI 方言，路径/schema 不写死单一数据库

路径形状（总纲 §89，最终以契约为准）

POST /api/datasources/test（真 JDBC 连测）、POST /api/datasources、GET /api/datasources（按 X-Tenant-Id）、GET /api/datasources/{id}/tables、POST /api/datasources/{id}/preview（LIMIT N）。均为租户隔离路由（require_tenant=true，带 X-Tenant-Id）。

责任 / 对接

• 起草：data-foundation 工程师（producer）→ PR 到主仓 contracts/（契约 SoT 在主仓）
• 评审：主仓 contracts 治理 + webui（SDK 生成）+ gateway（路由）
• 解阻塞：hashmatrix-gateway#16（Blocked by 本 issue）

验收

registry 索引到；spectral/oasdiff 加法兼容；webui SDK 可生成；gateway 据此配路由。