[cDAC] Expose interpreter JIT manager code heaps

[max-charlamb]

Summary

• export the optional InterpreterJitManagerAddress through the CoreCLR data descriptor
• add JitManagerKind-based ExecutionManager APIs for discovering EE and interpreter managers and enumerating their code heaps independently
• bump the advisory CoreCLR cDAC reader version to 2 and document the reader-version history
• add unit coverage and a dump test using the interpreter-enabled InterpreterStack debuggee

Motivation

Interpreter-generated code is owned by InterpreterJitManager, whose code heaps were not discoverable through the managed cDAC ExecutionManager contract. Dump collectors using the contract could therefore omit metadata stored alongside interpreted code.

The new descriptor global is optional. Readers tolerate runtimes where it is absent, and older readers ignore it. Existing ISOSDacInterface behavior remains EE-only.

Validation

• build.cmd clr+libs+tools.cdac+tools.cdactests -rc Release -lc Release /p:UseSharedCompilation=false
• all 3,154 cDAC unit tests passed
• cDAC dump-test project built with 0 warnings and 0 errors
• InterpreterStackDumpTests.ExecutionManager_EnumeratesInterpreterCodeHeaps: 1 passed (local/jit), 1 expected skip (local/r2r, debuggee is JIT-only)
• generated data-contract documentation check passed

Note

This pull request description was generated with GitHub Copilot.

[azure-pipelines]

Azure Pipelines:
Successfully started running 5 pipeline(s).
11 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[dotnet-policy-service]

Tagging subscribers to this area: @steveisok, @tommcdon, @dotnet/dotnet-diag
See info in area-owners.md if you want to be subscribed.

[azure-pipelines]

Azure Pipelines:
Successfully started running 5 pipeline(s).
11 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

🟡 Changes recommended

A critical API compatibility issue and a moderate reader-version test gap remain unresolved.

Get a fresh assessment by requesting another Copilot review.

Pull request overview

This pull request exposes interpreter JIT manager code heaps through cDAC and updates related contracts, descriptors, tests, and documentation.

Changes:

• Adds optional interpreter manager discovery and heap enumeration APIs.
• Updates native descriptors and test coverage.
• Bumps the advisory reader version to 2 and documents the change.

File summaries

File	Summary
src/native/managed/cdac/tests/UnitTests/MockDescriptors/MockDescriptors.ExecutionManager.cs	Adds interpreter manager test descriptors.
src/native/managed/cdac/tests/UnitTests/ExecutionManager/ExecutionManagerTests.cs	Tests manager selection and heap enumeration.
src/native/managed/cdac/tests/DumpTests/InterpreterStackDumpTests.cs	Adds interpreter heap dump coverage.
src/native/managed/cdac/tests/DumpTests/CodeHeapListDumpTests.cs	Updates EE heap queries.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Legacy/SOSDacImpl.cs	Preserves EE-only legacy behavior.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/RuntimeInfo_1.cs	Reports reader version 2. Moderate finding (1 vote): add a unit assertion for GetCurrentReaderVersion().
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/ExecutionManager/ExecutionManagerCore.cs	Implements manager discovery and enumeration.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/ExecutionManager/ExecutionManager_1.cs	Exposes the new manager APIs.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Constants.cs	Adds the interpreter global name.
src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Abstractions/Contracts/IExecutionManager.cs	Adds manager-kind APIs. Critical finding (2 votes): retain existing EE-only members as EE-forwarding wrappers.
src/coreclr/vm/datadescriptor/datadescriptor.inc	Publishes the optional native global.
src/coreclr/vm/codeman.h	Exposes the interpreter manager address.
docs/design/datacontracts/RuntimeInfo.md	Links reader-version history.
docs/design/datacontracts/reader-version-history.md	Documents reader versions 1 and 2.
docs/design/datacontracts/ExecutionManager.md	Documents the updated contract.
docs/design/datacontracts/data-descriptor-meanings.json	Updates descriptor meanings.

Review details

Suppressed comments (1)

src/native/managed/cdac/Microsoft.Diagnostics.DataContractReader.Contracts/Contracts/RuntimeInfo_1.cs:44

• Please add a unit assertion for GetCurrentReaderVersion() returning 2. This value was just changed and controls the reader capability advertised to callers, but RuntimeInfoTests does not exercise it, so a future mismatch could silently break the reader-version advisory behavior.

    uint IRuntimeInfo.GetCurrentReaderVersion() => 2;

• Files reviewed: 16/16 changed files
• Comments generated: 1
• Review effort level: Lite