mirror of
https://git.openapi.site/https://github.com/desirecore/registry.git
synced 2026-09-05 15:23:39 +08:00
Yige
223be1f04b
* feat: 建立 Registry 目录元数据验证基础 * feat: 迁移 Registry 应用目录元数据 * test: 解耦目录迁移进度断言 * feat: 迁移 Registry 服务目录元数据 * fix(catalog): 强制 Registry 目录元数据 * fix(catalog): 兼容 Registry v4 外部集成
263 lines
9.8 KiB
JSON
263 lines
9.8 KiB
JSON
{
|
||
"$schema": "http://json-schema.org/draft-07/schema#",
|
||
"$id": "https://github.com/desirecore/registry/schemas/catalog-metadata.v1.schema.json",
|
||
"title": "DesireCore Registry catalog metadata v1 sidecar",
|
||
"description": "CatalogItemV1 的 Registry 来源事实子集。受信 catalogSourceId、catalog provenance 和 official 身份由客户端同步器注入，禁止写入本文档。",
|
||
"type": "object",
|
||
"required": ["schemaVersion", "identity", "presentation", "release", "timestamps", "provenance", "governance", "compatibility", "spec"],
|
||
"properties": {
|
||
"$schema": { "const": "../../schemas/catalog-metadata.v1.schema.json" },
|
||
"schemaVersion": { "const": 1 },
|
||
"identity": {
|
||
"type": "object",
|
||
"required": ["kind", "id"],
|
||
"properties": {
|
||
"kind": { "enum": ["app", "service"], "description": "canonical 条目类型；Registry mcp/http-api 都归一为 service。" },
|
||
"id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$", "description": "来源内条目 ID；受信来源 ID 不属于 sidecar。" }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"presentation": {
|
||
"type": "object",
|
||
"required": ["defaultLocale", "i18n", "tags"],
|
||
"properties": {
|
||
"defaultLocale": { "type": "string", "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$" },
|
||
"i18n": {
|
||
"type": "object",
|
||
"minProperties": 1,
|
||
"propertyNames": { "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$" },
|
||
"additionalProperties": { "$ref": "#/$defs/localeText" }
|
||
},
|
||
"tags": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 120 }, "uniqueItems": true }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"release": { "$ref": "#/$defs/release" },
|
||
"timestamps": {
|
||
"type": "object",
|
||
"required": ["catalogUpdatedAt", "releasePublishedAt", "reviewedAt", "upstreamObservedAt"],
|
||
"properties": {
|
||
"catalogUpdatedAt": { "$ref": "#/$defs/timestamp" },
|
||
"releasePublishedAt": { "$ref": "#/$defs/timestamp" },
|
||
"reviewedAt": { "$ref": "#/$defs/timestamp" },
|
||
"upstreamObservedAt": { "$ref": "#/$defs/timestamp" }
|
||
},
|
||
"additionalProperties": false,
|
||
"description": "目录修改、内容发布、审核和上游观察时间彼此独立；syncedAt 不属于上游元数据。"
|
||
},
|
||
"provenance": {
|
||
"type": "object",
|
||
"properties": { "content": { "$ref": "#/$defs/contentSource" } },
|
||
"additionalProperties": false,
|
||
"description": "只声明内容来源。Catalog 仓库来源由同步器根据受信 repo 上下文注入。"
|
||
},
|
||
"governance": {
|
||
"type": "object",
|
||
"required": ["availability", "license", "redistribution"],
|
||
"properties": {
|
||
"availability": { "enum": ["listing-only", "installable"] },
|
||
"stewardship": { "enum": ["partner", "community", "pointer"], "description": "正文不得自报 official；受信官方身份只能由同步器注入。" },
|
||
"license": { "$ref": "#/$defs/license" },
|
||
"redistribution": { "enum": ["allowed", "source-pointer-only", "verify-package-terms"] },
|
||
"listingMaintainer": { "$ref": "#/$defs/maintainer" },
|
||
"upstreamMaintainer": { "$ref": "#/$defs/maintainer" },
|
||
"branding": { "$ref": "#/$defs/branding" },
|
||
"compliance": { "$ref": "#/$defs/compliance" }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"compatibility": {
|
||
"type": "object",
|
||
"required": ["platforms"],
|
||
"properties": {
|
||
"platforms": { "$ref": "#/$defs/platforms" },
|
||
"requiredClientVersion": {
|
||
"type": "string",
|
||
"pattern": "^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"spec": { "oneOf": [{ "$ref": "#/$defs/appSpec" }, { "$ref": "#/$defs/serviceSpec" }] }
|
||
},
|
||
"additionalProperties": false,
|
||
"$defs": {
|
||
"localeText": {
|
||
"type": "object",
|
||
"required": ["name", "summary"],
|
||
"properties": {
|
||
"name": { "type": "string", "minLength": 1 },
|
||
"summary": { "type": "string", "minLength": 1 },
|
||
"description": { "type": "string", "minLength": 1 }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"release": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": ["state"],
|
||
"properties": { "state": { "const": "unknown" } },
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": ["state", "version", "versionScheme"],
|
||
"properties": {
|
||
"state": { "const": "known" },
|
||
"version": { "type": "string", "minLength": 1, "maxLength": 160 },
|
||
"versionScheme": { "enum": ["semver", "calver", "opaque"] }
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": ["state"],
|
||
"properties": { "state": { "const": "unknown" } },
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": ["state", "value", "precision"],
|
||
"properties": {
|
||
"state": { "const": "known" },
|
||
"value": { "type": "string" },
|
||
"precision": { "enum": ["day", "second"] }
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
]
|
||
},
|
||
"contentSource": {
|
||
"type": "object",
|
||
"required": ["kind", "url"],
|
||
"properties": {
|
||
"kind": { "enum": ["git", "web", "zip", "release", "package", "container"] },
|
||
"url": { "type": "string", "format": "uri" },
|
||
"ref": { "type": "string", "minLength": 1, "maxLength": 500 },
|
||
"sha256": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" },
|
||
"path": { "type": "string", "minLength": 1 }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"license": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": ["state"],
|
||
"properties": { "state": { "const": "unknown" } },
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": ["state", "value"],
|
||
"properties": {
|
||
"state": { "const": "known" },
|
||
"value": { "type": "string", "minLength": 1, "maxLength": 240 },
|
||
"evidencePath": { "type": "string", "minLength": 1 }
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
]
|
||
},
|
||
"maintainer": {
|
||
"type": "object",
|
||
"required": ["name"],
|
||
"properties": {
|
||
"name": { "type": "string", "minLength": 1 },
|
||
"url": { "type": "string", "format": "uri" },
|
||
"verified": { "type": "boolean", "description": "身份是否已验证；不代表许可证授权或官方身份。" }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"branding": {
|
||
"type": "object",
|
||
"required": ["relationship", "nameUsage", "logoStatus"],
|
||
"properties": {
|
||
"relationship": { "enum": ["partner", "independent-listing"], "description": "sidecar 不接受 official 自报。" },
|
||
"nameUsage": { "enum": ["owned", "licensed", "nominative"] },
|
||
"logoStatus": { "enum": ["not-used", "license-covered", "trademark-policy-allowed", "permission-obtained"] }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"compliance": {
|
||
"type": "object",
|
||
"required": ["licenseEvidencePath", "reviewedRef", "reviewedAt", "reviewedBy", "upstreamEndorsed"],
|
||
"properties": {
|
||
"licenseEvidencePath": { "type": "string", "minLength": 1 },
|
||
"noticePath": { "type": "string", "minLength": 1 },
|
||
"reviewedRef": { "type": "string", "minLength": 1 },
|
||
"reviewedAt": { "type": "string" },
|
||
"reviewedBy": { "type": "string", "minLength": 1 },
|
||
"upstreamEndorsed": { "type": "boolean" }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"platforms": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": ["state", "values"],
|
||
"properties": {
|
||
"state": { "const": "known" },
|
||
"values": {
|
||
"type": "array",
|
||
"items": { "enum": ["macos", "windows", "linux", "web", "ios", "android"] },
|
||
"minItems": 1,
|
||
"uniqueItems": true
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": ["state"],
|
||
"properties": { "state": { "enum": ["all", "unknown"] } },
|
||
"additionalProperties": false
|
||
}
|
||
]
|
||
},
|
||
"placementPolicy": {
|
||
"type": "object",
|
||
"required": ["showInMyApps", "allowNavPin", "allowAgentBinding"],
|
||
"properties": {
|
||
"showInMyApps": { "type": "boolean" },
|
||
"allowNavPin": { "type": "boolean" },
|
||
"allowAgentBinding": { "type": "boolean" }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"appSpec": {
|
||
"type": "object",
|
||
"required": ["kind"],
|
||
"properties": {
|
||
"kind": { "const": "app" },
|
||
"category": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
|
||
"entrypointKinds": {
|
||
"type": "array",
|
||
"items": { "enum": ["builtin", "embedded-web", "external"] },
|
||
"uniqueItems": true
|
||
},
|
||
"placementPolicy": { "$ref": "#/$defs/placementPolicy" }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"serviceSpec": {
|
||
"type": "object",
|
||
"required": ["kind", "protocol"],
|
||
"properties": {
|
||
"kind": { "const": "service" },
|
||
"protocol": { "enum": ["mcp", "http"] },
|
||
"authType": { "enum": ["none", "bearer", "header", "query", "oauth", "unknown"] },
|
||
"capabilities": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "uniqueItems": true },
|
||
"toolCount": { "type": "integer", "minimum": 0 }
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
}
|
||
}
|