gitwarren 0.1.10 → 0.1.11

package/README.md

@@ -61,6 +61,18 @@ The MCP server reads the same SQLite file the browser view does, so an agent
 can open and comment on reviews whether or not GitWarren is being served. What
 serving adds is that the links an agent hands you have something to open.
 
+On a machine where nothing has been installed, the same server starts by name:
+`npx gitwarren mcp`. That is the command a Claude Code plugin or an MCP registry
+entry names, and it is what makes either work before you have decided to keep
+GitWarren. It writes no launcher and asks for no login item; it reads the same
+database, so the reviews are there when you do.
+
+`npx gitwarren mcp --serve` also serves the review page, on loopback and for as
+long as the agent keeps the server running, so the links the agent hands out
+open even on a machine with nothing else installed. If GitWarren is already
+running, as the app or as `gitwarren serve`, it serves nothing and the links
+open there instead.
+
 ## Where your data is
 
 One SQLite database in the usual place for your platform —

package/lib/gitwarren.cjs

@@ -1,9 +1,10 @@
 "use strict";
-const Client = require("better-sqlite3");
-const crypto$1 = require("node:crypto");
+const node_module = require("node:module");
 const fs = require("node:fs");
-const node_os = require("node:os");
 const node_path = require("node:path");
+const node_os = require("node:os");
+const Client = require("better-sqlite3");
+const crypto$1 = require("node:crypto");
 const node_child_process = require("node:child_process");
 const node_stream = require("node:stream");
 const require$$0$3 = require("events");
@@ -23,6 +24,99 @@ const node_util = require("node:util");
 const node_url = require("node:url");
 const node_http = require("node:http");
 var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
