mosaicstack/stack
1
0
Fork 0
Code Issues 13 Pull Requests Actions Packages Projects Releases 11 Wiki Activity

mosaic doctor fails with ERR_PACKAGE_PATH_NOT_EXPORTED fallback miss #383

New Issue
Closed
opened 2026-04-05 01:37:05 +00:00 by jason.woltje · 0 comments
jason.woltje commented 2026-04-05 01:37:05 +00:00
Owner
Copy Link

mosaic doctor (and all framework-delegated subcommands: init, upgrade, projects, orchestrator-*, etc.) fail on globally-installed CLI with:

[mosaic] Script not found: /home/jarvis/.config/mosaic/tools/_scripts/mosaic-doctor

Root cause

resolveTool() in packages/mosaic/src/commands/launch.ts calls req.resolve('@mosaic/mosaic/package.json') to locate the bundled framework/tools/ directory. The published package.json only exports the . subpath, so Node throws ERR_PACKAGE_PATH_NOT_EXPORTED. The bare catch {} swallows the error silently and falls back to $MOSAIC_HOME/tools/_scripts/…, which does not exist on the user's machine.

Fix

  • Resolve framework dir via fileURLToPath(import.meta.url) (exports-field independent)
  • Add ./package.json and ./framework/* subpath exports (belt-and-suspenders)
  • Bump @mosaic/mosaic 0.0.17 → 0.0.18

Branch: fix/mosaic-doctor-script-resolution

`mosaic doctor` (and all framework-delegated subcommands: init, upgrade, projects, orchestrator-*, etc.) fail on globally-installed CLI with: ``` [mosaic] Script not found: /home/jarvis/.config/mosaic/tools/_scripts/mosaic-doctor ``` ### Root cause `resolveTool()` in `packages/mosaic/src/commands/launch.ts` calls `req.resolve('@mosaic/mosaic/package.json')` to locate the bundled `framework/tools/` directory. The published `package.json` only exports the `.` subpath, so Node throws `ERR_PACKAGE_PATH_NOT_EXPORTED`. The bare `catch {}` swallows the error silently and falls back to `$MOSAIC_HOME/tools/_scripts/…`, which does not exist on the user's machine. ### Fix - Resolve framework dir via `fileURLToPath(import.meta.url)` (exports-field independent) - Add `./package.json` and `./framework/*` subpath exports (belt-and-suspenders) - Bump `@mosaic/mosaic` 0.0.17 → 0.0.18 Branch: `fix/mosaic-doctor-script-resolution`
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#383
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?