soja-cli 1.4.0

package/dist/ui/screens/WelcomeScreen.js

@@ -0,0 +1,254 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text, useApp } from 'ink';
+import { useMemo, useState } from 'react';
+import { FileConfigStore } from '../../config/config.js';
+import { CredentialStore } from '../../config/credentials.js';
+import { resolvePaths } from '../../config/paths.js';
+import { DEFAULT_SERVER_URL, isSecureServerUrl } from '../../config/server.js';
+import { ApiClient } from '../../data/remote/api-client.js';
+import { SojaError, ValidationError } from '../../domain/errors.js';
+import { toDisplayError } from '../../utils/errors.js';
+import { Splash } from '../branding/Splash.js';
+import { Button } from '../kit/Button.js';
+import { Panel } from '../kit/Panel.js';
+import { Spinner } from '../kit/Spinner.js';
+import { TextField } from '../components/TextField.js';
+import { Layer } from '../input/dispatcher.js';
+import { useKeys } from '../input/KeyProvider.js';
+import { useTerminalSize } from '../hooks/use-terminal-size.js';
+import { palette } from '../theme/theme.js';
+const sleep = (seconds) => new Promise((resolve) => setTimeout(resolve, seconds * 1000));
+/** First-run choice between private local data and the GitHub-backed team service. */
+export function WelcomeScreen({ onLocal }) {
+    const { exit } = useApp();
+    const { columns, rows } = useTerminalSize();
+    const paths = resolvePaths();
+    const config = useMemo(() => new FileConfigStore(paths.configFile), [paths.configFile]);
+    const credentials = useMemo(() => new CredentialStore(paths.credentialsFile), [paths.credentialsFile]);
+    const [stage, setStage] = useState('choose');
+    const server = config.load()?.remote?.apiUrl ?? DEFAULT_SERVER_URL;
+    const [message, setMessage] = useState('');
+    const [error, setError] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [device, setDevice] = useState(null);
+    const [user, setUser] = useState(null);
+    const [countries, setCountries] = useState([]);
+    const [field, setField] = useState(0);
+    const [values, setValues] = useState(['', '', '', '']);
+    const [selectedCountry, setSelectedCountry] = useState(null);
+    const [countryCursor, setCountryCursor] = useState(0);
+    const [workspaceChoices, setWorkspaceChoices] = useState([]);
+    const [workspaceName, setWorkspaceName] = useState('');
+    const filtered = useMemo(() => countries.filter((country) => country.name.toLocaleLowerCase().includes((values[3] ?? '').toLocaleLowerCase())).slice(0, 10), [countries, values]);
+    const chooseLocal = () => {
+        const current = config.load();
+        if (current?.mode === 'remote')
+            config.save({ ...current, mode: 'local' });
+        onLocal();
+    };
+    const signIn = async () => {
+        setBusy(true);
+        setError('');
+        setStage('waiting');
+        try {
+            const base = server.trim().replace(/\/$/, '');
+            if (!isSecureServerUrl(base))
+                throw new ValidationError('El servidor SOJA debe usar HTTPS. Solo se permite HTTP en localhost durante el desarrollo.');
+            const api = new ApiClient(base, null);
+            const started = await api.post('/v1/auth/device');
+            setDevice({ uri: started.verificationUri, code: started.userCode });
+            const deadline = Date.now() + started.expiresIn * 1000;
+            let interval = started.interval;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                const poll = await api.postWithStatus('/v1/auth/device/token', { deviceCode: started.deviceCode });
+                if (poll.status === 202) {
+                    if (poll.body.status === 'slow_down')
+                        interval += 5;
+                    continue;
+                }
+                if (!poll.body.token || !poll.body.user)
+                    throw new SojaError('El backend no devolvió una sesión.');
+                const accountApi = new ApiClient(base, poll.body.token);
+                const account = await accountApi.get('/v1/me');
+                credentials.save(base, poll.body.token, poll.body.user.username);
+                setUser(account.user);
+                if (account.user.accessStatus === 'approved') {
+                    if (account.workspaces.length > 1) {
+                        setWorkspaceChoices(account.workspaces);
+                        config.save({ parentFolders: [], ...config.load(), mode: 'local', remote: { apiUrl: base, userId: account.user.id } });
+                        setStage('workspace');
+                        setBusy(false);
+                        return;
+                    }
+                    if (account.workspaces.length === 0) {
+                        config.save({ parentFolders: [], ...config.load(), mode: 'local', remote: { apiUrl: base, userId: account.user.id } });
+                        setStage('newworkspace');
+                        setBusy(false);
+                        return;
+                    }
+                    const workspaceId = account.workspaces[0]?.id;
+                    config.save({ parentFolders: [], ...config.load(), mode: 'remote', remote: { apiUrl: base, userId: account.user.id, ...(workspaceId ? { workspaceId } : {}) } });
+                    setMessage('Acceso aprobado. Abriendo SOJA Online…');
+                    setTimeout(() => exit(), 500);
+                    return;
+                }
+                if (account.user.accessStatus === 'rejected') {
+                    setMessage('La solicitud anterior fue rechazada. Puedes presentar una nueva.');
+                }
+                const countryResult = await accountApi.get('/v1/auth/countries');
+                setCountries(countryResult.countries);
+                setValues([account.user.displayName, '', '', '']);
+                setStage('profile');
+                setBusy(false);
+                return;
+            }
+            throw new SojaError('El código de GitHub expiró; vuelve a iniciar sesión.');
+        }
+        catch (failure) {
+            setError(toDisplayError(failure).message);
+            setStage('error');
+            setBusy(false);
+        }
+    };
+    const selectWorkspace = (index) => {
+        const workspace = workspaceChoices[index];
+        if (!workspace || !user)
+            return;
+        const base = server.trim().replace(/\/$/, '');
+        config.save({ parentFolders: [], ...config.load(), mode: 'remote', remote: { apiUrl: base, userId: user.id, workspaceId: workspace.id } });
+        setMessage(`Workspace ${workspace.name} seleccionado. Abriendo SOJA Online…`);
+        setTimeout(() => exit(), 500);
+    };
+    const createWorkspace = async () => {
+        if (!user || !workspaceName.trim()) {
+            setError('Escribe un nombre para tu workspace.');
+            return;
+        }
+        const base = server.trim().replace(/\/$/, '');
+        const token = credentials.token(base);
+        if (!token) {
+            setError('No encontré la sesión guardada.');
+            return;
+        }
+        setBusy(true);
+        setError('');
+        try {
+            const created = await new ApiClient(base, token).post('/v1/workspaces', { name: workspaceName.trim() });
+            config.save({ parentFolders: [], ...config.load(), mode: 'remote', remote: { apiUrl: base, userId: user.id, workspaceId: created.id } });
+            setTimeout(() => exit(), 400);
+        }
+        catch (failure) {
+            setError(toDisplayError(failure).message);
+            setBusy(false);
+        }
+    };
+    const submitProfile = async () => {
+        if (!user || !selectedCountry) {
+            setError('Selecciona un país de la lista.');
+            return;
+        }
+        if (Array.from(values[2] ?? '').length > 100) {
+            setError('La carta no puede superar 100 caracteres.');
+            return;
+        }
+        const base = server.trim().replace(/\/$/, '');
+        const token = credentials.token(base);
+        if (!token) {
+            setError('No encontré la sesión guardada. Ejecuta `soja login`.');
+            return;
+        }
+        setBusy(true);
+        setError('');
+        try {
+            await new ApiClient(base, token).post('/v1/access-request', { displayName: values[0], dateOfBirth: values[1], letter: values[2], countryCode: selectedCountry.code });
+            const current = config.load();
+            config.save({ parentFolders: [], ...current, mode: 'local', remote: { apiUrl: base, userId: user.id } });
+            setMessage('Solicitud enviada. SOJA queda en modo local hasta que el CEO apruebe tu acceso.');
+            setStage('error');
+            setBusy(false);
+        }
+        catch (failure) {
+            setError(toDisplayError(failure).message);
+            setBusy(false);
+        }
+    };
+    useKeys(Layer.screen, (input, key) => {
+        if (stage === 'choose') {
+            if (input === '1' || input.toLowerCase() === 'l') {
+                chooseLocal();
+                return true;
+            }
+            if (input === '2' || input.toLowerCase() === 'g') {
+                void signIn();
+                return true;
+            }
+        }
+        if (stage === 'error' && key.escape) {
+            setStage('choose');
+            setError('');
+            setMessage('');
+            return true;
+        }
+        if (stage === 'workspace') {
+            if (key.upArrow) {
+                setCountryCursor((n) => Math.max(0, n - 1));
+                return true;
+            }
+            if (key.downArrow) {
+                setCountryCursor((n) => Math.min(workspaceChoices.length - 1, n + 1));
+                return true;
+            }
+            if (key.return) {
+                selectWorkspace(countryCursor);
+                return true;
+            }
+            if (/^[1-9]$/.test(input)) {
+                selectWorkspace(Number(input) - 1);
+                return true;
+            }
+        }
+        if (stage === 'newworkspace') {
+            if (key.return) {
+                void createWorkspace();
+                return true;
+            }
+            if (key.escape) {
+                setStage('choose');
+                return true;
+            }
+        }
+        if (stage === 'profile') {
+            if (field === 3 && key.upArrow) {
+                setCountryCursor((n) => Math.max(0, n - 1));
+                return true;
+            }
+            if (field === 3 && key.downArrow) {
+                setCountryCursor((n) => Math.min(filtered.length - 1, n + 1));
+                return true;
+            }
+            if (field === 3 && key.return && filtered[countryCursor]) {
+                setSelectedCountry(filtered[countryCursor] ?? null);
+                setField(4);
+                return true;
+            }
+            if (key.return) {
+                if (field < 3)
+                    setField(field + 1);
+                else if (field === 4)
+                    void submitProfile();
+                return true;
+            }
+            if (key.escape) {
+                if (field > 0)
+                    setField(field - 1);
+                else
+                    setStage('choose');
+                return true;
+            }
+        }
+        return false;
+    }, true);
+    const width = Math.max(36, Math.min(76, columns - 4));
+    return (_jsx(Box, { width: columns, height: rows, alignItems: "center", justifyContent: "center", children: _jsxs(Box, { flexDirection: "column", width: width, children: [_jsx(Box, { justifyContent: "center", children: _jsx(Splash, { compact: true }) }), stage === 'choose' ? _jsxs(Panel, { title: "Welcome to SOJA", focused: true, width: width, children: [_jsx(Text, { color: palette.text, children: "Choose how you want to work." }), _jsx(Box, { marginTop: 1, children: _jsx(Button, { label: "Sign in with GitHub", variant: "primary", layer: Layer.screen, onPress: () => void signIn() }) }), _jsx(Box, { marginTop: 1, children: _jsx(Button, { label: "Local mode", layer: Layer.screen, onPress: chooseLocal }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: palette.muted, children: "Local mode keeps tasks on this machine and has no team chat." }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: palette.faint, children: "g GitHub \u00B7 l local \u00B7 enter select" }) })] }) : null, stage === 'waiting' ? _jsxs(Panel, { title: "Sign in with GitHub", focused: true, width: width, children: [device ? _jsxs(_Fragment, { children: [_jsxs(Text, { children: ["Open ", device.uri] }), _jsxs(Text, { bold: true, color: palette.accent, children: ["Enter code: ", device.code] })] }) : _jsx(Text, { children: "Connecting to SOJA\u2026" }), _jsx(Box, { marginTop: 1, children: _jsx(Spinner, { label: "Waiting for GitHub authorization\u2026" }) })] }) : null, stage === 'workspace' ? _jsxs(Panel, { title: "Choose a workspace", focused: true, width: width, children: [_jsx(Text, { color: palette.muted, children: "Your account belongs to multiple workspaces." }), workspaceChoices.map((workspace, index) => _jsx(Text, { color: index === countryCursor ? palette.accent : palette.text, children: `${index === countryCursor ? '›' : ' '} ${index + 1}. ${workspace.name}` }, workspace.id)), _jsx(Text, { color: palette.faint, children: "\u2191/\u2193 move \u00B7 enter or 1\u20139 select" })] }) : null, stage === 'newworkspace' ? _jsxs(Panel, { title: "Create your first workspace", focused: true, width: width, children: [_jsx(Text, { color: palette.muted, children: "Your account is approved. Name the workspace you own." }), _jsx(TextField, { value: workspaceName, onChange: setWorkspaceName, placeholder: "My team", width: width - 6 }), error ? _jsx(Text, { color: palette.danger, children: error }) : null, _jsx(Text, { color: palette.faint, children: "enter create \u00B7 esc back" })] }) : null, stage === 'profile' ? _jsxs(Panel, { title: "Request SOJA access", aside: `${field + 1}/5`, focused: true, width: width, children: [_jsx(Text, { color: palette.muted, children: "Your session is restricted until CEO approval." }), field === 0 ? _jsxs(_Fragment, { children: [_jsx(Text, { children: "Name" }), _jsx(TextField, { value: values[0] ?? '', onChange: (v) => setValues((old) => [v, old[1] ?? '', old[2] ?? '', old[3] ?? '']), placeholder: "Full name", width: width - 6 })] }) : null, field === 1 ? _jsxs(_Fragment, { children: [_jsx(Text, { children: "Date of birth (YYYY-MM-DD)" }), _jsx(TextField, { value: values[1] ?? '', onChange: (v) => setValues((old) => [old[0] ?? '', v, old[2] ?? '', old[3] ?? '']), placeholder: "2000-01-31", width: width - 6 })] }) : null, field === 2 ? _jsxs(_Fragment, { children: [_jsxs(Text, { children: ["Why are you interested in SOJA? (max 100 characters \u00B7 ", Array.from(values[2] ?? '').length, "/100)"] }), _jsx(TextField, { value: values[2] ?? '', onChange: (v) => setValues((old) => [old[0] ?? '', old[1] ?? '', Array.from(v).slice(0, 100).join(''), old[3] ?? '']), placeholder: "I want to\u2026", width: width - 6 })] }) : null, field === 3 ? _jsxs(_Fragment, { children: [_jsx(Text, { children: "Country \u00B7 type to search, \u2191/\u2193 and enter to select" }), _jsx(TextField, { value: values[3] ?? '', onChange: (v) => { setCountryCursor(0); setSelectedCountry(null); setValues((old) => [old[0] ?? '', old[1] ?? '', old[2] ?? '', v]); }, placeholder: "Search countries", width: width - 6 }), filtered.map((country, index) => _jsx(Text, { color: index === countryCursor ? palette.accent : palette.muted, children: `${index === countryCursor ? '›' : ' '} ${country.flag} ${country.name}` }, country.code))] }) : null, field === 4 ? _jsxs(Text, { children: ["Country selected: ", selectedCountry?.flag, " ", selectedCountry?.name] }) : null, error ? _jsx(Text, { color: palette.danger, children: error }) : null, _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: palette.faint, children: ["enter next \u00B7 esc back ", busy ? '· saving…' : ''] }) })] }) : null, stage === 'error' ? _jsxs(Panel, { title: "SOJA account", focused: true, width: width, children: [error ? _jsx(Text, { color: palette.danger, children: error }) : null, message ? _jsx(Text, { color: palette.text, children: message }) : null, _jsx(Box, { marginTop: 1, children: _jsx(Button, { label: "Back", layer: Layer.screen, onPress: () => { setStage('choose'); setError(''); setMessage(''); } }) })] }) : null, stage === 'profile' && error ? _jsx(Text, { color: palette.danger, children: error }) : null] }) }));
+}

