@elaraai/e3-ui-cli 1.0.71 → 1.0.73

package/dist/tui/app.js

@@ -0,0 +1,241 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The terminal UI entry — `runTui(options)`: detect the theme and glyphs,
+ * load the state file, create the store / feeds / controller, mount Ink on
+ * the alternate screen, open the session (the launch screen shows its
+ * steps), route to the first view, and exit cleanly on every path (quit,
+ * Ctrl-C, SIGTERM, a fatal error), stopping the embedded server and
+ * flushing the state file.
+ *
+ * @packageDocumentation
+ */
+import * as os from 'node:os';
+import { createRequire } from 'node:module';
+import { render } from 'ink';
+import { createElement } from 'react';
+import { describeError } from './api.js';
+import { MOUSE_OFF, MOUSE_ON, mouseSupported } from './input/mouse.js';
+import { App } from './ui/App.js';
+import { createController } from './controller.js';
+import { createFeeds } from './data/feeds.js';
+import { createDebugLogger, describeTerminal, EXIT_SOFTWARE, fatalText, installLifecycle } from './lifecycle.js';
+import { selectGlyphs } from './render/glyphs.js';
+import { createTheme, detectColorLevel } from './render/theme.js';
+import { initialState, taskView } from './state/actions.js';
+import { createPersister, loadState, repoEntry, statePath } from './state/persist.js';
+import { createStore, StoreContext } from './state/store.js';
+import { openSession, SessionRefusal } from './session.js';
+import { suspendTerminal } from './suspend.js';
+import './ui/views/all.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../../package.json');
+/**
+ * Runs the terminal UI and resolves with the process exit code.
+ *
+ * @param options - The resolved root-action options
+ * @returns The exit code
+ */
+export async function runTui(options) {
+    const env = process.env;
+    const { log, file: debugFile } = createDebugLogger(env);
+    const glyphs = selectGlyphs({ ascii: options.ascii, env });
+    const level = detectColorLevel(env, process.stdout);
+    const theme = createTheme(level);
+    const stateFile = statePath(env, process.platform, os.homedir());
+    const loaded = loadState(stateFile);
+    const persist = createPersister(stateFile, loaded.state, { onError: (err) => log(`state write failed: ${describeError(err)}`) });
+    if (loaded.recoveredFrom !== undefined)
+        log(`state file was corrupt; moved to ${loaded.recoveredFrom}`);
+    const size = { columns: process.stdout.columns || 80, rows: process.stdout.rows || 24 };
+    const store = createStore(initialState(size, options.repo));
+    let session = null;
+    let instance = null;
+    let exitCode = 0;
+    let exited = false;
+    const feeds = createFeeds({ store, api: () => session?.api ?? null, log });
+    // Mouse reporting: on while the UI owns the screen, off on every exit
+    // path and around the login hand-over; never on for --no-mouse, a dumb
+    // terminal or a non-TTY.
+    const mouseWanted = options.mouse && mouseSupported(env, process.stdout);
+    let mouseActive = false;
+    const mouseOn = () => {
+        if (!mouseWanted || mouseActive)
+            return;
+        process.stdout.write(MOUSE_ON);
+        mouseActive = true;
+        store.dispatch({ type: 'mouse', enabled: true });
+    };
+    const mouseOff = () => {
+        if (!mouseActive)
+            return;
+        process.stdout.write(MOUSE_OFF);
+        mouseActive = false;
+    };
+    const exit = (code) => {
+        if (exited)
+            return;
+        exited = true;
+        exitCode = code;
+        mouseOff();
+        feeds.stop();
+        instance?.unmount();
+    };
+    const openTarget = async (target) => {
+        const previous = session;
+        session = null;
+        store.dispatch({ type: 'session', session: null });
+        store.dispatch({ type: 'data/reset' });
+        store.dispatch({ type: 'view/root', view: { kind: 'launch', target, step: 'starting' } });
+        if (previous !== null)
+            await previous.stop().catch(() => undefined);
+        await open(target);
+    };
+    const login = async (url) => {
+        // The device flow prints its code and URL and waits: hand the
+        // terminal over, run `e3 auth login` in this process, take it back.
+        const { createLoginCommand } = await import('@elaraai/e3-cli/internal');
+        mouseOff();
+        await suspendTerminal(async () => {
+            const command = createLoginCommand();
+            command.exitOverride();
+            try {
+                await command.parseAsync(['login', url], { from: 'user' });
+            }
+            catch (err) {
+                process.stderr.write(`${describeError(err)}\n`);
+            }
+        });
+        mouseOn();
+        await openTarget(url === session?.info.origin ? session.info.target : url);
+    };
+    const controller = createController({
+        store,
+        glyphs,
+        api: () => session?.api ?? null,
+        feeds,
+        persist,
+        exit,
+        openTarget,
+        login,
+        copy: (text) => {
+            if (!process.stdout.isTTY)
+                return false;
+            process.stdout.write(`\x1b]52;c;${Buffer.from(text, 'utf8').toString('base64')}\x07`);
+            return true;
+        },
+        now: () => Date.now(),
+        log,
+    });
+    const facts = () => {
+        const status = session?.status ?? null;
+        if (status === null)
+            return null;
+        return { objects: Number(status.objectCount), packages: Number(status.packageCount), workspaces: Number(status.workspaceCount) };
+    };
+    const removeLifecycle = installLifecycle({
+        onSignal: (signal) => {
+            log(`signal ${signal}`);
+            exit(signal === 'SIGINT' ? 130 : 0);
+        },
+        onFatal: (error) => {
+            log(`fatal: ${fatalText(error)}`);
+            mouseOff();
+            exit(EXIT_SOFTWARE);
+            process.stderr.write(`e3-ui: ${fatalText(error)}\n`);
+            if (debugFile !== null)
+                process.stderr.write(`(debug log: ${debugFile})\n`);
+        },
+    });
+    // Where the launch lands: --task / --input, else the workspace given, else
+    // the last used, else the only one, else the workspaces list.
+    const firstView = async (opened) => {
+        if (opened.info.kind === 'origin')
+            return { kind: 'repos', list: { sel: 0, top: 0 } };
+        store.dispatch({ type: 'view/launchStep', step: 'reading workspaces' });
+        const workspaces = await opened.api.workspaceList();
+        store.dispatch({ type: 'data/workspaces', workspaces });
+        store.dispatch({ type: 'view/launchStep', step: `reading ${workspaces.length} workspace${workspaces.length === 1 ? '' : 's'}` });
+        const remembered = persist.state.repos[opened.info.stateKey]?.workspace;
+        const candidates = [options.workspace, remembered, workspaces.length === 1 ? workspaces[0].name : undefined];
+        const ws = candidates.find(name => name !== undefined && workspaces.some(w => w.name === name));
+        if (ws === undefined) {
+            if (options.workspace !== undefined)
+                controller.toast(`no workspace ${options.workspace}`, 'warn');
+            return { kind: 'workspaces', list: { sel: 0, top: 0 } };
+        }
+        if (options.task !== undefined)
+            return taskView(ws, options.task);
+        if (options.input !== undefined)
+            return { kind: 'input', ws, name: options.input, tree: { sel: 0, top: 0, open: {}, baseDepth: undefined, match: null }, editing: null };
+        return { kind: 'dashboard', ws, list: { sel: 0, top: 0 } };
+    };
+    const open = async (target) => {
+        try {
+            const opened = await openSession(target, { onStep: (step) => store.dispatch({ type: 'view/launchStep', step }) });
+            if (exited) {
+                await opened.stop();
+                return;
+            }
+            session = opened;
+            store.dispatch({ type: 'session', session: opened.info });
+            persist.update(s => {
+                s.lastRepo = target;
+                repoEntry(s, opened.info.stateKey);
+            });
+            const view = await firstView(opened);
+            store.dispatch({ type: 'view/root', view });
+            if (view.kind === 'dashboard' || view.kind === 'task' || view.kind === 'input') {
+                persist.update(s => { repoEntry(s, opened.info.stateKey).workspace = view.ws; });
+            }
+            feeds.sync();
+        }
+        catch (err) {
+            if (err instanceof SessionRefusal) {
+                log(`refusal: ${err.message}`);
+                store.dispatch({ type: 'view/root', view: { kind: 'refusal', refusal: err.refusal } });
+                if (err.refusal.kind === 'not-logged-in') {
+                    store.dispatch({ type: 'command/edit', text: `/login ${err.refusal.origin}` });
+                }
+                return;
+            }
+            log(`open failed: ${fatalText(err)}`);
+            store.dispatch({ type: 'view/root', view: { kind: 'refusal', refusal: { kind: 'error', message: describeError(err) } } });
+        }
+    };
+    const about = {
+        statePath: stateFile.replace(os.homedir(), '~'),
+        terminal: describeTerminal(env, size, level, mouseWanted, glyphs),
+    };
+    instance = render(createElement(StoreContext.Provider, { value: store }, createElement(App, { controller, theme, glyphs, version: packageJson.version, about, facts })), {
+        alternateScreen: true,
+        exitOnCtrlC: false,
+        patchConsole: true,
+        kittyKeyboard: { mode: 'auto' },
+        maxFps: 30,
+    });
+    mouseOn();
+    feeds.start();
+    void open(options.repo);
+    try {
+        await instance.waitUntilExit();
+    }
+    catch (err) {
+        log(`exited with error: ${fatalText(err)}`);
+        exitCode = EXIT_SOFTWARE;
+        process.stderr.write(`e3-ui: ${fatalText(err)}\n`);
+    }
+    finally {
+        exited = true;
+        mouseOff();
+        removeLifecycle();
+        feeds.stop();
+        persist.flush();
+        if (session !== null)
+            await session.stop().catch(() => undefined);
+    }
+    return exitCode;
+}
+//# sourceMappingURL=app.js.map

