{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://www.dsh.so/data/stars.schema.json",
  "title": "dsh.so GitHub star leaderboard (three artifact classes)",
  "description": "GitHub star leaderboard of the dsh.so registry, served at /data/stars.json — one board per artifact class (plugin = dsh plugins, ecoPlugin = ecosystem plugins that install but mount no plugin capability, ecoApp = ecosystem apps / desktop and web shells), each ranked by registry-captured star count descending, top 100 per class. Listable artifacts only: repo-health-marked or sub-L3 entries are absent from every board. The upstream harness itself (deepseek-ai/deepseek-harness) is excluded from every board. The ecoPlugin board only admits install-verified entries: L4 sandbox install passed AND the L5 web-loader inventory confirms nothing mounts — L4-unknown topic pickups are absent, never padded in. The momentum view (weekly star gainers) is the sibling feed /data/star-trend.json.",
  "type": "object",
  "required": [
    "generatedAt",
    "limit",
    "boards",
    "license"
  ],
  "additionalProperties": true,
  "properties": {
    "schema": {
      "type": "string",
      "description": "Absolute URL of this JSON Schema."
    },
    "generatedAt": {
      "type": "string",
      "description": "Build timestamp — preserve it alongside any cached copy."
    },
    "source": {
      "type": "string",
      "description": "Provenance note (GitHub star counts captured by the dsh.so registry pipelines at build time)."
    },
    "scope": {
      "type": "object",
      "additionalProperties": true,
      "properties": {
        "listableOnly": {
          "const": true
        },
        "upstreamCoreExcluded": {
          "const": true,
          "description": "The upstream harness itself (deepseek-ai/deepseek-harness) is excluded from every board."
        },
        "ecoPluginInstallVerifiedOnly": {
          "const": true,
          "description": "The ecoPlugin board only admits install-verified entries: L4 sandbox install passed AND L5 web-loader inventory confirms nothing mounts; L4-unknown topic pickups are absent."
        },
        "classes": {
          "type": "array",
          "items": {
            "enum": [
              "plugin",
              "ecoPlugin",
              "ecoApp"
            ]
          },
          "description": "The three artifact classes covered by boards."
        }
      }
    },
    "limit": {
      "const": 100,
      "description": "Each board provides its top 100 entries only."
    },
    "boards": {
      "type": "object",
      "required": [
        "plugin",
        "ecoPlugin",
        "ecoApp"
      ],
      "additionalProperties": true,
      "properties": {
        "plugin": {
          "$ref": "#/definitions/board",
          "description": "dsh plugins — declare a dsh.bundle and install via `dsh plugin add`."
        },
        "ecoPlugin": {
          "$ref": "#/definitions/board",
          "description": "Ecosystem plugins — install-verified (L4 sandbox install passed, L5 web-loader inventory confirms nothing mounts); install-unverified topic pickups are absent."
        },
        "ecoApp": {
          "$ref": "#/definitions/board",
          "description": "Ecosystem apps — desktop / web shells distributed as release packages, plus indexed entries whose installability was never verified (L4 sandbox run produced no verdict; merged per the 2026-09-21 taxonomy)."
        }
      }
    },
    "license": {
      "type": "object",
      "required": [
        "data",
        "reuse",
        "attribution",
        "spdx",
        "terms"
      ],
      "additionalProperties": true,
      "properties": {
        "data": {
          "type": "string"
        },
        "reuse": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "spdx": {
          "const": "CC-BY-4.0"
        },
        "terms": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "definitions": {
    "board": {
      "type": "object",
      "required": [
        "count",
        "items"
      ],
      "additionalProperties": true,
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of entries on this board (= items.length); capped by limit."
        },
        "items": {
          "type": "array",
          "maxItems": 100,
          "items": {
            "type": "object",
            "required": [
              "rank",
              "id",
              "name",
              "stars",
              "url"
            ],
            "additionalProperties": true,
            "properties": {
              "rank": {
                "type": "integer",
                "minimum": 1,
                "description": "1-based position within this board, sorted by stars descending (1-100)."
              },
              "id": {
                "type": "string",
                "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
                "description": "Plugin id (matches plugins.json ids and artifact slugs)."
              },
              "name": {
                "type": "string",
                "description": "Display name."
              },
              "stars": {
                "type": "integer",
                "minimum": 0,
                "description": "GitHub star count captured at registry refresh."
              },
              "url": {
                "type": "string",
                "description": "Absolute artifact detail page URL on dsh.so."
              }
            }
          }
        }
      }
    }
  }
}