Skip to content

feat(schemas): add software operational incident and upstream watch item contracts#24

Merged
mdheller merged 5 commits intomainfrom
oprisk-sourceos-spec-schema-v1
Apr 16, 2026
Merged

feat(schemas): add software operational incident and upstream watch item contracts#24
mdheller merged 5 commits intomainfrom
oprisk-sourceos-spec-schema-v1

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

Summary

Adds the first machine-readable software operational risk contracts:

  • SoftwareOperationalIncident
  • UpstreamWatchItem

plus conforming example payloads.

Why here

Before writing, the current upstream README and schema catalog on main were checked. sourceos-spec is the canonical machine-readable contract layer, so this is the correct place to introduce the first incident and watchlist schemas downstream of the normative governance pack in SocioProphet/socioprophet-standards-storage PR #72.

Included

  • schemas/SoftwareOperationalIncident.json
  • schemas/UpstreamWatchItem.json
  • examples/softwareoperationalincident.json
  • examples/upstreamwatchitem.json

Notes

This PR intentionally starts with the minimum typed surface needed to support:

  • normalized outage corpus records
  • normalized upstream drift / watchlist records
  • future harvester outputs in sociosphere
  • later reserve / scenario envelopes

Follow-on

  • extend the schema catalog index
  • add reserve / scenario report envelopes
  • add OpenAPI / AsyncAPI exposure where needed
  • align downstream automation and runtime repos to these new schema types

Copy link
Copy Markdown
Contributor Author

Follow-up added on the same branch after re-checking current upstream state:

  • docs/software-oprisk-schema-family.md — documents the initial software operational risk schema family, URN prefixes, examples, and intended downstream consumers.

This keeps PR #24 as the single typed-contract lane for the first incident/watchlist schema set.

@mdheller mdheller marked this pull request as ready for review April 16, 2026 20:51
@mdheller mdheller merged commit 8d08595 into main Apr 16, 2026
4 checks passed
@mdheller mdheller deleted the oprisk-sourceos-spec-schema-v1 branch April 16, 2026 20:51
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