@rainy-updates/cli 0.6.0 → 0.6.2

package/dist/ui/tui.js

@@ -1,178 +1,286 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState } from "react";
-import { Box, render, Text, useInput } from "ink";
-const FILTER_ORDER = [
-    "all",
-    "security",
-    "risky",
-    "major",
-    "peer-conflict",
-    "license",
-    "unused",
-    "blocked",
-];
+import React from "react";
+import { Box, render, Text, useInput, useStdout } from "ink";
+import { DETAIL_TABS, FILTER_ORDER, } from "./dashboard-state.js";
 const SORT_ORDER = ["risk", "advisories", "diff", "name", "workspace"];
 const GROUP_ORDER = ["none", "workspace", "scope", "risk", "decision"];
-const DETAIL_TABS = [
-    "overview",
-    "risk",
-    "security",
-    "peer",
-    "license",
-    "health",
-    "changelog",
-];
-function TuiApp({ items, title, subtitle, onComplete }) {
-    const [cursorIndex, setCursorIndex] = useState(0);
-    const [filterIndex, setFilterIndex] = useState(0);
-    const [sortIndex, setSortIndex] = useState(0);
-    const [groupIndex, setGroupIndex] = useState(0);
-    const [tabIndex, setTabIndex] = useState(0);
-    const [showHelp, setShowHelp] = useState(false);
-    const [searchMode, setSearchMode] = useState(false);
-    const [search, setSearch] = useState("");
-    const [selectedIndices, setSelectedIndices] = useState(new Set(items.flatMap((item, index) => item.update.selectedByDefault === false ? [] : [index])));
-    const activeFilter = FILTER_ORDER[filterIndex] ?? "all";
-    const activeSort = SORT_ORDER[sortIndex] ?? "risk";
-    const activeGroup = GROUP_ORDER[groupIndex] ?? "none";
-    const activeTab = DETAIL_TABS[tabIndex] ?? "overview";
+function tuiReducer(state, action) {
+    switch (action.type) {
+        case "SET_SEARCH_MODE":
+            return {
+                ...state,
+                searchMode: action.active,
+                ...(action.active ? {} : { search: "", cursorIndex: 0 }),
+            };
+        case "APPEND_SEARCH":
+            return { ...state, search: state.search + action.value, cursorIndex: 0 };
+        case "BACKSPACE_SEARCH":
+            return { ...state, search: state.search.slice(0, -1), cursorIndex: 0 };
+        case "TOGGLE_HELP":
+            return { ...state, showHelp: !state.showHelp };
+        case "SET_HELP":
+            return { ...state, showHelp: action.active };
+        case "MOVE_FILTER":
+            return {
+                ...state,
+                filterIndex: Math.min(action.max, Math.max(0, state.filterIndex + action.direction)),
+                cursorIndex: 0,
+            };
+        case "MOVE_CURSOR":
+            return {
+                ...state,
+                cursorIndex: Math.min(action.max, Math.max(0, state.cursorIndex + action.direction)),
+            };
+        case "CYCLE_SORT":
+            return {
+                ...state,
+                sortIndex: (state.sortIndex + 1) % action.max,
+                cursorIndex: 0,
+            };
+        case "CYCLE_GROUP":
+            return {
+                ...state,
+                groupIndex: (state.groupIndex + 1) % action.max,
+                cursorIndex: 0,
+            };
+        case "CYCLE_TAB": {
+            const next = (state.tabIndex + action.direction + action.max) % action.max;
+            return { ...state, tabIndex: next };
+        }
+        case "SET_SELECTED":
+            return { ...state, selectedIndices: action.indices };
+        case "TOGGLE_SELECTED": {
+            const next = new Set(state.selectedIndices);
+            if (next.has(action.index))
+                next.delete(action.index);
+            else
+                next.add(action.index);
+            return { ...state, selectedIndices: next };
+        }
+        default:
+            return state;
+    }
+}
+function TuiApp({ items, title, subtitle, initialFilter = "all", initialTab = "overview", onComplete, }) {
+    const { stdout } = useStdout();
+    const { columns: stdoutWidth = 160, rows: stdoutHeight = 32 } = stdout;
+    const [state, dispatch] = React.useReducer(tuiReducer, undefined, () => ({
+        cursorIndex: 0,
+        filterIndex: Math.max(0, FILTER_ORDER.indexOf(initialFilter)),
+        sortIndex: 0,
+        groupIndex: 0,
+        tabIndex: Math.max(0, DETAIL_TABS.indexOf(initialTab)),
+        showHelp: false,
+        searchMode: false,
+        search: "",
+        selectedIndices: new Set(items.flatMap((item, index) => item.update.selectedByDefault === false ? [] : [index])),
+    }));
+    const activeFilter = FILTER_ORDER[state.filterIndex] ?? "all";
+    const activeSort = SORT_ORDER[state.sortIndex] ?? "risk";
+    const activeGroup = GROUP_ORDER[state.groupIndex] ?? "none";
+    const activeTab = DETAIL_TABS[state.tabIndex] ?? "overview";
     const visibleRows = buildVisibleRows(items, {
         filter: activeFilter,
         sort: activeSort,
         group: activeGroup,
-        search,
+        search: state.search,
     });
     const itemRows = visibleRows.filter((row) => row.kind === "item" && typeof row.index === "number");
-    const boundedCursor = Math.min(cursorIndex, Math.max(0, itemRows.length - 1));
+    const boundedCursor = Math.min(state.cursorIndex, Math.max(0, itemRows.length - 1));
     const focusedIndex = itemRows[boundedCursor]?.index ?? 0;
     const focusedItem = items[focusedIndex];
+    const visibleMetrics = summarizeVisibleItems(itemRows, items, state.selectedIndices);
+    const renderWindow = createRenderWindow({
+        visibleRows,
+        focusedIndex,
+        stdoutHeight,
+    });
+    const rowPositionByIndex = createRowPositionMap(itemRows);
+    const layout = createDashboardLayout(stdoutWidth);
+    const platformLabel = process.platform === "win32" ? "windows" : "unix";
+    const selectedItems = items.filter((_, index) => state.selectedIndices.has(index));
     useInput((input, key) => {
-        if (searchMode) {
+        if (state.searchMode) {
             if (key.escape) {
-                setSearchMode(false);
-                setSearch("");
-                setCursorIndex(0);
+                dispatch({ type: "SET_SEARCH_MODE", active: false });
                 return;
             }
             if (key.return) {
-                setSearchMode(false);
-                setCursorIndex(0);
+                dispatch({ type: "SET_SEARCH_MODE", active: false });
                 return;
             }
             if (key.backspace || key.delete) {
-                setSearch((value) => value.slice(0, -1));
-                setCursorIndex(0);
+                dispatch({ type: "BACKSPACE_SEARCH" });
                 return;
             }
             if (input && !key.ctrl && !key.meta) {
-                setSearch((value) => value + input);
-                setCursorIndex(0);
+                dispatch({ type: "APPEND_SEARCH", value: input });
             }
             return;
         }
         if (input === "/") {
-            setSearchMode(true);
+            dispatch({ type: "SET_SEARCH_MODE", active: true });
             return;
         }
         if (input === "?") {
-            setShowHelp((value) => !value);
+            dispatch({ type: "TOGGLE_HELP" });
             return;
         }
-        if (key.escape && showHelp) {
-            setShowHelp(false);
+        if (key.escape && state.showHelp) {
+            dispatch({ type: "SET_HELP", active: false });
             return;
         }
-        if (key.leftArrow) {
-            setFilterIndex((prev) => Math.max(0, prev - 1));
-            setCursorIndex(0);
+        if (key.leftArrow || input === "h") {
+            dispatch({
+                type: "MOVE_FILTER",
+                direction: -1,
+                max: FILTER_ORDER.length - 1,
+            });
+            return;
         }
-        if (key.rightArrow) {
-            setFilterIndex((prev) => Math.min(FILTER_ORDER.length - 1, prev + 1));
-            setCursorIndex(0);
+        if (key.rightArrow || input === "l") {
+            dispatch({
+                type: "MOVE_FILTER",
+                direction: 1,
+                max: FILTER_ORDER.length - 1,
+            });
+            return;
         }
-        if (key.upArrow) {
-            setCursorIndex((prev) => Math.max(0, prev - 1));
+        if (key.upArrow || input === "k") {
+            dispatch({
+                type: "MOVE_CURSOR",
+                direction: -1,
+                max: itemRows.length - 1,
+            });
+            return;
         }
-        if (key.downArrow) {
-            setCursorIndex((prev) => Math.min(itemRows.length - 1, Math.max(0, prev + 1)));
+        if (key.downArrow || input === "j") {
+            dispatch({
+                type: "MOVE_CURSOR",
+                direction: 1,
+                max: itemRows.length - 1,
+            });
+            return;
         }
         if (input === "o") {
-            setSortIndex((prev) => (prev + 1) % SORT_ORDER.length);
-            setCursorIndex(0);
+            dispatch({ type: "CYCLE_SORT", max: SORT_ORDER.length });
+            return;
         }
         if (input === "g") {
-            setGroupIndex((prev) => (prev + 1) % GROUP_ORDER.length);
-            setCursorIndex(0);
+            dispatch({ type: "CYCLE_GROUP", max: GROUP_ORDER.length });
+            return;
         }
         if (key.tab) {
-            setTabIndex((prev) => (prev + 1) % DETAIL_TABS.length);
+            dispatch({
+                type: "CYCLE_TAB",
+                direction: key.shift ? -1 : 1,
+                max: DETAIL_TABS.length,
+            });
+            return;
         }
         if (input === "a") {
-            setSelectedIndices((prev) => addVisible(prev, itemRows));
+            dispatch({
+                type: "SET_SELECTED",
+                indices: addVisible(state.selectedIndices, itemRows),
+            });
+            return;
         }
         if (input === "n") {
-            setSelectedIndices((prev) => removeVisible(prev, itemRows));
+            dispatch({
+                type: "SET_SELECTED",
+                indices: removeVisible(state.selectedIndices, itemRows),
+            });
+            return;
         }
         if (input === "s") {
-            setSelectedIndices((prev) => selectSafe(prev, itemRows, items));
+            dispatch({
+                type: "SET_SELECTED",
+                indices: selectSafe(state.selectedIndices, itemRows, items),
+            });
+            return;
         }
         if (input === "b") {
-            setSelectedIndices((prev) => clearBlocked(prev, itemRows, items));
+            dispatch({
+                type: "SET_SELECTED",
+                indices: clearBlocked(state.selectedIndices, itemRows, items),
+            });
+            return;
         }
-        if (input === " ") {
-            setSelectedIndices((prev) => {
-                const next = new Set(prev);
-                if (next.has(focusedIndex))
-                    next.delete(focusedIndex);
-                else
-                    next.add(focusedIndex);
-                return next;
+        if (input === "x") {
+            dispatch({
+                type: "SET_SELECTED",
+                indices: selectActionable(state.selectedIndices, itemRows, items),
             });
+            return;
+        }
+        if (input === " ") {
+            dispatch({ type: "TOGGLE_SELECTED", index: focusedIndex });
+            return;
         }
-        if (input === "q" || key.escape) {
-            onComplete(items.filter((_, index) => selectedIndices.has(index)));
+        if (input === "q" || (key.escape && !state.showHelp)) {
+            onComplete(selectedItems);
             return;
         }
         if (key.return) {
-            onComplete(items.filter((_, index) => selectedIndices.has(index)));
+            onComplete(selectedItems);
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: title ?? "Rainy Dashboard" }), _jsx(Text, { color: "gray", children: subtitle ??
-                    "Check detects, doctor summarizes, dashboard decides, upgrade applies." }), _jsx(Text, { color: "gray", children: "Filters: \u2190/\u2192  Sort: o  Group: g  Tabs: Tab  Search: /  Help: ?  Space: toggle  Enter: confirm" }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsxs(Box, { width: 24, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Filter Rail" }), FILTER_ORDER.map((filter, index) => (_jsxs(Text, { color: index === filterIndex ? "cyan" : "gray", children: [index === filterIndex ? ">" : " ", " ", filter] }, filter))), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Search" }), _jsx(Text, { color: searchMode ? "cyan" : "gray", children: searchMode ? `/${search}` : search ? `/${search}` : "inactive" })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Modes" }), _jsxs(Text, { color: "gray", children: ["sort: ", activeSort] }), _jsxs(Text, { color: "gray", children: ["group: ", activeGroup] }), _jsxs(Text, { color: "gray", children: ["tab: ", activeTab] })] })] }), _jsxs(Box, { marginLeft: 1, width: 82, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Review Queue" }), itemRows.length === 0 ? (_jsx(Text, { color: "gray", children: "No review candidates match this view." })) : (visibleRows.map((row, visibleIndex) => {
-                                if (row.kind === "group") {
-                                    return (_jsx(Text, { bold: true, color: "gray", children: row.label }, `group:${row.label}`));
-                                }
-                                const index = row.index ?? 0;
-                                const item = items[index];
-                                const update = item.update;
-                                const decision = update.decisionState ?? deriveDecision(item);
-                                const itemPosition = itemRows.findIndex((candidate) => candidate.index === index);
-                                const isFocused = itemPosition === boundedCursor;
-                                const isSelected = selectedIndices.has(index);
-                                return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: isFocused ? "cyan" : "gray", children: [isFocused ? ">" : " ", " ", isSelected ? "[x]" : "[ ]", " "] }), _jsx(Box, { width: 22, children: _jsx(Text, { bold: isFocused, children: update.name }) }), _jsx(Box, { width: 14, children: _jsx(Text, { color: diffColor(update.diffType), children: update.diffType }) }), _jsx(Box, { width: 14, children: _jsx(Text, { color: riskColor(update.riskLevel), children: update.riskLevel ?? "low" }) }), _jsx(Box, { width: 14, children: _jsx(Text, { color: decisionColor(decision), children: decision }) }), _jsx(Box, { width: 10, children: _jsx(Text, { color: decisionColor(decision), children: update.riskScore ?? "--" }) }), _jsx(Text, { color: "gray", children: update.fromRange }), _jsx(Text, { color: "gray", children: " \u2192 " }), _jsx(Text, { color: "green", children: update.toVersionResolved })] }, `${update.packagePath}:${update.name}`));
-                            }))] }), _jsxs(Box, { marginLeft: 1, width: 54, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Decision Panel" }), _jsxs(Text, { color: "gray", children: ["tab: ", activeTab] }), focusedItem ? renderTab(focusedItem, activeTab) : _jsx(Text, { color: "gray", children: "No review candidate selected." })] })] }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsxs(Text, { color: "gray", children: [selectedIndices.size, " selected of ", items.length, ". view=", activeFilter, " sort=", activeSort, " group=", activeGroup] }) }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(Text, { color: "gray", children: "A select visible  N clear visible  S select safe  B clear blocked  Q finish  Esc clears search/help" }) }), showHelp ? (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Help" }), _jsx(Text, { color: "gray", children: "Use review as the decision center. Search packages with / and inspect details with Tab." }), _jsx(Text, { color: "gray", children: "Blocked items default to deselected. Safe items can be bulk-selected with S." })] })) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(DashboardHeader, { title: title, subtitle: subtitle, platformLabel: platformLabel, metrics: visibleMetrics }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(FilterRail, { width: layout.railWidth, filterIndex: state.filterIndex, search: state.search, searchMode: state.searchMode, activeSort: activeSort, activeGroup: activeGroup, activeTab: activeTab }), _jsx(QueuePanel, { width: layout.queueWidth, items: items, visibleRows: visibleRows, itemRows: itemRows, renderWindow: renderWindow, rowPositionByIndex: rowPositionByIndex, boundedCursor: boundedCursor, selectedIndices: state.selectedIndices }), _jsx(DecisionPanel, { width: layout.detailWidth, activeTab: activeTab, focusedItem: focusedItem })] }), _jsx(ActionBar, {}), state.showHelp ? _jsx(HelpPanel, {}) : null] }));
+}
+function DashboardHeader({ title, subtitle, platformLabel, metrics, }) {
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: "cyan", children: title ?? "Rainy Dashboard" }), _jsx(Text, { color: "gray", children: subtitle ??
+                    "Check detects, doctor summarizes, dashboard decides, upgrade applies." }), _jsxs(Text, { color: "gray", children: [platformLabel, " keys: arrows or hjkl, Tab changes panel, / search, ? help, Enter confirm"] }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsxs(Text, { children: ["visible ", metrics.total, " | selected ", metrics.selected, " | actionable", " ", metrics.actionable, " | blocked ", metrics.blocked, " | security", " ", metrics.security] }) })] }));
+}
+function FilterRail({ width, filterIndex, search, searchMode, activeSort, activeGroup, activeTab, }) {
+    return (_jsxs(Box, { width: width, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Filter Rail" }), FILTER_ORDER.map((filter, index) => (_jsxs(Text, { color: index === filterIndex ? "cyan" : "gray", children: [index === filterIndex ? ">" : " ", " ", filter] }, filter))), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Search" }), _jsx(Text, { color: searchMode ? "cyan" : "gray", children: searchMode ? `/${search}` : search ? `/${search}` : "inactive" })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Modes" }), _jsxs(Text, { color: "gray", children: ["sort: ", activeSort] }), _jsxs(Text, { color: "gray", children: ["group: ", activeGroup] }), _jsxs(Text, { color: "gray", children: ["tab: ", activeTab] })] })] }));
+}
+function QueuePanel({ width, items, visibleRows, itemRows, renderWindow, rowPositionByIndex, boundedCursor, selectedIndices, }) {
+    return (_jsxs(Box, { marginLeft: 1, width: width, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsxs(Text, { bold: true, children: ["Review Queue", renderWindow.start > 0 ? "  [more above]" : "", renderWindow.end < visibleRows.length ? "  [more below]" : ""] }), itemRows.length === 0 ? (_jsx(Text, { color: "gray", children: "No review candidates match this view." })) : (renderWindow.rows.map((row) => (_jsx(QueueRow, { row: row, items: items, rowPositionByIndex: rowPositionByIndex, boundedCursor: boundedCursor, selectedIndices: selectedIndices }, row.kind === "group" ? `group:${row.label}` : `${items[row.index ?? 0]?.update.packagePath}:${items[row.index ?? 0]?.update.name}`))))] }));
+}
+function QueueRow({ row, items, rowPositionByIndex, boundedCursor, selectedIndices, }) {
+    if (row.kind === "group") {
+        return (_jsx(Text, { bold: true, color: "gray", children: row.label }));
+    }
+    const index = row.index ?? 0;
+    const item = items[index];
+    const update = item.update;
+    const decision = update.decisionState ?? deriveDecision(item);
+    const itemPosition = rowPositionByIndex.get(index) ?? -1;
+    const isFocused = itemPosition === boundedCursor;
+    const isSelected = selectedIndices.has(index);
+    return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: isFocused ? "cyan" : "gray", children: [isFocused ? ">" : " ", " ", isSelected ? "[x]" : "[ ]", " "] }), _jsx(Box, { width: 24, children: _jsx(Text, { bold: isFocused, children: truncate(update.name, 22) }) }), _jsx(Box, { width: 10, children: _jsx(Text, { color: diffColor(update.diffType), children: update.diffType }) }), _jsx(Box, { width: 11, children: _jsx(Text, { color: riskColor(update.riskLevel), children: update.riskLevel ?? "low" }) }), _jsx(Box, { width: 12, children: _jsx(Text, { color: decisionColor(decision), children: truncate(decision, 10) }) }), _jsx(Box, { width: 7, children: _jsx(Text, { color: decisionColor(decision), children: update.riskScore ?? "--" }) }), _jsxs(Text, { color: "gray", children: [truncate(update.fromRange, 12), " ", "->", " "] }), _jsx(Text, { color: "green", children: truncate(update.toVersionResolved, 12) })] }));
+}
+function DecisionPanel({ width, activeTab, focusedItem, }) {
+    return (_jsxs(Box, { marginLeft: 1, width: width, flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, children: "Decision Panel" }), _jsxs(Text, { color: "gray", children: ["tab: ", activeTab] }), focusedItem ? (renderTab(focusedItem, activeTab)) : (_jsx(Text, { color: "gray", children: "No review candidate selected." }))] }));
+}
+function ActionBar() {
+    return (_jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "gray", paddingX: 1, children: _jsx(Text, { color: "gray", children: "A add visible | N clear visible | S safe | X actionable | B clear blocked | Space toggle | Q finish" }) }));
+}
+function HelpPanel() {
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Help" }), _jsx(Text, { color: "gray", children: "Use filters for queue slices, search with /, and switch panels with Tab." }), _jsx(Text, { color: "gray", children: "The queue is windowed around the focused package for faster rendering in large workspaces." }), _jsx(Text, { color: "gray", children: "Actionable items can be bulk-selected with X. Blocked items stay easy to clear with B." })] }));
 }
 function renderTab(item, tab) {
     const update = item.update;
     if (tab === "risk") {
-        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["state: ", _jsx(Text, { color: decisionColor(update.decisionState ?? deriveDecision(item)), children: update.decisionState ?? deriveDecision(item) })] }), _jsxs(Text, { children: ["policy: ", _jsx(Text, { color: decisionColor(policyToDecision(update.policyAction)), children: update.policyAction ?? "allow" })] }), _jsxs(Text, { children: ["risk score: ", update.riskScore ?? 0] }), _jsxs(Text, { children: ["impact score: ", update.impactScore?.score ?? 0] }), _jsxs(Text, { children: ["recommended action: ", update.recommendedAction ?? "Safe to keep in the selected set."] }), update.riskReasons && update.riskReasons.length > 0 ? update.riskReasons.slice(0, 5).map((reason) => (_jsxs(Text, { color: "gray", children: ["- ", reason] }, reason))) : _jsx(Text, { color: "gray", children: "No elevated risk reasons." })] }));
+        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["state:", " ", _jsx(Text, { color: decisionColor(update.decisionState ?? deriveDecision(item)), children: update.decisionState ?? deriveDecision(item) })] }), _jsxs(Text, { children: ["policy:", " ", _jsx(Text, { color: decisionColor(policyToDecision(update.policyAction)), children: update.policyAction ?? "allow" })] }), _jsxs(Text, { children: ["risk score: ", update.riskScore ?? 0] }), _jsxs(Text, { children: ["impact score: ", update.impactScore?.score ?? 0] }), _jsxs(Text, { children: ["recommended:", " ", truncate(update.recommendedAction ?? "Safe to keep in the selected set.", 80)] }), update.riskReasons && update.riskReasons.length > 0 ? (update.riskReasons.slice(0, 5).map((reason) => (_jsxs(Text, { color: "gray", children: ["- ", truncate(reason, 48)] }, reason)))) : (_jsx(Text, { color: "gray", children: "No elevated risk reasons." }))] }));
     }
     if (tab === "security") {
-        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["advisories: ", item.advisories.length] }), item.advisories.length > 0 ? item.advisories.slice(0, 4).map((advisory) => (_jsxs(Text, { color: "gray", children: ["- ", advisory.severity, " ", advisory.cveId, ": ", advisory.title] }, `${advisory.packageName}:${advisory.cveId}`))) : _jsx(Text, { color: "gray", children: "No security advisories detected." })] }));
+        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["advisories: ", item.advisories.length] }), item.advisories.length > 0 ? (item.advisories.slice(0, 4).map((advisory) => (_jsxs(Text, { color: "gray", children: ["- ", truncate(`${advisory.severity} ${advisory.cveId}: ${advisory.title}`, 48)] }, `${advisory.packageName}:${advisory.cveId}`)))) : (_jsx(Text, { color: "gray", children: "No security advisories detected." }))] }));
     }
     if (tab === "peer") {
-        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["peer status: ", update.peerConflictSeverity ?? "none"] }), item.peerConflicts.length > 0 ? item.peerConflicts.slice(0, 4).map((conflict) => (_jsxs(Text, { color: "gray", children: ["- ", conflict.requester, " requires ", conflict.peer, " ", conflict.requiredRange] }, `${conflict.requester}:${conflict.peer}`))) : _jsx(Text, { color: "gray", children: "No peer conflicts detected." })] }));
+        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["peer status: ", update.peerConflictSeverity ?? "none"] }), item.peerConflicts.length > 0 ? (item.peerConflicts.slice(0, 4).map((conflict) => (_jsxs(Text, { color: "gray", children: ["- ", truncate(`${conflict.requester} requires ${conflict.peer} ${conflict.requiredRange}`, 48)] }, `${conflict.requester}:${conflict.peer}`)))) : (_jsx(Text, { color: "gray", children: "No peer conflicts detected." }))] }));
     }
     if (tab === "license") {
-        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["license status: ", update.licenseStatus ?? "allowed"] }), _jsxs(Text, { children: ["repository: ", update.repository ?? "unavailable"] }), _jsxs(Text, { children: ["homepage: ", update.homepage ?? "unavailable"] })] }));
+        return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["license status: ", update.licenseStatus ?? "allowed"] }), _jsxs(Text, { children: ["repository: ", truncate(update.repository ?? "unavailable", 48)] }), _jsxs(Text, { children: ["homepage: ", truncate(update.homepage ?? "unavailable", 48)] })] }));
     }
     if (tab === "health") {
         return (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["health: ", update.healthStatus ?? "healthy"] }), _jsxs(Text, { children: ["maintainers: ", update.maintainerCount ?? "unknown"] }), _jsxs(Text, { children: ["publish age days: ", update.publishAgeDays ?? "unknown"] }), _jsxs(Text, { children: ["maintainer churn: ", update.maintainerChurn ?? "unknown"] })] }));
     }
     if (tab === "changelog") {
-        return (_jsxs(_Fragment, { children: [_jsx(Text, { children: update.releaseNotesSummary?.title ?? "Release notes unavailable" }), _jsx(Text, { color: "gray", children: update.releaseNotesSummary?.excerpt ?? "Run review with changelog support or inspect the repository manually." })] }));
+        return (_jsxs(_Fragment, { children: [_jsx(Text, { children: truncate(update.releaseNotesSummary?.title ?? "Release notes unavailable", 48) }), _jsx(Text, { color: "gray", children: truncate(update.releaseNotesSummary?.excerpt ??
+                        "Run review with changelog support or inspect the repository manually.", 96) })] }));
     }