package/dist/ui/screens/WorkspacesScreen.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { useAppState } from '../app-state.js';
+import { useFlows } from '../hooks/use-flows.js';
+import { useLayout } from '../hooks/use-layout.js';
+import { useList } from '../hooks/use-list.js';
+import { useQuery } from '../hooks/use-query.js';
+import { Layer } from '../input/dispatcher.js';
+import { useKeys } from '../input/KeyProvider.js';
+import { palette, symbols } from '../theme/theme.js';
+import { Badge } from '../kit/Badge.js';
+import { Clickable } from '../kit/Clickable.js';
+import { Panel } from '../kit/Panel.js';
+import { ScreenFrame } from './ScreenFrame.js';
+export function WorkspacesScreen({ active }) {
+    const { services, session } = useAppState();
+    const { height, width } = useLayout();
+    const data = useQuery(async () => {
+        const [workspaces, members] = await Promise.all([
+            services.workspaces.list(session.user),
+            services.workspaces.members(session),
+        ]);
+        return { workspaces, members };
+    }, `workspaces:${session.workspace.id}`);
+    const workspaces = data.data?.workspaces ?? [];
+    const members = data.data?.members ?? [];
+    const listRows = Math.max(3, Math.min(workspaces.length, height - 6 - Math.min(members.length, 8)));
+    const list = useList(workspaces.length, listRows, true, Math.max(0, workspaces.findIndex((w) => w.id === session.workspace.id)));
+    const flows = useFlows();
+    useKeys(Layer.screen, (input, key) => {
+        if (list.handleKey(input, key))
+            return true;
+        if (key.ctrl || key.meta)
+            return false;
+        const workspace = workspaces[list.index];
+        if (key.return && workspace)
+            void flows.switchWorkspace(workspace.id);
+        else if (input === 'n')
+            flows.newWorkspace();
+        else if (input === 'a')
+            flows.addDeveloper();
+        else
+            return false;
+        return true;
+    }, active);
+    const wide = width >= 80;
+    return (_jsx(ScreenFrame, { title: "Workspaces", aside: `${workspaces.length} workspace${workspaces.length === 1 ? '' : 's'}`, hints: [
+            ['↑↓', 'move'],
+            ['enter', 'switch'],
+            ['n', 'new workspace'],
+            ['a', 'add developer'],
+            ['esc', 'back'],
+        ], children: _jsxs(Box, { flexDirection: wide ? 'row' : 'column', gap: 1, children: [_jsx(Panel, { title: "Your workspaces", flexGrow: 1, children: workspaces.slice(list.offset, list.offset + listRows).map((workspace, position) => {
+                        const index = list.offset + position;
+                        const selected = index === list.index;
+                        const current = workspace.id === session.workspace.id;
+                        const bg = selected ? { backgroundColor: palette.selection } : {};
+                        return (_jsx(Clickable, { active: active, onClick: () => (selected ? void flows.switchWorkspace(workspace.id) : list.select(index)), children: _jsxs(Box, { gap: 1, flexGrow: 1, ...bg, children: [_jsx(Text, { color: palette.accent, children: selected ? symbols.pointer : ' ' }), _jsx(Text, { color: palette.text, bold: selected, wrap: "truncate-end", children: workspace.name }), _jsx(Text, { color: palette.muted, wrap: "truncate-end", children: `${workspace.slug} ${symbols.dot} ${workspace.role}` }), current ? _jsx(Badge, { tone: "success", children: "current" }) : null] }) }, workspace.id));
+                    }) }), _jsxs(Panel, { title: `Developers in ${session.workspace.name}`, aside: `${members.length}`, width: wide ? Math.floor(width * 0.45) : undefined, flexShrink: 0, children: [members.slice(0, 10).map((member) => (_jsxs(Box, { gap: 1, children: [_jsx(Text, { backgroundColor: palette.neutralSoft, color: palette.accent, bold: true, children: ` ${initials(member.displayName)} ` }), _jsx(Text, { color: palette.text, children: `@${member.username}` }), _jsx(Text, { color: palette.muted, wrap: "truncate-end", children: member.displayName }), member.role === 'owner' ? _jsx(Badge, { tone: "info", children: "owner" }) : null] }, member.id))), members.length > 10 ? _jsx(Text, { color: palette.faint, children: `${symbols.ellipsis} and ${members.length - 10} more` }) : null, _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: palette.faint, children: "a adds a developer" }) })] })] }) }));
+}
+function initials(name) {
+    const parts = name.trim().split(/\s+/);
+    return ((parts[0]?.[0] ?? '?') + (parts[1]?.[0] ?? '')).toUpperCase();
+}

