Printable idea sheet
published_host_native_install
reqlan rq/distribution/native_host_binary.rq:89
Katz 0.114
After a published install of `@reqlan/analytical`, the host platform package must resolve.
The host is `process.platform` and `process.arch` of the install process ( native_host_binary ).
Git `@reqlan/analytical` does not list `optionalDependencies`. The check exits 0 in this workspace.
The published tarball lists pinned optionalDependencies ( rust_binary_distribution ).
That tarball runs check-host-native.mjs as `postinstall`.
If the host package name is missing from `optionalDependencies`, or `createRequire` from `@reqlan/analytical/package.json` cannot resolve that package to a file, the script prints a warning and exits 0.
The warning text tells the user how to enable optional dependencies and how to limit pnpm to the host OS and CPU.
Do not use `--force`. `--force` installs every optional platform package.
Do not skip the script with `--ignore-scripts` on a published install.
CLI install documentation: README.template.md.
Implementation: check-host-native.mjs, package.json, README.template.md, README.template.md.
- status
- done
- todo
- postinstall warning is not covered by automated tests; package-manager optional install is not a reliable unit-test guarantee
Interactive page: published_host_native_install