Skip to content

feat(operations): define surface contracts - #265

Open
jmagar wants to merge 2 commits into
feat/operations-schema-diagnosticsfrom
feat/operations-surface-contracts
Open

feat(operations): define surface contracts#265
jmagar wants to merge 2 commits into
feat/operations-schema-diagnosticsfrom
feat/operations-surface-contracts

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 Closed parameter schemas and surface projections

Summary

  • generate 59 closed Draft 2020-12 canonical parameter schemas
  • exclude Flux/Scout routing and presentation fields from shared schemas
  • preserve exact required and alternative parameter groups from the pinned donor
  • encode bounded fields, defaults, enum constraints, delta exclusivity, Compose volume-removal confirmation, and command allowlisting
  • generate complete projections for all 33 stable diagnostic codes across CLI exit codes, HTTP statuses, MCP error codes, event severity, retry, and terminal behavior
  • add machine schemas for both generated bundles
  • add digest-bound Rust tests proving schema IDs, closed shapes, required parity, complete operation coverage, and exact diagnostic vocabulary coverage
  • add Just recipes and documentation-package integration

Digests

  • parameter schemas: 62ff07d6fed6bf18d65fae54708c28ceb3397a4c4cf9f9810a6ef61a68f308fa
  • diagnostic projections: 87d9be437bf7a0ac8a21ac32e03e852a98d6ba30591c2ad6009e570cd35fafaa

Validation

  • generator check: 59 schemas, 33 diagnostic projections
  • every parameter schema passes Draft 2020-12 meta-validation
  • both bundle schemas validate their checked-in instances
  • behavioral probes pass for delta alternatives, Compose force confirmation, unknown-field rejection, and command allowlisting
  • cargo fmt --all --check
  • 55 unit tests passed
  • four 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: 131 files
  • git diff --check

Scope boundary

This PR defines canonical parameter schemas and diagnostic surface projections. Concrete typed result payload schemas and product adapter implementation remain the next 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