Dev

.ground-control.yaml

@@ -6,12 +6,16 @@ workflow:
   completion_command: uv tool run --from 'nox[uv]==2026.4.10' nox -f noxfile.py -s verify
   lint_command: uv tool run --from 'nox[uv]==2026.4.10' nox -f noxfile.py -s lint
   format_command: uv tool run --from 'nox[uv]==2026.4.10' nox -f noxfile.py -s hygiene
+  codex_review:
+    pre_push_cap: 1
+  test_quality_review:
+    pre_push_cap: 1
   review_disposition:
-    enabled: true
-    mode: authoritative
-    max_auto_overrides: 1
+    enabled: false
+    mode: shadow
+    max_auto_overrides: 0
     judge:
-      enabled: true
+      enabled: false
 docs:
   adr_dir: docs/decisions/adrs/
 example_paths:
@@ -25,7 +29,6 @@ requirements:
 routing:
   enabled: true
   default_provider: claude
-  default_fallback: parent
   stages: {}
 sonarcloud:
   project_key: Brad-Edwards_aces

contracts/fixtures/experiment-core/experiment-binding-descriptors-v1/invalid/duplicate-canonical-target.json

@@ -0,0 +1,51 @@
+{
+  "schema_version": "experiment-binding-descriptors/v1",
+  "descriptors": [
+    {
+      "binding_id": "binding.worker-count.first",
+      "source_factor_id": "factor.worker-count",
+      "source_factor_level_id": "four",
+      "source_condition_id": "condition.four-workers",
+      "target": {
+        "plane": "scenario",
+        "scenario_family_id": "family.techvault",
+        "variation_point_id": "variation.worker-count",
+        "target_id": "variables.worker_count"
+      },
+      "value_type": "integer",
+      "value": {
+        "kind": "literal",
+        "value": 4
+      },
+      "owner": {
+        "contract_id": "sdl-authoring-input-v1",
+        "contract_version": "1",
+        "validator_id": "raes-sdl-instantiation",
+        "validator_version": "1"
+      }
+    },
+    {
+      "binding_id": "binding.worker-count.second",
+      "source_factor_id": "factor.worker-count",
+      "source_factor_level_id": "four",
+      "source_condition_id": "condition.four-workers",
+      "target": {
+        "plane": "scenario",
+        "scenario_family_id": "family.techvault",
+        "variation_point_id": "variation.worker-count",
+        "target_id": "variables.worker_count"
+      },
+      "value_type": "integer",
+      "value": {
+        "kind": "literal",
+        "value": 4
+      },
+      "owner": {
+        "contract_id": "sdl-authoring-input-v1",
+        "contract_version": "1",
+        "validator_id": "raes-sdl-instantiation",
+        "validator_version": "1"
+      }
+    }
+  ]
+}

contracts/fixtures/experiment-core/experiment-binding-descriptors-v1/valid/reference.json

@@ -0,0 +1,28 @@
+{
+  "schema_version": "experiment-binding-descriptors/v1",
+  "descriptors": [
+    {
+      "binding_id": "binding.worker-count",
+      "source_factor_id": "factor.worker-count",
+      "source_factor_level_id": "four",
+      "source_condition_id": "condition.four-workers",
+      "target": {
+        "plane": "scenario",
+        "scenario_family_id": "family.techvault",
+        "variation_point_id": "variation.worker-count",
+        "target_id": "variables.worker_count"
+      },
+      "value_type": "integer",
+      "value": {
+        "kind": "literal",
+        "value": 4
+      },
+      "owner": {
+        "contract_id": "sdl-authoring-input-v1",
+        "contract_version": "1",
+        "validator_id": "raes-sdl-instantiation",
+        "validator_version": "1"
+      }
+    }
+  ]
+}

contracts/fixtures/participant-implementation-configuration/participant-configuration-result-v1/invalid/digest-mismatch.json

@@ -0,0 +1,31 @@
+{
+  "schema_version": "participant-configuration-result/v1",
+  "participant_address": "participants.red",
+  "manifest_ref": "manifests/reference-red-agent.json",
+  "manifest_digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+  "configuration": {
+    "implementation_identity": {
+      "name": "reference-red-agent",
+      "version": "1.0.0"
+    },
+    "manifest_version": "participant-implementation-manifest/v1",
+    "owner": {
+      "contract_id": "participant-configuration-result-v1",
+      "contract_version": "1",
+      "validator_id": "reference-participant-configuration",
+      "validator_version": "1"
+    },
+    "values": [
+      {
+        "target_id": "policy.mode",
+        "value_type": "string",
+        "origin": "override",
+        "value": {
+          "kind": "literal",
+          "value": "deterministic"
+        }
+      }
+    ]
+  },
+  "configuration_digest": "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+}

