@aragon-agent/cli 0.6.16 → 0.6.18

package/dist/ui/App.js

@@ -48,6 +48,8 @@ import { useRenderGovernor } from './use-render-governor.js';
 import { readScrollbarPerf, setPerfResetHook, setPerfSnapshotProvider, } from '../commands/perf.js';
 import { buildFrameBudget } from './layout/budget.js';
 import { OVERLAY_PAGE, useWheelRouting } from './use-wheel-routing.js';
+import { INDEX_KEY_FRAME } from '../input/limits.js';
+import { INDEX_SKILL_NAME, buildIndexConfirmSummary, hasProjectIndex, indexBuildInvocationArgs, } from '../commands/index-build.js';
 import { installConsoleBridge } from './console-bridge.js';
 import { publishExitSnapshot } from './exit-snapshot.js';
 import { OverlayFrame } from './layout/OverlayFrame.js';
@@ -648,6 +650,15 @@ export function App({ controller, version, initialOverlay, initialPrompt, confir
                         dispatch({ type: 'teamUpdate', snapshot });
                     break;
                 }
+                case 'overseer': {
+                    // A supervisor decision was applied (team-overseer). The roster
+                    // already refreshed through the agent_update the runtime publishes
+                    // with it; re-read the snapshot so the panel cannot miss the row.
+                    const snap = controller.getTeamSnapshot();
+                    if (snap)
+                        dispatch({ type: 'teamUpdate', snapshot: snap });
+                    break;
+                }
                 case 'usage': {
                     // Child spend is REAL SPEND and must reach the status bar, or the
                     // session cost readout under-reports by however much the team consumed
@@ -662,10 +673,9 @@ export function App({ controller, version, initialOverlay, initialPrompt, confir
                     // so it closes over the `cfg` object of the render it mounted in, and
                     // `setModel` builds a NEW one.
                     const live = controller.getConfig();
-                    const fastTier = event.tier === 'fast' ? controller.getFastStatus().tier : null;
-                    const ref = fastTier && fastTier.ok
-                        ? fastTier.ref
-                        : { providerId: live.provider, modelId: live.model };
+                    // Every child runs the lead's own model (main-agent parity), so the
+                    // lead's live connection IS the tier that billed.
+                    const ref = { providerId: live.provider, modelId: live.model };
                     // Unknown pricing contributes ZERO rather than a fabricated figure
                     // (C-11 / RV-4); `/fast status` and the dispatch report say `unknown`.
                     const costDelta = controller.isPricedModel(ref)
@@ -1554,6 +1564,46 @@ export function App({ controller, version, initialOverlay, initialPrompt, confir
         setConfirmState(null);
         dispatch({ type: 'setOverlay', overlay: null });
     };
+    // --- Ctrl+I: run the bundled project-indexer skill. -------------------
+    //
+    // SAME PATH AS A TYPED COMMAND, ON PURPOSE. After the Yes/No gate (the
+    // second confirmation the user asked for) this dispatches
+    // `/skill:project-indexer <args>` through `executeSlashInput`, so the
+    // load/activate/queue-frame/submit lifecycle and the streaming tool cards
+    // in the transcript are the ones every skill command already has. The
+    // busy guard refuses rather than queueing: a queued skill body would
+    // arrive as steering mid-run, which is not what "build the index" means.
+    const requestIndexBuild = () => {
+        if (controller.isRunning() || interactionPhase.current !== 'idle') {
+            // A notice entry, not a toast: the running status row's feedback slot is
+            // owned by the activity phrase, and a busy warning nobody can read is
+            // the same as no warning.
+            notify('warn', 'The agent is busy. Let it finish before building the index (Ctrl+I).');
+            return;
+        }
+        if (cfg.skills.enabled) {
+            const record = controller.getSkillService().get(INDEX_SKILL_NAME);
+            if (!record || record.disabled || record.invalid) {
+                notify('warn', `Skill "${INDEX_SKILL_NAME}" is not available. Check /skills list.`);
+                return;
+            }
+        }
+        else {
+            notify('warn', 'Skills are disabled; the project index needs the bundled skill.');
+            return;
+        }
+        const cwd = controller.getCwd();
+        const existing = hasProjectIndex(cwd);
+        void (async () => {
+            const approved = await new Promise((resolve) => {
+                setConfirmState({ summary: buildIndexConfirmSummary({ cwd, hasExistingIndex: existing }), resolve });
+                dispatch({ type: 'setOverlay', overlay: 'confirm' });
+            });
+            if (approved) {
+                await executeSlashInput(`/skill:${INDEX_SKILL_NAME} ${indexBuildInvocationArgs(existing)}`);
+            }
+        })();
+    };
     /** Answer every outstanding request with the same response and close up. */
     const resolveHuman = (response) => {
         for (const entry of [...pendingHuman.current])
@@ -1715,6 +1765,16 @@ export function App({ controller, version, initialOverlay, initialPrompt, confir
             setStatusExpanded(value => !value);
             return;
         }
+        // Ctrl+I arrives as INDEX_KEY_FRAME, never as key.ctrl + 'i': legacy
+        // terminals encode it as the Tab byte and the stdin filter's translators
+        // are the only layer that can tell them apart (see input/limits.ts).
+        // Guarded exactly like Ctrl+G above it.
+        if (input.includes(INDEX_KEY_FRAME)) {
+            if (tooSmall || stateRef.current.overlay)
+                return;
+            requestIndexBuild();
+            return;
+        }
         if (tooSmall)
             return;
         // R-P1-7: the overlay branch MUST come before the transcript scroll branch

package/dist/ui/BottomStatusRow.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from 'react';
 import { Box, Text } from 'ink';
 export function BottomStatusRow({ plan, columns, theme }) {
-    const tones = { normal: theme.primary, muted: theme.muted, warning: theme.noticeWarn, error: theme.noticeError };
+    const tones = { normal: theme.primary, muted: theme.muted, warning: theme.noticeWarn, error: theme.noticeError,
+        accent: theme.accent };
     return _jsxs(Box, { height: 1, width: columns, flexShrink: 0, overflow: "hidden", children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), plan.fields.map((field, index) => _jsxs(React.Fragment, { children: [index > 0 && _jsx(Box, { width: plan.separatorCells, flexShrink: 0, children: _jsx(Text, { color: theme.muted, children: plan.separator }) }), _jsx(Box, { width: field.cells, flexShrink: 0, children: _jsx(Text, { wrap: "truncate", color: tones[field.tone], children: field.text }) })] }, field.id))] });
 }

package/dist/ui/Header.js

@@ -5,7 +5,18 @@ import { Logo } from './Logo.js';
 export function Header({ cwd, provider, model, hasKey, variant, theme, caps, columns = 80, statusExpanded = false, scrolledLines = 0, overlayOpen = false }) {
     const scroll = Number.isFinite(scrolledLines) && scrolledLines > 0
         ? (scrolledLines > 9999 ? '^9999+' : '^' + Math.floor(scrolledLines)) + (overlayOpen ? ' ' : '  ') : '';
+    // The Ctrl+I project-index affordance sits LEFT of the ^G detail toggle:
+    // collapsed it names the key and the noun ('^I Index'); expanded - the
+    // same Ctrl+G state that adds the status detail row - it spells the action
+    // ('^I build index'). Hidden while an overlay owns the header and below the
+    // 72-column cutoff the composer hints also use: on a narrow terminal the
+    // scroll chip and the ^G toggle are the two affordances that must survive.
+    const indexHint = overlayOpen || columns < 72
+        ? ''
+        : (statusExpanded ? '^I build index  ' : '^I Index  ');
     const detail = overlayOpen ? (statusExpanded ? 'Details on' : 'Details off')
-        : '^G ' + (statusExpanded ? 'less' : 'more');
-    return _jsxs(Box, { flexDirection: "row", height: 1, width: columns, flexShrink: 0, overflow: "hidden", children: [_jsx(Box, { width: Math.max(0, columns - 18), flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", children: [_jsx(Logo, { variant: variant === 'mini' ? 'mini' : 'bar', theme: theme, caps: caps }), variant !== 'mini' && _jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.accent, children: ['  ', provider, ":", model] }), _jsxs(Text, { color: theme.muted, children: ['  ', basename(cwd) || cwd] }), _jsxs(Text, { color: hasKey ? theme.toolDone : theme.toolRunning, children: ['  ', hasKey ? theme.symbols.keyOn : theme.symbols.keyOff] })] })] }) }), _jsx(Box, { width: 18, flexShrink: 0, justifyContent: "flex-end", children: _jsx(Text, { color: theme.muted, wrap: "truncate", children: scroll + detail }) })] });
+        : indexHint + '^G ' + (statusExpanded ? 'less' : 'more');
+    // Widest content: '^9999+  ' (8) + '^I build index  ^G less' (23) = 31.
+    const detailCells = indexHint ? 32 : 18;
+    return _jsxs(Box, { flexDirection: "row", height: 1, width: columns, flexShrink: 0, overflow: "hidden", children: [_jsx(Box, { width: Math.max(0, columns - detailCells), flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", children: [_jsx(Logo, { variant: variant === 'mini' ? 'mini' : 'bar', theme: theme, caps: caps }), variant !== 'mini' && _jsxs(_Fragment, { children: [_jsxs(Text, { color: theme.accent, children: ['  ', provider, ":", model] }), _jsxs(Text, { color: theme.muted, children: ['  ', basename(cwd) || cwd] }), _jsxs(Text, { color: hasKey ? theme.toolDone : theme.toolRunning, children: ['  ', hasKey ? theme.symbols.keyOn : theme.symbols.keyOff] })] })] }) }), _jsx(Box, { width: detailCells, flexShrink: 0, justifyContent: "flex-end", children: _jsx(Text, { color: theme.muted, wrap: "truncate", children: scroll + detail }) })] });
 }

package/dist/ui/PromptInput.js

@@ -37,7 +37,7 @@ import { draftMaxRows } from './composer-limits.js';
 import { layoutComposer, splitRowAtColumn } from './composer-rows.js';
 import { moveVisualCursor, snapGrapheme, stepGrapheme } from './editor-navigation.js';
 import { interactionCopy } from './interaction-copy.js';
-import { PASTE_DRAFT_MAX_BYTES, PASTE_MAX_BLOCKS, formatPasteSize, } from '../input/limits.js';
+import { INDEX_KEY_FRAME, PASTE_DRAFT_MAX_BYTES, PASTE_MAX_BLOCKS, formatPasteSize, } from '../input/limits.js';
 // ---------------------------------------------------------------------------
 // The scroll chip (§4.2)
 // ---------------------------------------------------------------------------
@@ -488,6 +488,16 @@ export function PromptInput({ cols: colsProp, terminalRows: terminalRowsProp, st
             insert('\n');
             return;
         }
+        // App owns the Ctrl+I index frame (see input/limits.ts). Standalone it
+        // never reaches here - isControlSeq drops it at the printable-insert
+        // branch below - but a frame glued to typed text in one chunk must
+        // insert ONLY the text, so strip it before any other interpretation.
+        if (input.includes(INDEX_KEY_FRAME)) {
+            const rest = input.split(INDEX_KEY_FRAME).join('');
+            if (rest.length > 0)
+                insert(rest);
+            return;
+        }
         if (hasPasteFrame(input) || hasEnterFrame(input) || /[\r\n]/.test(input)) {
             const intents = splitEnterFrames(input).map((frame) => frame.kind === 'paste' ? { ...frame, id: allocatePasteId() } : frame);
             if (intents.length > 0)

package/dist/ui/StatusBar.js

@@ -27,7 +27,8 @@ export function StatusBar(props) {
         ecoRung: props.ecoRung, fastActive: props.fastActive, scrolledLines: props.scrolledLines,
     });
     const tones = { normal: props.theme.primary, muted: props.theme.muted,
-        warning: props.theme.noticeWarn, error: props.theme.noticeError };
+        warning: props.theme.noticeWarn, error: props.theme.noticeError,
+        accent: props.theme.accent };
     return _jsxs(Box, { width: cols, height: 1, flexShrink: 0, flexDirection: "row", overflow: "hidden", children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { children: redrawChar(props.redrawNonce ?? 0) }) }), plan.fields.map((item, index) => _jsxs(React.Fragment, { children: [index > 0 && _jsx(Box, { width: plan.separatorCells, flexShrink: 0, children: _jsx(Text, { color: props.theme.muted, children: plan.separator }) }), _jsx(Box, { width: item.cells, flexShrink: 0, children: _jsx(Text, { color: tones[item.tone], wrap: "truncate", children: item.id === 'phase' && active
                                 ? _jsxs(_Fragment, { children: [spinner ?? glyph, item.text.slice(glyph.length)] })
                                 : item.text }) })] }, item.id))] });

package/dist/ui/TeamPanel.js

@@ -130,7 +130,7 @@ export function TeamPanel({ snapshot, rows, cols, reducedMotion, theme, caps, no
                 // `reducedMotion` and a non-Unicode terminal fall back to the same
                 // static marker, exactly as `AssistantEntry` and `ToolCard` already do.
                 const animate = isRunning(run) && !reducedMotion && caps.unicode;
-                return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: color, children: [' ', animate ? _jsx(Spinner, { type: "dots" }) : marker(run, glyphs), ' '] }), _jsx(Text, { color: theme.primary, children: `${run.label}${run.tier === 'fast' ? '~' : ''}`.padEnd(8).slice(0, 8) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsx(Text, { wrap: "truncate", color: theme.muted, children: run.description.replace(/\s+/g, ' ') }) }), _jsx(Box, { flexShrink: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", color: color, children: ['  ', activityLine(run, cols)] }) }), _jsxs(Text, { wrap: "truncate", color: theme.muted, children: ['  ', run.startedAt ? formatDuration(Math.max(0, (run.endedAt ?? at) - run.startedAt)) : ''] })] }, run.label));
+                return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: color, children: [' ', animate ? _jsx(Spinner, { type: "dots" }) : marker(run, glyphs), ' '] }), _jsx(Text, { color: theme.primary, children: run.label.padEnd(8).slice(0, 8) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsx(Text, { wrap: "truncate", color: theme.muted, children: run.description.replace(/\s+/g, ' ') }) }), _jsx(Box, { flexShrink: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", color: color, children: ['  ', activityLine(run, cols)] }) }), _jsxs(Text, { wrap: "truncate", color: theme.muted, children: ['  ', run.startedAt ? formatDuration(Math.max(0, (run.endedAt ?? at) - run.startedAt)) : ''] })] }, run.label));
             }), hiddenTotal > 0 && (_jsxs(Text, { wrap: "truncate", color: theme.muted, children: ['  ', "+", hiddenTotal, " more", hiddenRunning > 0 ? ` (${hiddenRunning} running)` : ''] })), snapshot.lastMessage && (_jsxs(Text, { wrap: "truncate", color: theme.muted, children: [' ', glyphs.teamMail, " ", snapshot.lastMessage.from, " ", glyphs.arrowRight, " ", snapshot.lastMessage.to, ": ", snapshot.lastMessage.subject.replace(/\s+/g, ' ')] }))] }));
 }
 function marker(run, glyphs) {

package/dist/ui/entries/TeamCard.js

@@ -48,12 +48,7 @@ function TeamCardImpl(props) {
             : `${formatDuration(durationMs ?? 0)}  (${ok} ok, ${failed} failed)`;
     const count = `${runs.length} ${runs.length === 1 ? 'subagent' : 'subagents'}`;
     const dropped = requested > runs.length ? `  (${runs.length} of ${requested} requested)` : '';
-    // ABSENT WHEN NO FAST CHILD RAN, so an ordinary dispatch's card is unchanged
-    // (fast-model-tier §6). `n fast` rather than a ratio: the total is already one
-    // column to the left.
-    const fastCount = runs.filter((r) => r.tier === 'fast').length;
-    const fastNote = fastCount > 0 ? `  ${fastCount} fast` : '';
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: theme.accent, bold: true, children: "team" }), _jsxs(Text, { color: theme.muted, children: [' ', count, dropped, fastNote, '  '] }), active && !reducedMotion && caps.unicode ? (_jsxs(Text, { color: color, children: [_jsx(Spinner, { type: "dots" }), " ", headline] })) : (_jsxs(Text, { color: color, children: [active ? `${glyphs.spinnerStill} ` : '', headline] }))] }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, paddingLeft: 1, ...railBorderProps(glyphs.railVertical, theme.border), children: [runs.map((run) => (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: isOk(run) ? theme.toolDone : theme.toolError, children: isOk(run) ? glyphs.toolDone : glyphs.toolError }), _jsxs(Text, { color: theme.primary, children: [' ', `${run.label}${run.tier === 'fast' ? '~' : ''}`.padEnd(8).slice(0, 8)] }), _jsxs(Text, { color: theme.muted, children: [' ', run.description, '  ', run.startedAt ? formatDuration(Math.max(0, (run.endedAt ?? 0) - run.startedAt)) : '', `  ${run.turns} turns`, run.filesTouched.length > 0 ? `  ${run.filesTouched.length} files` : '', run.error ? `  ${run.error}` : ''] }), run.retry && (_jsxs(Text, { color: theme.noticeWarn, bold: true, children: ['  ', "retry ", run.retry.attempt, "/", run.retry.maxRetries] }))] }, run.label))), expanded &&
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: theme.accent, bold: true, children: "team" }), _jsxs(Text, { color: theme.muted, children: [' ', count, dropped, '  '] }), active && !reducedMotion && caps.unicode ? (_jsxs(Text, { color: color, children: [_jsx(Spinner, { type: "dots" }), " ", headline] })) : (_jsxs(Text, { color: color, children: [active ? `${glyphs.spinnerStill} ` : '', headline] }))] }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, paddingLeft: 1, ...railBorderProps(glyphs.railVertical, theme.border), children: [runs.map((run) => (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: isOk(run) ? theme.toolDone : theme.toolError, children: isOk(run) ? glyphs.toolDone : glyphs.toolError }), _jsxs(Text, { color: theme.primary, children: [' ', run.label.padEnd(8).slice(0, 8)] }), _jsxs(Text, { color: theme.muted, children: [' ', run.description, '  ', run.startedAt ? formatDuration(Math.max(0, (run.endedAt ?? 0) - run.startedAt)) : '', `  ${run.turns} turns`, run.filesTouched.length > 0 ? `  ${run.filesTouched.length} files` : '', run.error ? `  ${run.error}` : ''] }), run.retry && (_jsxs(Text, { color: theme.noticeWarn, bold: true, children: ['  ', "retry ", run.retry.attempt, "/", run.retry.maxRetries] }))] }, run.label))), expanded &&
                         runs.map((run) => (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { color: theme.accent, children: [run.label, " ", glyphs.midDot, " ", run.description] }), _jsx(Text, { color: theme.muted, children: run.summary ?? '(no summary)' })] }, `s-${run.label}`))), !expanded && !active && runs.length > 0 && (_jsxs(Text, { color: theme.muted, children: ["+", runs.length, " ", runs.length === 1 ? 'summary' : 'summaries', " (Ctrl+O)"] })), expanded && _jsx(Text, { color: theme.muted, children: "(Ctrl+O to collapse)" })] })] }));
 }
 /**

package/dist/ui/layout/status-detail-layout.js

@@ -1,6 +1,17 @@
 import { formatCost, formatTokens, promptTokensOf } from '../../agent/usage.js';
 import { actionCandidates, clipStatusText, escapeClause } from '../interaction-hints.js';
+import { MODE_LABEL } from '../../agent/agent-mode.js';
 import { statusField, statusLinePlan, validContext } from './status-layout.js';
+/**
+ * Uppercase mode word for the details row, mirroring the primary row's field:
+ * same vocabulary (`MODE_LABEL`), same `CUR>PENDING` deferred-switch shape.
+ */
+function detailModeText(mode, pendingMode) {
+    const word = (value) => MODE_LABEL[value] ?? value.toUpperCase();
+    if (pendingMode)
+        return `${word(mode || 'build')}>${word(pendingMode)}`;
+    return word(mode || 'build');
+}
 export function planStatusDetail(input) {
     const { status, hints } = input;
     const budget = Math.max(0, Math.floor(status.columns) - 1);
@@ -26,8 +37,7 @@ export function planStatusDetail(input) {
     if (status.servicesActive?.live)
         add(statusField('services', 'Svc' + status.servicesActive.live));
     if (status.mode || status.pendingMode)
-        add(statusField('mode', status.pendingMode
-            ? (status.mode ?? 'build') + '>' + status.pendingMode : status.mode));
+        add(statusField('mode', detailModeText(status.mode, status.pendingMode), 'accent'));
     if (validContext(status.context)) {
         const approximate = status.context.source === 'estimate' || status.context.deltaTokens > 0 ? '~' : '';
         add(statusField('context', 'Context ' + approximate + formatTokens(status.context.occupied)

package/dist/ui/layout/status-layout.d.ts

@@ -25,6 +25,7 @@ export interface StatusLayoutInput {
         max: number;
         secondsLeft: number;
     };
+    /** Named on the primary row in EVERY mode - the §6.4 guarantee, restored. */
     mode?: string;
     pendingMode?: string | null;
     servicesActive?: {
@@ -54,7 +55,8 @@ export interface StatusField {
     id: string;
     text: string;
     cells: number;
-    tone: 'normal' | 'muted' | 'warning' | 'error';
+    /** 'accent' carries the mode word - the row's one always-on emphasis. */
+    tone: 'normal' | 'muted' | 'warning' | 'error' | 'accent';
 }
 export interface StatusLinePlan {
     fields: readonly StatusField[];
@@ -68,5 +70,5 @@ export declare function statusLinePlan(fields: readonly StatusField[], separator
 export declare function phaseLabels(input: Pick<StatusLayoutInput, 'phase' | 'activeTool' | 'runOutcome' | 'waitingForConfirmation' | 'stopping' | 'compacting' | 'retryActive'>): readonly [string, string];
 export declare function validContext(context: ContextUsageSnapshot): boolean;
 export declare function shortDuration(ms: number): string;
-/** All five fields survive each width rung; only the redraw carrier is outside this plan. */
+/** Every field survives each width rung; only the redraw carrier is outside this plan. */
 export declare function planPrimaryStatusFields(input: StatusPrimaryInput): StatusLinePlan;

package/dist/ui/layout/status-layout.js

@@ -1,6 +1,7 @@
 import stringWidth from 'string-width';
 import stripAnsi from 'strip-ansi';
 import { formatDuration } from '../../agent/usage.js';
+import { MODE_LABEL } from '../../agent/agent-mode.js';
 import { interactionCopy as copy } from '../interaction-copy.js';
 export function cleanStatusText(text) {
     // eslint-disable-next-line no-control-regex
@@ -89,7 +90,27 @@ function feedbackLabel(input, form) {
     return labels[feedback.kind][form === 'full' ? 0 : form === 'short' ? 1 : 2];
 }
 const thinkingCodes = { off: 'O', minimal: 'N', low: 'L', medium: 'M', high: 'H', xhigh: 'X' };
-/** All five fields survive each width rung; only the redraw carrier is outside this plan. */
+/**
+ * The mode word for the primary row: full rungs name the mode with
+ * `MODE_LABEL`, tight rungs keep only its first letter, and a deferred switch
+ * renders `CUR>PENDING` in both tiers. `null` when the caller names no mode at
+ * all, so callers and tests that predate the field keep a byte-identical plan.
+ * The word must survive every width rung: the border color cannot be the only
+ * mode signal the default view carries (plan-mode P1-6).
+ */
+function modeFieldText(mode, pendingMode, full) {
+    if (!mode && !pendingMode)
+        return null;
+    const word = (value) => {
+        const label = MODE_LABEL[value];
+        if (!label)
+            return full ? value.toUpperCase() : (value[0] ?? '?').toUpperCase();
+        return full ? label : label[0];
+    };
+    const current = word(mode || 'build');
+    return pendingMode ? `${current}>${word(pendingMode)}` : current;
+}
+/** Every field survives each width rung; only the redraw carrier is outside this plan. */
 export function planPrimaryStatusFields(input) {
     const budget = Math.max(0, (Number.isFinite(input.columns) ? Math.floor(input.columns) : 80) - 1);
     const labels = phaseLabels(input);
@@ -104,8 +125,10 @@ export function planPrimaryStatusFields(input) {
         const full = rung === 0;
         const label = feedbackLabel(input, full ? 'full' : rung >= 4 ? 'tiny' : 'short')
             ?? (full ? labels[1] : rung >= 4 ? labels[0].slice(0, 4) : labels[0]);
+        const modeText = modeFieldText(input.mode, input.pendingMode, full);
         return statusLinePlan([
             statusField('phase', glyph + (rung >= 5 ? '' : ' ') + label, tone),
+            ...(modeText ? [statusField('mode', modeText, 'accent')] : []),
             statusField('context', (full ? 'Context ' : 'C') + pct),
             statusField('thinking', full ? 'Think ' + (thinkingCodes[input.thinkingLevel] ? input.thinkingLevel : '?')
                 : (rung >= 2 ? '' : 'Th:') + code),

package/dist/ui/overlays/HelpOverlay.js

@@ -20,6 +20,7 @@ function keyRows(times) {
         [`Ctrl+C ${times}2`, 'Exit'],
         ['Ctrl+L', 'Redraw the frame'],
         ['Ctrl+T', 'Show/hide thinking (off by default)'],
+        ['Ctrl+I', 'Build the project index (bundled skill; asks first; needs keyboard enhancement)'],
         ['Ctrl+G', 'Expand/collapse status details; disabled while an overlay is open'],
         ['PgUp / PgDn', 'Scroll a page (transcript, or this overlay)'],
         ['Shift+Up / Shift+Down', 'Scroll the transcript a line (full-screen mode)'],
@@ -31,6 +32,7 @@ function keyRows(times) {
         ['Drag right edge', 'Scroll messages; input stays fixed; type to return to newest output'],
         ['Bottom rows', 'Fixed input, one status row; Ctrl+G adds one detail row'],
         ['C / Th / t/s', 'Context percent / thinking level / run-average output tokens per second'],
+        ['B / P / P>B', 'Status-row mode word: BUILD / PLAN; CUR>PENDING = switch deferred to run end'],
         ['O/N/L/M/H/X', 'Thinking: off/minimal/low/medium/high/xhigh'],
         ['~ / ? / --', 'Estimated context / unknown context / unavailable output speed'],
         ['Output speed', 'Main Agent reported output tokens / total run time, including tools and waits'],
@@ -40,7 +42,6 @@ function keyRows(times) {
         ['Ctrl+C (with a selection)', 'Copy the pending selection - does not arm exit'],
         ['Native terminal selection', 'Copy-on-select is controlled by your terminal settings'],
         ['Queue / /queue', 'Pending receipt; /queue opens full text, PgUp/PgDn pages, Esc closes'],
-        ['plan>build / build>plan', 'A mode switch pending until the current run ends'],
         ['/bg / /todo status', 'Show full service and TODO counts when status fields are hidden'],
         ['Queue paused', 'Unreceived messages persist after interruption until accepted or cancelled'],
         ['Up / Down', 'Prompt history (empty input)'],
@@ -113,7 +114,6 @@ const FAST_ROWS = [
     ['/fast model <id>', 'Set the fast model; accepts provider:model'],
     ['/fast same', 'Run the fast tier on the main model'],
     ['/fast review <n> | off', 'Turns between automatic reviews, or turn them off'],
-    ['/fast delegate on | off', 'Allow model:"fast" on task subagents'],
     ['--fast / --no-fast', 'Start a session with the tier on or off (also ARAGON_FAST=1)'],
     ['<fast_review>', 'An automated second opinion from the fast model - advice, not the user'],
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/cli",
-  "version": "0.6.16",
+  "version": "0.6.18",
   "description": "AragonAgent CLI — a Claude-Code / Codex-style interactive terminal UI (TUI) on top of the @aragon-agent/core engine. Installable and runnable via npm / npx.",
   "license": "MIT",
   "author": "AragonAgent contributors",
@@ -56,7 +56,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@aragon-agent/core": "^0.2.28",
+    "@aragon-agent/core": "^0.2.30",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.0.0",
     "commander": "^12.1.0",

package/skills/project-indexer/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: project-indexer
+description: Generate and use a project index for quick codebase understanding in new sessions. Scans the workspace, extracts exported symbols, writes .claude-index/index.md plus config, and injects a Google-style Clean Code Guidelines section into CLAUDE.md. Use when the user says "explore the project", "generate index", "regenerate index", "更新索引", "生成索引", or presses Ctrl+I.
+version: 1.1.0
+license: MIT
+keywords: [productivity, codebase, indexing, navigation, cleancode]
+# The read-only tools (read_file, list_dir, glob, grep, ask_user, todo_write)
+# are always available inside a skill frame via the tool floor; this ceiling
+# adds exactly the two writers the generated files need.
+allowed-tools:
+  - write_file
+  - edit_file
+---
+
+# Project Indexer
+
+Generate a structured index of any codebase so a new session understands the
+project with minimal context usage. The index is a **navigation map**, not a
+code copy: enough to see the project globally (type, stack, architecture),
+navigate on demand (feature map, file index), and know which symbols exist
+without reading every file.
+
+## Current request
+
+$ARGUMENTS
+
+## Step 1: Check for an existing index
+
+- If `.claude-index/index.md` exists and has the key sections (Project
+  Overview, Feature Map, File Index), go to "Using an existing index".
+- If it exists but is empty or malformed, tell the user and regenerate
+  (first-time flow), preserving `config.md` if intact.
+- Otherwise run the first-time flow.
+
+## Using an existing index
+
+1. Read `.claude-index/index.md` and `CLAUDE.md` (if present).
+2. Summarize in 3-5 bullets: structure, stack, feature areas, key entry
+   points. Offer to help.
+3. For later questions, navigate via the Feature Map / File Index and read
+   real source only when detail is needed.
+
+## First-time flow
+
+### Step 2: Gather configuration (ask_user)
+
+Ask with `ask_user`, defaults offered in every question:
+
+1. **Exclusions** - A) defaults (node_modules, .git, dist, build,
+   __pycache__, .venv, vendor, coverage, .next, .nuxt, .cache, target, bin,
+   obj, .idea, .vscode) B) add more C) custom list.
+2. **Priority directories** - A) auto-detect (recommended) B) specify C) all
+   equally.
+3. **Tech stack** - auto-detect unless the user names one.
+4. **Clean Code Guidelines** (injected into CLAUDE.md) - A) Google strict
+   (method 60, file 1000 - recommended) B) Google relaxed (method 600)
+   C) custom D) skip.
+
+If C: ask **one `ask_user` call per limit** showing default and range -
+MAX_FILE_LINES 1000 (200-5000), MAX_METHOD_LINES 60 (20-600),
+MAX_FUNCTION_PARAMS 5 (2-10), MAX_CYCLOMATIC 10 (5-25); fall back to the
+default on an out-of-range answer and say so in the summary.
+MAX_LINE_LENGTH (default 100, Python 80) and MAX_NESTING_DEPTH (4) are never
+asked. If the user skips every question, use all defaults.
+
+Treat the answer as `CleanCodeConfig.preset`: strict | relaxed | custom |
+disabled. D (`disabled`) skips the Clean Code composition below, never adds
+markers, and persists `Enabled: No`.
+
+### Step 3: Scan and analyze
+
+1. Traverse the tree with the exclusion rules (`glob`, never one giant read).
+2. Detect project type (frontend/backend/fullstack/library/CLI/monorepo),
+   languages with percentages, frameworks, entry points.
+3. Group files by feature/domain and extract exported symbols - full support
+   for JS/TS (.js/.jsx/.ts/.tsx/.mjs) and Python; best-effort for Java,
+   Kotlin, Go, Rust, C/C++, C#, Ruby, PHP; unknown types are listed without
+   symbols.
+4. Analyze module-level dependencies (import graph).
+
+Adaptive sizing: <50 files -> full detail; 50-200 -> full coverage with
+concise descriptions; 200+ -> detail the priority directories, summarize the
+rest, group similar utilities. Over 1000 files after exclusions: warn and
+suggest more exclusions before continuing; sample representative files with
+glob/grep rather than reading everything. Keep language/framework findings in
+working memory - do NOT write an intermediate JSON file.
+
+### Step 4: Write `.claude-index/`
+
+1. `config.md` - exclusions, priorities, tech stack, plus an Index Settings
+   block (Generated date, Project Root, Index Version) and a Clean Code
+   Settings block (Enabled / Preset / the six limits; when the user picked
+   skip, write `Enabled: No`, `Preset: disabled` and the strict numbers so a
+   later "enable cleancode" can flip it back).
+2. `index.md` - follow `templates/index-template.md` in this skill's
+   directory: Project Overview, Feature Map (per area: entry file, one-line
+   description, key exports with signatures), Module Dependencies, File Index
+   (per-directory tables, one line per file).
+
+### Step 5: Compose the Clean Code Guidelines (skip when disabled)
+
+Read `templates/cleancode-template.md` and `templates/cleancode-overrides.md`
+from this skill's directory, then:
+
+1. Primary languages = every language with >= 10% of post-exclusion source
+   files; if none clears 10%, use the `Other` row.
+2. Take the **minimum** across all matching rows for each numeric column.
+3. Apply the user preset: strict/relaxed values intersect with the language
+   minimum (never looser than the baseline); custom numbers are honoured
+   verbatim with divergence noted.
+4. Substitute every placeholder: `{{MAX_FILE_LINES}}`, `{{MAX_METHOD_LINES}}`,
+   `{{MAX_FUNCTION_PARAMS}}`, `{{MAX_CYCLOMATIC}}`, `{{MAX_LINE_LENGTH}}`,
+   `{{MAX_NESTING_DEPTH}}`, `{{PRIMARY_LANGUAGES}}` (comma-joined languages)
+   and `{{LANGUAGE_HINTS}}` (one `- Language: note` bullet per matching row,
+   deduped by exact string).
+5. Verify no `{{...}}` placeholder remains. Do not count characters at
+   runtime.
+
+### Step 6: Update CLAUDE.md
+
+- `## Project Index` section: upsert (replace when present, else append at
+  end; create the file when missing). Contents: Location
+  `.claude-index/index.md`, Last Updated (YYYY-MM-DD), Contents line, a
+  Usage line, and "Regenerate: say 'regenerate index' / '更新索引'".
+- `## Clean Code Guidelines` section (unless disabled): wrap the rendered
+  body in `<!-- project-indexer:cleancode:begin v1.1.0 -->` and
+  `<!-- project-indexer:cleancode:end -->`. Locate an existing block with
+  the version-agnostic regex `<!-- project-indexer:cleancode:begin
+  v\d+\.\d+\.\d+ -->` (NEVER a literal-version match) plus the literal end
+  marker; fallback: the region from a `## Clean Code Guidelines` heading to
+  the next `## ` heading or EOF. Replace the found block; if none, insert
+  after the Project Index section (first-insert only; when both sections
+  already exist preserve the user's ordering and everything between them).
+  Write UTF-8; add a trailing newline when missing.
+
+### Step 7: Report
+
+List what was created/updated, the feature-area count, files indexed and
+symbols extracted. Offer to start work.
+
+## Regeneration ("regenerate index" / "更新索引")
+
+1. Read `config.md` and preserve exclusions, priorities, stack.
+2. Clean Code handling: if CLAUDE.md has markers or the heading, ask
+   A) refresh B) keep C) remove; honour `Enabled: No` from config.md by
+   skipping silently with one reminder line. When no block exists and
+   Enabled is Yes/absent, compose and inject (announce before writing).
+3. Confirm the plan (exclusions, priorities, cleancode decision) with the
+   user, then re-run Steps 3-7.
+
+Special triggers: "disable cleancode" removes the block and sets
+`Enabled: No`; "enable cleancode" re-composes it and sets `Enabled: Yes` -
+both without a full rescan.
+
+## Edge cases
+
+- Inaccessible directories: list them under a "Skipped Directories" note and
+  continue; never fail the whole run for one unreadable path.
+- No recognizable source files: generate a minimal index (overview + file
+  listing) and say so.
+- The user pressed Ctrl+I: they already confirmed once - do not re-ask the
+  global "proceed?" question, but still ask the configuration questions
+  above (or reuse `.claude-index/config.md` when it exists).

package/skills/project-indexer/templates/cleancode-overrides.md

@@ -0,0 +1,46 @@
+# Clean Code — Language Override Table
+
+> Read by `project-indexer` at Step 5. The skill intersects the rows below
+> with the **primary languages** detected during the scan (any language whose
+> source files account for >= 10% of the post-exclusion total).
+>
+> When two or more rows apply, the skill **takes the minimum** for every
+> numeric column. Notes from each matching row are concatenated and rendered
+> as bullets in the `{{LANGUAGE_HINTS}}` placeholder of
+> `cleancode-template.md`.
+>
+> Defaults (used when no row matches, i.e. the `Other` row) live in the last
+> row. Numeric units: `MAX_FILE_LINES` and `MAX_METHOD_LINES` are physical
+> lines of source. `MAX_LINE_LENGTH` is columns. `MAX_FUNCTION_PARAMS` is the
+> count of positional + keyword parameters in a single signature.
+
+| Language    | MAX_FILE_LINES | MAX_METHOD_LINES | MAX_LINE_LENGTH | MAX_FUNCTION_PARAMS | Notes |
+|-------------|----------------|------------------|-----------------|---------------------|-------|
+| TypeScript  | 1000           | 60               | 100             | 5                   | Prefer `interface` over `type` for public APIs. |
+| JavaScript  | 1000           | 60               | 100             | 5                   | Avoid `any`; use JSDoc when no TS. |
+| Python      | 800            | 50               | 80              | 5                   | PEP 8 + Google docstrings. |
+| Go          | 800            | 60               | 120             | 4                   | Errors as values; no panic in library code. |
+| Java        | 1500           | 40               | 100             | 5                   | Google Java Style. |
+| Kotlin      | 1500           | 40               | 100             | 5                   | KtLint defaults. |
+| Rust        | 1000           | 60               | 100             | 5                   | `clippy::pedantic` recommended. |
+| C / C++     | 1000           | 50               | 100             | 5                   | Google C++ Style. |
+| Other       | 1000           | 60               | 100             | 5                   | Generic fallback. |
+
+## Merge Rules
+
+1. **Detection threshold** — only languages with >= 10% of source files (after
+   exclusions) contribute. If no language clears 10%, use the `Other` row.
+2. **Numeric merge** — `min()` across every matching row, per column.
+3. **Note merge** — collect each matching row's `Notes` cell, dedupe by exact
+   string match, render as a bullet list. Example for TypeScript + Python:
+   - `- TypeScript: Prefer interface over type for public APIs.`
+   - `- Python: PEP 8 + Google docstrings.`
+4. **Fixed defaults (not in the table, applied unconditionally)** —
+   `MAX_CYCLOMATIC = 10`, `MAX_NESTING_DEPTH = 4`. These can still be
+   overridden by the user via the Custom preset.
+
+## Adding a Language
+
+When extending this table, keep the column order identical and use the
+strictest reasonable value for each cell so the `min()` merge stays
+meaningful for polyglot repos.