Skip to content

Publish exact 1.0 and open 1.1 development - #1270

Merged
Gudge (MGudgin) merged 1 commit into
mainfrom
user/gudge/rust-sdk-phase14b
Sep 30, 2026
Merged

Gudge (MGudgin) merged 1 commit into
mainfrom
user/gudge/rust-sdk-phase14b

Conversation

@MGudgin

@MGudgin Gudge (MGudgin) commented Sep 24, 2026 •

Copy link
Copy Markdown
Member

This PR publishes the exact 1.0.0 configuration contract from the v0.9
baseline and renames the mutable development contract to 1.1.0-alpha. It also
updates the existing executor and typed lifecycle compatibility seams so this
stack boundary remains independently buildable after retiring 0.10.0-alpha.

Details

  • Remove pre-v1 compatibility aliases from the immutable 1.0 contract.
  • Generate and register the stable 1.0 schema and TypeScript wire oracle.
  • Rename development surfaces and artifacts to 1.1.0-alpha.
  • Target SDK major 1 at the latest published 1.0.0 contract.

Tests

  • cargo check --workspace --all-targets --all-features
  • npm run check-contract-codegen
  • npm run check-schema-versions
  • npm run validate-configs — 394 configs validated.
Microsoft Reviewers: Open in CodeFlow

@MGudgin
Gudge (MGudgin) requested a review from a team as a code owner September 24, 2026 22:07
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The compatibility documentation omits the newly supported stable 1.0.0 contract and incorrectly leaves 0.9 marked current.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Publishes the immutable exact 1.0 contract, advances development to 1.1.0-alpha, and updates parsers, SDKs, generated artifacts, documentation, and validation fixtures accordingly.

Changes:

  • Adds and registers exact 1.0 wire contracts, adapters, schemas, and tests.
  • Renames mutable 0.10 development surfaces to 1.1.0-alpha.
  • Updates SDK version metadata and lifecycle compatibility paths.
