wiggum-cli 0.16.0 → 0.17.0

package/dist/tui/app.d.ts

@@ -16,7 +16,7 @@ import type { SessionState } from '../repl/session-state.js';
 /**
  * Available screen types for the App component
  */
-export type AppScreen = 'shell' | 'interview' | 'init' | 'run';
+export type AppScreen = 'shell' | 'interview' | 'init' | 'run' | 'agent';
 /**
  * Props for the interview screen
  */
@@ -31,6 +31,19 @@ export interface InterviewAppProps {
     model: string;
     /** Optional scan result with detected tech stack */
     scanResult?: ScanResult;
+    /** References to auto-add during context phase (from CLI --issue/--context flags) */
+    initialReferences?: string[];
+}
+/**
+ * Props for the agent screen when launched directly from CLI
+ */
+export interface AgentAppProps {
+    modelOverride?: string;
+    maxItems?: number;
+    maxSteps?: number;
+    labels?: string[];
+    reviewMode?: 'manual' | 'auto' | 'merge';
+    dryRun?: boolean;
 }
 /**
  * Props for the run/monitor screen when launched directly from CLI
@@ -57,6 +70,8 @@ export interface AppProps {
     interviewProps?: InterviewAppProps;
     /** Props for the run/monitor screen (required when screen is 'run') */
     runProps?: RunAppProps;
+    /** Props for the agent screen (required when screen is 'agent') */
+    agentProps?: AgentAppProps;
     /** Called when the screen completes successfully */
     onComplete?: (result: string) => void;
     /** Called when the user exits/cancels */
@@ -69,7 +84,7 @@ export interface AppProps {
  * and receives a shared headerElement prop.
  */
 export declare function App({ screen: initialScreen, initialSessionState, version, // Fallback if package.json read fails (keep in sync with index.ts)
-interviewProps, runProps, onComplete, onExit, }: AppProps): React.ReactElement | null;
+interviewProps, runProps, agentProps, onComplete, onExit, }: AppProps): React.ReactElement | null;
 /**
  * Render options for renderApp
  */
@@ -84,6 +99,8 @@ export interface RenderAppOptions {
     interviewProps?: InterviewAppProps;
     /** Props for run/monitor screen (if starting directly on run screen) */
     runProps?: RunAppProps;
+    /** Props for agent screen (if starting directly on agent screen) */
+    agentProps?: AgentAppProps;
     /** Called when spec generation completes */
     onComplete?: (result: string) => void;
     /** Called when user exits */

package/dist/tui/app.js

@@ -19,6 +19,7 @@ import { logger } from '../utils/logger.js';
 import { InterviewScreen } from './screens/InterviewScreen.js';
 import { InitScreen } from './screens/InitScreen.js';
 import { RunScreen } from './screens/RunScreen.js';
+import { AgentScreen } from './screens/AgentScreen.js';
 import { MainShell } from './screens/MainShell.js';
 import { HeaderContent } from './components/HeaderContent.js';
 import { useBackgroundRuns } from './hooks/useBackgroundRuns.js';
@@ -29,7 +30,7 @@ import { useBackgroundRuns } from './hooks/useBackgroundRuns.js';
  * and receives a shared headerElement prop.
  */
 export function App({ screen: initialScreen, initialSessionState, version = '0.12.1', // Fallback if package.json read fails (keep in sync with index.ts)
-interviewProps, runProps, onComplete, onExit, }) {
+interviewProps, runProps, agentProps, onComplete, onExit, }) {
     const [currentScreen, setCurrentScreen] = useState(initialScreen);
     const [screenProps, setScreenProps] = useState(() => {
         if (initialScreen === 'run' && runProps) {
@@ -184,7 +185,7 @@ interviewProps, runProps, onComplete, onExit, }) {
                 navigate('shell', { message: 'Feature name is required for the run screen.' });
             }
         }
-        else if (currentScreen !== 'shell' && currentScreen !== 'init') {
+        else if (currentScreen !== 'shell' && currentScreen !== 'init' && currentScreen !== 'agent') {
             // Unknown screen — redirect to shell on next tick
             navigate('shell', { message: `Internal error: unknown screen "${currentScreen}". Returned to shell.` });
         }
@@ -198,7 +199,7 @@ interviewProps, runProps, onComplete, onExit, }) {
             if (!featureName || typeof featureName !== 'string' || !sessionState.provider) {
                 return null; // useEffect will redirect to shell
             }
-            return (_jsx(InterviewScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, provider: sessionState.provider, model: sessionState.model, scanResult: sessionState.scanResult, specsPath: sessionState.config?.paths.specs, onComplete: handleInterviewComplete, onCancel: handleInterviewCancel }));
+            return (_jsx(InterviewScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, provider: sessionState.provider, model: sessionState.model, scanResult: sessionState.scanResult, specsPath: sessionState.config?.paths.specs, initialReferences: interviewProps?.initialReferences, onComplete: handleInterviewComplete, onCancel: handleInterviewCancel }));
         }
         case 'init':
             return (_jsx(InitScreen, { header: headerElement, projectRoot: sessionState.projectRoot, sessionState: sessionState, onComplete: handleInitComplete, onCancel: () => navigate('shell') }));
