kantban-cli 0.1.1

package/dist/lib/orchestrator.d.ts

@@ -0,0 +1,172 @@
+import type { LoopConfig, LoopResult } from './ralph-loop.js';
+import type { PipelineEvent } from './event-queue.js';
+/**
+ * Shape of a board-scope column as returned by fetchBoardScope.
+ */
+interface BoardColumn {
+    id: string;
+    name: string;
+    type: string;
+    goal: string;
+    ticket_count: number;
+    has_prompt: boolean;
+}
+/**
+ * Shape of the board-scope response.
+ */
+interface BoardScope {
+    scope: string;
+    board: {
+        id: string;
+        name: string;
+    };
+    columns: BoardColumn[];
+    circuit_breaker: {
+        threshold: number;
+        target_column_id: string | null;
+    };
+    tool_prefix: string;
+}
+/**
+ * Shape of a ticket summary in column scope.
+ */
+interface ColumnTicket {
+    id: string;
+    ticket_number: number;
+    title: string;
+}
+/**
+ * Agent config from column scope.
+ */
+interface ColumnAgentConfig {
+    execution_mode?: string | undefined;
+    model_preference?: string | undefined;
+    max_iterations?: number | undefined;
+    max_budget_usd?: number | null | undefined;
+    concurrency?: number | undefined;
+    gutter_threshold?: number | undefined;
+    poll_interval_seconds?: number | undefined;
+    worktree?: {
+        enabled: boolean;
+        path_pattern?: string | undefined;
+    } | undefined;
+}
+/**
+ * Shape of the column-scope response.
+ */
+interface ColumnScope {
+    scope: string;
+    column: {
+        id: string;
+        name: string;
+        goal: string;
+    };
+    prompt_document: {
+        id: string;
+        title: string;
+        content: string;
+    } | null;
+    agent_config: ColumnAgentConfig | null;
+    tickets: ColumnTicket[];
+    transition_rules: string;
+    signals: unknown[];
+    field_definitions: unknown[];
+    tool_prefix: string;
+}
+/**
+ * Injectable dependencies for the PipelineOrchestrator.
+ * Allows full testability via dependency injection.
+ */
+/**
+ * A ticket that is blocked by another ticket, with its current column.
+ */
+interface BlockedTicket {
+    id: string;
+    column_id: string | null;
+}
+export interface OrchestratorDeps {
+    fetchBoardScope: (boardId: string) => Promise<BoardScope>;
+    fetchColumnScope: (columnId: string) => Promise<ColumnScope>;
+    startLoop: (ticketId: string, columnId: string, config: LoopConfig) => Promise<LoopResult>;
+    createComment: (ticketId: string, body: string) => Promise<void>;
+    createSignal: (ticketId: string, body: string) => Promise<void>;
+    claimTicket: (ticketId: string) => Promise<void>;
+    fetchBlockedTickets: (ticketId: string) => Promise<BlockedTicket[]>;
+    hasUnresolvedBlockers: (ticketId: string) => Promise<boolean>;
+}
+/**
+ * PipelineOrchestrator — coordination layer for Ralph Loops.
+ *
+ * Discovers pipeline columns (has_prompt=true, type !== 'done'),
+ * spawns loops for tickets with concurrency limits per column,
+ * and handles WebSocket events for dynamic ticket arrivals.
+ */
+export declare class PipelineOrchestrator {
+    private boardId;
+    private projectId;
+    private deps;
+    /** Column ID -> column configuration */
+    private pipelineColumns;
+    /** Column ID -> cached column scope (from initialize) */
+    private columnScopes;
+    /** Ticket ID -> active loop tracking */
+    private activeLoops;
+    /** Column ID -> queued ticket IDs (FIFO) */
+    private loopQueues;
+    /** Ticket IDs that have been spawned or queued (prevents re-processing) */
+    private knownTickets;
+    /** Tickets deferred because they have unresolved blockers. Re-queued when a blocker reaches Done. */
+    private deferredTickets;
+    /** Ticket IDs currently in the spawning process (prevents double-spawn race) */
+    private spawning;
+    constructor(boardId: string, projectId: string, deps: OrchestratorDeps);
+    /** Returns the IDs of all discovered pipeline columns. */
+    get pipelineColumnIds(): string[];
+    /** Returns the total number of active loops. */
+    get activeLoopCount(): number;
+    /** Returns the number of queued (waiting) tickets for a column. */
+    queuedCount(columnId: string): number;
+    /**
+     * Initialize the orchestrator: fetch board scope, identify pipeline columns,
+     * and fetch column-level agent configs.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Refresh the cached column scope for a single column.
+     * Keeps stale scope on error rather than crashing.
+     */
+    refreshColumnScope(columnId: string): Promise<void>;
+    /**
+     * Scan all pipeline columns for existing tickets and spawn loops.
+     * Refreshes column scopes before scanning to avoid stale ticket lists.
+     * Respects per-column concurrency limits — excess tickets are queued.
+     */
+    scanAndSpawn(): Promise<void>;
+    /**
+     * Handle a pipeline event (typically from WebSocket via EventQueue).
+     */
+    handleEvent(event: PipelineEvent): Promise<void>;
+    /**
+     * Spawn a loop for a ticket if under concurrency limit, otherwise queue it.
+     * @param skipKnownCheck - true for event-driven spawns (bypass scan dedup)
+     */
+    private spawnOrQueue;
+    /**
+     * Start a loop and track it. Attach completion handler for cleanup + queue drain.
+     */
+    private startTrackedLoop;
+    /**
+     * Called when a loop finishes. Cleans up tracking and drains the queue.
+     */
+    private onLoopComplete;
+    /**
+     * Start the next queued ticket for a column if under concurrency limit.
+     */
+    private drainQueue;
+    /**
+     * Count active loops for a specific column.
+     */
+    private activeCountForColumn;
+}
+export {};
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/lib/orchestrator.d.ts.map

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

