v0.2.3: fix pnpm exec design-loop ERR_MODULE_NOT_FOUND on github: install

Reported by a first-time user after a fresh `pnpm add github:...` install:
`pnpm exec design-loop --help` crashed with ERR_MODULE_NOT_FOUND. The
workaround was `node node_modules/@ekolabs/.../dist/cli.js`. Root cause:

pnpm's `github:` install layout encodes the commit SHA in the directory
name as a `#<sha>` suffix (e.g. `.../claude-design-loop.git#ca4380c_<hash>/`).
The bin shim was passing a raw absolute filesystem path to `await import()`.
Node converts that to a `file://` URL internally and treats the `#` as a
URL fragment — truncating the path mid-way through node_modules and
throwing ERR_MODULE_NOT_FOUND.

Fix: route the dynamic import through `pathToFileURL(dist).href` so `#`
(and any other special chars, e.g. spaces on Windows) are properly
percent-encoded into a valid file URL.

`config.ts` already does this correctly when loading the consumer's
config — the bug was only in the bin entry point. Affected every
consumer using `pnpm exec design-loop`, `pnpm design`, or any
pnpm-driven invocation of the bin. npm / direct-`node` invocations
were unaffected.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: talzu

CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-05-15
+
+### Fixed
+- **`pnpm exec design-loop` crashed with `ERR_MODULE_NOT_FOUND` after a
+  fresh `github:` install.** pnpm's git-install layout puts the commit
+  SHA in the directory name (e.g. `.../claude-design-loop.git#<sha>/`).
+  The bin shim was passing a raw absolute path to `await import()`,
+  which Node converts to a `file://` URL — and treats the `#` as a URL
+  fragment, truncating the path. Now goes through `pathToFileURL` so
+  `#` (and any other special chars, e.g. spaces on Windows) are
+  properly percent-encoded. Affected every consumer using
+  `pnpm exec design-loop`, `pnpm design`, or any pnpm-driven invocation
+  of the bin. `node node_modules/@ekolabs/.../dist/cli.js` was the
+  workaround. npm / direct-`node` invocations were unaffected.
+
 ### Changed
 - README: clarified that `pnpm install` / `npm install` does NOT
   re-fetch the latest commit when tracking `main`, because lockfiles

bin/design-loop.js

@@ -1,7 +1,16 @@
 #!/usr/bin/env node
 // Thin shim: import the built CLI from dist/. tsup emits ESM with a top-level
 // program.parseAsync() that runs on import, so a bare import is enough.
-import { fileURLToPath } from 'node:url';
+//
+// IMPORTANT: pnpm's `github:` install layout puts a `#<sha>` segment in the
+// `node_modules/.pnpm/...` directory name (e.g. `...claude-design-loop.git
+// #ca4380c_<hash>/...`). When passing a raw filesystem path to `await
+// import()`, Node converts it to a `file://` URL and treats the `#` as a
+// URL fragment — truncating the path mid-way and throwing
+// `ERR_MODULE_NOT_FOUND`. Always go through `pathToFileURL` so the `#`
+// (and any other special chars, e.g. spaces on Windows) are properly
+// percent-encoded.
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { dirname, resolve } from 'node:path';
 import { existsSync } from 'node:fs';
 
@@ -15,4 +24,4 @@ if (!existsSync(dist)) {
   process.exit(1);
 }
 
-await import(dist);
+await import(pathToFileURL(dist).href);

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekolabs/claude-design-loop",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Round-trip design loop between your IDE and claude.ai/design. Capture a route, send a brief, iterate visually with Claude, fetch the handoff bundle, translate it into framework-native scaffolds, and verify the result.",
   "license": "SEE LICENSE IN LICENSE",
   "private": false,

src/cli.ts

@@ -67,7 +67,7 @@ const program = new Command();
 program
   .name('design-loop')
   .description('Round-trip design loop between your IDE and claude.ai/design')
-  .version('0.2.2');
+  .version('0.2.3');
 
 // Default action: when no subcommand is supplied, drop into the wizard.
 program