fix: Add $schema property to settings.schema.json (#12763)

Co-authored-by: cornmander <shikhman@google.com>

schemas/settings.schema.json

@@ -6,6 +6,12 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
+    "$schema": {
+      "title": "Schema",
+      "description": "The URL of the JSON schema for this settings file. Used by editors for validation and autocompletion.",
+      "type": "string",
+      "default": "https://raw.githubusercontent.com/google-gemini/gemini-cli/main/schemas/settings.schema.json"
+    },
     "mcpServers": {
       "title": "MCP Servers",
       "description": "Configuration for MCP servers.",

scripts/generate-settings-schema.ts

@@ -120,6 +120,14 @@ function buildSchemaObject(schema: SettingsSchemaType): JsonSchema {
     properties: {},
   };
 
+  root.properties!['$schema'] = {
+    title: 'Schema',
+    description:
+      'The URL of the JSON schema for this settings file. Used by editors for validation and autocompletion.',
+    type: 'string',
+    default: SCHEMA_ID,
+  };
+
   for (const [key, definition] of Object.entries(schema)) {
     root.properties![key] = buildSettingSchema(definition, [key], defs);
   }