git-coco 0.56.0 → 0.57.0

package/dist/index.js

@@ -78,7 +78,7 @@ var readline__namespace = /*#__PURE__*/_interopNamespaceDefault(readline);
 /**
  * Current build version from package.json
  */
-const BUILD_VERSION = "0.56.0";
+const BUILD_VERSION = "0.57.0";
 
 const isInteractive = (config) => {
     return config?.mode === 'interactive' || !!config?.interactive;
@@ -2156,6 +2156,10 @@ const schema$1 = {
                 "selection": {
                     "type": "string"
                 },
+                "selectionForeground": {
+                    "type": "string",
+                    "description": "Foreground for text sitting on the `selection` background. Derived automatically from `selection` (black on light, white on dark) so the selected row stays readable regardless of the user's terminal default foreground — but can be overridden per theme via `options.colors`."
+                },
                 "success": {
                     "type": "string"
                 },
@@ -2199,7 +2203,25 @@ const schema$1 = {
                 "vitesse-dark",
                 "vesper",
                 "flexoki",
-                "mellow"
+                "mellow",
+                "night-owl",
+                "cobalt2",
+                "oceanic-next",
+                "catppuccin-macchiato",
+                "gruvbox-light",
+                "tokyo-night-day",
+                "one-light",
+                "ayu-light",
+                "rose-pine-dawn",
+                "everforest-light",
+                "vitesse-light",
+                "dayfox",
+                "night-owl-light",
+                "flexoki-light",
+                "material-lighter",
+                "papercolor-light",
+                "modus-operandi",
+                "quiet-light"
             ]
         }
     }
@@ -15229,10 +15251,19 @@ const CommitSplitPlanSchema = objectType({
         title: stringType().min(1),
         body: stringType().optional(),
         rationale: stringType().optional(),
-        files: arrayType(stringType()),
-        hunks: arrayType(stringType()),
+        // Both optional: the model legitimately emits a group with *either*
+        // `files` or `hunks` (a file-level vs hunk-level grouping), not always
+        // both. Requiring both made Zod throw "Required" and the whole split
+        // chain failed to parse before the refine could run. The refine below
+        // still enforces "at least one", and every downstream consumer already
+        // reads these as `group.files || []`. (Kept `.optional()` rather than
+        // `.default([])` so the schema's input and output types stay identical
+        // — `executeChainWithSchema` takes a `z.ZodSchema<T>`, which requires
+        // that.)
+        files: arrayType(stringType()).optional(),
+        hunks: arrayType(stringType()).optional(),
     })
-        .refine((group) => group.files.length > 0 || group.hunks.length > 0, {
+        .refine((group) => (group.files?.length ?? 0) > 0 || (group.hunks?.length ?? 0) > 0, {
         message: 'Each group must include at least one file or hunk',
     }))
         .min(1),
@@ -32197,6 +32228,10 @@ function renderBranchesSurface(h, components, state, context, contextStatus, bod
                 // row's dim and read as quiet chrome.
                 h(Text, { color: markerColor, dimColor: markerColor ? false : undefined }, marker.glyph), trailingName, h(Text, { dimColor: true }, timestampPadded), trailingDivergence);
             });
+    // Scroll indicators — same "N more above/below" pattern as the
+    // sidebar and help overlay so the user knows the list continues.
+    const branchesHasMoreAbove = startIndex > 0 && localBranches.length > 0;
+    const branchesHasMoreBelow = startIndex + listRows < localBranches.length;
     return h(Box, {
         borderColor: focusBorderColor(theme, focused),
         borderStyle: theme.borderStyle,
@@ -32204,7 +32239,11 @@ function renderBranchesSurface(h, components, state, context, contextStatus, bod
         flexShrink: 0,
         paddingX: 1,
         width,
-    }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Branches', focused)), h(Text, { dimColor: true }, headerRight)), ...renderPromotedFilterAffordance(h, Text, state, theme), ...lines);
+    }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Branches', focused)), h(Text, { dimColor: true }, headerRight)), ...renderPromotedFilterAffordance(h, Text, state, theme), ...(branchesHasMoreAbove
+        ? [h(Text, { key: 'branches-more-above', dimColor: true }, `  ↑ ${startIndex} more above`)]
+        : []), ...lines, ...(branchesHasMoreBelow
+        ? [h(Text, { key: 'branches-more-below', dimColor: true }, `  ↓ ${localBranches.length - (startIndex + listRows)} more below`)]
+        : []));
 }
 
 /**
@@ -32977,12 +33016,19 @@ function renderDiffSurface(h, components, state, context, contextStatus, worktre
                         // sees at a glance which file the cursor is inside.
                         const isActive = absoluteIndex === activeStartLine;
                         const arrow = theme.ascii ? '> ' : '▾ ';
+                        const activeHeader = isActive && focused && !theme.noColor;
                         return h(Text, {
                             key: `stash-diff-line-${absoluteIndex}`,
                             bold: true,
-                            color: theme.noColor ? undefined : theme.colors.accent,
-                            backgroundColor: isActive && focused && !theme.noColor ? theme.colors.selection : undefined,
-                            inverse: isActive && focused,
+                            // Active header sits on the selection bar with a
+                            // contrast-guaranteed foreground (matches history/status).
+                            // The old `inverse` swap turned the accent into the bar and
+                            // left the path in the selection color — low-contrast on
+                            // light themes (e.g. accent blue bar + light-gray text).
+                            color: activeHeader
+                                ? theme.colors.selectionForeground
+                                : (theme.noColor ? undefined : theme.colors.accent),
+                            backgroundColor: activeHeader ? theme.colors.selection : undefined,
                         }, (() => {
                             // Smart path truncation for the diff file header: keep
                             // the leading arrow glyph and elide middle path
@@ -34060,7 +34106,7 @@ function formatHistoryFetchArgs(args) {
  * Returns the spans flat so the caller can splat them into the row's
  * outer Text alongside other segments without an extra wrapper.
  */
