Skip to content

Linux ARM64 환경에서 oc CLI npm 설치본이 native bindings 누락으로 실행되지 않습니다 #31

@Nedian0Brien

Description

@Nedian0Brien

요약

npm install -g @aicontextlab/cli 로 설치한 OpenContext CLI가 Linux ARM64 환경에서 바로 실행되지 않습니다.

재현 환경

  • OS: Linux
  • Architecture: aarch64 / arm64
  • Node.js: v22.17.1
  • npm package:
    • @aicontextlab/cli@0.2.2
    • @aicontextlab/core-native@0.2.1

재현 절차

  1. npm install -g @aicontextlab/cli
  2. oc folder ls --all 또는 oc mcp 실행

실제 동작

아래와 같은 에러로 실행이 실패합니다.

Error: OpenContext native bindings not available.
Error (npm): Cannot find module '@aicontextlab/core-native-linux-arm64-gnu'

기대 동작

Linux ARM64 환경에서도 oc CLI와 oc mcp가 정상 실행되어야 합니다.

확인한 내용

  • @aicontextlab/core-native@0.2.1index.js 는 Linux ARM64에서 아래 패키지를 로드하려고 시도합니다.
    • @aicontextlab/core-native-linux-arm64-gnu
    • @aicontextlab/core-native-linux-arm64-musl
  • 하지만 실제 package.jsonoptionalDependencies에는 Linux ARM64 패키지가 없습니다.
  • npm registry에서도 @aicontextlab/core-native-linux-arm64-gnu 패키지는 조회되지 않았습니다.
  • 결과적으로 현재 npm 배포본만으로는 Linux ARM64에서 정상 설치가 불가능합니다.

임시 우회

소스에서 crates/opencontext-node를 직접 빌드한 뒤 생성된 opencontext-node.linux-arm64-gnu.node 파일을 글로벌 설치 경로의 @aicontextlab/core-native 디렉터리에 넣으면 동작은 복구됩니다.

제안

  • Linux ARM64 prebuilt 패키지를 실제로 publish 하거나
  • 최소한 optionalDependencies / 로더 분기 / 배포 아티팩트 구성을 일치시켜 주세요.

필요하시면 제가 확인한 npm 메타데이터와 재현 로그도 더 정리해 드릴 수 있습니다.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    Status
    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions