@parallel-cli/parallel 0.3.3 → 0.4.0

package/dist/ui/CommandInput.js

@@ -6,7 +6,39 @@ import { t } from '../i18n.js';
 import { readClipboardImage } from './clipboard.js';
 /** A paste is "long" when it spans multiple lines — it then collapses into a chip. */
 const PASTE_MIN_LINES = 2;
-export function CommandInput({ active, placeholder, mask, agentNames = [], onSubmit, onEscape, notify }) {
+const GROUP_LABEL = {
+    modes: 'Agent modes',
+    control: 'Control',
+    views: 'Views',
+    settings: 'Settings',
+    git: 'Git/session',
+    other: 'Other',
+};
+function modeHint(value) {
+    const v = value.trimStart().toLowerCase();
+    if (!v)
+        return 'Default /task · Tab/→ autocomplete · / for commands';
+    if (!v.startsWith('/'))
+        return 'Will launch /task';
+    if (v.startsWith('/ask') || v === '/a')
+        return 'Ask mode · advice only · no edits';
+    if (v.startsWith('/task') || v === '/t')
+        return 'Task mode · execute, edit, validate';
+    if (v.startsWith('/plan') || v === '/p')
+        return 'Plan mode · asks before editing';
+    return 'Tab/→ accepts the best suggestion';
+}
+function groupedCommands(commands) {
+    const order = ['modes', 'control', 'views', 'settings', 'git', 'other'];
+    return order
+        .map((g) => [g, commands.filter((c) => (c.group ?? 'other') === g)])
+        .filter(([, items]) => items.length > 0);
+}
+export function bestCommandCompletion(value) {
+    const cmd = matchCommands(value)[0];
+    return cmd ? `${cmd.name} ` : null;
+}
+export function CommandInput({ active, placeholder, mask, agentNames = [], agents = [], onSubmit, onEscape, notify }) {
     const [value, setValue] = useState('');
     const [attachments, setAttachments] = useState([]);
     const [history, setHistory] = useState([]);
@@ -53,6 +85,22 @@ export function CommandInput({ active, placeholder, mask, agentNames = [], onSub
         setAttachments((arr) => [...arr, { kind: 'image', n, dataUri: img.dataUri, label: img.label }]);
         notify?.(t('input.imageAdded'));
     };
+    const completeBest = () => {
+        const cmd = bestCommandCompletion(value);
+        if (cmd) {
+            setValue(cmd);
+            return true;
+        }
+        if (value.startsWith('@')) {
+            const frag = value.slice(1).toLowerCase();
+            const m = ['all', ...agentNames].find((n) => n.toLowerCase().startsWith(frag));
+            if (m) {
+                setValue('@' + m + ' ');
+                return true;
+            }
+        }
+        return false;
+    };
     useInput((input, key) => {
         if (key.escape) {
             if (value || attachments.length > 0)
@@ -100,18 +148,8 @@ export function CommandInput({ active, placeholder, mask, agentNames = [], onSub
             });
             return;
         }
-        if (key.tab) {
-            const cmds = matchCommands(value);
-            if (cmds.length > 0) {
-                setValue(cmds[0].name + ' ');
-                return;
-            }
-            if (value.startsWith('@')) {
-                const frag = value.slice(1).toLowerCase();
-                const m = ['all', ...agentNames].find((n) => n.toLowerCase().startsWith(frag));
-                if (m)
-                    setValue('@' + m + ' ');
-            }
+        if (key.tab || key.rightArrow) {
+            completeBest();
             return;
         }
         if (key.ctrl && input === 'u') {
@@ -145,10 +183,13 @@ export function CommandInput({ active, placeholder, mask, agentNames = [], onSub
         }
         setValue((v) => v + input);
     }, { isActive: active });
-    const cmdSuggestions = value.startsWith('/') && !value.includes(' ') ? matchCommands(value).slice(0, 8) : [];
+    const cmdSuggestions = value.startsWith('/') && !value.includes(' ') ? matchCommands(value).slice(0, 10) : [];
     const agentSuggestions = value.startsWith('@') && !value.includes(' ')
         ? ['all', ...agentNames].filter((n) => n.toLowerCase().startsWith(value.slice(1).toLowerCase())).slice(0, 8)
         : [];
     const shown = mask ? '•'.repeat(value.length) : value;
-    return (_jsxs(Box, { flexDirection: "column", children: [cmdSuggestions.length > 0 && (_jsx(Box, { borderStyle: "round", borderColor: "gray", flexDirection: "column", paddingX: 1, children: cmdSuggestions.map((c) => (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: c.name.padEnd(18) }), _jsx(Text, { color: "yellow", children: c.args.padEnd(24) }), _jsx(Text, { color: "gray", children: t(c.descKey) })] }, c.name))) })), agentSuggestions.length > 0 && (_jsx(Box, { borderStyle: "round", borderColor: "gray", flexDirection: "column", paddingX: 1, children: agentSuggestions.map((n) => (_jsxs(Text, { children: [_jsxs(Text, { color: "magenta", bold: true, children: ["@", n] }), _jsxs(Text, { color: "gray", children: [t('input.atHint'), n === 'all' ? t('input.atAll') : ''] })] }, n))) })), attachments.length > 0 && (_jsx(Box, { flexDirection: "row", gap: 1, paddingX: 1, children: attachments.map((a) => (_jsxs(Text, { color: "cyan", backgroundColor: "gray", children: [' ', a.kind === 'paste' ? t('input.attPaste', { n: a.n, lines: a.lines }) : t('input.attImage', { n: a.n, file: a.label }), ' '] }, a.n))) })), _jsxs(Box, { borderStyle: "round", borderColor: active ? 'cyan' : 'gray', paddingX: 1, children: [_jsxs(Text, { color: "cyanBright", bold: true, children: ["\u276F", ' '] }), shown ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: shown }), active && _jsx(Text, { color: "cyanBright", children: "\u2588" })] })) : (_jsxs(_Fragment, { children: [active && _jsx(Text, { color: "cyanBright", children: "\u2588" }), _jsx(Text, { color: "gray", children: placeholder })] }))] })] }));
+    const byName = new Map(agents.flatMap((a) => [[a.name, a], [a.alias, a]]));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "gray", wrap: "truncate-end", children: modeHint(value) }), cmdSuggestions.length > 0 && (_jsx(Box, { borderStyle: "single", borderColor: "gray", flexDirection: "column", paddingX: 1, children: groupedCommands(cmdSuggestions).map(([group, commands]) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "gray", bold: true, children: GROUP_LABEL[group] ?? group }), commands.map((c) => (_jsxs(Text, { children: [_jsx(Text, { color: "cyan", bold: true, children: c.name.padEnd(14) }), _jsx(Text, { color: "yellow", children: c.args.padEnd(22) }), _jsx(Text, { color: "gray", children: t(c.descKey) })] }, c.name)))] }, group))) })), agentSuggestions.length > 0 && (_jsx(Box, { borderStyle: "single", borderColor: "gray", flexDirection: "column", paddingX: 1, children: agentSuggestions.map((n) => (_jsxs(Text, { children: [_jsxs(Text, { color: "cyan", bold: true, children: ["@", n.padEnd(10)] }), _jsx(Text, { color: "gray", children: n === 'all'
+                                ? t('input.atAll')
+                                : `${byName.get(n)?.state ?? ''} ${byName.get(n)?.mode ? `/${byName.get(n)?.mode}` : ''}` })] }, n))) })), attachments.length > 0 && (_jsx(Box, { flexDirection: "row", gap: 1, paddingX: 1, children: attachments.map((a) => (_jsxs(Text, { color: "cyan", backgroundColor: "gray", children: [' ', a.kind === 'paste' ? t('input.attPaste', { n: a.n, lines: a.lines }) : t('input.attImage', { n: a.n, file: a.label }), ' '] }, a.n))) })), _jsxs(Box, { borderStyle: "single", borderColor: active ? 'cyan' : 'gray', paddingX: 1, children: [_jsxs(Text, { color: "cyanBright", bold: true, children: ["\u203A", ' '] }), shown ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: shown }), active && _jsx(Text, { color: "cyanBright", children: "\u2588" })] })) : (_jsxs(_Fragment, { children: [active && _jsx(Text, { color: "cyanBright", children: "\u2588" }), _jsx(Text, { color: "gray", children: placeholder })] }))] })] }));
 }

