oharness 0.1.0

package/dist/ui/tui/screen.js

@@ -0,0 +1,150 @@
+/**
+ * Terminal ownership: the alternate buffer, raw mode, and getting out again.
+ *
+ * The failure that matters here is not a misdrawn frame. It is exiting without
+ * restoring: the user is left in raw mode with no echo and no cursor, facing a
+ * terminal that appears frozen, and their only recovery is to type `reset`
+ * blind. So restoration is wired to every exit path there is — normal return,
+ * thrown exception, unhandled rejection, and the signals a terminal or a
+ * supervisor can deliver — and it is idempotent, because several of those can
+ * fire together.
+ */
+const ESC = "\u001b";
+const ALT_SCREEN_ON = `${ESC}[?1049h`;
+const ALT_SCREEN_OFF = `${ESC}[?1049l`;
+const CURSOR_HIDE = `${ESC}[?25l`;
+const CURSOR_SHOW = `${ESC}[?25h`;
+const CURSOR_HOME = `${ESC}[H`;
+const CLEAR_BELOW = `${ESC}[J`;
+const CLEAR_LINE_END = `${ESC}[K`;
+/**
+ * Synchronized output: the terminal buffers everything between these and
+ * presents it at once. Terminals that do not support it ignore the sequence,
+ * so it costs nothing and removes tearing on the ones that do.
+ */
+const SYNC_BEGIN = `${ESC}[?2026h`;
+const SYNC_END = `${ESC}[?2026l`;
+/**
+ * How long a signal waits for `beforeExit`.
+ *
+ * A tool that ignores its abort signal must not keep the process alive, and a
+ * supervisor that sent SIGTERM will follow with SIGKILL soon enough anyway.
+ */
+const EXIT_GRACE_MS = 5_000;
+/**
+ * Streams are injectable so the restore path can be tested.
+ *
+ * Not a general-purpose seam: it exists because "does this leave the terminal
+ * usable" is the one behaviour here worth proving, and proving it against the
+ * real process streams would wreck the terminal running the tests.
+ */
+export function openScreen(streams, opts) {
+    const out = (streams?.out ?? process.stdout);
+    const input = (streams?.input ?? process.stdin);
+    const wasRaw = input.isRaw ?? false;
+    let closed = false;
+    let keyHandler;
+    let resizeHandler;
+    const restore = () => {
+        if (closed)
+            return;
+        closed = true;
+        // Order matters: leave raw mode before the alt buffer, so a terminal that
+        // redraws on buffer switch does it with echo already back on.
+        try {
+            if (input.isTTY)
+                input.setRawMode(wasRaw);
+        }
+        catch {
+            // A stdin that has already been torn down cannot be restored, and
+            // throwing here would mask whatever error is actually ending the process.
+        }
+        input.pause();
+        out.write(`${CURSOR_SHOW}${ALT_SCREEN_OFF}`);
+        process.off("exit", restore);
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+        process.off("SIGHUP", onSignal);
+        out.off("resize", onResize);
+        input.off("data", onData);
+    };
+    const onSignal = () => {
+        // Restore before waiting, not after: the terminal has to come back even if
+        // the flush below hangs, and `render` is a no-op once closed, so nothing
+        // can draw over the restored screen in the meantime. `restore` also
+        // unregisters these handlers, so a second signal takes the default action
+        // and kills us immediately — which is what an impatient user wants.
+        restore();
+        const pending = opts?.beforeExit?.();
+        // Exit code 130 by convention, so a supervisor reading the status can see
+        // that a signal ended this rather than a clean return.
+        if (!pending)
+            process.exit(130);
+        void Promise.race([
+            pending.catch(() => { }),
+            new Promise((resolve) => setTimeout(resolve, EXIT_GRACE_MS)),
+        ]).then(() => process.exit(130));
+    };
+    const onData = (data) => keyHandler?.(data.toString());
+    const onResize = () => resizeHandler?.();
+    if (input.isTTY)
+        input.setRawMode(true);
+    input.resume();
+    out.write(`${ALT_SCREEN_ON}${CURSOR_HIDE}${CURSOR_HOME}${CLEAR_BELOW}`);
+    // `exit` covers a normal return and an explicit process.exit; the two
+    // handlers below cover the errors that would otherwise bypass it.
+    process.on("exit", restore);
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    process.on("SIGHUP", onSignal);
+    process.on("uncaughtException", (err) => {
+        restore();
+        console.error(err);
+        process.exit(1);
+    });
+    process.on("unhandledRejection", (err) => {
+        restore();
+        console.error(err);
+        process.exit(1);
+    });
+    out.on("resize", onResize);
+    input.on("data", onData);
+    return {
+        get rows() {
+            // A terminal that reports nothing still has to be given a size, or every
+            // layout calculation divides into an undefined viewport.
+            return out.rows || 24;
+        },
+        get columns() {
+            return out.columns || 80;
+        },
+        render(lines, cursor) {
+            if (closed)
+                return;
+            const height = out.rows || 24;
+            const frame = lines.slice(0, height);
+            let buffer = `${SYNC_BEGIN}${CURSOR_HIDE}${CURSOR_HOME}`;
+            for (let i = 0; i < frame.length; i++) {
+                // Erase to end of line per row instead of clearing the screen first:
+                // a full clear makes every frame flash on terminals without
+                // synchronized output.
+                buffer += `${frame[i]}${CLEAR_LINE_END}`;
+                if (i < frame.length - 1)
+                    buffer += "\r\n";
+            }
+            buffer += CLEAR_BELOW;
+            if (cursor)
+                buffer += `${ESC}[${cursor.row};${cursor.column}H${CURSOR_SHOW}`;
+            buffer += SYNC_END;
+            out.write(buffer);
+        },
+        onKey(handler) {
+            keyHandler = handler;
+        },
+        onResize(handler) {
+            resizeHandler = handler;
+        },
+        close: restore,
+    };
+}
+//# sourceMappingURL=screen.js.map

