refactor: migrate schemas to $schemas directory and add schema references

- Move manifests/schemas/ to manifests/$schemas/ with singular naming
- Add $schema property to all manifest JSON files
- Update validation and generation scripts for new schema location
- Update TypeScript types and documentation references

BREAKING CHANGE: Schema files moved from manifests/schemas/ to manifests/$schemas/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ericyangpan

CONTRIBUTING.md

@@ -2,9 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "CLI Manifest Schema",
   "description": "Schema for CLI tool metadata",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "allOf": [{ "$ref": "./ref/app.schema.json" }]
-  }
+  "type": "object",
+  "allOf": [{ "$ref": "./ref/app.schema.json" }]
 }

docs/SCHEMA-ALIGNMENT.md

@@ -4,6 +4,7 @@
   "description": "Schema for curated collections of specifications, articles, and tools",
   "type": "object",
   "properties": {
+    "$schema": { "type": "string" },
     "specifications": {
       "$ref": "#/$defs/collectionSection"
     },

docs/SCHEMA-REFACTORING-SUMMARY.md

@@ -2,28 +2,25 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Extensions Manifest Schema",
   "description": "Schema for IDE extensions metadata",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "allOf": [
-      { "$ref": "./ref/product.schema.json" },
-      {
-        "type": "object",
-        "properties": {
-          "supportedIdes": {
-            "type": "array",
-            "description": "List of IDEs that support this extension",
-            "items": {
-              "$ref": "#/$defs/ideSupport"
-            },
-            "minItems": 1,
-            "uniqueItems": true
-          }
-        },
-        "required": ["supportedIdes"]
-      }
-    ]
-  },
+  "type": "object",
+  "allOf": [
+    { "$ref": "./ref/product.schema.json" },
+    {
+      "type": "object",
+      "properties": {
+        "supportedIdes": {
+          "type": "array",
+          "description": "List of IDEs that support this extension",
+          "items": {
+            "$ref": "#/$defs/ideSupport"
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": ["supportedIdes"]
+    }
+  ],
   "$defs": {
     "ideSupport": {
       "type": "object",

manifests/schemas/clis.schema.json manifests/$schemas/cli.schema.jsonmanifests/schemas/clis.schema.json renamed to manifests/$schemas/cli.schema.json

@@ -2,9 +2,6 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "IDE Manifest Schema",
   "description": "Schema for IDE metadata",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "allOf": [{ "$ref": "./ref/app.schema.json" }]
-  }
+  "type": "object",
+  "allOf": [{ "$ref": "./ref/app.schema.json" }]
 }

manifests/schemas/collections.schema.json …nifests/$schemas/collections.schema.jsonmanifests/schemas/collections.schema.json renamed to manifests/$schemas/collections.schema.json manifests/schemas/collections.schema.json renamed to manifests/$schemas/collections.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Models Manifest Schema",
+  "description": "Schema for large language model metadata",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "./ref/vendor-entity.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "size": {
+          "type": "string",
+          "description": "Model parameter size (e.g., '7B', '32B', '200B')"
+        },
+        "totalContext": {
+          "type": "string",
+          "description": "Total context window size (e.g., '32K', '64K', '200K')"
+        },
+        "maxOutput": {
+          "type": "string",
+          "description": "Maximum output token size (e.g., '4K', '8K')"
+        },
+        "tokenPricing": {
+          "type": "object",
+          "description": "Token-based pricing information for API usage (in $/M tokens)",
+          "properties": {
+            "input": {
+              "type": "number",
+              "description": "Input token pricing in $/M tokens (e.g., 0.14 for $0.14/1M tokens)"
+            },
+            "output": {
+              "type": "number",
+              "description": "Output token pricing in $/M tokens (e.g., 0.42 for $0.42/1M tokens)"
+            },
+            "cache": {
+              "type": ["number", "null"],
+              "description": "Cache token pricing in $/M tokens (e.g., 0.07 for $0.07/1M tokens, null if not applicable)"
+            }
+          },
+          "required": ["input", "output", "cache"],
+          "additionalProperties": false
+        },
+        "platformUrls": {
+          "$ref": "./ref/platform-urls.schema.json",
+          "description": "URLs to various third-party platform pages for this model"
+        }
+      },
+      "required": ["size", "totalContext", "maxOutput", "tokenPricing", "platformUrls"]
+    }
+  ]
+}

manifests/schemas/extensions.schema.json manifests/$schemas/extension.schema.jsonmanifests/schemas/extensions.schema.json renamed to manifests/$schemas/extension.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Provider Manifest Schema",
+  "description": "Schema for AI model providers and service aggregators",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "./ref/vendor-entity.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Provider category",
+          "enum": ["foundation-model-provider", "model-service-provider"]
+        },
+        "applyKeyUrl": {
+          "type": ["string", "null"],
+          "format": "uri",
+          "description": "API key application URL"
+        },
+        "platformUrls": {
+          "$ref": "./ref/platform-urls.schema.json",
+          "description": "URLs to various third-party platform pages for this provider"
+        },
+        "communityUrls": {
+          "$ref": "./ref/community-urls.schema.json",
+          "description": "Community presence URLs for the provider"
+        }
+      },
+      "required": ["type", "applyKeyUrl", "platformUrls", "communityUrls"]
+    }
+  ]
+}