package/dist/ui/SettingsPanel.js

@@ -10,6 +10,13 @@ function masked(key) {
         return '—';
     return '••••' + key.slice(-4);
 }
+function nextApprovalMode(mode) {
+    if (mode === 'ask')
+        return 'auto-safe';
+    if (mode === 'auto-safe')
+        return 'yolo';
+    return 'ask';
+}
 /**
  * /settings        → scope 'global'  : persisted in ~/.parallel/config.json
  * /settings-session → scope 'session' : this session only, never persisted
@@ -76,9 +83,9 @@ export function SettingsPanel({ ctl, scope, onClose, }) {
             return setStep({ id: 'newSpecialist' });
         if (v === 'approvals') {
             if (scope === 'global')
-                ctl.setGlobalApprovalMode(cfg.approvalMode === 'ask' ? 'auto' : 'ask');
+                ctl.setGlobalApprovalMode(nextApprovalMode(cfg.approvalMode));
             else
-                ctl.setSessionApprovalMode(ctl.session.approvalMode === 'ask' ? 'auto' : 'ask');
+                ctl.setSessionApprovalMode(nextApprovalMode(ctl.session.approvalMode));
             if (scope === 'global')
                 saved();
             return;

package/dist/ui/Timeline.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { t } from '../i18n.js';
+import { presentTimeline } from './events.js';
+import { truncate } from './theme.js';
+import { UI } from './tokens.js';
+function sectionLabel(category) {
+    return t(`timeline.section.${category}`);
+}
+function fileLabel(label, count) {
+    const key = label === 'write' ? 'timeline.wroteFiles' : label === 'edit' ? 'timeline.editedFiles' : label === 'search' ? 'timeline.searched' : label === 'list' ? 'timeline.listed' : 'timeline.readFiles';
+    return t(key, { count });
+}
+function itemColor(item) {
+    if (item.status === 'error')
+        return UI.danger;
+    if (item.kind === 'command')
+        return UI.accent;
+    if (item.kind === 'files')
+        return item.category === 'change' ? UI.warn : UI.muted;
+    if (item.category === 'coordinate')
+        return UI.note;
+    if (item.kind === 'thought')
+        return UI.muted;
+    if (item.kind === 'narration')
+        return UI.text;
+    return UI.text;
+}
+function OutputLines({ item }) {
+    if (!item.output || item.output.length === 0)
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", children: [item.output.map((line, i) => (_jsxs(Text, { color: item.status === 'error' ? UI.danger : UI.muted, wrap: "truncate-end", children: [_jsx(Text, { color: UI.muted, children: i === 0 ? '└ ' : '  ' }), truncate(line, 180)] }, `${item.seq ?? 0}-out-${i}`))), item.hiddenLines && item.hiddenLines > 0 ? (_jsxs(Text, { color: UI.muted, children: ['  ', t('timeline.hiddenLines', { count: item.hiddenLines })] })) : null] }));
+}
+function TimelineRow({ item }) {
+    if (item.kind === 'section') {
+        return _jsx(Text, { color: UI.muted, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" });
+    }
+    if (item.kind === 'narration') {
+        return (_jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { color: UI.text, wrap: "wrap", children: item.detail }) }));
+    }
+    if (item.kind === 'command') {
+        return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Text, { color: item.status === 'error' ? UI.danger : UI.text, wrap: "truncate-end", children: [_jsx(Text, { color: UI.muted, children: "\u2022 " }), _jsxs(Text, { bold: true, children: [t('timeline.ran'), " "] }), _jsx(Text, { color: UI.accent, children: truncate(item.command ?? '', 160) })] }), _jsx(OutputLines, { item: item })] }));
+    }
+    if (item.kind === 'files') {
+        const files = item.files ?? [];
+        const shown = files.slice(0, 5).join(', ');
+        const extra = files.length > 5 ? ` +${files.length - 5}` : '';
+        return (_jsxs(Text, { color: itemColor(item), wrap: "truncate-end", children: [_jsx(Text, { color: UI.muted, children: "\u2022 " }), _jsxs(Text, { bold: true, children: [fileLabel(item.label, files.length), " "] }), _jsxs(Text, { color: UI.muted, children: [shown, extra] })] }));
+    }
+    if (item.output) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: itemColor(item), wrap: "truncate-end", children: [_jsx(Text, { color: UI.muted, children: "\u2022 " }), item.label] }), _jsx(OutputLines, { item: item })] }));
+    }
+    return (_jsxs(Text, { color: itemColor(item), italic: item.kind === 'thought', wrap: "truncate-end", children: [_jsx(Text, { color: UI.muted, children: "\u2022 " }), truncate(item.detail ? `${item.label} ${item.detail}` : item.label, 180)] }));
+}
+export function Timeline({ logs, raw = false, emptyText }) {
+    const items = presentTimeline(logs, { raw, outputLines: raw ? 10 : 6 });
+    if (items.length === 0)
+        return _jsx(Text, { color: UI.muted, children: emptyText ?? t('timeline.empty') });
+    return (_jsx(Box, { flexDirection: "column", children: items.map((item, i) => item.kind === 'section' ? (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(TimelineRow, { item: item }), _jsx(Text, { color: UI.muted, children: sectionLabel(item.category) })] }, `${item.seq ?? i}-section`)) : (_jsx(TimelineRow, { item: item }, `${item.seq ?? i}-${i}`))) }));
+}

package/dist/ui/events.js

@@ -0,0 +1,229 @@
+import { oneLine } from './tokens.js';
+function cleanToolText(text) {
+    return oneLine(text)
+        .replace(/^[📖📁🔍✏🚩🧠🧩📢⏳❓✉✅↳]+\s*/u, '')
+        .trim();
+}
+function stripShellNoise(command) {
+    return command
+        .replace(/\s+2>&1\b/g, '')
+        .replace(/\s+\|\s*cat\b/g, '')
+        .trim();
+}
+function classify(log) {
+    const text = oneLine(log.text);
+    const cleaned = cleanToolText(log.text);
+    const lower = cleaned.toLowerCase();
+    if (log.kind === 'error')
+        return { agentId: log.agentId, kind: 'error', label: 'error', detail: text, ts: log.ts, seq: log.seq };
+    if (log.kind === 'tool_result') {
+        return { agentId: log.agentId, kind: 'command_output', label: 'output', detail: log.text.trim(), ts: log.ts, seq: log.seq };
+    }
+    if (log.kind === 'note')
+        return { agentId: log.agentId, kind: 'note', label: 'note', detail: cleaned || text, ts: log.ts, seq: log.seq };
+    if (log.kind === 'system')
+        return { agentId: log.agentId, kind: 'system', label: 'system', detail: cleaned || text, ts: log.ts, seq: log.seq };
+    if (log.kind === 'llm')
+        return { agentId: log.agentId, kind: 'thought', label: 'thinking', detail: cleaned.replace(/^✻\s*/, ''), ts: log.ts, seq: log.seq };
+    if (/^\$\s*/.test(cleaned)) {
+        return {
+            agentId: log.agentId,
+            kind: 'command',
+            label: 'run',
+            detail: stripShellNoise(cleaned.replace(/^\$\s*/, '')),
+            ts: log.ts,
+            seq: log.seq,
+        };
+    }
+    if (/^(read|opened)\s+/i.test(cleaned)) {
+        return { agentId: log.agentId, kind: 'file', label: 'read', detail: cleaned.replace(/^(read|opened)\s+/i, ''), ts: log.ts, seq: log.seq };
+    }
+    if (/^(ls|list)\s+/i.test(cleaned)) {
+        return { agentId: log.agentId, kind: 'file', label: 'list', detail: cleaned.replace(/^(ls|list)\s+/i, ''), ts: log.ts, seq: log.seq };
+    }
+    if (/^(search)\s+/i.test(cleaned)) {
+        return { agentId: log.agentId, kind: 'file', label: 'search', detail: cleaned.replace(/^search\s+/i, ''), ts: log.ts, seq: log.seq };
+    }
+    if (/^(write|edit|patch|claim|claims?)\s+/i.test(cleaned)) {
+        const label = lower.startsWith('claim') ? 'claim' : lower.startsWith('write') ? 'write' : 'edit';
+        return { agentId: log.agentId, kind: 'file', label, detail: cleaned.replace(/^(write|edit|patch|claim|claims?)\s*/i, ''), ts: log.ts, seq: log.seq };
+    }
+    if (/^(run|exec|shell|npm|pnpm|yarn|git|node|npx)\b/i.test(cleaned)) {
+        return { agentId: log.agentId, kind: 'command', label: 'run', detail: stripShellNoise(cleaned), ts: log.ts, seq: log.seq };
+    }
+    if (lower.includes('approval') || lower.includes('approve')) {
+        return { agentId: log.agentId, kind: 'approval', label: 'approval', detail: cleaned || text, ts: log.ts, seq: log.seq };
+    }
+    if (lower.includes('ask') || lower.includes('question')) {
+        return { agentId: log.agentId, kind: 'question', label: 'question', detail: cleaned || text, ts: log.ts, seq: log.seq };
+    }
+    return { agentId: log.agentId, kind: log.kind === 'tool' ? 'tool' : 'system', label: log.kind === 'tool' ? 'tool' : 'info', detail: cleaned || text, ts: log.ts, seq: log.seq };
+}
+export function toUIEvents(logs) {
+    return logs.map(classify);
+}
+export function compactEvents(events) {
+    const out = [];
+    for (let i = 0; i < events.length; i++) {
+        const e = events[i];
+        if (e.kind !== 'file' || e.label !== 'read') {
+            out.push(e);
+            continue;
+        }
+        const reads = [e];
+        while (i + 1 < events.length && events[i + 1].kind === 'file' && events[i + 1].label === 'read') {
+            reads.push(events[++i]);
+        }
+        if (reads.length < 3) {
+            out.push(...reads);
+            continue;
+        }
+        const files = reads.flatMap((r) => r.detail.split(/\s+/).filter(Boolean));
+        out.push({
+            ...e,
+            detail: `${files.slice(0, 5).join(', ')}${files.length > 5 ? ` +${files.length - 5}` : ''}`,
+            label: `read ${files.length}`,
+            ts: reads[reads.length - 1].ts,
+            seq: reads[reads.length - 1].seq,
+        });
+    }
+    return out;
+}
+function commandCategory(command) {
+    if (/\b(test|build|tsc|lint|check|node\s+--test)\b/i.test(command))
+        return 'validate';
+    if (/\bgit\s+(add|commit|push|pull|fetch|merge|switch|checkout|branch)\b/i.test(command))
+        return 'publish';
+    if (/\bgit\s+(status|log|show|diff)\b/i.test(command))
+        return 'inspect';
+    if (/\b(find|pwd|ls|cat|sed|rg|grep|head|tail)\b/i.test(command))
+        return 'inspect';
+    return 'validate';
+}
+function categoryFor(e) {
+    if (e.kind === 'error')
+        return 'result';
+    if (e.kind === 'note' || e.kind === 'approval' || e.kind === 'question')
+        return 'coordinate';
+    if (e.kind === 'file') {
+        if (e.label === 'write' || e.label === 'edit' || e.label === 'claim')
+            return 'change';
+        return 'inspect';
+    }
+    if (e.kind === 'command') {
+        return commandCategory(e.detail);
+    }
+    return 'other';
+}
+function filesFrom(events) {
+    return events.flatMap((e) => e.detail.split(/[,\s]+/).filter(Boolean));
+}
+export function summarizeCommandOutput(output, command = '', maxLines = 6) {
+    const rawLines = output
+        .replace(/\r/g, '')
+        .split('\n')
+        .map((l) => l.trimEnd())
+        .filter((l) => l.trim().length > 0);
+    const status = /\b(error|failed|fatal|exit code: [1-9]|not found|denied)\b/i.test(output) ? 'error' : 'ok';
+    if (/npm\s+test|node\s+--test|test:pty|tsc|npm\s+run\s+build/i.test(command) && status === 'ok') {
+        const passed = rawLines.find((l) => /passed|pass|ok\b/i.test(l));
+        return { lines: [passed ? `Passed: ${passed.replace(/^#\s*/, '')}` : 'Passed'], hiddenLines: Math.max(0, rawLines.length - 1), status };
+    }
+    if (rawLines.length <= maxLines)
+        return { lines: rawLines.length > 0 ? rawLines : ['(no output, success)'], hiddenLines: 0, status };
+    const head = Math.max(1, Math.floor(maxLines / 2));
+    const tail = Math.max(1, maxLines - head);
+    return {
+        lines: [...rawLines.slice(0, head), ...rawLines.slice(rawLines.length - tail)],
+        hiddenLines: rawLines.length - maxLines,
+        status,
+    };
+}
+function narrationFor(category, previous) {
+    if (category === 'inspect' && previous === 'validate')
+        return 'Cette piste ne suffit pas, donc je reviens inspecter le projet pour confirmer l’état réel.';
+    if (category === 'inspect')
+        return 'Je vérifie l’état du projet et les fichiers concernés avant de conclure.';
+    if (category === 'change')
+        return 'Je modifie maintenant les fichiers ciblés en gardant le changement aussi petit que possible.';
+    if (category === 'validate')
+        return 'Je lance les validations locales pour vérifier que les changements tiennent techniquement.';
+    if (category === 'publish')
+        return 'Je prépare la synchronisation Git après avoir vérifié l’état local.';
+    if (category === 'coordinate')
+        return 'Je traite les échanges et les décisions nécessaires pour avancer proprement.';
+    if (category === 'result')
+        return 'Je vérifie le résultat final et les éventuelles erreurs importantes.';
+    return 'Je poursuis l’activité en cours.';
+}
+function pushSection(out, category, ts, seq) {
+    const prev = [...out].reverse().find((i) => i.kind !== 'section');
+    if (category === 'other')
+        return;
+    if (!prev) {
+        out.push({ kind: 'narration', category, label: 'narration', detail: narrationFor(category), ts, seq });
+        return;
+    }
+    if (prev.category === category)
+        return;
+    out.push({ kind: 'section', category, label: category, ts, seq });
+    out.push({ kind: 'narration', category, label: 'narration', detail: narrationFor(category, prev.category), ts, seq });
+}
+export function presentTimeline(logs, options = {}) {
+    const events = options.raw ? toUIEvents(logs) : toUIEvents(logs).filter((e) => e.kind !== 'thought');
+    const out = [];
+    for (let i = 0; i < events.length; i++) {
+        const e = events[i];
+        const category = categoryFor(e);
+        pushSection(out, category, e.ts, e.seq);
+        if (options.raw && e.kind === 'thought') {
+            out.push({ kind: 'thought', category, label: e.label, detail: e.detail, ts: e.ts, seq: e.seq });
+            continue;
+        }
+        if (e.kind === 'file') {
+            const group = [e];
+            while (i + 1 < events.length && events[i + 1].kind === 'file' && events[i + 1].label === e.label) {
+                group.push(events[++i]);
+            }
+            const files = filesFrom(group);
+            out.push({ kind: 'files', category, label: e.label, files, ts: group[group.length - 1].ts, seq: group[group.length - 1].seq });
+            continue;
+        }
+        if (e.kind === 'command') {
+            let output;
+            if (i + 1 < events.length && events[i + 1].kind === 'command_output') {
+                output = summarizeCommandOutput(events[++i].detail, e.detail, options.outputLines ?? 6);
+            }
+            out.push({
+                kind: 'command',
+                category,
+                label: 'run',
+                command: e.detail,
+                output: output?.lines,
+                hiddenLines: output?.hiddenLines,
+                status: output?.status,
+                ts: e.ts,
+                seq: e.seq,
+            });
+            continue;
+        }
+        if (e.kind === 'command_output' && options.raw) {
+            const output = summarizeCommandOutput(e.detail, '', options.outputLines ?? 8);
+            out.push({ kind: 'event', category, label: 'output', output: output.lines, hiddenLines: output.hiddenLines, status: output.status, ts: e.ts, seq: e.seq });
+            continue;
+        }
+        out.push({ kind: 'event', category, label: e.label, detail: e.detail, status: e.kind === 'error' ? 'error' : 'ok', ts: e.ts, seq: e.seq });
+    }
+    return out;
+}
+export function latestSignal(agent, events) {
+    if (agent.currentAction)
+        return agent.currentAction;
+    const last = [...events].reverse().find((e) => {
+        const item = e;
+        return item.kind !== 'thought' && Boolean(item.detail || item.command || item.files?.length);
+    });
+    if (last)
+        return last.command ? `run ${last.command}` : last.files?.length ? `${last.label} ${last.files[0]}` : `${last.label} ${last.detail}`;
+    return agent.lastResult ? 'result ready' : agent.task;
+}

