ruvnet / ruvnet/agentic-flow

agentic-jujutsu@2.3.6 fails on macOS arm64: missing native package

Open
#159 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
812
Forks
175
Avg merge
2m
Merged PRs (30d)
3

Description

Summary

Installing agentic-jujutsu@2.3.6 globally on macOS Apple Silicon succeeds, but running jj-agent fails because the package tries to require a missing native dependency:

Error: Cannot find module 'agentic-jujutsu-darwin-arm64'

Environment

  • OS: macOS
  • Architecture: arm64 / Apple Silicon
  • Node: v24.15.0
  • Package manager: npm via Volta
  • Package: agentic-jujutsu@2.3.6

Reproduction

npm install -g agentic-jujutsu
exec zsh
jj-agent

Actual result

Error: Cannot find module 'agentic-jujutsu-darwin-arm64'
Require stack:
- .../agentic-jujutsu/index.js
- .../agentic-jujutsu/bin/cli.js

Expected result

jj-agent should start successfully on macOS arm64.

Investigation

The generated N-API loader attempts to load agentic-jujutsu-darwin-arm64 for process.platform === 'darwin' and process.arch === 'arm64'.

However, the published package metadata for agentic-jujutsu@2.3.6 only lists these optional dependencies:

{
  agentic-jujutsu-win32-x64-msvc: 2.3.6,
  agentic-jujutsu-darwin-x64: 2.3.6,
  agentic-jujutsu-linux-x64-gnu: 2.3.6,
  agentic-jujutsu-linux-x64-musl: 2.3.6,
  agentic-jujutsu-linux-arm64-musl: 2.3.6,
  agentic-jujutsu-linux-arm-gnueabihf: 2.3.6
}

There is no agentic-jujutsu-darwin-arm64 package published to npm, and agentic-jujutsu-darwin-universal also appears to be unpublished.

Additionally, the installed package included agentic-jujutsu.linux-x64-gnu.node inside the main package tarball, which appears incorrect for a macOS install.

Workaround

I cloned the upstream repository, built the package locally on macOS arm64 with:

npm install
npm run build

inside packages/agentic-jujutsu, then copied the generated agentic-jujutsu.darwin-arm64.node into the installed global package directory. After that, jj-agent version worked correctly.

Possible fix

Publish one of the following native packages for version 2.3.6:

  • agentic-jujutsu-darwin-arm64
  • or agentic-jujutsu-darwin-universal

and include it in optionalDependencies.

Alternatively, ensure the main npm tarball includes the correct macOS ARM .node file when publishing.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in packages/agentic-jujutsu and inspect the generated loader, package metadata, and npm publishing configuration alongside index.js and bin/cli.js. Reproduce the macOS arm64 install, verify the native package or .node file is published and listed as an optional dependency, and confirm that jj-agent starts successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos, node.js, typescript
Domain
build-system, cli, release
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.