@@ -211,6 +212,23 @@ interviewProps, runProps, onComplete, onExit, }) {
             const reviewMode = screenProps?.reviewMode;
             return (_jsx(RunScreen, { header: headerElement, featureName: featureName, projectRoot: sessionState.projectRoot, sessionState: sessionState, monitorOnly: monitorOnly, reviewMode: reviewMode, onComplete: handleRunComplete, onBackground: handleRunBackground, onCancel: () => navigate('shell') }));
         }
+        case 'agent': {
+            // Merge CLI-provided agentProps with navigation screenProps (from /agent command)
+            const resolvedAgentOptions = {
+                ...agentProps,
+                ...(screenProps?.dryRun != null ? { dryRun: screenProps.dryRun } : {}),
+                ...(screenProps?.maxItems != null ? { maxItems: screenProps.maxItems } : {}),
+                ...(screenProps?.reviewMode != null ? { reviewMode: screenProps.reviewMode } : {}),
+            };
+            return (_jsx(AgentScreen, { header: headerElement, projectRoot: sessionState.projectRoot, agentOptions: resolvedAgentOptions, onExit: () => {
+                    if (initialScreen === 'agent') {
+                        onExit?.();
+                    }
+                    else {
+                        navigate('shell');
+                    }
+                } }));
+        }
         default: {
             // Return fallback UI instead of calling navigate() during render (which would be setState during render).
             // The useEffect guard above will redirect to shell on next tick.
@@ -224,5 +242,5 @@ interviewProps, runProps, onComplete, onExit, }) {
  * Render the App component to the terminal
  */
 export function renderApp(options) {
-    return render(_jsx(App, { screen: options.screen, initialSessionState: options.initialSessionState, version: options.version, interviewProps: options.interviewProps, runProps: options.runProps, onComplete: options.onComplete, onExit: options.onExit }));
+    return render(_jsx(App, { screen: options.screen, initialSessionState: options.initialSessionState, version: options.version, interviewProps: options.interviewProps, runProps: options.runProps, agentProps: options.agentProps, onComplete: options.onComplete, onExit: options.onExit }));
 }

package/dist/tui/components/IssuePicker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * IssuePicker - GitHub issue selection dropdown
+ *
+ * Displays a bordered list of GitHub issues for the user to navigate
+ * and select from. Follows the visual style of CommandDropdown.
+ * Supports arrow keys and j/k for navigation, Enter to select, Esc to cancel.
+ */
+import React from 'react';
+import type { GitHubIssueListItem } from '../../utils/github.js';
+/**
+ * Props for the IssuePicker component
+ */
+export interface IssuePickerProps {
+    /** List of issues to display */
+    issues: GitHubIssueListItem[];
+    /** Repository slug (e.g. "owner/repo") shown in header */
+    repoSlug: string;
+    /** Called when an issue is selected */
+    onSelect: (issue: GitHubIssueListItem) => void;
+    /** Called when the picker is dismissed (Escape) */
+    onCancel: () => void;
+    /** Whether issues are currently loading */
+    isLoading: boolean;
+    /** Optional error message to display */
+    error?: string;
+}
+export declare function IssuePicker({ issues, repoSlug, onSelect, onCancel, isLoading, error, }: IssuePickerProps): React.ReactElement;

package/dist/tui/components/IssuePicker.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * IssuePicker - GitHub issue selection dropdown
+ *
+ * Displays a bordered list of GitHub issues for the user to navigate
+ * and select from. Follows the visual style of CommandDropdown.
+ * Supports arrow keys and j/k for navigation, Enter to select, Esc to cancel.
+ */
+import React, { useState } from 'react';
+import { Box, Text, useInput, useStdout } from 'ink';
+import Spinner from 'ink-spinner';
+import { colors, box } from '../theme.js';
+const MAX_LABELS = 2;
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 1) + '\u2026';
+}
+export function IssuePicker({ issues, repoSlug, onSelect, onCancel, isLoading, error, }) {
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const { stdout } = useStdout();
+    const columns = stdout?.columns ?? 80;
+    React.useEffect(() => {
+        setSelectedIndex(0);
+    }, [issues]);
+    // Handle keyboard input
+    useInput((input, key) => {
+        if (key.escape) {
+            onCancel();
+            return;
+        }
+        if (key.return && issues.length > 0) {
+            onSelect(issues[selectedIndex]);
+            return;
+        }
+        if (key.upArrow || input === 'k') {
+            setSelectedIndex((prev) => Math.max(0, prev - 1));
+            return;
+        }
+        if (key.downArrow || input === 'j') {
+            setSelectedIndex((prev) => Math.min(issues.length - 1, prev + 1));
+            return;
+        }
+    });
+    // Build border strings
+    const countSuffix = !isLoading && !error ? ` (${issues.length})` : '';
+    const headerLabel = ` GitHub Issues ${box.horizontal} ${repoSlug}${countSuffix} `;
+    const contentWidth = Math.min(Math.max(60, headerLabel.length + 10), columns - 6);
+    const topBorderFill = contentWidth - headerLabel.length - 1;
+    const topBorder = box.topLeft + box.horizontal + headerLabel + box.horizontal.repeat(Math.max(0, topBorderFill)) + box.topRight;
+    const bottomBorder = box.bottomLeft + box.horizontal.repeat(contentWidth) + box.bottomRight;
+    // Space budget for title: total width minus number, labels, borders, padding
+    const numberWidth = 6; // " #999 " — enough for 3-digit issues
+    const labelBudget = 24; // space for up to 2 labels
+    const chrome = 4; // borders + padding
+    const titleMaxLen = Math.max(20, contentWidth - numberWidth - labelBudget - chrome);
+    return (_jsxs(Box, { flexDirection: "column", marginLeft: 2, marginTop: 1, children: [_jsx(Text, { dimColor: true, children: topBorder }), isLoading && (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: box.vertical }), _jsx(Text, { children: " " }), _jsx(Spinner, { type: "dots" }), _jsx(Text, { color: colors.yellow, children: " Searching..." }), _jsx(Text, { children: ' '.repeat(Math.max(0, contentWidth - 16)) }), _jsx(Text, { dimColor: true, children: box.vertical })] })), !isLoading && error && (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: box.vertical }), _jsxs(Text, { color: colors.pink, children: [" ", error] }), _jsx(Text, { children: ' '.repeat(Math.max(0, contentWidth - error.length - 1)) }), _jsx(Text, { dimColor: true, children: box.vertical })] })), !isLoading && !error && issues.length === 0 && (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: box.vertical }), _jsx(Text, { dimColor: true, children: " No open issues found" }), _jsx(Text, { children: ' '.repeat(Math.max(0, contentWidth - 21)) }), _jsx(Text, { dimColor: true, children: box.vertical })] })), !isLoading && !error && issues.map((issue, index) => {
+                const isSelected = index === selectedIndex;
+                const numberText = `#${issue.number}`;
+                const title = truncate(issue.title, titleMaxLen);
+                const labelTags = issue.labels.slice(0, MAX_LABELS).join(' ');
+                return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: box.vertical }), _jsxs(Text, { backgroundColor: isSelected ? colors.yellow : undefined, color: isSelected ? colors.brown : colors.yellow, children: [' ', numberText] }), _jsxs(Text, { backgroundColor: isSelected ? colors.yellow : undefined, color: isSelected ? colors.brown : undefined, children: ['  ', title] }), labelTags && (_jsxs(Text, { backgroundColor: isSelected ? colors.yellow : undefined, color: isSelected ? colors.brown : colors.gray, children: ['  ', labelTags] })), _jsxs(Text, { dimColor: true, children: [' '.repeat(1), box.vertical] })] }, issue.number));
+            }), _jsx(Text, { dimColor: true, children: bottomBorder }), _jsx(Box, { marginLeft: 1, children: _jsxs(Text, { color: colors.gray, children: ['(', '\u2191\u2193 navigate, Enter select, Esc cancel', ')'] }) })] }));
+}

