Add Java linuxmusl-arm64 native runtime support by Copilot · Pull Request #2728 · github/copilot-sdk

Copilot · 2026-09-18T21:16:50Z

Adds Java native runtime packaging, testing, and publishing support for linuxmusl-arm64, matching the existing native classifier pipeline.

Packaging
- Add ARM64 musl Maven profiles for the runtime and SDK modules.
- Validate ARM64 ELF architecture and musl loader.
- Attach externally built linuxmusl-arm64 artifacts during publication.
CI and publishing
- Exercise in-process mode on ARM64 Alpine.
- Build and validate classifier JARs on ubuntu-24.04-arm.
- Include the classifier in snapshot, release, and local publication assembly.
Coverage and documentation
- Extend native host, artifact, and publication tests.
- Document linuxmusl-arm64 as a supported in-process platform.

Fixes [Java] Add support for linuxmusl-arm64 #2727

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Copilot

Copilot review overview

🟡 Changes recommended

The ADR’s earlier platform-scope section still incorrectly describes Linux musl as unsupported and publication as containing only six classifiers.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1

Open (1)

Update ADR scope to include musl and eight classifiers · New

What changed in this PR

Adds Java linuxmusl-arm64 native runtime support across packaging, validation, testing, publication, and documentation.

Changes:

Adds ARM64 musl Maven profiles and host validation.
Extends CI and publishing pipelines.
Updates tests and supported-platform documentation.