package/dist/ui/tui/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../../../src/ui/tui/screen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,GAAG,GAAG,QAAQ,CAAC;AACrB,MAAM,aAAa,GAAG,GAAG,GAAG,SAAS,CAAC;AACtC,MAAM,cAAc,GAAG,GAAG,GAAG,SAAS,CAAC;AACvC,MAAM,WAAW,GAAG,GAAG,GAAG,OAAO,CAAC;AAClC,MAAM,WAAW,GAAG,GAAG,GAAG,OAAO,CAAC;AAClC,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC;AAC/B,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI,CAAC;AAC/B,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAClC;;;;GAIG;AACH,MAAM,UAAU,GAAG,GAAG,GAAG,SAAS,CAAC;AACnC,MAAM,QAAQ,GAAG,GAAG,GAAG,SAAS,CAAC;AAyBjC;;;;;GAKG;AACH,MAAM,aAAa,GAAG,KAAK,CAAC;AAQ5B;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgC,EAAE,IAAoB;IAC/E,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAuB,CAAC;IACnE,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,CAAsB,CAAC;IAErE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;IACpC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,UAA+C,CAAC;IACpD,IAAI,aAAuC,CAAC;IAE5C,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,0EAA0E;QAC1E,8DAA8D;QAC9D,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,KAAK;gBAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;YAClE,0EAA0E;QAC5E,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,cAAc,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5B,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,2EAA2E;QAC3E,yEAAyE;QACzE,oEAAoE;QACpE,0EAA0E;QAC1E,oEAAoE;QACpE,OAAO,EAAE,CAAC;QAEV,MAAM,OAAO,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;QACrC,0EAA0E;QAC1E,uDAAuD;QACvD,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhC,KAAK,OAAO,CAAC,IAAI,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YACvB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;SAC7D,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAQ,EAAE,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC;IAE/C,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,KAAK,CAAC,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC,CAAC;IAExE,sEAAsE;IACtE,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE;QACvC,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzB,OAAO;QACL,IAAI,IAAI;YACN,yEAAyE;YACzE,yDAAyD;YACzD,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,MAAM;YAClB,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAErC,IAAI,MAAM,GAAG,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;YACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,qEAAqE;gBACrE,4DAA4D;gBAC5D,uBAAuB;gBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,CAAC;gBACzC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,MAAM,CAAC;YAC7C,CAAC;YACD,MAAM,IAAI,WAAW,CAAC;YACtB,IAAI,MAAM;gBAAE,MAAM,IAAI,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;YAC7E,MAAM,IAAI,QAAQ,CAAC;YAEnB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,UAAU,GAAG,OAAO,CAAC;QACvB,CAAC;QACD,QAAQ,CAAC,OAAO;YACd,aAAa,GAAG,OAAO,CAAC;QAC1B,CAAC;QACD,KAAK,EAAE,OAAO;KACf,CAAC;AACJ,CAAC"}

package/dist/ui/tui/width.d.ts

