@cubicj/codex-watch 0.1.0 → 0.2.0

package/README.md

@@ -9,6 +9,7 @@ Live-tail the newest Codex plugin background job log for the current git repo.
 - Resolves the git repo from the terminal's current working directory.
 - Follows the newest job log written by the `openai/codex-plugin-cc` Claude Code plugin.
 - Auto-switches when a `--resume` starts a newer job id, so a resumed run is picked up without restarting.
+- Shows the job's model, reasoning effort, sandbox mode, and write access under the header (resolved from the Codex CLI session files in `$CODEX_HOME`, default `~/.codex`).
 - Colorizes assistant messages, command status, file changes, and job events.
 - Prints a completion banner such as `✓ completed · <duration>` or `✗ <status> · <duration>`.
 - Drops duplicate captured lines.
@@ -32,7 +33,7 @@ codex-watch
 From source:
 
 ```sh
-git clone <repo-url>
+git clone https://github.com/cubicj/codex-watch.git
 cd codex-watch
 npm link
 codex-watch

package/bin/codex-watch

@@ -3,6 +3,14 @@ const fs = require("fs");
 const path = require("path");
 const os = require("os");
 const childProcess = require("child_process");
+const { StringDecoder } = require("node:string_decoder");
+
+process.stdout.on("error", (error) => {
+  if (error.code === "EPIPE") {
+    process.exit(0);
+  }
+  throw error;
+});
 
 const args = process.argv.slice(2);
 const useColor = !process.env.NO_COLOR && process.stdout.isTTY;
@@ -53,17 +61,21 @@ const slug = makeSlug(repoRoot);
 const stateRoot = process.env.CLAUDE_PLUGIN_DATA
   ? path.join(process.env.CLAUDE_PLUGIN_DATA, "state")
   : path.join(os.homedir(), ".claude/plugins/data/codex-openai-codex/state");
+const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
 const stateDirPattern = new RegExp("^" + escapeRegExp(slug) + "-[0-9a-f]{6,}$");
 
 let currentJob = null;
-let currentKey = "";
 let logOffset = 0;
+let logDecoder = new StringDecoder("utf8");
 let pendingText = "";
 let assistantBlock = false;
 let tailTimer = null;
 let scanTimer = null;
 let waitingPrinted = false;
 let completionBannerPrinted = false;
+let sessionInfoPrinted = false;
+let sessionRolloutPath = "";
+let lastRolloutSearchAt = null;
 
 process.on("SIGINT", () => {
   clearTimers();
@@ -78,6 +90,7 @@ if (once) {
     process.exit(0);
   }
   printHeader(job);
+  printSessionInfo(job);
   renderWholeLog(job);
   process.exit(0);
 }
@@ -160,10 +173,13 @@ function findNewestJob() {
         jsonPath,
         logPath,
         createdAt,
-        displayedCreatedAt: typeof meta.createdAt === "string" ? meta.createdAt : createdAt,
+        displayedCreatedAt: typeof meta.createdAt === "string" && meta.createdAt ? meta.createdAt : createdAt,
+        startedAt: typeof meta.startedAt === "string" ? meta.startedAt : "",
         status: typeof meta.status === "string" ? meta.status : "unknown",
         phase: typeof meta.phase === "string" ? meta.phase : "unknown",
-        summary: typeof meta.summary === "string" ? meta.summary : ""
+        summary: typeof meta.summary === "string" ? meta.summary : "",
+        threadId: typeof meta.threadId === "string" ? meta.threadId : "",
+        write: typeof meta.write === "boolean" ? meta.write : false
       });
     }
   }
@@ -194,28 +210,32 @@ function scanForNewJob() {
   }
 
   if (!currentJob) {
-    switchToJob(newest, false);
+    switchToJob(newest);
     return;
   }
 
   if (newest.createdAt > currentJob.createdAt) {
     console.log(color("dim", "──────── switched to " + newest.id + " ────────"));
-    switchToJob(newest, true);
+    switchToJob(newest);
   }
 }
 
 function switchToJob(job) {
   currentJob = job;
-  currentKey = job.jsonPath;
   logOffset = 0;
+  logDecoder = new StringDecoder("utf8");
   pendingText = "";
   assistantBlock = false;
   waitingPrinted = false;
   completionBannerPrinted = false;
+  sessionInfoPrinted = false;
+  sessionRolloutPath = "";
+  lastRolloutSearchAt = null;
   if (tailTimer) {
     clearInterval(tailTimer);
   }
   printHeader(job);
+  printSessionInfo(job);
   readAvailableLog();
   tailTimer = setInterval(readAvailableLog, 400);
 }
@@ -235,6 +255,100 @@ function printHeader(job) {
   console.log(color("dim", line));
 }
 
+function printSessionInfo(job) {
+  if (sessionInfoPrinted || !job.threadId) {
+    return;
+  }
+
+  if (!sessionRolloutPath) {
+    const now = Date.now();
+    if (lastRolloutSearchAt !== null && now - lastRolloutSearchAt < 5000) {
+      return;
+    }
+    lastRolloutSearchAt = now;
+    sessionRolloutPath = findRolloutFile(job.threadId);
+    if (!sessionRolloutPath) {
+      return;
+    }
+  }
+
+  const text = readFileText(sessionRolloutPath);
+  const startedAt = typeof job.startedAt === "string" && job.startedAt
+    ? job.startedAt
+    : typeof job.createdAt === "string"
+      ? job.createdAt
+      : "";
+  let turnContext = null;
+
+  for (const line of text.split(/\r?\n/)) {
+    try {
+      const entry = JSON.parse(line);
+      if (
+        entry &&
+        entry.type === "turn_context" &&
+        (!startedAt || (typeof entry.timestamp === "string" && entry.timestamp >= startedAt))
+      ) {
+        turnContext = entry;
+      }
+    } catch (_error) {}
+  }
+
+  const payload = turnContext && turnContext.payload;
+  if (!payload || typeof payload.model !== "string" || !payload.model) {
+    return;
+  }
+
+  const segments = ["model " + payload.model];
+  if (typeof payload.effort === "string" && payload.effort) {
+    segments.push("effort " + payload.effort);
+  }
+  if (payload.sandbox_policy && typeof payload.sandbox_policy.type === "string" && payload.sandbox_policy.type) {
+    segments.push("sandbox " + payload.sandbox_policy.type);
+  }
+  segments.push(job.write === true ? "write" : "read-only");
+  console.log(color("dim", segments.join(" · ")));
+  sessionInfoPrinted = true;
+}
+
+function findRolloutFile(threadId) {
+  const sessionsRoot = path.join(codexHome, "sessions");
+  const years = safeReadDir(sessionsRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort()
+    .reverse();
+
+  for (const year of years) {
+    const yearDir = path.join(sessionsRoot, year);
+    const months = safeReadDir(yearDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+      .sort()
+      .reverse();
+
+    for (const month of months) {
+      const monthDir = path.join(yearDir, month);
+      const days = safeReadDir(monthDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort()
+        .reverse();
+
+      for (const day of days) {
+        const dayDir = path.join(monthDir, day);
+        const rollout = safeReadDir(dayDir, { withFileTypes: true }).find(
+          (entry) => entry.isFile() && entry.name.endsWith("-" + threadId + ".jsonl")
+        );
+        if (rollout) {
+          return path.join(dayDir, rollout.name);
+        }
+      }
+    }
+  }
+
+  return "";
+}
+
 function formatElapsed(createdAt, updatedAt) {
   const started = Date.parse(createdAt);
   if (!Number.isFinite(started)) {
@@ -261,35 +375,36 @@ function renderWholeLog(job) {
 }
 
 function readAvailableLog() {
-  if (!currentJob || currentKey !== currentJob.jsonPath) {
-    return;
-  }
-
-  if (!checkJobCompletion()) {
+  if (!currentJob) {
     return;
   }
 
   const stat = safeStat(currentJob.logPath);
-  if (!stat || !stat.isFile()) {
-    return;
-  }
-
-  if (stat.size < logOffset) {
-    logOffset = 0;
-    pendingText = "";
-    assistantBlock = false;
-  }
+  if (stat && stat.isFile()) {
+    if (stat.size < logOffset) {
+      logOffset = 0;
+      logDecoder = new StringDecoder("utf8");
+      pendingText = "";
+      assistantBlock = false;
+    }
 
-  if (stat.size === logOffset) {
-    return;
+    if (stat.size !== logOffset) {
+      const chunk = readFileChunk(currentJob.logPath, logOffset, stat.size - logOffset);
+      if (chunk !== null) {
+        logOffset += chunk.length;
+        renderText(logDecoder.write(chunk), true);
+      }
+    }
   }
 
-  const chunk = readFileChunk(currentJob.logPath, logOffset, stat.size - logOffset);
-  logOffset = stat.size;
-  renderText(chunk, true);
+  checkJobCompletion();
 }
 
 function checkJobCompletion() {
+  if (completionBannerPrinted) {
+    return true;
+  }
+
   let meta = null;
   try {
     meta = JSON.parse(fs.readFileSync(currentJob.jsonPath, "utf8"));
@@ -298,13 +413,19 @@ function checkJobCompletion() {
   }
 
   const status = typeof meta.status === "string" ? meta.status : "unknown";
-  if (completionBannerPrinted || !isTerminalStatus(status)) {
+  currentJob.threadId = typeof meta.threadId === "string" ? meta.threadId : "";
+  currentJob.write = typeof meta.write === "boolean" ? meta.write : false;
+  currentJob.startedAt = typeof meta.startedAt === "string" ? meta.startedAt : "";
+  printSessionInfo(currentJob);
+  if (!isTerminalStatus(status)) {
     return true;
   }
 
   const createdAt = typeof meta.createdAt === "string" && meta.createdAt ? meta.createdAt : currentJob.displayedCreatedAt;
+  const startedAt = typeof meta.startedAt === "string" && meta.startedAt ? meta.startedAt : createdAt;
   const updatedAt = typeof meta.updatedAt === "string" && meta.updatedAt ? meta.updatedAt : "";
-  const elapsed = formatElapsed(createdAt, updatedAt);
+  const completedAt = typeof meta.completedAt === "string" && meta.completedAt ? meta.completedAt : updatedAt;
+  const elapsed = formatElapsed(startedAt, completedAt);
   if (status === "completed") {
     console.log(color("green", "✓ completed · " + elapsed));
   } else {
@@ -315,7 +436,7 @@ function checkJobCompletion() {
 }
 
 function isTerminalStatus(status) {
-  return status !== "running" && status !== "queued" && status !== "pending";
+  return status !== "running" && status !== "queued";
 }
 
 function readFileText(file) {
@@ -332,16 +453,14 @@ function readFileChunk(file, start, length) {
     fd = fs.openSync(file, "r");
     const buffer = Buffer.alloc(length);
     const bytesRead = fs.readSync(fd, buffer, 0, length, start);
-    return buffer.subarray(0, bytesRead).toString("utf8");
+    return buffer.subarray(0, bytesRead);
   } catch (_error) {
-    return "";
+    return null;
   } finally {
     if (fd !== null) {
       try {
         fs.closeSync(fd);
-      } catch (_error) {
-        return "";
-      }
+      } catch (_error) {}
     }
   }
 }
@@ -368,7 +487,7 @@ function renderText(text, keepPartial) {
 }
 
 function renderLine(line) {
-  const match = line.match(/^\[[^\]]+\]\s+(.*)$/);
+  const match = line.match(/^\[\d{4}-\d{2}-\d{2}T[^\]]*\]\s+(.*)$/);
   if (!match) {
     if (assistantBlock) {
       console.log(assistantText(line));
@@ -427,8 +546,9 @@ function renderLine(line) {
 
 function truncate(value) {
   const maxLength = 140;
-  if (value.length <= maxLength) {
+  const codePoints = Array.from(value);
+  if (codePoints.length <= maxLength) {
     return value;
   }
-  return value.slice(0, maxLength - 1) + "…";
+  return codePoints.slice(0, maxLength - 1).join("") + "…";
 }

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@cubicj/codex-watch",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Live-tail the newest Codex plugin background job log for the current git repo.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cubicj/codex-watch.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cubicj/codex-watch/issues"
+  },
+  "homepage": "https://github.com/cubicj/codex-watch#readme",
   "publishConfig": {
     "access": "public"
   },