claude-code-kanban 4.27.0 → 4.28.0

package/plugin/plugins/claude-code-kanban/scripts/postman.js

@@ -26,6 +26,10 @@ const SERVER_INFO = path.join(CLAUDE_DIR, '.cck', 'server.json');
 // because an enqueue wakes the poll immediately.
 const WAIT_SEC = 120;
 const RETRY_MS = 15000;
+// `--topic dispatch` is the kanban-dispatch inbox: reports from sessions this one started.
+const TOPIC = process.argv.includes('--topic') ? process.argv[process.argv.indexOf('--topic') + 1] : null;
+// A dispatch report is a result, not an instruction, so a late attach still wants it.
+const KEEP_BACKLOG = process.argv.includes('--keep-backlog');
 
 if (!SESSION_ID) process.exit(0);
 
@@ -43,11 +47,12 @@ function serverUrl() {
 // Once per process, not once per poll: the grant means "follow the board from here on", so
 // the first attach throws away whatever queued up before it. A later reconnect must not
 // discard again -- by then the queue holds events the user is owed.
-let firstAttach = true;
+let firstAttach = !KEEP_BACKLOG;
 
 async function poll(base) {
   const first = firstAttach ? '&first=1' : '';
-  const url = `${base}/api/sessions/${encodeURIComponent(SESSION_ID)}/events?wait=${WAIT_SEC}${first}`;
+  const topic = TOPIC ? `&topic=${encodeURIComponent(TOPIC)}` : '';
+  const url = `${base}/api/sessions/${encodeURIComponent(SESSION_ID)}/events?wait=${WAIT_SEC}${first}${topic}`;
   const res = await fetch(url, { signal: AbortSignal.timeout((WAIT_SEC + 15) * 1000) });
   if (!res.ok) throw new Error(`HTTP ${res.status}`);
   firstAttach = false;

package/plugin/plugins/claude-code-kanban/skills/kanban-dispatch/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: kanban-dispatch
+description: Dispatch a task to another Claude Code session through the kanban board (cck), fire-and-forget or with a report back. Use when the user asks to dispatch, delegate, or start a session for a task, or to collect or check on a dispatched session's result.
+argument-hint: '<task> [--report] [--group <name>] [--model haiku|sonnet|opus|fable] [--worktree [name]]'
+---
+
+# Kanban dispatch
+
+This file only points at the guide. The guide ships with the `claude-code-kanban` binary, so it always matches the commands that binary accepts.
+
+Invoking this skill also arms this session's dispatch inbox: when a session you dispatched with `--report` reports or exits, a line arrives here:
+
+```
+cck:1 dispatch.<succeeded|failed|exited> <dispatch-id> session=<uuid> summary=<text>
+```
+
+Load the guide before running any dispatch command:
+
+```bash
+claude-code-kanban skills get dispatch
+```
+
+Fall back to `npx claude-code-kanban` when the bare binary is not on PATH. If `skills get` is unknown, the installed cck is too old: tell the user to update it, and do not guess commands.