package/dist/ui/theme/detect.js

@@ -0,0 +1,59 @@
+/**
+ * Chooses the light or dark palette: `SOJA_THEME`, then `COLORFGBG` (set by
+ * some terminals), then asking the terminal for its background color
+ * (OSC 11, answered by kitty, WezTerm, iTerm2, GNOME Terminal, Alacritty,
+ * Windows Terminal…). Dark when nothing answers.
+ */
+export async function detectThemeMode(env = process.env, io = { stdin: process.stdin, stdout: process.stdout }) {
+    const forced = env.SOJA_THEME?.toLowerCase();
+    if (forced === 'light' || forced === 'dark')
+        return forced;
+    const fromEnv = modeFromColorFgBg(env.COLORFGBG);
+    if (fromEnv)
+        return fromEnv;
+    const background = await queryBackground(io).catch(() => null);
+    return background ?? 'dark';
+}
+/** `COLORFGBG="15;0"`: foreground;background as ANSI indexes (7 and 15 are light). */
+export function modeFromColorFgBg(value) {
+    const background = value?.split(';').at(-1);
+    if (background === undefined || background === '' || Number.isNaN(Number(background)))
+        return null;
+    return ['7', '15'].includes(background) ? 'light' : 'dark';
+}
+/** `rgb:ffff/ffff/ffff` (from OSC 11) → light or dark by perceived luminance. */
+export function modeFromOscReply(reply) {
+    const match = /rgb:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})/i.exec(reply);
+    if (!match)
+        return null;
+    const [r, g, b] = match.slice(1, 4).map((hex) => Number.parseInt(hex, 16) / (16 ** hex.length - 1));
+    const luminance = 0.2126 * (r ?? 0) + 0.7152 * (g ?? 0) + 0.0722 * (b ?? 0);
+    return luminance > 0.5 ? 'light' : 'dark';
+}
+function queryBackground({ stdin, stdout }, timeoutMs = 150) {
+    if (!stdin.isTTY || !stdout.isTTY || typeof stdin.setRawMode !== 'function')
+        return Promise.resolve(null);
+    return new Promise((resolve) => {
+        let reply = '';
+        const wasRaw = stdin.isRaw;
+        const finish = (result) => {
+            clearTimeout(timer);
+            stdin.off('data', onData);
+            stdin.setRawMode(wasRaw);
+            stdin.pause();
+            resolve(result);
+        };
+        const onData = (chunk) => {
+            reply += chunk.toString('latin1');
+            const mode = modeFromOscReply(reply);
+            // The reply ends with BEL or ST; a terminal that does not know OSC 11 sends nothing.
+            if (mode || reply.includes('\u0007') || reply.includes('\u001b\\'))
+                finish(mode);
+        };
+        const timer = setTimeout(() => finish(null), timeoutMs);
+        stdin.setRawMode(true);
+        stdin.on('data', onData);
+        stdin.resume();
+        stdout.write('\x1b]11;?\x1b\\');
+    });
+}

