Skip to content

feat(operations): define result contracts - #266

Open
jmagar wants to merge 2 commits into
feat/operations-surface-contractsfrom
feat/operations-result-schemas
Open

feat(operations): define result contracts#266
jmagar wants to merge 2 commits into
feat/operations-surface-contractsfrom
feat/operations-result-schemas

Conversation

@jmagar

@jmagar jmagar commented Aug 1, 2026

Copy link
Copy Markdown
Collaborator

Stack

Position Branch Base Purpose
1 feat/product-family-architecture main Product-family architecture (#257)
2 feat/operations-foundation architecture branch Neutral operation foundation (#260)
3 feat/operations-semantic-parity foundation branch Donor legacy semantics (#261)
4 feat/operations-canonical-classification semantic branch Canonical classifications (#262)
5 feat/operations-schema-diagnostics classification branch Schema IDs and diagnostic vocabulary (#264)
6 feat/operations-surface-contracts schema branch Parameter schemas and surface projections (#265)
7 feat/operations-result-schemas surface branch Closed canonical result payload schemas

Summary

  • generate 59 closed Draft 2020-12 result payload schemas
  • bind each result schema ID directly to its canonical OperationSpec
  • normalize mixed donor outputs into 13 shared result families
  • bound inventory, status, metrics, mutation, text/artifact, command, fanout, transfer, diff, file-content, help, and diagnostic-report payloads
  • require inline text/command output or protected artifact references without ambiguous duplication
  • preserve product-specific legacy JSON as projectors above the canonical payloads
  • add a machine schema for the generated bundle
  • add a digest-bound Rust test proving complete operation coverage, closed top-level payloads, unique schema IDs, and family coverage
  • add Just recipes and documentation-package integration

Digest

  • result schemas: 7addf92410b53205dc7ae2b9b80bb58a4ccfbe947e206bb93a8bb439366c3e3a

Validation

  • generator check: 59 result schemas
  • all 59 schemas pass Draft 2020-12 meta-validation
  • bundle schema validates the checked-in instance
  • behavioral probes passed for command/text artifact exclusivity, fanout, transfer, diff, mutation, and unknown-field rejection
  • cargo fmt --all --check
  • 55 unit tests passed
  • five operation integration tests passed
  • strict all-feature Clippy passed
  • rustdoc with warnings denied passed
  • unrelated external consumer compile passed
  • architecture check passed: 37 packages, 85 internal edges
  • full xtask suite passed: 206 tests
  • docs manifest/checksums current: 133 files
  • git diff --check

Scope boundary

This PR defines canonical result payload schemas. Synapse compatibility projectors and concrete shared execution adapters remain the next implementation slices.

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