mulmoclaude 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# MulmoClaude
+
+Experience GUI-chat with Claude Code — and long-term memory!
+
+## Quick Start
+
+```bash
+# Prerequisites: Node.js 20+, Claude Code CLI
+npm install -g @anthropic-ai/claude-code
+claude auth login
+
+# Launch MulmoClaude
+npx mulmoclaude
+```
+
+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
+```
+
+## How it works
+
+The npm package ships with the pre-built client (Vite) and the server
+source — TypeScript, executed directly via `tsx`. No cloning, no
+build step for end users: `npx` downloads the package and starts the
+Express server.
+
+Your data lives in `~/mulmoclaude/` (created on first run).
+
+## For developers
+
+Publish flow and the full local-test recipe (prepare-dist,
+direct launch, curl checks, tarball simulation) live in the
+header comment of `bin/prepare-dist.js`.
+
+## License
+
+MIT

package/bin/mulmoclaude.js

@@ -0,0 +1,202 @@
+#!/usr/bin/env node
+
+// MulmoClaude launcher — `npx mulmoclaude` entry point.
+//
+// Ships with server source (TypeScript) + pre-built client (Vite).
+// Runs the server via tsx (TypeScript executor).
+
+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 { fileURLToPath } from "url";
+
+const require = createRequire(import.meta.url);
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_DIR = join(__dirname, "..");
+const SERVER_ENTRY = join(PKG_DIR, "server", "index.ts");
+const DEFAULT_PORT = 3001;
+
+// ── Helpers ─────────────────────────────────────────────────
+
+function log(msg) {
+  console.log(`\x1b[36m[mulmoclaude]\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.error(`\x1b[31m[mulmoclaude]\x1b[0m ${msg}`);
+}
+
+function checkClaude() {
+  try {
+    execSync("claude --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function pickOpenCommand() {
+  if (process.platform === "darwin") return "open";
+  if (process.platform === "win32") return "start";
+  return "xdg-open";
+}
+
+// Poll the server until it answers an HTTP request, then call `onReady`.
+// Gives up after ~15s so the launcher doesn't hang forever on a crash loop.
+function waitUntilReady(portNum, onReady) {
+  const startedAt = Date.now();
+  const timeoutMs = 15000;
+  const intervalMs = 300;
+
+  const attempt = () => {
+    const req = httpGet({ host: "127.0.0.1", port: portNum, path: "/", timeout: 1000 }, (res) => {
+      res.resume();
+      onReady();
+    });
+    req.on("error", retry);
+    req.on("timeout", () => {
+      req.destroy();
+      retry();
+    });
+  };
+
+  const retry = () => {
+    if (Date.now() - startedAt > timeoutMs) return;
+    setTimeout(attempt, intervalMs);
+  };
+
+  attempt();
+}
+
+function printReadyBanner(url) {
+  const bar = "─".repeat(50);
+  console.log("");
+  console.log(`\x1b[32m${bar}\x1b[0m`);
+  console.log(`\x1b[32m  ✓ MulmoClaude is ready\x1b[0m`);
+  console.log(`\x1b[32m  → ${url}\x1b[0m`);
+  console.log(`\x1b[32m  Press Ctrl+C to stop.\x1b[0m`);
+  console.log(`\x1b[32m${bar}\x1b[0m`);
+  console.log("");
+}
+
+// ── Parse args ──────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+  console.log(`
+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
+`);
+  process.exit(0);
+}
+
+if (args.includes("--version")) {
+  console.log("mulmoclaude 0.1.0");
+  process.exit(0);
+}
+
+const port = resolvePort();
+const noOpen = args.includes("--no-open");
+
+function resolvePort() {
+  const idx = args.indexOf("--port");
+  if (idx === -1) return DEFAULT_PORT;
+  const raw = args[idx + 1];
+  if (raw === undefined) {
+    error("--port requires a value (integer 1..65535)");
+    process.exit(1);
+  }
+  const parsed = Number.parseInt(raw, 10);
+  if (!Number.isInteger(parsed) || String(parsed) !== raw || parsed < 1 || parsed > 65535) {
+    error(`Invalid --port value: "${raw}" (expected integer 1..65535)`);
+    process.exit(1);
+  }
+  return parsed;
+}
+
+// ── Pre-flight checks ───────────────────────────────────────
+
+if (!checkClaude()) {
+  error("Claude Code CLI not found.");
+  error("");
+  error("Install it first:");
+  error("  npm install -g @anthropic-ai/claude-code");
+  error("  claude auth login");
+  error("");
+  error("Then try again: npx mulmoclaude");
+  process.exit(1);
+}
+
+log("Claude Code CLI ✓");
+
+if (!existsSync(SERVER_ENTRY)) {
+  error(`Server source not found at ${SERVER_ENTRY}`);
+  process.exit(1);
+}
+
+// ── Start server ────────────────────────────────────────────
+
+log(`Starting MulmoClaude on port ${port}...`);
+
+// Resolve tsx's CLI entry via Node's module resolution so this works
+// whether tsx is nested (`npx`/local install) or hoisted (`npm i -g`).
+// tsx doesn't export `./cli`, so locate via its package.json + `bin`.
+let tsxCli;
+try {
+  const tsxPkgJson = require.resolve("tsx/package.json");
+  const tsxPkg = require(tsxPkgJson);
+  tsxCli = join(dirname(tsxPkgJson), tsxPkg.bin);
+} catch {
+  error("Failed to locate 'tsx' — the package may be installed incorrectly.");
+  process.exit(1);
+}
+
+const server = spawn(process.execPath, [tsxCli, SERVER_ENTRY], {
+  cwd: PKG_DIR,
+  env: {
+    ...process.env,
+    NODE_ENV: "production",
+    PORT: String(port),
+  },
+  stdio: "inherit",
+});
+
+// Print a ready banner + optionally open the browser once the server
+// actually responds — not a fixed-delay timer, so the banner appears
+// right when the UI is reachable.
+const url = `http://localhost:${port}`;
+waitUntilReady(port, () => {
+  printReadyBanner(url);
+  if (noOpen) return;
+  const openCmd = pickOpenCommand();
+  try {
+    // openCmd is a hard-coded literal; url is http://localhost:<numeric-port>.
+    // eslint-disable-next-line sonarjs/os-command
+    execSync(`${openCmd} ${url}`, { stdio: "pipe" });
+  } catch {
+    log(`Open your browser: ${url}`);
+  }
+});
+
+// Graceful shutdown
+process.on("SIGINT", () => {
+  server.kill("SIGTERM");
+  process.exit(0);
+});
+
+process.on("SIGTERM", () => {
+  server.kill("SIGTERM");
+  process.exit(0);
+});
+
+server.on("exit", (code) => {
+  process.exit(code ?? 1);
+});

package/bin/prepare-dist.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+
+// Copies server source + client build + shared config into this
+// package so `npm publish` includes everything needed to run.
+//
+// ── Local test flow (before publishing) ───────────────────────
+// From the repo root:
+//
+//   yarn build                                       # 1. Vite build → dist/client/
+//   yarn install                                     # 2. brings in tsx (runtime)
+//   node packages/mulmoclaude/bin/prepare-dist.js    # 3. copy into this pkg
+//   node packages/mulmoclaude/bin/mulmoclaude.js --no-open --port 3099
+//
+// Expected: the launcher prints `[server] listening port=3099`.
+// Sanity-check from another shell:
+//
+//   curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3099/
+//     → 200  (index.html served with bearer token substituted)
+//   curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3099/api/config
+//     → 401  (protected API, expected without token)
+//
+// Stop: Ctrl+C, or `kill "$(lsof -ti:3099)"`.
+//
+// To test the exact published artifact end-to-end:
+//
+//   cd packages/mulmoclaude && npm pack        # → mulmoclaude-<ver>.tgz
+//   mkdir /tmp/mc-test && cd /tmp/mc-test
+//   npm init -y && npm install /abs/path/to/mulmoclaude-<ver>.tgz
+//   ./node_modules/.bin/mulmoclaude --no-open --port 3099
+//
+// ── Publish ───────────────────────────────────────────────────
+//   cd packages/mulmoclaude && npm publish --access public
+
+import { cpSync, existsSync, rmSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgDir = join(__dirname, "..");
+const rootDir = join(pkgDir, "..", "..");
+
+// ── Clean ───────────────────────────────────────────────────
+
+// Include `dist` so leftovers from the older pre-built-JS layout are
+// wiped on re-run.
+for (const dir of ["dist", "client", "server", "src"]) {
+  const target = join(pkgDir, dir);
+  if (existsSync(target)) rmSync(target, { recursive: true });
+}
+
+// ── Client dist (Vite build output) ─────────────────────────
+// Copied to `client/` (not `dist/client/`) so the server's
+// `path.join(__dirname, "../client")` resolves correctly when
+// tsx runs `server/index.ts` directly from this package.
+
+const clientDist = join(rootDir, "dist", "client");
+if (!existsSync(clientDist)) {
+  console.error("dist/client/ not found. Run `yarn build` first.");
+  process.exit(1);
+}
+cpSync(clientDist, join(pkgDir, "client"), { recursive: true });
+console.log("✓ client");
+
+// ── Server source (TypeScript — run via tsx) ────────────────
+
+cpSync(join(rootDir, "server"), join(pkgDir, "server"), {
+  recursive: true,
+  filter: (src) => {
+    if (src.includes("node_modules")) return false;
+    if (src.endsWith(".map")) return false;
+    if (src.endsWith(".log")) return false;
+    // Skip dev-only files: local logs dir, tsconfig used by repo's
+    // own `tsc -p server/tsconfig.json` (end users don't compile).
+    const tail = src.split("/").slice(-2).join("/");
+    if (tail === "server/logs" || src.endsWith("/server/logs")) return false;
+    if (src.endsWith("/tsconfig.json")) return false;
+    return true;
+  },
+});
+console.log("✓ server source");
+
+// ── Shared src/ (server imports from src/config, src/types,
+//    src/plugins, src/utils). Copy the whole tree — Vue files are
+//    ignored at runtime since the server never imports them.
+
+cpSync(join(rootDir, "src"), join(pkgDir, "src"), {
+  recursive: true,
+  filter: (src) => !src.endsWith(".map"),
+});
+console.log("✓ shared src/");
+
+console.log("\nReady to publish. Run:");
+console.log("  cd packages/mulmoclaude && npm publish --access public");

package/client/assets/chunk-vKJrgz-R-C_I3GbVV.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),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=Object.create,p=Object.defineProperty,m=Object.getOwnPropertyDescriptor,h=Object.getOwnPropertyNames,g=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty,v=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),y=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var i=h(t),a=0,o=i.length,s;a<o;a++)s=i[a],!_.call(e,s)&&s!==n&&p(e,s,{get:(e=>t[e]).bind(null,s),enumerable:!(r=m(t,s))||r.enumerable});return e},b=(e,t,n)=>(n=e==null?{}:f(g(e)),y(t||!e||!e.__esModule?p(n,`default`,{value:e,enumerable:!0}):n,e));export{c as a,o as i,v as n,d as o,s as r,u as s,b as t};