contracts/fixtures/participant-implementation-configuration/participant-configuration-result-v1/valid/reference.json

@@ -0,0 +1,49 @@
+{
+  "schema_version": "participant-configuration-result/v1",
+  "participant_address": "participants.red",
+  "manifest_ref": "manifests/reference-red-agent.json",
+  "manifest_digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+  "configuration": {
+    "implementation_identity": {
+      "name": "reference-red-agent",
+      "version": "1.0.0"
+    },
+    "manifest_version": "participant-implementation-manifest/v1",
+    "owner": {
+      "contract_id": "participant-configuration-result-v1",
+      "contract_version": "1",
+      "validator_id": "reference-participant-configuration",
+      "validator_version": "1"
+    },
+    "values": [
+      {
+        "target_id": "credentials.api",
+        "value_type": "string",
+        "origin": "override",
+        "value": {
+          "kind": "secret-reference",
+          "reference_id": "operator-secret.reference-red-api"
+        }
+      },
+      {
+        "target_id": "policy.mode",
+        "value_type": "string",
+        "origin": "override",
+        "value": {
+          "kind": "literal",
+          "value": "deterministic"
+        }
+      },
+      {
+        "target_id": "policy.temperature",
+        "value_type": "number",
+        "origin": "default",
+        "value": {
+          "kind": "literal",
+          "value": 0.25
+        }
+      }
+    ]
+  },
+  "configuration_digest": "sha256:3949cb272258d96d9506f23077c89cbb77d4dad2d0218fed74145bbd5a971655"
+}

contracts/fixtures/participant-implementation-manifest/participant-implementation-manifest-v1/valid/reference.json

@@ -8,6 +8,8 @@
   "supported_contract_versions": [
     "participant-implementation-manifest-v1",
     "participant-implementation-provenance-v1",
+    "experiment-binding-descriptors-v1",
+    "participant-configuration-result-v1",
     "participant-episode-state-envelope-v1",
     "participant-episode-history-event-stream-v1",
     "participant-behavior-history-event-stream-v1"
@@ -66,5 +68,50 @@
       "task-statement",
       "observation-stream"
     ]
+  },
+  "configuration_registry": {
+    "owner": {
+      "contract_id": "participant-configuration-result-v1",
+      "contract_version": "1",
+      "validator_id": "reference-participant-configuration",
+      "validator_version": "1"
+    },
+    "targets": {
+      "policy.temperature": {
+        "target_id": "policy.temperature",
+        "value_type": "number",
+        "aliases": [
+          "temperature"
+        ],
+        "allowed_value_kinds": [
+          "literal"
+        ],
+        "sensitivity": "public",
+        "default": {
+          "kind": "literal",
+          "value": 0.25
+        }
+      },
+      "policy.mode": {
+        "target_id": "policy.mode",
+        "value_type": "string",
+        "aliases": [
+          "mode"
+        ],
+        "allowed_value_kinds": [
+          "literal"
+        ],
+        "sensitivity": "internal"
+      },
+      "credentials.api": {
+        "target_id": "credentials.api",
+        "value_type": "string",
+        "aliases": [],
+        "allowed_value_kinds": [
+          "secret-reference"
+        ],
+        "sensitivity": "secret"
+      }
+    }
   }
 }

contracts/schema-publication/entries/backend-manifest-v2.json

@@ -2,9 +2,9 @@
   "contract_id": "backend-manifest-v2",
   "schema_path": "contracts/schemas/backend-manifest/backend-manifest-v2.json",
   "stability": "draft",
-  "content_hash": "178db9d22d522e069bcad2bc91cfb985e58a22e01ee5dc2b8de506373c1952f0",
+  "content_hash": "8645c2b5e00cd595d2661959fe2dfa0ac91e5cca26d4455fe87dad8e6a97db48",
   "last_change": {
-    "summary": "Published service materialization, portable shared-time, and autonomous participant capability controls.",
-    "content_hash": "178db9d22d522e069bcad2bc91cfb985e58a22e01ee5dc2b8de506373c1952f0"
+    "summary": "Added a typed, owner-governed apparatus configuration target registry and experiment binding contract support.",
+    "content_hash": "8645c2b5e00cd595d2661959fe2dfa0ac91e5cca26d4455fe87dad8e6a97db48"
   }
 }

