@cubicj/codex-watch 0.1.0 → 0.2.1

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,15 @@ const fs = require("fs");
 const path = require("path");
 const os = require("os");
 const childProcess = require("child_process");
+const crypto = require("node:crypto");
+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;
@@ -50,20 +59,24 @@ if (args.includes("--help") || args.includes("-h")) {
 const once = args.includes("--once");
 const repoRoot = resolveRepoRoot();
 const slug = makeSlug(repoRoot);
+const stateDirName = makeStateDirName(repoRoot, slug);
 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 stateDirPattern = new RegExp("^" + escapeRegExp(slug) + "-[0-9a-f]{6,}$");
+const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
 
 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,7 +91,11 @@ if (once) {
     process.exit(0);
   }
   printHeader(job);
+  printSessionInfo(job);
   renderWholeLog(job);
+  if (isTerminalStatus(job.status)) {
+    printCompletionBanner(job, job.displayedCreatedAt);
+  }
   process.exit(0);
 }
 
@@ -102,8 +119,13 @@ function makeSlug(root) {
   return path.basename(root).replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "workspace";
 }
 
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function makeStateDirName(root, rootSlug) {
+  let canonical = root;
+  try {
+    canonical = fs.realpathSync.native(root);
+  } catch (_error) {}
+  const hash = crypto.createHash("sha256").update(canonical).digest("hex").slice(0, 16);
+  return rootSlug + "-" + hash;
 }
 
 function safeReadDir(dir, options) {
@@ -131,46 +153,43 @@ function readJson(file) {
 }
 
 function findNewestJob() {
-  const stateEntries = safeReadDir(stateRoot, { withFileTypes: true });
+  const jobsDir = path.join(stateRoot, stateDirName, "jobs");
+  const jobEntries = safeReadDir(jobsDir, { withFileTypes: true });
   const candidates = [];
 
-  for (const entry of stateEntries) {
-    if (!entry.isDirectory() || !stateDirPattern.test(entry.name)) {
+  for (const jobEntry of jobEntries) {
+    if (!jobEntry.isFile() || !jobEntry.name.endsWith(".json")) {
       continue;
     }
 
-    const jobsDir = path.join(stateRoot, entry.name, "jobs");
-    const jobEntries = safeReadDir(jobsDir, { withFileTypes: true });
-
-    for (const jobEntry of jobEntries) {
-      if (!jobEntry.isFile() || !jobEntry.name.endsWith(".json")) {
-        continue;
-      }
-
-      const id = path.basename(jobEntry.name, ".json");
-      const jsonPath = path.join(jobsDir, jobEntry.name);
-      const logPath = path.join(jobsDir, id + ".log");
-      const meta = readJson(jsonPath);
-      const stat = safeStat(jsonPath);
-      const fallbackCreatedAt = stat ? stat.mtime.toISOString() : "";
-      const createdAt = typeof meta.createdAt === "string" && meta.createdAt ? meta.createdAt : fallbackCreatedAt;
-
-      candidates.push({
-        id,
-        jsonPath,
-        logPath,
-        createdAt,
-        displayedCreatedAt: typeof meta.createdAt === "string" ? meta.createdAt : createdAt,
-        status: typeof meta.status === "string" ? meta.status : "unknown",
-        phase: typeof meta.phase === "string" ? meta.phase : "unknown",
-        summary: typeof meta.summary === "string" ? meta.summary : ""
-      });
-    }
+    const id = path.basename(jobEntry.name, ".json");
+    const jsonPath = path.join(jobsDir, jobEntry.name);
+    const logPath = path.join(jobsDir, id + ".log");
+    const meta = readJson(jsonPath);
+    const stat = safeStat(jsonPath);
+    const fallbackCreatedAt = stat ? stat.mtime.toISOString() : "";
+    const createdAt = typeof meta.createdAt === "string" && meta.createdAt ? meta.createdAt : fallbackCreatedAt;
+
+    candidates.push({
+      id,
+      jsonPath,
+      logPath,
+      createdAt,
+      displayedCreatedAt: typeof meta.createdAt === "string" && meta.createdAt ? meta.createdAt : createdAt,
+      startedAt: typeof meta.startedAt === "string" ? meta.startedAt : "",
+      updatedAt: typeof meta.updatedAt === "string" ? meta.updatedAt : "",
+      completedAt: typeof meta.completedAt === "string" ? meta.completedAt : "",
+      status: typeof meta.status === "string" ? meta.status : "unknown",
+      phase: typeof meta.phase === "string" ? meta.phase : "unknown",
+      summary: typeof meta.summary === "string" ? meta.summary : "",
+      threadId: typeof meta.threadId === "string" ? meta.threadId : "",
+      write: typeof meta.write === "boolean" ? meta.write : false
+    });
   }
 
   candidates.sort((a, b) => {
     if (a.createdAt === b.createdAt) {
-      return a.id.localeCompare(b.id);
+      return b.id.localeCompare(a.id);
     }
     return a.createdAt < b.createdAt ? 1 : -1;
   });
@@ -194,28 +213,35 @@ function scanForNewJob() {
   }
 
   if (!currentJob) {
-    switchToJob(newest, false);
+    switchToJob(newest);
     return;
   }
 
-  if (newest.createdAt > currentJob.createdAt) {
+  if (
+    newest.createdAt > currentJob.createdAt ||
+    (newest.createdAt === currentJob.createdAt && newest.id.localeCompare(currentJob.id) > 0)
+  ) {
     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 +261,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,61 +381,72 @@ 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;
+  }
+
   let meta = null;
   try {
     meta = JSON.parse(fs.readFileSync(currentJob.jsonPath, "utf8"));
   } catch (_error) {
-    return false;
+    return;
   }
 
   const status = typeof meta.status === "string" ? meta.status : "unknown";
-  if (completionBannerPrinted || !isTerminalStatus(status)) {
-    return true;
+  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;
   }
 
-  const createdAt = typeof meta.createdAt === "string" && meta.createdAt ? meta.createdAt : currentJob.displayedCreatedAt;
-  const updatedAt = typeof meta.updatedAt === "string" && meta.updatedAt ? meta.updatedAt : "";
-  const elapsed = formatElapsed(createdAt, updatedAt);
+  printCompletionBanner(meta, currentJob.displayedCreatedAt);
+  completionBannerPrinted = true;
+}
+
+function printCompletionBanner(job, fallbackCreatedAt) {
+  const status = typeof job.status === "string" ? job.status : "unknown";
+  const createdAt = typeof job.createdAt === "string" && job.createdAt ? job.createdAt : fallbackCreatedAt;
+  const startedAt = typeof job.startedAt === "string" && job.startedAt ? job.startedAt : createdAt;
+  const updatedAt = typeof job.updatedAt === "string" && job.updatedAt ? job.updatedAt : "";
+  const completedAt = typeof job.completedAt === "string" && job.completedAt ? job.completedAt : updatedAt;
+  const elapsed = formatElapsed(startedAt, completedAt);
   if (status === "completed") {
     console.log(color("green", "✓ completed · " + elapsed));
   } else {
     console.log(color("red", "✗ " + status + " · " + elapsed));
   }
-  completionBannerPrinted = true;
-  return true;
 }
 
 function isTerminalStatus(status) {
-  return status !== "running" && status !== "queued" && status !== "pending";
+  return status !== "running" && status !== "queued";
 }
 
 function readFileText(file) {
@@ -332,16 +463,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 +497,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 +556,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.1",
   "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"
   },