Coding-Autopilot-System · OgeonX-Ai · Jul 8, 2026 · Jul 6, 2026 · Jul 6, 2026 · chatgpt-codex-connector
@@ -4,6 +4,10 @@ All notable changes follow Semantic Versioning and Keep a Changelog conventions.
 
 ## [Unreleased]
 
+### Changed
+
+- **BREAKING:** Schema `$id` values now point at the live GitHub Pages registry (`https://coding-autopilot-system.github.io/cas-contracts/registry/...`) instead of the unresolvable `https://schemas.coding-autopilot.dev/` namespace introduced in v1.1.1. Consumers that hardcode the old `$id` string (e.g. offline schema validators) must update to the new value. See REQ-1.4.11.
+
 ### Added
 
 - Conservative automated JSON Schema compatibility classification in pull-request CI.

@@ -7,11 +7,9 @@ sub-path of the documentation site on a single GitHub Pages origin:
 https://coding-autopilot-system.github.io/cas-contracts/registry/
 ```
 
-Schema `$id` values use the reserved canonical namespace
-`https://schemas.coding-autopilot.dev/`. That namespace is the stable identity
-of each schema even though the current live distribution is served from GitHub
-Pages. Consumers should treat `$id` as identity and use the Pages registry URLs
-below as the fetch location until the canonical domain is activated.
+Schema `$id` values are now identical to the live fetch URL under the GitHub
+Pages registry — there is no separate canonical namespace. `$id` is both the
+identity and the resolvable fetch location for every schema.
 
 ## URL Contract
 
@@ -67,7 +65,9 @@ immutable manifest and the stable-line index before declaring the release done.
 
 ## Custom domain (optional future work)
 
-When `schemas.coding-autopilot.dev` is activated, it must serve the same
-versioned registry content without changing any schema `$id` values. The live
-GitHub Pages registry remains the current distribution URL and should stay
-stable for consumers that fetch schemas directly today.
+If `schemas.coding-autopilot.dev` is ever activated as a custom domain, that
+will require a new, explicit `$id` migration with its own consumer-compatibility
+plan — it is not a transparent, zero-cost activation. `$id` currently equals
+the live GitHub Pages fetch URL, so repointing `$id` to a future custom domain
+would be a breaking change for any consumer that has adopted the current
+`$id` value, and must be planned and announced accordingly.
@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/artifact-manifest.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/artifact-manifest.schema.json",
     "title":  "ArtifactManifest",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v0.1/common.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/common.schema.json",
   "title": "CAS Common Definitions",
   "$defs": {
     "actor": {

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/evaluation-result.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/evaluation-result.schema.json",
     "title":  "EvaluationResult",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/policy-decision.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/policy-decision.schema.json",
     "title":  "PolicyDecision",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/prompt-envelope.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/prompt-envelope.schema.json",
     "title":  "PromptEnvelope",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/run-event.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/run-event.schema.json",
     "title":  "RunEvent",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/verification-result.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/verification-result.schema.json",
     "title":  "VerificationResult",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v0.1/work-request.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/work-request.schema.json",
     "title":  "WorkRequest",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v1.0/artifact-manifest.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/artifact-manifest.schema.json",
     "title":  "ArtifactManifest",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.0/common.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/common.schema.json",
   "title": "CAS Common Definitions",
   "$defs": {
     "actor": {

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v1.0/evaluation-result.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/evaluation-result.schema.json",
     "title":  "EvaluationResult",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v1.0/policy-decision.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/policy-decision.schema.json",
     "title":  "PolicyDecision",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v1.0/prompt-envelope.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/prompt-envelope.schema.json",
     "title":  "PromptEnvelope",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v1.0/run-event.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/run-event.schema.json",
     "title":  "RunEvent",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
     "$schema":  "https://json-schema.org/draft/2020-12/schema",
-    "$id":  "https://schemas.coding-autopilot.dev/v1.0/verification-result.schema.json",
+    "$id":  "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/verification-result.schema.json",
     "title":  "VerificationResult",
     "type":  "object",
     "allOf":  [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.0/work-request.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.0/work-request.schema.json",
   "title": "WorkRequest",
   "type": "object",
   "allOf": [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.1/common.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.1/common.schema.json",
   "title": "CAS Common Definitions v1.1",
   "$defs": {
     "actor": {

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.1/phase-execution-request.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.1/phase-execution-request.schema.json",
   "title": "PhaseExecutionRequest",
   "type": "object",
   "allOf": [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.1/phase-execution-result.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.1/phase-execution-result.schema.json",
   "title": "PhaseExecutionResult",
   "type": "object",
   "allOf": [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.1/phase-verification-result.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.1/phase-verification-result.schema.json",
   "title": "PhaseVerificationResult",
   "type": "object",
   "allOf": [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.1/sdlc-lifecycle-event.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.1/sdlc-lifecycle-event.schema.json",
   "title": "SdlcLifecycleEvent",
   "type": "object",
   "allOf": [

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.coding-autopilot.dev/v1.1/sdlc-profile.schema.json",
+  "$id": "https://coding-autopilot-system.github.io/cas-contracts/registry/v1.1/sdlc-profile.schema.json",
   "title": "SdlcProfile",
   "type": "object",
   "allOf": [

@@ -43,7 +43,7 @@ export async function createValidator(directory = schemaRoot) {
 }
 
 export function schemaId(version, name) {
-  return `${canonicalSchemaBase}/${version}/${name}.schema.json`;
+  return `${pagesRegistryBase}/${version}/${name}.schema.json`;
 }
 
 export function schemaIdForExample(examplePath) {

@@ -41,14 +41,13 @@ test("distributed stable schemas compile and retain authoritative ids", async ()
   }
 });
 
-test("registry keeps canonical schema identity independent from the Pages hosting URL", async () => {
+test("registry schema identity resolves under the live Pages registry URL", async () => {
   const output = await build();
   const manifest = await readJson(path.join(output, "v0.1", "manifest.json"));
 
   for (const entry of manifest.schemas) {
-    assert.match(entry.id, /^https:\/\/schemas\.coding-autopilot\.dev\//);
-    assert.doesNotMatch(entry.id, /github\.io/);
-    assert.notEqual(entry.id, `https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/${entry.path}`);
+    assert.match(entry.id, /^https:\/\/coding-autopilot-system\.github\.io\/cas-contracts\/registry\//);
+    assert.equal(entry.id, `https://coding-autopilot-system.github.io/cas-contracts/registry/v0.1/${entry.path}`);
   }
 
   const promptEnvelope = manifest.schemas.find((entry) => entry.path === "prompt-envelope.schema.json");