+const INSTANCE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+function isInstanceId(value) {
+  return INSTANCE_ID_PATTERN.test(value);
+}
+const APP_DIR_NAME = "GitWarren";
+const DATABASE_FILE_NAME = "gitwarren.db";
+const INSTANCE_FILE_NAME = "instance-id";
+const DATA_DIR_ENV_VAR = "GITWARREN_DATA_DIR";
+function getDataDirectory() {
+  const override = process.env[DATA_DIR_ENV_VAR]?.trim();
+  if (override) return override;
+  switch (process.platform) {
+    case "win32":
+      return node_path.join(process.env.APPDATA ?? node_path.join(node_os.homedir(), "AppData", "Roaming"), APP_DIR_NAME);
+    case "darwin":
+      return node_path.join(node_os.homedir(), "Library", "Application Support", APP_DIR_NAME);
+    default:
+      return node_path.join(process.env.XDG_CONFIG_HOME ?? node_path.join(node_os.homedir(), ".config"), APP_DIR_NAME);
+  }
+}
+function getDatabasePath() {
+  return node_path.join(getDataDirectory(), DATABASE_FILE_NAME);
+}
+function getInstanceIdPath() {
+  return node_path.join(getDataDirectory(), INSTANCE_FILE_NAME);
+}
+function ensureDataDirectory() {
+  const dir = getDataDirectory();
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+const DAEMON_CACHE_DIR_NAME = "daemon-cache";
+function getDaemonCacheDirectory() {
+  return node_path.join(getDataDirectory(), DAEMON_CACHE_DIR_NAME);
+}
+const RUNTIME_FILE_NAME = "daemon-runtime.json";
+const LEGACY_FILE_NAME = "gui-runtime.json";
+function getDaemonRuntimePath() {
+  return node_path.join(getDataDirectory(), RUNTIME_FILE_NAME);
+}
+function writeDaemonRuntime(runtime) {
+  try {
+    ensureDataDirectory();
+    const merged = { ...runtime, webRoot: runtime.webRoot ?? exposure };
+    published = merged;
+    fs.writeFileSync(getDaemonRuntimePath(), JSON.stringify(merged), "utf8");
+    fs.rmSync(node_path.join(getDataDirectory(), LEGACY_FILE_NAME), { force: true });
+  } catch (error2) {
+    console.error("[runtime] could not publish the runtime file", error2);
+  }
+}
+function clearDaemonRuntime() {
+  published = null;
+  exposure = null;
+  try {
+    fs.rmSync(getDaemonRuntimePath(), { force: true });
+  } catch (error2) {
+    console.error("[runtime] could not remove the runtime file", error2);
+  }
+}
+let published = null;
+let exposure = null;
+function writeDaemonExposure(webRoot) {
+  exposure = webRoot;
+  if (!published) return;
+  if ((published.webRoot ?? null) === webRoot) return;
+  writeDaemonRuntime({ ...published, webRoot });
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readLiveDaemonRuntime() {
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(getDaemonRuntimePath(), "utf8"));
+  } catch {
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null) return null;
+  const { instanceId, pid, linkPort, owner, webRoot } = parsed;
+  if (typeof instanceId !== "string" || !isInstanceId(instanceId)) return null;
+  if (!Number.isInteger(pid) || pid === void 0 || pid <= 0) return null;
+  if (owner !== "gui" && owner !== "daemon") return null;
+  const port = linkPort === null ? null : Number.isInteger(linkPort) && linkPort !== void 0 && linkPort > 0 && linkPort <= 65535 ? linkPort : void 0;
+  if (port === void 0) return null;
+  const root = typeof webRoot === "string" ? webRoot : null;
+  return isAlive(pid) ? { instanceId, pid, linkPort: port, owner, webRoot: root } : null;
+}
 const entityKind = /* @__PURE__ */ Symbol.for("drizzle:entityKind");
 function is(value, type) {
   if (!value || typeof value !== "object") {
@@ -4871,37 +4965,6 @@ function migrate(db, config2) {
   const migrations = readMigrationFiles(config2);
   db.dialect.migrate(migrations, db.session, config2);
 }
-const APP_DIR_NAME = "GitWarren";
-const DATABASE_FILE_NAME = "gitwarren.db";
-const INSTANCE_FILE_NAME = "instance-id";
-const DATA_DIR_ENV_VAR = "GITWARREN_DATA_DIR";
-function getDataDirectory() {
-  const override = process.env[DATA_DIR_ENV_VAR]?.trim();
-  if (override) return override;
-  switch (process.platform) {
-    case "win32":
-      return node_path.join(process.env.APPDATA ?? node_path.join(node_os.homedir(), "AppData", "Roaming"), APP_DIR_NAME);
-    case "darwin":
-      return node_path.join(node_os.homedir(), "Library", "Application Support", APP_DIR_NAME);
-    default:
-      return node_path.join(process.env.XDG_CONFIG_HOME ?? node_path.join(node_os.homedir(), ".config"), APP_DIR_NAME);
-  }
-}
-function getDatabasePath() {
-  return node_path.join(getDataDirectory(), DATABASE_FILE_NAME);
-}
-function getInstanceIdPath() {
-  return node_path.join(getDataDirectory(), INSTANCE_FILE_NAME);
-}
-function ensureDataDirectory() {
-  const dir = getDataDirectory();
-  fs.mkdirSync(dir, { recursive: true });
-  return dir;
-}
-const DAEMON_CACHE_DIR_NAME = "daemon-cache";
-function getDaemonCacheDirectory() {
-  return node_path.join(getDataDirectory(), DAEMON_CACHE_DIR_NAME);
-}
 const MIGRATIONS_DIR_ENV_VAR = "GITWARREN_MIGRATIONS_DIR";
 function isMigrationsFolder(candidate) {
   return fs.existsSync(node_path.join(candidate, "meta", "_journal.json"));
@@ -5295,10 +5358,6 @@ const schema = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProper
   reviewedFiles,
   reviews
 }, Symbol.toStringTag, { value: "Module" }));
