kantban-cli 0.1.1

package/dist/lib/prompt-composer.js

@@ -0,0 +1,178 @@
+export function composePrompt(columnContext, ticketContext, meta) {
+    const parts = [];
+    // 0. System preamble — tells the agent who it is and what to do
+    const hasUnresolvedBlockers = ticketContext.ticket_links.some((l) => l.direction === 'inward' && l.link_type === 'blocks' && !l.resolved);
+    parts.push(`# Pipeline Agent Instructions
+
+You are a pipeline automation agent processing ticket #${String(ticketContext.ticket.ticket_number)}: "${ticketContext.ticket.title}".
+
+## Your Goal
+Advance this ticket through the pipeline. Your success criteria:
+1. Complete the work described in the ticket and column prompt below
+2. Move the ticket to the next column using \`${ticketContext.tool_prefix}move_ticket\`
+3. Or mark it complete using \`${ticketContext.tool_prefix}complete_task\`
+
+## Iteration ${meta.iteration} of ${meta.maxIterations}
+${meta.iteration >= meta.maxIterations - 1 ? '**FINAL ITERATIONS** — prioritize moving the ticket NOW or it will be marked stalled.' : `You have ${meta.maxIterations - meta.iteration} iterations remaining. Make meaningful progress each iteration.`}
+${meta.gutterCount > 0 ? `
+## ⚠ Progress Warning
+No meaningful progress detected for ${meta.gutterCount} consecutive iteration(s).
+${meta.gutterThreshold - meta.gutterCount} iteration(s) remain before this loop is terminated as stalled.
+
+You MUST change approach. What you've been doing is not working. Consider:
+- Breaking the problem into smaller steps
+- Setting a field value to record partial progress
+- Creating a comment explaining what's blocking you
+- Asking for help via a signal
+` : ''}
+## Available Tools (prefix: ${ticketContext.tool_prefix})
+- **${ticketContext.tool_prefix}check_transition** — ALWAYS call this before moving. Returns allowed/blocked with recovery steps.
+  Params: \`{ projectId, boardId, ticketId, targetColumnId }\`
+- **${ticketContext.tool_prefix}move_ticket** — Move ticket to a new column. Include handoff data for the next agent.
+  Params: \`{ projectId, ticketId, column_id, handoff: { branch?, commit_sha?, build_status?, notes? } }\`
+- **${ticketContext.tool_prefix}complete_task** — Move to a done column with handoff data.
+  Params: \`{ projectId, ticketId, handoff: { ... } }\`
+- **${ticketContext.tool_prefix}set_field_value** — Set a required field before moving (check transition rules).
+  Params: \`{ projectId, ticketId, fieldId, value }\`
+- **${ticketContext.tool_prefix}create_signal** — Leave knowledge for future agents at any scope.
+- **${ticketContext.tool_prefix}create_comment** — Add progress notes to the ticket.
+
+## Iteration Summary (Required)
+Before finishing your work this iteration, you MUST create a comment using \`${ticketContext.tool_prefix}create_comment\` summarizing:
+- What you accomplished
+- What remains to be done
+- Any blockers or issues encountered
+
+This comment is your handoff to the next iteration. Without it, the next iteration starts blind.
+
+## Critical Rules
+1. **Always call ${ticketContext.tool_prefix}check_transition before ${ticketContext.tool_prefix}move_ticket** — moves that violate workflow rules will fail.
+2. **If the ticket has UNRESOLVED blockers, do not attempt to move it.** Create a comment explaining you are waiting, then stop.
+3. **Include handoff data** when moving — the next agent needs context (branch name, build status, etc.).
+4. **If you cannot make progress**, create a comment explaining why and stop. Do not burn iterations.
+${hasUnresolvedBlockers ? '\n**WARNING: This ticket has UNRESOLVED blockers. Do NOT attempt to move it. Document your status and stop.**\n' : ''}
+---
+`);
+    // 1. Column prompt document (the PROMPT.md equivalent)
+    if (columnContext.prompt_document?.content) {
+        parts.push(columnContext.prompt_document.content);
+    }
+    // 2. Ticket details
+    parts.push(`## Current Ticket\n`);
+    parts.push(`**Title:** ${ticketContext.ticket.title}`);
+    parts.push(`**Ticket ID:** ${ticketContext.ticket.id}`);
+    parts.push(`**Ticket Number:** ${String(ticketContext.ticket.ticket_number)}`);
+    if (ticketContext.ticket.description) {
+        parts.push(`\n${ticketContext.ticket.description}`);
+    }
+    // Assignee and column position
+    if (ticketContext.ticket.assignee) {
+        parts.push(`**Assignee:** ${ticketContext.ticket.assignee.name}`);
+    }
+    if (ticketContext.ticket.column) {
+        parts.push(`**Current Column:** ${ticketContext.ticket.column.name} (${ticketContext.ticket.column.type})`);
+    }
+    if (ticketContext.ticket.backward_transitions > 0) {
+        parts.push(`**Backward Transitions:** ${String(ticketContext.ticket.backward_transitions)}`);
+    }
+    // 3. Field values
+    if (ticketContext.field_values.length > 0) {
+        parts.push(`\n## Field Values\n`);
+        for (const fv of ticketContext.field_values) {
+            parts.push(`- **${fv.field_name}:** ${fv.value !== null ? JSON.stringify(fv.value) : '(not set)'}`);
+        }
+    }
+    // Parent/children
+    if (ticketContext.parent) {
+        parts.push(`\n## Parent Ticket\n`);
+        parts.push(`- #${String(ticketContext.parent.ticket_number)}: ${ticketContext.parent.title}`);
+    }
+    if (ticketContext.children.length > 0) {
+        parts.push(`\n## Child Tickets\n`);
+        for (const child of ticketContext.children) {
+            parts.push(`- #${String(child.ticket_number)}: ${child.title}${child.column_name ? ` (${child.column_name})` : ''}`);
+        }
+    }
+    // 4. Transition history (handoff chain)
+    if (ticketContext.transitions.length > 0) {
+        parts.push(`\n## Transition History\n`);
+        for (const t of ticketContext.transitions) {
+            let line = `- ${t.from ?? 'Backlog'} → ${t.to}`;
+            if (t.handoff)
+                line += ` (handoff: ${JSON.stringify(t.handoff)})`;
+            parts.push(line);
+        }
+    }
+    // Ticket links
+    if (ticketContext.ticket_links.length > 0) {
+        parts.push(`\n## Ticket Links\n`);
+        const blockers = ticketContext.ticket_links.filter(l => l.direction === 'inward' && l.link_type === 'blocks');
+        const blocking = ticketContext.ticket_links.filter(l => l.direction === 'outward' && l.link_type === 'blocks');
+        const related = ticketContext.ticket_links.filter(l => l.link_type === 'relates_to');
+        if (blockers.length > 0) {
+            parts.push(`**Blocked by:**`);
+            for (const l of blockers) {
+                const status = l.resolved ? '(resolved)' : '⚠ UNRESOLVED';
+                parts.push(`- #${String(l.ticket_number)}: ${l.title} [${l.column_name ?? 'backlog'}] ${status}`);
+            }
+        }
+        if (blocking.length > 0) {
+            parts.push(`**Blocks:**`);
+            for (const l of blocking) {
+                parts.push(`- #${String(l.ticket_number)}: ${l.title} [${l.column_name ?? 'backlog'}]`);
+            }
+        }
+        if (related.length > 0) {
+            parts.push(`**Related:**`);
+            for (const l of related) {
+                parts.push(`- #${String(l.ticket_number)}: ${l.title}`);
+            }
+        }
+    }
+    // 5. Composed signals (guardrails)
+    if (ticketContext.signals.length > 0) {
+        parts.push(`\n## Signals (Guardrails)\n`);
+        for (const s of ticketContext.signals) {
+            parts.push(`- ${s}`);
+        }
+    }
+    // Comments
+    if (ticketContext.comments.length > 0) {
+        parts.push(`\n## Comments\n`);
+        for (const c of ticketContext.comments) {
+            parts.push(`**${c.author}** (${c.created_at}):\n${c.body}\n`);
+        }
+    }
+    // 6. Transition rules
+    if (ticketContext.transition_rules) {
+        parts.push(`\n## Transition Rules\n`);
+        parts.push(ticketContext.transition_rules);
+    }
+    // Dependency requirements
+    if (ticketContext.dependency_requirements && ticketContext.dependency_requirements !== 'No dependency or field requirements configured.') {
+        parts.push(`\n## Dependency & Field Requirements\n`);
+        parts.push(ticketContext.dependency_requirements);
+    }
+    // 7. Linked documents
+    if (ticketContext.linked_documents.length > 0) {
+        parts.push(`\n## Linked Documents\n`);
+        for (const doc of ticketContext.linked_documents) {
+            if (doc.content) {
+                parts.push(`### ${doc.title}\n`);
+                parts.push(doc.content);
+            }
+            else if (doc.truncated) {
+                parts.push(`- ${doc.title} (document too large — read via kantban_get_document)`);
+            }
+        }
+    }
+    // 8. Iteration metadata
+    parts.push(`\n## Pipeline Metadata\n`);
+    parts.push(`- Iteration: ${meta.iteration} / ${meta.maxIterations}`);
+    parts.push(`- Project ID: ${meta.projectId}`);
+    parts.push(`- Tool Prefix: ${ticketContext.tool_prefix}`);
+    parts.push(`- Column: ${columnContext.column.name}`);
+    parts.push(`- Goal: ${columnContext.column.goal ?? 'No goal set'}`);
+    return parts.join('\n');
+}
+//# sourceMappingURL=prompt-composer.js.map