package/dist/ui/theme/theme.js

@@ -0,0 +1,135 @@
+import { PRIORITY_LABELS, STATUS_LABELS } from '../../domain/task.js';
+const DARK = {
+    accent: '#8CC66F',
+    onAccent: '#14180F',
+    text: '#E6E3DA',
+    muted: '#9C998E',
+    faint: '#66645C',
+    border: '#3B3D35',
+    borderFocus: '#8CC66F',
+    bar: '#23261F',
+    barText: '#C9C6BB',
+    surface: '#2A2D25',
+    selection: '#33402C',
+    danger: '#EF6B5F',
+    warning: '#E6B450',
+    success: '#8CC66F',
+    info: '#62B6D9',
+    merged: '#B894E6',
+    dangerSoft: '#4A2622',
+    warningSoft: '#453A1E',
+    successSoft: '#2F4125',
+    infoSoft: '#1F3A47',
+    mergedSoft: '#3A2D4A',
+    neutralSoft: '#34362F',
+};
+const LIGHT = {
+    accent: '#3F8A3F',
+    onAccent: '#FFFFFF',
+    text: '#26251F',
+    muted: '#6B685E',
+    faint: '#A29F94',
+    border: '#D5D2C6',
+    borderFocus: '#3F8A3F',
+    bar: '#ECEAE2',
+    barText: '#3E3C35',
+    surface: '#F6F5EF',
+    selection: '#DDEBD3',
+    danger: '#C43D32',
+    warning: '#A06A00',
+    success: '#3F8A3F',
+    info: '#1F76A0',
+    merged: '#7A4FB8',
+    dangerSoft: '#F6DCD8',
+    warningSoft: '#F3E6C4',
+    successSoft: '#DDEBD3',
+    infoSoft: '#D6E9F2',
+    mergedSoft: '#E8DDF6',
+    neutralSoft: '#E6E4DC',
+};
+/** The active interface palette. Filled in place by `setThemeMode` before the interface renders. */
+export const palette = { ...DARK };
+let mode = 'dark';
+export function setThemeMode(next) {
+    mode = next;
+    Object.assign(palette, next === 'light' ? LIGHT : DARK);
+}
+export function themeMode() {
+    return mode;
+}
+/** Foreground and soft background of a tone, for badges. */
+export function toneColors(tone) {
+    switch (tone) {
+        case 'danger':
+            return { fg: palette.danger, bg: palette.dangerSoft };
+        case 'warning':
+            return { fg: palette.warning, bg: palette.warningSoft };
+        case 'success':
+            return { fg: palette.success, bg: palette.successSoft };
+        case 'info':
+            return { fg: palette.info, bg: palette.infoSoft };
+        case 'merged':
+            return { fg: palette.merged, bg: palette.mergedSoft };
+        case 'neutral':
+            return { fg: palette.muted, bg: palette.neutralSoft };
+    }
+}
+export const statusTone = {
+    backlog: 'neutral',
+    todo: 'neutral',
+    in_progress: 'warning',
+    review: 'info',
+    blocked: 'danger',
+    done: 'success',
+    cancelled: 'neutral',
+};
+export const priorityTone = {
+    urgent: 'danger',
+    high: 'danger',
+    medium: 'warning',
+    low: 'neutral',
+    none: 'neutral',
+};
+/** Soy green, from young leaf to ripe pod. */
+export const brandGradient = ['#D7E86A', '#A9D46F', '#7DBE6E', '#58A56B'];
+export const symbols = {
+    pointer: '▌',
+    cursor: '▁',
+    dot: '·',
+    arrow: '→',
+    check: '✓',
+    cross: '✕',
+    active: '●',
+    rule: '─',
+    comment: '›',
+    ellipsis: '…',
+    /** Chat: a message waiting to be sent, a quoted reply, unread messages. */
+    pending: '⋯',
+    reply: '↳',
+    unread: '✉',
+    /** Checks still running. */
+    running: '◌',
+    pullRequest: '#',
+    chevron: '›',
+    link: '⇄',
+    info: 'ℹ',
+    /** Filled bar for gauges and scroll thumbs; light shade for their track. */
+    full: '█',
+    shade: '░',
+};
+export const priorityStyles = {
+    urgent: { label: PRIORITY_LABELS.urgent, color: 'redBright', bold: true },
+    high: { label: PRIORITY_LABELS.high, color: 'red' },
+    medium: { label: PRIORITY_LABELS.medium, color: 'yellow' },
+    low: { label: PRIORITY_LABELS.low, dim: true },
+    none: { label: '—', dim: true },
+};
+export const statusStyles = {
+    backlog: { label: STATUS_LABELS.backlog, glyph: '◌', dim: true },
+    todo: { label: STATUS_LABELS.todo, glyph: '○' },
+    in_progress: { label: STATUS_LABELS.in_progress, glyph: '◐', color: 'yellow' },
+    review: { label: STATUS_LABELS.review, glyph: '◎', color: 'cyan' },
+    blocked: { label: STATUS_LABELS.blocked, glyph: '⊘', color: 'red' },
+    done: { label: STATUS_LABELS.done, glyph: '✓', color: 'green' },
+    cancelled: { label: STATUS_LABELS.cancelled, glyph: '✕', dim: true },
+};