File Description
docs/​*.md Updates schema, versioning, lifecycle, and backend documentation.
schemas/​dev/​mxc-config.schema.1.1.0-alpha.json Publishes the renamed development schema.
schemas/​stable/​mxc-config.schema.1.0.0.json Adds the generated stable 1.0 schema.
schemas/​schema-version.json Registers stable 1.0 and development 1.1 targets.
scripts/​versioning/​** Validates published SDK targets and generated contracts.
sdk/​dotnet/​** Updates .NET schema constants, validation, tests, and documentation.
sdk/​node/​src/​generated/​** Adds exact 1.0 and 1.1 TypeScript wire artifacts.
sdk/​node/​src/​** Updates supported versions and lifecycle constants.
sdk/​node/​tests/​** Updates SDK and wire-conformance coverage.
src/​backends/​nanvix/​runner/​src/​lib.rs Moves backend policy tests to 1.1-alpha.
src/​core/​mxc-sdk/​tests/​state_aware.rs Updates typed lifecycle contract coverage.
src/​core/​mxc_config_contract/​src/​dev/​** Renames the mutable contract to 1.1-alpha.
src/​core/​mxc_config_contract/​src/​published/​v1_0_0/​** Implements the immutable exact 1.0 contract.
src/​core/​mxc_config_contract/​src/​{published/​mod.rs,registry.rs,version.rs} Registers and exposes the new versions.
src/​core/​mxc_config_contract/​tests/​support/​** Makes shared tests version- and alias-aware.
src/​core/​mxc_config_contract/​tests/​v0_9_0_alpha/​** Preserves prior-version boundary coverage.
src/​core/​mxc_config_contract/​tests/​v0_10_0_alpha/​** Removes retired development fixtures.
src/​core/​mxc_config_contract/​tests/​v1_0_0/​** Adds exact 1.0 contract and fixture coverage.
src/​core/​mxc_config_contract/​tests/​v1_1_0_alpha/​** Renames and extends development-contract coverage.
src/​core/​mxc_config_contract/​tests/​version_boundaries/​** Tests the 1.0 compatibility-alias boundary.
src/​core/​mxc_engine/​src/​policy/​** Adds exact 1.0 builders and advances development builders.
src/​core/​mxc_engine/​src/​state_aware*.rs Accepts registered 1.0 and 1.1 lifecycle versions.
src/​core/​wxc/​src/​main.rs Updates CLI contract coverage.
src/​core/​wxc_common/​src/​config_contract_adapters/​dev/​** Advances development adapters to 1.1-alpha.
src/​core/​wxc_common/​src/​config_contract_adapters/​v1_0/​** Adds exact 1.0 normalization adapters and tests.
src/​core/​wxc_common/​src/​config_contract_adapters/​mod.rs Registers the 1.0 adapter module.
src/​core/​wxc_common/​src/​config_deserialize.rs Covers exact 1.0 request roots.
src/​core/​wxc_common/​src/​config_parser.rs Dispatches exact 1.0 and 1.1 contracts.
src/​core/​wxc_common/​src/​{policy_identity.rs,sdk_input.rs,state_aware_binding_tests.rs} Updates version-sensitive lifecycle behavior.
src/​ffi/​mxc_ffi/​src/​state_aware.rs Updates FFI lifecycle fixtures.
src/​testing/​wxc_e2e_tests/​tests/​e2e_windows.rs Moves Windows E2E policies to 1.1-alpha.
src/​tools/​mxc_schema_gen/​** Generates and tests 1.0 and 1.1 artifacts.
tests/​configs/​*.json Advances backend execution fixtures to 1.1-alpha.
tests/​examples/​*.json Updates Windows Sandbox examples.
tests/​playground/​src/​renderer/​app.ts Emits 1.1-alpha raw backend configurations.
tests/​scripts/​run_hyperlight_network_migration_test.ps1 Updates migration assertions to 1.1.
tests/​scripts/​run_windows_sandbox_state_aware_tests.ps1 Defaults lifecycle requests to 1.1-alpha.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/playground-limitations.md Resolved
Copilot AI review requested due to automatic review settings September 25, 2026 21:02
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from a3b0bb2 to 32de98b Compare September 25, 2026 21:02

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The multi-digit minor-version test now compares different major versions and no longer covers the behavior named by the test.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 Medium severity

Open (1)
Resolved since last review (1)

Copilot AI review requested due to automatic review settings September 25, 2026 22:44
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 32de98b to 1597b6b Compare September 25, 2026 22:44

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The ProcessContainer lifecycle suite still expects the newly published 1.0 contract to be rejected.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 High severity

Open (1)
Resolved since last review (1)

Comment thread schemas/schema-version.json Resolved
Copilot AI review requested due to automatic review settings September 25, 2026 23:02
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 1597b6b to 3e4c00e Compare September 25, 2026 23:02

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

Exact-contract behavior and compatibility boundaries are consistently updated, with only a non-blocking stale test alias remaining.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
Resolved since last review (1)

Copilot AI review requested due to automatic review settings September 25, 2026 23:19
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 3e4c00e to 2c0377d Compare September 25, 2026 23:19
Copilot AI review requested due to automatic review settings September 26, 2026 23:37
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 032b73d to 3a97a53 Compare September 26, 2026 23:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Publishing an immutable contract across 307 files warrants final human verification despite coherent implementation and comprehensive tests.

Review effort: Balanced
Findings: 1 Low severity

Open (1)

Comment thread docs/versioning.md Resolved
Copilot AI review requested due to automatic review settings September 26, 2026 23:56
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 3a97a53 to 9c9c857 Compare September 26, 2026 23:56

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

The 307-file wire-contract publication changes immutable schemas and multiple SDK boundaries, warranting final human review despite no identified blocking defect.

Review effort: Balanced
Findings: None

Resolved since last review (1)