contracts/schema-publication/entries/backend-profile-v1.json

@@ -2,9 +2,9 @@
   "contract_id": "backend-profile-v1",
   "schema_path": "contracts/schemas/profiles/backend-profile-v1.json",
   "stability": "draft",
-  "content_hash": "05f507351c826558d03cec48b0e99501022acbbd5b6e1d816f86727e9f4ad78d",
+  "content_hash": "fd118e131b273684ac540675a8ba8d4b6ef1f10990ddd0d0dc5776c1b6c4a233",
   "last_change": {
-    "summary": "Added API-421 shared-time contract ids to the governed backend contract vocabulary.",
-    "content_hash": "05f507351c826558d03cec48b0e99501022acbbd5b6e1d816f86727e9f4ad78d"
+    "summary": "Added the authoritative experiment binding descriptor contract to the governed backend contract vocabulary.",
+    "content_hash": "fd118e131b273684ac540675a8ba8d4b6ef1f10990ddd0d0dc5776c1b6c4a233"
   }
 }

contracts/schema-publication/entries/experiment-authoring-input-v1.json

@@ -2,9 +2,9 @@
   "contract_id": "experiment-authoring-input-v1",
   "schema_path": "contracts/schemas/experiment-core/experiment-authoring-input-v1.json",
   "stability": "draft",
-  "content_hash": "829ac69c37136596506bf83e0f2fde6cd8c333a79d497c84b93b0497e37aabc9",
+  "content_hash": "47a2a28bd72c252aff22a651e58b216cd4700e9d7c4cabc87728bce0657183a6",
   "last_change": {
-    "summary": "Retargeted qualified Python validator references and current project descriptions from the retired ACES package identity to RAES as part of the #884 hard cut; schema identifiers and validation semantics are unchanged.",
-    "content_hash": "829ac69c37136596506bf83e0f2fde6cd8c333a79d497c84b93b0497e37aabc9"
+    "summary": "Added explicit binding semantics and authoritative cross-plane binding descriptors joined to factor levels and conditions.",
+    "content_hash": "47a2a28bd72c252aff22a651e58b216cd4700e9d7c4cabc87728bce0657183a6"
   }
 }

contracts/schema-publication/entries/experiment-binding-descriptors-v1.json

@@ -0,0 +1,10 @@
+{
+  "contract_id": "experiment-binding-descriptors-v1",
+  "schema_path": "contracts/schemas/experiment-core/experiment-binding-descriptors-v1.json",
+  "stability": "draft",
+  "content_hash": "88d57279e1d4467de97fa32893dfad58f3dccb5bf6a9d6e9610ce84e78265f2c",
+  "last_change": {
+    "summary": "Published explicit, typed, plane-specific experiment binding descriptors with factor and condition provenance.",
+    "content_hash": "88d57279e1d4467de97fa32893dfad58f3dccb5bf6a9d6e9610ce84e78265f2c"
+  }
+}

contracts/schema-publication/entries/experiment-run-v1.json

@@ -2,9 +2,9 @@
   "contract_id": "experiment-run-v1",
   "schema_path": "contracts/schemas/experiment-core/experiment-run-v1.json",
   "stability": "draft",
-  "content_hash": "5c936907be31c0b1d0f7071ecd1785a39804afb52f6277671c11c95d325baf16",
+  "content_hash": "718d8b108bfc7cc7cee4d55970c12e7fd87c3873f13aaee51b2b4de468ba5db7",
   "last_change": {
-    "summary": "Retargeted qualified Python validator references and current project descriptions from the retired ACES package identity to RAES as part of the #884 hard cut; schema identifiers and validation semantics are unchanged.",
-    "content_hash": "5c936907be31c0b1d0f7071ecd1785a39804afb52f6277671c11c95d325baf16"
+    "summary": "Added realized cross-plane binding provenance with explicit source, target, value origin, and configuration digest.",
+    "content_hash": "718d8b108bfc7cc7cee4d55970c12e7fd87c3873f13aaee51b2b4de468ba5db7"
   }
 }

contracts/schema-publication/entries/participant-configuration-result-v1.json