-const INSTANCE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
-function isInstanceId(value) {
-  return INSTANCE_ID_PATTERN.test(value);
-}
 let cached$2 = null;
 function readExisting() {
   try {
@@ -10242,7 +10301,7 @@ function cmdQuote(value) {
   if (value.includes('"')) throw new Error(`a Windows path cannot contain a quote: ${value}`);
   return `"${value}"`;
 }
-const APP_VERSION = "0.1.10";
+const APP_VERSION = "0.1.11";
 const REMOTE_ROOT = "$HOME/.gitwarren";
 const runOnHost = (route2, options) => {
   switch (route2.kind) {
@@ -10498,64 +10557,6 @@ async function unserveTailnet(port) {
   await tailscale(["serve", "--http", String(port), "off"], SERVE_TIMEOUT_MS);
   return await tailnetServeOrigin(port) !== null;
 }
-const RUNTIME_FILE_NAME = "daemon-runtime.json";
-const LEGACY_FILE_NAME = "gui-runtime.json";
-function getDaemonRuntimePath() {
-  return node_path.join(getDataDirectory(), RUNTIME_FILE_NAME);
-}
-function writeDaemonRuntime(runtime) {
-  try {
-    ensureDataDirectory();
-    const merged = { ...runtime, webRoot: runtime.webRoot ?? exposure };
-    published = merged;
-    fs.writeFileSync(getDaemonRuntimePath(), JSON.stringify(merged), "utf8");
-    fs.rmSync(node_path.join(getDataDirectory(), LEGACY_FILE_NAME), { force: true });
-  } catch (error2) {
-    console.error("[runtime] could not publish the runtime file", error2);
-  }
-}
-function clearDaemonRuntime() {
-  published = null;
-  exposure = null;
-  try {
-    fs.rmSync(getDaemonRuntimePath(), { force: true });
-  } catch (error2) {
-    console.error("[runtime] could not remove the runtime file", error2);
-  }
-}
-let published = null;
-let exposure = null;
-function writeDaemonExposure(webRoot) {
-  exposure = webRoot;
-  if (!published) return;
-  if ((published.webRoot ?? null) === webRoot) return;
-  writeDaemonRuntime({ ...published, webRoot });
-}
-function isAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function readLiveDaemonRuntime() {
-  let parsed;
-  try {
-    parsed = JSON.parse(fs.readFileSync(getDaemonRuntimePath(), "utf8"));
-  } catch {
-    return null;
-  }
-  if (typeof parsed !== "object" || parsed === null) return null;
-  const { instanceId, pid, linkPort, owner, webRoot } = parsed;
-  if (typeof instanceId !== "string" || !isInstanceId(instanceId)) return null;
-  if (!Number.isInteger(pid) || pid === void 0 || pid <= 0) return null;
-  if (owner !== "gui" && owner !== "daemon") return null;
-  const port = linkPort === null ? null : Number.isInteger(linkPort) && linkPort !== void 0 && linkPort > 0 && linkPort <= 65535 ? linkPort : void 0;
-  if (port === void 0) return null;
-  const root = typeof webRoot === "string" ? webRoot : null;
-  return isAlive(pid) ? { instanceId, pid, linkPort: port, owner, webRoot: root } : null;
-}
 const UNAVAILABLE = {
   available: false,
   dnsName: null,
@@ -26868,7 +26869,7 @@ Connection: close\r
     }
   };
 }
-const VERSION$1 = "0.1.10";
+const VERSION$1 = "0.1.11";
 function isWebBuild(directory) {
   return fs.existsSync(node_path.join(directory, "index.html")) && !fs.existsSync(node_path.join(directory, "main.ts"));
 }
@@ -26971,6 +26972,11 @@ function runListen(hooks = {}) {
       owner: "daemon"
     });
     const url = `http://${LINK_SERVER_HOST}:${LINK_SERVER_PORT}/?${TOKEN_PARAM}=${token}`;
+    if (hooks.brief) {
+      console.error(`[gitwarren] serving the review page at ${url}`);
+      hooks.onListening?.(url);
+      return;
+    }
     console.error(
       `[gitwarren] GitWarren is running at
 
@@ -27087,17 +27093,21 @@ function findMcpServer(script) {
   }
   return null;
 }
-function describeSelf() {
+function resolveScript() {
   const argv1 = process.argv[1];
-  let script = null;
-  if (argv1 !== void 0) {
-    try {
-      const resolved2 = fs.realpathSync(argv1);
-      script = /\.[cm]?ts$/i.test(resolved2) ? null : resolved2;
-    } catch {
-      script = null;
-    }
+  if (argv1 === void 0) return null;
+  try {
+    const resolved2 = fs.realpathSync(argv1);
+    return /\.[cm]?ts$/i.test(resolved2) ? null : resolved2;
+  } catch {
+    return null;
   }
+}
+function locateMcpServer() {
+  return findMcpServer(resolveScript());
+}
+function describeSelf() {
+  const script = resolveScript();
   return { node: fs.realpathSync(process.execPath), script, mcpServer: findMcpServer(script), env: relaunchEnv() };
 }
 const BANNER = (what) => [
@@ -27609,7 +27619,7 @@ function runService(argv) {
     return true;
   }
 }
-const VERSION = "0.1.10";
+const VERSION = "0.1.11";
 const USAGE = `gitwarren - code review for your own git repositories, in a browser tab
 
 Run it now
@@ -27626,6 +27636,8 @@ Keep it running
 Let a coding agent in
   gitwarren agent-setup          print the one sentence to give an agent so it can
                                  reach this GitWarren over MCP
+  gitwarren mcp [--serve]        run the MCP server itself, on stdin/stdout - what
+                                 \`npx gitwarren mcp\` in an agent's config starts
 
   gitwarren serve --stdio        answer GitWarren's protocol on stdin/stdout (this
                                  is what another machine's GitWarren spawns)
@@ -27652,6 +27664,22 @@ a URL that carries this launch's token. Ctrl-C stops it.
 Serving also writes ~/.gitwarren/bin/gitwarren-mcp, the command a coding agent
 starts the MCP server with - see \`gitwarren agent-setup\`.
 `;
+const MCP_USAGE = `gitwarren mcp [--serve]
+
+Runs GitWarren's MCP server, speaking MCP over stdin and stdout. This is for an
+agent to run, not a person: it is the same server ~/.gitwarren/bin/gitwarren-mcp
+starts, reachable by name so that an agent's config can say \`npx gitwarren mcp\`
+on a machine where GitWarren was never installed.
+
+It reads the same SQLite file the app and \`gitwarren serve\` do, so reviews an
+agent makes this way are there the moment a person opens GitWarren to look.
+
+  --serve   also serve the review page on 127.0.0.1 for as long as the agent
+            keeps this running, unless a GitWarren is already running on this
+            machine - then links open there and this serves nothing. This is
+            what a plugin asks for, so the links its agent hands out open on a
+            machine with nothing else installed.
+`;
 function afterListening(url, open2) {
   const launchers = ensureLaunchers();
   if (launchers.refused) {
@@ -27667,6 +27695,51 @@ function afterListening(url, open2) {
     openInBrowser(url, (message) => console.error(`[gitwarren] ${message}. The URL is above.`));
   }
 }
+function runMcp(argv) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(MCP_USAGE);
+    return true;
+  }
+  if (argv.some((argument) => argument !== "--serve")) {
+    console.error(MCP_USAGE);
+    return false;
+  }
+  const server = locateMcpServer();
+  if (!server) {
+    console.error(
+      "[gitwarren] this install has no MCP server bundle next to it. From a checkout, run `npm run build:mcp` first, or use `npm run mcp:dev`."
+    );
+    return false;
+  }
+  process.removeAllListeners("SIGINT");
+  process.removeAllListeners("SIGTERM");
+  if (argv.includes("--serve")) serveBesideMcp();
+  node_module.createRequire(server)(server);
+  return true;
+}
+function serveBesideMcp() {
+  const owner = readLiveDaemonRuntime();
+  if (owner) {
+    console.error(
+      `[gitwarren] GitWarren is already running on this machine as ${owner.owner === "gui" ? "the desktop app" : "a server"}; links will open there.`
+    );
+    return;
+  }
+  if (!runDaemon(["--listen"], { brief: true })) {
+    process.exitCode = void 0;
+    console.error(
+      "[gitwarren] the review page could not be served, so links will not open until a GitWarren is started on this machine. The MCP server is running regardless."
+    );
+    return;
+  }
+  const release = () => shutdownListen();
+  process.on("SIGINT", release);
+  process.on("SIGTERM", release);
+  process.stdin.once("end", () => {
+    shutdownListen();
+    process.exit(0);
+  });
+}
 function runCli(argv) {
   const [command, ...rest] = argv;
   switch (command) {
@@ -27684,6 +27757,8 @@ function runCli(argv) {
       return runService(rest);
     case "agent-setup":
       return runAgentSetup(rest);
+    case "mcp":
+      return runMcp(rest);
     case "--version":
     case "-v":
       console.log(VERSION);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitwarren",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Code review for your own machines and your own agents, served on loopback. No Electron, no account.",
   "keywords": ["code-review", "git", "diff", "mcp", "local-first", "ssh", "wsl", "tailscale", "self-hosted"],
   "homepage": "https://github.com/klarluft/gitwarren-app",