Copilot AI review requested due to automatic review settings September 27, 2026 18:26
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 9c9c857 to 6dc79c3 Compare September 27, 2026 18:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

The cross-language contract publication and compatibility transition require final human validation despite no specific defect found.

Review effort: Balanced
Findings: None

@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 6dc79c3 to 5a6afd1 Compare September 27, 2026 21:05
Base automatically changed from user/gudge/rust-sdk-phase14a to main September 28, 2026 14:15
@MGudgin
Gudge (MGudgin) force-pushed the user/gudge/rust-sdk-phase14b branch from 5a6afd1 to e53e629 Compare September 28, 2026 14:15
@jsidewhite

Copy link
Copy Markdown
Member

"appContainer": {

delete this file?


Refers to: src/core/mxc_config_contract/tests/v1_0_0/fixtures/one_shot/invalid/app_container_alias.json:6 in e53e629. [](commit_id = e53e629, deletion_comment = False)

@jsidewhite

Copy link
Copy Markdown
Member

/// Selects one exact-contract network format before backend-specific fields are applied.

..why? contract adapter should have already done this.


Refers to: src/core/mxc_engine/src/policy/network.rs:239 in e53e629. [](commit_id = e53e629, deletion_comment = False)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:shipit:

@MGudgin

Copy link
Copy Markdown
Member Author

/// Selects one exact-contract network format before backend-specific fields are applied.

..why? contract adapter should have already done this.

Refers to: src/core/mxc_engine/src/policy/network.rs:239 in e53e629. [](commit_id = e53e629, deletion_comment = False)

Because 0.8 supports both legacy and directional. That said, we could move some of this decision making earlier in the pipeline.

This PR publishes the exact 1.0.0 configuration contract from the v0.9
baseline and renames the mutable development contract to 1.1.0-alpha. It wires
both identities through generation, parsing, adapters, engine policy
construction, SDK validation, fixtures, and documentation.

Details

* Remove pre-v1 compatibility aliases throughout the v1 contract line,
  reject them in Node raw-configuration validation, and remove redundant
  v1 alias-rejection fixtures.
* Generate and register the stable 1.0 schema and TypeScript wire oracle.
* Rename all 0.10 development surfaces and artifacts to 1.1.0-alpha.
* Target SDK major 1 at the latest published 1.0.0 contract.
* Verify v1.0 rejects development-only fields before v1.1 introduces them.
* Verify the retired 0.10 development version remains unregistered.
* Document backend-specific exact versions for state-aware SDK requests.
* Preserve same-major, multi-digit minor ordering coverage with 1.9 and 1.10.
* Update ProcessContainer lifecycle boundaries for registered 1.0 and 1.1
  contracts and reject unregistered 1.2 development input.

Tests

* `cargo fmt --all -- --check`
* `cargo check` and `cargo clippy` on affected Rust crates and all targets;
  Clippy passed with `-D warnings`.
* Rust v1.0 and v1.1 fixture suites: 637 passed; alias parser guard passed.
* Node SDK build and unit tests; .NET lifecycle tests: 86 passed.
* Selected versioning tests: 40 passed; three exact contract artifact sets
  matched and validated; 403 configs validated against six exact schemas.
* PowerShell parser accepted three affected scripts; `git diff --check`.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 1d91874d-feea-4a33-b183-67d506ae61b5
Copilot-Session: 33217f7b-dc7d-4da0-af5f-018fef64013c
Copilot-Session: 76fcff6a-5a76-47c5-a803-c5d695981c0f
Generated-with: gpt-6-sol

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Publishing an immutable contract across 303 files warrants final human verification despite consistent implementation and passing automated checks.

Review effort: Balanced
Findings: None

@MGudgin
Gudge (MGudgin) merged commit f82237f into main Sep 30, 2026
31 checks passed
@MGudgin
Gudge (MGudgin) deleted the user/gudge/rust-sdk-phase14b branch September 30, 2026 13:30
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.

4 participants