package/dist/lib/prompt-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer.js","sourceRoot":"","sources":["../../src/lib/prompt-composer.ts"],"names":[],"mappings":"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"}

package/dist/lib/ralph-loop.d.ts

@@ -0,0 +1,47 @@
+import { type ColumnContext, type TicketContext } from './prompt-composer.js';
+import type { TicketFingerprint } from '@kantban/types';
+export interface LoopConfig {
+    maxIterations: number;
+    gutterThreshold: number;
+    modelPreference?: string;
+    maxBudgetUsd?: number | null;
+    worktreeEnabled?: boolean;
+    worktreePattern?: string;
+    postMoveRetryDelayMs?: number;
+}
+export interface LoopResult {
+    reason: 'moved' | 'max_iterations' | 'stalled' | 'stopped' | 'error';
+    iterations: number;
+    gutterCount: number;
+    lastError?: string;
+}
+export interface RalphLoopDeps {
+    fetchTicketContext: (ticketId: string) => Promise<TicketContext>;
+    fetchColumnContext: (columnId: string) => Promise<ColumnContext>;
+    fetchFingerprint: (ticketId: string) => Promise<TicketFingerprint>;
+    invokeClaudeP: (prompt: string, options: ClaudeInvokeOptions) => Promise<{
+        exitCode: number;
+        output: string;
+    }>;
+    mcpConfigPath: string;
+    projectId: string;
+}
+export interface ClaudeInvokeOptions {
+    mcpConfigPath: string;
+    model?: string | undefined;
+    maxBudgetUsd?: number | null | undefined;
+    worktree?: string | undefined;
+}
+export declare class RalphLoop {
+    private ticketId;
+    private columnId;
+    private config;
+    private deps;
+    private stopped;
+    private currentIteration;
+    constructor(ticketId: string, columnId: string, config: LoopConfig, deps: RalphLoopDeps);
+    stop(): void;
+    get iteration(): number;
+    run(): Promise<LoopResult>;
+}
+//# sourceMappingURL=ralph-loop.d.ts.map

