soja-cli 1.6.2 → 1.7.0

package/dist/application/services/preference-service.js

@@ -1,3 +1,35 @@
+export const GLOBAL_SHORTCUTS = {
+    commands: ':',
+    search: '/',
+    newTask: 'n',
+    projects: 'p',
+    workspaces: 'w',
+    finance: 'f',
+    access: 'A',
+    chat: '#',
+    mouse: 'M',
+    help: '?',
+    settings: ',',
+    profile: 'u',
+    quit: 'q',
+};
+export function normalizeGlobalShortcut(value) {
+    const key = value.trim().toLowerCase();
+    if (/^\S$/u.test(key) && key.length === 1)
+        return key;
+    if (/^ctrl\+[a-z]$/.test(key) && key !== 'ctrl+r')
+        return key;
+    return null;
+}
+export function matchesGlobalShortcut(input, key, binding) {
+    const normalized = normalizeGlobalShortcut(binding);
+    if (!normalized)
+        return false;
+    const control = /^ctrl\+([a-z])$/.exec(normalized);
+    if (control)
+        return key.ctrl && !key.meta && input.toLowerCase() === control[1];
+    return !key.ctrl && !key.meta && input === binding;
+}
 /** Per-machine interface preferences, kept in the config file. */
 export class PreferenceService {
     config;
@@ -14,4 +46,27 @@ export class PreferenceService {
         if (current)
             this.config.save({ ...current, mouse: on });
     }
+    keyboardShortcuts() {
+        return { ...GLOBAL_SHORTCUTS, ...this.config.load()?.keyboardShortcuts };
+    }
+    setKeyboardShortcut(action, key) {
+        const normalized = normalizeGlobalShortcut(key);
+        if (!normalized)
+            throw new Error('Use one printable key or a Ctrl+letter combination. Ctrl+R is reserved for reset.');
+        const current = this.keyboardShortcuts();
+        const conflict = Object.keys(current).find((other) => other !== action && normalizeGlobalShortcut(current[other]) === normalized);
+        if (conflict)
+            throw new Error(`That key is already assigned to ${conflict}.`);
+        const config = this.config.load();
+        if (config)
+            this.config.save({ ...config, keyboardShortcuts: { ...config.keyboardShortcuts, [action]: normalized } });
+    }
+    resetKeyboardShortcuts() {
+        const config = this.config.load();
+        if (config) {
+            const reset = { ...config };
+            delete reset.keyboardShortcuts;
+            this.config.save(reset);
+        }
+    }
 }

package/dist/cli/commands/tui.js

@@ -31,7 +31,7 @@ export async function runInterface(options = {}) {
         const updates = createUpdater();
         // Light or dark palette, from the terminal's own background (SOJA_THEME overrides).
         setThemeMode(await detectThemeMode());
-        const instance = render(_jsx(App, { services: runtime.services, welcomeOnLocal: savedConfig?.mode === 'remote' && !hasRemoteToken, updates: () => updates.cachedCheck(), mouse: process.env.SOJA_MOUSE !== '0' && runtime.services.preferences.mouse(), ...(options.route ? { initialRoute: options.route } : {}) }), { alternateScreen: true, exitOnCtrlC: true });
+        const instance = render(_jsx(App, { services: runtime.services, welcomeOnLocal: savedConfig?.mode === 'remote' && !hasRemoteToken, updates: { check: () => updates.cachedCheck(), install: (version) => updates.install(version) }, mouse: process.env.SOJA_MOUSE !== '0' && runtime.services.preferences.mouse(), ...(options.route ? { initialRoute: options.route } : {}) }), { alternateScreen: true, exitOnCtrlC: true });
         await instance.waitUntilExit();
         reopenInCurrentMode = new FileConfigStore(runtime.paths.configFile).load()?.mode !== runtime.services.environment.mode;
     }

package/dist/config/config.js

@@ -30,6 +30,8 @@ export const configSchema = z
     parentFolders: z.array(z.string().min(1)).default([]),
     /** Whether the interface reports the mouse (`soja mouse on|off`, `M` in the interface). On when unset. */
     mouse: z.boolean().optional(),
