npm install -g creates broken symlink — binary is notion-bin but package.json references bin/notion

[xuelongmu]

After installing globally with npm install -g @4ier/notion-cli, the notion command is not found despite the package installing successfully.

Expected behavior: After running npm install -g @4ier/notion-cli, the notion command should be available globally.

Actual behavior: The notion command is not found. npm creates a symlink pointing to bin/notion, which doesn't exist. The actual binary is named bin/notion-bin.

Root cause: The bin field in package.json points to bin/notion, but the actual binary in the package is bin/notion-bin. This results in a dangling symlink:

$ ls -la ~/.nvm/versions/node/v24.13.0/bin/notion
lrwxrwxrwx 1 ubuntu ubuntu 47 Apr  5 22:48 notion -> ../lib/node_modules/@4ier/notion-cli/bin/notion

$ ls ~/.nvm/versions/node/v24.13.0/lib/node_modules/@4ier/notion-cli/bin/
notion-bin
notion.cmd

Fix: Either rename bin/notion-bin to bin/notion in the package, or update the bin field in package.json to point to bin/notion-bin.

Environment:

• Node: v24.13.0 (via nvm)
• OS: Ubuntu (Linux)

[4ier]

Thanks for the detailed report @xuelongmu — you nailed the root cause.

What happened: The postinstall script extracts the Go binary (named notion) from the goreleaser tarball directly into bin/, which overwrites the shell wrapper script (bin/notion, 143 bytes). It then renames the binary to bin/notion-bin, but at that point the wrapper is already gone. npm's global symlink points to the now-missing bin/notion → broken.

Fix: Extract to a temporary directory (bin/_tmp_extract/) first, then rename to bin/notion-bin. The wrapper script stays intact.

Published as v0.3.1:

npm install -g @4ier/notion-cli@0.3.1

[xuelongmu]

Thanks for making the fix, however 0.3.1 is not a valid release in the repo :)

npm error path /home/ubuntu/.nvm/versions/node/v24.13.0/lib/node_modules/@4ier/notion-cli
npm error command failed
npm error command sh -c node install.js
npm error Downloading notion-cli v0.3.1 for linux/arm64...
npm error Failed to install notion-cli: Download failed: 404 https://github.com/4ier/notion-cli/releases/download/v0.3.1/notion-cli_0.3.1_linux_arm64.tar.gz
npm error You can install manually from https://github.com/4ier/notion-cli/releases