claude-code-kanban 2.1.0 → 2.2.0-rc.1

package/hooks/agent-spy.sh

@@ -16,6 +16,24 @@ eval "$(echo "$INPUT" | jq -r '
 
 [ -z "$SESSION_ID" ] && exit 0
 
+# Map session to custom task list on session start
+if [ "$EVENT" = "SessionStart" ]; then
+  TASK_LIST_ID="${CLAUDE_CODE_TASK_LIST_ID:-}"
+  if [ -n "$TASK_LIST_ID" ]; then
+    CWD=$(echo "$INPUT" | jq -r '.cwd // ""')
+    MAPS_DIR="$HOME/.claude/agent-activity/_task-maps"
+    mkdir -p "$MAPS_DIR"
+    MAP_FILE="$MAPS_DIR/$TASK_LIST_ID.json"
+    TMP_FILE="$MAP_FILE.$$"
+    TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    EXISTING="{}"
+    [ -f "$MAP_FILE" ] && EXISTING=$(cat "$MAP_FILE")
+    echo "$EXISTING" | jq -c --arg sid "$SESSION_ID" --arg cwd "$CWD" --arg ts "$TS" \
+      '.[$sid] = {project: $cwd, updatedAt: $ts}' > "$TMP_FILE" && mv "$TMP_FILE" "$MAP_FILE"
+  fi
+  exit 0
+fi
+
 # PostToolUse / non-waiting PreToolUse: clear waiting state
 if [ "$EVENT" = "PostToolUse" ] || { [ "$EVENT" = "PreToolUse" ] && [ "$TOOL_NAME" != "AskUserQuestion" ]; }; then
   WFILE="$HOME/.claude/agent-activity/$SESSION_ID/_waiting.json"

package/install.js

