Support vendored Go native modules

[ananth7592]

Place generated Cosmos native archives at each target module root so Go vendoring preserves the linker input and cgo can link through ${SRCDIR}.

• generate the flat archive/header layout for all six targets and remove stale native/ or .syso outputs
• bind root archive paths into checksums, provenance, and downstream layout validation
• add direct and vendored Go consumer builds that call cosmos_version() from a real native archive
• update the native pipeline, local rehearsal, Pester coverage, and supply-chain documentation

Validation

• Native pipeline Pester suite: 29/29 passed
• Real Windows AMD64 native archive build: passed
• Direct and -mod=vendor consumer builds against the real archive: passed
• Real native link smoke test: passed
• Markdown lint and cSpell: passed

[azure-pipelines]

Azure Pipelines:
Successfully started running 3 pipeline(s).
2 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]

🔵 Needs a closer look

Two moderate test assertions need their single-quoted expected strings corrected before approval.

Pull request overview

This PR makes Cosmos native Go modules vendoring-compatible by placing archives and headers at module roots.

Changes:

• Flattens native outputs and removes stale paths.
• Strengthens checksum, provenance, and layout validation.
• Adds direct/vendored consumer checks and updates pipeline documentation.

File summaries

File	Summary
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/tests/Test-GoModuleConsumer.Tests.ps1	Tests consumer build command flow.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/tests/Prepare-GoDriverPullRequest.Tests.ps1	Tests staging, provenance, and path validation.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/tests/New-GoModules.Tests.ps1	Tests flat output layout and cleanup.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/Test-NativeLink.ps1	Links against root-level native inputs.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/Test-GoModuleConsumer.ps1	Builds direct and vendored Go consumers.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/README.md	Documents layout and validation.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/Prepare-GoDriverPullRequest.ps1	Validates generated paths, checksums, and provenance.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/New-GoModules.ps1	Generates flat modules and removes stale outputs.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/native-driver.yml	Adds CI validation for checksums and consumers.
sdk/cosmos/azure_data_cosmos_driver_native/pipeline/Invoke-LocalSupplyChain.ps1	Updates the local rehearsal flow.
sdk/cosmos/azure_data_cosmos_driver_native/docs/NATIVE_SUPPLY_CHAIN.md	Updates supply-chain documentation.

Review details

Suppressed comments (2)

sdk/cosmos/azure_data_cosmos_driver_native/pipeline/tests/New-GoModules.Tests.ps1:173

• Because this is a single-quoted PowerShell string, the backtick is literal, so this assertion searches for a backtick before ${SRCDIR} instead of the generated ${SRCDIR}/native text. A linker file containing both the new root directive and the obsolete native-directory directive would therefore pass this check; remove the backtick from the expected string.

            $linkContent | Should -Not -Match ([regex]::Escape('`${SRCDIR}/native'))

sdk/cosmos/azure_data_cosmos_driver_native/pipeline/tests/New-GoModules.Tests.ps1:188

• This repeats the same quoting error: in a single-quoted PowerShell string the backtick is literal, so the repository-wide check does not match the actual obsolete ${SRCDIR}/native directive. Remove the backtick so this regression check can fail when any generated linker file retains the old path.

        $generatedContents | Should -Not -Match ([regex]::Escape('`${SRCDIR}/native'))

• Files reviewed: 11/11 changed files
• Comments generated: 0
• Review effort level: Lite

---

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

[Tomas Varon (tvaron3)]

LGTM thanks