-    return (_jsxs(_Fragment, { children: [_jsx(Text, { children: update.name }), _jsxs(Text, { color: "gray", children: ["package: ", update.packagePath] }), _jsxs(Text, { children: ["state: ", _jsx(Text, { color: decisionColor(update.decisionState ?? deriveDecision(item)), children: update.decisionState ?? deriveDecision(item) })] }), _jsxs(Text, { children: ["diff: ", _jsx(Text, { color: diffColor(update.diffType), children: update.diffType })] }), _jsxs(Text, { children: ["risk: ", _jsx(Text, { color: riskColor(update.riskLevel), children: update.riskLevel ?? "low" })] }), _jsxs(Text, { children: ["policy: ", update.policyAction ?? "allow"] }), _jsxs(Text, { children: ["workspace: ", update.workspaceGroup ?? "root"] }), _jsxs(Text, { children: ["group: ", update.groupKey ?? "none"] }), _jsxs(Text, { children: ["action: ", update.recommendedAction ?? "Safe to keep in the selected set."] })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { children: update.name }), _jsxs(Text, { color: "gray", children: ["package: ", truncate(update.packagePath, 48)] }), _jsxs(Text, { children: ["state:", " ", _jsx(Text, { color: decisionColor(update.decisionState ?? deriveDecision(item)), children: update.decisionState ?? deriveDecision(item) })] }), _jsxs(Text, { children: ["diff: ", _jsx(Text, { color: diffColor(update.diffType), children: update.diffType })] }), _jsxs(Text, { children: ["risk:", " ", _jsx(Text, { color: riskColor(update.riskLevel), children: update.riskLevel ?? "low" })] }), _jsxs(Text, { children: ["policy: ", update.policyAction ?? "allow"] }), _jsxs(Text, { children: ["workspace: ", update.workspaceGroup ?? "root"] }), _jsxs(Text, { children: ["group: ", update.groupKey ?? "none"] }), _jsxs(Text, { children: ["action:", " ", truncate(update.recommendedAction ?? "Safe to keep in the selected set.", 80)] })] }));
 }
 function buildVisibleRows(items, config) {
     const filtered = items
@@ -181,7 +289,11 @@ function buildVisibleRows(items, config) {
         .filter(({ item }) => matchesSearch(item, config.search))
         .sort((left, right) => compareItems(left.item, right.item, config.sort));
     if (config.group === "none") {
-        return filtered.map(({ item, index }) => ({ kind: "item", label: item.update.name, index }));
+        return filtered.map(({ item, index }) => ({
+            kind: "item",
+            label: item.update.name,
+            index,
+        }));
     }
     const rows = [];
     let currentGroup = "";
@@ -191,15 +303,20 @@ function buildVisibleRows(items, config) {
             currentGroup = nextGroup;
             rows.push({ kind: "group", label: nextGroup });
         }
-        rows.push({ kind: "item", label: entry.item.update.name, index: entry.index });
+        rows.push({
+            kind: "item",
+            label: entry.item.update.name,
+            index: entry.index,
+        });
     }
     return rows;
 }
 function matchesFilter(item, filter) {
     if (filter === "security")
         return item.advisories.length > 0;
-    if (filter === "risky")
+    if (filter === "risky") {
         return item.update.riskLevel === "critical" || item.update.riskLevel === "high";
+    }
     if (filter === "major")
         return item.update.diffType === "major";
     if (filter === "peer-conflict")
@@ -208,8 +325,9 @@ function matchesFilter(item, filter) {
         return item.update.licenseStatus === "denied";
     if (filter === "unused")
         return item.unusedIssues.length > 0;
-    if (filter === "blocked")
+    if (filter === "blocked") {
         return (item.update.decisionState ?? deriveDecision(item)) === "blocked";
+    }
     return true;
 }
 function matchesSearch(item, search) {
@@ -221,7 +339,7 @@ function matchesSearch(item, search) {
 }
 function compareItems(left, right, sort) {
     if (sort === "advisories") {
-        const byAdvisories = (right.advisories.length ?? 0) - (left.advisories.length ?? 0);
+        const byAdvisories = right.advisories.length - left.advisories.length;
         if (byAdvisories !== 0)
             return byAdvisories;
     }
@@ -256,8 +374,9 @@ function groupLabel(item, group) {
     }
     if (group === "risk")
         return item.update.riskLevel ?? "low";
-    if (group === "decision")
+    if (group === "decision") {
         return item.update.decisionState ?? deriveDecision(item);
+    }
     return "all";
 }
 function addVisible(selected, rows) {
@@ -275,7 +394,8 @@ function removeVisible(selected, rows) {
 function selectSafe(selected, rows, items) {
     const next = new Set(selected);
     for (const row of rows) {
-        if ((items[row.index]?.update.decisionState ?? deriveDecision(items[row.index])) === "safe") {
+        if ((items[row.index]?.update.decisionState ??
+            deriveDecision(items[row.index])) === "safe") {
             next.add(row.index);
         }
     }
@@ -284,14 +404,27 @@ function selectSafe(selected, rows, items) {
 function clearBlocked(selected, rows, items) {
     const next = new Set(selected);
     for (const row of rows) {
-        if ((items[row.index]?.update.decisionState ?? deriveDecision(items[row.index])) === "blocked") {
+        if ((items[row.index]?.update.decisionState ??
+            deriveDecision(items[row.index])) === "blocked") {
             next.delete(row.index);
         }
     }
     return next;
 }
+function selectActionable(selected, rows, items) {
+    const next = new Set(selected);
+    for (const row of rows) {
+        const decision = items[row.index]?.update.decisionState ??
+            deriveDecision(items[row.index]);
+        if (decision === "actionable" || decision === "review") {
+            next.add(row.index);
+        }
+    }
+    return next;
+}
 function deriveDecision(item) {
-    if (item.update.peerConflictSeverity === "error" || item.update.licenseStatus === "denied") {
+    if (item.update.peerConflictSeverity === "error" ||
+        item.update.licenseStatus === "denied") {
         return "blocked";
     }
     if ((item.update.advisoryCount ?? 0) > 0 || item.update.riskLevel === "critical") {
@@ -354,9 +487,76 @@ function decisionColor(label) {
             return "green";
     }
 }
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+function createDashboardLayout(stdoutWidth) {
+    const railWidth = clamp(Math.floor(stdoutWidth * 0.2), 24, 30);
+    const detailWidth = clamp(Math.floor(stdoutWidth * 0.26), 36, 54);
+    const queueWidth = Math.max(48, stdoutWidth - railWidth - detailWidth - 8);
+    return { railWidth, detailWidth, queueWidth };
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    if (maxLength <= 1)
+        return value.slice(0, maxLength);
+    return `${value.slice(0, Math.max(1, maxLength - 1))}…`;
+}
+function createRowPositionMap(rows) {
+    const map = new Map();
+    rows.forEach((row, position) => {
+        map.set(row.index, position);
+    });
+    return map;
+}
+function createRenderWindow(config) {
+    const maxRows = clamp(config.stdoutHeight - 16, 8, 18);
+    if (config.visibleRows.length <= maxRows) {
+        return {
+            rows: config.visibleRows,
+            start: 0,
+            end: config.visibleRows.length,
+        };
+    }
+    const focusedRow = Math.max(0, config.visibleRows.findIndex((row) => row.kind === "item" && row.index === config.focusedIndex));
+    let start = Math.max(0, focusedRow - Math.floor(maxRows / 2));
+    let end = Math.min(config.visibleRows.length, start + maxRows);
+    start = Math.max(0, end - maxRows);
+    return {
+        rows: config.visibleRows.slice(start, end),
+        start,
+        end,
+    };
+}
+function summarizeVisibleItems(rows, items, selected) {
+    let actionable = 0;
+    let blocked = 0;
+    let security = 0;
+    let selectedCount = 0;
+    for (const row of rows) {
+        const item = items[row.index];
+        const decision = item.update.decisionState ?? deriveDecision(item);
+        if (selected.has(row.index))
+            selectedCount += 1;
+        if (decision === "actionable" || decision === "review")
+            actionable += 1;
+        if (decision === "blocked")
+            blocked += 1;
+        if (item.advisories.length > 0)
+            security += 1;
+    }
+    return {
+        total: rows.length,
+        selected: selectedCount,
+        actionable,
+        blocked,
+        security,
+    };
+}
 export async function runTui(items, options) {
     return new Promise((resolve) => {
-        const { unmount } = render(_jsx(TuiApp, { items: items, title: options?.title, subtitle: options?.subtitle, onComplete: (selected) => {
+        const { unmount } = render(_jsx(TuiApp, { items: items, title: options?.title, subtitle: options?.subtitle, initialFilter: options?.initialFilter, initialTab: options?.initialTab, onComplete: (selected) => {
                 unmount();
                 resolve(selected);
             } }));

package/dist/utils/shell.d.ts

@@ -0,0 +1,6 @@
+export interface ShellInvocation {
+    shell: string;
+    args: string[];
+    display: string;
+}
+export declare function buildShellInvocation(command: string, runtimePlatform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): ShellInvocation;

package/dist/utils/shell.js

@@ -0,0 +1,18 @@
+export function buildShellInvocation(command, runtimePlatform = process.platform, env = process.env) {
+    if (runtimePlatform === "win32") {
+        const shell = env.COMSPEC?.trim() || "cmd.exe";
+        const args = ["/d", "/s", "/c", command];
+        return {
+            shell,
+            args,
+            display: [shell, ...args].join(" "),
+        };
+    }
+    const shell = env.SHELL?.trim() || "sh";
+    const args = ["-lc", command];
+    return {
+        shell,
+        args,
+        display: [shell, ...args].join(" "),
+    };
+}

package/dist/workspace/discover.d.ts

@@ -1 +1,7 @@
-export declare function discoverPackageDirs(cwd: string, workspaceMode: boolean): Promise<string[]>;
+import type { DependencyKind } from "../types/index.js";
+import { type GitScopeOptions } from "../git/scope.js";
+export declare function discoverPackageDirs(cwd: string, workspaceMode: boolean, options?: {
+    git?: GitScopeOptions;
+    includeKinds?: DependencyKind[];
+    includeDependents?: boolean;
+}): Promise<string[]>;