fix(mosaic): resolve framework scripts via import.meta.url #385
Assignees
jason.woltje
Clear assignees
jason.woltje
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: mosaicstack/stack#385
Reference in New Issue
Block a user
Delete Branch "fix/mosaic-doctor-script-resolution"
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?
Fixes #383. Root cause: resolveTool() used req.resolve('@mosaic/mosaic/package.json') but published exports only has '.', causing ERR_PACKAGE_PATH_NOT_EXPORTED. Catch swallowed it and fell back to non-existent MOSAIC_HOME path. Fix: fileURLToPath(import.meta.url) + add package.json/framework subpath exports + bump to 0.0.18.
Previously, resolveTool() used createRequire + req.resolve('@mosaic/mosaic/package.json') to locate the bundled framework directory. The published package.json only exports the root '.' subpath, so Node throws ERR_PACKAGE_PATH_NOT_EXPORTED for './package.json'. The catch block silently swallowed this error and fell through to the MOSAIC_HOME fallback path (~/.config/mosaic/tools/_scripts/mosaic-doctor), which does not exist on a user's machine, causing every framework-delegated subcommand (doctor, coord, etc.) to fail with '[mosaic] Script not found'. Two-layer fix: 1. Replace the createRequire approach with import.meta.url-based resolution. The built file lives at dist/commands/launch.js, so ../../framework/tools/... always resolves to the bundled framework directory regardless of how the package exports field is configured. This is layout-stable for both the published package and local dev. 2. Add './package.json' and './framework/*' subpath exports to package.json as belt-and- suspenders, keeping subpath access working for any future caller. Bump version to 0.0.18. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>