feat(runtime): Add option to disable Document Schema upgrades

[scottn12]

Description

This PR adds an option disableSchemaUpgrade to ContainerRuntimeOptions. When enabled, it will prevent the runtime from sending DocumentSchemaChange ops and will throw on incoming DocumentSchemaChange ops.

This is useful for applications that don't require schema upgrades, as it guarantees that no mid-session errors can arise from schema upgrades.

Misc

AB#53703
Spec

[Copilot]

Pull request overview

Adds a new runtime option to disable document schema upgrades, preventing outgoing DocumentSchemaChange ops and rejecting incoming ones to avoid mid-session schema transitions.

Changes:

• Introduces disableSchemaUpgrade on ContainerRuntimeOptions (defaulting to false) and threads it into schema controller behavior.
• Updates schema controller logic to no-op on send and throw on receive when schema upgrades are disabled.
• Extends tests and option matrices to exercise the new flag and updates API/type-validation artifacts.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
packages/test/test-service-load/src/optionsMatrix.ts	Adds the new flag to load-test runtime option permutations.
packages/service-clients/azure-client/src/test/AzureClient.spec.ts	Updates expected runtime options to include the new flag.
packages/runtime/container-runtime/src/test/types/validateContainerRuntimePrevious.generated.ts	Marks the API type compatibility break as expected.
packages/runtime/container-runtime/src/test/documentSchema.spec.ts	Adds coverage for disabled-upgrade behavior and updates controller construction calls.
packages/runtime/container-runtime/src/test/containerRuntime.spec.ts	Updates expected runtime options and telemetry assertions to include the new flag.
packages/runtime/container-runtime/src/summary/documentSchema.ts	Implements the disable-upgrade behavior in the schema controller and updates docs.
packages/runtime/container-runtime/src/containerRuntime.ts	Adds the new option to the public runtime options API and wires it into construction.
packages/runtime/container-runtime/src/containerCompatibility.ts	Excludes the new option from doc-schema-affecting runtime options.
packages/runtime/container-runtime/package.json	Records the API compatibility break in type validation configuration.
packages/runtime/container-runtime/api-report/container-runtime.legacy.beta.api.md	Updates the API report to include the new option.

Comments suppressed due to low confidence (1)

packages/runtime/container-runtime/src/summary/documentSchema.ts:1

• Adding another positional boolean parameter to an already-long constructor signature increases the chance of call-site mistakes (especially since many call sites now pass a bare false). Consider making this parameter optional with a default (disableSchemaUpgrade = false) or switching to an options object for the trailing parameters so call sites are self-documenting and future additions don’t require broad mechanical edits.

/*!

---

You can also share your feedback on Copilot code review. Take the survey.

[github-actions]

🔗 No broken links found! ✅

Your attention to detail is admirable.

linkcheck output

> fluid-framework-docs-site@0.0.0 ci:check-links /home/runner/work/FluidFramework/FluidFramework/docs
> start-server-and-test "npm run serve -- --no-open" 3000 check-links

1: starting server using command "npm run serve -- --no-open"
and when url "[ 'http://127.0.0.1:3000' ]" is responding with HTTP status code 200
running tests using command "npm run check-links"


> fluid-framework-docs-site@0.0.0 serve
> docusaurus serve --no-open

[SUCCESS] Serving "build" directory at: http://localhost:3000/

> fluid-framework-docs-site@0.0.0 check-links
> linkcheck http://localhost:3000 --skip-file skipped-urls.txt

Crawling...

Stats:
  257792 links
    1822 destination URLs
    2063 URLs ignored
       0 warnings
       0 errors