@cloudhal/core-contracts 0.3.3 → 0.3.5

package/schemas/.bundled/term.schema.json

@@ -1,315 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cloudhal.dev/schemas/v1/term.schema.json",
-  "title": "Term",
-  "description": "One concept in a taxonomy (a category, a tag, a series). Content refers to terms by id, independent of locale; names, synonyms, archive intro and SEO are per locale. Renames, merges and retirements keep the id and leave redirects behind; `proposedBy` records the actor that proposed it (RFC-0002).",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "id",
-    "siteId",
-    "taxonomyId",
-    "slug",
-    "status",
-    "visibility",
-    "labels",
-    "rev",
-    "createdAt",
-    "updatedAt"
-  ],
-  "properties": {
-    "schemaVersion": {
-      "$ref": "#/$defs/SchemaVersion"
-    },
-    "id": {
-      "$ref": "#/$defs/Id"
-    },
-    "siteId": {
-      "$ref": "#/$defs/Id"
-    },
-    "taxonomyId": {
-      "$ref": "#/$defs/Id"
-    },
-    "slug": {
-      "$ref": "#/$defs/Slug",
-      "description": "URL segment of the term's archive; unique within its taxonomy, together with every slug in any term's slugHistory."
-    },
-    "status": {
-      "type": "string",
-      "description": "active: usable and public (subject to visibility). proposed: created by an agent, waiting for a person; assignable but never public. retired: no new assignments, no archive.",
-      "enum": [
-        "active",
-        "proposed",
-        "retired"
-      ]
-    },
-    "visibility": {
-      "type": "string",
-      "description": "internal terms have no archive, feed or sitemap entry and are not shown on entries; themes and filters may still use them.",
-      "enum": [
-        "public",
-        "internal"
-      ]
-    },
-    "labels": {
-      "type": "object",
-      "description": "Names per locale. Must contain the site's default locale.",
-      "propertyNames": {
-        "$ref": "#/$defs/Locale"
-      },
-      "minProperties": 1,
-      "additionalProperties": {
-        "$ref": "#/$defs/TermLabel"
-      }
-    },
-    "parentId": {
-      "$ref": "#/$defs/Id",
-      "description": "Parent term in the same taxonomy; only in hierarchical taxonomies. No cycles."
-    },
-    "position": {
-      "type": "integer",
-      "description": "Order among sibling terms (same taxonomy and parent), lowest first, for menus and sidebars. Terms without a position follow, by name.",
-      "minimum": 0,
-      "maximum": 100000
-    },
-    "image": {
-      "$ref": "#/$defs/ImageRef"
-    },
-    "links": {
-      "type": "array",
-      "description": "Profile links shown with the term and given to search engines as sameAs, such as an author's pages elsewhere (RFC-0019 §1).",
-      "maxItems": 10,
-      "items": {
-        "$ref": "#/$defs/Link"
-      }
-    },
-    "slugHistory": {
-      "type": "array",
-      "description": "Earlier slugs, oldest first. Old slugs stay reserved in the taxonomy and still resolve when an agent assigns by slug.",
-      "items": {
-        "$ref": "#/$defs/Slug"
-      },
-      "minItems": 1,
-      "maxItems": 50,
-      "uniqueItems": true
-    },
-    "mergedInto": {
-      "$ref": "#/$defs/Id",
-      "description": "Set when this term was merged into another active term of the same taxonomy; status is then 'retired'."
-    },
-    "proposedBy": {
-      "$ref": "#/$defs/Actor"
-    },
-    "rev": {
-      "$ref": "#/$defs/Revision"
-    },
-    "createdAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "updatedAt": {
-      "$ref": "#/$defs/Timestamp"
-    },
-    "metadata": {
-      "$ref": "#/$defs/Metadata"
-    }
-  },
-  "$defs": {
-    "Actor": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "kind",
-        "id"
-      ],
-      "properties": {
-        "kind": {
-          "$ref": "#/$defs/ActorKind"
-        },
-        "id": {
-          "$ref": "#/$defs/Id"
-        },
-        "name": {
-          "type": "string",
-          "maxLength": 200
-        }
-      }
-    },
-    "ActorKind": {
-      "type": "string",
-      "description": "Who performed an action. Humans and agents share one actor model so the policy engine treats them uniformly.",
-      "enum": [
-        "human",
-        "agent",
-        "system"
-      ]
-    },
-    "Id": {
-      "type": "string",
-      "description": "Prefixed, URL-safe identifier, e.g. site_01HZX8K3Q9. The prefix names the entity kind; agents and the MCP server pass these as opaque handles.",
-      "pattern": "^[a-z]+_[A-Za-z0-9]{6,32}$",
-      "minLength": 8,
-      "maxLength": 48
-    },
-    "ImageRef": {
-      "type": "object",
-      "description": "Reference to an image. With `assetId` the image is an Asset node (RFC-0004): the store writes its media URL into `src`, and its size into `width` and `height`, as a fallback for readers that do not resolve assets. Without it, `src` is a relative path or an absolute URL, as before.",
-      "additionalProperties": false,
-      "required": [
-        "src",
-        "alt"
-      ],
-      "properties": {
-        "assetId": {
-          "$ref": "#/$defs/Id",
-          "description": "The Asset node shown (RFC-0004). Renderers that know assets resolve it and ignore `src`."
-        },
-        "src": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "alt": {
-          "type": "string",
-          "maxLength": 500
-        },
-        "width": {
-          "type": "integer",
-          "minimum": 1
-        },
-        "height": {
-          "type": "integer",
-          "minimum": 1
-        }
-      }
-    },
-    "Link": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "label",
-        "href"
-      ],
-      "properties": {
-        "label": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 200
-        },
-        "href": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 2048
-        },
-        "external": {
-          "type": "boolean"
-        }
-      }
-    },
-    "Locale": {
-      "type": "string",
-      "description": "BCP 47 language tag, e.g. en, tr, en-US.",
-      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"
-    },
-    "Metadata": {
-      "type": "object",
-      "description": "Free-form string-to-string map for extensions. Keys should be namespaced (e.g. cloudhal.source).",
-      "additionalProperties": {
-        "type": "string"
-      }
-    },
-    "Revision": {
-      "type": "integer",
-      "description": "Monotonic per-node revision used for optimistic locking (compare-and-swap on write).",
-      "minimum": 0
-    },
-    "SchemaVersion": {
-      "type": "integer",
-      "description": "Version of this contract. Readers reject unknown versions; migrations move documents forward one version at a time.",
-      "enum": [
-        1
-      ]
-    },
-    "Seo": {
-      "type": "object",
-      "description": "Search and social metadata of a routable node (page, term archive).",
-      "additionalProperties": false,
-      "properties": {
-        "title": {
-          "type": "string",
-          "maxLength": 300
-        },
-        "description": {
-          "type": "string",
-          "maxLength": 500
-        },
-        "noindex": {
-          "type": "boolean"
-        },
-        "canonical": {
-          "type": "string",
-          "maxLength": 2048
-        },
-        "ogImage": {
-          "$ref": "#/$defs/ImageRef"
-        }
-      }
-    },
-    "Slug": {
-      "type": "string",
-      "description": "Lower-case URL segment.",
-      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 128
-    },
-    "TermLabel": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "name"
-      ],
-      "properties": {
-        "name": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 200
-        },
-        "slug": {
-          "$ref": "#/$defs/Slug",
-          "description": "This locale's archive slug (RFC-0033); absent uses the term's slug. Never set for the site's default locale, whose slug is the term's own; unique per taxonomy and locale."
-        },
-        "altNames": {
-          "type": "array",
-          "description": "Synonyms (SKOS altLabel). Matched when an agent or editor assigns by name; never shown as separate terms.",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 200
-          },
-          "minItems": 1,
-          "maxItems": 50,
-          "uniqueItems": true
-        },
-        "description": {
-          "type": "string",
-          "description": "Markdown introduction shown at the top of the archive.",
-          "maxLength": 20000
-        },
-        "role": {
-          "type": "string",
-          "description": "A short role or title shown with the term, such as an author's \"Senior reporter\" (RFC-0019 §1).",
-          "minLength": 1,
-          "maxLength": 120
-        },
-        "seo": {
-          "$ref": "#/$defs/Seo"
-        }
-      }
-    },
-    "Timestamp": {
-      "type": "string",
-      "description": "RFC 3339 / ISO 8601 instant in UTC.",
-      "format": "date-time"
-    }
-  }
-}