Skip to content

docs: warn about npm install caveats#368

Merged
jdx merged 1 commit intomainfrom
codex/docs-npm-install-warning
Apr 28, 2026
Merged

docs: warn about npm install caveats#368
jdx merged 1 commit intomainfrom
codex/docs-npm-install-warning

Conversation

@jdx
Copy link
Copy Markdown
Contributor

@jdx jdx commented Apr 28, 2026

Summary

  • Add an installation-page warning that the npm package depends on lifecycle scripts and can fail to expose commands when scripts are disabled or PowerShell blocks npm.ps1.
  • Add a mise tip explaining why it remains the recommended path and how to enable idiomatic Node version files with idiomatic_version_file_enable_tools.
  • Mirror the npm caveat and mise Node-version note in the README install section.

Validation

  • git diff --check
  • npm.cmd run docs:build (fails before docs render: active toolchain is rustc 1.88.0-beta.3, but aube-settings requires rustc 1.93)

Note

Low Risk
Low risk documentation-only changes; no product logic is modified, but incorrect guidance could impact install success for npm users.

Overview
Updates the install docs to further recommend mise by calling out Node runtime/version-file management, including the mise settings add idiomatic_version_file_enable_tools node guidance.

Clarifies npm install caveats by switching examples to pass --ignore-scripts=false and adding warnings that the npm package depends on its preinstall lifecycle script to fetch the native binary and wire up aube/aubr/aubx commands (mirrored in both README.md and docs/installation.md).

Reviewed by Cursor Bugbot for commit c2fa685. Bugbot is set up for automated code reviews on this repo. Configure here.

@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Apr 28, 2026

Greptile Summary

Documentation-only PR that adds install caveats for the npm path (--ignore-scripts=false flag, lifecycle-script dependency, native-binary wiring) and a mise tip about managing project Node versions via idiomatic version files. Changes are mirrored consistently between README.md and docs/installation.md.

Confidence Score: 5/5

Safe to merge — documentation-only changes with no code or runtime impact.

All changes are prose and markdown. The only finding is a P2 suggestion to add a Windows/PowerShell note that was mentioned in the PR description but omitted from the actual warning block.

No files require special attention.

Important Files Changed

Filename Overview
docs/installation.md Updated npm warning to describe lifecycle-script dependency and native-binary wiring; added mise tip about Node version-file support. Minor: Windows/PowerShell caveat mentioned in PR description is absent from the warning block.
README.md Added mise Node-version tip and updated npm install section to include --ignore-scripts=false and prose explanation. Mirrors docs/installation.md changes cleanly.

Fix All in Claude Code

Reviews (5): Last reviewed commit: "docs: warn about npm install caveats" | Re-trigger Greptile

@jdx jdx force-pushed the codex/docs-npm-install-warning branch 9 times, most recently from af38965 to c2fa685 Compare April 28, 2026 19:22
@jdx jdx enabled auto-merge (squash) April 28, 2026 19:29
@jdx jdx merged commit 3980ff3 into main Apr 28, 2026
17 checks passed
@jdx jdx deleted the codex/docs-npm-install-warning branch April 28, 2026 19:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant