feat(schema): v2.0.0 extension schema — citations, provenance, schema_version

examples/v2.0.0/server_v2.0.0_example.json

@@ -0,0 +1,118 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "hatch_schema_version": "2.0.0",
+    "name": "io.github.example/weather-server",
+    "version": "1.0.14",
+    "description": "Example Hatch MCP server metadata showing citations, provenance, and all dependency types.",
+    "authors": [
+      {
+        "name": "Example Author",
+        "email": "author@example.org"
+      }
+    ],
+    "dependencies": {
+      "python": [
+        {
+          "name": "numpy",
+          "version_constraint": "==1.26.0",
+          "package_manager": "conda",
+          "channel": "conda-forge"
+        }
+      ],
+      "system": [
+        {
+          "name": "libgomp1",
+          "version_constraint": "==12.3.0",
+          "package_manager": "apt"
+        }
+      ],
+      "docker": [
+        {
+          "name": "ghcr.io/example/image",
+          "tag": "1.0.0",
+          "digest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+        }
+      ],
+      "hatch": [
+        {
+          "name": "io.github.example/peer-pkg",
+          "version_constraint": "==0.1.0"
+        }
+      ]
+    },
+    "entry_point": {
+      "mcp_server": "server.py",
+      "hatch_mcp_server": "hatch_wrapper.py"
+    },
+    "tags": [
+      "meteorology",
+      "weather",
+      "prediction"
+    ],
+    "license": {
+      "name": "MIT",
+      "uri": "https://opensource.org/licenses/MIT"
+    },
+    "tools": [
+      {
+        "name": "get_weather",
+        "desc": "Return current weather for a requested location, fetched from Eumetnet."
+      },
+      {
+        "name": "get_forecast",
+        "desc": "Return a short-term forecast for a requested location."
+      }
+    ],
+    "documentation": "https://example.org/docs",
+    "provenance": {
+      "git_sha": "a1b2c3d",
+      "build_env": "conda-lock"
+    },
+    "citations": [
+      {
+        "format": "doi",
+        "value": "10.1234/example",
+        "note": "primary paper"
+      },
+      {
+        "format": "arxiv",
+        "value": "2301.12345",
+        "note": "preprint"
+      },
+      {
+        "format": "pmid",
+        "value": "12345678",
+        "note": "method reference"
+      },
+      {
+        "format": "isbn",
+        "value": "9781234567897",
+        "note": "book reference"
+      },
+      {
+        "format": "url",
+        "value": "https://example.org/docs",
+        "note": "documentation"
+      },
+      {
+        "format": "bibtex",
+        "value": "@article{example2024,title={Example Paper},author={Author, Example},journal={Journal of Examples},year={2024}}",
+        "note": "dataset"
+      },
+      {
+        "format": "ris",
+        "value": "TY  - JOUR\nTI  - Example Paper\nAU  - Example, Author\nPY  - 2024\nER  -",
+        "note": "reference manager export"
+      },
+      {
+        "format": "csl-json",
+        "value": "{\"type\":\"article-journal\",\"title\":\"Example Paper\",\"author\":[{\"family\":\"Example\",\"given\":\"Author\"}],\"issued\":{\"date-parts\":[[2024]]}}",
+        "note": "machine-readable citation"
+      },
+      {
+        "format": "formatted",
+        "value": "Author et al. (2024). Example Paper. Journal of Examples.",
+        "note": "software used"
+      }
+    ]
+  }

examples/v2.0.0/server_v2.0.0_invalid_example.json

@@ -0,0 +1,81 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "hatch_schema_version": "2.0.0",
+    "name": "io.github.example/invalid-server",
+    "version": "1.0.14",
+    "description": "Invalid example of a Hatch MCP server metadata.",
+    "authors": [
+      {
+        "name": "Example Author",
+        "email": "author@example.org"
+      }
+    ],
+    "dependencies": {
+      "python": [
+        {
+          "name": "numpy",
+          "version_constraint": "==1.26.0",
+          "package_manager": "conda",
+          "channel": "conda-forge"
+        }
+      ],
+      "system": [
+        {
+          "name": "libgomp1",
+          "version_constraint": "==12.3.0",
+          "package_manager": "apt"
+        }
+      ],
+      "docker": [
+        {
+          "name": "ghcr.io/example/image",
+          "tag": "1.0.0",
+          "digest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
+        }
+      ],
+      "hatch": [
+        {
+          "name": "io.github.example/peer-pkg",
+          "version_constraint": "==0.1.0"
+        }
+      ]
+    },
+    "entry_point": {
+      "mcp_server": "server.py",
+      "hatch_mcp_server": "hatch_wrapper.py"
+    },
+    "tags": [
+      "meteorology",
+      "weather",
+      "prediction"
+    ],
+    "license": {
+      "name": "MIT",
+      "uri": "https://opensource.org/licenses/MIT"
+    },
+    "tools": [
+      {
+        "name": "get_weather",
+        "desc": "Return current weather for a requested location, fetched from Eumetnet."
+      },
+      {
+        "name": "get_forecast",
+        "desc": "Return a short-term forecast for a requested location."
+      }
+    ],
+    "documentation": "https://example.org/docs",
+    "provenance": {
+    },
+    "citations": [
+      {
+        "format": "doi",
+        "value": "10.1234/example",
+        "note": "primary paper"
+      },
+      {
+        "format": "sandwich",
+        "value": "2301.12345",
+        "note": "preprint"
+      }
+    ]
+  }