mulmoclaude 0.5.3 → 0.6.0

package/README.md

@@ -18,12 +18,25 @@ Your browser opens to `http://localhost:3001`. That's it.
 ## Options
 
 ```
-npx mulmoclaude              # Default (port 3001, opens browser)
-npx mulmoclaude --port 8080  # Custom port
-npx mulmoclaude --no-open    # Don't open browser
-npx mulmoclaude --version    # Show version
+npx mulmoclaude                              # Default (port 3001, opens browser)
+npx mulmoclaude --port 8080                  # Custom port
+npx mulmoclaude --no-open                    # Don't open browser
+npx mulmoclaude --dev-plugin ./my-plugin     # Load a plugin from a local
+                                             # project dir (repeatable;
+                                             # path can be relative or absolute)
+npx mulmoclaude --version                    # Show version
 ```
 
+`--dev-plugin <path>` is the plugin author's dev loop. Pair with
+`yarn dev` (vite watch) in the plugin directory: edits → vite
+rebuilds `dist/` → **the browser auto-reloads** via a debounced
+watcher on the plugin's `dist/`. The plugin's `package.json` name +
+`dist/index.js` must already be in place; the launcher refuses to
+start on missing files or on a name collision with an already-
+installed plugin. Server-side `definePlugin` factory edits still
+require a launcher restart (Node ESM has no cache invalidation API);
+the launcher log explicitly says so when `dist/index.js` changes.
+
 ## How it works
 
 The npm package ships with the pre-built client (Vite) and the server

package/bin/mulmoclaude.js

@@ -9,13 +9,14 @@ import { execSync, spawn } from "child_process";
 import { existsSync } from "fs";
 import { get as httpGet } from "http";
 import { createRequire } from "module";
-import { join, dirname } from "path";
+import { join, dirname, delimiter as PATH_DELIMITER } from "path";
 import { fileURLToPath } from "url";
 
 // Shared with `server/index.ts` — the launcher and the dev server use
 // the same probe + fallback logic. See server/utils/port.mjs for why
 // it's plain JS rather than TypeScript.
 import { isPortFree, findAvailablePort, MAX_PORT_PROBES } from "../server/utils/port.mjs";
+import { parseDevPluginArgs } from "../server/utils/dev-plugin-args.mjs";
 
 const require = createRequire(import.meta.url);
 
@@ -56,7 +57,11 @@ function waitUntilReady(portNum, onReady) {
   const timeoutMs = 15000;
   const intervalMs = 300;
 
-  const attempt = () => {
+  // `function` declarations (not arrow consts) so the mutual
+  // reference between `attempt` and `retry` works without TDZ
+  // ordering problems. Both forms are hoisted to the top of the
+  // enclosing function scope.
+  function attempt() {
     const req = httpGet({ host: "127.0.0.1", port: portNum, path: "/", timeout: 1000 }, (res) => {
       res.resume();
       onReady();
@@ -66,12 +71,12 @@ function waitUntilReady(portNum, onReady) {
       req.destroy();
       retry();
     });
-  };
+  }
 
-  const retry = () => {
+  function retry() {
     if (Date.now() - startedAt > timeoutMs) return;
     setTimeout(attempt, intervalMs);
-  };
+  }
 
   attempt();
 }
@@ -95,21 +100,38 @@ if (args.includes("--help") || args.includes("-h")) {
 Usage: npx mulmoclaude [options]
 
 Options:
-  --port <number>   Server port (default: ${DEFAULT_PORT})
-  --no-open         Don't open browser automatically
-  --version         Show version
-  --help            Show this help
+  --port <number>      Server port (default: ${DEFAULT_PORT})
+  --no-open            Don't open browser automatically
+  --dev-plugin <path>  Load a plugin from a local project dir for development
+                       (repeatable). Path can be absolute or relative to cwd.
+                       The dir must have package.json and dist/index.js
+                       (run \`yarn build\` or \`yarn dev\` in the plugin first).
+  --version            Show version
+  --help               Show this help
 `);
   process.exit(0);
 }
 
 if (args.includes("--version")) {
-  console.log("mulmoclaude 0.5.3");
+  console.log("mulmoclaude 0.6.0");
   process.exit(0);
 }
 
 const { requestedPort, portExplicit } = parsePortArg();
 const noOpen = args.includes("--no-open");
+const devPluginPaths = resolveDevPluginPaths();
+
+function resolveDevPluginPaths() {
+  const result = parseDevPluginArgs(args, process.cwd());
+  if (!result.ok) {
+    error(result.reason);
+    process.exit(1);
+  }
+  for (const { rawInput, absPath } of result.resolved) {
+    log(`[dev-plugin] ${rawInput} → ${absPath}`);
+  }
+  return result.resolved.map((entry) => entry.absPath);
+}
 
 function parsePortArg() {
   const idx = args.indexOf("--port");
@@ -180,6 +202,10 @@ log(`Starting MulmoClaude on port ${port}...`);
 let tsxCli;
 try {
   const tsxPkgJson = require.resolve("tsx/package.json");
+  // Path is the resolved location of tsx's own package.json under
+  // node_modules — not user-influenced, so the dynamic require is
+  // safe. require.resolve already validated the path.
+  // eslint-disable-next-line security/detect-non-literal-require -- resolved package.json path from require.resolve, not user input
   const tsxPkg = require(tsxPkgJson);
   tsxCli = join(dirname(tsxPkgJson), tsxPkg.bin);
 } catch {
@@ -187,13 +213,18 @@ try {
   process.exit(1);
 }
 
+const serverEnv = {
+  ...process.env,
+  NODE_ENV: "production",
+  PORT: String(port),
+};
+if (devPluginPaths.length > 0) {
+  serverEnv.MULMOCLAUDE_DEV_PLUGINS = devPluginPaths.join(PATH_DELIMITER);
+}
+
 const server = spawn(process.execPath, [tsxCli, SERVER_ENTRY], {
   cwd: PKG_DIR,
-  env: {
-    ...process.env,
-    NODE_ENV: "production",
-    PORT: String(port),
-  },
+  env: serverEnv,
   stdio: "inherit",
 });
 

package/client/assets/chunk-CernVdwh.js

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(e&&(t=e(e=0)),t),s=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),c=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r},l=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},u=(n,r,a)=>(a=n==null?{}:e(i(n)),l(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n)),d=e=>a.call(e,`module.exports`)?e[`module.exports`]:l(t({},`__esModule`,{value:!0}),e),f=(e=>typeof require<`u`?require:typeof Proxy<`u`?new Proxy(e,{get:(e,t)=>(typeof require<`u`?require:e)[t]}):e)(function(e){if(typeof require<`u`)return require.apply(this,arguments);throw Error('Calling `require` for "'+e+"\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.")});export{d as a,f as i,o as n,u as o,c as r,s as t};

package/client/assets/chunk-D8eiyYIV-C1eAZMzz.js

@@ -0,0 +1 @@
+import"./chunk-CernVdwh.js";var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),s=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},c=(n,r,a)=>(a=n==null?{}:e(i(n)),s(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));export{o as n,c as t};