contracts: 扩 governance-metadata 写入面（资产登记/编辑 · 解 gateway#17 阻塞）

[uniquehole]

源起：讨论 #52。WP1 / 总纲 §63/§82 拆分项之一。父：#50。

背景

M2 数据目录·资产登记链（链②）需要 governance 的写入面。现 contracts/openapi/governance-metadata-v1.yaml 仅有读侧（GET /api/meta/search、/api/meta/detail、/api/meta/lineage、/api/perm/*）与 POST /api/open/query，无资产登记/编辑写端点。gateway #17 被阻塞。

要达成

• 扩 contracts/openapi/governance-metadata-v1.yaml 写入面（加法 MINOR，不破坏既有读侧）
• 同步 contracts/icd/governance-metadata-icd.md 写入面描述（现仅描述 search 取数）
• registry 版本递增（producer=hashmatrix-governance）

路径形状（最终以契约为准）

资产登记/编辑写入面，建议 POST /api/meta/assets、PUT /api/meta/assets/{id}。租户隔离（require_tenant=true，写时落 tenant_id，读时强制过滤 — D9）。

责任 / 对接

• 起草：governance 工程师（producer）→ PR 到主仓 contracts/
• 评审：主仓 contracts 治理 + webui + gateway
• 解阻塞：hashmatrix-gateway#17（Blocked by 本 issue）

验收

oasdiff 对既有读侧加法兼容；registry 版本对齐；webui SDK 可生成写端点。

[uniquehole]

主仓拍板：写入面资源模型/幂等/租户语义（源 讨论 #53）

起草 #56 时按以下轮廓固化（governance #29 据此实现）：

1. 资源模型——读写 DTO 分离：写侧独立 AssetUpsertRequest，不复用读侧 AssetSummary（读侧含派生/聚合字段，写侧只含可写字段）。AssetUpsertRequest 含可扩展 attributes（JSONB，对齐 R2：schema 按 JSONB 可扩展设计，避免 feat(contracts): 控制平面/租户开通 OpenAPI + governance 供数契约细化 (#3) #12 元模型引擎落地返工）。
2. id / 幂等：id 服务端生成（UUID）。POST /api/meta/assets = 登记（服务端发 id）；PUT /api/meta/assets/{id} = 编辑（按 id 幂等）。建议契约预留业务唯一键 (tenant_id, code) 做登记去重（同租户同 code 视为重复）。
3. 租户语义（D9/D2）：require_tenant=true，缺 X-Tenant-Id → 拒绝（fail-closed）；写落 tenant_id、读强制过滤。错误体沿用契约现有 error schema，勿另立。