{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.anguskit.com/schema/anguscopilot/1.0.0/info.json",
  "title": "Info Section",
  "description": "对齐 OpenAPI info 字段的元信息块，承载名称、版本、描述、作者、标签、注解。",
  "type": "object",
  "required": ["name", "version"],
  "properties": {
    "name": {
      "description": "资源名称，全局唯一（同一规范族下）。建议使用 kebab-case。",
      "$ref": "common.json#/$defs/Identifier"
    },
    "version": {
      "description": "资源语义化版本。框架按 SemVer 比较以决定兼容性与回滚目标。",
      "$ref": "common.json#/$defs/SemVer"
    },
    "description": {
      "description": "面向使用者的简短说明（≤ 500 字符）。",
      "type": "string",
      "maxLength": 500
    },
    "summary": {
      "description": "单行摘要（≤ 120 字符），用于 Capability 检索召回时的展示。",
      "type": "string",
      "maxLength": 120
    },
    "author": {
      "description": "维护方（个人邮箱、团队名或 URL）。",
      "type": "string",
      "maxLength": 200
    },
    "license": {
      "description": "License 标识（SPDX 表达式或自定义）。",
      "type": "string",
      "maxLength": 100,
      "examples": ["Apache-2.0", "MIT", "Proprietary"]
    },
    "homepage": {
      "description": "官方主页或文档 URL。",
      "type": "string",
      "format": "uri"
    },
    "labels": {
      "description": "结构化标签，用于过滤、路由、监控聚合。",
      "$ref": "common.json#/$defs/Labels"
    },
    "annotations": {
      "description": "非结构化注解，存放 changelog、依赖说明等长文本。",
      "$ref": "common.json#/$defs/Annotations"
    },
    "tags": {
      "description": "用于 Capability 语义检索召回时的过滤条件。",
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 63
      },
      "uniqueItems": true,
      "maxItems": 16
    }
  },
  "patternProperties": {
    "^x-": { "$ref": "common.json#/$defs/ExtensionMap/additionalProperties" }
  },
  "unevaluatedProperties": false
}
