@cookielab.io/klovi 0.10.5 → 0.11.0

package/README.md

@@ -31,6 +31,13 @@ bun install -g @cookielab.io/klovi
 klovi
 ```
 
+Or install via [Homebrew](https://brew.sh) (no runtime dependency):
+
+```bash
+brew install cookielab/tap/klovi
+klovi
+```
+
 Open http://localhost:3583
 
 ### Development

package/dist/server.js

@@ -3,10 +3,13 @@ import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // index.ts
-import { existsSync as existsSync2, readSync } from "node:fs";
+import { existsSync as existsSync2 } from "node:fs";
 import { dirname, join as join4 } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// src/server/cli.ts
+import { readSync } from "node:fs";
+
 // src/server/parser/claude-dir.ts
 import { readdir, readFile, stat } from "node:fs/promises";
 import { join as join2 } from "node:path";
@@ -499,8 +502,8 @@ async function handleSubAgent(sessionId, agentId, encodedPath) {
 
 // src/server/version.ts
 var appVersion = {
-  version: "0.10.5",
-  commitHash: "e60d690"
+  version: "0.11.0",
+  commitHash: "45bb1d6"
 };
 
 // src/server/api/version.ts
@@ -508,6 +511,109 @@ function handleVersion() {
   return Response.json(appVersion);
 }
 
+// src/server/cli.ts
+function parseCliArgs(argv) {
+  const portIdx = argv.indexOf("--port");
+  let port = 3583;
+  if (portIdx !== -1) {
+    const val = argv[portIdx + 1];
+    if (!val || val.startsWith("-")) {
+      console.error("Error: --port requires a number argument.");
+      process.exit(1);
+    }
+    port = Number.parseInt(val, 10);
+    if (Number.isNaN(port) || port < 1 || port > 65535) {
+      console.error("Error: --port must be a valid port number (1-65535).");
+      process.exit(1);
+    }
+  }
+  const acceptRisks = argv.includes("--accept-risks");
+  const showHelp = argv.includes("--help") || argv.includes("-h");
+  const projectsDirIdx = argv.indexOf("--projects-dir");
+  if (projectsDirIdx !== -1) {
+    const dir = argv[projectsDirIdx + 1];
+    if (!dir || dir.startsWith("-")) {
+      console.error("Error: --projects-dir requires a path argument.");
+      process.exit(1);
+    }
+    setProjectsDir(dir);
+  }
+  return { port, acceptRisks, showHelp };
+}
+function showHelpText() {
+  console.log(`
+Klovi — a web viewer for Claude Code sessions
+
+Usage:
+  klovi [options]
+
+Options:
+  --accept-risks           Skip the startup security warning
+  --port <number>          Server port (default: 3583)
+  --projects-dir <path>    Override the Claude projects directory
+  -h, --help               Show this help message
+
+The server runs on http://localhost:3583 by default.
+`);
+}
+function promptSecurityWarning(port) {
+  const resolvedDir = getProjectsDir();
+  const yellow = "\x1B[33m";
+  const bold = "\x1B[1m";
+  const reset = "\x1B[0m";
+  const dim = "\x1B[2m";
+  console.log("");
+  console.log(`${yellow}${bold}  ⚠  WARNING${reset}`);
+  console.log("");
+  console.log(`  Klovi reads Claude Code session history from ${resolvedDir}.`);
+  console.log("  Session data may contain sensitive information such as API keys,");
+  console.log("  credentials, or private code snippets.");
+  console.log("");
+  console.log(`  The server will expose this data on ${bold}http://localhost:${port}${reset}.`);
+  console.log("");
+  console.log(`  ${dim}To skip this prompt, pass --accept-risks${reset}`);
+  console.log("");
+  process.stdout.write("  Continue? (y/N) ");
+  const buf = Buffer.alloc(1024);
+  const bytesRead = readSync(0, buf, 0, 1024, null);
+  const answer = buf.toString("utf-8", 0, bytesRead).trim().toLowerCase();
+  if (answer !== "y" && answer !== "yes") {
+    console.log("  Aborted.");
+    process.exit(0);
+  }
+  console.log("");
+}
+function createRoutes() {
+  return [
+    { pattern: "/api/version", handler: () => handleVersion() },
+    { pattern: "/api/projects", handler: () => handleProjects() },
+    {
+      pattern: "/api/projects/:encodedPath/sessions",
+      handler: (_req, p) => handleSessions(p.encodedPath)
+    },
+    {
+      pattern: "/api/sessions/:sessionId",
+      handler: (req, p) => {
+        const project = new URL(req.url).searchParams.get("project");
+        if (!project) {
+          return Response.json({ error: "project query parameter required" }, { status: 400 });
+        }
+        return handleSession(p.sessionId, project);
+      }
+    },
+    {
+      pattern: "/api/sessions/:sessionId/subagents/:agentId",
+      handler: (req, p) => {
+        const project = new URL(req.url).searchParams.get("project");
+        if (!project) {
+          return Response.json({ error: "project query parameter required" }, { status: 400 });
+        }
+        return handleSubAgent(p.sessionId, p.agentId, project);
+      }
+    }
+  ];
+}
+
 // src/server/http.ts
 import { existsSync } from "node:fs";
 import { readFile as readFile2 } from "node:fs/promises";