@@ -17,6 +17,7 @@ const AGENT_ACTIVITY_DIR = path.join(CLAUDE_DIR, 'agent-activity');
 
 const HOOK_COMMAND = '~/.claude/hooks/agent-spy.sh';
 const HOOK_EVENTS = [
+  { event: 'SessionStart' },
   { event: 'SubagentStart' },
   { event: 'SubagentStop' },
   { event: 'TeammateIdle' },

package/package.json

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

package/public/app.js

@@ -1784,6 +1784,7 @@ function renderSessions() {
             <div class="session-progress">
               <span class="session-indicators">
                 ${isTeam ? `<span class="team-badge" title="${memberCount} team members"><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="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>${memberCount}</span>` : ''}
+                ${session.sharedTaskList ? `<span class="shared-tasklist-badge" title="Shared task list: ${escapeHtml(session.sharedTaskList)}"><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="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg></span>` : ''}
                 ${isTeam || session.project || showCtx ? `<span class="team-info-btn" onclick="event.stopPropagation(); showSessionInfoModal('${session.id}')" title="View session info">ℹ</span>` : ''}
                 ${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>` : ''}
                 ${session.hasRunningAgents ? '<span class="agent-badge" title="Active agents">🤖</span>' : ''}
@@ -3804,6 +3805,9 @@ function showInfoModal(session, teamConfig, tasks, planContent) {
   if (session.tasksDir) {
     infoRows.push(['Tasks Dir', session.tasksDir, { openPath: session.tasksDir }]);
   }
+  if (session.sharedTaskList) {
+    infoRows.push(['Shared Tasks', session.sharedTaskList]);
+  }
   if (teamConfig?.configPath) {
     const configDir = teamConfig.configPath.replace(/[/\\][^/\\]+$/, '');
     infoRows.push(['Team Config', teamConfig.configPath, { openPath: configDir, openFile: teamConfig.configPath }]);

package/public/style.css

@@ -1578,6 +1578,13 @@ body::before {
   font-weight: 600;
 }
 
+.shared-tasklist-badge {
+  display: inline-flex;
+  align-items: center;
+  color: var(--accent);
+  flex-shrink: 0;
+}
+
 .team-info-btn {
   width: 24px;
   height: 24px;

package/server.js

@@ -189,6 +189,9 @@ const terminatedCache = new Map();
 const compactSummaryCache = new Map();
 const taskCountsCache = new Map();
 const contextStatusCache = new Map();
+const TASK_MAPS_DIR = path.join(AGENT_ACTIVITY_DIR, '_task-maps');
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUUID(s) { return UUID_RE.test(s); }
 
 function evictStaleCache(cache) {
   if (cache.size <= MAX_CACHE_ENTRIES) return;
@@ -196,6 +199,47 @@ function evictStaleCache(cache) {
   if (oldest !== undefined) cache.delete(oldest);
 }
 
+let sessionToTaskListCache = null;
+let lastTaskMapScan = 0;
+const TASK_MAP_SCAN_TTL = 5000;
+
+function loadAllTaskMaps() {
+  const now = Date.now();
+  if (sessionToTaskListCache && now - lastTaskMapScan < TASK_MAP_SCAN_TTL) return sessionToTaskListCache;
+
+  const sessionToList = {};
+  const listToSessions = {};
+  if (!existsSync(TASK_MAPS_DIR)) {
+    sessionToTaskListCache = { sessionToList, listToSessions };
+    lastTaskMapScan = now;
+    return sessionToTaskListCache;
+  }
+  try {
+    for (const file of readdirSync(TASK_MAPS_DIR).filter(f => f.endsWith('.json'))) {
+      const taskListName = file.replace(/\.json$/, '');
+      const mapPath = path.join(TASK_MAPS_DIR, file);
+      try {
+        const map = JSON.parse(readFileSync(mapPath, 'utf8'));
+        listToSessions[taskListName] = map;
+        for (const sessionId of Object.keys(map)) {
+          sessionToList[sessionId] = taskListName;
+        }
+      } catch (e) { /* skip invalid */ }
+    }
+  } catch (e) { /* ignore */ }
+  sessionToTaskListCache = { sessionToList, listToSessions };
+  lastTaskMapScan = now;
+  return sessionToTaskListCache;
+}
+
+function getCustomTaskDir(sessionId) {
+  const { sessionToList } = loadAllTaskMaps();
+  const taskListName = sessionToList[sessionId];
+  if (!taskListName) return null;
+  const dir = path.join(TASKS_DIR, taskListName);
+  return existsSync(dir) ? dir : null;
+}
+
 function getTaskCounts(sessionPath) {
   const cached = taskCountsCache.get(sessionPath);
   if (cached) return cached;
@@ -449,7 +493,7 @@ app.get('/api/sessions', async (req, res) => {
       const entries = readdirSync(TASKS_DIR, { withFileTypes: true });
 
       for (const entry of entries) {
-        if (entry.isDirectory()) {
+        if (entry.isDirectory() && isUUID(entry.name)) {
           const sessionPath = path.join(TASKS_DIR, entry.name);
           const stat = statSync(sessionPath);
           const { taskCount, completed, inProgress, pending, newestTaskMtime } = getTaskCounts(sessionPath);
@@ -497,6 +541,44 @@ app.get('/api/sessions', async (req, res) => {
           }));
         }
       }
+
+      // Process custom task lists (non-UUID directories mapped via _task-maps)
+      const { listToSessions } = loadAllTaskMaps();
+      for (const [taskListName, map] of Object.entries(listToSessions)) {
+        const customTaskDir = path.join(TASKS_DIR, taskListName);
+        if (!existsSync(customTaskDir)) continue;
+        const counts = getTaskCounts(customTaskDir);
+
+        for (const [sessionId, info] of Object.entries(map)) {
+          const existing = sessionsMap.get(sessionId);
+          if (existing) {
+            Object.assign(existing, {
+              taskCount: counts.taskCount,
+              completed: counts.completed,
+              inProgress: counts.inProgress,
+              pending: counts.pending,
+              tasksDir: customTaskDir,
+              sharedTaskList: taskListName,
+            });
+            if (counts.newestTaskMtime) {
+              const taskMtime = counts.newestTaskMtime.toISOString();
+              if (taskMtime > existing.modifiedAt) existing.modifiedAt = taskMtime;
+            }
+          } else {
+            const meta = { ...(metadata[sessionId] || {}) };
+            if (!meta.project && info.project) meta.project = info.project;
+            sessionsMap.set(sessionId, buildSessionObject(sessionId, meta, {
+              taskCount: counts.taskCount,
+              completed: counts.completed,
+              inProgress: counts.inProgress,
+              pending: counts.pending,
+              modifiedAt: counts.newestTaskMtime ? counts.newestTaskMtime.toISOString() : (info.updatedAt || new Date(0).toISOString()),
+              tasksDir: customTaskDir,
+              sharedTaskList: taskListName,
+            }));
+          }
+        }
+      }
     }
 
     // Add sessions from metadata that don't have task directories
@@ -645,7 +727,8 @@ app.get('/api/projects', (req, res) => {
 // API: Get tasks for a session
 app.get('/api/sessions/:sessionId', async (req, res) => {
   try {
-    const sessionPath = path.join(TASKS_DIR, req.params.sessionId);
+    const customDir = getCustomTaskDir(req.params.sessionId);
+    const sessionPath = customDir || path.join(TASKS_DIR, req.params.sessionId);
 
     if (!existsSync(sessionPath)) {
       return res.status(404).json({ error: 'Session not found' });
@@ -1200,21 +1283,44 @@ const watcher = chokidar.watch(TASKS_DIR, {
 watcher.on('all', (event, filePath) => {
   if ((event === 'add' || event === 'change' || event === 'unlink') && filePath.endsWith('.json')) {
     const relativePath = path.relative(TASKS_DIR, filePath);
-    const sessionId = relativePath.split(path.sep)[0];
+    const dirName = relativePath.split(path.sep)[0];
 
-    taskCountsCache.delete(path.join(TASKS_DIR, sessionId));
+    taskCountsCache.delete(path.join(TASKS_DIR, dirName));
 
-    broadcast({
-      type: 'update',
-      event,
-      sessionId,
-      file: path.basename(filePath)
-    });
+    if (isUUID(dirName)) {
+      broadcast({ type: 'update', event, sessionId: dirName, file: path.basename(filePath) });
+    } else {
+      broadcastToMappedSessions(dirName, event, filePath);
+    }
   }
 });
 
+function broadcastToMappedSessions(taskListName, event, filePath) {
+  const { listToSessions } = loadAllTaskMaps();
+  const map = listToSessions[taskListName];
+  if (!map) return;
+  for (const sid of Object.keys(map)) {
+    broadcast({ type: 'update', event, sessionId: sid, file: path.basename(filePath) });
+  }
+}
+
 console.log(`Watching for changes in: ${TASKS_DIR}`);
 
+// Watch task maps directory for session→task-list mapping changes
+const taskMapsWatcher = chokidar.watch(TASK_MAPS_DIR, {
+  persistent: true,
+  ignoreInitial: true,
+  depth: 1
+});
+taskMapsWatcher.on('all', (event, filePath) => {
+  if ((event === 'add' || event === 'change' || event === 'unlink') && filePath.endsWith('.json')) {
+    lastTaskMapScan = 0;
+    const taskListName = path.basename(filePath, '.json');
+    taskCountsCache.delete(path.join(TASKS_DIR, taskListName));
+    broadcastToMappedSessions(taskListName, event, filePath);
+  }
+});
+
 // Watch teams directory for config changes
 const teamsWatcher = chokidar.watch(TEAMS_DIR, {
   persistent: true,