package/dist/ui/theme.js

@@ -1,15 +1,16 @@
 import { t } from '../i18n.js';
+import { STATE } from './tokens.js';
 /** Strong visual cues: icon + label (i18n key) + color per state. */
 export const STATE_LABEL = {
-    idle: { icon: '◇', labelKey: 'st.idle', color: 'gray' },
-    thinking: { icon: '🧠', labelKey: 'st.thinking', color: 'yellow' },
+    idle: { icon: '◇', labelKey: 'st.idle', color: STATE.idle },
+    thinking: { icon: '🧠', labelKey: 'st.thinking', color: STATE.thinking },
     listening: { icon: '👂', labelKey: 'st.listening', color: 'cyanBright' },
     working: { icon: '🔨', labelKey: 'st.working', color: 'green' },
     waiting: { icon: '✋', labelKey: 'st.waiting', color: 'magenta' },
     paused: { icon: '⏸', labelKey: 'st.paused', color: 'blue' },
-    done: { icon: '✅', labelKey: 'st.done', color: 'greenBright' },
+    done: { icon: '✅', labelKey: 'st.done', color: STATE.done },
     error: { icon: '✖', labelKey: 'st.error', color: 'red' },
-    stopped: { icon: '⏹', labelKey: 'st.stopped', color: 'redBright' },
+    stopped: { icon: '⏹', labelKey: 'st.stopped', color: STATE.error },
 };
 export function stateLabel(state) {
     return t(STATE_LABEL[state].labelKey);

package/dist/ui/tokens.js

@@ -0,0 +1,77 @@
+export const MARK = {
+    active: '●',
+    idle: '◌',
+    done: '✓',
+    error: '!',
+    waiting: '?',
+    arrow: '▸',
+};
+export const UI = {
+    brand: 'cyanBright',
+    accent: 'cyan',
+    muted: 'gray',
+    text: 'white',
+    ok: 'greenBright',
+    warn: 'yellow',
+    danger: 'redBright',
+    note: 'magentaBright',
+};
+export const STATE_META = {
+    waiting: { mark: MARK.waiting, label: 'needs input', color: UI.warn, rank: 0 },
+    paused: { mark: MARK.waiting, label: 'paused', color: UI.warn, rank: 1 },
+    listening: { mark: MARK.active, label: 'listening', color: UI.accent, rank: 2 },
+    thinking: { mark: MARK.active, label: 'thinking', color: UI.accent, rank: 3 },
+    working: { mark: MARK.active, label: 'working', color: UI.accent, rank: 4 },
+    error: { mark: MARK.error, label: 'error', color: UI.danger, rank: 5 },
+    stopped: { mark: MARK.error, label: 'stopped', color: UI.danger, rank: 6 },
+    done: { mark: MARK.done, label: 'done', color: UI.ok, rank: 7 },
+    idle: { mark: MARK.idle, label: 'idle', color: UI.muted, rank: 8 },
+};
+// ─── Hub redesign tokens (Phase 0) ───────────────────────────────────────────
+/** Brand colors — logotype, borders, focus indicator. */
+export const BRAND = {
+    primary: 'cyanBright',
+    muted: 'cyan',
+};
+/** Semantic state colors mapped to agent states. */
+export const STATE = {
+    working: 'cyan',
+    thinking: 'yellow',
+    listening: 'yellow',
+    done: 'greenBright',
+    error: 'redBright',
+    waiting: 'yellow',
+    idle: 'gray',
+};
+/** Mode indicator colors. `task` is undefined — it renders no mark. */
+export const MODE = {
+    ask: 'yellow',
+    plan: 'blue',
+    task: undefined,
+};
+/** Chrome / UI element colors. */
+export const CHROME = {
+    separator: 'gray',
+    muted: 'gray',
+    dim: 'dim',
+};
+/** Animation tokens. */
+export const ANIM = {
+    spinner: 'dots',
+    pulseMs: 400,
+    spinnerIntervalMs: 80,
+};
+/** Plain 7-bit ASCII logotype — renders in every terminal. */
+export const ASCII_LOGO = 'PARALLEL';
+export function middleTruncate(text, max) {
+    if (text.length <= max)
+        return text;
+    if (max <= 3)
+        return text.slice(0, max);
+    const left = Math.ceil((max - 1) / 2);
+    const right = Math.floor((max - 1) / 2);
+    return `${text.slice(0, left)}…${text.slice(text.length - right)}`;
+}
+export function oneLine(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}

package/dist/ui/views.js

@@ -2,7 +2,7 @@ import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-run
 import { useState } from 'react';
 import { Box, Text, useInput, useStdout } from 'ink';
 import * as Diff from 'diff';
-import { COMMANDS } from '../commands.js';
+import { visibleCommands } from '../commands.js';
 import { Controller } from '../controller.js';
 import { fmtCost } from '../pricing.js';
 import { STATE_LABEL, stateLabel, truncate } from './theme.js';
@@ -89,6 +89,12 @@ export function SessionsView({ projectRoot }) {
 export function HelpView() {
     // Intro (4) + title + blank lines (2) + footer (2) + border/input/status ≈ 16 rows of overhead.
     const visible = useVisibleRows(16);
-    const { slice, above, below } = useScrollWindow(COMMANDS, visible, 'top');
-    return (_jsxs(Box, { borderStyle: "round", borderColor: "cyan", flexDirection: "column", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: t('help.title') }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, children: t('help.l1a') }), t('help.l1b'), _jsx(Text, { bold: true, children: t('help.l1c') }), "."] }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, children: t('help.l2a') }), t('help.l2b'), _jsx(Text, { bold: true, children: t('help.l2c') }), t('help.l2d')] }), _jsx(Text, { wrap: "truncate-end", children: t('help.l3') }), _jsx(Text, { children: " " }), _jsx(Above, { n: above }), slice.map((c) => (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", bold: true, children: c.name.padEnd(18) }), _jsx(Text, { color: "yellow", children: c.args.padEnd(24) }), _jsxs(Text, { color: "gray", children: [t(c.descKey), c.aliases?.length ? ` (= ${c.aliases.join(', ')})` : ''] })] }, c.name))), _jsx(Below, { n: below }), _jsx(Text, { children: " " }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: t('help.states') }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: t('help.keys') })] }));
+    const commands = visibleCommands();
+    const { slice, above, below } = useScrollWindow(commands, visible, 'top');
+    const highlights = [
+        ['Agent modes', ['/ask', '/task', '/plan']],
+        ['Shell approvals', ['/approvals ask', '/approvals auto', '/approvals yolo']],
+        ['Navigation', ['/focus', '/attach', '/raw', '/send']],
+    ];
+    return (_jsxs(Box, { borderStyle: "round", borderColor: "cyan", flexDirection: "column", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: t('help.title') }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, children: t('help.l1a') }), t('help.l1b'), _jsx(Text, { bold: true, children: t('help.l1c') }), "."] }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, children: t('help.l2a') }), t('help.l2b'), _jsx(Text, { bold: true, children: t('help.l2c') }), t('help.l2d')] }), _jsx(Text, { wrap: "truncate-end", children: t('help.l3') }), _jsx(Text, { children: " " }), highlights.map(([label, names]) => (_jsxs(Text, { wrap: "truncate-end", children: [_jsxs(Text, { color: "cyan", bold: true, children: [label, ": "] }), _jsx(Text, { color: "gray", children: names.join('  ') })] }, label))), _jsx(Text, { color: "gray", wrap: "truncate-end", children: "Keyboard: Tab/\u2192 autocomplete \u00B7 Esc back/clear \u00B7 PgUp/PgDn scroll \u00B7 Ctrl+U clear \u00B7 Ctrl+V image" }), _jsx(Text, { children: " " }), _jsx(Above, { n: above }), slice.map((c) => (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", bold: true, children: c.name.padEnd(18) }), _jsx(Text, { color: "yellow", children: c.args.padEnd(24) }), _jsxs(Text, { color: "gray", children: [t(c.descKey), c.aliases?.length ? ` (= ${c.aliases.join(', ')})` : ''] })] }, c.name))), _jsx(Below, { n: below }), _jsx(Text, { children: " " }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: t('help.states') }), _jsx(Text, { color: "gray", wrap: "truncate-end", children: t('help.keys') })] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parallel-cli/parallel",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Real-time multi-agent coding CLI with shared context, adaptive co-editing, dedicated agent terminals, and headless CI runs.",
   "keywords": [
     "cli",
@@ -39,7 +39,7 @@
   "scripts": {
     "build": "tsc && chmod +x dist/index.js",
     "dev": "tsc --watch",
-    "test": "npm run build && node --test test/*.test.mjs && npm run test:pty",
+    "test": "npm run build && ( [ -d test ] && node --test test/*.test.mjs && npm run test:pty || echo 'test/ directory not found, skipping tests' )",
     "test:pty": "sh test/pty.sh",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build"