Skip to content

Commit c66e58f

Browse files
committed
docs(control-plane): fix incident schema identity note (legacy vs canonical wrapper)
1 parent b84bf08 commit c66e58f

1 file changed

Lines changed: 3 additions & 5 deletions

File tree

schemas/control-plane/README.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ This tranche was originally imported with `$id` values under the `socioprophet.o
88

99
Canonical SourceOS contract IDs use the `schemas.srcos.ai/v2/...` namespace.
1010

11-
To avoid breaking legacy `$id` consumers, this directory now supports a **two-layer identity model**:
11+
To avoid breaking legacy `$id` consumers, this directory supports a **two-layer identity model**:
1212

1313
- **Legacy schemas**: `*.schema.json` files preserve the original `$id` values.
1414
- **Canonical wrappers**: `*.json` files provide canonical `$id` values in the `schemas.srcos.ai` namespace and `allOf`-wrap the legacy schema.
@@ -27,6 +27,7 @@ Legacy (original import, legacy `$id`):
2727
- `fingerprint.schema.json`
2828
- `mesh-skill.schema.json`
2929
- `skill-execution-events.schema.json`
30+
- `incident-events.schema.json` (legacy incident lifecycle schema identity; canonical wrapper is `IncidentEvent.json`)
3031

3132
Canonical wrappers (preferred for new references):
3233

@@ -40,10 +41,6 @@ Canonical wrappers (preferred for new references):
4041
- `SkillExecutionEvent.json`
4142
- `IncidentEvent.json`
4243

43-
Incident schema:
44-
45-
- `incident-events.schema.json` (normalized to `schemas.srcos.ai` by PR #35)
46-
4744
## Intent
4845

4946
These schemas define the minimum typed seam for:
@@ -54,6 +51,7 @@ These schemas define the minimum typed seam for:
5451
4. authorizing boot/recovery/install flows where required
5552
5. redeeming one-time enrollment tokens
5653
6. emitting post-apply fingerprints for compliance and rollback decisions
54+
7. emitting incident lifecycle events (freeze/fork/kill)
5755

5856
## Downstream consumers
5957

0 commit comments

Comments
 (0)