Add release alias map to releases.json (#23626)

Author: Copilot

.github/aw/releases.json

@@ -2,5 +2,9 @@
   "$schema": "./releases.schema.json",
   "blockedVersions": [],
   "minimumVersion": "v0.64.4",
-  "minRecommendedVersion": "v0.64.4"
+  "minRecommendedVersion": "v0.64.4",
+  "aliases": {
+    "latest": "latest",
+    "stable": "v0.64.5"
+  }
 }

.github/aw/releases.schema.json

@@ -31,6 +31,16 @@
       "description": "The minimum recommended compile-agentic version in vMAJOR.MINOR.PATCH format. Workflows compiled with a version below this will emit a warning (but not fail) at activation, nudging users to upgrade. Use an empty string to disable this check.",
       "pattern": "^(v[0-9]+\\.[0-9]+\\.[0-9]+)?$",
       "default": ""
+    },
+    "aliases": {
+      "type": "object",
+      "description": "A map of release alias names to version strings. The special value 'latest' resolves to the most recent release. Other values must be a version string in vMAJOR.MINOR.PATCH format.",
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^(latest|v[0-9]+\\.[0-9]+\\.[0-9]+)$",
+        "description": "A version string in vMAJOR.MINOR.PATCH format or the special value 'latest'"
+      },
+      "default": {}
     }
   }
 }

.github/workflows/ci.yml

@@ -869,13 +869,30 @@ jobs:
             const errors = [];
 
             // Check additionalProperties (only allow known keys)
-            const allowedKeys = new Set(['$schema', 'blockedVersions', 'minimumVersion', 'minRecommendedVersion']);
+            const allowedKeys = new Set(['$schema', 'blockedVersions', 'minimumVersion', 'minRecommendedVersion', 'aliases']);
             for (const key of Object.keys(config)) {
               if (!allowedKeys.has(key)) {
                 errors.push(`Unknown property: '${key}'`);
               }
             }
 
+            // Validate aliases
+            if ('aliases' in config) {
+              const aliases = config.aliases;
+              if (typeof aliases !== 'object' || aliases === null || Array.isArray(aliases)) {
+                errors.push("'aliases' must be an object");
+              } else {
+                const aliasValuePattern = /^(latest|v[0-9]+\.[0-9]+\.[0-9]+)$/;
+                for (const [alias, value] of Object.entries(aliases)) {
+                  if (typeof value !== 'string') {
+                    errors.push(`'aliases.${alias}' must be a string`);
+                  } else if (!aliasValuePattern.test(value)) {
+                    errors.push(`'aliases.${alias}' ('${value}') must be 'latest' or a version in vMAJOR.MINOR.PATCH format (e.g. 'v1.2.3')`);
+                  }
+                }
+              }
+            }
+
             // Validate blockedVersions
             if ('blockedVersions' in config) {
               const bv = config.blockedVersions;