+    /** User-defined single-key global navigation shortcuts. */
+    keyboardShortcuts: z.record(z.string(), z.string()).optional(),
     remote: remoteSchema.optional(),
 })
     .refine((config) => config.mode !== 'remote' || config.remote !== undefined, {

package/dist/data/sync/finance.js

@@ -12,4 +12,7 @@ export class ReplicaFinanceService {
     async setMySalary(session, input) {
         await this.context.api.request('PUT', `/v1/workspaces/${session.workspace.id}/finance/salary`, input);
     }
+    async configurePayroll(session, input) {
+        await this.context.api.request('PUT', `/v1/workspaces/${session.workspace.id}/finance/payroll`, input);
+    }
 }

package/dist/ui/Shell.js

@@ -28,6 +28,9 @@ import { WorkspacesScreen } from './screens/WorkspacesScreen.js';
 import { ChatScreen } from './screens/ChatScreen.js';
 import { AccessScreen } from './screens/AccessScreen.js';
 import { FinanceScreen } from './screens/FinanceScreen.js';
+import { SettingsScreen } from './screens/SettingsScreen.js';
+import { ProfileScreen } from './screens/ProfileScreen.js';
+import { matchesGlobalShortcut } from '../application/services/preference-service.js';
 import { ApiClient } from '../data/remote/api-client.js';
 import { CredentialStore } from '../config/credentials.js';
 import { resolvePaths } from '../config/paths.js';
@@ -77,31 +80,34 @@ function Frame() {
     }, [followPullRequests]);
     const mouseToggle = useMouseToggle();
     useKeys(Layer.global, (input, key) => {
-        if (input === ':' || (key.ctrl && input === 'k'))
+        const shortcuts = services.preferences.keyboardShortcuts();
+        if (matchesGlobalShortcut(input, key, shortcuts.commands) || (key.ctrl && input === 'k'))
             openPalette();
-        else if (key.ctrl || key.meta)
-            return false;
-        else if (input === '/')
+        else if (matchesGlobalShortcut(input, key, shortcuts.search))
             openOverlay({ kind: 'search' });
-        else if (input === 'n')
+        else if (matchesGlobalShortcut(input, key, shortcuts.newTask))
             openOverlay({ kind: 'new-task', projectId: newTaskProjectId });
-        else if (input === '?')
+        else if (matchesGlobalShortcut(input, key, shortcuts.help))
             go({ type: 'push', route: { name: 'help' } });
-        else if (input === 'p')
+        else if (matchesGlobalShortcut(input, key, shortcuts.projects))
             go({ type: 'push', route: { name: 'projects' } });
-        else if (input === 'w')
+        else if (matchesGlobalShortcut(input, key, shortcuts.workspaces))
             go({ type: 'push', route: { name: 'workspaces' } });
-        else if (input === 'f' && services.finance)
+        else if (matchesGlobalShortcut(input, key, shortcuts.finance) && services.finance)
             go({ type: 'push', route: { name: 'finance' } });
-        else if (input === 'A')
+        else if (matchesGlobalShortcut(input, key, shortcuts.access))
             go({ type: 'push', route: { name: 'access' } });
-        else if (input === 'M')
+        else if (matchesGlobalShortcut(input, key, shortcuts.mouse))
             mouseToggle.toggle();
-        else if (input === '#' && chat)
+        else if (matchesGlobalShortcut(input, key, shortcuts.chat) && chat)
             go({ type: 'push', route: { name: 'chat' } });
+        else if (matchesGlobalShortcut(input, key, shortcuts.settings))
+            go({ type: 'push', route: { name: 'settings' } });
+        else if (matchesGlobalShortcut(input, key, shortcuts.profile))
+            go({ type: 'push', route: { name: 'profile' } });
         else if (key.escape && stack.length > 1)
             go({ type: 'pop' });
-        else if (input === 'q') {
+        else if (matchesGlobalShortcut(input, key, shortcuts.quit)) {
             if (stack.length > 1)
                 go({ type: 'pop' });
             else
@@ -115,7 +121,7 @@ function Frame() {
     const { flash } = useAppState();
     const server = services.environment.mode === 'remote' ? new URL(services.environment.server).host : undefined;
     const syncLabel = syncLabelFor(syncStatus);
-    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(TopBar, { columns: columns, workspace: session.workspace.name, trail: trailFor(route, project.data), username: session.user.username, isCeo: accountBadge.data === true, server: server, sync: syncLabel, chat: route.name === 'chat' ? undefined : (chatTotals.data ?? undefined) }), _jsxs(Box, { flexGrow: 1, flexShrink: 1, children: [sidebar ? _jsx(Sidebar, { width: sidebar, height: rows - 1 - FOOTER_GAP_ROWS - footerRowsFor(columns), active: !overlay }) : null, _jsx(Box, { flexDirection: "column", flexGrow: 1, flexShrink: 1, children: stack.map((entry, index) => {
+    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsx(TopBar, { columns: columns, workspace: session.workspace.name, trail: trailFor(route, project.data), username: session.user.username, isCeo: accountBadge.data === true, onProfileClick: () => go({ type: 'push', route: { name: 'profile' } }), profileActive: !overlay, server: server, sync: syncLabel, chat: route.name === 'chat' ? undefined : (chatTotals.data ?? undefined) }), _jsxs(Box, { flexGrow: 1, flexShrink: 1, children: [sidebar ? _jsx(Sidebar, { width: sidebar, height: rows - 1 - FOOTER_GAP_ROWS - footerRowsFor(columns), active: !overlay }) : null, _jsx(Box, { flexDirection: "column", flexGrow: 1, flexShrink: 1, children: stack.map((entry, index) => {
                             const top = index === stack.length - 1;
                             // The screen under a window stays visible, but only the window takes keys and clicks.
                             const active = top && !overlay;
@@ -136,6 +142,10 @@ function ScreenFor({ route, active }) {
             return _jsx(WorkspacesScreen, { active: active });
         case 'finance':
             return _jsx(FinanceScreen, { active: active });
+        case 'settings':
+            return _jsx(SettingsScreen, { active: active });
+        case 'profile':
+            return _jsx(ProfileScreen, { active: active });
         case 'access':
             return _jsx(AccessScreen, { active: active });
         case 'help':
@@ -176,6 +186,10 @@ function trailFor(route, projectName) {
             return ['Workspaces'];
         case 'finance':
             return ['Finance'];
+        case 'settings':
+            return ['Settings'];
+        case 'profile':
+            return ['Profile'];
         case 'access':
             return ['Access approvals'];
         case 'help':

package/dist/ui/app-state.js

@@ -39,14 +39,32 @@ export function AppStateProvider({ services, cwd, initialSession, initialRoute,
         if (!updates)
             return;
         let active = true;
-        void updates().then((update) => {
-            if (active && update?.available)
-                notify(`SOJA v${update.latest} is available`, 'info', 'Run `soja update` to install it.');
+        void updates.check().then((update) => {
+            if (active && update?.available) {
+                setOverlay({
+                    kind: 'confirm',
+                    title: `SOJA v${update.latest} is available`,
+                    context: `Current version: v${update.current}`,
+                    message: 'Install the update from npm now? SOJA will close after installation so you can start the new version.',
+                    confirmLabel: 'Update now',
+                    onConfirm: async () => {
+                        try {
+                            await updates.install(update.latest);
+                            exit();
+                        }
+                        catch (error) {
+                            const display = toDisplayError(error);
+                            notify(display.message, 'error', display.hint);
+                            return false;
+                        }
+                    },
+                });
+            }
         });
         return () => {
             active = false;
         };
-    }, [updates, notify]);
+    }, [updates, notify, exit]);
     const run = useCallback(async (action, success) => {
         try {
             await action();

package/dist/ui/chrome/TopBar.js

@@ -1,10 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { APP_NAME, APP_VERSION } from '../branding/brand.js';
+import { Clickable } from '../kit/Clickable.js';
 import { palette, symbols } from '../theme/theme.js';
 /** The title bar: brand and place on the left, connection and you on the right. */
-export function TopBar({ columns, workspace, trail, username, isCeo, server, sync, chat }) {
+export function TopBar({ columns, workspace, trail, username, isCeo, server, sync, chat, onProfileClick, profileActive = true }) {
     const roomy = columns >= 90;
     const syncColor = sync?.tone === 'warn' ? palette.warning : sync?.tone === 'busy' ? palette.info : palette.muted;
-    return (_jsxs(Box, { width: columns, backgroundColor: palette.bar, justifyContent: "space-between", flexShrink: 0, children: [_jsx(Box, { flexShrink: 1, children: _jsxs(Text, { wrap: "truncate-end", backgroundColor: palette.bar, children: [_jsx(Text, { backgroundColor: palette.accent, color: palette.onAccent, bold: true, children: ` ${APP_NAME}${symbols.cursor} ` }), _jsx(Text, { color: palette.barText, bold: true, children: `  ${workspace}` }), trail.map((part) => (_jsx(Text, { color: palette.muted, children: `  ${symbols.chevron} ${part}` }, part)))] }) }), _jsxs(Box, { flexShrink: 0, gap: 2, paddingRight: 1, children: [chat && chat.unread > 0 ? (_jsxs(Text, { backgroundColor: palette.bar, children: [_jsx(Text, { color: palette.accent, children: `${symbols.unread} ${chat.unread}` }), chat.mentions > 0 ? _jsx(Text, { color: palette.warning, bold: true, children: ` @${chat.mentions}` }) : null] })) : null, server ? (_jsx(Text, { backgroundColor: palette.bar, color: syncColor, children: `${symbols.link} ${roomy ? server : ''}${sync ? `${roomy ? ` ${symbols.dot} ` : ''}${sync.text}` : ''}` })) : null, _jsxs(Text, { backgroundColor: palette.bar, color: palette.barText, children: [`@${username}`, isCeo ? _jsx(Text, { color: palette.warning, bold: true, children: ' ★ CEO' }) : null] }), roomy ? _jsx(Text, { backgroundColor: palette.bar, color: palette.faint, children: `v${APP_VERSION}` }) : null] })] }));
+    return (_jsxs(Box, { width: columns, backgroundColor: palette.bar, justifyContent: "space-between", flexShrink: 0, children: [_jsx(Box, { flexShrink: 1, children: _jsxs(Text, { wrap: "truncate-end", backgroundColor: palette.bar, children: [_jsx(Text, { backgroundColor: palette.accent, color: palette.onAccent, bold: true, children: ` ${APP_NAME}${symbols.cursor} ` }), _jsx(Text, { color: palette.barText, bold: true, children: `  ${workspace}` }), trail.map((part) => (_jsx(Text, { color: palette.muted, children: `  ${symbols.chevron} ${part}` }, part)))] }) }), _jsxs(Box, { flexShrink: 0, gap: 2, paddingRight: 1, children: [chat && chat.unread > 0 ? (_jsxs(Text, { backgroundColor: palette.bar, children: [_jsx(Text, { color: palette.accent, children: `${symbols.unread} ${chat.unread}` }), chat.mentions > 0 ? _jsx(Text, { color: palette.warning, bold: true, children: ` @${chat.mentions}` }) : null] })) : null, server ? (_jsx(Text, { backgroundColor: palette.bar, color: syncColor, children: `${symbols.link} ${roomy ? server : ''}${sync ? `${roomy ? ` ${symbols.dot} ` : ''}${sync.text}` : ''}` })) : null, _jsx(Clickable, { onClick: onProfileClick ? () => onProfileClick() : undefined, active: profileActive, children: _jsxs(Text, { backgroundColor: palette.bar, color: palette.barText, children: [`@${username}`, isCeo ? _jsx(Text, { color: palette.warning, bold: true, children: ' ★ CEO' }) : null] }) }), roomy ? _jsx(Text, { backgroundColor: palette.bar, color: palette.faint, children: `v${APP_VERSION}` }) : null] })] }));
 }

package/dist/ui/hooks/use-commands.js

@@ -13,26 +13,30 @@ export function useCommandPalette(newTaskProjectId) {
     const flows = useFlows();
     const mouse = useMouseToggle();
     return () => {
+        const shortcuts = services.preferences.keyboardShortcuts();
         const commands = [
-            { id: 'new-task', label: 'New task', key: 'n', run: () => openOverlay({ kind: 'new-task', projectId: newTaskProjectId }) },
+            { id: 'new-task', label: 'New task', key: shortcuts.newTask, run: () => openOverlay({ kind: 'new-task', projectId: newTaskProjectId }) },
             ...TASK_FILTERS.map((filter) => ({
                 id: `filter-${filter}`,
                 label: FILTER_LABELS[filter],
                 run: () => showView(filter),
             })),
             { id: 'filter-archived', label: 'Archived tasks', run: () => showView('archived') },
-            { id: 'search', label: 'Search', key: '/', run: () => openOverlay({ kind: 'search' }) },
-            { id: 'projects', label: 'Projects', key: 'p', run: () => go({ type: 'push', route: { name: 'projects' } }) },
+            { id: 'search', label: 'Search', key: shortcuts.search, run: () => openOverlay({ kind: 'search' }) },
+            { id: 'projects', label: 'Projects', key: shortcuts.projects, run: () => go({ type: 'push', route: { name: 'projects' } }) },
             { id: 'switch-project', label: 'Switch project', run: () => flows.pickProject() },
             { id: 'new-project', label: 'New project', run: () => flows.newProject() },
             { id: 'switch-workspace', label: 'Switch workspace', run: () => flows.pickWorkspace() },
-            { id: 'workspaces', label: 'Workspaces', key: 'w', run: () => go({ type: 'push', route: { name: 'workspaces' } }) },
-            ...(services.finance ? [{ id: 'finance', label: 'Finance & performance', key: 'f', run: () => go({ type: 'push', route: { name: 'finance' } }) }] : []),
+            { id: 'workspaces', label: 'Workspaces', key: shortcuts.workspaces, run: () => go({ type: 'push', route: { name: 'workspaces' } }) },
+            ...(services.finance ? [{ id: 'finance', label: 'Finance & performance', key: shortcuts.finance, run: () => go({ type: 'push', route: { name: 'finance' } }) }] : []),
+            { id: 'settings', label: 'Settings', key: shortcuts.settings, run: () => go({ type: 'push', route: { name: 'settings' } }) },
+            { id: 'profile', label: 'My profile', key: shortcuts.profile, run: () => go({ type: 'push', route: { name: 'profile' } }) },
+            { id: 'access', label: 'Access approvals', key: shortcuts.access, run: () => go({ type: 'push', route: { name: 'access' } }) },
             { id: 'new-workspace', label: 'New workspace', run: () => flows.newWorkspace() },
             { id: 'add-developer', label: 'Add developer', run: () => flows.addDeveloper() },
             { id: 'parent-folders', label: 'Parent folders', run: () => flows.manageParentFolders() },
             { id: 'git-log', label: 'Git log', run: () => openOverlay({ kind: 'git-log' }) },
-            ...(services.chat ? [{ id: 'chat', label: 'Chat', key: '#', run: () => go({ type: 'push', route: { name: 'chat' } }) }] : []),
+            ...(services.chat ? [{ id: 'chat', label: 'Chat', key: shortcuts.chat, run: () => go({ type: 'push', route: { name: 'chat' } }) }] : []),
             ...(services.sync
                 ? [{
                         id: 'sync',
@@ -43,9 +47,9 @@ export function useCommandPalette(newTaskProjectId) {
                         },
                     }]
                 : []),
-            { id: 'mouse', label: mouse.enabled ? 'Mouse off' : 'Mouse on', key: 'M', run: mouse.toggle },
-            { id: 'help', label: 'Help', key: '?', run: () => go({ type: 'push', route: { name: 'help' } }) },
-            { id: 'quit', label: 'Quit', key: 'q', run: quit },
+            { id: 'mouse', label: mouse.enabled ? 'Mouse off' : 'Mouse on', key: shortcuts.mouse, run: mouse.toggle },
+            { id: 'help', label: 'Help', key: shortcuts.help, run: () => go({ type: 'push', route: { name: 'help' } }) },
+            { id: 'quit', label: 'Quit', key: shortcuts.quit, run: quit },
         ];
         const spec = {
             kind: 'picker',

package/dist/ui/screens/FinanceScreen.js

@@ -18,6 +18,7 @@ export function FinanceScreen({ active }) {
     const query = useQuery(() => finance ? finance.summary(session) : Promise.reject(new Error('Finance is only available in online workspaces.')), topic, [topic]);
     const data = query.data;
     const enoughMembers = (data?.performanceByMember.length ?? 0) >= 2;
+    const ticketHistory = data?.myTicketHistory ?? [];
     useKeys(Layer.screen, (input, key) => {
         if (!finance || key.ctrl || key.meta)
             return false;
@@ -57,6 +58,29 @@ export function FinanceScreen({ active }) {
                 } });
             return true;
         }
+        if (input === 'p') {
+            openOverlay({ kind: 'picker', title: 'Payroll schedule', initial: data?.myPayroll?.schedule ?? null, options: [
+                    { value: 'monthly', label: 'Once a month · choose a day' },
+                    { value: 'semimonthly', label: '15th and last day · split salary equally' },
+                ], onSelect: (schedule) => {
+                    if (schedule === 'semimonthly')
+                        return run(async () => {
+                            await finance.configurePayroll(session, { schedule, timeZone: localTimeZone() });
+                            invalidateQueries([topic]);
+                        }, 'Payroll set to the 15th and last day of the month');
+                    openOverlay({ kind: 'prompt', title: 'Monthly payday (1–31)', initial: String(data?.myPayroll?.dayOfMonth ?? 31), placeholder: '31 means the last day of every month', onSubmit: (value) => {
+                            const dayOfMonth = Number(value.trim());
+                            if (!Number.isInteger(dayOfMonth) || dayOfMonth < 1 || dayOfMonth > 31)
+                                return false;
+                            return run(async () => {
+                                await finance.configurePayroll(session, { schedule: 'monthly', dayOfMonth, timeZone: localTimeZone() });
+                                invalidateQueries([topic]);
+                            }, `Monthly payday set to day ${dayOfMonth}`);
+                        } });
+                    return true;
+                } });
+            return true;
+        }
         return false;
     }, active);
     if (!finance)
@@ -64,13 +88,13 @@ export function FinanceScreen({ active }) {
     if (query.error && !data)
         return _jsx(ScreenFrame, { title: "Finance", hints: [['esc', 'back']], children: _jsx(EmptyState, { lines: [query.error.message, query.error.hint ?? ''], icon: symbols.cross }) });
     if (!data)
-        return _jsx(ScreenFrame, { title: "Finance", hints: [['c', 'currency'], ['s', 'salary'], ['esc', 'back']], children: "Loading finance\u2026" });
+        return _jsx(ScreenFrame, { title: "Finance", hints: [['c', 'currency'], ['s', 'salary'], ['p', 'payday'], ['esc', 'back']], children: _jsx(Text, { color: palette.faint, children: "Loading finance\u2026" }) });
     const compact = height < 25 || width < 75;
     const rows = Math.max(1, Math.min(6, height - (compact ? 8 : 12)));
     const financeMembers = data.paidByMember.slice(0, rows);
     const currencyCode = data.currencyCode;
     const performance = data.performanceByMember.slice(0, rows);
-    return (_jsx(ScreenFrame, { title: "Finance & performance", aside: session.workspace.name, hints: [['c', 'currency'], ['s', 'my salary'], ['esc', 'back']], children: _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Panel, { title: "My base salary", aside: "private to you", height: 4, children: [_jsx(Text, { color: palette.text, children: data.mySalary && data.currencyCode ? `${money(data.mySalary.amountMinor, data.currencyCode)} / ${data.mySalary.period}` : 'Not set · press s' }), _jsx(Text, { color: palette.faint, children: "Excluded from ticket earnings and workspace comparisons." })] }), !data.currencyCode ? (_jsxs(Panel, { title: "Workspace currency", height: 5, children: [_jsx(Text, { color: palette.warning, children: "Not configured \u00B7 press c to choose an ISO 4217 currency." }), _jsx(Text, { color: palette.faint, children: "Ticket prices and team finance totals use one currency." })] })) : null, enoughMembers ? (_jsxs(Box, { flexDirection: compact ? 'column' : 'row', gap: 1, children: [_jsxs(Panel, { title: `Ticket earnings · ${data.currencyCode ?? '—'}`, flexGrow: 1, children: [currencyCode ? financeMembers.map((member) => _jsx(ChartRow, { label: `@${member.username}`, value: member.amountMinor, max: Math.max(1, ...financeMembers.map((row) => row.amountMinor)), text: money(member.amountMinor, currencyCode) }, member.id)) : _jsx(Text, { color: palette.faint, children: "Set the workspace currency to enable paid tickets." }), data.currencyCode && financeMembers.length === 0 ? _jsx(Text, { color: palette.faint, children: "No ticket earnings yet." }) : null, _jsx(Text, { color: palette.faint, children: "Only remunerated tickets moved to Done. Salary is excluded." })] }), _jsxs(Panel, { title: "Performance \u00B7 all ticket types", flexGrow: 1, children: [performance.map((member) => _jsx(ChartRow, { label: `@${member.username}`, value: member.ticketCount, max: Math.max(1, ...performance.map((row) => row.ticketCount)), text: `${member.ticketCount} tickets · ${member.openCount} open` }, member.id)), _jsxs(Text, { color: palette.faint, children: ["Average close time \u00B7 ", performance.map((member) => `${member.username}: ${duration(member.averageCloseMs)}`).join(' · ')] }), _jsx(Text, { color: palette.faint, children: "Open age counts every ticket; cancelled tickets are excluded from close averages." })] })] })) : (_jsx(Panel, { title: "Workspace comparisons", height: 4, children: _jsx(Text, { color: palette.faint, children: "Comparisons appear when at least two workspace members are eligible." }) })), _jsx(Text, { color: palette.faint, children: "Values are accrued in SOJA when approved and marked Done; they do not confirm a bank transfer." })] }) }));
+    return (_jsx(ScreenFrame, { title: "Finance & performance", aside: session.workspace.name, hints: [['c', 'currency'], ['s', 'my salary'], ['p', 'payday'], ['esc', 'back']], children: _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Panel, { title: "My base salary", aside: "private to you", height: 5, children: [_jsx(Text, { color: palette.text, children: data.mySalary && data.currencyCode ? `${money(data.mySalary.amountMinor, data.currencyCode)} / ${data.mySalary.period}` : 'Not set · press s' }), _jsxs(Text, { color: palette.text, children: ["Payroll \u00B7 ", data.myPayroll ? `${payrollLabel(data.myPayroll)} · next ${formatDate(data.myPayroll.nextPayday)}` : 'not set · press p'] }), _jsx(Text, { color: palette.faint, children: "Excluded from ticket earnings and workspace comparisons." })] }), data.myPayroll && currencyCode ? (_jsxs(Panel, { title: `Upcoming payroll · ${formatDate(data.myPayroll.nextPayday)}`, height: 4, children: [_jsx(Text, { color: palette.text, children: `Base salary${data.myPayroll.salaryAmountMinor === null ? ' (not monthly)' : ''} · ${data.myPayroll.salaryAmountMinor === null ? 'not estimated' : money(data.myPayroll.salaryAmountMinor, currencyCode)}` }), _jsx(Text, { color: palette.accent, children: `Ticket income · ${money(data.myPayroll.ticketEarningsMinor, currencyCode)}  |  Estimated total · ${data.myPayroll.salaryAmountMinor === null ? money(data.myPayroll.ticketEarningsMinor, currencyCode) : money(data.myPayroll.totalAmountMinor, currencyCode)}` })] })) : null, !data.currencyCode ? (_jsxs(Panel, { title: "Workspace currency", height: 5, children: [_jsx(Text, { color: palette.warning, children: "Not configured \u00B7 press c to choose an ISO 4217 currency." }), _jsx(Text, { color: palette.faint, children: "Ticket prices and team finance totals use one currency." })] })) : null, enoughMembers ? (_jsxs(Box, { flexDirection: compact ? 'column' : 'row', gap: 1, children: [_jsxs(Panel, { title: `Ticket earnings · ${data.currencyCode ?? '—'}`, flexGrow: 1, children: [currencyCode ? financeMembers.map((member) => _jsx(ChartRow, { label: `@${member.username}`, value: member.amountMinor, max: Math.max(1, ...financeMembers.map((row) => row.amountMinor)), text: money(member.amountMinor, currencyCode) }, member.id)) : _jsx(Text, { color: palette.faint, children: "Set the workspace currency to enable paid tickets." }), data.currencyCode && financeMembers.length === 0 ? _jsx(Text, { color: palette.faint, children: "No ticket earnings yet." }) : null, _jsx(Text, { color: palette.faint, children: "Only remunerated tickets moved to Done. Salary is excluded." })] }), _jsxs(Panel, { title: "Performance \u00B7 all ticket types", flexGrow: 1, children: [performance.map((member) => _jsx(ChartRow, { label: `@${member.username}`, value: member.ticketCount, max: Math.max(1, ...performance.map((row) => row.ticketCount)), text: `${member.ticketCount} tickets · ${member.openCount} open` }, member.id)), _jsxs(Text, { color: palette.faint, children: ["Average close time \u00B7 ", performance.map((member) => `${member.username}: ${duration(member.averageCloseMs)}`).join(' · ')] }), _jsx(Text, { color: palette.faint, children: "Open age counts every ticket; cancelled tickets are excluded from close averages." })] })] })) : (_jsx(Panel, { title: "Workspace comparisons", height: 4, children: _jsx(Text, { color: palette.faint, children: "Comparisons appear when at least two workspace members are eligible." }) })), _jsx(Panel, { title: "My ticket income history", aside: "positive income in green", height: Math.max(4, Math.min(ticketHistory.length + 3, rows + 3)), children: ticketHistory.length === 0 ? _jsx(Text, { color: palette.faint, children: "No paid ticket history yet." }) : ticketHistory.slice(0, rows).map((entry) => (_jsxs(Box, { justifyContent: "space-between", gap: 1, children: [_jsx(Text, { color: palette.text, wrap: "truncate-end", children: `${entry.taskRef} ${entry.taskTitle}` }), _jsx(Text, { color: entry.amountMinor > 0 ? palette.accent : entry.amountMinor < 0 ? palette.danger : palette.muted, bold: true, children: money(entry.amountMinor, entry.currencyCode) }), _jsx(Text, { color: palette.faint, children: `${entry.eventType} · ${formatDate(entry.createdAt)} → payroll ${formatDate(entry.payrollDate)}` })] }, entry.id))) }), _jsx(Text, { color: palette.faint, children: "Values are accrued in SOJA when approved and marked Done; they do not confirm a bank transfer." })] }) }));
 }
 function ChartRow({ label, value, max, text }) {
     const bar = Math.max(value > 0 ? 1 : 0, Math.round((value / max) * 16));
@@ -86,3 +110,13 @@ function duration(milliseconds) {
     const hours = milliseconds / 3_600_000;
     return hours < 48 ? `${hours.toFixed(1)}h` : `${(hours / 24).toFixed(1)}d`;
 }
+function payrollLabel(payroll) {
+    return payroll.schedule === 'semimonthly' ? '15th and last day' : `monthly on day ${payroll.dayOfMonth}`;
+}
+function formatDate(value) {
+    const date = value instanceof Date ? value : new Date(`${value.slice(0, 10)}T12:00:00`);
+    return Number.isNaN(date.valueOf()) ? String(value) : new Intl.DateTimeFormat(undefined, { month: 'short', day: 'numeric', year: 'numeric' }).format(date);
+}
+function localTimeZone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+}

package/dist/ui/screens/HelpScreen.js

@@ -70,6 +70,8 @@ const SECTIONS = [
             ['p', 'Projects'],
             ['w', 'Workspaces'],
             ['f', 'Finance & performance (online)'],
+            [',', 'Settings and global keyboard shortcuts'],
+            ['u', 'My profile (online); username in the top bar is clickable'],
             ['A', 'Access approvals (CEO, remote mode)'],
             ['r', 'Link repo (in Projects)'],
         ],

package/dist/ui/screens/ProfileScreen.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { useMemo } from 'react';
+import { CredentialStore } from '../../config/credentials.js';
+import { resolvePaths } from '../../config/paths.js';
+import { ApiClient } from '../../data/remote/api-client.js';
+import { useAppState } from '../app-state.js';
+import { EmptyState } from '../components/EmptyState.js';
+import { useQuery } from '../hooks/use-query.js';
+import { Layer } from '../input/dispatcher.js';
+import { useKeys } from '../input/KeyProvider.js';
+import { Panel } from '../kit/Panel.js';
+import { ScreenFrame } from './ScreenFrame.js';
+import { palette, symbols } from '../theme/theme.js';
+import { toDisplayError } from '../../utils/errors.js';
+export function ProfileScreen({ active }) {
+    const { services, session, openOverlay, run, invalidateQueries, notify } = useAppState();
+    const client = useMemo(() => {
+        if (services.environment.mode !== 'remote')
+            return null;
+        const token = new CredentialStore(resolvePaths().credentialsFile).token(services.environment.server);
+        return token ? new ApiClient(services.environment.server, token) : null;
+    }, [services.environment]);
+    const topic = `profile:${session.user.id}`;
+    const query = useQuery(() => client
+        ? client.get('/v1/profile').then((result) => result.user)
+        : Promise.reject(new Error('Your SOJA profile is available while signed in online.')), topic, [topic]);
+    const profile = query.data;
+    const save = (changes) => {
+        if (!client || !profile)
+            return false;
+        if (!profile.dateOfBirth || !profile.countryCode) {
+            openOverlay({ kind: 'prompt', title: 'Complete profile · date of birth (YYYY-MM-DD)', initial: profile.dateOfBirth ?? '', onSubmit: (dateOfBirth) => {
+                    if (!/^\d{4}-\d{2}-\d{2}$/.test(dateOfBirth))
+                        return false;
+                    return run(async () => {
+                        await client.request('PUT', '/v1/profile', { displayName: profile.displayName, dateOfBirth, countryCode: profile.countryCode ?? '' });
+                        invalidateQueries([topic]);
+                    }, 'Profile updated');
+                } });
+            return false;
+        }
+        return run(async () => {
+            await client.request('PUT', '/v1/profile', { displayName: changes.displayName ?? profile.displayName, dateOfBirth: changes.dateOfBirth ?? profile.dateOfBirth, countryCode: changes.countryCode ?? profile.countryCode });
+            invalidateQueries([topic]);
+        }, 'Profile updated');
+    };
+    useKeys(Layer.screen, (input) => {
+        if (!profile || !client)
+            return false;
+        if (input === 'n') {
+            openOverlay({ kind: 'prompt', title: 'Display name', initial: profile.displayName, placeholder: 'Your name', onSubmit: (displayName) => {
+                    const cleaned = displayName.trim();
+                    if (!cleaned || cleaned.length > 80)
+                        return false;
+                    return save({ displayName: cleaned });
+                } });
+            return true;
+        }
+        if (input === 'd') {
+            openOverlay({ kind: 'prompt', title: 'Date of birth (YYYY-MM-DD)', initial: profile.dateOfBirth ?? '', placeholder: '1990-01-31', onSubmit: (dateOfBirth) => save({ dateOfBirth }) });
+            return true;
+        }
+        if (input === 'c') {
+            void client.get('/v1/auth/countries').then(({ countries }) => {
+                openOverlay({ kind: 'picker', title: 'Country', initial: profile.countryCode, filterable: true, options: countries.map((country) => ({ value: country.code, label: `${country.flag} ${country.name} · ${country.code}` })), onSelect: (countryCode) => save({ countryCode }) });
+            }).catch((error) => notify(toDisplayError(error).message, 'error'));
+            return true;
+        }
+        return false;
+    }, active);
+    if (services.environment.mode !== 'remote')
+        return _jsx(ScreenFrame, { title: "Profile", hints: [['esc', 'back']], children: _jsx(EmptyState, { lines: ['Sign in to view your online profile.'], icon: symbols.dot }) });
+    if (query.error && !profile)
+        return _jsx(ScreenFrame, { title: "Profile", hints: [['esc', 'back']], children: _jsx(EmptyState, { lines: [query.error.message, query.error.hint ?? ''], icon: symbols.cross }) });
+    if (!profile)
+        return _jsx(ScreenFrame, { title: "Profile", hints: [['esc', 'back']], children: _jsx(Text, { color: palette.faint, children: "Loading profile\u2026" }) });
+    return (_jsx(ScreenFrame, { title: "My profile", aside: `@${profile.username}`, hints: [['n', 'name'], ['d', 'birth date'], ['c', 'country'], ['esc', 'back']], children: _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Panel, { title: "SOJA account", height: 7, children: [_jsxs(Text, { color: palette.text, children: ["Username \u00B7 @", profile.username] }), _jsxs(Text, { color: palette.text, children: ["Display name \u00B7 ", profile.displayName] }), _jsxs(Text, { color: palette.text, children: ["Country \u00B7 ", profile.countryCode ?? 'not set'] }), _jsxs(Text, { color: palette.text, children: ["Date of birth \u00B7 ", profile.dateOfBirth ?? 'not set'] }), _jsxs(Text, { color: palette.faint, children: ["Access \u00B7 ", profile.accessStatus, profile.isCeo ? ' · ★ CEO' : ''] })] }), _jsx(Text, { color: palette.faint, children: "Personal profile details are visible only to you here. Change them with n, d or c." })] }) }));
+}

package/dist/ui/screens/SettingsScreen.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { useState } from 'react';
+import { normalizeGlobalShortcut } from '../../application/services/preference-service.js';
+import { useAppState } from '../app-state.js';
+import { useLayout } from '../hooks/use-layout.js';
+import { Layer } from '../input/dispatcher.js';
+import { useKeys } from '../input/KeyProvider.js';
+import { Panel } from '../kit/Panel.js';
+import { ScreenFrame } from './ScreenFrame.js';
+import { palette } from '../theme/theme.js';
+const ACTIONS = [
+    { id: 'commands', label: 'Command palette' },
+    { id: 'search', label: 'Search' },
+    { id: 'newTask', label: 'New task' },
+    { id: 'projects', label: 'Projects' },
+    { id: 'workspaces', label: 'Workspaces' },
+    { id: 'finance', label: 'Finance' },
+    { id: 'access', label: 'Access requests' },
+    { id: 'chat', label: 'Chat' },
+    { id: 'mouse', label: 'Toggle mouse' },
+    { id: 'help', label: 'Help' },
+    { id: 'settings', label: 'Settings' },
+    { id: 'profile', label: 'My profile' },
+    { id: 'quit', label: 'Quit / back' },
+];
+export function SettingsScreen({ active }) {
+    const { services, openOverlay, run, notify } = useAppState();
+    const { height } = useLayout();
+    const shortcuts = services.preferences.keyboardShortcuts();
+    const [selected, setSelected] = useState(0);
+    useKeys(Layer.screen, (input, key) => {
+        if (key.upArrow) {
+            setSelected((index) => Math.max(0, index - 1));
+            return true;
+        }
+        if (key.downArrow) {
+            setSelected((index) => Math.min(ACTIONS.length - 1, index + 1));
+            return true;
+        }
+        if (key.ctrl && input.toLowerCase() === 'r') {
+            void run(async () => services.preferences.resetKeyboardShortcuts(), 'Default shortcuts restored');
+            return true;
+        }
+        if (key.return) {
+            const action = ACTIONS[selected];
+            if (!action)
+                return false;
+            const current = services.preferences.keyboardShortcuts();
+            openOverlay({
+                kind: 'prompt',
+                title: `Shortcut for ${action.label}`,
+                initial: current[action.id],
+                placeholder: 'One key or Ctrl+letter',
+                onSubmit: (value) => {
+                    const normalized = normalizeGlobalShortcut(value);
+                    if (!normalized) {
+                        notify('Use one printable key or Ctrl+letter. Ctrl+R is reserved for reset.', 'error');
+                        return false;
+                    }
+                    const conflict = ACTIONS.find((candidate) => candidate.id !== action.id && normalizeGlobalShortcut(current[candidate.id]) === normalized);
+                    if (conflict) {
+                        notify(`That key is already assigned to ${conflict.label}.`, 'error');
+                        return false;
+                    }
+                    return run(async () => services.preferences.setKeyboardShortcut(action.id, normalized), `${action.label} shortcut saved`);
+                },
+            });
+            return true;
+        }
+        return false;
+    }, active);
+    return (_jsx(ScreenFrame, { title: "Settings", hints: [['↑↓', 'select'], ['enter', 'change shortcut'], ['ctrl+r', 'reset'], ['esc', 'back']], children: _jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Panel, { title: "Keyboard shortcuts \u00B7 global navigation", height: Math.max(3, Math.min(ACTIONS.length + 3, height - 2)), children: ACTIONS.map((action, index) => {
+                        const chosen = selected === index;
+                        return (_jsxs(Box, { justifyContent: "space-between", backgroundColor: chosen ? palette.selection : undefined, children: [_jsx(Text, { color: chosen ? palette.accent : palette.text, children: `${chosen ? '▌ ' : '  '}${action.label}` }), _jsx(Text, { color: palette.warning, bold: true, children: shortcuts[action.id] })] }, action.id));
+                    }) }), _jsx(Text, { color: palette.faint, children: "Changes are saved on this machine. Enter a key or Ctrl+letter; screen-specific task and chat shortcuts stay unchanged." }), _jsxs(Text, { color: palette.faint, children: ["Profile: use ", shortcuts.profile, " or select your username in the top bar."] })] }) }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soja-cli",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "Software Operations & Job Assistant",
   "author": "Enmauel.biz",
   "license": "SEE LICENSE IN LICENSE",