@@ -0,0 +1,30 @@
+/**
+ * How wide a string is on a terminal, and how to break it into rows.
+ *
+ * Every row count in the layout comes from here, so the two ways a naive
+ * `string.length` lies both have to be handled:
+ *
+ *   - ANSI colour codes are in the string but occupy no columns.
+ *   - East Asian characters occupy two columns each. Getting this wrong makes
+ *     Chinese text wrap short, and every row below it lands in the wrong place.
+ */
+export declare function stripAnsi(text: string): string;
+export declare function charWidth(codePoint: number): number;
+/** Columns the string occupies once colour codes are discounted. */
+export declare function visibleWidth(text: string): number;
+/**
+ * Cut a string to at most `columns`, appending an ellipsis when it did not fit.
+ *
+ * Cuts on character boundaries, never inside a surrogate pair, and never
+ * halfway through a wide character — a half-drawn CJK glyph corrupts every
+ * column after it on that row.
+ */
+export declare function truncate(text: string, columns: number): string;
+/**
+ * Break text into rows no wider than `columns`.
+ *
+ * Wraps at word boundaries when it can and mid-word when a single word is
+ * longer than the line, which is common for paths and stack traces. Explicit
+ * newlines always start a new row.
+ */
+export declare function wrap(text: string, columns: number): string[];

package/dist/ui/tui/width.js

@@ -0,0 +1,197 @@
+/**
+ * How wide a string is on a terminal, and how to break it into rows.
+ *
+ * Every row count in the layout comes from here, so the two ways a naive
+ * `string.length` lies both have to be handled:
+ *
+ *   - ANSI colour codes are in the string but occupy no columns.
+ *   - East Asian characters occupy two columns each. Getting this wrong makes
+ *     Chinese text wrap short, and every row below it lands in the wrong place.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI = /\u001b\[[0-9;?]*[a-zA-Z]/g;
+export function stripAnsi(text) {
+    return text.replace(ANSI, "");
+}
+/**
+ * Columns occupied by one code point.
+ *
+ * Ranges follow Unicode's East Asian Width property (W and F). This is the
+ * same table every terminal uses; an approximation here would show up as text
+ * drifting one column further right with each CJK character on the line.
+ */
+/**
+ * Code point ranges that occupy two columns, sorted and non-overlapping.
+ *
+ * A table rather than a chain of `||` conditions, because a reviewer can check
+ * a table against Unicode's EastAsianWidth.txt. The first version of this was
+ * a boolean expression and it silently gave U+1F680 (🚀) a width of one: the
+ * emoji block was written as ending at 1F64F, and nothing said otherwise.
+ */
+const WIDE = [
+    [0x1100, 0x115f], // Hangul Jamo
+    [0x2329, 0x232a], // angle brackets
+    [0x2e80, 0x303e], // CJK radicals, Kangxi, CJK symbols
+    [0x3041, 0x33ff], // kana, Hangul compat, CJK compat
+    [0x3400, 0x4dbf], // CJK ext A
+    [0x4e00, 0x9fff], // CJK unified
+    [0xa000, 0xa4cf], // Yi
+    [0xa960, 0xa97f], // Hangul Jamo ext A
+    [0xac00, 0xd7a3], // Hangul syllables
+    [0xf900, 0xfaff], // CJK compat ideographs
+    [0xfe10, 0xfe19], // vertical forms
+    [0xfe30, 0xfe6f], // CJK compat forms
+    [0xff00, 0xff60], // fullwidth forms
+    [0xffe0, 0xffe6], // fullwidth signs
+    [0x1f300, 0x1f64f], // misc symbols, emoticons
+    [0x1f680, 0x1f6ff], // transport and map symbols
+    [0x1f7e0, 0x1f7eb], // coloured shapes
+    [0x1f900, 0x1f9ff], // supplemental symbols, people
+    [0x1fa70, 0x1faff], // extended-A symbols
+    [0x20000, 0x2fffd], // CJK ext B onward
+    [0x30000, 0x3fffd],
+];
+export function charWidth(codePoint) {
+    // Control characters and combining marks take no space of their own.
+    if (codePoint === 0)
+        return 0;
+    if (codePoint < 32 || (codePoint >= 0x7f && codePoint < 0xa0))
+        return 0;
+    if (isCombining(codePoint))
+        return 0;
+    for (const [low, high] of WIDE) {
+        if (codePoint < low)
+            break; // sorted, so nothing further can match
+        if (codePoint <= high)
+            return 2;
+    }
+    return 1;
+}
+function isCombining(codePoint) {
+    return ((codePoint >= 0x0300 && codePoint <= 0x036f) ||
+        (codePoint >= 0x1ab0 && codePoint <= 0x1aff) ||
+        (codePoint >= 0x20d0 && codePoint <= 0x20ff) ||
+        (codePoint >= 0xfe00 && codePoint <= 0xfe0f) || // variation selectors
+        (codePoint >= 0xfe20 && codePoint <= 0xfe2f));
+}
+/** Columns the string occupies once colour codes are discounted. */
+export function visibleWidth(text) {
+    let total = 0;
+    for (const char of stripAnsi(text))
+        total += charWidth(char.codePointAt(0));
+    return total;
+}
+/**
+ * Cut a string to at most `columns`, appending an ellipsis when it did not fit.
+ *
+ * Cuts on character boundaries, never inside a surrogate pair, and never
+ * halfway through a wide character — a half-drawn CJK glyph corrupts every
+ * column after it on that row.
+ */
+export function truncate(text, columns) {
+    if (columns <= 0)
+        return "";
+    if (visibleWidth(text) <= columns)
+        return text;
+    const budget = columns - 1; // room for the ellipsis
+    let width = 0;
+    let out = "";
+    for (const char of stripAnsi(text)) {
+        const w = charWidth(char.codePointAt(0));
+        if (width + w > budget)
+            break;
+        width += w;
+        out += char;
+    }
+    return `${out}…`;
+}
+/**
+ * Break text into rows no wider than `columns`.
+ *
+ * Wraps at word boundaries when it can and mid-word when a single word is
+ * longer than the line, which is common for paths and stack traces. Explicit
+ * newlines always start a new row.
+ */
+export function wrap(text, columns) {
+    if (columns <= 0)
+        return [""];
+    const rows = [];
+    for (const paragraph of text.split("\n")) {
+        if (paragraph === "") {
+            rows.push("");
+            continue;
+        }
+        let row = "";
+        let width = 0;
+        for (const word of splitWords(paragraph)) {
+            const wordWidth = visibleWidth(word);
+            // A word longer than the whole line has to be broken; otherwise it would
+            // either overflow the row or loop forever looking for a fit.
+            if (wordWidth > columns) {
+                if (row) {
+                    rows.push(row);
+                    row = "";
+                    width = 0;
+                }
+                for (const piece of hardBreak(word, columns)) {
+                    if (visibleWidth(piece) === columns)
+                        rows.push(piece);
+                    else {
+                        row = piece;
+                        width = visibleWidth(piece);
+                    }
+                }
+                continue;
+            }
+            if (width + wordWidth > columns) {
+                rows.push(row);
+                row = word.trimStart();
+                width = visibleWidth(row);
+            }
+            else {
+                row += word;
+                width += wordWidth;
+            }
+        }
+        rows.push(row);
+    }
+    return rows;
+}
+/** Words with their trailing spaces attached, so wrapping keeps the gaps. */
+function splitWords(text) {
+    return text.match(/\S+\s*|\s+/g) ?? [];
+}
+function hardBreak(word, columns) {
+    const pieces = [];
+    let piece = "";
+    let width = 0;
+    for (const char of word) {
+        const w = charWidth(char.codePointAt(0));
+        // A glyph wider than the entire line has no faithful rendering — at one
+        // column, a CJK character simply cannot be drawn. Emitting it anyway would
+        // produce an over-wide row, and every row count below it would then be
+        // wrong. A marker keeps the invariant and still shows something is there.
+        if (w > columns) {
+            if (piece) {
+                pieces.push(piece);
+                piece = "";
+                width = 0;
+            }
+            pieces.push("…");
+            continue;
+        }
+        if (width + w > columns) {
+            pieces.push(piece);
+            piece = char;
+            width = w;
+        }
+        else {
+            piece += char;
+            width += w;
+        }
+    }
+    if (piece)
+        pieces.push(piece);
+    return pieces;
+}
+//# sourceMappingURL=width.js.map

