claude-code-kanban 5.3.0 → 5.4.0

package/lib/parsers.js

@@ -4,6 +4,21 @@ const path = require('node:path');
 const os = require('node:os');
 const { StringDecoder } = require('node:string_decoder');
 
+// Full-transcript scans stream the file instead of reading it whole: a transcript can
+// reach hundreds of megabytes, and the event loop it would block also carries the
+// embedded terminal's keystrokes. Yields the same lines as content.split('\n').
+async function* readLines(file) {
+  const decoder = new StringDecoder('utf8');
+  let rest = '';
+  for await (const chunk of fs.createReadStream(file, { highWaterMark: 1 << 20 })) {
+    const parts = decoder.write(chunk).split('\n');
+    parts[0] = rest + parts[0];
+    rest = parts.pop();
+    yield* parts;
+  }
+  yield rest + decoder.end();
+}
+
 function parseTask(raw) {
   const task = typeof raw === 'string' ? JSON.parse(raw) : raw;
   return {
@@ -347,12 +362,24 @@ function scrapeScalarFromBlob(blob, re) {
 const sessionInfoCache = new Map();
 const SESSION_INFO_CACHE_MAX = 2000;
 
+// A prompt line carries the mode it was sent in. After a Shift+Tab, Claude Code writes an
+// auto_mode / auto_mode_exit attachment with the next tool result, and later rewrites a
+// permission-mode line with the live mode, often tens of seconds after.
+const modeOf = (data) => {
+  if (data.type === 'attachment') {
+    const t = data.attachment?.type;
+    return t === 'auto_mode' ? 'auto' : t === 'auto_mode_exit' ? 'default' : null;
+  }
+  return (data.type === 'user' || data.type === 'permission-mode') && data.permissionMode || null;
+};
+
 // gitBranch in the JSONL is pinned to the launch-time repo by Claude Code
 // and goes stale once cwd shifts (Bash `cd`, submodule). Callers needing the
 // live branch must resolve it from cwd separately. Cache is reset on inode
 // change or truncation (size < scannedUpTo).
+
 function readSessionInfoFromJsonl(jsonlPath) {
-  const result = { slug: null, projectPath: null, cwd: null, gitBranch: null, customTitle: null, logicalParentUuid: null, compactBoundaryUuid: null };
+  const result = { slug: null, projectPath: null, cwd: null, gitBranch: null, customTitle: null, logicalParentUuid: null, compactBoundaryUuid: null, permissionMode: null };
   let stat;
   let fd;
   try {
@@ -372,6 +399,7 @@ function readSessionInfoFromJsonl(jsonlPath) {
       gitBranch: cached.gitBranch,
       logicalParentUuid: cached.logicalParentUuid || null,
       compactBoundaryUuid: cached.compactBoundaryUuid || null,
+      permissionMode: cached.permissionMode || null,
       customTitle: readCustomTitle(jsonlPath, stat)
     };
   }
@@ -383,6 +411,7 @@ function readSessionInfoFromJsonl(jsonlPath) {
     result.gitBranch = cached.gitBranch;
     result.logicalParentUuid = cached.logicalParentUuid || null;
     result.compactBoundaryUuid = cached.compactBoundaryUuid || null;
+    result.permissionMode = cached.permissionMode || null;
   }
 
   let lastCwdSeen = result.cwd;
@@ -395,6 +424,8 @@ function readSessionInfoFromJsonl(jsonlPath) {
         lastCwdSeen = data.cwd;
       }
       if (data.gitBranch) result.gitBranch = data.gitBranch;
+      const mode = modeOf(data);
+      if (mode) result.permissionMode = mode;
       if (data.subtype === 'compact_boundary' && data.logicalParentUuid && !result.logicalParentUuid) {
         result.logicalParentUuid = data.logicalParentUuid;
         // The boundary record's own uuid: a fork copies it verbatim from the
@@ -466,6 +497,7 @@ function readSessionInfoFromJsonl(jsonlPath) {
         const tn = fs.readSync(fd, tailBuf, 0, TAIL_SIZE, tailStart);
         const lines = tailBuf.toString('utf8', 0, tn).split('\n');
         let latestTailCwd = null;
+        let latestTailMode = null;
         for (let i = lines.length - 1; i >= 0; i--) {
           try {
             const data = JSON.parse(lines[i]);
@@ -473,10 +505,12 @@ function readSessionInfoFromJsonl(jsonlPath) {
             if (!result.projectPath && data.cwd) result.projectPath = data.cwd;
             if (!result.gitBranch && data.gitBranch) result.gitBranch = data.gitBranch;
             if (!latestTailCwd && data.cwd) latestTailCwd = data.cwd;
-            if (latestTailCwd && result.slug && result.projectPath && result.gitBranch) break;
+            if (!latestTailMode) latestTailMode = modeOf(data);
+            if (latestTailCwd && latestTailMode && result.slug && result.projectPath && result.gitBranch) break;
           } catch {}
         }
         if (latestTailCwd) lastCwdSeen = latestTailCwd;
+        if (latestTailMode) result.permissionMode = latestTailMode;
       }
       scannedUpTo = stat.size;
     }
@@ -498,7 +532,8 @@ function readSessionInfoFromJsonl(jsonlPath) {
       gitBranch: result.gitBranch,
       cwd: result.cwd,
       logicalParentUuid: result.logicalParentUuid,
-      compactBoundaryUuid: result.compactBoundaryUuid
+      compactBoundaryUuid: result.compactBoundaryUuid,
+      permissionMode: result.permissionMode
     });
     if (sessionInfoCache.size > SESSION_INFO_CACHE_MAX) {
       const firstKey = sessionInfoCache.keys().next().value;
@@ -1064,12 +1099,10 @@ function readRecentMessages(jsonlPath, limit = 10) {
   }
 }
 
-function readFullToolResult(jsonlPath, toolUseId) {
+async function readFullToolResult(jsonlPath, toolUseId) {
   if (!toolUseId || !jsonlPath || !existsSync(jsonlPath)) return null;
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
-    const lines = content.split('\n');
-    for (const line of lines) {
+    for await (const line of readLines(jsonlPath)) {
       if (!line || line.indexOf(toolUseId) === -1) continue;
       try {
         const obj = JSON.parse(line);
@@ -1092,14 +1125,12 @@ function readFullToolResult(jsonlPath, toolUseId) {
   return null;
 }
 
-function readUserImage(jsonlPath, msgUuid, blockIndex) {
+async function readUserImage(jsonlPath, msgUuid, blockIndex) {
   if (!msgUuid || !jsonlPath) return null;
   const idx = Number(blockIndex);
   if (!Number.isInteger(idx) || idx < 0) return null;
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
-    const lines = content.split('\n');
-    for (const line of lines) {
+    for await (const line of readLines(jsonlPath)) {
       if (!line || line.indexOf(msgUuid) === -1) continue;
       try {
         const obj = JSON.parse(line);
@@ -1119,14 +1150,12 @@ function readUserImage(jsonlPath, msgUuid, blockIndex) {
 
 // Read the Nth base64 image embedded in a tool_result block (e.g. the output of
 // a Read on an image file). Scans for the tool_result matching toolUseId.
-function readToolResultImage(jsonlPath, toolUseId, n) {
+async function readToolResultImage(jsonlPath, toolUseId, n) {
   if (!toolUseId || !jsonlPath) return null;
   const idx = Number(n);
   if (!Number.isInteger(idx) || idx < 0) return null;
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
-    const lines = content.split('\n');
-    for (const line of lines) {
+    for await (const line of readLines(jsonlPath)) {
       if (!line || line.indexOf(toolUseId) === -1) continue;
       let obj;
       try { obj = JSON.parse(line); } catch (_) { continue; }
@@ -1196,14 +1225,13 @@ function readMessagesPage(jsonlPath, limit = 10, beforeTimestamp = null) {
   };
 }
 
-function buildSessionDigest(jsonlPath) {
+async function buildSessionDigest(jsonlPath) {
   const map = {};
   const terminated = new Map();
   const rejectedToolUseIds = new Set();
   const promptByToolUseId = {};
   const killedAgentIds = new Set();
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
     const re = /"type":"agent_progress"[^}]*"agentId":"([^"]+)"/;
     const parentRe = /"parentToolUseID":"([^"]+)"/;
     const promptRe = /"prompt":"((?:[^"\\]|\\.)*)"/;
@@ -1215,7 +1243,7 @@ function buildSessionDigest(jsonlPath) {
     const nameByToolUseId = {};
     const descByToolUseId = {};
     const usageByToolUseId = {};
-    for (const line of content.split('\n')) {
+    for await (const line of readLines(jsonlPath)) {
       // Terminated-teammate detection: check first since cheap substring guards
       if (line.includes('teammate-message') &&
           (line.includes('teammate_terminated') || line.includes('shutdown_response'))) {
@@ -1346,8 +1374,8 @@ function buildSessionDigest(jsonlPath) {
   return { progressMap: map, terminated, rejectedAgentIds, rejectedPrompts, killedAgentIds };
 }
 
-function buildAgentProgressMap(jsonlPath) {
-  return buildSessionDigest(jsonlPath).progressMap;
+async function buildAgentProgressMap(jsonlPath) {
+  return (await buildSessionDigest(jsonlPath)).progressMap;
 }
 
 const ARTIFACT_URL_RE = /https:\/\/claude\.ai\/\S*artifact\/[A-Za-z0-9_-]+/;
@@ -1365,7 +1393,7 @@ function toolResultText(content) {
 // only when its tool_use_id belongs to a publish call — an artifact URL quoted
 // back by a grep or a file read would otherwise register another session's page as
 // this session's own, and a `read` of someone else's artifact is not a publish.
-function readArtifactLinks(jsonlPath) {
+async function readArtifactLinks(jsonlPath) {
   const byUrl = new Map();
   const publishedFileByToolUseId = new Map();
   const upsert = (url, ts) => {
@@ -1378,8 +1406,7 @@ function readArtifactLinks(jsonlPath) {
     return a;
   };
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
-    for (const line of content.split('\n')) {
+    for await (const line of readLines(jsonlPath)) {
       if (!line.includes('"frame-link"') && !line.includes('"name":"Artifact"') && !line.includes('claude.ai'))
         continue;
       let obj;
@@ -1426,11 +1453,10 @@ const SCRATCH_NAME_RE = /\bscratch\s+new\s+(?:"([^"]+)"|'([^']+)'|(?!-)(\S+))/;
 // the manifest is the 4th of ~13 printed lines, so any `| tail -N` cuts it off. `name`
 // stands in because it is what the manifest stores as its own `name`; the path is not
 // recovered from the command, which would mean tracking the `cd` and a relative `--dir`.
-function readScratchpadCreations(jsonlPath) {
+async function readScratchpadCreations(jsonlPath) {
   const calls = new Map();
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
-    for (const line of content.split('\n')) {
+    for await (const line of readLines(jsonlPath)) {
       // Substring reject before JSON.parse: transcripts reach tens of megabytes and
       // only a handful of lines can ever match.
       const isCall = line.includes('scratch new');
@@ -1456,13 +1482,12 @@ function readScratchpadCreations(jsonlPath) {
   return [...calls.values()];
 }
 
-function readCompactSummaries(jsonlPath) {
+async function readCompactSummaries(jsonlPath) {
   const results = [];
   // Inline format: newer Claude Code stores the summary directly in the parent
   // session JSONL as a user message with isCompactSummary: true (no subagent file).
   try {
-    const content = readFileSync(jsonlPath, 'utf8');
-    for (const line of content.split('\n')) {
+    for await (const line of readLines(jsonlPath)) {
       if (!line.trim() || !line.includes('isCompactSummary')) continue;
       try {
         const obj = JSON.parse(line);
@@ -1515,8 +1540,8 @@ function readCompactSummaries(jsonlPath) {
   return results.sort((a, b) => (a.timestamp || '').localeCompare(b.timestamp || ''));
 }
 
-function findTerminatedTeammates(jsonlPath) {
-  return buildSessionDigest(jsonlPath).terminated;
+async function findTerminatedTeammates(jsonlPath) {
+  return (await buildSessionDigest(jsonlPath)).terminated;
 }
 
 function extractPromptFromTranscript(jsonlPath) {
@@ -1585,28 +1610,28 @@ function extractModelFromTranscript(jsonlPath) {
 // output tokens, and first/last timestamps (for duration). COLD PATH ONLY —
 // used by the workflow run view on demand, never from the session-scan hot
 // path (a full read per agent would blow the /api/sessions budget).
-function extractTranscriptStats(jsonlPath) {
-  let content;
-  try { content = readFileSync(jsonlPath, 'utf8'); } catch (_) { return null; }
+async function extractTranscriptStats(jsonlPath) {
   let model = null;
   let outputTokens = 0;
   let firstTs = null;
   let lastTs = null;
-  for (const line of content.split('\n')) {
-    if (!line.trim()) continue;
-    let obj;
-    try { obj = JSON.parse(line); } catch (_) { continue; }
-    if (obj.timestamp) {
-      if (!firstTs) firstTs = obj.timestamp;
-      lastTs = obj.timestamp;
-    }
-    const msg = obj.message;
-    if (msg && typeof msg === 'object') {
-      if (!model && msg.model) model = msg.model;
-      const out = msg.usage?.output_tokens;
-      if (typeof out === 'number') outputTokens += out;
+  try {
+    for await (const line of readLines(jsonlPath)) {
+      if (!line.trim()) continue;
+      let obj;
+      try { obj = JSON.parse(line); } catch (_) { continue; }
+      if (obj.timestamp) {
+        if (!firstTs) firstTs = obj.timestamp;
+        lastTs = obj.timestamp;
+      }
+      const msg = obj.message;
+      if (msg && typeof msg === 'object') {
+        if (!model && msg.model) model = msg.model;
+        const out = msg.usage?.output_tokens;
+        if (typeof out === 'number') outputTokens += out;
+      }
     }
-  }
+  } catch (_) { return null; }
   return { model, outputTokens, firstTs, lastTs };
 }
 
@@ -1625,7 +1650,9 @@ function formatStructuredResult(input) {
 // Some subagents end their run on a tool call and never emit a text response, so
 // their lastMessage is empty: workflow subagents given a schema call StructuredOutput,
 // background subagents report through SubagentHandback. Tail-read the transcript and
-// take the LAST such tool_use as the agent's result. Returns null when absent.
+// take the LAST such tool_use as the agent's result. Without one, take the last
+// assistant text: the plugin's mod records no lastMessage, because Claude Code's
+// turn.complete carries an empty answer for a subagent. Returns null when neither exists.
 const RESULT_TOOLS = {
   StructuredOutput: formatStructuredResult,
   SubagentHandback: (input) => (typeof input.message === 'string' && input.message) || null,
@@ -1649,16 +1676,25 @@ function extractAgentResultFromTranscript(jsonlPath) {
     const text = buf.toString('utf8');
     // Drop the leading partial line unless we read from the very start.
     const clean = start > 0 ? text.slice(text.indexOf('\n') + 1) : text;
-    if (!RESULT_TOOL_TEXT.some((t) => clean.includes(t))) return null;
     const lines = clean.split('\n');
-    for (let i = lines.length - 1; i >= 0; i--) {
-      if (!RESULT_TOOL_TEXT.some((t) => lines[i].includes(t))) continue;
-      let obj;
-      try { obj = JSON.parse(lines[i]); } catch (_) { continue; }
-      const content = obj?.message?.content;
-      const result = Array.isArray(content) && content.map(resultFromBlock).findLast(Boolean);
-      if (result) return result;
-    }
+    const lastAssistant = (needle, pick) => {
+      for (let i = lines.length - 1; i >= 0; i--) {
+        if (!needle(lines[i])) continue;
+        let obj;
+        try { obj = JSON.parse(lines[i]); } catch (_) { continue; }
+        const content = obj?.message?.content;
+        const found = obj?.type === 'assistant' && Array.isArray(content) && pick(content);
+        if (found) return found;
+      }
+      return null;
+    };
+    return lastAssistant(
+      (line) => RESULT_TOOL_TEXT.some((t) => line.includes(t)),
+      (content) => content.map(resultFromBlock).findLast(Boolean),
+    ) ?? lastAssistant(
+      (line) => line.includes('"type":"assistant"'),
+      (content) => toolResultText(content).trim(),
+    );
   } catch (_) {
   } finally {
     closeSync(fd);
@@ -1831,5 +1867,6 @@ module.exports = {
   extractPromptFromTranscript,
   extractModelFromTranscript,
   extractAgentResultFromTranscript,
-  extractTranscriptStats
+  extractTranscriptStats,
+  readLines
 };

package/lib/plugin-status.js

@@ -31,7 +31,7 @@ function pluginStatus(claudeDir, bundledManifest = BUNDLED_MANIFEST) {
 
 // --dir rather than CLAUDE_CONFIG_DIR=…, so the same line runs in bash, PowerShell and cmd.
 function installCommand(claudeDir) {
-  const base = 'claude-code-kanban --install --plugin-only';
+  const base = 'claude-code-kanban --install --yes';
   return isDefaultClaudeDir(claudeDir) ? base : `${base} --dir "${claudeDir}"`;
 }
 

package/lib/session-cache.js

@@ -4,7 +4,7 @@ const { exportParentVerdicts, importParentVerdicts, parentVerdictsDirty } = requ
 const { exportTaskCounts, importTaskCounts, taskCountsDirty } = require('./task-counts');
 
 // Bump when an entry's shape or meaning changes: a file with another version is ignored.
-const VERSION = 2;
+const VERSION = 3;
 // A cache this large is not one cck wrote for a normal set of transcripts. Rebuild it cold.
 const MAX_BYTES = 8 * 1024 * 1024;
 

package/lib/terminal.js

@@ -552,8 +552,9 @@ function createTerminalService(o) {
     const cols = clampDim(msg.cols, 80);
     const rows = clampDim(msg.rows, 24);
 
+    // An ended PTY stays in the map until its process exits; a hello for its id starts a new one.
     const existing = sessions.get(id);
-    if (existing) return attach(ws, existing, true);
+    if (existing && !existing.ended) return attach(ws, existing, true);
 
     if (mode === 'auto' && o.isLiveElsewhere(id)) {
       send(ws, { t: 'live' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "type": "commonjs",
@@ -11,7 +11,6 @@
     "start": "node server.js",
     "dev": "node --watch server.js",
     "test": "node --test test/*.test.js",
-    "test:hooks": "bash tests/test-agent-spy.sh && bash tests/test-approval-gate.sh",
     "validate:schemas": "node test/validate-live-schemas.js",
     "prepare": "husky"
   },

package/plugin/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     {
       "name": "claude-code-kanban",
       "source": "./plugins/claude-code-kanban",
-      "description": "claude-code-kanban dashboard integration: agent activity tracking, context statusline, and a skill to drive the board from a session"
+      "description": "claude-code-kanban dashboard integration: agent activity tracking, context and cost tracking, and a skill to drive the board from a session"
     }
   ]
 }

package/plugin/plugins/claude-code-kanban/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-kanban",
-  "version": "2.17.2",
-  "description": "claude-code-kanban dashboard integration: agent activity tracking, context statusline, skills to drive the board from a session and to follow it",
+  "version": "2.21.4",
+  "description": "claude-code-kanban dashboard integration: agent activity tracking, context and cost tracking, skills to drive the board from a session and to follow it",
   "experimental": {
     "monitors": "./monitors.json"
   }