kojee-mcp 0.4.0 → 0.5.0

package/dist/cli.js

@@ -1,18 +1,22 @@
 #!/usr/bin/env node
 import {
   AuthModule,
+  VERSION,
   startProxy
-} from "./chunk-ZGVUM4AG.js";
+} from "./chunk-LCFCCWMM.js";
+import "./chunk-QB22PD6T.js";
+import "./chunk-E26AHU6J.js";
+import "./chunk-BJMASMKX.js";
 import {
   loadPairedConfig,
   pairedConfigPath,
   savePairedConfig
-} from "./chunk-E7TE4QZD.js";
-import "./chunk-36DMIXH7.js";
+} from "./chunk-GBOTBYEP.js";
 
 // src/cli.ts
 import { Command } from "commander";
 import crypto from "crypto";
+import os from "os";
 import path from "path";
 
 // src/tandem/pair.ts
@@ -55,7 +59,7 @@ async function runPair(opts) {
 }
 
 // src/cli.ts
-var KOJEE_DIR = path.join(process.env["HOME"] ?? "~", ".kojee");
+var KOJEE_DIR = path.join(os.homedir(), ".kojee");
 function deriveKeystorePath(token) {
   const hash = crypto.createHash("sha256").update(token).digest("hex").slice(0, 12);
   return path.join(KOJEE_DIR, `keypair-${hash}.json`);
@@ -65,7 +69,7 @@ function defaultPairedKeystorePath() {
 }
 var program = new Command().name("kojee-mcp").description(
   "Local MCP proxy for Kojee \u2014 handles DPoP auth, tool discovery, and governance transparently"
-).version("0.3.0").enablePositionalOptions();
+).version(VERSION).enablePositionalOptions();
 program.command("pair <code>").description("Pair this machine against Kojee using a pair code from the dashboard").requiredOption("--url <url>", "Broker base URL (e.g. https://rosie-server.kojee.net)").option("--keystore-path <path>", "Path to keypair.json (default ~/.kojee/keypair.json)").action(async (code, opts) => {
   const url = opts.url.replace(/\/+$/, "");
   const keystorePath = opts.keystorePath ?? defaultPairedKeystorePath();
@@ -80,11 +84,11 @@ program.command("pair <code>").description("Pair this machine against Kojee usin
 });
 program.command("hook").description("Run a kojee MCP hook script (called by Claude Code via ~/.claude/settings.json)").requiredOption("--type <type>", "Hook type: stop or user-prompt-submit").action(async (opts) => {
   if (opts.type === "stop") {
-    const { runStopHook } = await import("./stop-hook-5XU3EQAE.js");
+    const { runStopHook } = await import("./stop-hook-VLQS6QPR.js");
     await runStopHook();
     process.exit(0);
   } else if (opts.type === "user-prompt-submit") {
-    const { runUserPromptSubmitHook } = await import("./user-prompt-submit-hook-WSRIJVF4.js");
+    const { runUserPromptSubmitHook } = await import("./user-prompt-submit-hook-C42DPDBO.js");
     await runUserPromptSubmitHook();
     process.exit(0);
   } else {
@@ -93,7 +97,7 @@ program.command("hook").description("Run a kojee MCP hook script (called by Clau
   }
 });
 program.command("install-hooks").description("Install kojee Stop + UserPromptSubmit hooks in ~/.claude/settings.json (idempotent)").option("--hooks-path <path>", "Override default ~/.claude/settings.json").option("--uninstall", "Remove kojee hook entries instead of installing them").action(async (opts) => {
-  const { installHooks, uninstallHooks } = await import("./install-WV25CRU2.js");
+  const { installHooks, uninstallHooks } = await import("./install-D2HIPOMT.js");
   if (opts.uninstall) {
     const removed = uninstallHooks({ hooksPath: opts.hooksPath });
     console.error(removed ? "Removed kojee hook entries." : "No kojee hook entries found.");
@@ -107,13 +111,27 @@ Restart Claude Code for hooks to take effect.`
     );
   }
 });
+program.command("tail <path>").description("Stream a file's contents and follow appends (portable replacement for `tail -F`)").action(async (filePath) => {
+  const { runTail } = await import("./tail-stream-UZ42UIWO.js");
+  try {
+    await runTail(filePath);
+  } catch (err) {
+    console.error("[kojee-mcp tail] Error:", err.message);
+    process.exit(1);
+  }
+});
+program.command("doctor").description("Diagnose the kojee wake path (proxy, hook-server, SSE stream, event log, Monitor) and print the exact wake recipe").action(async () => {
+  const { runDoctor } = await import("./doctor-GILTOH2R.js");
+  const code = await runDoctor();
+  process.exit(code);
+});
 program.command("init").description("Install kojee into Claude Code (MCP server entry + hooks). Run after `kojee-mcp pair`.").option("--config-path <path>", "Override default ~/.claude.json").option("--uninstall", "Remove the kojee MCP server entry and hooks").action(async (opts) => {
-  const { loadPairedConfig: loadPairedConfig2 } = await import("./paired-config-OAR3O3XY.js");
+  const { loadPairedConfig: loadPairedConfig2 } = await import("./paired-config-RB4SABOS.js");
   if (loadPairedConfig2() === null && !opts.uninstall) {
     console.error("Not paired. Run `kojee-mcp pair <code> --url <broker>` first, then re-run `init`.");
     process.exit(1);
   }
-  const { runInit, runUninstall } = await import("./install-WV25CRU2.js");
+  const { runInit, runUninstall } = await import("./install-D2HIPOMT.js");
   if (opts.uninstall) {
     const report = runUninstall({ configPath: opts.configPath });
     console.error(formatUninstall(report));
@@ -192,7 +210,7 @@ program.option("--token <token>", "Gateway token (for token-mode)").option("--ur
     url = url.replace(/\/+$/, "");
     keystorePath ??= deriveKeystorePath(token);
   } else {
-    const { loadPairedConfig: loadPairedConfig2 } = await import("./paired-config-OAR3O3XY.js");
+    const { loadPairedConfig: loadPairedConfig2 } = await import("./paired-config-RB4SABOS.js");
     const cfg = loadPairedConfig2();
     if (!cfg) {
       console.error(

package/dist/doctor-GILTOH2R.js

@@ -0,0 +1,222 @@
+import {
+  buildMonitorSpawn,
+  buildReplyRecipe
+} from "./chunk-E26AHU6J.js";
+import {
+  deriveDiscoveryKey,
+  findClaudeAncestorPid
+} from "./chunk-BJMASMKX.js";
+import {
+  monitorHeartbeatPath,
+  statusLogPath
+} from "./chunk-VLZADEFC.js";
+import {
+  discoveryPathForKey,
+  readSessionDiscoveryByKey
+} from "./chunk-W6YRLSD4.js";
+import {
+  loadPairedConfig
+} from "./chunk-GBOTBYEP.js";
+
+// src/doctor.ts
+import fs from "fs";
+function defaultIsPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    if (err.code === "EPERM") return true;
+    return false;
+  }
+}
+function defaultStat(path) {
+  try {
+    const s = fs.statSync(path);
+    return { mtimeMs: s.mtimeMs, size: s.size };
+  } catch {
+    return null;
+  }
+}
+var STATUS_TAIL_BYTES = 64 * 1024;
+function defaultReadLastStatusLine(path) {
+  let fd = null;
+  try {
+    const { size } = fs.statSync(path);
+    const start = Math.max(0, size - STATUS_TAIL_BYTES);
+    const len = size - start;
+    if (len === 0) return null;
+    fd = fs.openSync(path, "r");
+    const buf = Buffer.alloc(len);
+    fs.readSync(fd, buf, 0, len, start);
+    const text = buf.toString("utf8");
+    const statusLines = text.split("\n").filter((l) => l.includes("kojee-status"));
+    return statusLines.length > 0 ? statusLines[statusLines.length - 1] : null;
+  } catch {
+    return null;
+  } finally {
+    if (fd !== null) {
+      try {
+        fs.closeSync(fd);
+      } catch {
+      }
+    }
+  }
+}
+async function collectDoctorReport(deps = {}) {
+  const fetchFn = deps.fetchFn ?? fetch;
+  const isPidAlive = deps.isPidAlive ?? defaultIsPidAlive;
+  const statFile = deps.statFile ?? defaultStat;
+  const readLastStatusLine = deps.readLastStatusLine ?? defaultReadLastStatusLine;
+  const readDiscovery = deps.readDiscovery ?? readSessionDiscoveryByKey;
+  const projectDir = deps.projectDir ?? process.env["CLAUDE_PROJECT_DIR"];
+  const ccPid = deps.ccPid !== void 0 ? deps.ccPid : await findClaudeAncestorPid();
+  const discoveryKey = deriveDiscoveryKey(projectDir, ccPid);
+  const discoveryPath = discoveryPathForKey(discoveryKey);
+  const checks = [];
+  const paired = deps.pairedConfigPresent !== void 0 ? deps.pairedConfigPresent : loadPairedConfig() !== null;
+  checks.push({
+    name: "paired config",
+    ok: paired,
+    detail: paired ? "present" : "MISSING \u2014 run `kojee-mcp pair <code> --url <broker>`"
+  });
+  const discovery = readDiscovery(discoveryKey);
+  let logPath = null;
+  if (!discovery) {
+    checks.push({
+      name: "session discovery",
+      ok: false,
+      detail: `no discovery file at ${discoveryPath} (key=${discoveryKey}) \u2014 proxy not running for this session?`
+    });
+  } else {
+    logPath = discovery.eventLogPath ?? null;
+    const proxyPid = discovery.proxyPid ?? discovery.pid;
+    const alive = typeof proxyPid === "number" && isPidAlive(proxyPid);
+    checks.push({
+      name: "proxy process",
+      ok: alive,
+      detail: alive ? `alive (pid=${proxyPid})` : `DEAD (pid=${proxyPid ?? "?"}) \u2014 restart Claude Code`
+    });
+    const base = `http://127.0.0.1:${discovery.port}`;
+    const health = await probeJson(fetchFn, `${base}/health`);
+    checks.push({
+      name: "hook-server /health",
+      ok: health !== null,
+      detail: health !== null ? "ok" : "unreachable"
+    });
+    const statusProbe = await probeJsonWithStatus(fetchFn, `${base}/status`);
+    if (statusProbe.json === null && statusProbe.routeAbsent) {
+      checks.push({
+        name: "hook-server /status",
+        ok: "unknown",
+        detail: "proxy predates /status (old version) \u2014 stream state unknown; restart the session to upgrade"
+      });
+    } else if (statusProbe.json === null) {
+      checks.push({ name: "hook-server /status", ok: false, detail: "unreachable" });
+    } else {
+      const status = statusProbe.json;
+      const s = status;
+      const connected = s.connected === true;
+      const stale = s.stale === true;
+      const hbAge = s.lastHeartbeatAgeMs;
+      const hbStr = hbAge === null || hbAge === void 0 ? "no heartbeat yet" : `last heartbeat ${Math.round(hbAge / 1e3)}s ago`;
+      checks.push({
+        name: "SSE stream",
+        ok: connected && !stale ? true : connected ? "warn" : false,
+        detail: `${s.stream ?? "?"}; ${hbStr}; subscribed=${s.subscribedTandemCount ?? 0}; reconnects=${s.reconnectCount ?? 0}${stale ? " \u2014 STALE" : ""}`
+      });
+    }
+  }
+  if (logPath) {
+    const logStat = statFile(logPath);
+    if (!logStat) {
+      checks.push({ name: "messages log", ok: false, detail: `missing at ${logPath}` });
+    } else {
+      const ageMs = Date.now() - logStat.mtimeMs;
+      checks.push({
+        name: "messages log",
+        ok: true,
+        detail: `${logPath} (${logStat.size} bytes, mtime ${Math.round(ageMs / 1e3)}s ago)` + (logStat.size === 0 ? " \u2014 no Tandem messages yet (normal)" : "")
+      });
+    }
+    const statusPath = statusLogPath(logPath);
+    const statusStat = statFile(statusPath);
+    const lastStatus = readLastStatusLine(statusPath);
+    if (!statusStat) {
+      checks.push({ name: "status stream", ok: "warn", detail: `no status sibling at ${statusPath}` });
+    } else {
+      const sAge = Date.now() - statusStat.mtimeMs;
+      checks.push({
+        name: "status stream",
+        ok: true,
+        detail: `${statusPath} (${statusStat.size} bytes, mtime ${Math.round(sAge / 1e3)}s ago)` + (lastStatus ? `
+      last status: ${lastStatus.trim()}` : " \u2014 no status lines yet")
+      });
+    }
+    const sentinel = monitorHeartbeatPath(logPath);
+    const sentinelStat = statFile(sentinel);
+    const sentinelFresh = sentinelStat !== null && Date.now() - sentinelStat.mtimeMs < 5e3;
+    checks.push({
+      name: "Monitor (tail) heartbeat",
+      ok: sentinelFresh ? true : "warn",
+      detail: sentinelFresh ? "live (a Monitor is reading the log)" : "no fresh sentinel \u2014 spawn the Monitor (recipe below)"
+    });
+  }
+  checks.push({
+    name: "wire contract",
+    ok: "unknown",
+    detail: "fixture-vs-wire drift is NOT unit-testable \u2014 periodically reconcile the SSE wire `kind` enum (spec [tell,ask,ack,status] vs live [message,status,system]) against a live backend; see tests/fixtures/tandem-event.ts NOTE 7."
+  });
+  const recipe = logPath ? { monitorSpawn: buildMonitorSpawn(logPath), reply: buildReplyRecipe() } : null;
+  const verdict = checks.some((c) => c.ok === false) ? "broken" : checks.some((c) => c.ok === "warn") ? "degraded" : "healthy";
+  return { discoveryKey, discoveryPath, logPath, checks, recipe, verdict };
+}
+async function probeJson(fetchFn, url) {
+  try {
+    const res = await fetchFn(url);
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+async function probeJsonWithStatus(fetchFn, url) {
+  try {
+    const res = await fetchFn(url);
+    if (res.ok) return { json: await res.json(), routeAbsent: false };
+    const routeAbsent = res.status === 404 || res.status === 405;
+    return { json: null, routeAbsent };
+  } catch {
+    return { json: null, routeAbsent: false };
+  }
+}
+function formatDoctorReport(report) {
+  const mark = (ok) => ok === true ? "\u2713" : ok === "warn" ? "\u26A0" : ok === "unknown" ? "?" : "\u2717";
+  const lines = [];
+  lines.push(`kojee-mcp doctor \u2014 verdict: ${report.verdict.toUpperCase()}`);
+  lines.push("");
+  lines.push(`  discovery key: ${report.discoveryKey}`);
+  for (const c of report.checks) {
+    lines.push(`  ${mark(c.ok)} ${c.name}: ${c.detail}`);
+  }
+  lines.push("");
+  if (report.recipe) {
+    lines.push("Wake recipe (spawn once at session start):");
+    lines.push(`  ${report.recipe.monitorSpawn}`);
+    lines.push(`Then ${report.recipe.reply}.`);
+  } else {
+    lines.push("No event-log path resolved \u2014 the proxy isn't running for this session.");
+    lines.push("Start Claude Code (which spawns the kojee proxy), then re-run doctor.");
+  }
+  return lines.join("\n");
+}
+async function runDoctor() {
+  const report = await collectDoctorReport();
+  console.error(formatDoctorReport(report));
+  return report.verdict === "broken" ? 1 : 0;
+}
+export {
+  collectDoctorReport,
+  defaultReadLastStatusLine,
+  formatDoctorReport,
+  runDoctor
+};

package/dist/event-log-R6VW6GAF.js

@@ -0,0 +1,17 @@
+import {
+  STATUS_LINE_PREFIX,
+  monitorHeartbeatPath,
+  nudgeSentinelPath,
+  startEventLog,
+  statusLogPath,
+  sweepStaleEventLogs
+} from "./chunk-VLZADEFC.js";
+import "./chunk-W6YRLSD4.js";
+export {
+  STATUS_LINE_PREFIX,
+  monitorHeartbeatPath,
+  nudgeSentinelPath,
+  startEventLog,
+  statusLogPath,
+  sweepStaleEventLogs
+};

package/dist/{hook-server-43QS7L7P.js → hook-server-QF5JVUHV.js}

@@ -24,6 +24,9 @@ async function handleRequest(req, res, opts) {
   if (req.method === "GET" && url.pathname === "/health") {
     return json(res, 200, { ok: true });
   }
+  if (req.method === "GET" && url.pathname === "/status") {
+    return respondWithStatus(res, opts);
+  }
   if (req.method === "GET" && url.pathname === "/poll") {
     const type = url.searchParams.get("type") ?? "";
     const timeoutMs = Number.parseInt(url.searchParams.get("timeout_ms") ?? "0", 10);
@@ -42,6 +45,31 @@ function respondWithEvents(res, opts) {
   const events = entries.map((entry) => opts.adapter.formatTandemEvent(entry.event));
   json(res, 200, { events, count: events.length });
 }
+function respondWithStatus(res, opts) {
+  const now = Date.now();
+  if (!opts.getStreamState) {
+    return json(res, 200, { stream: "unknown", now });
+  }
+  const s = opts.getStreamState();
+  const lastEventAgeMs = s.lastEventAt === null ? null : now - s.lastEventAt;
+  const lastHeartbeatAgeMs = s.lastHeartbeatAt === null ? null : now - s.lastHeartbeatAt;
+  const stale = s.connected && s.staleAfterMs !== null && lastEventAgeMs !== null && lastEventAgeMs >= s.staleAfterMs;
+  json(res, 200, {
+    stream: s.connected ? "connected" : "disconnected",
+    connected: s.connected,
+    connectedSince: s.connectedSince,
+    lastEventAt: s.lastEventAt,
+    lastEventAgeMs,
+    lastHeartbeatAt: s.lastHeartbeatAt,
+    lastHeartbeatAgeMs,
+    reconnectCount: s.reconnectCount,
+    subscribedTandemCount: Object.keys(s.cursors).length,
+    cursors: s.cursors,
+    staleAfterMs: s.staleAfterMs,
+    stale,
+    now
+  });
+}
 async function longPollAndRespond(res, opts, timeoutMs) {
   const immediate = opts.queue.takeForHook();
   if (immediate.length > 0) {

package/dist/index.js

@@ -1,7 +1,9 @@
 import {
   startProxy
-} from "./chunk-ZGVUM4AG.js";
-import "./chunk-36DMIXH7.js";
+} from "./chunk-LCFCCWMM.js";
+import "./chunk-QB22PD6T.js";
+import "./chunk-E26AHU6J.js";
+import "./chunk-BJMASMKX.js";
 export {
   startProxy
 };

package/dist/{install-WV25CRU2.js → install-D2HIPOMT.js}

@@ -1,8 +1,9 @@
 // src/hooks/install.ts
 import fs from "fs";
+import os from "os";
 import path from "path";
 function discoverInstallTargets() {
-  const home = process.env["HOME"] ?? "~";
+  const home = os.homedir();
   const targets = [];
   const cliPath = path.join(home, ".claude.json");
   const cliHooksPath = path.join(home, ".claude", "settings.json");
@@ -28,10 +29,10 @@ var MCP_SERVER_CMD = "npx";
 var MCP_SERVER_ARGS = ["kojee-mcp"];
 var MCP_SERVER_ENV = { KOJEE_RUNTIME: "claude-code" };
 function defaultConfigPath() {
-  return path.join(process.env["HOME"] ?? "~", ".claude.json");
+  return path.join(os.homedir(), ".claude.json");
 }
 function defaultHooksPath() {
-  return path.join(process.env["HOME"] ?? "~", ".claude", "settings.json");
+  return path.join(os.homedir(), ".claude", "settings.json");
 }
 function deriveHooksPath(configPath) {
   return path.join(path.dirname(configPath), ".claude", "settings.json");

package/dist/{paired-config-OAR3O3XY.js → paired-config-RB4SABOS.js}

@@ -2,7 +2,7 @@ import {
   loadPairedConfig,
   pairedConfigPath,
   savePairedConfig
-} from "./chunk-E7TE4QZD.js";
+} from "./chunk-GBOTBYEP.js";
 export {
   loadPairedConfig,
   pairedConfigPath,

package/dist/resubscribe-SLZNA76S.js

@@ -0,0 +1,59 @@
+// src/tandem/resubscribe.ts
+var DEFAULT_PER_CALL_TIMEOUT_MS = 1e4;
+var DEFAULT_CONCURRENCY = 4;
+var DEFAULT_DEBOUNCE_MS = 3e4;
+async function resubscribeMemberships(opts) {
+  const { gateway, eventLog } = opts;
+  const perCallTimeoutMs = opts.perCallTimeoutMs ?? DEFAULT_PER_CALL_TIMEOUT_MS;
+  const concurrency = Math.max(1, opts.concurrency ?? DEFAULT_CONCURRENCY);
+  const now = opts.now ?? Date.now;
+  const debounceMs = opts.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+  if (opts.debounceState && now() - opts.debounceState.lastRunAt < debounceMs) {
+    return 0;
+  }
+  let tandemIds;
+  try {
+    tandemIds = opts.listTandems ? await opts.listTandems() : opts.tandemIds ?? [];
+  } catch (err) {
+    console.error("[resubscribe] re-list failed:", err.message);
+    tandemIds = [];
+  }
+  let touched = 0;
+  async function touchOne(tandemId) {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), perCallTimeoutMs);
+    try {
+      const result = await gateway.sendRpc(
+        "tools/call",
+        { name: "tandem_messages", arguments: { tandem_id: tandemId, limit: 1 } },
+        ac.signal
+      );
+      const maybeErr = result;
+      if (!maybeErr.isError) touched += 1;
+    } catch (err) {
+      console.error(
+        `[resubscribe] touch failed for ${tandemId}:`,
+        err.message
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  let next = 0;
+  async function worker() {
+    while (next < tandemIds.length) {
+      const i = next++;
+      await touchOne(tandemIds[i]);
+    }
+  }
+  await Promise.all(
+    Array.from({ length: Math.min(concurrency, tandemIds.length) }, () => worker())
+  );
+  if (opts.debounceState) opts.debounceState.lastRunAt = now();
+  await eventLog?.appendStatus(`status=subscribed n=${tandemIds.length} touched=${touched}`).catch(() => {
+  });
+  return touched;
+}
+export {
+  resubscribeMemberships
+};

package/dist/{session-discovery-WSHLR4OV.js → session-discovery-QE5TTAPS.js}

@@ -10,7 +10,7 @@ import {
   sweepStaleDiscovery,
   writeDiscoveryByKey,
   writeSessionDiscovery
-} from "./chunk-VZVGTHGF.js";
+} from "./chunk-W6YRLSD4.js";
 export {
   cleanupDiscoveryByKey,
   cleanupSessionDiscovery,

package/dist/stop-hook-VLQS6QPR.js

@@ -0,0 +1,118 @@
+import {
+  readHookStdin
+} from "./chunk-LSUB6QMP.js";
+import {
+  buildMonitorNudge
+} from "./chunk-E26AHU6J.js";
+import {
+  deriveDiscoveryKey,
+  findClaudeAncestorPid
+} from "./chunk-BJMASMKX.js";
+import {
+  monitorHeartbeatPath,
+  nudgeSentinelPath
+} from "./chunk-VLZADEFC.js";
+import {
+  readSessionDiscoveryByKey
+} from "./chunk-W6YRLSD4.js";
+
+// src/hooks/stop-hook.ts
+import fs from "fs";
+var STOP_POLL_TIMEOUT_MS = Number.parseInt(
+  process.env["KOJEE_STOP_HOOK_TIMEOUT_MS"] ?? "0",
+  10
+);
+var MONITOR_HEARTBEAT_STALE_MS = 5e3;
+var NUDGE_WINDOW_MS = Number.parseInt(
+  process.env["KOJEE_STOP_NUDGE_WINDOW_MS"] ?? "300000",
+  // 5 min
+  10
+);
+async function decideStopHook(deps) {
+  if (deps.stopHookActive) return "{}";
+  if (!deps.discovery) return "{}";
+  const body = await deps.pollEvents().catch(() => null);
+  if (body && body.count > 0) {
+    return JSON.stringify({ decision: "block", reason: formatEvents(body.events) });
+  }
+  const logPath = deps.discovery.eventLogPath;
+  if (logPath && deps.logHasContent(logPath) && !deps.monitorIsLive(logPath)) {
+    if (deps.nudgedRecently(logPath)) return "{}";
+    deps.recordNudge(logPath);
+    return JSON.stringify({ decision: "block", reason: buildMonitorNudge(logPath) });
+  }
+  return "{}";
+}
+function defaultNudgedRecently(logPath) {
+  try {
+    const { mtimeMs } = fs.statSync(nudgeSentinelPath(logPath));
+    return Date.now() - mtimeMs < NUDGE_WINDOW_MS;
+  } catch {
+    return false;
+  }
+}
+function defaultRecordNudge(logPath) {
+  const sentinel = nudgeSentinelPath(logPath);
+  const now = /* @__PURE__ */ new Date();
+  try {
+    fs.utimesSync(sentinel, now, now);
+  } catch {
+    try {
+      fs.writeFileSync(sentinel, "", { mode: 384 });
+    } catch {
+    }
+  }
+}
+async function runStopHook() {
+  const { stopHookActive } = await readHookStdin();
+  const ccPid = await findClaudeAncestorPid();
+  const key = deriveDiscoveryKey(process.env["CLAUDE_PROJECT_DIR"], ccPid);
+  const discovery = readSessionDiscoveryByKey(key);
+  const out = await decideStopHook({
+    stopHookActive,
+    discovery: discovery ? { port: discovery.port, eventLogPath: discovery.eventLogPath } : null,
+    pollEvents: async () => {
+      const res = await fetch(
+        `http://127.0.0.1:${discovery.port}/poll?type=stop&timeout_ms=${STOP_POLL_TIMEOUT_MS}`
+      );
+      if (!res.ok) return { events: [], count: 0 };
+      return await res.json();
+    },
+    logHasContent,
+    monitorIsLive,
+    nudgedRecently: defaultNudgedRecently,
+    recordNudge: defaultRecordNudge
+  });
+  process.stdout.write(out);
+}
+function logHasContent(logPath) {
+  try {
+    return fs.statSync(logPath).size > 0;
+  } catch {
+    return false;
+  }
+}
+function monitorIsLive(logPath) {
+  try {
+    const { mtimeMs } = fs.statSync(monitorHeartbeatPath(logPath));
+    return Date.now() - mtimeMs < MONITOR_HEARTBEAT_STALE_MS;
+  } catch {
+    return false;
+  }
+}
+function formatEvents(events) {
+  const header = `[${events.length} unread Tandem ${events.length === 1 ? "event" : "events"}]
+
+`;
+  const bodies = events.map((evt) => {
+    const attrs = Object.entries(evt.meta).map(([k, v]) => `${k}="${v}"`).join(" ");
+    return `<channel source="kojee-mcp" ${attrs}>
+${evt.content}
+</channel>`;
+  });
+  return header + bodies.join("\n\n");
+}
+export {
+  decideStopHook,
+  runStopHook
+};