package/dist/ui/tui/width.js.map

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

package/dist/ui/wordmark.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The brand: the mark from `website/public/logo.svg`, and the name beside it.
+ *
+ * Kept apart from either frontend because both draw it — the hand-written TUI
+ * writes rows into a frame, Ink wraps them in components — and two copies of a
+ * letterform drift into two different logos. Neither the mark nor the glyphs
+ * carry colour; the caller paints them, because Ink and raw ANSI have no way
+ * to share that part.
+ */
+/**
+ * The mark: a ring broken on the two diagonals, with a dot at its centre.
+ *
+ * The SVG is two hooked strokes — a top edge rounding into a left edge, and a
+ * bottom edge rounding into a right edge — leaving gaps at top-right and
+ * bottom-left. Box-drawing reproduces that at three rows; a half-block circle
+ * would not, because the gaps are the whole idea.
+ */
+export declare const MARK: [string, string, string];
+export declare const MARK_WIDTH = 5;
+/** How the name is spelled everywhere it is drawn. */
+export declare const NAME = "OHarness";
+/** The three rows spelling `text`; characters with no glyph are skipped. */
+export declare function word(text: string): string[];
+/** Gap between the mark and the name, in columns. */
+export declare const MARK_GAP = 3;
+/** The name as three rows, plus the width of mark, gap and name together. */
+export declare function wordmark(): {
+    rows: string[];
+    width: number;
+};

