Skip to content

spec(workstation): add canonical doctor/fix report schemas#54

Merged
mdheller merged 9 commits intomainfrom
feat/workstation-report-schemas
Apr 22, 2026
Merged

spec(workstation): add canonical doctor/fix report schemas#54
mdheller merged 9 commits intomainfrom
feat/workstation-report-schemas

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

Adds the first canonical workstation report contract family to sourceos-spec.

Changes:

  • schemas/WorkstationDoctorReport.json
  • schemas/WorkstationFixShellReport.json
  • schemas/WorkstationFixFishReport.json
  • schemas/WorkstationFixAllReport.json
  • conforming examples for each schema
  • docs/workstation-report-contract-family.md

Why:

  • SociOS-Linux/source-os now emits real machine-readable workstation reports:
    • sourceos.doctor
    • sourceos.fix.shell
    • sourceos.fix.fish
    • sourceos.fix.all
  • Those reports need to graduate from implementation-local JSON shapes into the canonical typed contract layer.
  • Downstream repos (agentplane, sociosphere, prophet-cli, contractforge) can then bind to one stable schema source.

Compatibility note:

  • The schemas preserve the current kind discriminator strings emitted by the Linux realization so they remain aligned with the existing producer while becoming formally typed.

Follow-on:

  • Update schemas/README.md catalog entries if reviewers want them in this PR rather than a small follow-up.
  • Add optional metadata/provenance fields when the producer begins emitting them.

@mdheller mdheller merged commit 7d9b315 into main Apr 22, 2026
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