package/dist/utils/editor.js

@@ -0,0 +1,37 @@
+import { spawn } from 'node:child_process';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { SojaError } from '../domain/errors.js';
+/** The user's editor: $VISUAL, then $EDITOR, then vi. May include arguments (`code --wait`). */
+export function preferredEditor(env = process.env) {
+    return env.VISUAL?.trim() || env.EDITOR?.trim() || 'vi';
+}
+/**
+ * Opens `initial` in the user's editor, attached to the terminal, and
+ * returns the saved text (trailing newlines trimmed). Resolves to null when
+ * the editor exits with an error, so nothing is changed. The caller must
+ * have released the terminal (the TUI suspends itself first).
+ */
+export async function editInEditor(initial, options) {
+    const dir = mkdtempSync(join(tmpdir(), 'soja-edit-'));
+    const file = join(dir, options.name);
+    try {
+        writeFileSync(file, initial.endsWith('\n') || !initial ? initial : `${initial}\n`, { mode: 0o600 });
+        const command = options.editor ?? preferredEditor();
+        const code = await new Promise((resolve, reject) => {
+            // Through the shell, so "code --wait" and similar editor settings work as in Git.
+            const child = spawn(`${command} "$SOJA_EDIT_FILE"`, { shell: true, stdio: 'inherit', env: { ...process.env, SOJA_EDIT_FILE: file } });
+            child.on('error', reject);
+            child.on('close', (exit) => resolve(exit ?? 1));
+        }).catch((error) => {
+            throw new SojaError(`Could not open your editor (${command}).`, { hint: 'Set $EDITOR, e.g. `export EDITOR=nano`.', cause: error });
+        });
+        if (code !== 0)
+            return null;
+        return readFileSync(file, 'utf8').replace(/\s+$/, '');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}

package/dist/utils/errors.js

@@ -0,0 +1,23 @@
+import { SojaError } from '../domain/errors.js';
+export function isDebug(env = process.env) {
+    return Boolean(env.SOJA_DEBUG && env.SOJA_DEBUG !== '0');
+}
+/** Turns anything thrown into something safe to show a person. */
+export function toDisplayError(error, debug = isDebug()) {
+    const details = debug ? describeChain(error) : undefined;
+    if (error instanceof SojaError)
+        return { message: error.message, hint: error.hint, debug: details };
+    return {
+        message: 'Something went wrong.',
+        hint: debug ? undefined : 'Run again with SOJA_DEBUG=1 for details.',
+        debug: details,
+    };
+}
+function describeChain(error) {
+    const parts = [];
+    for (let current = error, depth = 0; current && depth < 5; depth += 1) {
+        parts.push(current instanceof Error ? (current.stack ?? current.message) : String(current));
+        current = current instanceof Error ? current.cause : undefined;
+    }
+    return parts.join('\n\ncaused by: ');
+}

package/dist/utils/text.js

@@ -0,0 +1,60 @@
+import { homedir } from 'node:os';
+/** Greedy word wrap by character count. Long words are hard-split. */
+export function wrapText(text, width) {
+    const size = Math.max(1, width);
+    const lines = [];
+    for (const paragraph of text.split(/\r?\n/)) {
+        let line = '';
+        for (const word of paragraph.split(/\s+/).filter(Boolean)) {
+            for (let chunk = word; chunk; chunk = chunk.slice(size)) {
+                const piece = chunk.slice(0, size);
+                if (!line)
+                    line = piece;
+                else if (line.length + 1 + piece.length <= size)
+                    line += ` ${piece}`;
+                else {
+                    lines.push(line);
+                    line = piece;
+                }
+            }
+        }
+        lines.push(line);
+    }
+    return lines;
+}
+/** Keeps at most `max` lines, marking the cut with an ellipsis. */
+export function clampLines(lines, max) {
+    if (lines.length <= max)
+        return [...lines];
+    const kept = lines.slice(0, Math.max(1, max));
+    kept[kept.length - 1] = `${kept[kept.length - 1] ?? ''}…`;
+    return kept;
+}
+export function truncate(text, width) {
+    if (text.length <= width)
+        return text;
+    return width <= 1 ? text.slice(0, width) : `${text.slice(0, width - 1)}…`;
+}
+/** Expands a leading `~` (typed in the interface, where no shell does it). */
+export function expandHome(path, home = homedir()) {
+    return path === '~' || path.startsWith('~/') ? `${home}${path.slice(1)}` : path;
+}
+/** Shortens paths under the home directory to `~/…`. */
+export function tildify(path, home = homedir()) {
+    return path === home || path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
+}
+/**
+ * C0/C1 control characters except tab and newline (these carry ANSI escape
+ * sequences: colors, cursor moves, window titles, clipboard writes), plus the
+ * Unicode bidi controls used to disguise text ("Trojan Source").
+ */
+// eslint-disable-next-line no-control-regex -- matching control characters is the point
+const UNSAFE = /[\u0000-\u0008\u000B-\u001F\u007F-\u009F\u202A-\u202E\u2066-\u2069]/g;
+/**
+ * Makes text written by someone else safe to print in a terminal. Applied to
+ * everything that comes from a SOJA server and to Git output from other
+ * people's commits.
+ */
+export function terminalSafe(text) {
+    return text.replace(/\r\n?/g, '\n').replace(UNSAFE, '');
+}