-
Notifications
You must be signed in to change notification settings - Fork 83
Description
Problem
ARM64 platform binaries are not published in sync with main package releases for @ruvector/attention and @ruvector/gnn. This causes installation failures on ARM64 Linux systems (e.g., GitHub Codespaces, Docker DevContainers on M1/M2 Macs, AWS Graviton).
Error Message
When installing @agentic-qe/v3 which depends on @ruvector/attention@^0.1.4:
Error: Cannot find module '@ruvector/attention-linux-arm64-gnu'
Require stack:
- /workspaces/project/node_modules/@ruvector/attention/index.js
Version Analysis
@ruvector/attention
| Version | Main Package | linux-arm64-gnu | darwin-arm64 |
|---|---|---|---|
| 0.1.4 | ✅ Published | ❌ Missing | ❌ Missing |
| 0.1.3 | ✅ Published | ✅ Published | ✅ Published |
| 0.1.2 | ✅ Published | ❌ Missing | ❌ Missing |
| 0.1.1 | ✅ Published | ✅ Published | ✅ Published |
| 0.1.0 | ✅ Published | ✅ Published | ✅ Published |
@ruvector/gnn
| Version | Main Package | linux-arm64-gnu | darwin-arm64 |
|---|---|---|---|
| 0.1.22 | ✅ Published | ❌ Missing | ❌ Missing |
| 0.1.21 | ✅ Published | ❌ Missing | ❌ Missing |
| 0.1.19 | ✅ Published | ✅ Published | ✅ Published |
| 0.1.18 | ✅ Published | ❌ Missing | ❌ Missing |
| 0.1.17 | ✅ Published | ❌ Missing | ❌ Missing |
| 0.1.15 | ✅ Published | ✅ Published | ✅ Published |
Root Cause
Looking at the CI/CD workflows (build-attention.yml, build-gnn.yml), ARM64 builds are configured in the matrix:
matrix:
settings:
- host: ubuntu-22.04
target: aarch64-unknown-linux-gnu
platform: linux-arm64-gnuHowever, the publish steps may not be triggering correctly for all releases:
build-attention.yml: Commits binaries only onworkflow_dispatchor push to main (not tags)build-gnn.yml: Publishes only wheninputs.publish == trueor on version tags
This means ARM64 binaries may be built but not published to npm when version bumps happen.
Impact
- Agentic QE v3 fails to start MCP server on ARM64 Linux
- GitHub Codespaces users cannot use the package
- Docker DevContainers on Apple Silicon fail
- AWS Graviton and other ARM64 cloud instances affected
Requested Fix
Option 1: Publish missing ARM64 binaries (immediate)
Manually trigger the workflows to build and publish ARM64 binaries for:
@ruvector/attention@0.1.4@ruvector/gnn@0.1.20,0.1.21,0.1.22
Option 2: Fix CI/CD for future releases (long-term)
Ensure ARM64 platform packages are published whenever the main package is published:
- Add ARM64 binaries to the same publish workflow as main package
- Or ensure
workflow_dispatchis run after each release - Consider atomic publishing of all platform packages together
Option 3: WASM fallback (alternative)
Provide guidance on using WASM packages as a fallback:
@ruvector/attention-unified-wasm(0.1.29 available)@ruvector/gnn-wasm(0.1.0 available)
Environment
- Platform: ARM64 Linux (aarch64-unknown-linux-gnu)
- Node.js: 20.x
- OS: Ubuntu 22.04 in Docker/Codespaces
- Package versions needed:
@ruvector/attention@0.1.4@ruvector/gnn@0.1.22@ruvector/sona@0.1.5(this one works - ARM64 binary published)
Workaround (temporary)
Until fixed, users can:
- Pin to older versions with ARM64 support:
"@ruvector/attention": "0.1.3", "@ruvector/gnn": "0.1.19"
- Use WASM packages if feature-compatible
- Use x86_64 emulation (slower)