Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[Bug]: Source build on non-NTFS/cloud-synced Windows volumes fails cryptically (pnpm workspace links need junctions)

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#299 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
84/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
node.js, typescript
Lĩnh vực
build-system, documentation

Hướng nghiên cứu

Bắt đầu với docs/installation.md và phần “Build from source” trong README. Ghi lại rằng các checkout trên Windows phải nằm trên một volume NTFS cục bộ vì các liên kết workspace của pnpm yêu cầu junctions, đồng thời đề cập đến lỗi cài đặt tương ứng trên các volume được đồng bộ với đám mây, FAT32, exFAT hoặc volume mạng. Hoàn tất khi cả hai điểm bắt đầu build từ mã nguồn đều nêu rõ yêu cầu và cách khắc phục.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug cli documentation needs-triage

Issue 2 — Document the local-NTFS requirement for Windows source checkouts

Template: Bug report → Product: Source build or repository tooling (docs gap + cryptic failure)

Title:
[Bug]: Source build: pnpm install fails cryptically on non-NTFS / cloud-synced Windows volumes — workspace links need junctions; requirement is undocumented

Product or interface

Source build or repository tooling

Version

Source @ ae65651 (0.5.1). Node.js v24.18.0, pnpm 9.12.0. Windows 11 x64 (build 26200).

Platform

Windows

Steps to reproduce
  1. Clone the repository onto a volume that is not a local NTFS disk — in this case a Google Drive desktop-mirrored volume that reports FAT32 (fsutil fsinfo volumeinfo G: → File system name: FAT32, volume name "Google Drive"). Network shares and exFAT USB drives behave the same way.
  2. npx [email protected] install --frozen-lockfile
Expected and actual behavior

Expected: either the install succeeds, or it fails with a message explaining that pnpm workspace links require junctions and therefore a local NTFS volume.

Actual: the install downloads and links ~530 packages, then aborts during linking of the vendored workspace dependency with a bare ENOENT stack that never mentions symlinks, junctions, or the filesystem:

ENOENT: no such file or directory, stat 'G:\…\minimax-code\third_party\pi-mono\packages\agent\node_modules\@earendil-works\pi-ai'
    at async Object.stat (node:internal/fs/promises:1038:18)
    at async renameOverwrite (…/pnpm/dist/pnpm.cjs:54992:15)
    at async forceSymlink (…/pnpm/dist/pnpm.cjs:103483:11)
    at async symlinkDirectRootDependency (…/pnpm/dist/pnpm.cjs:143278:26)

The failure leaves an empty …\agent\node_modules\@earendil-works\ directory behind. Rerunning reproduces the identical failure.

Root cause: the root .npmrc sets node-linker=hoisted, so regular dependencies are copied and work fine, but workspace:* links (e.g. @earendil-works/pi-ai in third_party/pi-mono/packages/agent) still require a filesystem junction/symlink. Junctions cannot exist on FAT32/exFAT/cloud-mirrored or network volumes — mklink /J fails with "Local NTFS volumes are required to complete this operation".

Verification of the diagnosis: the same commit cloned to a local NTFS drive installs cleanly (25 s), builds (10.5 s), and passes typecheck, check:source, check:tsconfig, test:smoke, test:byok, test:status-contract.

Suggested fix
  1. Document the requirement in docs/installation.md (and the README "Build from source" section): the checkout must live on a local NTFS volume on Windows; cloud-synced or FAT32/exFAT locations fail during pnpm install at the workspace-link stage. This is especially relevant because "Desktop" folders are commonly redirected to Google Drive/OneDrive on Windows machines.
  2. Optionally, fail fast with a clear message: a small preflight (install script or docs CI check) that detects a non-NTFS/non-local checkout root on Windows and prints "clone to a local NTFS drive" instead of the raw pnpm ENOENT stack.
Redacted error summary
npx [email protected] install --frozen-lockfile
…
ENOENT: no such file or directory, stat '…\third_party\pi-mono\packages\agent\node_modules\@earendil-works\pi-ai'
    at async renameOverwrite / forceSymlink / symlinkDirectRootDependency

cmd> mklink /J …\pi-ai …\ai
Local NTFS volumes are required to complete this operation.
Before submitting
  • I have searched existing issues.
  • I have included my version and removed sensitive information.
Ngôn ngữ chính
TypeScript
Star
2k
Fork
250
Merge trung bình
7 giờ 37 phút
Pull request đã merge (30 ngày)
147

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của MiniMax-AI/minimax-code

Tất cả issue của MiniMax-AI/minimax-code

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.