{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/alchemylab-sh/json-schema/alchemylab-sh-content-item-schema.json",
  "title": "ContentItem",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/alchemylab-sh-api-openapi.json#/components/schemas/ContentItem",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "source": {
      "type": "string",
      "enum": [
        "hackernews",
        "reddit",
        "twitter",
        "bluesky",
        "rss",
        "arxiv",
        "huggingface",
        "lobsters",
        "modelscope"
      ]
    },
    "url": {
      "type": [
        "string",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "body": {
      "type": [
        "string",
        "null"
      ]
    },
    "author": {
      "type": [
        "string",
        "null"
      ]
    },
    "publishedAt": {
      "type": "string",
      "format": "date-time"
    },
    "relevanceScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "0–1 AI-relevance score."
    },
    "trendingScore": {
      "type": [
        "number",
        "null"
      ]
    },
    "topics": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "models",
          "tools",
          "use-cases",
          "regulation",
          "research",
          "funding",
          "opinion",
          "tutorial"
        ]
      }
    },
    "clusterSize": {
      "type": "integer",
      "description": "How many near-duplicate stories this representative stands for."
    },
    "corroboration": {
      "type": "object",
      "description": "How independently this story is corroborated across its cluster — a provenance signal, never a truth verdict.",
      "properties": {
        "level": {
          "type": "string",
          "enum": [
            "primary",
            "corroborated",
            "reported",
            "unverified"
          ]
        },
        "publishers": {
          "type": "integer",
          "description": "Distinct independent publisher hosts in the cluster."
        },
        "tiers": {
          "type": "object",
          "description": "Distinct publishers per credibility tier.",
          "properties": {
            "primary": {
              "type": "integer"
            },
            "expert": {
              "type": "integer"
            },
            "media": {
              "type": "integer"
            },
            "community": {
              "type": "integer"
            }
          }
        },
        "label": {
          "type": "string",
          "description": "Short, glanceable summary."
        }
      }
    }
  },
  "required": [
    "id",
    "source",
    "title",
    "publishedAt"
  ]
}