@@ -0,0 +1,10 @@
+{
+  "contract_id": "participant-configuration-result-v1",
+  "schema_path": "contracts/schemas/participant-implementation-configuration/participant-configuration-result-v1.json",
+  "stability": "draft",
+  "content_hash": "915c2557c352fc5866fa0e5171abb02afb0b9eea485749aefa94ba0bc0dc3c51",
+  "last_change": {
+    "summary": "Published atomic normalized participant configuration results with value provenance and a canonical digest.",
+    "content_hash": "915c2557c352fc5866fa0e5171abb02afb0b9eea485749aefa94ba0bc0dc3c51"
+  }
+}

contracts/schema-publication/entries/participant-implementation-manifest-v1.json

@@ -2,5 +2,9 @@
   "contract_id": "participant-implementation-manifest-v1",
   "schema_path": "contracts/schemas/participant-implementation-manifest/participant-implementation-manifest-v1.json",
   "stability": "draft",
-  "content_hash": "93e30291adbc08b1969adb9b938f888b004d317ac864e90151d0f43a395948e4"
+  "content_hash": "5b7c636a98c540e1afc74ca74a1e9a421609f498c3b85c473a52c1516e398984",
+  "last_change": {
+    "summary": "Added typed participant configuration targets, aliases, defaults, sensitivity, and governed validator ownership.",
+    "content_hash": "5b7c636a98c540e1afc74ca74a1e9a421609f498c3b85c473a52c1516e398984"
+  }
 }

contracts/schema-publication/entries/participant-implementation-provenance-v1.json

@@ -2,5 +2,9 @@
   "contract_id": "participant-implementation-provenance-v1",
   "schema_path": "contracts/schemas/participant-implementation-provenance/participant-implementation-provenance-v1.json",
   "stability": "draft",
-  "content_hash": "a4c050fb2a53129148f7d2960a7cb06d36c4682483064734e505acda4677d7ec"
+  "content_hash": "88076dc67b837b282a0efe482d4b74d5fb053ad7b44cb6bc0d862b4fe17eb30e",
+  "last_change": {
+    "summary": "Required participant configuration references and authoritative normalized configuration digests to be supplied together.",
+    "content_hash": "88076dc67b837b282a0efe482d4b74d5fb053ad7b44cb6bc0d862b4fe17eb30e"
+  }
 }

contracts/schema-publication/entries/processor-manifest-v2.json

@@ -2,9 +2,9 @@
   "contract_id": "processor-manifest-v2",
   "schema_path": "contracts/schemas/processor-manifest/processor-manifest-v2.json",
   "stability": "draft",
-  "content_hash": "504f5dee2028bbcd49c023c1c57c8ad664f6ea57f51e8c2431e8a185ae275e87",
+  "content_hash": "bd2e67b226d6eb18eb1cfec69e8840e7d8349161f3357fa71832771f9b8e68dc",
   "last_change": {
-    "summary": "Added API-421 time-model-v1 to the processor contract surface.",
-    "content_hash": "504f5dee2028bbcd49c023c1c57c8ad664f6ea57f51e8c2431e8a185ae275e87"
+    "summary": "Added a typed, owner-governed apparatus configuration target registry and experiment binding contract support.",
+    "content_hash": "bd2e67b226d6eb18eb1cfec69e8840e7d8349161f3357fa71832771f9b8e68dc"
   }
 }

contracts/schema-publication/entries/runtime-snapshot-v1.json

@@ -2,9 +2,9 @@
   "contract_id": "runtime-snapshot-v1",
   "schema_path": "contracts/schemas/snapshots/runtime-snapshot-v1.json",
   "stability": "draft",
-  "content_hash": "8117be2036ef71aa51cbd5529121ec50d5354ef688d1cc54134f768ce7524df8",
+  "content_hash": "ce74f9bb39d44c18badc1451d7f4d363d58e3938de8e360dc020ea2d1e4bcdf7",
   "last_change": {
-    "summary": "Retargeted qualified Python validator references and current project descriptions from the retired ACES package identity to RAES as part of the #884 hard cut; schema identifiers and validation semantics are unchanged.",
-    "content_hash": "8117be2036ef71aa51cbd5529121ec50d5354ef688d1cc54134f768ce7524df8"
+    "summary": "Added first-class append-only API-409 participant control history for RUN-310 supervisory lifecycle persistence and replay.",
+    "content_hash": "ce74f9bb39d44c18badc1451d7f4d363d58e3938de8e360dc020ea2d1e4bcdf7"
   }
 }