package/dist/ui/wordmark.js

@@ -0,0 +1,63 @@
+/**
+ * The brand: the mark from `website/public/logo.svg`, and the name beside it.
+ *
+ * Kept apart from either frontend because both draw it — the hand-written TUI
+ * writes rows into a frame, Ink wraps them in components — and two copies of a
+ * letterform drift into two different logos. Neither the mark nor the glyphs
+ * carry colour; the caller paints them, because Ink and raw ANSI have no way
+ * to share that part.
+ */
+/**
+ * The mark: a ring broken on the two diagonals, with a dot at its centre.
+ *
+ * The SVG is two hooked strokes — a top edge rounding into a left edge, and a
+ * bottom edge rounding into a right edge — leaving gaps at top-right and
+ * bottom-left. Box-drawing reproduces that at three rows; a half-block circle
+ * would not, because the gaps are the whole idea.
+ */
+export const MARK = [
+    "╭─── ",
+    "│ ● │",
+    " ───╯",
+];
+export const MARK_WIDTH = 5;
+/** How the name is spelled everywhere it is drawn. */
+export const NAME = "OHarness";
+/**
+ * Drawn with half-block characters rather than figlet-style ASCII: at terminal
+ * resolution, slashes and underscores read as noise, while a block letterform
+ * reads as type.
+ *
+ * Each glyph is three rows of four columns, the last being the gap. Sized so
+ * the mark and the whole name fit inside eighty columns, which is still the
+ * width a terminal is assumed to have.
+ */
+const GLYPHS = {
+    O: ["█▀▀█", "█  █", "▀▀▀▀"],
+    H: ["█  █", "█▀▀█", "▀  ▀"],
+    a: ["█▀▀█", "█▀▀█", "▀  ▀"],
+    e: ["█▀▀█", "█▀▀▀", "▀▀▀▀"],
+    n: ["█▀▀█", "█  █", "▀  ▀"],
+    r: ["█▀▀█", "█▀▀ ", "▀  ▀"],
+    s: ["█▀▀▀", "▀▀▀█", "▀▀▀▀"],
+};
+/** The three rows spelling `text`; characters with no glyph are skipped. */
+export function word(text) {
+    const rows = ["", "", ""];
+    for (const char of text) {
+        const glyph = GLYPHS[char];
+        if (!glyph)
+            continue;
+        for (let i = 0; i < 3; i++)
+            rows[i] += glyph[i] + " ";
+    }
+    return rows.map((row) => row.trimEnd());
+}
+/** Gap between the mark and the name, in columns. */
+export const MARK_GAP = 3;
+/** The name as three rows, plus the width of mark, gap and name together. */
+export function wordmark() {
+    const rows = word(NAME);
+    return { rows, width: MARK_WIDTH + MARK_GAP + rows[0].length };
+}
+//# sourceMappingURL=wordmark.js.map

package/dist/ui/wordmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wordmark.js","sourceRoot":"","sources":["../../src/ui/wordmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAA6B;IAC5C,OAAO;IACP,OAAO;IACP,OAAO;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B,sDAAsD;AACtD,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC;AAE/B;;;;;;;;GAQG;AACH,MAAM,MAAM,GAA6C;IACvD,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC;AAE1B,6EAA6E;AAC7E,MAAM,UAAU,QAAQ;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE,CAAC;AAClE,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "oharness",
+  "version": "0.1.0",
+  "description": "A model-agnostic agent harness: swappable providers, tool calling, MCP, subagents, compaction, hooks and permissions.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.6.0"
+  },
+  "bin": {
+    "oharness": "./dist/ui/main.js",
+    "oharness-headless": "./dist/headless/main.js",
+    "oharness-web": "./dist/bin/web.js",
+    "oharness-sync": "./dist/bin/sync.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "oharness-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./providers": {
+      "oharness-source": "./src/providers.ts",
+      "types": "./dist/providers.d.ts",
+      "default": "./dist/providers.js"
+    },
+    "./tools": {
+      "oharness-source": "./src/tools.ts",
+      "types": "./dist/tools.d.ts",
+      "default": "./dist/tools.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@oharness/engine": "0.1.0",
+    "@oharness/server": "0.1.0",
+    "@oharness/sync": "0.1.0",
+    "ink": "^7.1.1",
+    "react": "^19.2.8"
+  }
+}