Add 0.8 one-shot configuration contract

[Gudge (MGudgin)]

This PR adds the mutable 0.8.0-alpha one-shot configuration contract.

Details

• Adds independently owned stable-candidate and recursively closed experimental wire types for the development contract.
• Models development containment values, ProcessContainer denial capture, Windows Sandbox, WSLC, telemetry, and compatibility aliases.
• Adds structural, fixture, compatibility, adjacent-version boundary, and strict rustdoc coverage while preserving the published contracts.

Tests

• cargo fmt --all -- --check
• cargo test -p mxc_config_contract (324 tests passed)
• cargo clippy -p mxc_config_contract --all-targets -- -D warnings
• $env:RUSTDOCFLAGS='-D missing-docs'; cargo doc -p mxc_config_contract --no-deps
• git diff --check origin/main..HEAD

Microsoft Reviewers: Open in CodeFlow

[azure-pipelines]

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

[Copilot]

Pull request overview

Adds the mutable, strict one-shot 0.8.0-alpha configuration contract and comprehensive compatibility/boundary tests.

Changes:

• Introduces independently owned development wire types.
• Models new containment, denial-capture, telemetry, Windows Sandbox, and WSLC fields.
• Adds fixtures and version-boundary coverage.

Show a summary per file

File	Description
src/core/mxc_config_contract/src/lib.rs	Exposes the development contract.
src/core/mxc_config_contract/src/dev/mod.rs	Defines and exports 0.8 contract modules.
src/core/mxc_config_contract/src/dev/primitives.rs	Adds strict optional and string primitives.
src/core/mxc_config_contract/src/dev/stable.rs	Models stable-candidate sections.
src/core/mxc_config_contract/src/dev/network.rs	Models network and proxy settings.
src/core/mxc_config_contract/src/dev/one_shot.rs	Defines the one-shot request contract.
src/core/mxc_config_contract/src/dev/experimental.rs	Models closed experimental settings.
src/core/mxc_config_contract/tests/v0_8_0_alpha.rs	Registers the 0.8 test suite.
src/core/mxc_config_contract/tests/v0_8_0_alpha/common.rs	Adds shared assertion helpers.
src/core/mxc_config_contract/tests/v0_8_0_alpha/annotations.rs	Tests annotation fields.
src/core/mxc_config_contract/tests/v0_8_0_alpha/enums.rs	Tests enum values and aliases.
src/core/mxc_config_contract/tests/v0_8_0_alpha/experimental.rs	Registers experimental tests.
src/core/mxc_config_contract/tests/v0_8_0_alpha/experimental/root.rs	Tests experimental-section closure.
src/core/mxc_config_contract/tests/v0_8_0_alpha/experimental/test_and_telemetry.rs	Tests test and telemetry fields.
src/core/mxc_config_contract/tests/v0_8_0_alpha/experimental/windows_sandbox.rs	Tests Windows Sandbox compatibility fields.
src/core/mxc_config_contract/tests/v0_8_0_alpha/experimental/wslc.rs	Tests WSLC settings and mappings.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures.rs	Validates fixture collections.
src/core/mxc_config_contract/tests/v0_8_0_alpha/network.rs	Tests proxy variants and constraints.
src/core/mxc_config_contract/tests/v0_8_0_alpha/one_shot.rs	Tests root and one-shot behavior.
src/core/mxc_config_contract/tests/v0_8_0_alpha/optional_fields.rs	Tests omission and null handling.
src/core/mxc_config_contract/tests/v0_8_0_alpha/seatbelt.rs	Tests Seatbelt structure and aliases.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/minimal.json	Adds a minimal valid fixture.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/complete.json	Adds a comprehensive fixture.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/annotations.json	Adds an annotation fixture.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/app_container_alias.json	Covers the AppContainer alias.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/empty_optional_objects.json	Covers empty optional objects.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/experimental.json	Covers experimental configuration.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/macos_sandbox_alias.json	Covers the macOS alias.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/proxy_builtin.json	Covers built-in proxy configuration.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/proxy_localhost.json	Covers localhost proxy configuration.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/proxy_url.json	Covers URL proxy configuration.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/seatbelt_complete.json	Adds a complete Seatbelt fixture.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/seatbelt_minimal.json	Adds a minimal Seatbelt fixture.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/invalid/incomplete_lxc.json	Covers incomplete LXC settings.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/invalid/seatbelt_invalid_launch_method.json	Covers invalid Seatbelt launch values.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/invalid/seatbelt_unknown_field.json	Covers unknown Seatbelt fields.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/invalid/state_aware.json	Rejects state-aware requests.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/invalid/unknown_nested_field.json	Rejects unknown nested fields.
src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/invalid/unknown_root_field.json	Rejects unknown root fields.
src/core/mxc_config_contract/tests/version_boundaries.rs	Registers new boundary suites.
src/core/mxc_config_contract/tests/version_boundaries/common.rs	Adds adjacent-version helpers.
src/core/mxc_config_contract/tests/version_boundaries/annotations.rs	Simplifies annotation boundaries.
src/core/mxc_config_contract/tests/version_boundaries/compatibility.rs	Extends alias compatibility through 0.8.
src/core/mxc_config_contract/tests/version_boundaries/containment.rs	Tests new containment values.
src/core/mxc_config_contract/tests/version_boundaries/experimental.rs	Tests experimental introduction.
src/core/mxc_config_contract/tests/version_boundaries/process_container.rs	Tests denial-capture introduction.
src/core/mxc_config_contract/tests/version_boundaries/seatbelt.rs	Simplifies Seatbelt boundaries.
src/core/mxc_config_contract/tests/v0_6_0_alpha/root.rs	Strengthens legacy experimental rejection.
src/core/mxc_config_contract/tests/v0_7_0_alpha/root.rs	Strengthens legacy experimental rejection.

Review details

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

Suppressed comments (2)

src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/annotations.json:4

• The fixture is for the new 0.8 contract, but its annotation still identifies the copied 0.7 example. Update the purpose so consumers of this fixture are not told it demonstrates the previous contract.

    "purpose": "Demonstrate 0.7 authoring annotations"

src/core/mxc_config_contract/tests/v0_8_0_alpha/annotations.rs:65

• This second valid annotation example also points to a stable 0.8 schema that does not exist. Reference the current development schema instead so the sample remains a usable $schema value.

        "$schema": "https://github.com/microsoft/mxc/blob/main/schemas/stable/mxc-config.schema.0.8.0-alpha.json",

• Files reviewed: 49/49 changed files
• Comments generated: 2
• Review effort level: Balanced

[Copilot]

Review details

Suppressed comments (1)

src/core/mxc_config_contract/tests/v0_8_0_alpha/fixtures/valid/annotations.json:4

• This 0.8 fixture still describes itself as demonstrating 0.7 annotations, which makes the fixture metadata misleading. Update the version in the purpose text to match the contract exercised by the file.

    "purpose": "Demonstrate 0.7 authoring annotations"

• Files reviewed: 49/49 changed files
• Comments generated: 0 new
• Review effort level: Balanced