v3.0.1

release: v3.0.1 (#75)

release: v3.0.1 (#75)

Release: v3.0.1 — Patch: Resolver Fix, CI Hardening, and Resilient Build Pipeline

🐛 BUG FIX — RESOLVE-FROM-CALLER: CALLER index.mjs NO LONGER TREATED AS INTERNAL
• Fix #isSlothletInternal() incorrectly treating any file named index.mjs or index.cjs as an internal Slothlet frame, regardless of location
• Root cause: bare path.basename() check had no location guard — a user entry point named index.mjs matched the same condition as the package root index.mjs
• Fix: add SLOTHLET_PKG_ROOT constant (__dirname + ../../..) and scope the basename check to only match files whose parent directory equals the package root
• Add regression fixture tests/vitests/suites/helpers/fixtures/index.mjs and two new tests to resolve-from-caller-paths.test.vitest.mjs covering both the correct resolution target and the directory name
• All 21 resolve-from-caller tests pass

🔧 CI HARDENING — SLOTHLET-DEV CONDITION STRIPPING
• Fix buildTestNodeEnv() in test-conditional.mjs using exact token equality (token !== "--conditions=slothlet-dev") to strip the custom export condition from NODE_OPTIONS
• Exact match silently failed for compound conditions (--conditions=slothlet-dev,other) and space-separated form (--conditions slothlet-dev), leaving slothlet-dev active in the post-build node test environment and causing Cannot find module '.../src/slothlet.mjs' errors after ci:cleanup-src
• Fix: replace with a full token-aware parser that handles both --conditions=VALUE and --conditions VALUE forms, stripping any comma-delimited component equal to slothlet-dev
• Fix: replace || undefined fallback (serialized as the string "undefined" by Node 16's child_process.spawn) with delete env.NODE_OPTIONS

🔧 CI HARDENING — RUN-ALL-TESTS RESPAWN RACE CONDITION
• Fix run-all-tests.mjs calling if (ensureDevEnvFlags()) process.exit() to handle the respawn-with-slothlet-dev case — the parent exited immediately before the child finished, silently discarding the child's real exit code and masking test failures
• Fix: restructure to if (!ensureDevEnvFlags()) { runAllTests(); } — parent stays alive, stdio streams directly to terminal, child.on("exit", code => process.exit(code)) propagates the real exit code

🛠️ BUILD PIPELINE — RESILIENT DIST COPY
• Fix build:dist crashing with cp: no such file or directory: src/* when ci:cleanup-src had already run — raw shx cp -r src/* dist/ errors out if src/ is absent
• New tools/build/build-dist.mjs: uses fs.cpSync (Node 16.7+), exits cleanly with a warning when src/ is not found rather than crashing the build pipeline
• package.json build:dist script updated to node tools/build/build-dist.mjs

Technical Implementation:

• SLOTHLET_PKG_ROOT = path.normalize(path.resolve(__dirname, "../../..")) added to resolve-from-caller.mjs; #isSlothletInternal() basename check now only fires when the file's parent directory equals SLOTHLET_PKG_ROOT
• buildTestNodeEnv() token loop: splits each NODE_OPTIONS token on =, inspects value component for comma-delimited conditions, reconstructs token without slothlet-dev; handles both --conditions=a,b and --conditions a forms
• run-all-tests.mjs control flow inversion: ensureDevEnvFlags() returns true when the environment is already correct, false when a respawn was initiated; runAllTests() only called when true
• build-dist.mjs uses existsSync guard before fs.cpSync, exits 0 with a console warning when src/ is absent

Testing Coverage:
Two new regression tests cover the resolve-from-caller fix directly: one asserts the resolved path equals the fixture's own directory (not process.cwd()), the second asserts the path contains "fixtures". Full suite of 21 tests passes. CI hardening changes verified against existing matrix test runs.

Files Changed: 10 files — 240 insertions, 30 deletions

package-lock.json                                                      |  4 +-
package.json                                                           | 12 +--
src/lib/helpers/resolve-from-caller.mjs                                | 19 ++-
tests/run-all-tests.mjs                                                | 15 ++-
tests/test-conditional.mjs                                             | 54 +++-
tests/vitests/suites/helpers/fixtures/index.mjs                        | 55 +++ (new)
tests/vitests/suites/helpers/resolve-from-caller-paths.test.vitest.mjs | 36 +++ (new)
tools/build/build-dist.mjs                                             | 72 +++ (new)
types/src/lib/helpers/resolve-from-caller.d.mts.map                    |  2 +-

Full Changelog: v3.0.0...v3.0.1

👥 Contributors

• @Shinrai