kantban-cli 0.1.1

package/README.md

@@ -0,0 +1,37 @@
+# kantban-cli
+
+CLI for KantBan pipeline orchestration — bridges KantBan boards to local Claude Code sessions.
+
+## Install
+
+```bash
+npm install -g kantban-cli
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `KANTBAN_API_TOKEN` | Yes | API token from KantBan account settings (starts with `cb_`) |
+| `KANTBAN_API_URL` | Yes | Your KantBan API URL |
+| `KANTBAN_PROJECT_ID` | No | Default project ID (some commands require it) |
+
+## Commands
+
+```bash
+kantban pipeline <board-id>   # Run autonomous agent pipeline
+kantban status <board-id>     # Monitor pipeline status
+kantban context <board-id>    # Print pipeline context as JSON
+kantban work <ticket-id>      # Start working on a ticket
+kantban cron <column-id>      # Process a single column on a timer
+```
+
+## Requirements
+
+- Node.js >= 22
+- A KantBan account with an API token
+
+## Links
+
+- [KantBan](https://kantban.com)
+- [kantban-mcp](https://www.npmjs.com/package/kantban-mcp) — MCP server for Claude Code integration

package/dist/client.d.ts

@@ -0,0 +1,35 @@
+export declare const REQUEST_TIMEOUT_MS = 30000;
+export declare const MAX_RETRIES = 2;
+export declare const RETRY_BASE_MS = 500;
+/** Returns true for statuses that are worth retrying (server errors + rate limit). */
+export declare function isRetryableStatus(status: number): boolean;
+/**
+ * Wraps `fetch` with:
+ *  - Per-request AbortController timeout (REQUEST_TIMEOUT_MS)
+ *  - Exponential backoff with jitter on retryable failures
+ *  - Up to MAX_RETRIES retries (so MAX_RETRIES + 1 total attempts)
+ *
+ * @param _sleep — optional override for the backoff sleep (used in tests to avoid real delays)
+ */
+export declare function fetchWithRetry(url: string, init: RequestInit, retries?: number, _sleep?: (ms: number) => Promise<void>): Promise<Response>;
+export declare class KantBanCLIClient {
+    private apiUrl;
+    private apiToken;
+    constructor(apiUrl: string, apiToken: string);
+    get baseUrl(): string;
+    get token(): string;
+    get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    post<T>(path: string, body?: Record<string, unknown>): Promise<T>;
+    claimTicket(projectId: string, ticketId: string): Promise<void>;
+    getFingerprint(projectId: string, ticketId: string): Promise<{
+        column_id: string | null;
+        updated_at: string;
+        comment_count: number;
+        signal_count: number;
+        field_value_count: number;
+    }>;
+    getBoardProject(boardId: string): Promise<{
+        project_id: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,SAAc,EACrB,MAAM,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CACe,GAClD,OAAO,CAAC,QAAQ,CAAC,CAgCnB;AAID,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;gBADR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM;IAG1B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAEK,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBhG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBjE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IAII,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAGxE"}

package/dist/client.js

@@ -0,0 +1,109 @@
+// ── retry / timeout constants ─────────────────────────────────────────────
+export const REQUEST_TIMEOUT_MS = 30_000;
+export const MAX_RETRIES = 2;
+export const RETRY_BASE_MS = 500;
+/** Returns true for statuses that are worth retrying (server errors + rate limit). */
+export function isRetryableStatus(status) {
+    return status >= 500 || status === 429;
+}
+/**
+ * Wraps `fetch` with:
+ *  - Per-request AbortController timeout (REQUEST_TIMEOUT_MS)
+ *  - Exponential backoff with jitter on retryable failures
+ *  - Up to MAX_RETRIES retries (so MAX_RETRIES + 1 total attempts)
+ *
+ * @param _sleep — optional override for the backoff sleep (used in tests to avoid real delays)
+ */
+export async function fetchWithRetry(url, init, retries = MAX_RETRIES, _sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))) {
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            const res = await fetch(url, { ...init, signal: controller.signal });
+            clearTimeout(timer);
+            // Non-retryable: 2xx (ok) or any non-retryable error status
+            if (res.ok || !isRetryableStatus(res.status)) {
+                return res;
+            }
+            // Retryable status — treat as a transient failure
+            lastError = new Error(`API error ${res.status}: ${await res.text()}`);
+        }
+        catch (err) {
+            clearTimeout(timer);
+            lastError = err;
+            // Only retry on network/abort errors, not on logic errors
+        }
+        if (attempt < retries) {
+            // Exponential backoff with up to 50% random jitter
+            const delay = RETRY_BASE_MS * 2 ** attempt * (1 + Math.random() * 0.5);
+            await _sleep(delay);
+        }
+    }
+    throw lastError;
+}
+// ── client ────────────────────────────────────────────────────────────────
+export class KantBanCLIClient {
+    apiUrl;
+    apiToken;
+    constructor(apiUrl, apiToken) {
+        this.apiUrl = apiUrl;
+        this.apiToken = apiToken;
+    }
+    get baseUrl() {
+        return this.apiUrl;
+    }
+    get token() {
+        return this.apiToken;
+    }
+    async get(path, params) {
+        const url = new URL(path, this.apiUrl);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, String(v));
+            }
+        }
+        const res = await fetchWithRetry(url.toString(), {
+            headers: {
+                'Authorization': `Bearer ${this.apiToken}`,
+                'X-KantBan-Via': 'cli',
+            },
+        });
+        if (!res.ok)
+            throw new Error(`API error ${res.status}: ${await res.text()}`);
+        const json = (await res.json());
+        if (!json.success)
+            throw new Error(`API responded with success: false`);
+        return json.data;
+    }
+    async post(path, body) {
+        const url = new URL(path, this.apiUrl);
+        const headers = {
+            'Authorization': `Bearer ${this.apiToken}`,
+            'X-KantBan-Via': 'cli',
+        };
+        const init = { method: 'POST', headers };
+        if (body) {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(body);
+        }
+        const res = await fetchWithRetry(url.toString(), init);
+        if (!res.ok)
+            throw new Error(`API error ${res.status}: ${await res.text()}`);
+        const json = (await res.json());
+        if (!json.success)
+            throw new Error(`API responded with success: false`);
+        return json.data;
+    }
+    async claimTicket(projectId, ticketId) {
+        await this.post(`/projects/${projectId}/tickets/${ticketId}/start`, {});
+    }
+    async getFingerprint(projectId, ticketId) {
+        return this.get(`/projects/${projectId}/tickets/${ticketId}/fingerprint`);
+    }
+    async getBoardProject(boardId) {
+        return this.get(`/boards/${boardId}/project`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,3 @@
+import type { KantBanCLIClient } from '../client.js';
+export declare function runContext(client: KantBanCLIClient, args: string[]): Promise<void>;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BxF"}

package/dist/commands/context.js

@@ -0,0 +1,27 @@
+export async function runContext(client, args) {
+    const [scopeType, scopeId] = args;
+    if (!scopeType || !scopeId) {
+        console.error('Usage: kantban context <board|column|ticket> <id>');
+        process.exit(1);
+    }
+    const projectId = process.env['KANTBAN_PROJECT_ID'];
+    if (!projectId) {
+        console.error('Error: KANTBAN_PROJECT_ID environment variable required for context command');
+        process.exit(1);
+    }
+    const params = {};
+    if (scopeType === 'board')
+        params['boardId'] = scopeId;
+    else if (scopeType === 'column')
+        params['columnId'] = scopeId;
+    else if (scopeType === 'ticket')
+        params['ticketId'] = scopeId;
+    else {
+        console.error(`Unknown scope type: ${scopeType}. Use board, column, or ticket.`);
+        process.exit(1);
+    }
+    const data = await client.get(`/projects/${projectId}/pipeline-context`, params);
+    // Output as structured JSON to stdout for piping
+    console.log(JSON.stringify(data, null, 2));
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAwB,EAAE,IAAc;IACvE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6EAA6E,CAAC,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,SAAS,KAAK,OAAO;QAAE,MAAM,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;SAClD,IAAI,SAAS,KAAK,QAAQ;QAAE,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;SACzD,IAAI,SAAS,KAAK,QAAQ;QAAE,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;SACzD,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,iCAAiC,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,aAAa,SAAS,mBAAmB,EACzC,MAAM,CACP,CAAC;IAEF,iDAAiD;IACjD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/commands/cron.d.ts

@@ -0,0 +1,3 @@
+import type { KantBanCLIClient } from '../client.js';
+export declare function runCron(client: KantBanCLIClient, args: string[]): Promise<void>;
+//# sourceMappingURL=cron.d.ts.map

package/dist/commands/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/commands/cron.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAqBrD,wBAAsB,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwGrF"}

package/dist/commands/cron.js

@@ -0,0 +1,106 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { generateMcpConfig, cleanupMcpConfig } from '../lib/mcp-config.js';
+import { RalphLoop } from '../lib/ralph-loop.js';
+const execFileAsync = promisify(execFile);
+function parseDuration(input) {
+    const match = input.match(/^(\d+)(s|m|h)$/);
+    if (!match)
+        throw new Error(`Invalid duration: ${input}. Use format like 5m, 30s, 1h`);
+    const value = Number(match[1]);
+    const unit = match[2];
+    switch (unit) {
+        case 's': return value * 1000;
+        case 'm': return value * 60 * 1000;
+        case 'h': return value * 60 * 60 * 1000;
+        default: throw new Error(`Unknown unit: ${unit}`);
+    }
+}
+export async function runCron(client, args) {
+    const columnId = args[0];
+    if (!columnId) {
+        console.error('Usage: kantban cron <column-id> [--interval 5m]');
+        process.exit(1);
+    }
+    // Parse interval
+    let intervalMs = 5 * 60 * 1000; // default 5m
+    const intervalIdx = args.indexOf('--interval');
+    const intervalArg = intervalIdx !== -1 ? args[intervalIdx + 1] : undefined;
+    if (intervalArg) {
+        intervalMs = parseDuration(intervalArg);
+    }
+    // Resolve project ID
+    const projectId = process.env['KANTBAN_PROJECT_ID'];
+    if (!projectId) {
+        console.error('Error: KANTBAN_PROJECT_ID required');
+        process.exit(1);
+    }
+    // Generate MCP config
+    const mcpConfigPath = generateMcpConfig(client.baseUrl, client.token);
+    // invokeClaudeP helper (same pattern as pipeline.ts)
+    async function invokeClaudeP(prompt, options) {
+        const claudeArgs = ['-p', prompt, '--mcp-config', options.mcpConfigPath, '--dangerously-skip-permissions'];
+        if (options.model)
+            claudeArgs.push('--model', options.model);
+        try {
+            const { stdout } = await execFileAsync('claude', claudeArgs, { maxBuffer: 10 * 1024 * 1024 });
+            return { exitCode: 0, output: stdout };
+        }
+        catch (err) {
+            const execErr = err;
+            return { exitCode: execErr.code ?? 1, output: execErr.stdout ?? execErr.message ?? '' };
+        }
+    }
+    let stopped = false;
+    // Graceful shutdown
+    const shutdown = () => {
+        stopped = true;
+        cleanupMcpConfig(mcpConfigPath);
+        console.log('\nCron stopped.');
+        process.exit(0);
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+    console.log(`Cron: column ${columnId}, interval ${String(intervalMs / 1000)}s`);
+    console.log('Press Ctrl+C to stop.\n');
+    // Main cron tick
+    const tick = async () => {
+        if (stopped)
+            return;
+        try {
+            // Fetch column scope
+            const columnScope = await client.get(`/projects/${projectId}/pipeline-context`, { columnId });
+            const tickets = columnScope.tickets ?? [];
+            if (tickets.length === 0) {
+                console.log(`[${new Date().toLocaleTimeString('en-US', { hour12: false })}] No tickets in column. Sleeping...`);
+                return;
+            }
+            console.log(`[${new Date().toLocaleTimeString('en-US', { hour12: false })}] Processing ${String(tickets.length)} ticket(s)...`);
+            // Process each ticket sequentially (one iteration each for cron)
+            for (const ticket of tickets) {
+                if (stopped)
+                    break;
+                const deps = {
+                    fetchTicketContext: (tid) => client.get(`/projects/${projectId}/pipeline-context`, { ticketId: tid }),
+                    fetchColumnContext: (cid) => client.get(`/projects/${projectId}/pipeline-context`, { columnId: cid }),
+                    fetchFingerprint: (tid) => client.getFingerprint(projectId, tid),
+                    invokeClaudeP,
+                    mcpConfigPath,
+                    projectId,
+                };
+                const config = { maxIterations: 1, gutterThreshold: 1 };
+                const loop = new RalphLoop(ticket.id, columnId, config, deps);
+                const result = await loop.run();
+                console.log(`  ${String(ticket.ticket_number)}: ${result.reason} (${String(result.iterations)} iter)`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Cron tick error: ${message}`);
+        }
+    };
+    // Run immediately, then on interval
+    await tick();
+    setInterval(() => void tick(), intervalMs);
+}
+//# sourceMappingURL=cron.js.map

package/dist/commands/cron.js.map

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

package/dist/commands/pipeline.d.ts

@@ -0,0 +1,4 @@
+import type { KantBanCLIClient } from '../client.js';
+export declare function runPipeline(client: KantBanCLIClient, args: string[]): Promise<void>;
+export declare function stopPipeline(args: string[]): Promise<void>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/commands/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/commands/pipeline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AA6QrD,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8TzF;AAmBD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwChE"}