Skip to content

Add control-plane ReleaseSet and Fingerprint examples#59

Merged
mdheller merged 5 commits intomainfrom
work/control-plane-examples
Apr 26, 2026
Merged

Add control-plane ReleaseSet and Fingerprint examples#59
mdheller merged 5 commits intomainfrom
work/control-plane-examples

Conversation

@mdheller
Copy link
Copy Markdown
Contributor

Summary

Adds concrete SourceOS control-plane lifecycle examples for the existing ReleaseSet and Fingerprint schemas.

This PR adds:

  • examples/release_set.json
  • examples/fingerprint.json
  • tools/validate_control_plane_examples.py
  • Makefile

This PR updates:

  • examples/README.md

What changed

The examples model the M2 local-first lifecycle proof path:

  • an assigned ReleaseSet for an M2 demo device
  • a post-apply Fingerprint showing realized state and compliance against that release

The validator proves both examples conform to the existing control-plane legacy schemas wrapped by canonical schemas.srcos.ai/v2/... contracts.

Software review

Correctness: this does not duplicate schemas. It hardens the existing ReleaseSet and Fingerprint contracts with conforming examples and validation.

Risk: low. Spec/example/validation-only tranche.

Weakness: BootReleaseSet and secure boot provisioning examples remain future work.

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