package/dist/lib/orchestrator.js

@@ -0,0 +1,315 @@
+/**
+ * PipelineOrchestrator — coordination layer for Ralph Loops.
+ *
+ * Discovers pipeline columns (has_prompt=true, type !== 'done'),
+ * spawns loops for tickets with concurrency limits per column,
+ * and handles WebSocket events for dynamic ticket arrivals.
+ */
+export class PipelineOrchestrator {
+    boardId;
+    projectId;
+    deps;
+    /** Column ID -> column configuration */
+    pipelineColumns = new Map();
+    /** Column ID -> cached column scope (from initialize) */
+    columnScopes = new Map();
+    /** Ticket ID -> active loop tracking */
+    activeLoops = new Map();
+    /** Column ID -> queued ticket IDs (FIFO) */
+    loopQueues = new Map();
+    /** Ticket IDs that have been spawned or queued (prevents re-processing) */
+    knownTickets = new Set();
+    /** Tickets deferred because they have unresolved blockers. Re-queued when a blocker reaches Done. */
+    deferredTickets = new Map(); // ticketId → columnId
+    /** Ticket IDs currently in the spawning process (prevents double-spawn race) */
+    spawning = new Set();
+    constructor(boardId, projectId, deps) {
+        this.boardId = boardId;
+        this.projectId = projectId;
+        this.deps = deps;
+    }
+    /** Returns the IDs of all discovered pipeline columns. */
+    get pipelineColumnIds() {
+        return Array.from(this.pipelineColumns.keys());
+    }
+    /** Returns the total number of active loops. */
+    get activeLoopCount() {
+        return this.activeLoops.size;
+    }
+    /** Returns the number of queued (waiting) tickets for a column. */
+    queuedCount(columnId) {
+        return this.loopQueues.get(columnId)?.length ?? 0;
+    }
+    /**
+     * Initialize the orchestrator: fetch board scope, identify pipeline columns,
+     * and fetch column-level agent configs.
+     */
+    async initialize() {
+        const boardScope = await this.deps.fetchBoardScope(this.boardId);
+        // Identify pipeline columns: has_prompt=true AND type !== 'done'
+        const pipelineCols = boardScope.columns.filter((col) => col.has_prompt && col.type !== 'done');
+        // Fetch column scope for each pipeline column to get agent_config and tickets
+        await Promise.all(pipelineCols.map(async (col) => {
+            const colScope = await this.deps.fetchColumnScope(col.id);
+            const cfg = colScope.agent_config;
+            this.pipelineColumns.set(col.id, {
+                columnId: col.id,
+                name: col.name,
+                concurrency: cfg?.concurrency ?? 1,
+                maxIterations: cfg?.max_iterations ?? 10,
+                gutterThreshold: cfg?.gutter_threshold ?? 3,
+                modelPreference: cfg?.model_preference,
+                maxBudgetUsd: cfg?.max_budget_usd,
+                worktreeEnabled: cfg?.worktree?.enabled,
+                worktreePattern: cfg?.worktree?.path_pattern,
+            });
+            // Cache column scope for scanAndSpawn
+            this.columnScopes.set(col.id, colScope);
+            // Initialize the queue for this column
+            this.loopQueues.set(col.id, []);
+        }));
+    }
+    /**
+     * Refresh the cached column scope for a single column.
+     * Keeps stale scope on error rather than crashing.
+     */
+    async refreshColumnScope(columnId) {
+        try {
+            const colScope = await this.deps.fetchColumnScope(columnId);
+            this.columnScopes.set(columnId, colScope);
+        }
+        catch {
+            // Keep stale scope rather than crash
+        }
+    }
+    /**
+     * Scan all pipeline columns for existing tickets and spawn loops.
+     * Refreshes column scopes before scanning to avoid stale ticket lists.
+     * Respects per-column concurrency limits — excess tickets are queued.
+     */
+    async scanAndSpawn() {
+        for (const [columnId] of this.pipelineColumns) {
+            await this.refreshColumnScope(columnId);
+            const colScope = this.columnScopes.get(columnId);
+            if (!colScope) {
+                console.error(`  [scan] Column ${columnId}: no cached scope`);
+                continue;
+            }
+            console.error(`  [scan] Column ${columnId} (${colScope.column.name}): ${String(colScope.tickets.length)} ticket(s)`);
+            for (const ticket of colScope.tickets) {
+                await this.spawnOrQueue(ticket.id, columnId);
+            }
+        }
+    }
+    /**
+     * Handle a pipeline event (typically from WebSocket via EventQueue).
+     */
+    async handleEvent(event) {
+        switch (event.type) {
+            case 'ticket:moved':
+            case 'ticket:created': {
+                if (event.columnId && this.pipelineColumns.has(event.columnId)) {
+                    await this.spawnOrQueue(event.ticketId, event.columnId, true);
+                }
+                // On any move, check if the moved ticket unblocks dependents
+                if (event.type === 'ticket:moved') {
+                    try {
+                        const blocked = await this.deps.fetchBlockedTickets(event.ticketId);
+                        for (const dep of blocked) {
+                            if (dep.id === event.ticketId)
+                                continue; // skip self
+                            if (dep.column_id && this.pipelineColumns.has(dep.column_id)) {
+                                this.knownTickets.delete(dep.id);
+                                this.deferredTickets.delete(dep.id);
+                                await this.spawnOrQueue(dep.id, dep.column_id, true);
+                            }
+                        }
+                    }
+                    catch {
+                        // Best-effort
+                    }
+                    // Re-evaluate all deferred tickets — resolution is server-side now
+                    for (const [deferredId, deferredCol] of Array.from(this.deferredTickets)) {
+                        if (deferredId === event.ticketId)
+                            continue; // already handled above
+                        this.knownTickets.delete(deferredId);
+                        this.deferredTickets.delete(deferredId);
+                        await this.spawnOrQueue(deferredId, deferredCol, true);
+                    }
+                }
+                break;
+            }
+            case 'ticket:deleted':
+            case 'ticket:archived': {
+                // If there's an active loop for this ticket, it will detect the
+                // change via fingerprint/404. We just clean up our tracking.
+                this.activeLoops.delete(event.ticketId);
+                this.knownTickets.delete(event.ticketId);
+                // Also remove from any queue
+                for (const [, queue] of this.loopQueues) {
+                    const idx = queue.indexOf(event.ticketId);
+                    if (idx !== -1) {
+                        queue.splice(idx, 1);
+                    }
+                }
+                break;
+            }
+        }
+    }
+    /**
+     * Spawn a loop for a ticket if under concurrency limit, otherwise queue it.
+     * @param skipKnownCheck - true for event-driven spawns (bypass scan dedup)
+     */
+    async spawnOrQueue(ticketId, columnId, skipKnownCheck = false) {
+        // Don't double-spawn
+        if (this.activeLoops.has(ticketId))
+            return;
+        // Prevent double-spawn race: two rapid events passing the activeLoops check
+        if (this.spawning.has(ticketId))
+            return;
+        // During scanAndSpawn, prevent re-processing tickets seen in other columns
+        if (!skipKnownCheck && this.knownTickets.has(ticketId))
+            return;
+        const colConfig = this.pipelineColumns.get(columnId);
+        if (!colConfig)
+            return;
+        // Count active loops for this column
+        const activeInColumn = this.activeCountForColumn(columnId);
+        // Mark as known to prevent re-processing
+        this.knownTickets.add(ticketId);
+        if (activeInColumn >= colConfig.concurrency) {
+            // Queue it
+            const queue = this.loopQueues.get(columnId);
+            if (queue && !queue.includes(ticketId)) {
+                queue.push(ticketId);
+            }
+            return;
+        }
+        // Mark as in-progress spawning to prevent double-spawn race
+        this.spawning.add(ticketId);
+        // Check for unresolved blockers before spawning — skip blocked tickets
+        // entirely instead of burning agent iterations on them.
+        try {
+            const blocked = await this.deps.hasUnresolvedBlockers(ticketId);
+            if (blocked) {
+                this.spawning.delete(ticketId);
+                this.deferredTickets.set(ticketId, columnId);
+                console.error(`  [skip] ${ticketId} has unresolved blockers — deferred`);
+                // Try next in queue instead
+                void this.drainQueue(columnId).catch(() => { });
+                return;
+            }
+        }
+        catch {
+            // If the check fails, proceed anyway — the agent will handle it
+        }
+        // Spawn the loop
+        await this.deps.claimTicket(ticketId);
+        this.startTrackedLoop(ticketId, columnId, colConfig);
+        this.spawning.delete(ticketId);
+    }
+    /**
+     * Start a loop and track it. Attach completion handler for cleanup + queue drain.
+     */
+    startTrackedLoop(ticketId, columnId, config) {
+        const loopConfig = {
+            maxIterations: config.maxIterations,
+            gutterThreshold: config.gutterThreshold,
+            ...(config.modelPreference !== undefined && { modelPreference: config.modelPreference }),
+            ...(config.maxBudgetUsd !== undefined && { maxBudgetUsd: config.maxBudgetUsd }),
+            ...(config.worktreeEnabled !== undefined && { worktreeEnabled: config.worktreeEnabled }),
+            ...(config.worktreePattern !== undefined && { worktreePattern: config.worktreePattern }),
+        };
+        const promise = this.deps.startLoop(ticketId, columnId, loopConfig);
+        this.activeLoops.set(ticketId, { columnId, promise });
+        // Attach completion handler — do NOT await
+        void promise.then((result) => this.onLoopComplete(ticketId, columnId, result).catch((err) => {
+            console.error(`onLoopComplete error for ${ticketId}:`, err);
+        }), (err) => this.onLoopComplete(ticketId, columnId, {
+            reason: 'error',
+            iterations: 0,
+            gutterCount: 0,
+            lastError: err instanceof Error ? err.message : String(err),
+        }).catch((completionErr) => {
+            console.error(`onLoopComplete error for ${ticketId}:`, completionErr);
+        }));
+    }
+    /**
+     * Called when a loop finishes. Cleans up tracking and drains the queue.
+     */
+    async onLoopComplete(ticketId, columnId, result) {
+        this.activeLoops.delete(ticketId);
+        // Write reason-specific comment
+        let comment;
+        switch (result.reason) {
+            case 'moved':
+                comment = `✓ Pipeline agent advanced ticket after ${result.iterations} iteration(s).`;
+                break;
+            case 'max_iterations':
+                comment = `Pipeline agent reached iteration limit (${result.iterations}) without advancing. Manual review needed.`;
+                break;
+            case 'stalled':
+                comment = `Pipeline agent stalled — no progress for ${result.gutterCount} consecutive iterations (of ${result.iterations} total). Manual review needed.`;
+                break;
+            case 'error':
+                comment = `Pipeline agent encountered an error after ${result.iterations} iteration(s): ${result.lastError ?? 'unknown error'}`;
+                break;
+            case 'stopped':
+                comment = `Pipeline agent was stopped externally after ${result.iterations} iteration(s).`;
+                break;
+        }
+        await this.deps.createComment(ticketId, comment).catch(() => { });
+        // Create signal for failure exits so future agents inherit the context
+        if (result.reason === 'stalled') {
+            await this.deps.createSignal(ticketId, `Previous pipeline run stalled after ${result.iterations} iterations with no progress. Review comments for details before retrying.`).catch(() => { });
+        }
+        else if (result.reason === 'error') {
+            await this.deps.createSignal(ticketId, `Previous pipeline run failed after ${result.iterations} iteration(s): ${result.lastError ?? 'unknown error'}. Review comments for details before retrying.`).catch(() => { });
+        }
+        // Drain queue: start next ticket for this column
+        await this.drainQueue(columnId);
+    }
+    /**
+     * Start the next queued ticket for a column if under concurrency limit.
+     */
+    async drainQueue(columnId) {
+        const colConfig = this.pipelineColumns.get(columnId);
+        if (!colConfig)
+            return;
+        const queue = this.loopQueues.get(columnId);
+        if (!queue || queue.length === 0)
+            return;
+        const activeInColumn = this.activeCountForColumn(columnId);
+        if (activeInColumn >= colConfig.concurrency)
+            return;
+        // Find the first unblocked ticket in the queue
+        while (queue.length > 0) {
+            const nextTicketId = queue.shift();
+            try {
+                const blocked = await this.deps.hasUnresolvedBlockers(nextTicketId);
+                if (blocked) {
+                    this.deferredTickets.set(nextTicketId, columnId);
+                    continue; // skip, try next
+                }
+            }
+            catch {
+                // If check fails, proceed anyway
+            }
+            await this.deps.claimTicket(nextTicketId);
+            this.startTrackedLoop(nextTicketId, columnId, colConfig);
+            return;
+        }
+    }
+    /**
+     * Count active loops for a specific column.
+     */
+    activeCountForColumn(columnId) {
+        let count = 0;
+        for (const [, loop] of this.activeLoops) {
+            if (loop.columnId === columnId)
+                count++;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/lib/orchestrator.js.map

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

package/dist/lib/prompt-composer.d.ts

@@ -0,0 +1,102 @@
+import type { AgentConfig } from '@kantban/types';
+interface ColumnContext {
+    scope: 'column';
+    column: {
+        id: string;
+        name: string;
+        goal: string | null;
+    };
+    prompt_document: {
+        id: string;
+        title: string;
+        content: string;
+    } | null;
+    agent_config: AgentConfig | null;
+    tickets: Array<{
+        id: string;
+        ticket_number: number;
+        title: string;
+    }>;
+    transition_rules: string;
+    signals: string[];
+    field_definitions: Array<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    tool_prefix: string;
+}
+interface TicketContext {
+    scope: 'ticket';
+    ticket: {
+        id: string;
+        ticket_number: number;
+        title: string;
+        description: string;
+        backward_transitions: number;
+        assignee: {
+            id: string;
+            name: string;
+        } | null;
+        column: {
+            id: string;
+            name: string;
+            type: string;
+        } | null;
+    };
+    field_values: Array<{
+        field_name: string;
+        value: unknown;
+    }>;
+    transitions: Array<{
+        from: string | null;
+        to: string;
+        handoff: unknown;
+        timestamp: string;
+    }>;
+    comments: Array<{
+        author: string;
+        body: string;
+        created_at: string;
+    }>;
+    ticket_links: Array<{
+        direction: 'outward' | 'inward';
+        link_type: 'blocks' | 'relates_to' | 'duplicates';
+        ticket_id: string;
+        ticket_number: number;
+        title: string;
+        column_name: string | null;
+        resolved: boolean;
+    }>;
+    parent: {
+        id: string;
+        ticket_number: number;
+        title: string;
+    } | null;
+    children: Array<{
+        id: string;
+        ticket_number: number;
+        title: string;
+        column_name: string | null;
+    }>;
+    signals: string[];
+    linked_documents: Array<{
+        id: string;
+        title: string;
+        content?: string;
+        truncated?: boolean;
+    }>;
+    transition_rules: string;
+    dependency_requirements: string;
+    tool_prefix: string;
+}
+interface IterationMeta {
+    iteration: number;
+    maxIterations: number;
+    projectId: string;
+    gutterCount: number;
+    gutterThreshold: number;
+}
+export type { ColumnContext, TicketContext };
+export declare function composePrompt(columnContext: ColumnContext, ticketContext: TicketContext, meta: IterationMeta): string;
+//# sourceMappingURL=prompt-composer.d.ts.map

package/dist/lib/prompt-composer.d.ts.map

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