package/dist/tui/components/RunCompletionSummary.js

@@ -116,10 +116,12 @@ export function RunCompletionSummary({ summary, }) {
     return (_jsxs(SummaryBox, { minWidth: 60, children: [_jsx(Text, { bold: true, children: summary.feature }), _jsxs(Box, { flexDirection: "row", gap: 1, children: [_jsxs(Text, { bold: true, color: exitStatus.color, children: [statusIcon, " ", exitStatus.label] }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { dimColor: true, children: subtitleParts.join(' · ') })] }), _jsxs(SummaryBoxSection, { children: [_jsx(Text, { bold: true, children: "Phases" }), summary.phases && summary.phases.length > 0 ? (summary.phases.map((phaseInfo) => {
                         const phaseIcon = phaseInfo.status === 'success' ? phase.complete :
                             phaseInfo.status === 'failed' ? phase.error :
-                                phase.pending;
+                                phaseInfo.status === 'started' ? phase.active :
+                                    phase.pending;
                         const phaseColor = phaseInfo.status === 'success' ? colors.green :
                             phaseInfo.status === 'failed' ? colors.pink :
-                                colors.gray;
+                                phaseInfo.status === 'started' ? colors.yellow :
+                                    colors.gray;
                         const durationText = phaseInfo.durationMs !== undefined
                             ? formatDurationMs(phaseInfo.durationMs)
                             : 'Not available';
@@ -127,7 +129,8 @@ export function RunCompletionSummary({ summary, }) {
                             ? ` (${phaseInfo.iterations} iterations)`
                             : '';
                         const statusText = phaseInfo.status === 'skipped' ? ' skipped' :
-                            phaseInfo.status === 'failed' ? ' failed' : '';
+                            phaseInfo.status === 'failed' ? ' failed' :
+                                phaseInfo.status === 'started' ? ' in progress' : '';
                         return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: phaseColor, children: [phaseIcon, " "] }), _jsxs(Text, { children: [phaseInfo.label, " ", durationText, iterationsText, statusText] })] }, phaseInfo.id));
                     })) : (_jsx(Text, { children: "No phase information available" }))] }), _jsxs(SummaryBoxSection, { children: [_jsx(Text, { bold: true, children: "Changes" }), !summary.changes || !summary.changes.available ? (_jsx(Text, { children: "Changes: Not available" })) : summary.changes.totalFilesChanged === 0 || (summary.changes.files && summary.changes.files.length === 0) ? (_jsx(Text, { children: "No changes" })) : summary.changes.totalFilesChanged !== undefined ? (_jsxs(Text, { children: [summary.changes.totalFilesChanged, " file", summary.changes.totalFilesChanged !== 1 ? 's' : '', " changed"] })) : !summary.changes.files ? (_jsx(Text, { children: "Changes: Could not compute diff" })) : null, (() => {
                         const files = summary.changes?.available ? summary.changes.files : undefined;

package/dist/tui/hooks/useAgentOrchestrator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * useAgentOrchestrator — React hook that bridges the agent orchestrator
+ * lifecycle to TUI state via callbacks.
+ *
+ * Creates the orchestrator, runs it via stream(), and interprets tool
+ * calls into structured state (active issue, queue, completed, log).
+ * Exposes an abort() function for clean shutdown on q/Esc.
+ */
+import type { AgentIssueState, AgentLogEntry, ReviewMode } from '../../agent/types.js';
+export type AgentStatus = 'idle' | 'running' | 'complete' | 'error';
+export interface UseAgentOrchestratorOptions {
+    projectRoot: string;
+    modelOverride?: string;
+    maxItems?: number;
+    maxSteps?: number;
+    labels?: string[];
+    reviewMode?: ReviewMode;
+    dryRun?: boolean;
+}
+export interface UseAgentOrchestratorResult {
+    status: AgentStatus;
+    activeIssue: AgentIssueState | null;
+    queue: AgentIssueState[];
+    completed: AgentIssueState[];
+    logEntries: AgentLogEntry[];
+    error: string | null;
+    abort: () => void;
+}
+export declare function useAgentOrchestrator(options: UseAgentOrchestratorOptions): UseAgentOrchestratorResult;