@@ -568,30 +674,53 @@ async function serveStatic(pathname, staticDir) {
     return null;
   }
 }
-function startServer(port, routes, staticDir) {
-  const hasStaticDir = existsSync(staticDir);
+function serveEmbedded(pathname, assets) {
+  const key = pathname === "/" ? "index.html" : pathname.slice(1);
+  const asset = assets.get(key);
+  if (asset) {
+    return new Response(asset.data.buffer, {
+      headers: { "content-type": asset.contentType }
+    });
+  }
+  if (!extname(pathname)) {
+    const index = assets.get("index.html");
+    if (index) {
+      return new Response(index.data.buffer, {
+        headers: { "content-type": "text/html; charset=utf-8" }
+      });
+    }
+  }
+  return null;
+}
+async function handleRequest(pathname, url, method, routes, staticDir, hasStaticDir, embeddedAssets) {
+  for (const route of routes) {
+    const params = matchRoute(route.pattern, pathname);
+    if (params !== null) {
+      const webReq = new Request(url.toString(), { method });
+      return route.handler(webReq, params);
+    }
+  }
+  if (embeddedAssets) {
+    const response = serveEmbedded(pathname, embeddedAssets);
+    if (response)
+      return response;
+  } else if (hasStaticDir) {
+    const response = await serveStatic(pathname, staticDir);
+    if (response)
+      return response;
+  }
+  return new Response("Not Found", {
+    status: 404,
+    headers: { "content-type": "text/plain" }
+  });
+}
+function startServer(port, routes, staticDir, embeddedAssets) {
+  const hasStaticDir = !embeddedAssets && existsSync(staticDir);
   const server = createServer(async (req, res) => {
     try {
       const url = new URL(req.url, `http://${req.headers.host || "localhost"}`);
-      const pathname = url.pathname;
-      for (const route of routes) {
-        const params = matchRoute(route.pattern, pathname);
-        if (params !== null) {
-          const webReq = new Request(url.toString(), { method: req.method });
-          const response = await route.handler(webReq, params);
-          await writeResponse(res, response);
-          return;
-        }
-      }
-      if (hasStaticDir) {
-        const response = await serveStatic(pathname, staticDir);
-        if (response) {
-          await writeResponse(res, response);
-          return;
-        }
-      }
-      res.writeHead(404, { "content-type": "text/plain" });
-      res.end("Not Found");
+      const response = await handleRequest(url.pathname, url, req.method, routes, staticDir, hasStaticDir, embeddedAssets);
+      await writeResponse(res, response);
     } catch (err) {
       console.error("Request error:", err);
       res.writeHead(500, { "content-type": "text/plain" });
@@ -611,47 +740,11 @@ async function writeResponse(res, webResponse) {
 }
 
 // index.ts
-var portIdx = process.argv.indexOf("--port");
-var port = 3583;
-if (portIdx !== -1) {
-  const val = process.argv[portIdx + 1];
-  if (!val || val.startsWith("-")) {
-    console.error("Error: --port requires a number argument.");
-    process.exit(1);
-  }
-  port = Number.parseInt(val, 10);
-  if (Number.isNaN(port) || port < 1 || port > 65535) {
-    console.error("Error: --port must be a valid port number (1-65535).");
-    process.exit(1);
-  }
-}
-var acceptRisks = process.argv.includes("--accept-risks");
-if (process.argv.includes("--help") || process.argv.includes("-h")) {
-  console.log(`
-Klovi — a web viewer for Claude Code sessions
-
-Usage:
-  klovi [options]
-
-Options:
-  --accept-risks           Skip the startup security warning
-  --port <number>          Server port (default: 3583)
-  --projects-dir <path>    Override the Claude projects directory
-  -h, --help               Show this help message
-
-The server runs on http://localhost:3583 by default.
-`);
+var { port, acceptRisks, showHelp } = parseCliArgs(process.argv);
+if (showHelp) {
+  showHelpText();
   process.exit(0);
 }
-var projectsDirIdx = process.argv.indexOf("--projects-dir");
-if (projectsDirIdx !== -1) {
-  const dir = process.argv[projectsDirIdx + 1];
-  if (!dir || dir.startsWith("-")) {
-    console.error("Error: --projects-dir requires a path argument.");
-    process.exit(1);
-  }
-  setProjectsDir(dir);
-}
 var resolvedDir = getProjectsDir();
 if (!existsSync2(resolvedDir)) {
   console.error(`Error: projects directory not found: ${resolvedDir}`);
@@ -659,59 +752,9 @@ if (!existsSync2(resolvedDir)) {
   process.exit(1);
 }
 if (!acceptRisks) {
-  const yellow = "\x1B[33m";
-  const bold = "\x1B[1m";
-  const reset = "\x1B[0m";
-  const dim = "\x1B[2m";
-  console.log("");
-  console.log(`${yellow}${bold}  ⚠  WARNING${reset}`);
-  console.log("");
-  console.log(`  Klovi reads Claude Code session history from ${resolvedDir}.`);
-  console.log("  Session data may contain sensitive information such as API keys,");
-  console.log("  credentials, or private code snippets.");
-  console.log("");
-  console.log(`  The server will expose this data on ${bold}http://localhost:${port}${reset}.`);
-  console.log("");
-  console.log(`  ${dim}To skip this prompt, pass --accept-risks${reset}`);
-  console.log("");
-  process.stdout.write("  Continue? (y/N) ");
-  const buf = Buffer.alloc(1024);
-  const bytesRead = readSync(0, buf, 0, 1024, null);
-  const answer = buf.toString("utf-8", 0, bytesRead).trim().toLowerCase();
-  if (answer !== "y" && answer !== "yes") {
-    console.log("  Aborted.");
-    process.exit(0);
-  }
-  console.log("");
+  promptSecurityWarning(port);
 }
 var __dirname2 = dirname(fileURLToPath(import.meta.url));
 var staticDir = existsSync2(join4(__dirname2, "public", "index.html")) ? join4(__dirname2, "public") : join4(__dirname2, "dist", "public");
-startServer(port, [
-  { pattern: "/api/version", handler: () => handleVersion() },
-  { pattern: "/api/projects", handler: () => handleProjects() },
-  {
-    pattern: "/api/projects/:encodedPath/sessions",
-    handler: (_req, p) => handleSessions(p.encodedPath)
-  },
-  {
-    pattern: "/api/sessions/:sessionId",
-    handler: (req, p) => {
-      const project = new URL(req.url).searchParams.get("project");
-      if (!project) {
-        return Response.json({ error: "project query parameter required" }, { status: 400 });
-      }
-      return handleSession(p.sessionId, project);
-    }
-  },
-  {
-    pattern: "/api/sessions/:sessionId/subagents/:agentId",
-    handler: (req, p) => {
-      const project = new URL(req.url).searchParams.get("project");
-      if (!project) {
-        return Response.json({ error: "project query parameter required" }, { status: 400 });
-      }
-      return handleSubAgent(p.sessionId, p.agentId, project);
-    }
-  }
-], staticDir);
+startServer(port, createRoutes(), staticDir);
 console.log(`Klovi running at http://localhost:${port}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cookielab.io/klovi",
-  "version": "0.10.5",
+  "version": "0.11.0",
   "description": "A local web app for browsing and presenting Claude Code session history",
   "module": "index.ts",
   "type": "module",
@@ -41,6 +41,7 @@
     "build": "bun run build:frontend && bun run build:server",
     "build:frontend": "rm -rf dist/public && bun build ./index.html --outdir dist/public",
     "build:server": "bun scripts/build-server.ts",
+    "build:compile": "bun scripts/build-compile.ts",
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "lint": "bunx biome lint .",