Fix #120: Establish AEP schema scaffolding: schemas/index.json registry, schemas/aep/ directory, and valid/invalid fixture conventions

.claude-bot/verify.yml

@@ -5,7 +5,10 @@
 version: 1
 
 setup:
-  - python3 -m pip install --quiet --upgrade jsonschema referencing build
+  # --break-system-packages keeps this robust under PEP 668 externally-managed
+  # environments (the Debian/Ubuntu Python the merge gate runs in). In a normal
+  # or venv-managed environment the flag is a harmless no-op.
+  - python3 -m pip install --quiet --upgrade --break-system-packages jsonschema referencing build
 
 steps:
   - name: schema-conformance
@@ -15,5 +18,5 @@ steps:
   - name: python-wheel-import
     run: |
       python3 -m build --wheel
-      python3 -m pip install --quiet --force-reinstall dist/*.whl
+      python3 -m pip install --quiet --force-reinstall --break-system-packages dist/*.whl
       python3 -c "from wasmagent_protocol import get_schema; assert get_schema('aep-record')['title']=='AEPRecord'"

schemas/aep/fixtures/seed/invalid/example.json

@@ -0,0 +1,4 @@
+{
+  "schema_version": "seed/v0.1",
+  "seed_id": "seed-abc123"
+}

schemas/aep/fixtures/seed/valid/example.json

@@ -0,0 +1,6 @@
+{
+  "schema_version": "seed/v0.1",
+  "seed_id": "seed-abc123",
+  "created_at_ms": 1737600000000,
+  "label": "example seed evidence"
+}

schemas/aep/seed.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://wasmagent.dev/schemas/aep/seed.schema.json",
+  "title": "SeedEvidence",
+  "description": "Template seed schema establishing the AEP evidence JSON Schema baseline. Demonstrates the pinned-draft, $id, title, type, required, properties, and additionalProperties:false convention for all AEP evidence schemas. Future Milestone 4 evidence schemas (e.g. checkpoint-evidence) mirror this structure.",
+  "type": "object",
+  "required": ["schema_version", "seed_id", "created_at_ms"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "description": "Schema version identifier, e.g. seed/v0.1"
+    },
+    "seed_id": {
+      "type": "string",
+      "description": "Unique identifier for this evidence record"
+    },
+    "created_at_ms": {
+      "type": "number",
+      "description": "UTC epoch milliseconds when the record was created"
+    },
+    "label": {
+      "type": "string",
+      "description": "Optional human-readable label for categorization"
+    }
+  },
+  "additionalProperties": false
+}

schemas/index.json

@@ -41,6 +41,22 @@
       ],
       "summary": "Shared envelope base for all AEP evidence records \u2014 schema_version, trace_id, created_at_ms, and optional signature."
     },
+    {
+      "id": "seed",
+      "title": "SeedEvidence",
+      "path": "schemas/aep/seed.schema.json",
+      "canonical_id": "https://wasmagent.dev/schemas/aep/seed.schema.json",
+      "version": "seed/v0.1",
+      "stability": "evolving",
+      "owners": [
+        "wasmagent-protocol"
+      ],
+      "consumers": [
+        "wasmagent-js",
+        "trace-pipeline"
+      ],
+      "summary": "Template seed schema establishing the AEP evidence JSON Schema baseline — pinned draft, $id convention, required, properties, additionalProperties:false."
+    },
     {
       "id": "constraint-ir",
       "title": "ConstraintIR",

tests/fixtures/invalid/seed/example.json

@@ -0,0 +1,4 @@
+{
+  "schema_version": "seed/v0.1",
+  "seed_id": "seed-abc123"
+}

tests/fixtures/invalid/seed/extra-property.json

@@ -0,0 +1,6 @@
+{
+  "schema_version": "seed/v0.1",
+  "seed_id": "seed-abc123",
+  "created_at_ms": 1737600000000,
+  "extra_unexpected_field": "this should be rejected"
+}

tests/fixtures/valid/seed/example.json

@@ -0,0 +1,6 @@
+{
+  "schema_version": "seed/v0.1",
+  "seed_id": "seed-abc123",
+  "created_at_ms": 1737600000000,
+  "label": "example seed evidence"
+}