kojee-mcp 0.7.5-staging.2 → 0.7.5-staging.21

package/dist/{tail-stream-G4WGTXDS.js → tail-stream-PQXEY3TI.js}

@@ -3,19 +3,20 @@ import {
   STATUS_LINE_PREFIX,
   monitorHeartbeatPath,
   statusLogPath
-} from "./chunk-TNZITJAB.js";
+} from "./chunk-WVQU3QQ7.js";
 import "./chunk-67F67AQ6.js";
 import {
   LOG_HEARTBEAT_INTERVAL_MS,
   UNARMED_FALLBACK_MS,
   createAdaptiveWatchdog
-} from "./chunk-CUOJHP2S.js";
+} from "./chunk-UGEBGCYU.js";
 import "./chunk-Z5LPNJQ6.js";
 import "./chunk-MIEI4PLB.js";
 import "./chunk-U5HHHRXA.js";
 
 // src/tail-stream.ts
 import fs from "fs";
+import { spawn } from "child_process";
 var STATUS_LINE_RE = new RegExp(`^\\[[^\\]]*\\] ${STATUS_LINE_PREFIX} (.*)$`);
 var HEARTBEAT_FIELDS_RE = /(^|\s)status=heartbeat(\s|$)/;
 var ROTATED_FIELDS_RE = /(^|\s)status=rotated(\s|$)/;
@@ -29,6 +30,7 @@ var TAIL_STALE_FLOOR_MS = envInt(
 );
 var STALE_CHECK_INTERVAL_MS = envInt("KOJEE_TAIL_CHECK_MS", 5e3);
 var TAIL_REWARN_AFTER_MS = 30 * 6e4;
+var SUSTAINED_STALE_MS = envInt("KOJEE_TAIL_SUSTAINED_MS", TAIL_REWARN_AFTER_MS);
 var TAIL_HEALTHY_RESET_MS = 30 * 6e4;
 var TAIL_BACKOFF_CAP_CYCLES = 3;
 function envInt(name, fallback) {
@@ -99,9 +101,14 @@ function createStallDetector(startNow, options = {}) {
     }
   };
 }