-function renderTypedSubject(h, Text, text, theme, key) {
+function renderTypedSubject(h, Text, text, theme, key, suppressColor = false) {
     const parsed = parseConventionalCommitPrefix(text);
     if (!parsed) {
         return [h(Text, { key: `${key}-msg` }, text)];
@@ -34068,7 +34114,9 @@ function renderTypedSubject(h, Text, text, theme, key) {
     if (text.length < parsed.prefix.length) {
         return [h(Text, { key: `${key}-msg` }, text)];
     }
-    const color = getConventionalCommitColor(parsed, theme);
+    // When the row is selected (inverted), suppress the type color so
+    // text inherits the dark inverted foreground and stays readable.
+    const color = suppressColor ? undefined : getConventionalCommitColor(parsed, theme);
     return [
         h(Text, { key: `${key}-type`, color, bold: parsed.breaking }, parsed.prefix),
         h(Text, { key: `${key}-rest` }, text.slice(parsed.prefix.length)),
@@ -34089,15 +34137,10 @@ function renderLaneSegmentSpans(h, Text, segments, theme, padTo, keyPrefix, opti
     const elements = [];
     let totalLen = 0;
     segments.forEach((seg, idx) => {
-        const laneColor = getLaneColor(seg.laneId, theme);
+        const laneColor = options.suppressColor ? undefined : (getLaneColor(seg.laneId, theme) ?? muted);
         elements.push(h(Text, {
             key: `${keyPrefix}-${idx}`,
-            color: laneColor ?? muted,
-            // Ink does not cascade dimColor from a parent Text to children,
-            // so the caller's "this whole row should fade" intent has to
-            // travel here as an explicit flag (#831). Used for graph-only
-            // lane-closure rows, where the lane colors otherwise compete
-            // for attention with the commits they connect.
+            color: laneColor,
             dimColor: options.forceDim || (theme.noColor && seg.laneId === undefined),
         }, seg.text));
         totalLen += seg.text.length;
@@ -34148,18 +34191,26 @@ function renderCommitHistoryRow(h, Text, commit, graph, graphWidth, selected, th
     const messageRoom = Math.max(8, totalWidth - fixedWidth - cellWidth(refsTrunc));
     const message = truncateCells(commit.message, messageRoom);
     const selectedBg = selected && !theme.noColor ? theme.colors.selection : undefined;
-    const accent = theme.noColor ? undefined : theme.colors.accent;
-    const muted = theme.noColor ? undefined : theme.colors.muted;
+    // Don't use inverse — it makes child colors unreadable. Instead, set a
+    // background on the row AND an explicit, contrast-guaranteed foreground
+    // (`selectionForeground`, derived from the selection bg) on the outer
+    // span. Suppressing each child's own color to `undefined` then lets it
+    // inherit that readable foreground — so the whole selected row stays
+    // legible regardless of the user's terminal default foreground, which
+    // is what the old "rely on the default fg" approach got wrong.
+    const selectedFg = selected && !theme.noColor ? theme.colors.selectionForeground : undefined;
+    const accent = selected ? undefined : (theme.noColor ? undefined : theme.colors.accent);
+    const muted = selected ? undefined : (theme.noColor ? undefined : theme.colors.muted);
     // Lane-colored graph spans when full graph mode + non-ASCII rendering
     // is in play; otherwise fall back to the legacy single-muted span so
     // compact mode and legacy terminals stay visually unchanged.
     const graphChildren = laneSegments && !theme.ascii
-        ? renderLaneSegmentSpans(h, Text, laneSegments, theme, graphWidth, `c${index}`)
-        : [h(Text, { color: muted, dimColor: theme.noColor }, substituteGraphChars(graph.padEnd(graphWidth), { ascii: theme.ascii }))];
+        ? renderLaneSegmentSpans(h, Text, laneSegments, theme, graphWidth, `c${index}`, { suppressColor: selected })
+        : [h(Text, { color: muted, dimColor: !selected && theme.noColor }, substituteGraphChars(graph.padEnd(graphWidth), { ascii: theme.ascii }))];
     return h(Text, {
         key: `${commit.hash}-${index}`,
         backgroundColor: selectedBg,
-        inverse: selected,
+        color: selectedFg,
     }, ...graphChildren, ' ', 
     // "Just landed" marker — a single thick vertical bar in the
     // accent color before the short hash. Fades when the runtime
@@ -34181,11 +34232,11 @@ function renderCommitHistoryRow(h, Text, commit, graph, graphWidth, selected, th
     // Date column drops out entirely at `tight` density — no spacer
     // either, so the message column slides left into the freed cells.
     dateText
-        ? h(Text, { key: `${commit.hash}-${index}-date`, dimColor: true }, dateText, ' ')
+        ? h(Text, { key: `${commit.hash}-${index}-date`, dimColor: !selected }, dateText, ' ')
         : null, 
     // Branch chip prefix (full-graph mode only) lands right before the
     // message so the eye reads "branch · subject" as a unit.
-    chip.node, ...renderTypedSubject(h, Text, message, theme, `${commit.hash}-${index}-subj`), refsTrunc ? h(Text, { color: accent }, refsTrunc) : null);
+    chip.node, ...renderTypedSubject(h, Text, message, theme, `${commit.hash}-${index}-subj`, selected), refsTrunc ? h(Text, { color: accent }, refsTrunc) : null);
 }
 /**
  * Stacked variant used at `rowMode='stacked'` (rail tier). Each
@@ -34200,9 +34251,13 @@ function renderCommitHistoryRow(h, Text, commit, graph, graphWidth, selected, th
  */
 function renderStackedCommitHistoryRow(h, Text, Box, commit, graph, graphWidth, selected, theme, index, panelWidth, fullGraph, now, laneSegments, isRecent = false, remoteNames) {
     const totalWidth = Math.max(20, panelWidth - 4);
-    const accent = theme.noColor ? undefined : theme.colors.accent;
-    const muted = theme.noColor ? undefined : theme.colors.muted;
+    // Suppress child colors on selected rows so each span inherits the
+    // contrast-guaranteed `selectionForeground` set on the line-1 span,
+    // keeping the selected row readable against the selection bg.
+    const accent = selected ? undefined : (theme.noColor ? undefined : theme.colors.accent);
+    const muted = selected ? undefined : (theme.noColor ? undefined : theme.colors.muted);
     const selectedBg = selected && !theme.noColor ? theme.colors.selection : undefined;
+    const selectedFg = selected && !theme.noColor ? theme.colors.selectionForeground : undefined;
     // Line 1 — subject row. Mostly mirrors the single-line layout but
     // skips the date and refs so the message has the whole tail to
     // itself. Branch chip rides between the hash and the subject the
@@ -34214,15 +34269,15 @@ function renderStackedCommitHistoryRow(h, Text, Box, commit, graph, graphWidth,
     const lineOneFixed = graphWidth + 1 + commit.shortHash.length + 1 + recentMarkerWidth + chip.width;
     const subject = truncateCells(commit.message, Math.max(8, totalWidth - lineOneFixed));
     const graphChildren = laneSegments && !theme.ascii
-        ? renderLaneSegmentSpans(h, Text, laneSegments, theme, graphWidth, `cs${index}`)
-        : [h(Text, { color: muted, dimColor: theme.noColor }, substituteGraphChars(graph.padEnd(graphWidth), { ascii: theme.ascii }))];
+        ? renderLaneSegmentSpans(h, Text, laneSegments, theme, graphWidth, `cs${index}`, { suppressColor: selected })
+        : [h(Text, { color: muted, dimColor: !selected && theme.noColor }, substituteGraphChars(graph.padEnd(graphWidth), { ascii: theme.ascii }))];
     const lineOne = h(Text, {
         key: `${commit.hash}-${index}-l1`,
         backgroundColor: selectedBg,
-        inverse: selected,
+        color: selectedFg,
     }, ...graphChildren, ' ', isRecent
         ? h(Text, { color: accent, bold: true }, theme.ascii ? '* ' : '▎ ')
-        : null, h(Text, { color: accent, bold: selected || isRecent }, commit.shortHash), ' ', chip.node, ...renderTypedSubject(h, Text, subject, theme, `${commit.hash}-${index}-stk-subj`));
+        : null, h(Text, { color: accent, bold: selected || isRecent }, commit.shortHash), ' ', chip.node, ...renderTypedSubject(h, Text, subject, theme, `${commit.hash}-${index}-stk-subj`, selected));
     // Line 2 — metadata row, padded to align with the start of the
     // shortHash on line 1 so the eye still groups them as one commit.
     // Selection background does not extend here so we don't get a thick
@@ -34275,8 +34330,11 @@ function renderPendingCommitRow(h, Text, worktree, selected, theme) {
     return h(Text, {
         key: 'pending-commit-row',
         bold: true,
-        color: theme.noColor ? undefined : theme.colors.accent,
-        inverse: selected,
+        // On selection, swap to the contrast-guaranteed foreground so the
+        // accent label doesn't wash out against the selection bar.
+        color: selected && !theme.noColor
+            ? theme.colors.selectionForeground
+            : (theme.noColor ? undefined : theme.colors.accent),
         backgroundColor: selected && !theme.noColor ? theme.colors.selection : undefined,
     }, truncateCells(label, 140));
 }
@@ -34690,6 +34748,10 @@ function renderCommandPalette(h, components, state, width, theme, focused) {
                 dimColor: !isSelected,
             }, truncateCells(line, width - 4));
         });
+    // Scroll indicators for the palette list — same pattern as the
+    // sidebar and help overlay so the user knows there's more content.
+    const paletteHasMoreAbove = startIndex > 0 && filtered.length > 0;
+    const paletteHasMoreBelow = startIndex + listRows < filtered.length;
     return h(Box, {
         borderColor: focusBorderColor(theme, focused),
         borderStyle: theme.borderStyle,
@@ -34698,7 +34760,11 @@ function renderCommandPalette(h, components, state, width, theme, focused) {
         paddingX: 1,
     }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Command palette', focused)), h(Text, { dimColor: true }, matchSummary)), h(Text, { color: theme.colors.accent }, truncateCells(inputLine, width - 4)), h(Text, { dimColor: true }, truncateCells(hint, width - 4)), h(Text, undefined, ''), ...(showingRecent
         ? [h(Text, { key: 'palette-recent-hint', dimColor: true }, '· marks recently-used')]
-        : []), ...itemLines);
+        : []), ...(paletteHasMoreAbove
+        ? [h(Text, { key: 'palette-more-above', dimColor: true }, `  ↑ ${startIndex} more above`)]
+        : []), ...itemLines, ...(paletteHasMoreBelow
+        ? [h(Text, { key: 'palette-more-below', dimColor: true }, `  ↓ ${filtered.length - (startIndex + listRows)} more below`)]
+        : []));
 }
 /**
  * Split-plan overlay (#907) — renders the proposed commit groups for
@@ -35554,6 +35620,8 @@ function renderStashSurface(h, components, state, context, contextStatus, bodyRo
                     dimColor: !isSelected,
                 }, truncateCells(`${cursor} ${stash.ref.padEnd(12)} ${stash.message}`, 140));
             });
+    const stashHasMoreAbove = startIndex > 0 && stashes.length > 0;
+    const stashHasMoreBelow = startIndex + listRows < stashes.length;
     return h(Box, {
         borderColor: focusBorderColor(theme, focused),
         borderStyle: theme.borderStyle,
@@ -35561,7 +35629,11 @@ function renderStashSurface(h, components, state, context, contextStatus, bodyRo
         flexShrink: 0,
         paddingX: 1,
         width,
-    }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Stash', focused)), h(Text, { dimColor: true }, headerRight)), ...renderPromotedFilterAffordance(h, Text, state, theme), ...lines);
+    }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Stash', focused)), h(Text, { dimColor: true }, headerRight)), ...renderPromotedFilterAffordance(h, Text, state, theme), ...(stashHasMoreAbove
+        ? [h(Text, { key: 'stash-more-above', dimColor: true }, `  ↑ ${startIndex} more above`)]
+        : []), ...lines, ...(stashHasMoreBelow
+        ? [h(Text, { key: 'stash-more-below', dimColor: true }, `  ↓ ${stashes.length - (startIndex + listRows)} more below`)]
+        : []));
 }
 
 /**
@@ -35657,7 +35729,7 @@ function renderStatusSurface(h, components, state, context, contextStatus, bodyR
                     bold: true,
                     dimColor: !headerSelected && rowIndex > cursorRowIndex,
                     backgroundColor: headerSelected && !theme.noColor ? theme.colors.selection : undefined,
-                    inverse: headerSelected,
+                    color: headerSelected && !theme.noColor ? theme.colors.selectionForeground : undefined,
                 }, truncateCells(text, 140));
             }
             const isSelected = !headerFocused && row.flatIndex === selectedIndex;
@@ -35677,8 +35749,11 @@ function renderStatusSurface(h, components, state, context, contextStatus, bodyR
                 key: `status-file-${row.flatIndex}-${rowIndex}`,
                 dimColor: !isSelected && rowIndex > cursorRowIndex,
                 backgroundColor: isSelected && focused && !theme.noColor ? theme.colors.selection : undefined,
-                inverse: isSelected && focused,
-            }, `  ${cursorPart}`, ...(useDot ? [h(Text, { color: dotColor }, STAGE_STATUS_DOT), ' '] : []), tailTrunc);
+                color: isSelected && focused && !theme.noColor ? theme.colors.selectionForeground : undefined,
+            }, `  ${cursorPart}`, 
+            // Suppress the dot's own color on selected rows so it inherits the
+            // contrast-guaranteed selection foreground set on the row span.
+            ...(useDot ? [h(Text, { color: (isSelected && focused) ? undefined : dotColor }, STAGE_STATUS_DOT), ' '] : []), tailTrunc);
         });
     // When the mask narrows the list to nothing but the underlying repo
     // is non-clean, surface why the panel looks empty so the user can
@@ -35693,6 +35768,10 @@ function renderStatusSurface(h, components, state, context, contextStatus, bodyR
                 : cleanHint
                     ? [cleanHint]
                     : ['Worktree clean'];
+    // Scroll indicators for the status file list — same pattern as
+    // branches and the sidebar so the user knows there's more content.
+    const statusHasMoreAbove = windowStart > 0 && surfaceRows.length > 0;
+    const statusHasMoreBelow = windowStart + listRows < surfaceRows.length;
     return h(Box, {
         borderColor: focusBorderColor(theme, focused),
         borderStyle: theme.borderStyle,
@@ -35708,7 +35787,11 @@ function renderStatusSurface(h, components, state, context, contextStatus, bodyR
     // never touch the filter.
     ...(isStatusFilterMaskActive(state.statusFilterMask)
         ? [h(Text, { key: 'status-mask-indicator', dimColor: true }, `filter: ${formatStatusFilterMask(state.statusFilterMask)}  (1/2/3 to toggle)`)]
-        : []), ...renderedRows, ...fallbackLines.map((line, index) => h(Text, {
+        : []), ...(statusHasMoreAbove
+        ? [h(Text, { key: 'status-more-above', dimColor: true }, `  ↑ ${windowStart} more above`)]
+        : []), ...renderedRows, ...(statusHasMoreBelow
+        ? [h(Text, { key: 'status-more-below', dimColor: true }, `  ↓ ${surfaceRows.length - (windowStart + listRows)} more below`)]
+        : []), ...fallbackLines.map((line, index) => h(Text, {
         key: `status-surface-fallback-${index}`,
         dimColor: index > 0,
     }, truncateCells(line, 140))));
@@ -35938,6 +36021,8 @@ function renderTagsSurface(h, components, state, context, contextStatus, bodyRow
                     dimColor: !isSelected,
                 }, before, formatHyperlink(namePadded, url), after);
             });
+    const tagsHasMoreAbove = startIndex > 0 && tags.length > 0;
+    const tagsHasMoreBelow = startIndex + listRows < tags.length;
     return h(Box, {
         borderColor: focusBorderColor(theme, focused),
         borderStyle: theme.borderStyle,
@@ -35945,7 +36030,11 @@ function renderTagsSurface(h, components, state, context, contextStatus, bodyRow
         flexShrink: 0,
         paddingX: 1,
         width,
-    }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Tags', focused)), h(Text, { dimColor: true }, headerRight)), ...renderPromotedFilterAffordance(h, Text, state, theme), ...lines);
+    }, h(Box, { justifyContent: 'space-between' }, h(Text, { bold: true }, panelTitle('Tags', focused)), h(Text, { dimColor: true }, headerRight)), ...renderPromotedFilterAffordance(h, Text, state, theme), ...(tagsHasMoreAbove
+        ? [h(Text, { key: 'tags-more-above', dimColor: true }, `  ↑ ${startIndex} more above`)]
+        : []), ...lines, ...(tagsHasMoreBelow
+        ? [h(Text, { key: 'tags-more-below', dimColor: true }, `  ↓ ${tags.length - (startIndex + listRows)} more below`)]
+        : []));
 }
 
 /**
@@ -36464,12 +36553,17 @@ function renderInspectorActionsSection(h, Text, context, width, theme, options =
         h(Text, { key: 'actions-title' }, cursorActive ? '[Actions]' : 'Actions:'),
         ...actions.map((action, index) => {
             const isSelected = cursorActive && index === cursorIndex;
+            // On the selected row, swap every span to the contrast-guaranteed
+            // selection foreground so the key glyph / destructive marker don't
+            // wash out against the selection bar; the row is already highlighted,
+            // and the label text still conveys which actions are destructive.
+            const selectedFg = isSelected && !theme.noColor ? theme.colors.selectionForeground : undefined;
             const keyCell = action.key.padEnd(KEY_COLUMN);
             const label = truncateCells(action.label, labelBudget);
             const children = [
                 h(Text, {
                     key: `actions-${index}-key`,
-                    color: action.destructive ? theme.colors.danger : theme.colors.accent,
+                    color: selectedFg ?? (action.destructive ? theme.colors.danger : theme.colors.accent),
                 }, keyCell),
                 GAP,
                 label,
@@ -36477,14 +36571,14 @@ function renderInspectorActionsSection(h, Text, context, width, theme, options =
             if (action.destructive) {
                 children.push(h(Text, {
                     key: `actions-${index}-mark`,
-                    color: theme.colors.danger,
+                    color: selectedFg ?? theme.colors.danger,
                     dimColor: false,
                 }, DESTRUCTIVE_SUFFIX));
             }
             return h(Text, {
                 key: `actions-${index}`,
                 backgroundColor: isSelected && !theme.noColor ? theme.colors.selection : undefined,
-                inverse: isSelected,
+                color: selectedFg,
             }, ...children);
         }),
     ];
@@ -36561,7 +36655,6 @@ function renderCommitFileList(h, Text, files, selectedIndex, focused, maxRows, w
         return h(Text, {
             key: `commit-file-${index}`,
             color: statusCodeColor(file.status, theme),
-            inverse: isSelected && focused && !theme.noColor,
             bold: isSelected,
         }, label);
     });
@@ -41153,8 +41246,9 @@ function LogInkApp(deps) {
                     if (group.rationale)
                         lines += 2;
                     lines += (group.files?.length || 0) + 1;
-                    if ((group.hunks?.length || 0) > 0)
-                        lines += group.hunks.length + 1;
+                    const hunkCount = group.hunks?.length || 0;
+                    if (hunkCount > 0)
+                        lines += hunkCount + 1;
                     return sum + lines;
                 }, 0)
                 : undefined,
@@ -41319,7 +41413,7 @@ function getColorLevel(env = process.env) {
         return '256';
     return '16';
 }
-const TRUECOLOR_PRESETS = new Set(['catppuccin', 'gruvbox', 'dracula', 'nord', 'solarized-dark', 'tokyo-night', 'one-dark', 'rose-pine', 'kanagawa', 'everforest', 'monokai', 'synthwave', 'ayu-dark', 'palenight', 'github-dark', 'horizon', 'nightfox', 'carbonfox', 'tokyonight-storm', 'catppuccin-latte', 'solarized-light', 'github-light', 'iceberg', 'material-ocean', 'moonlight', 'poimandres', 'vitesse-dark', 'vesper', 'flexoki', 'mellow']);
+const TRUECOLOR_PRESETS = new Set(['catppuccin', 'gruvbox', 'dracula', 'nord', 'solarized-dark', 'tokyo-night', 'one-dark', 'rose-pine', 'kanagawa', 'everforest', 'monokai', 'synthwave', 'ayu-dark', 'palenight', 'github-dark', 'horizon', 'nightfox', 'carbonfox', 'tokyonight-storm', 'catppuccin-latte', 'solarized-light', 'github-light', 'iceberg', 'material-ocean', 'moonlight', 'poimandres', 'vitesse-dark', 'vesper', 'flexoki', 'mellow', 'night-owl', 'cobalt2', 'oceanic-next', 'catppuccin-macchiato', 'gruvbox-light', 'tokyo-night-day', 'one-light', 'ayu-light', 'rose-pine-dawn', 'everforest-light', 'vitesse-light', 'dayfox', 'night-owl-light', 'flexoki-light', 'material-lighter', 'papercolor-light', 'modus-operandi', 'quiet-light']);
 /**
  * `true` when the named preset relies on hex colors that look best under
  * 24-bit RGB. Used by `createLogInkTheme` to decide whether to downgrade
@@ -41328,6 +41422,45 @@ const TRUECOLOR_PRESETS = new Set(['catppuccin', 'gruvbox', 'dracula', 'nord', '
 function presetUsesTrueColor(preset) {
     return preset !== undefined && TRUECOLOR_PRESETS.has(preset);
 }
+/**
+ * WCAG 2.x relative luminance of a `#rrggbb` color, 0 (black) … 1 (white).
+ * Returns `null` for anything that isn't a 6-digit hex (e.g. ANSI-named
+ * colors), so callers can fall back rather than guess.
+ */
+function relativeLuminance(hex) {
+    const match = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+    if (!match)
+        return null;
+    const int = parseInt(match[1], 16);
+    const channel = (c) => {
+        const x = c / 255;
+        return x <= 0.03928 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
+    };
+    const r = channel((int >> 16) & 0xff);
+    const g = channel((int >> 8) & 0xff);
+    const b = channel(int & 0xff);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+/**
+ * Pick a foreground guaranteed to stay readable on `bg` — black for light
+ * backgrounds, white for dark ones. The 0.179 threshold is the luminance
+ * crossover where black and white yield identical contrast, so the choice
+ * always maximizes it; every background clears WCAG AA (≥ 4.5:1).
+ *
+ * This is how the selected-row text stays legible across every theme:
+ * coco controls the selection *background* but not the user's terminal
+ * default foreground, so it must supply its own contrasting foreground
+ * instead of hoping the terminal's happens to contrast. Returns
+ * `undefined` for non-hex backgrounds (let the caller leave color alone).
+ */
+function readableForegroundFor(bg) {
+    if (!bg)
+        return undefined;
+    const luminance = relativeLuminance(bg);
+    if (luminance === null)
+        return undefined;
+    return luminance > 0.179 ? '#000000' : '#ffffff';
+}
 
 const THEME_PRESET_COLORS = {
     default: {
@@ -41340,7 +41473,7 @@ const THEME_PRESET_COLORS = {
         gitModified: 'yellow',
         info: 'blue',
         muted: 'gray',
-        selection: 'cyan',
+        selection: '#1a3a4a',
         success: 'green',
         warning: 'yellow',
     },
@@ -41764,6 +41897,258 @@ const THEME_PRESET_COLORS = {
         success: '#a3d4a0',
         warning: '#f0c674',
     },
+    'night-owl': {
+        accent: '#82aaff',
+        border: '#1d3b53',
+        danger: '#ef5350',
+        focusBorder: '#7fdbca',
+        gitAdded: '#addb67',
+        gitDeleted: '#ef5350',
+        gitModified: '#ecc48d',
+        info: '#82aaff',
+        muted: '#637777',
+        selection: '#1d3b53',
+        success: '#addb67',
+        warning: '#ecc48d',
+    },
+    cobalt2: {
+        accent: '#ffc600',
+        border: '#234e6d',
+        danger: '#ff628c',
+        focusBorder: '#9effff',
+        gitAdded: '#3ad900',
+        gitDeleted: '#ff628c',
+        gitModified: '#ffc600',
+        info: '#9effff',
+        muted: '#627e99',
+        selection: '#0d3a58',
+        success: '#3ad900',
+        warning: '#ffc600',
+    },
+    'oceanic-next': {
+        accent: '#6699cc',
+        border: '#343d46',
+        danger: '#ec5f67',
+        focusBorder: '#5fb3b3',
+        gitAdded: '#99c794',
+        gitDeleted: '#ec5f67',
+        gitModified: '#fac863',
+        info: '#6699cc',
+        muted: '#65737e',
+        selection: '#4f5b66',
+        success: '#99c794',
+        warning: '#fac863',
+    },
+    'catppuccin-macchiato': {
+        accent: '#8aadf4',
+        border: '#494d64',
+        danger: '#ed8796',
+        focusBorder: '#91d7e3',
+        gitAdded: '#a6da95',
+        gitDeleted: '#ed8796',
+        gitModified: '#eed49f',
+        info: '#8aadf4',
+        muted: '#6e738d',
+        selection: '#363a4f',
+        success: '#a6da95',
+        warning: '#eed49f',
+    },
+    'gruvbox-light': {
+        accent: '#076678',
+        border: '#bdae93',
+        danger: '#9d0006',
+        focusBorder: '#427b58',
+        gitAdded: '#79740e',
+        gitDeleted: '#9d0006',
+        gitModified: '#b57614',
+        info: '#076678',
+        muted: '#7c6f64',
+        selection: '#ebdbb2',
+        success: '#79740e',
+        warning: '#b57614',
+    },
+    'tokyo-night-day': {
+        accent: '#2e7de9',
+        border: '#b7c1e3',
+        danger: '#f52a65',
+        focusBorder: '#007197',
+        gitAdded: '#587539',
+        gitDeleted: '#f52a65',
+        gitModified: '#8c6c3e',
+        info: '#2e7de9',
+        muted: '#848cb5',
+        selection: '#b7c1e3',
+        success: '#587539',
+        warning: '#8c6c3e',
+    },
+    'one-light': {
+        accent: '#4078f2',
+        border: '#d4d4d4',
+        danger: '#e45649',
+        focusBorder: '#0184bc',
+        gitAdded: '#50a14f',
+        gitDeleted: '#e45649',
+        gitModified: '#c18401',
+        info: '#4078f2',
+        muted: '#a0a1a7',
+        selection: '#e5e5e6',
+        success: '#50a14f',
+        warning: '#c18401',
+    },
+    'ayu-light': {
+        accent: '#fa8d3e',
+        border: '#e6e6e6',
+        danger: '#e65050',
+        focusBorder: '#4cbf99',
+        gitAdded: '#6cbf43',
+        gitDeleted: '#e65050',
+        gitModified: '#f2ae49',
+        info: '#399ee6',
+        muted: '#abb0b6',
+        selection: '#d1e4f4',
+        success: '#6cbf43',
+        warning: '#f2ae49',
+    },
+    'rose-pine-dawn': {
+        accent: '#907aa9',
+        border: '#dfdad9',
+        danger: '#b4637a',
+        focusBorder: '#56949f',
+        gitAdded: '#286983',
+        gitDeleted: '#b4637a',
+        gitModified: '#ea9d34',
+        info: '#56949f',
+        muted: '#9893a5',
+        selection: '#dfdad9',
+        success: '#286983',
+        warning: '#ea9d34',
+    },
+    'everforest-light': {
+        accent: '#8da101',
+        border: '#ddd8be',
+        danger: '#f85552',
+        focusBorder: '#35a77c',
+        gitAdded: '#8da101',
+        gitDeleted: '#f85552',
+        gitModified: '#dfa000',
+        info: '#3a94c5',
+        muted: '#939f91',
+        selection: '#edeada',
+        success: '#8da101',
+        warning: '#dfa000',
+    },
+    'vitesse-light': {
+        accent: '#1e754f',
+        border: '#e0e0e0',
+        danger: '#ab5959',
+        focusBorder: '#2993a3',
+        gitAdded: '#1e754f',
+        gitDeleted: '#ab5959',
+        gitModified: '#b07d48',
+        info: '#296aa3',
+        muted: '#999fa6',
+        selection: '#eaeaeb',
+        success: '#1e754f',
+        warning: '#b07d48',
+    },
+    dayfox: {
+        accent: '#2848a9',
+        border: '#e4dcd4',
+        danger: '#a5222f',
+        focusBorder: '#287980',
+        gitAdded: '#396847',
+        gitDeleted: '#a5222f',
+        gitModified: '#ac5402',
+        info: '#2848a9',
+        muted: '#908479',
+        selection: '#e7d2be',
+        success: '#396847',
+        warning: '#ac5402',
+    },
+    'night-owl-light': {
+        accent: '#288ed7',
+        border: '#d9d9d9',
+        danger: '#d3423e',
+        focusBorder: '#2aa298',
+        gitAdded: '#08916a',
+        gitDeleted: '#d3423e',
+        gitModified: '#daaa01',
+        info: '#288ed7',
+        muted: '#989fb1',
+        selection: '#e4e8f0',
+        success: '#08916a',
+        warning: '#daaa01',
+    },
+    'flexoki-light': {
+        accent: '#205ea6',
+        border: '#cecdc3',
+        danger: '#af3029',
+        focusBorder: '#24837b',
+        gitAdded: '#66800b',
+        gitDeleted: '#af3029',
+        gitModified: '#ad8301',
+        info: '#205ea6',
+        muted: '#6f6e69',
+        selection: '#e6e4d9',
+        success: '#66800b',
+        warning: '#ad8301',
+    },
+    'material-lighter': {
+        accent: '#39adb5',
+        border: '#e7eaec',
+        danger: '#e53935',
+        focusBorder: '#39adb5',
+        gitAdded: '#91b859',
+        gitDeleted: '#e53935',
+        gitModified: '#f6a434',
+        info: '#6182b8',
+        muted: '#90a4ae',
+        selection: '#d3e1e8',
+        success: '#91b859',
+        warning: '#f6a434',
+    },
+    'papercolor-light': {
+        accent: '#0087af',
+        border: '#d7d7d7',
+        danger: '#af0000',
+        focusBorder: '#005f87',
+        gitAdded: '#008700',
+        gitDeleted: '#af0000',
+        gitModified: '#d75f00',
+        info: '#0087af',
+        muted: '#878787',
+        selection: '#d0d0d0',
+        success: '#008700',
+        warning: '#d75f00',
+    },
+    'modus-operandi': {
+        accent: '#0031a9',
+        border: '#d7d7d7',
+        danger: '#a60000',
+        focusBorder: '#005e8b',
+        gitAdded: '#006800',
+        gitDeleted: '#a60000',
+        gitModified: '#6f5500',
+        info: '#0031a9',
+        muted: '#595959',
+        selection: '#c0deff',
+        success: '#006800',
+        warning: '#6f5500',
+    },
+    'quiet-light': {
+        accent: '#4b83cd',
+        border: '#e0e0e0',
+        danger: '#aa3731',
+        focusBorder: '#4b83cd',
+        gitAdded: '#448c27',
+        gitDeleted: '#aa3731',
+        gitModified: '#a67d00',
+        info: '#4b83cd',
+        muted: '#a3a6ad',
+        selection: '#c9d0d9',
+        success: '#448c27',
+        warning: '#a67d00',
+    },
 };
 function shouldUseAscii(term) {
     if (!term) {
@@ -41788,8 +42173,28 @@ function createLogInkTheme(options = {}) {
         ? {}
         : {
             ...THEME_PRESET_COLORS[preset],
+            // Preserve the requested theme's selection background even when the
+            // rest of the palette downgrades to `default`. The selection is a
+            // single background color the terminal can approximate; without this,
+            // a light theme inherits `default`'s dark selection (#1a3a4a) and the
+            // selected row renders as a dark bar on a light background.
+            ...(preset !== requestedPreset && THEME_PRESET_COLORS[requestedPreset]?.selection
+                ? { selection: THEME_PRESET_COLORS[requestedPreset].selection }
+                : {}),
             ...options.colors,
         };
+    // Derive a contrasting foreground for the selected row from its own
+    // selection background, unless the caller supplied one explicitly. coco
+    // owns the selection background but not the terminal's default foreground,
+    // so without this the selected row's text falls back to whatever the
+    // user's terminal foreground is — which may not contrast with the bar at
+    // all (the bug behind unreadable selected rows on many themes).
+    if (!noColor && colors.selection && !colors.selectionForeground) {
+        const selectionForeground = readableForegroundFor(colors.selection);
+        if (selectionForeground) {
+            colors.selectionForeground = selectionForeground;
+        }
+    }
     return {
         noColor,
         ascii,
@@ -43418,7 +43823,7 @@ const options$1 = {
     },
     theme: {
         description: 'TUI theme preset',
-        choices: ['default', 'monochrome', 'catppuccin', 'gruvbox', 'dracula', 'nord', 'solarized-dark', 'tokyo-night', 'one-dark', 'rose-pine', 'kanagawa', 'everforest', 'monokai', 'synthwave', 'ayu-dark', 'palenight', 'github-dark', 'horizon', 'nightfox', 'carbonfox', 'tokyonight-storm', 'catppuccin-latte', 'solarized-light', 'github-light', 'iceberg', 'material-ocean', 'moonlight', 'poimandres', 'vitesse-dark', 'vesper', 'flexoki', 'mellow'],
+        choices: ['default', 'monochrome', 'catppuccin', 'gruvbox', 'dracula', 'nord', 'solarized-dark', 'tokyo-night', 'one-dark', 'rose-pine', 'kanagawa', 'everforest', 'monokai', 'synthwave', 'ayu-dark', 'palenight', 'github-dark', 'horizon', 'nightfox', 'carbonfox', 'tokyonight-storm', 'catppuccin-latte', 'solarized-light', 'github-light', 'iceberg', 'material-ocean', 'moonlight', 'poimandres', 'vitesse-dark', 'vesper', 'flexoki', 'mellow', 'night-owl', 'cobalt2', 'oceanic-next', 'catppuccin-macchiato', 'gruvbox-light', 'tokyo-night-day', 'one-light', 'ayu-light', 'rose-pine-dawn', 'everforest-light', 'vitesse-light', 'dayfox', 'night-owl-light', 'flexoki-light', 'material-lighter', 'papercolor-light', 'modus-operandi', 'quiet-light'],
     },
 };
 const builder$1 = (yargs) => {
@@ -43446,7 +43851,7 @@ const options = {
     },
     theme: {
         description: 'TUI theme preset',
-        choices: ['default', 'monochrome', 'catppuccin', 'gruvbox', 'dracula', 'nord', 'solarized-dark', 'tokyo-night', 'one-dark', 'rose-pine', 'kanagawa', 'everforest', 'monokai', 'synthwave', 'ayu-dark', 'palenight', 'github-dark', 'horizon', 'nightfox', 'carbonfox', 'tokyonight-storm', 'catppuccin-latte', 'solarized-light', 'github-light', 'iceberg', 'material-ocean', 'moonlight', 'poimandres', 'vitesse-dark', 'vesper', 'flexoki', 'mellow'],
+        choices: ['default', 'monochrome', 'catppuccin', 'gruvbox', 'dracula', 'nord', 'solarized-dark', 'tokyo-night', 'one-dark', 'rose-pine', 'kanagawa', 'everforest', 'monokai', 'synthwave', 'ayu-dark', 'palenight', 'github-dark', 'horizon', 'nightfox', 'carbonfox', 'tokyonight-storm', 'catppuccin-latte', 'solarized-light', 'github-light', 'iceberg', 'material-ocean', 'moonlight', 'poimandres', 'vitesse-dark', 'vesper', 'flexoki', 'mellow', 'night-owl', 'cobalt2', 'oceanic-next', 'catppuccin-macchiato', 'gruvbox-light', 'tokyo-night-day', 'one-light', 'ayu-light', 'rose-pine-dawn', 'everforest-light', 'vitesse-light', 'dayfox', 'night-owl-light', 'flexoki-light', 'material-lighter', 'papercolor-light', 'modus-operandi', 'quiet-light'],
     },
 };
 const builder = (yargs) => {
@@ -44730,33 +45135,48 @@ function buildWorkspaceHeaderChips(state, options = { focusLabel: 'List' }) {
     });
     return chips;
 }
-// Footer hints prioritize discoverable / forgettable actions and
-// drop the bindings users can find on their own (arrow keys, Enter
-// for "open", Tab for "switch panels"). The full keymap lives behind
-// `?` so nothing is hidden, just decluttered.
-const LIST_HINT = 's sort · / filter · r/R refresh · a add · d remove · ? help · q quit';
-const SIDEBAR_HINT = '? help · q quit';
-const FILTER_HINT = 'type to filter · enter apply · esc cancel';
-const ADD_REPO_HINT = 'type path · tab to complete · enter to add · esc to cancel';
-const CONFIRM_DELETE_HINT = 'press y to remove · any other key to cancel';
-function hintFor(focus) {
+// Footer hints are split into two slots — same pattern as `coco ui`:
+//   - contextual : per-mode actions (sort, filter, refresh, add/remove)
+//   - global     : always-on essentials (help, quit) — never crowded out
+//
+// The contextual slot drops bindings users can find via the help
+// overlay (arrow keys, tab); the global slot is the safety net so
+// `? help` and `q quit` never disappear.
+const LIST_CONTEXTUAL = ['s sort', '/ filter', 'r/R refresh', 'a add', 'd remove'];
+const SIDEBAR_CONTEXTUAL = ['↑/↓ cycle tab', 'enter open'];
+const FILTER_CONTEXTUAL = ['type to filter', 'enter apply', 'esc cancel'];
+const ADD_REPO_CONTEXTUAL = ['type path', 'tab to complete', 'enter to add', 'esc to cancel'];
+const CONFIRM_DELETE_CONTEXTUAL = ['y confirm', 'any other key cancels'];
+const GLOBAL_HINTS = ['? help', 'q quit'];
+function contextualHintsFor(focus) {
     switch (focus) {
         case 'sidebar':
-            return SIDEBAR_HINT;
+            return SIDEBAR_CONTEXTUAL;
         case 'filter':
-            return FILTER_HINT;
+            return FILTER_CONTEXTUAL;
         case 'add-repo':
-            return ADD_REPO_HINT;
+            return ADD_REPO_CONTEXTUAL;
         case 'confirm-delete':
-            return CONFIRM_DELETE_HINT;
+            return CONFIRM_DELETE_CONTEXTUAL;
         case 'list':
         default:
-            return LIST_HINT;
+            return LIST_CONTEXTUAL;
     }
 }
 function buildWorkspaceFooter(state) {
+    const contextual = contextualHintsFor(state.focus);
+    // Modal modes (filter / add-repo / confirm-delete) suppress the
+    // global hints — those bindings are not reachable while a prompt
+    // is open and showing them would be misleading.
+    const isModal = state.focus === 'filter' ||
+        state.focus === 'add-repo' ||
+        state.focus === 'confirm-delete';
+    const global = isModal ? [] : GLOBAL_HINTS;
+    const allHints = [...contextual, ...global];
     return {
-        hint: hintFor(state.focus),
+        hint: allHints.join(' · '),
+        contextual,
+        global,
         status: state.status,
         filterMode: state.focus === 'filter',
     };
@@ -44766,11 +45186,25 @@ function buildWorkspaceFooter(state) {
  * sections so users can scan by intent ("how do I navigate?" "how
  * do I act?") rather than reading a flat alphabetized list.
  *
+ * Section order mirrors `coco ui`'s help convention — Essentials
+ * first so newcomers see `?`/`esc`/`q` immediately, then move outward
+ * to navigation, modification, and the destructive verbs last.
+ *
  * The view layer composes these into a panel with section titles,
  * a leading app/title bar, and a closing hint at the bottom.
  */
 function buildWorkspaceHelpSections() {
     return [
+        {
+            title: 'Essentials',
+            subtitle: 'The keys you reach for most often.',
+            rows: [
+                { glyph: '?', keys: '?', description: 'Toggle this help overlay' },
+                { glyph: '⎋', keys: 'esc', description: 'Clear filter / close overlay / cancel prompt' },
+                { glyph: '◴', keys: 'q · ctrl+c', description: 'Quit the workspace surface' },
+                { glyph: '↵', keys: 'enter', description: 'Drill into the cursored repo (coco ui)' },
+            ],
+        },
         {
             title: 'Navigate',
             subtitle: 'Move the cursor and switch focus between panels.',
@@ -44780,7 +45214,6 @@ function buildWorkspaceHelpSections() {
                 { glyph: '←', keys: 'h', description: 'Jump focus to the sidebar' },
                 { glyph: '→', keys: 'l', description: 'Jump focus to the list' },
                 { glyph: '⤒', keys: 'g / G', description: 'Jump to top / bottom of the list' },
-                { glyph: '↵', keys: 'enter', description: 'Drill into the cursored repo (coco ui)' },
             ],
         },
         {
@@ -44800,14 +45233,6 @@ function buildWorkspaceHelpSections() {
                 { glyph: '✕', keys: 'd', description: 'Remove the cursored repo from the known-repos store' },
             ],
         },
-        {
-            title: 'General',
-            rows: [
-                { glyph: '?', keys: '?', description: 'Toggle this help overlay' },
-                { glyph: '⎋', keys: 'esc', description: 'Clear filter / close overlay / cancel prompt' },
-                { glyph: '◴', keys: 'q · ctrl+c', description: 'Quit the workspace surface' },
-            ],
-        },
     ];
 }
 function buildWorkspaceOnboarding(state) {
@@ -45254,13 +45679,19 @@ function renderFooter(deps) {
     // height shifted by a row every time a status banner came and went,
     // forcing the panel chrome to reflow.
     const statusContent = model.status ?? '';
+    const contextualText = model.contextual.join('   ');
+    const globalText = model.global.join(' · ');
     return React.createElement(Box, {
         borderColor: focusBorderColor(theme, false),
         borderStyle: theme.borderStyle,
         paddingX: 1,
         flexDirection: 'column',
         height: FOOTER_HEIGHT,
-    }, React.createElement(Text, { dimColor: true }, model.hint), React.createElement(Text, {
+    }, 
+    // Row 1: contextual ↔ global hints. justifyContent pushes them
+    // to opposite edges so the eye scans each cluster as one block —
+    // same shape as `coco ui`'s footer post-0.54.2 redesign.
+    React.createElement(Box, { flexDirection: 'row', justifyContent: 'space-between' }, React.createElement(Text, { dimColor: true }, contextualText), React.createElement(Text, { dimColor: true }, globalText)), React.createElement(Text, {
         color: model.status ? toneColor('warn', theme) : undefined,
         dimColor: !model.status,
     }, statusContent || ' '));
@@ -46563,6 +46994,148 @@ var workspace = {
     options,
 };
 
+/**
+ * Default-command router for `coco` invoked with no positional
+ * arguments. Decides where to send the user based on the state of
+ * their machine:
+ *
+ *   ┌─────────────────────────┬─────────────────────┬──────────────┐
+ *   │ Config present?         │ In a git repo?      │ Action       │
+ *   ├─────────────────────────┼─────────────────────┼──────────────┤
+ *   │ No (default-only)       │ —                   │ run `init`   │
+ *   │ Yes                     │ Yes (worktree)      │ run `ui`     │
+ *   │ Yes                     │ No                  │ run `ws`     │
+ *   └─────────────────────────┴─────────────────────┴──────────────┘
+ *
+ * The pre-existing default — fall through to `commit` — was hostile
+ * to first-time users: a fresh install with no config landed
+ * straight in the API-key error path, with no hint that `coco init`
+ * was the right next step. Routing fresh installs to `init` and
+ * configured users to the workstation/UI matches what every other
+ * git-aware CLI does (lazygit, tig, gitui all open their TUI on bare
+ * invocation).
+ *
+ * `coco commit` keeps its dedicated subcommand entry so existing
+ * scripts (`git aliases`, hook integrations, CI jobs) that call
+ * `coco commit` continue to work unchanged.
+ *
+ * The router is a thin shim — it forwards to the existing handlers
+ * via their public exports rather than re-implementing the logic.
+ */
+/**
+ * Pure decision function — given probed signals (whether config
+ * exists, whether the current directory is a git repo, whether the
+ * user opted into legacy commit-by-default), decides which command
+ * to invoke. Kept pure so unit tests can cover every quadrant of
+ * the router table without spawning processes.
+ *
+ * "Config exists" is defined as: the loader detected at least one
+ * source beyond `default` — i.e., the user has either a project
+ * config, a git config `[coco]` section, an env var, or an XDG
+ * config. A pure-defaults run is treated as "never been configured"
+ * because `coco init` is the only way to populate any of those
+ * sources.
+ */
+function decideDefaultRoute(input) {
+    if (input.envOverride === 'commit' || input.explicitCommit) {
+        return {
+            kind: 'commit',
+            reason: input.envOverride === 'commit' ? 'env-override' : 'explicit-flag',
+        };
+    }
+    if (!input.hasConfigSource) {
+        return { kind: 'init', reason: 'no-config' };
+    }
+    if (input.isGitRepo) {
+        return { kind: 'ui', reason: 'config-and-repo' };
+    }
+    return { kind: 'workspace', reason: 'config-no-repo' };
+}
+/**
+ * Probe whether the cwd (after `--repo` is honored) is inside a git
+ * worktree. Tolerant of every error class — a thrown simple-git
+ * call should never block the router; it should fall back to
+ * "not a repo" so the user lands somewhere sensible (workspace
+ * surface) rather than crashing on an empty machine.
+ */
+async function probeIsGitRepo() {
+    try {
+        // Lazy-import simple-git so the cold-start path stays fast for
+        // users running `coco --help` / `coco doctor` etc.
+        const { default: simpleGit } = await import('simple-git');
+        const git = simpleGit();
+        return await git.checkIsRepo();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build a synthetic argv for one of the targeted handlers. Each
+ * handler reads its own typed argv contract (`CommitArgv`,
+ * `InitArgv`, `UiArgv`, `WorkspaceArgv`) so we can't just spread the
+ * raw default argv — we have to project the shared fields and let
+ * the handler fill in command-specific defaults.
+ */
+function buildSyntheticArgv(argv) {
+    return {
+        _: ['$0'],
+        $0: argv.$0,
+        repo: argv.repo,
+        cwd: argv.cwd,
+        verbose: argv.verbose ?? false,
+        interactive: true,
+        version: false,
+        help: false,
+    };
+}
+/**
+ * Default-command handler installed under yargs's `$0` slot. Probes
+ * the environment, computes the right route, and forwards to the
+ * matching command handler. Falls through to commit if any
+ * unexpected error blocks routing — preserves backwards-compat
+ * for users on weird setups while still giving newcomers the
+ * onboarding path they deserve.
+ */
+const defaultRouteHandler = async (argv, logger) => {
+    // The `--repo` flag has to land before any probe runs — otherwise
+    // we'd sniff the launcher's cwd instead of the targeted repo.
+    applyRepoCwd(argv);
+    // Trigger a config load so `getConfigSources()` returns the active
+    // source list. We discard the config object — the decision only
+    // cares about which sources contributed.
+    void loadConfig(argv);
+    const sources = getConfigSources();
+    const hasConfigSource = sources.some((source) => source.source !== 'default');
+    const isGitRepo = await probeIsGitRepo();
+    const decision = decideDefaultRoute({
+        hasConfigSource,
+        isGitRepo,
+        explicitCommit: Boolean(argv.commit),
+        envOverride: process.env.COCO_DEFAULT,
+    });
+    switch (decision.kind) {
+        case 'init':
+            // Friendly hint before the wizard kicks in — sets expectations
+            // that the user is being walked through setup, not silently
+            // routed to a different command.
+            logger.log('No coco config detected — running `coco init` to set up your provider + key.', { color: 'cyan' });
+            logger.log('');
+            await handler$7(buildSyntheticArgv(argv), logger);
+            return;
+        case 'ui':
+            await handler$5(buildSyntheticArgv(argv));
+            return;
+        case 'workspace':
+            await handler(buildSyntheticArgv(argv));
+            return;
+        case 'commit':
+        default:
+            await handler$9(buildSyntheticArgv(argv), logger);
+            return;
+    }
+};
+
 var types = /*#__PURE__*/Object.freeze({
   __proto__: null
 });
@@ -46581,7 +47154,37 @@ y.option('repo', {
     description: 'Target a specific repository directory instead of the current working directory.',
     global: true,
 });
-y.command([commit.command, '$0'], commit.desc, commit.builder, commit.handler);
+// Global `--verbose` (alias `-v`) — every subcommand inherits it.
+// Flips `argv.verbose: true` so `commandExecutor` and `Logger` print
+// stack traces / debug spans. Previously only settable via the
+// `COCO_VERBOSE=true` env var or `coco.verbose` git/json config —
+// `BaseArgvOptions.verbose` was typed but never declared as a yargs
+// option, so passing `--verbose` from the CLI was a silent no-op.
+y.option('verbose', {
+    type: 'boolean',
+    alias: 'v',
+    description: 'Print verbose diagnostic output (stack traces on errors, debug spans).',
+    default: false,
+    global: true,
+});
+// `$0` (no positional args) routes through the smart default router
+// rather than aliasing directly to `coco commit`. The router probes
+// the user's environment (config presence, git-repo presence) and
+// forwards to `init` / `ui` / `workspace` / `commit` based on which
+// of those is most likely to be helpful. Mirrors what other modern
+// git-aware CLIs do (lazygit / tig / gitui) — fresh installs land in
+// a setup wizard, configured users land in the TUI, scripts that
+// rely on `coco commit` keep their dedicated subcommand entry.
+y.command('$0', 'Smart entry point — routes to init / ui / workspace / commit based on your environment.', (yargs) => yargs.option('commit', {
+    type: 'boolean',
+    description: 'Force the legacy default — run `coco commit` regardless of routing.',
+    default: false,
+}), 
+// `commandExecutor` wraps every command with config loading, error
+// formatting, and exit-code handling. The router is a regular
+// command so it lights up the same plumbing for free.
+commandExecutor(defaultRouteHandler));
+y.command(commit.command, commit.desc, commit.builder, commit.handler);
 y.command(changelog.command, changelog.desc, changelog.builder, changelog.handler);
 y.command(recap.command, recap.desc, recap.builder, recap.handler);
 y.command(review.command, review.desc, review.builder, review.handler);