Manifest Reference

# 字段总表

未知顶层字段会以 manifest.unknown_field 拒绝；缺少必需字段会以 manifest.required_field_missing 拒绝。

# 完整骨架

{
  "manifest_version": "1.0",
  "id": "vendor.package",
  "version": "1.0.0",
  "package_type": "business-module",
  "entrypoint": "Vendor\\Package\\PackageRegistrar",
  "capabilities": [],
  "requires": [],
  "optional_requires": [],
  "lifecycle": [],
  "events": [],
  "migrations": [],
  "data_ownership": [],
  "uninstall_policy": "PRESERVE",
  "templates": [],
  "assets": [],
  "config_schema": {}
}

# 包类型

# Capability Reference

判定语义：ALLOW 可进入 grant plan；CONDITIONAL 需要显式审批；DENY 永远不能授予。manifest 声明是必要条件，不等于已经获得授权。

# Dependencies

{"kind":"package","name":"source.package","range":">=1.0.0 <2.0.0"}
{"kind":"contract","name":"source.contract","range":"1.0.0","fallback":"FEATURE-DISABLED"}

kind 仅为 package、provider、contract。range 使用以空格分隔的精确比较条件，支持 = > >= < <=；不支持 caret 或 wildcard。每个 package id 同时只能有一个 active version；必需依赖缺失/版本不符会阻止激活；可选依赖缺失或不兼容时使用冻结 fallback；cycle 会被拒绝。

# Events

事件 id 必须是版本化的点分标识，例如 example.greeting.render.v1。主机拥有 payload validator、NOTIFY/COLLECT mode、contribution validator 和 failure policy。包只能注册 manifest 已声明的事件。NOTIFY handler 必须返回 null；COLLECT 的结果必须通过主机 validator。执行顺序按 dependency rank、priority、package id、handler id 确定。

# Closed-world 与失败

不要添加“看起来合理”的字段。未知顶层字段、未知 dependency 字段、重复 capability、重复 data namespace、错误版本或错误 package type 都会 fail closed。使用 稳定诊断定位。