package/dist/tui/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/tui/app.tsx"],"names":[],"mappings":"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"}

package/dist/tui/controller.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The controller — every key and every command lands here. It resolves
+ * keys through the keymap, drives the store, runs commands against the
+ * session's API, and owns the side effects (feeds, persistence, exit).
+ * Views stay pure; the frame specs drive this with the in-memory API.
+ *
+ * @packageDocumentation
+ */
+import type { Key } from 'ink';
+import { type Api } from './api.js';
+import { type Feeds } from './data/feeds.js';
+import { type ParsedCommand } from './input/commands.js';
+import { type KeyAction } from './input/keymap.js';
+import { type MouseEvent } from './input/mouse.js';
+import { type HitTarget } from './ui/frame.js';
+import type { Glyphs } from './render/glyphs.js';
+import type { Size } from './render/layout.js';
+import type { Tone } from './render/theme.js';
+import { type Action, type TaskTab, type TuiState, type View } from './state/actions.js';
+import type { Persister } from './state/persist.js';
+import type { Store } from './state/store.js';
+/** What the controller acts through. */
+export interface ControllerDeps {
+    store: Store;
+    glyphs: Glyphs;
+    /** The current session's API (null before a session opens). */
+    api: () => Api | null;
+    feeds: Feeds;
+    persist: Persister | null;
+    /** Ends the app with an exit code. */
+    exit: (code: number) => void;
+    /** Opens another repository (`/repo`, a refusal retry). */
+    openTarget: (target: string) => Promise<void>;
+    /** Runs the device-flow login for an origin (`/login`). */
+    login: (url: string) => Promise<void>;
+    /** Puts text on the clipboard (OSC 52); false when no terminal can take it. */
+    copy: (text: string) => boolean;
+    now: () => number;
+    /** The debug log. */
+    log: (line: string) => void;
+}
+/** Hooks later views register: what `⏎` opens on the current row, tree operations, and the like. */
+export interface ViewHooks {
+    /** `⏎` / `→` on a list view. */
+    open?: (state: TuiState, controller: Controller) => void;
+    /** A tree operation on a tree view. */
+    tree?: (action: KeyAction, state: TuiState, controller: Controller) => boolean;
+    /** Every other key action a view handles (logs, editing). */
+    key?: (action: KeyAction, state: TuiState, controller: Controller) => boolean;
+    /** Commands a view handles (`/find`, `/goto`, `/save`, `/tag`, …); true when handled. */
+    command?: (command: ParsedCommand, state: TuiState, controller: Controller) => Promise<boolean>;
+    /** Variant tags `/tag` offers on the selected row. */
+    tags?: (state: TuiState) => string[] | undefined;
+    /** A click on one of the view's own hit targets (rows, twists, toolbars); true when handled. */
+    click?: (target: HitTarget, event: MouseEvent, state: TuiState, controller: Controller) => boolean;
+    /** The wheel (`delta` rows) or a thumb drag (`top`) over the view's pane; true when handled. */
+    scroll?: (to: {
+        delta: number;
+    } | {
+        top: number;
+    }, state: TuiState, controller: Controller) => boolean;
+}
+/**
+ * Registers a view's hooks (called by each view module on load).
+ *
+ * @param kind - The view kind
+ * @param viewHooks - The hooks
+ */
+export declare function registerViewHooks(kind: string, viewHooks: ViewHooks): void;
+/** The controller. */
+export interface Controller {
+    /** Handles one Ink key event. */
+    onKey(input: string, key: Key): void;
+    /** Runs a command line (`/task forecast`, or a fuzzy jump). */
+    execute(text: string): Promise<void>;
+    /** Shows a toast for three seconds (with the tone's glyph, or `glyph`). */
+    toast(text: string, tone?: Tone, glyph?: string): void;
+    /** Replaces the view (or pushes it onto the history). */
+    navigate(view: View, push?: boolean): void;
+    /** Opens a task view. */
+    openTask(ws: string, task: string, tab?: TaskTab): void;
+    /** Opens an input view. */
+    openInput(ws: string, name: string): void;
+    /** Opens a workspace's dashboard as the new root. */
+    openWorkspace(ws: string): void;
+    /** Goes back one view. */
+    back(): void;
+    /** Quits (asking first while edits are pending). */
+    quit(force: boolean): void;
+    /** Records the terminal size. */
+    setSize(size: Size): void;
+    /** Records the output stream (mouse enable / disable). */
+    attachStdout(stdout: NodeJS.WriteStream): void;
+    /** Recomputes the completion list for the current box text. */
+    updateCompletion(): void;
+    /** The dependencies (for view hooks). */
+    readonly deps: ControllerDeps;
+    /** Dispatches an action. */
+    dispatch(action: Action): void;
+    /** The current state. */
+    state(): TuiState;
+    /** The current workspace, if the view has one. */
+    workspace(): string | null;
+}
+/**
+ * Creates the controller.
+ *
+ * @param deps - The dependencies
+ * @returns The controller
+ */
+export declare function createController(deps: ControllerDeps): Controller;
+//# sourceMappingURL=controller.d.ts.map

package/dist/tui/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/tui/controller.ts"],"names":[],"mappings":"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"}