wiggum-cli 0.16.0 → 0.17.1

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,8 @@ 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: screenProps?.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 +213,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 +243,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,73 @@
+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';
+}
+function pad(text, width) {
+    if (text.length >= width)
+        return text.slice(0, width);
+    return text + ' '.repeat(width - text.length);
+}
+// Fixed column widths
+const COL_NUMBER = 6; // " #104 "
+const COL_STATE = 8; // " closed " or "  open  "
+const COL_LABELS = 14; // " enhancement "
+const COL_CHROME = 2; // left + right border
+export function IssuePicker({ issues, repoSlug, onSelect, onCancel, isLoading, error, }) {
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const { stdout } = useStdout();
+    const termColumns = stdout?.columns ?? 80;
+    React.useEffect(() => {
+        setSelectedIndex(0);
+    }, [issues]);
+    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;
+        }
+    });
+    const countSuffix = !isLoading && !error ? ` (${issues.length})` : '';
+    const headerLabel = ` GitHub Issues ${box.horizontal} ${repoSlug}${countSuffix} `;
+    const contentWidth = Math.min(Math.max(60, headerLabel.length + 10), termColumns - 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;
+    // Title column gets all remaining space
+    const colTitle = Math.max(20, contentWidth - COL_NUMBER - COL_STATE - COL_LABELS - COL_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 }), _jsx(Text, { color: colors.pink, children: pad(` ${error}`, contentWidth) }), _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: pad(' No open issues found', contentWidth) }), _jsx(Text, { dimColor: true, children: box.vertical })] })), !isLoading && !error && issues.map((issue, index) => {
+                const isSelected = index === selectedIndex;
+                const bg = isSelected ? colors.yellow : undefined;
+                const fg = isSelected ? colors.brown : undefined;
+                const numberCell = pad(` #${issue.number}`, COL_NUMBER);
+                const titleCell = pad(` ${truncate(issue.title, colTitle - 1)}`, colTitle);
+                const stateCell = pad(` ${issue.state}`, COL_STATE);
+                const labelText = issue.labels.slice(0, MAX_LABELS).join(' ');
+                const labelCell = pad(` ${truncate(labelText, COL_LABELS - 1)}`, COL_LABELS);
+                return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { dimColor: true, children: box.vertical }), _jsx(Text, { backgroundColor: bg, color: isSelected ? colors.brown : colors.yellow, children: numberCell }), _jsx(Text, { backgroundColor: bg, color: fg, children: titleCell }), _jsx(Text, { backgroundColor: bg, color: isSelected ? colors.brown : issue.state === 'open' ? colors.green : colors.gray, children: stateCell }), _jsx(Text, { backgroundColor: bg, color: isSelected ? colors.brown : colors.gray, children: labelCell }), _jsx(Text, { dimColor: true, children: 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/components/StatusLine.d.ts

@@ -15,6 +15,8 @@ export interface StatusLineProps {
     phase?: string;
     /** Path or context info (e.g., working directory or feature name) */
     path?: string;
+    /** Extra trailing segment (e.g., "review: auto") */
+    extra?: string;
 }
 /**
  * StatusLine component
@@ -32,4 +34,4 @@ export interface StatusLineProps {
  * // Renders: Initialize Project │ Analysis (4/5) │ /Users/name/project
  * ```
  */
-export declare function StatusLine({ action, phase, path, }: StatusLineProps): React.ReactElement;
+export declare function StatusLine({ action, phase, path, extra, }: StatusLineProps): React.ReactElement;

package/dist/tui/components/StatusLine.js

@@ -17,11 +17,11 @@ import { theme, colors } from '../theme.js';
  * // Renders: Initialize Project │ Analysis (4/5) │ /Users/name/project
  * ```
  */
-export function StatusLine({ action, phase, path, }) {
+export function StatusLine({ action, phase, path, extra, }) {
     const separator = theme.statusLine.separator;
     // Truncate path if too long (keep last 40 chars)
     const displayPath = path && path.length > 40
         ? '...' + path.slice(-37)
         : path;
-    return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: colors.yellow, bold: true, children: action }), phase && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: separator }), _jsx(Text, { children: phase })] })), displayPath && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: separator }), _jsx(Text, { dimColor: true, children: displayPath })] }))] }));
+    return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: colors.yellow, bold: true, children: action }), phase && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: separator }), _jsx(Text, { children: phase })] })), displayPath && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: separator }), _jsx(Text, { dimColor: true, children: displayPath })] })), extra && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: separator }), _jsx(Text, { dimColor: true, children: extra })] }))] }));
 }

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

@@ -0,0 +1,40 @@
+/**
+ * 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';
+import { type LoopStatus, type TaskCounts, type ActivityEvent } from '../utils/loop-status.js';
+import { type CommitLogEntry } from '../utils/git-summary.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 LoopMonitorData {
+    loopStatus: LoopStatus;
+    tasks: TaskCounts;
+    branch: string;
+    recentCommits: CommitLogEntry[];
+    activityEvents: ActivityEvent[];
+    startTime: number;
+}
+export interface UseAgentOrchestratorResult {
+    status: AgentStatus;
+    activeIssue: AgentIssueState | null;
+    queue: AgentIssueState[];
+    completed: AgentIssueState[];
+    logEntries: AgentLogEntry[];
+    loopMonitor: LoopMonitorData | null;
+    error: string | null;
+    abort: () => void;
+}
+export declare function useAgentOrchestrator(options: UseAgentOrchestratorOptions): UseAgentOrchestratorResult;