claude-code-kanban 3.10.0 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "3.10.0",
+  "version": "4.0.0",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {

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

@@ -1,5 +1,5 @@
 {
   "name": "claude-code-kanban",
-  "version": "1.1.5",
+  "version": "2.0.0",
   "description": "Agent activity tracking for claude-code-kanban dashboard"
 }

package/plugin/plugins/claude-code-kanban/scripts/agent-spy.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
-# Tracks subagent lifecycle: one JSON file per agent, grouped by session
-# Layout: ~/.claude/.cck/agent-activity/{sessionId}/{agentId}.json
+# Tracks subagent lifecycle: one append-only JSONL file per agent, grouped by session
+# Layout: ~/.claude/.cck/agent-activity/{sessionId}/{agentId}.jsonl
+# Each line is a lifecycle event (start | idle | stop). Server folds last-line-wins.
 
 INPUT=$(cat)
 
@@ -70,23 +71,16 @@ if [ "$EVENT" = "TeammateIdle" ] && [ -z "$AGENT_ID" ] && [ -n "$TEAMMATE_NAME"
   [ ! -f "$MAP_FILE" ] && exit 0
   AGENT_ID=$(cat "$MAP_FILE")
   [ -z "$AGENT_ID" ] && exit 0
-  FILE="$DIR/$AGENT_ID.json"
+  FILE="$DIR/$AGENT_ID.jsonl"
   TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-  STARTED_AT="$TS"
-  if [ -f "$FILE" ]; then
-    PREV_START=$(jq -r '.startedAt // ""' "$FILE" 2>/dev/null)
-    [ -n "$PREV_START" ] && STARTED_AT="$PREV_START"
-  fi
-  cat > "$FILE" <<EOF
-{"agentId":"$AGENT_ID","type":"$TEAMMATE_NAME","status":"idle","startedAt":"$STARTED_AT","updatedAt":"$TS"}
-EOF
+  echo "{\"agentId\":\"$AGENT_ID\",\"type\":\"$TEAMMATE_NAME\",\"event\":\"idle\",\"status\":\"idle\",\"updatedAt\":\"$TS\"}" >> "$FILE"
   exit 0
 fi
 
 [ -z "$AGENT_ID" ] && exit 0
 
 DIR="$CCK_ACTIVITY/$SESSION_ID"
-FILE="$DIR/$AGENT_ID.json"
+FILE="$DIR/$AGENT_ID.jsonl"
 
 # On Start: skip if no type (internal agents like AskUserQuestion)
 # On Stop/Idle: only skip if no existing file (never tracked)
@@ -102,48 +96,19 @@ mkdir -p "$DIR"
 TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 
 if [ "$EVENT" = "SubagentStart" ]; then
-  cat > "$FILE" <<EOF
-{"agentId":"$AGENT_ID","type":"$AGENT_TYPE_RAW","status":"active","startedAt":"$TS","updatedAt":"$TS"}
-EOF
-  # Write name→id mapping for TeammateIdle resolution
-  # Delete previous file only if not active (idle/stopped = teammate re-spawn, active = parallel subagent)
+  echo "{\"agentId\":\"$AGENT_ID\",\"type\":\"$AGENT_TYPE_RAW\",\"event\":\"start\",\"status\":\"active\",\"startedAt\":\"$TS\",\"updatedAt\":\"$TS\"}" >> "$FILE"
+  # Mapping always points at latest agent of this type (used by TeammateIdle resolution).
   if [ -n "$AGENT_TYPE_RAW" ]; then
-    MAP_FILE="$DIR/_name-${AGENT_TYPE_RAW}.id"
-    if [ -f "$MAP_FILE" ]; then
-      OLD_ID=$(cat "$MAP_FILE")
-      if [ -n "$OLD_ID" ] && [ "$OLD_ID" != "$AGENT_ID" ]; then
-        OLD_FILE="$DIR/$OLD_ID.json"
-        OLD_STATUS=""
-        [ -f "$OLD_FILE" ] && OLD_STATUS=$(jq -r '.status // ""' "$OLD_FILE" 2>/dev/null)
-        [ "$OLD_STATUS" != "active" ] && rm -f "$OLD_FILE"
-      fi
-    fi
-    echo -n "$AGENT_ID" > "$MAP_FILE"
+    echo -n "$AGENT_ID" > "$DIR/_name-${AGENT_TYPE_RAW}.id"
   fi
 
 elif [ "$EVENT" = "SubagentStop" ]; then
-  AGENT_TYPE="$AGENT_TYPE_RAW"
-  STARTED_AT="$TS"
-  if [ -f "$FILE" ]; then
-    eval "$(jq -r '@sh "PREV_TYPE=\(.type // "unknown")", @sh "PREV_START=\(.startedAt // "")"' "$FILE")"
-    [ -z "$AGENT_TYPE" ] && AGENT_TYPE="$PREV_TYPE"
-    [ -n "$PREV_START" ] && STARTED_AT="$PREV_START"
-  fi
   echo "$INPUT" | jq -c \
-    --arg id "$AGENT_ID" --arg type "$AGENT_TYPE" --arg started "$STARTED_AT" --arg ts "$TS" \
-    '{agentId: $id, type: $type, status: "stopped", startedAt: $started,
+    --arg id "$AGENT_ID" --arg type "$AGENT_TYPE_RAW" --arg ts "$TS" \
+    '{agentId: $id, type: $type, event: "stop", status: "stopped",
       lastMessage: (.last_assistant_message // ""), stoppedAt: $ts, updatedAt: $ts}' \
-    > "$FILE"
+    >> "$FILE"
 
 elif [ "$EVENT" = "TeammateIdle" ]; then
-  AGENT_TYPE="$AGENT_TYPE_RAW"
-  STARTED_AT="$TS"
-  if [ -f "$FILE" ]; then
-    eval "$(jq -r '@sh "PREV_TYPE=\(.type // "unknown")", @sh "PREV_START=\(.startedAt // "")"' "$FILE")"
-    [ -z "$AGENT_TYPE" ] && AGENT_TYPE="$PREV_TYPE"
-    [ -n "$PREV_START" ] && STARTED_AT="$PREV_START"
-  fi
-  cat > "$FILE" <<EOF
-{"agentId":"$AGENT_ID","type":"$AGENT_TYPE","status":"idle","startedAt":"$STARTED_AT","updatedAt":"$TS"}
-EOF
+  echo "{\"agentId\":\"$AGENT_ID\",\"type\":\"$AGENT_TYPE_RAW\",\"event\":\"idle\",\"status\":\"idle\",\"updatedAt\":\"$TS\"}" >> "$FILE"
 fi

package/public/app.js

@@ -2458,6 +2458,7 @@ function renderSessions() {
     const showCtx = !!session.contextStatus;
     const linkedDocsCount = getSessionPreviewPaths(session.id).length;
     const bookmarksCount = loadPins(session.id).length;
+    const hasScratchpad = !!(localStorage.getItem(_sessionScratchpadKey(session.id)) || '').trim();
     const tempClass = session.hasRecentLog || session.inProgress || session.hasWaitingForUser ? 'warm' : 'stale';
     return `
           <button onclick="fetchTasks('${session.id}')" data-session-id="${session.id}" class="session-item ${isActive ? 'active' : ''} ${session.hasWaitingForUser ? 'permission-pending' : ''} ${tempClass} ${showCtx ? 'has-context' : ''}" title="${tooltip}">
@@ -2474,6 +2475,7 @@ function renderSessions() {
                 ${session.hasPlan ? `<span class="plan-indicator" onclick="event.stopPropagation(); openPlanForSession('${session.id}')" title="View plan"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg></span>` : ''}
                 ${linkedDocsCount > 0 ? `<span class="linked-docs-badge" onclick="event.stopPropagation(); showSessionInfoModal('${session.id}')" title="${linkedDocsCount} linked document${linkedDocsCount > 1 ? 's' : ''}">${linkSvg(10)}${linkedDocsCount}</span>` : ''}
                 ${bookmarksCount > 0 ? `<span class="bookmarks-badge" onclick="event.stopPropagation(); openSessionWithBookmarks('${session.id}')" title="${bookmarksCount} bookmarked message${bookmarksCount > 1 ? 's' : ''}"><svg width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 21l-7-5-7 5V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z"/></svg>${bookmarksCount}</span>` : ''}
+                ${hasScratchpad ? `<span class="scratchpad-badge" onclick="event.stopPropagation(); openSessionScratchpad('${session.id}')" title="Open scratchpad"><svg width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg></span>` : ''}
                 ${session.hasRunningAgents ? '<span class="agent-badge" title="Active agents">🤖</span>' : ''}
                 ${session.planSourceSessionId ? `<span class="plan-indicator" title="Implements plan — click to reveal plan session" onclick="event.stopPropagation(); revealPlanSession('${escapeHtml(session.planSourceSessionId)}')">📋</span>` : ''}
                 ${session.hasWaitingForUser ? '<span class="agent-badge" title="Waiting for user">❓</span>' : ''}
@@ -3613,9 +3615,17 @@ const _scratchpadCharcount = document.getElementById('scratchpad-charcount');
 
 let _scratchpadKeyOverride = null;
 
+function _sessionScratchpadKey(sessionId) {
+  return `scratchpad-${sessionId}`;
+}
+
+function _isSessionScratchpadKey(key) {
+  return key.startsWith('scratchpad-') && !key.startsWith('scratchpad-project:');
+}
+
 function _scratchpadKey() {
   if (_scratchpadKeyOverride) return _scratchpadKeyOverride;
-  if (currentSessionId) return `scratchpad-${currentSessionId}`;
+  if (currentSessionId) return _sessionScratchpadKey(currentSessionId);
   if (currentProjectPath) return `scratchpad-project:${currentProjectPath}`;
   return null;
 }
@@ -3628,6 +3638,11 @@ function toggleScratchpad() {
   }
 }
 
+// biome-ignore lint/correctness/noUnusedVariables: used in HTML onclick
+function openSessionScratchpad(sessionId) {
+  showScratchpad(_sessionScratchpadKey(sessionId));
+}
+
 function showScratchpad(keyOverride) {
   _scratchpadKeyOverride = keyOverride || null;
   const key = _scratchpadKey();
@@ -3652,11 +3667,16 @@ function saveScratchpad() {
   const key = _scratchpadKey();
   if (!key) return;
   const val = _scratchpadTextarea.value;
-  if (val.trim()) {
+  const had = !!(localStorage.getItem(key) || '').trim();
+  const has = !!val.trim();
+  if (has) {
     localStorage.setItem(key, val);
   } else {
     localStorage.removeItem(key);
   }
+  if (had !== has && _isSessionScratchpadKey(key)) {
+    renderSessions();
+  }
 }
 
 _scratchpadTextarea.addEventListener('input', () => {
@@ -4075,7 +4095,7 @@ function _findOrphanedKeys() {
     const key = localStorage.key(i);
     if (key.startsWith('pinned-messages-')) {
       if (!known.has(key.slice('pinned-messages-'.length))) orphaned.push(key);
-    } else if (key.startsWith('scratchpad-') && !key.startsWith('scratchpad-project:')) {
+    } else if (_isSessionScratchpadKey(key)) {
       if (!known.has(key.slice('scratchpad-'.length))) orphaned.push(key);
     } else if (key.startsWith(PREVIEW_STORAGE_PREFIX)) {
       if (!known.has(key.slice(PREVIEW_STORAGE_PREFIX.length))) orphaned.push(key);

package/public/style.css

@@ -2536,7 +2536,8 @@ body::before {
 }
 
 .linked-docs-badge,
-.bookmarks-badge {
+.bookmarks-badge,
+.scratchpad-badge {
   display: inline-flex;
   align-items: center;
   gap: 2px;
@@ -2552,7 +2553,8 @@ body::before {
 }
 
 .linked-docs-badge:hover,
-.bookmarks-badge:hover {
+.bookmarks-badge:hover,
+.scratchpad-badge:hover {
   border-color: var(--accent);
   color: var(--text-primary);
 }

package/server.js

@@ -102,12 +102,19 @@ const SESSION_STALE_MS = 300000;
 
 const WAITING_RESOLVE_GRACE_MS = 15000;
 
+function readAgentJsonl(filePath) {
+  const raw = readFileSync(filePath, 'utf8');
+  const merged = {};
+  for (const line of raw.split(/\r?\n/)) {
+    if (!line.trim()) continue;
+    try { Object.assign(merged, JSON.parse(line)); } catch (_) { /* skip malformed */ }
+  }
+  return merged;
+}
+
 function persistAgent(dir, agent) {
-  const file = path.join(dir, agent.agentId + '.json');
-  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
-  fs.writeFile(tmp, JSON.stringify(agent), 'utf8')
-    .then(() => fs.rename(tmp, file))
-    .catch(() => { fs.unlink(tmp).catch(() => {}); });
+  const file = path.join(dir, agent.agentId + '.jsonl');
+  fs.appendFile(file, JSON.stringify({ ...agent, event: 'server-update' }) + '\n', 'utf8').catch(() => {});
 }
 
 function checkWaitingForUser(agentDir, logMtime) {
@@ -125,6 +132,10 @@ function checkWaitingForUser(agentDir, logMtime) {
   return null;
 }
 
+function agentDisplayName(agent) {
+  return agent.type || agent.name;
+}
+
 function isGhostAgent(agent) {
   if (agent.startedAt !== agent.updatedAt || agent.lastMessage) return false;
   return (Date.now() - new Date(agent.startedAt).getTime()) >= AGENT_STALE_MS;
@@ -156,9 +167,9 @@ function checkAgentStatus(agentDir, stale, logMtime, isTeam) {
   if (result.waitingForUser) result.hasActive = true;
   if (stale && !isTeam) return result;
   try {
-    for (const file of readdirSync(agentDir).filter(f => f.endsWith('.json') && !f.startsWith('_'))) {
+    for (const file of readdirSync(agentDir).filter(f => f.endsWith('.jsonl') && !f.startsWith('_'))) {
       try {
-        const agent = JSON.parse(readFileSync(path.join(agentDir, file), 'utf8'));
+        const agent = readAgentJsonl(path.join(agentDir, file));
         if (isTeam && (agent.status === 'active' || agent.status === 'idle')) {
           result.hasActive = true;
           if (agent.status === 'active') result.hasRunning = true;
@@ -1050,17 +1061,17 @@ app.get('/api/sessions/:sessionId/agents', (req, res) => {
     const isTeam = !!teamConfig;
     const teamMemberNames = isTeam ? new Set(teamConfig.members.map(m => m.name)) : null;
 
-    const files = readdirSync(agentDir).filter(f => f.endsWith('.json') && !f.startsWith('_'));
+    const files = readdirSync(agentDir).filter(f => f.endsWith('.jsonl') && !f.startsWith('_'));
     const agents = [];
     for (const file of files) {
       try {
-        const agent = JSON.parse(readFileSync(path.join(agentDir, file), 'utf8'));
+        const agent = readAgentJsonl(path.join(agentDir, file));
         if (isGhostAgent(agent)) continue;
         const agentTs = agent.updatedAt || agent.startedAt;
         const agentStale = !sessionStale && agentTs && (Date.now() - new Date(agentTs).getTime()) > AGENT_STALE_MS;
         if (!isAgentFresh(agent) || sessionStale || agentStale) {
           if (agent.status === 'active' || agent.status === 'idle') {
-            const agentName = agent.type || agent.name;
+            const agentName = agentDisplayName(agent);
             const isTeamMember = isTeam && agentName && teamMemberNames.has(agentName);
             if (!isTeamMember) {
               agent.status = 'stopped';
@@ -1077,7 +1088,7 @@ app.get('/api/sessions/:sessionId/agents', (req, res) => {
         const terminated = getTerminatedTeammates(meta.jsonlPath);
         if (terminated.size) {
           for (const agent of liveAgents) {
-            const agentName = agent.type || agent.name;
+            const agentName = agentDisplayName(agent);
             if (agentName && terminated.has(agentName)) {
               const terminatedAt = terminated.get(agentName);
               if (terminatedAt && agent.startedAt && terminatedAt < agent.startedAt) continue;
@@ -1168,14 +1179,40 @@ app.get('/api/sessions/:sessionId/agents', (req, res) => {
       }
       if (Object.keys(teamColors).length) {
         for (const agent of agents) {
-          const name = agent.type || agent.name;
+          const name = agentDisplayName(agent);
           if (name && teamColors[name]) agent.color = teamColors[name];
         }
       }
     }
 
+    // Collapse teammate re-spawns: when a teammate goes idle and is later re-engaged,
+    // a fresh agentId is spawned. Hide older idle/stopped entries when a newer same-name
+    // teammate exists; never hide an `active` agent (parallel teammate work would vanish).
+    // Subagents (Explore, general-purpose, etc.) are not in teamMemberNames and bypass
+    // dedup entirely, so parallel siblings of the same subagent type remain visible.
+    let visibleAgents = agents;
+    if (teamMemberNames && teamMemberNames.size) {
+      const groups = new Map();
+      for (const a of agents) {
+        const t = agentDisplayName(a);
+        if (!t || !teamMemberNames.has(t)) continue;
+        const list = groups.get(t) || [];
+        list.push(a);
+        groups.set(t, list);
+      }
+      const hidden = new Set();
+      for (const list of groups.values()) {
+        if (list.length < 2) continue;
+        list.sort((a, b) => new Date(b.startedAt || 0) - new Date(a.startedAt || 0));
+        for (const older of list.slice(1)) {
+          if (older.status === 'idle' || older.status === 'stopped') hidden.add(older.agentId);
+        }
+      }
+      if (hidden.size) visibleAgents = agents.filter(a => !hidden.has(a.agentId));
+    }
+
     const waitingForUser = checkWaitingForUser(agentDir, logMtime);
-    res.json({ agents, waitingForUser, teamColors });
+    res.json({ agents: visibleAgents, waitingForUser, teamColors });
   } catch (e) {
     res.json({ agents: [], waitingForUser: null });
   }
@@ -1184,13 +1221,14 @@ app.get('/api/sessions/:sessionId/agents', (req, res) => {
 app.post('/api/sessions/:sessionId/agents/:agentId/stop', (req, res) => {
   const sessionId = resolveSessionId(req.params.sessionId);
   const agentId = sanitizeAgentId(req.params.agentId);
-  const agentFile = path.join(AGENT_ACTIVITY_DIR, sessionId, agentId + '.json');
+  const agentFile = path.join(AGENT_ACTIVITY_DIR, sessionId, agentId + '.jsonl');
   if (!existsSync(agentFile)) return res.status(404).json({ error: 'Agent not found' });
   try {
-    const agent = JSON.parse(readFileSync(agentFile, 'utf8'));
+    const agent = readAgentJsonl(agentFile);
     agent.status = 'stopped';
     agent.stoppedAt = new Date().toISOString();
-    writeFileSync(agentFile, JSON.stringify(agent), 'utf8'); // sync — response depends on write
+    const stopEvt = { agentId, type: agent.type, event: 'user-stop', status: 'stopped', stoppedAt: agent.stoppedAt, updatedAt: agent.stoppedAt };
+    writeFileSync(agentFile, readFileSync(agentFile, 'utf8') + JSON.stringify(stopEvt) + '\n', 'utf8'); // sync — response depends on write
     // Also remove waiting state if present
     const waitingFile = path.join(AGENT_ACTIVITY_DIR, sessionId, '_waiting.json');
     if (existsSync(waitingFile)) unlinkSync(waitingFile);
@@ -1331,8 +1369,8 @@ app.get('/api/sessions/:sessionId/messages', (req, res) => {
         if (entry.description) msg.agentDescription = entry.description;
         if (entry.prompt && !msg.agentPrompt) msg.agentPrompt = entry.prompt;
         try {
-          const agentFile = path.join(agentDir, entry.agentId + '.json');
-          const agent = JSON.parse(readFileSync(agentFile, 'utf8'));
+          const agentFile = path.join(agentDir, entry.agentId + '.jsonl');
+          const agent = readAgentJsonl(agentFile);
           if (agent.lastMessage) msg.agentLastMessage = agent.lastMessage;
           if (agent.prompt && !msg.agentPrompt) msg.agentPrompt = agent.prompt;
           const prompt = msg.agentPrompt || entry.prompt;
@@ -1819,14 +1857,16 @@ const agentActivityWatcher = chokidar.watch(AGENT_ACTIVITY_DIR, {
 const AGENT_FILE_CAP = 20;
 
 agentActivityWatcher.on('all', (event, filePath) => {
-  if ((event === 'add' || event === 'change' || event === 'unlink') && filePath.endsWith('.json')) {
+  const base = path.basename(filePath);
+  const isAgentEvent = filePath.endsWith('.jsonl') || base === '_waiting.json';
+  if ((event === 'add' || event === 'change' || event === 'unlink') && isAgentEvent) {
     const relativePath = path.relative(AGENT_ACTIVITY_DIR, filePath);
     const sessionId = relativePath.split(path.sep)[0];
     // Cleanup: if session dir exceeds cap, delete oldest files by mtime
-    if (event === 'add') {
+    if (event === 'add' && filePath.endsWith('.jsonl')) {
       try {
         const sessionDir = path.join(AGENT_ACTIVITY_DIR, sessionId);
-        const files = readdirSync(sessionDir).filter(f => f.endsWith('.json') && !f.startsWith('_'));
+        const files = readdirSync(sessionDir).filter(f => f.endsWith('.jsonl') && !f.startsWith('_'));
         if (files.length > AGENT_FILE_CAP) {
           const withStats = files.map(f => {
             const fp = path.join(sessionDir, f);