feat(spec): introduce OSImage / NodeBinding / CyberneticAssignment seam#26
Merged
feat(spec): introduce OSImage / NodeBinding / CyberneticAssignment seam#26
Conversation
Contributor
Author
|
Execution note for reviewers: This PR is the anchor tranche for the OS build / cybernetic boundary rollout. Recommended merge order after review:
Downstream draft PRs have already been staged against this seam and should be treated as dependent consumers, not parallel schema authorities. Before merge, this PR still needs the existing-file completion tranche noted in the description:
Once those are complete and the branch is refreshed on current |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This draft PR stages the foundational additive contract tranche for the OS build / cybernetic boundary:
schemas/OSImage.jsonschemas/NodeBinding.jsonschemas/CyberneticAssignment.jsondocs/specs/canon.os-build.v1.mddocs/adr/0001-os-build-cybernetic-boundary.mdIntent
The goal is to formalize the seam between:
OSImage)NodeBinding)CyberneticAssignment)Why draft
This branch was cut from
mainand staged successfully, butmainadvanced during authoring and the branch is now behind the current base. The added files are isolated new paths, so review can begin now, but the branch should be rebased or replayed onto currentmainbefore merge.Follow-on required in this PR or immediate successor
To fully satisfy the repository contribution discipline, the following still need to be added or updated on top of this draft:
README.mdschema family table / repo layout referencesARCHITECTURE.mdURN table and lifecycle discussionschemas/README.mdcatalog rows for the three new typesCHANGELOG.mdadditiveUnreleasedentry (or release entry if cut asv2.1.0)openapi.yamladditive REST exposure if these objects are promoted to first-class API resourcesasyncapi.yamladditive event exposure if these objects emit first-class change eventsNotes for reviewers
This PR is intentionally limited to the foundational new-file tranche because the connector path available during staging exposed a straightforward create-file workflow for new files but not a clean single-step update path for the existing catalog/changelog/API files.
Suggested next review order