[governance → hashmatrix] governance-metadata 写入面契约何时落地（阻塞 #29 资产登记写端点）

[uniquehole]

背景

• 提问方：governance（HashMatrixData/hashmatrix-governance）
• 目标方：hashmatrix（主仓 · contracts owner）
• 触及：契约 governance-metadata（producer=governance）的写入面

M2「数据目录·资产登记」纵切链中，governance 已拆出写端点子任务 #29 · POST /api/meta/assets，但其受阻于契约：先改契约、再改实现。主仓 M2 总纲 §2「必须同步修订项」已列出此项，本讨论为推进确认。

疑问 / 讨论点

1. 现 contracts/openapi/governance-metadata-v1.yaml 仅有读取面（/api/meta/search、detail、lineage、perm、open），无任何写入操作；M2 需新增资产登记/编辑写入面（拟 POST /api/meta/assets）。主仓计划何时、由谁落地这条写入面契约？
2. 写入面的资源模型与既有 AssetSummary 的关系：登记体应是 AssetSummary 超集（含 attributes 可扩展属性，对齐 R2 JSONB）还是另立 AssetUpsertRequest？id 由客户端提供还是服务端生成、"编辑"靠什么键幂等？
3. 写入面是否同步约定租户头要求（D9：X-Tenant-Id 强制隔离、无租户头拒绝）与错误 schema，便于本仓 tolerant reader 对齐、webui SDK 由契约生成。

期望与引用

• 期望：主仓确认写入面落地时间/责任人，并就上述资源模型/幂等键/租户语义给一个可对齐的轮廓；落定后本仓 feat: M1 privacy 部署接线（chart 镜像/端口/探针 + gateway 路由 + 编排层契约） #29 即可对齐实现。
• 引用（胜于粘贴）：
  • contracts/openapi/governance-metadata-v1.yaml（现仅读取面）
  • contracts/icd/governance-metadata-icd.md、contracts/registry.yaml
  • 主仓 docs/milestones/M2-页面真实操作-可写纵切链.md §2「必须同步修订项」第 2 条
  • governance 子任务 feat: M1 privacy 部署接线（chart 镜像/端口/探针 + gateway 路由 + 编排层契约） #29（本仓 POST /api/meta/assets）

可能的落点

• 澄清即可（无需改动）
• 落成 Issue（结论清晰后用 /issue-report 提到主仓 contracts，追踪写入面落地）
• 其它

[uniquehole]

✅ 主仓答复：契约已立（#56），写入面轮廓如下

写入面契约 task 已在主仓开立并通知 governance 起草：➡️ #56（producer=governance，本仓 PR 到 contracts/；已挂 M2 milestone、#50 sub-issue；gateway#17 已 Blocked by #56）。背景见已闭环讨论 #52。

就你问的 3 点,主仓拍板（已折入 #56,供 #29 对齐）：

1. 资源模型：读写 DTO 分离——写侧独立 AssetUpsertRequest（只含可写字段 + 可扩展 attributes JSONB,对齐 R2），不复用读侧 AssetSummary。
2. id / 幂等：id 服务端生成（UUID）；POST 登记发 id、PUT /{id} 编辑按 id 幂等；契约预留 (tenant_id, code) 业务唯一键做登记去重。
3. 租户语义：require_tenant=true,缺 X-Tenant-Id → 拒绝（D9/D2 fail-closed）;写落 tenant_id、读强制过滤;错误体沿用契约现有 error schema。

后续在 #56 跟踪（契约 PR → 合入 → 关闭 → #29 解阻塞）,本讨论无需继续。