Global bin wrapper fails on linuxbrew/Node 25: hardcoded dist path MODULE_NOT_FOUND

[blb-pieter]

Linuxbrew/Node 25 Global Install Fix

Problem

On linuxbrew (Homebrew on Linux) with Node 25+, the global npm bin wrapper for qmd hardcodes a wrong path:

Error:

Error: Cannot find module '/home/linuxbrew/.linuxbrew/dist/cli/qmd.js'

Repro:

1. npm install -g @tobilu/qmd@2.0.0
2. qmd --version → MODULE_NOT_FOUND

Cause: npm generates bin/qmd as exec node '/home/linuxbrew/.linuxbrew/dist/cli/qmd.js' "$@", but actual module is in lib/node_modules/@tobilu/qmd/dist/cli/qmd.js (no dist/ symlink).

npx works fine.

Workaround

alias qmd='npx @tobilu/qmd@2.0.0'

Proposed Fix

Add this postinstall script to package.json:

{
  "scripts": {
    "postinstall": "node -e \"const fs = require('fs'); const prefix = require('npm-prefix')(); const binPath = `${prefix}/bin/qmd`; const modPath = `${prefix}/lib/node_modules/@tobilu/qmd/dist/cli/qmd.js`; const content = `#!/usr/bin/env node\\nrequire('${modPath}');`; fs.writeFileSync(binPath, content); fs.chmodSync(binPath, 0o755);\""
  }
}

[tobi]

Closing as part of the post-v2.5.1 backlog cleanup: this item is over two months old and has either been superseded by newer QMD releases or is too stale to keep actionable. If it still reproduces on v2.5.1 or newer, please open a fresh focused issue with current repro steps.