v0.2.6

A patch release focused on lockfile compatibility — most notably reading legacy npm lockfiles — plus a Homebrew install-path fix.

Lockfile compatibility

Nub now reads the legacy npm lockfile formats it previously refused: package-lock.json with lockfileVersion: 1 (npm 5/6), and pre-2017 npm-shrinkwrap.json (a nested dependencies tree with no lockfileVersion field). The legacy nested tree is lifted into the same install-path scheme Nub uses for v2/v3, so registry dependencies resolve and install; the first mutating operation (nub add, nub remove) rewrites the lock as v3, the same in-place upgrade npm 7+ performs. Two edges remain out of scope — git and file: deps a v1 lock encodes in version rather than resolved, and fully-hoisted pre-npm-5 shrinkwraps with no requires edges (Nub installs what it can and warns about the rest). (#212)

Three smaller compatibility fixes ship alongside it:

Area	What changed	PR
Bun lockfile	The Bun reader accepts lockfileVersion: 2 — forward-compat for the unreleased Bun 1.4; released Bun still writes v1.	#210
Lockfile ambiguity	The multiple-lockfiles ambiguity guard no longer trips on global-scope read commands.	#199
Config migration	The nub pm use nub config-migration precedence is now pnpm-major-aware.	#211

Distribution

The Homebrew formula installs nub/nubx from the stripped working directory instead of a bin/ subpath. (#209, closes #208)

Documentation & site

• Documented the legacy npm-lockfile reader on the npm install page (75ee80d4).
• Docs prose measure capped at 720px and the star-nudge styling softened (5aeb8aad, d7d6c26a).
• The GitHub pill's hover accent scoped to its star and border (ddbeb18c, acd08db4).

Commits in this release

• site: soften docs star nudge color, point arrow at link bottom-middle (d7d6c26a)
• site: cap docs prose measure at 720px (was ~116 chars/line) (5aeb8aad)
• fix(pm): scope lockfile-ambiguity guard off global-scope read commands (#199, a31ec221)
• site: make the GitHub pill's star the sole ember hover accent (ddbeb18c)
• site: make the GitHub pill's border the sole ember hover accent (acd08db4)
• site: wrap docs code blocks instead of horizontal-scrolling (d0562a21)
• Revert "site: wrap docs code blocks instead of horizontal-scrolling" (e561ad59)
• fix(lockfile): accept bun lockfileVersion 2 in the bun reader (#210, 15b0ee2d)
• fix(homebrew): install nub/nubx from stripped cwd, not bin/ subpath (#209, 2273e592)
• fix(pm): make nub pm use nub config-migration precedence pnpm-major-aware (#211, 8518c670)
• feat(lockfile): read legacy npm lockfiles (lockfileVersion 1 + pre-2017 shrinkwrap) (#212, f9bbf30b)
• docs(install/npm): document the legacy npm-lockfile reader (#212, 75ee80d4)
• v0.2.6 (d8a5499b)

Full Changelog: v0.2.5...v0.2.6