package/dist/lib/ralph-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-loop.d.ts","sourceRoot":"","sources":["../../src/lib/ralph-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/G,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa;IAOvF,IAAI,IAAI,IAAI;IAIZ,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;CA2FjC"}

package/dist/lib/ralph-loop.js

@@ -0,0 +1,114 @@
+import { composePrompt } from './prompt-composer.js';
+export class RalphLoop {
+    ticketId;
+    columnId;
+    config;
+    deps;
+    stopped = false;
+    currentIteration = 0;
+    constructor(ticketId, columnId, config, deps) {
+        this.ticketId = ticketId;
+        this.columnId = columnId;
+        this.config = config;
+        this.deps = deps;
+    }
+    stop() {
+        this.stopped = true;
+    }
+    get iteration() {
+        return this.currentIteration;
+    }
+    async run() {
+        let gutterCount = 0;
+        let lastFingerprint = null;
+        for (let i = 1; i <= this.config.maxIterations; i++) {
+            if (this.stopped)
+                return { reason: 'stopped', iterations: i - 1, gutterCount };
+            this.currentIteration = i;
+            try {
+                // On first iteration, snapshot baseline fingerprint for gutter detection
+                if (!lastFingerprint) {
+                    lastFingerprint = await this.deps.fetchFingerprint(this.ticketId);
+                }
+                // Fetch fresh context
+                const [ticketCtx, columnCtx] = await Promise.all([
+                    this.deps.fetchTicketContext(this.ticketId),
+                    this.deps.fetchColumnContext(this.columnId),
+                ]);
+                // Compose prompt
+                const prompt = composePrompt(columnCtx, ticketCtx, {
+                    iteration: i,
+                    maxIterations: this.config.maxIterations,
+                    projectId: this.deps.projectId,
+                    gutterCount,
+                    gutterThreshold: this.config.gutterThreshold,
+                });
+                // Invoke Claude
+                if (this.stopped)
+                    return { reason: 'stopped', iterations: i - 1, gutterCount };
+                const { exitCode, output } = await this.deps.invokeClaudeP(prompt, {
+                    mcpConfigPath: this.deps.mcpConfigPath,
+                    model: this.config.modelPreference,
+                    maxBudgetUsd: this.config.maxBudgetUsd,
+                    worktree: this.config.worktreeEnabled
+                        ? this.config.worktreePattern?.replace('{ticket_number}', String(ticketCtx.ticket.ticket_number))
+                        : undefined,
+                });
+                // Check exit code — non-zero means Claude crashed or was killed
+                if (exitCode !== 0) {
+                    const snippet = output.slice(-200);
+                    return { reason: 'error', iterations: i, gutterCount, lastError: `non-zero exit code: ${exitCode}. Last output: ${snippet}` };
+                }
+                // Check post-iteration state with retry for async MCP lag
+                const retryDelayMs = this.config.postMoveRetryDelayMs ?? 1500;
+                let afterFp = await this.deps.fetchFingerprint(this.ticketId);
+                if (afterFp.column_id === this.columnId) {
+                    // Ticket still in same column — retry in case MCP move is still in flight
+                    for (let retry = 0; retry < 2; retry++) {
+                        await new Promise((r) => setTimeout(r, retryDelayMs));
+                        afterFp = await this.deps.fetchFingerprint(this.ticketId);
+                        if (afterFp.column_id !== this.columnId)
+                            break;
+                    }
+                }
+                // Did ticket move?
+                if (afterFp.column_id !== this.columnId) {
+                    return { reason: 'moved', iterations: i, gutterCount };
+                }
+                // Gutter detection — a ticket is "in the gutter" when the agent
+                // isn't making meaningful progress.  We compare the fingerprint
+                // BUT we ignore signal_count because a dependency-blocked agent
+                // can create a new "still waiting" signal every iteration, which
+                // tricks the old check into thinking progress was made.
+                if (lastFingerprint && fingerprintsEqualIgnoringSignals(lastFingerprint, afterFp)) {
+                    gutterCount++;
+                    if (gutterCount >= this.config.gutterThreshold) {
+                        return { reason: 'stalled', iterations: i, gutterCount };
+                    }
+                }
+                else {
+                    gutterCount = 0;
+                }
+                lastFingerprint = afterFp;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                // If ticket was deleted, the context fetch will 404
+                if (message.includes('404')) {
+                    return { reason: 'moved', iterations: i, gutterCount };
+                }
+                return { reason: 'error', iterations: i, gutterCount, lastError: message };
+            }
+        }
+        return { reason: 'max_iterations', iterations: this.config.maxIterations, gutterCount };
+    }
+}
+function fingerprintsEqualIgnoringSignals(a, b) {
+    // Only field_value_count is a reliable progress indicator.
+    // signal_count and comment_count both inflate when a dependency-blocked
+    // agent posts "still waiting" messages each iteration.
+    // Column change is detected separately (exits as 'moved').
+    return a.column_id === b.column_id
+        && a.field_value_count === b.field_value_count;
+}
+//# sourceMappingURL=ralph-loop.js.map