File	Description
`java/sdk/pom.xml`	Selects the ARM64 musl runtime.
`java/README.md`	Documents platform support and build commands.
`java/docs/adr/adr-007-native-bundling-strategy.md`	Adds the published classifier to the ADR.
`java/copilot-native/scripts/validate-native-host.test.mjs`	Tests ARM64 musl host acceptance.
`java/copilot-native/scripts/validate-native-host.mjs`	Recognizes the ARM64 musl classifier.
`java/copilot-native/scripts/validate-native-artifact.test.mjs`	Includes the classifier in publication fixtures.
`java/copilot-native/scripts/validate-local-publication.mjs`	Requires the classifier in complete publications.
`java/copilot-native/scripts/fetch-native.test.mjs`	Extends fetch tests to ARM64 musl.
`java/copilot-native/pom.xml`	Packages and attaches the classifier JAR.
`.github/workflows/java-sdk-tests.yml`	Tests and assembles ARM64 musl artifacts.
`.github/workflows/java-publish-snapshot.yml`	Builds and publishes snapshot artifacts.
`.github/workflows/java-publish-maven.yml`	Builds and publishes release artifacts.

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

  4. Loads it via [JNA](#references) using the C ABI entry points, per the [binding technology decision](#binding-technology-jna-over-panama-ffm) above. The JNA-specific code is confined behind an internal binding interface to preserve a future FFM migration path.
 * A validated supported-host profile fetches the matching platform tarball from the pinned `github/copilot-cli` release, verifies its release SHA-256, and packages the version-matched runtime files.
-* The current release work publishes the `linux-x64`, `linux-arm64`, `linuxmusl-x64`, `win32-x64`, `win32-arm64`, `darwin-x64`, and `darwin-arm64` classifiers. The planned classifier set expands to the other detected platforms.
+* The current release work publishes the `linux-x64`, `linux-arm64`, `linuxmusl-x64`, `linuxmusl-arm64`, `win32-x64`, `win32-arm64`, `darwin-x64`, and `darwin-arm64` classifiers. The planned classifier set expands to the other detected platforms.


edburns · 2026-09-21T20:54:24Z

Copilot review overview

🟡 Changes recommended

The ADR’s earlier platform-scope section still incorrectly describes Linux musl as unsupported and publication as containing only six classifiers.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced Findings: 1

Open (1)

Update ADR scope to include musl and eight classifiers · New

What changed in this PR
Adds Java linuxmusl-arm64 native runtime support across packaging, validation, testing, publication, and documentation.

Changes:

Adds ARM64 musl Maven profiles and host validation.

Extends CI and publishing pipelines.

Updates tests and supported-platform documentation.

File Description
java/sdk/pom.xml Selects the ARM64 musl runtime.
java/README.md Documents platform support and build commands.
java/docs/adr/adr-007-native-bundling-strategy.md Adds the published classifier to the ADR.
java/copilot-native/scripts/validate-native-host.test.mjs Tests ARM64 musl host acceptance.
java/copilot-native/scripts/validate-native-host.mjs Recognizes the ARM64 musl classifier.
java/copilot-native/scripts/validate-native-artifact.test.mjs Includes the classifier in publication fixtures.
java/copilot-native/scripts/validate-local-publication.mjs Requires the classifier in complete publications.
java/copilot-native/scripts/fetch-native.test.mjs Extends fetch tests to ARM64 musl.
java/copilot-native/pom.xml Packages and attaches the classifier JAR.
.github/workflows/java-sdk-tests.yml Tests and assembles ARM64 musl artifacts.
.github/workflows/java-publish-snapshot.yml Builds and publishes snapshot artifacts.
.github/workflows/java-publish-maven.yml Builds and publishes release artifacts.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@copilot update the ADR to document what is now actually supported.

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Copilot · 2026-09-21T20:57:39Z

Copilot review overview

🟡 Changes recommended

The ADR’s earlier platform-scope section still incorrectly describes Linux musl as unsupported and publication as containing only six cl...

Updated the current platform scope to cover both musl classifiers and the eight-classifier publication flow in commit 0c8c4f7.

github-actions · 2026-09-21T21:02:27Z

SDK Consistency Review — PR #2728

This PR adds a new native-runtime classifier (linuxmusl-arm64) for the Java SDK's experimental in-process mode, along with the corresponding CI workflow jobs (java-publish-maven.yml, java-publish-snapshot.yml, java-sdk-tests.yml), build scripts (validate-native-host.mjs, fetch-native.test.mjs, validate-local-publication.mjs, validate-native-artifact.test.mjs), Maven profiles (java/sdk/pom.xml, java/copilot-native/pom.xml), and documentation updates (java/README.md, ADR-007).

Findings:

All changes are scoped to the java/ directory and Java-specific GitHub Actions workflows.
No public API surface (method signatures, client behavior, tool/session APIs) is added or modified — this is purely native-artifact packaging/build infrastructure for Java's in-process mode (JNA-based native library loading).
The in-process/native-classifier bundling system is a Java-specific architectural choice (per ADR-007) with no equivalent construct in the Node.js, Python, Go, .NET, or Rust SDKs, so there is no parallel feature to keep in sync in those SDKs.
No cross-language API naming, parameter, or behavior inconsistencies were introduced.

Conclusion: No cross-SDK consistency issues found. This PR is an internal Java build/packaging enhancement and does not require corresponding changes in other language SDKs.

Generated by SDK Consistency Review Agent for #2728 · copilot · sonnet50 · 21.1 AIC · ⌖ 11.4 AIC · ⊞ 7.8K · ◷

roji · 2026-11-06T13:49:51Z

Closing as already implemented by the normal SDK snapshot in 20d75a71, included in the published SDK v1.0.17. The Java native packaging profiles, SDK profile, ARM64 musl host/artifact validation, and external classifier attachment already support linuxmusl-arm64; current documentation also lists that classifier. The native module POM and several validation files on main exactly match this PR's results. No separate merge is needed. Thanks for completing the platform support.

Initial plan

da5324b

Copilot AI assigned Copilot and edburns Sep 18, 2026

Copilot AI linked an issue Sep 18, 2026 that may be closed by this pull request

[Java] Add support for linuxmusl-arm64 #2727

Closed

Copilot started work on behalf of edburns September 18, 2026 21:17

View session

Add Java linuxmusl ARM64 support

f32fee1

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add support for linuxmusl-arm64 to copilot-sdk~~ Add Java linuxmusl-arm64 native runtime support Sep 18, 2026

Copilot AI requested a review from edburns September 18, 2026 21:31

Copilot finished work on behalf of edburns September 18, 2026 21:31

This comment has been minimized.

Sign in to view

Merge branch 'main' into copilot/add-linuxmusl-arm64-support

faa7581

edburns marked this pull request as ready for review September 21, 2026 20:28

edburns requested a review from a team as a code owner September 21, 2026 20:28

Copilot AI balanced review requested due to automatic review settings September 21, 2026 20:28

Copilot started reviewing on behalf of edburns September 21, 2026 20:29

View session

Copilot AI reviewed Sep 21, 2026

View reviewed changes

This comment has been minimized.

Sign in to view

Copilot started work on behalf of edburns September 21, 2026 20:55

View session

Update ADR native platform scope

0c8c4f7

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Copilot finished work on behalf of edburns September 21, 2026 20:57

roji closed this Nov 6, 2026

Navigation Menu

Repository navigation

Add Java linuxmusl-arm64 native runtime support - #2728

Add Java linuxmusl-arm64 native runtime support#2728
edburns with Copilot wants to merge 4 commits into
mainfrom
copilot/add-linuxmusl-arm64-support

Copilot AI commented Sep 18, 2026 •

edited

Loading

Uh oh!

This comment has been minimized.

Copilot AI left a comment

Uh oh!

This comment has been minimized.

edburns commented Sep 21, 2026

Copilot review overview

🟡 Changes recommended

Uh oh!

Copilot AI commented Sep 21, 2026

Copilot review overview

🟡 Changes recommended

Uh oh!

github-actions Bot commented Sep 21, 2026

Uh oh!

roji commented Nov 6, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Copilot AI commented Sep 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment has been minimized.

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

This comment has been minimized.

edburns commented Sep 21, 2026

Copilot review overview

🟡 Changes recommended

Uh oh!

Copilot AI commented Sep 21, 2026

Copilot review overview

🟡 Changes recommended

Uh oh!

github-actions Bot commented Sep 21, 2026

SDK Consistency Review — PR #2728

Uh oh!

roji commented Nov 6, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented Sep 18, 2026 •

edited

Loading