-async function runTail(messagesPath) {
+async function runTail(messagesPath, opts = {}) {
+  const wakeOnly = opts.wakeOnly === true;
+  const replay = opts.replay === true;
   const statusPath = statusLogPath(messagesPath);
-  const detector = createStallDetector(Date.now(), { floorMs: TAIL_STALE_FLOOR_MS });
+  const detector = createStallDetector(Date.now(), {
+    floorMs: TAIL_STALE_FLOOR_MS,
+    rewarnAfterMs: SUSTAINED_STALE_MS
+  });
   const heartbeatPath = monitorHeartbeatPath(messagesPath);
   const touchHeartbeat = () => {
     const now = /* @__PURE__ */ new Date();
@@ -116,7 +123,7 @@ async function runTail(messagesPath) {
   };
   let lastCursor = null;
   function onMessageLine(line) {
-    if (detector.onLife(Date.now())?.kind === "recovered") {
+    if (detector.onLife(Date.now())?.kind === "recovered" && !wakeOnly) {
       process.stdout.write(
         "[kojee] stream recovered \u2014 events flowing again (recovery is automatic; no action needed).\n"
       );
@@ -133,7 +140,7 @@ async function runTail(messagesPath) {
     if (HEARTBEAT_FIELDS_RE.test(fields)) {
       detector.onHeartbeat(now);
     }
-    if (detector.onLife(now)?.kind === "recovered") {
+    if (detector.onLife(now)?.kind === "recovered" && !wakeOnly) {
       process.stdout.write(
         "[kojee] stream recovered \u2014 heartbeats resumed (the stall was transient, likely idle-period timing or brief host load; no action needed).\n"
       );
@@ -149,8 +156,16 @@ async function runTail(messagesPath) {
     }
   }
   const followers = [
-    makeFollower(messagesPath, onMessageLine, touchHeartbeat),
-    makeFollower(statusPath, onStatusLine, touchHeartbeat)
+    // MESSAGES (wake-critical) — prefer the OS `tail -F` follower where the
+    // platform has one; it delegates file-following to the battle-tested system
+    // binary instead of the Node fs.watch/poll tailer. STATUS (telemetry) stays
+    // on the Node follower: its startup-backlog seeding boundary (statusSeeded)
+    // is clean to detect only when we control the drain. See makeMessagesFollower.
+    makeMessagesFollower(messagesPath, onMessageLine, touchHeartbeat, replay),
+    // STATUS stays replay=true: its single current-state line is seeded on
+    // attach (statusSeeded boundary) — that's cheap, not a flood, and the
+    // connected/rotated seed is what primes the watchdog + backfill logic.
+    makeFollower(statusPath, onStatusLine, touchHeartbeat, true)
   ];
   void Promise.all([
     followers[0].start(),
@@ -171,6 +186,7 @@ async function runTail(messagesPath) {
       );
       return;
     }
+    if (wakeOnly) return;
     const thresholdS = Math.round((signal.thresholdMs ?? 0) / 1e3);
     process.stdout.write(
       `[kojee] WARNING: no events or heartbeat for ${silentS}s (threshold ${thresholdS}s) \u2014 stream may be dead, but this is often benign (idle stream, or brief host load delaying heartbeats) and recovery is automatic; if it persists, run \`npx kojee-mcp doctor\`.
@@ -191,7 +207,7 @@ async function runTail(messagesPath) {
     process.on("SIGINT", cleanup);
   });
 }
-function makeFollower(filePath, onLine, onActivity) {
+function makeFollower(filePath, onLine, onActivity, replay = true) {
   let buffer = "";
   let offset = 0;
   let watcher = null;
@@ -248,6 +264,12 @@ function makeFollower(filePath, onLine, onActivity) {
         await sleep(250);
       }
       if (stopped) return;
+      if (!replay) {
+        try {
+          offset = (await fs.promises.stat(filePath)).size;
+        } catch {
+        }
+      }
       onActivity();
       await scheduleDrain();
       pollTimer = setInterval(() => {
@@ -273,11 +295,100 @@ function makeFollower(filePath, onLine, onActivity) {
     }
   };
 }
+function osTailAvailable() {
+  const override = (process.env.KOJEE_TAIL_IMPL ?? "").trim().toLowerCase();
+  if (override === "os") return true;
+  if (override === "node") return false;
+  return process.platform !== "win32";
+}
+function makeMessagesFollower(filePath, onLine, onActivity, replay = true) {
+  if (!osTailAvailable()) return makeFollower(filePath, onLine, onActivity, replay);
+  return makeTailFollower(
+    filePath,
+    onLine,
+    onActivity,
+    () => makeFollower(filePath, onLine, onActivity, replay),
+    replay
+  );
+}
+function makeTailFollower(filePath, onLine, onActivity, fallback, replay = true) {
+  let child = null;
+  let heir = null;
+  let hbTimer = null;
+  let buffer = "";
+  let stopped = false;
+  let handedOff = false;
+  function emit(chunk) {
+    onActivity();
+    buffer += chunk;
+    let nl;
+    while ((nl = buffer.indexOf("\n")) !== -1) {
+      onLine(buffer.slice(0, nl));
+      buffer = buffer.slice(nl + 1);
+    }
+  }
+  function handOff() {
+    if (stopped || handedOff) return;
+    handedOff = true;
+    if (hbTimer) {
+      clearInterval(hbTimer);
+      hbTimer = null;
+    }
+    if (child) {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+      child = null;
+    }
+    heir = fallback();
+    void heir.start().catch(() => {
+    });
+  }
+  return {
+    async start() {
+      try {
+        child = spawn("tail", ["-n", replay ? "+1" : "0", "-F", filePath], {
+          stdio: ["ignore", "pipe", "ignore"]
+        });
+      } catch {
+        handOff();
+        return;
+      }
+      child.on("error", () => handOff());
+      child.on("exit", () => {
+        if (!stopped) handOff();
+      });
+      child.stdout?.setEncoding("utf8");
+      child.stdout?.on("data", (d) => emit(d));
+      onActivity();
+      hbTimer = setInterval(onActivity, 1e3);
+    },
+    stop() {
+      stopped = true;
+      if (hbTimer) {
+        clearInterval(hbTimer);
+        hbTimer = null;
+      }
+      if (child) {
+        try {
+          child.kill("SIGTERM");
+        } catch {
+        }
+        child = null;
+      }
+      if (heir) heir.stop();
+    }
+  };
+}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 export {
   createStallDetector,
   makeFollower,
+  makeMessagesFollower,
+  makeTailFollower,
+  osTailAvailable,
   runTail
 };

package/dist/{user-prompt-submit-hook-DTXXFDSD.js → user-prompt-submit-hook-YQXGE3JU.js}

@@ -1,9 +1,9 @@
 import {
   resolveHookDiscovery
-} from "./chunk-WBXU27BF.js";
+} from "./chunk-FNMKP34Y.js";
 import {
   readHookStdin
-} from "./chunk-LSUB6QMP.js";
+} from "./chunk-NIIBVKLP.js";
 import {
   controlTokenAuthHeaders
 } from "./chunk-GKXHKR3B.js";
@@ -13,7 +13,7 @@ import {
 import "./chunk-67F67AQ6.js";
 import "./chunk-U5HHHRXA.js";
 import "./chunk-XJEBJIQE.js";
-import "./chunk-KNEJTD6G.js";
+import "./chunk-SZLNNMIZ.js";
 
 // src/hooks/user-prompt-submit-hook.ts
 async function runUserPromptSubmitHook() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kojee-mcp",
-  "version": "0.7.5-staging.2",
+  "version": "0.7.5-staging.21",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
@@ -34,7 +34,8 @@
     "jose": "^5.0.0",
     "ps-list": "^8.1.1",
     "ulidx": "^2.3.0",
-    "undici": "^8.5.0",
+    "undici": "8.5.0",
+    "yaml": "^2.9.0",
     "zod": "^3.22.0"
   },
   "devDependencies": {

package/dist/chunk-5DHIUN73.js

@@ -1,25 +0,0 @@
-// src/version.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-var FALLBACK_VERSION = "0.0.0-unknown";
-function resolveVersion() {
-  try {
-    const here = path.dirname(fileURLToPath(import.meta.url));
-    const parsed = JSON.parse(
-      fs.readFileSync(path.join(here, "..", "package.json"), "utf8")
-    );
-    return typeof parsed?.version === "string" && parsed.version ? parsed.version : FALLBACK_VERSION;
-  } catch (err) {
-    process.stderr.write(
-      `kojee-mcp: could not resolve version from package.json, falling back to ${FALLBACK_VERSION}: ${String(err)}
-`
-    );
-    return FALLBACK_VERSION;
-  }
-}
-var VERSION = resolveVersion();
-
-export {
-  VERSION
-};

package/dist/chunk-TMCNB4JH.js

@@ -1,33 +0,0 @@
-// src/hooks/hook-command.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-function npxHookCommand(type) {
-  return `npx -y kojee-mcp hook --type=${type}`;
-}
-function resolveCliEntry(moduleUrl = import.meta.url) {
-  try {
-    const here = fileURLToPath(moduleUrl);
-    const candidate = path.join(path.dirname(here), "cli.js");
-    return fs.existsSync(candidate) ? candidate : null;
-  } catch {
-    return null;
-  }
-}
-function buildHookCommand(type, opts = {}) {
-  const cliEntry = opts.cliEntry !== void 0 ? opts.cliEntry : resolveCliEntry();
-  if (!cliEntry) return npxHookCommand(type);
-  const execPath = opts.execPath ?? process.execPath;
-  return `"${execPath}" "${cliEntry}" hook --type=${type}`;
-}
-var PINNED_HOOK_RE = /^"[^"]+" "[^"]+" hook --type=(stop|user-prompt-submit|codex-stop|codex-prompt-submit)$/;
-function isKojeeHookCommand(command) {
-  if (command.startsWith("npx -y kojee-mcp hook --type=")) return true;
-  return PINNED_HOOK_RE.test(command);
-}
-
-export {
-  npxHookCommand,
-  buildHookCommand,
-  isKojeeHookCommand
-};