package/dist/lib/ralph-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-loop.js","sourceRoot":"","sources":["../../src/lib/ralph-loop.ts"],"names":[],"mappings":"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"}

package/dist/lib/ws-client.d.ts

@@ -0,0 +1,28 @@
+import type { KantBanCLIClient } from '../client.js';
+export interface WsClientOptions {
+    boardId: string;
+    projectId: string;
+    onEvent: (event: {
+        type: string;
+        payload: Record<string, unknown>;
+    }) => void;
+    onConnect: () => void;
+    onDisconnect: () => void;
+}
+export declare class PipelineWsClient {
+    private ws;
+    private client;
+    private options;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private pingTimer;
+    private stopped;
+    constructor(client: KantBanCLIClient, options: WsClientOptions);
+    connect(): Promise<void>;
+    stop(): void;
+    private send;
+    private cleanup;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/lib/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../../src/lib/ws-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7E,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe;IAKxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiE9B,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/lib/ws-client.js

@@ -0,0 +1,113 @@
+import WebSocket from 'ws';
+export class PipelineWsClient {
+    ws = null;
+    client;
+    options;
+    reconnectTimer = null;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 10;
+    pingTimer = null;
+    stopped = false;
+    constructor(client, options) {
+        this.client = client;
+        this.options = options;
+    }
+    async connect() {
+        // Close any existing connection before creating a new one
+        if (this.ws) {
+            try {
+                this.ws.removeAllListeners();
+                this.ws.close();
+            }
+            catch { /* ignore */ }
+            this.ws = null;
+        }
+        this.cleanup();
+        // Get WS ticket
+        const { ticket } = await this.client.post('/ws-ticket');
+        // Build WS URL
+        const wsUrl = this.client.baseUrl.replace(/^http/, 'ws') + `/ws?ticket=${ticket}`;
+        return new Promise((resolve, reject) => {
+            let resolved = false;
+            this.ws = new WebSocket(wsUrl);
+            let subscribed = false;
+            this.ws.on('open', () => {
+                this.reconnectAttempts = 0;
+                // Start heartbeat
+                this.pingTimer = setInterval(() => this.send({ type: 'ping', payload: {} }), 30000);
+                // NOTE: board:subscribe is deferred until the first server message
+                // to avoid a race where the message arrives before the server's
+                // on('message') handler is attached (behind async setup).
+            });
+            this.ws.on('message', (data) => {
+                try {
+                    const event = JSON.parse(data.toString());
+                    // Send board:subscribe after the first server message proves the handler is ready
+                    if (!subscribed) {
+                        subscribed = true;
+                        this.send({ type: 'board:subscribe', payload: { boardId: this.options.boardId, projectId: this.options.projectId } });
+                        this.options.onConnect();
+                        if (!resolved) {
+                            resolved = true;
+                            resolve();
+                        }
+                    }
+                    this.options.onEvent(event);
+                }
+                catch (err) {
+                    console.error('WS message parse error:', err);
+                }
+            });
+            this.ws.on('close', () => {
+                this.cleanup();
+                this.options.onDisconnect();
+                if (!this.stopped)
+                    this.scheduleReconnect();
+            });
+            this.ws.on('error', (err) => {
+                if (!resolved) {
+                    resolved = true;
+                    reject(err);
+                }
+                // Otherwise reconnect will handle it
+            });
+        });
+    }
+    stop() {
+        this.stopped = true;
+        this.cleanup();
+        if (this.ws) {
+            try {
+                this.ws.removeAllListeners();
+                this.ws.close();
+            }
+            catch { /* ignore */ }
+            this.ws = null;
+        }
+    }
+    send(data) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(data));
+        }
+    }
+    cleanup() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectAttempts >= this.maxReconnectAttempts)
+            return;
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30000);
+        this.reconnectAttempts++;
+        this.reconnectTimer = setTimeout(() => void this.connect().catch((err) => {
+            console.error('WS reconnect failed:', err instanceof Error ? err.message : String(err));
+        }), delay);
+    }
+}
+//# sourceMappingURL=ws-client.js.map

package/dist/lib/ws-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.js","sourceRoot":"","sources":["../../src/lib/ws-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "kantban-cli",
+  "version": "0.1.1",
+  "description": "CLI for KantBan pipeline orchestration — bridges KantBan boards to local Claude Code sessions",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Meltero/cantban.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "kantban",
+    "cli",
+    "kanban",
+    "pipeline",
+    "claude",
+    "ai"
+  ],
+  "bin": {
+    "kantban": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "postbuild": "chmod +x dist/index.js",
+    "prepublishOnly": "tsc"
+  },
+  "dependencies": {
+    "ws": "^8.20.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@kantban/types": "workspace:^",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}