Skip to content

spec hygiene: eliminate duplicate IncidentEvent $id and reference canonical wrapper#39

Merged
mdheller merged 2 commits intomainfrom
spec/hygiene-incident-id-20260418
Apr 19, 2026
Merged

spec hygiene: eliminate duplicate IncidentEvent $id and reference canonical wrapper#39
mdheller merged 2 commits intomainfrom
spec/hygiene-incident-id-20260418

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

Fixes a subtle multi-authority issue introduced by PR #35/#38:

  • Both schemas/control-plane/incident-events.schema.json and schemas/control-plane/IncidentEvent.json currently share the same canonical $id.
    This creates duplicate schema identity and can confuse resolvers.

This PR restores the intended two-layer model:

  1. Make incident-events.schema.json a legacy schema identity
  • Reverts its $id to the legacy socioprophet.org namespace.
  • Keeps its content and title unchanged.
  1. Keep IncidentEvent.json as the canonical identity
  • Canonical $id remains https://schemas.srcos.ai/v2/control-plane/IncidentEvent.json.
  1. Update Truth Plane OpenAPI patch to reference canonical wrapper
  • openapi.truth-plane.patch.yaml now $refs ./schemas/control-plane/IncidentEvent.json.

No loss of intent; this removes duplicate authority and keeps both legacy and canonical identities available.

@mdheller mdheller merged commit ab92673 into main Apr 19, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant