tickmarkr 1.72.0 → 1.74.0

package/dist/tui/app.js

@@ -1,334 +0,0 @@
-import { TerminalEngine } from "../tui/engine.js";
-import { createFleetView } from "./views/fleet-view.js";
-import { createPreviewView } from "./views/preview-view.js";
-import { createProfileView } from "./views/profile-view.js";
-import { createRoutingView } from "./views/routing-view.js";
-import { createRunsView } from "./views/runs-view.js";
-import { renderDiffModal } from "./views/diff-modal.js";
-import { buildSaveProposal, confirmSave } from "./save.js";
-import { FleetStaging } from "./staging.js";
-const MUTATION_KEYS = ["r", "m", "return"];
-const READONLY_NOTICE = "read-only in v1.66 — write path ships in v1.67";
-function emptyFleetEditable() {
-    return {
-        denyAdapters: [],
-        denyModels: [],
-        tiers: {},
-        map: {},
-        floors: {},
-    };
-}
-export class StudioApp {
-    engine;
-    views;
-    active = 0;
-    showingHelp = false;
-    confirmingQuit = false;
-    showingSave = false;
-    saveTarget = "repo";
-    saveProposal = null;
-    notice = null;
-    staging;
-    repoRoot;
-    globalDir;
-    _lines = [];
-    resolveExit = null;
-    exited;
-    constructor(opts) {
-        this.engine = new TerminalEngine({
-            input: opts.input,
-            output: opts.output,
-            onResize: () => this.paint(),
-        });
-        this.repoRoot = opts.repoRoot ?? process.cwd();
-        this.globalDir = opts.globalDir;
-        this.staging = new FleetStaging(opts.loaded ?? emptyFleetEditable());
-        this.views = [createFleetView(), createRoutingView(), createPreviewView(), createProfileView(), createRunsView()];
-        this.exited = new Promise((resolve) => {
-            this.resolveExit = resolve;
-        });
-    }
-    /** Current line model last rendered or prepared. */
-    get lines() {
-        return this._lines;
-    }
-    /** Labels of every registered view, in order. */
-    get viewLabels() {
-        return this.views.map((v) => v.label);
-    }
-    /** Enter the alternate screen and start routing input. */
-    start() {
-        this.bindKeys();
-        this.paint();
-        this.engine.start(this._lines);
-    }
-    /** Restore the terminal and release the input stream. */
-    stop() {
-        this.engine.stop();
-        if (this.resolveExit) {
-            this.resolveExit();
-            this.resolveExit = null;
-        }
-    }
-    /** Apply an edit to the staging buffer and repaint. Intended as the test seam and future edit hook. */
-    stageEdit(edit) {
-        this.staging.apply(edit);
-        this.paint();
-    }
-    get isModalOpen() {
-        return this.showingHelp || this.confirmingQuit || this.showingSave;
-    }
-    bindKeys() {
-        // view switching
-        // Tab is decoded as the raw "\t" sequence by the micro-engine.
-        this.engine.key("\t", () => {
-            if (!this.isModalOpen)
-                this.setView((this.active + 1) % this.views.length);
-        });
-        for (let i = 1; i <= this.views.length; i++) {
-            const idx = i - 1;
-            this.engine.key(String(i), () => {
-                if (!this.isModalOpen)
-                    this.setView(idx);
-            });
-        }
-        // per-view navigation
-        for (const name of ["up", "down"]) {
-            this.engine.key(name, () => {
-                if (!this.isModalOpen)
-                    this.forwardViewKey(name);
-            });
-        }
-        // help overlay
-        this.engine.key("?", () => {
-            if (!this.confirmingQuit && !this.showingSave) {
-                this.showingHelp = true;
-                this.paint();
-            }
-        });
-        // dismissal / quit
-        this.engine.key("escape", () => this.handleEscape());
-        this.engine.key("q", () => this.handleQuit());
-        // revert staged changes
-        this.engine.key("u", () => this.handleRevert());
-        // save modal
-        this.engine.key("s", () => this.handleSaveOpen());
-        this.engine.key("t", () => this.handleSaveToggle());
-        // quit-confirmation / save-confirmation answers
-        this.engine.key("y", () => this.handleConfirm());
-        this.engine.key("n", () => this.handleCancel());
-        // remaining mutation keys — read-only until wired
-        for (const key of MUTATION_KEYS) {
-            this.engine.key(key, () => {
-                if (!this.isModalOpen)
-                    this.showNotice();
-            });
-        }
-    }
-    handleEscape() {
-        if (this.showingHelp) {
-            this.showingHelp = false;
-            this.paint();
-        }
-        else if (this.showingSave) {
-            this.closeSave(false);
-        }
-        else if (this.confirmingQuit) {
-            this.confirmingQuit = false;
-            this.paint();
-        }
-        else if (this.staging.isDirty) {
-            this.confirmingQuit = true;
-            this.paint();
-        }
-        else {
-            this.stop();
-        }
-    }
-    handleQuit() {
-        if (this.showingHelp || this.showingSave)
-            return; // modals block q
-        if (this.confirmingQuit) {
-            this.stop();
-            return;
-        }
-        if (this.staging.isDirty) {
-            this.confirmingQuit = true;
-            this.paint();
-        }
-        else {
-            this.stop();
-        }
-    }
-    handleSaveOpen() {
-        if (this.isModalOpen)
-            return;
-        if (!this.staging.isDirty) {
-            this.notice = "no staged changes";
-            this.paint();
-            return;
-        }
-        this.showingSave = true;
-        this.saveTarget = "repo";
-        this.saveProposal = buildSaveProposal({
-            repoRoot: this.repoRoot,
-            loaded: this.staging.loadedState,
-            staged: this.staging.current,
-            target: this.saveTarget,
-            globalDir: this.globalDir,
-        });
-        this.paint();
-    }
-    handleSaveToggle() {
-        if (!this.showingSave)
-            return;
-        this.saveTarget = this.saveTarget === "repo" ? "global" : "repo";
-        this.saveProposal = buildSaveProposal({
-            repoRoot: this.repoRoot,
-            loaded: this.staging.loadedState,
-            staged: this.staging.current,
-            target: this.saveTarget,
-            globalDir: this.globalDir,
-        });
-        this.paint();
-    }
-    handleConfirm() {
-        if (this.showingSave) {
-            this.executeSave();
-            return;
-        }
-        if (this.confirmingQuit) {
-            this.stop();
-        }
-    }
-    handleCancel() {
-        if (this.showingSave) {
-            this.closeSave(false);
-            return;
-        }
-        if (this.confirmingQuit) {
-            this.confirmingQuit = false;
-            this.paint();
-        }
-    }
-    executeSave() {
-        if (!this.saveProposal)
-            return;
-        const result = confirmSave({
-            repoRoot: this.repoRoot,
-            loaded: this.staging.loadedState,
-            staged: this.staging.current,
-            target: this.saveTarget,
-            globalDir: this.globalDir,
-        });
-        if (result.kind === "written") {
-            this.staging = new FleetStaging(this.staging.current);
-            this.closeSave(true, `wrote ${result.path}`);
-        }
-        else if (result.kind === "refused") {
-            this.closeSave(true, `save refused: ${result.reason}`);
-        }
-        else {
-            this.closeSave(false);
-        }
-    }
-    closeSave(notify, message) {
-        this.showingSave = false;
-        this.saveProposal = null;
-        if (notify && message)
-            this.notice = message;
-        this.paint();
-    }
-    handleRevert() {
-        if (this.isModalOpen)
-            return;
-        if (this.staging.isDirty) {
-            this.staging.revert();
-            this.notice = null;
-            this.paint();
-        }
-        else {
-            this.notice = "no staged changes";
-            this.paint();
-        }
-    }
-    setView(idx) {
-        this.active = idx;
-        this.showingHelp = false;
-        this.notice = null;
-        this.paint();
-    }
-    forwardViewKey(name) {
-        this.views[this.active]?.key?.(name);
-        this.paint();
-    }
-    showNotice() {
-        this.notice = READONLY_NOTICE;
-        this.paint();
-    }
-    paint() {
-        this._lines = this.buildFrame();
-        this.engine.render(this._lines);
-    }
-    buildFrame() {
-        const { cols, rows } = this.engine.size;
-        const lines = [];
-        lines.push(this.renderTabBar());
-        if (this.showingHelp) {
-            lines.push(...this.renderHelp());
-        }
-        else if (this.showingSave && this.saveProposal) {
-            lines.push(...renderDiffModal({
-                target: this.saveProposal.target,
-                targetPath: this.saveProposal.targetPath,
-                diff: this.saveProposal.diff,
-                liveRun: this.saveProposal.liveRun,
-            }));
-        }
-        else if (this.confirmingQuit) {
-            lines.push(...this.renderQuitConfirm());
-        }
-        else {
-            const view = this.views[this.active];
-            lines.push(...view.render({ cols, rows: Math.max(rows - 2, 1) }));
-        }
-        if (this.notice) {
-            lines.push(this.notice);
-        }
-        lines.push(this.renderStatusBar());
-        return lines;
-    }
-    renderTabBar() {
-        const parts = ["tickmarkr ui ──"];
-        for (let i = 0; i < this.views.length; i++) {
-            const view = this.views[i];
-            const marker = i === this.active ? `*${view.label}` : view.label;
-            parts.push(`[${i + 1}]${marker}`);
-        }
-        return parts.join(" ");
-    }
-    renderStatusBar() {
-        if (this.staging.isDirty) {
-            const n = this.staging.changeCount;
-            return `● ${n} staged change${n === 1 ? "" : "s"}`;
-        }
-        return "no staged changes";
-    }
-    renderHelp() {
-        return [
-            "Key bindings",
-            "1-5      switch view",
-            "tab      cycle views",
-            "?        show this help",
-            "esc / q  quit",
-            "u        revert staged changes",
-            "r        re-probe (read-only)",
-            "s        save",
-            "m        mode (read-only)",
-        ];
-    }
-    renderQuitConfirm() {
-        const n = this.staging.changeCount;
-        return [`Quit with ${n} staged change${n === 1 ? "" : "s"}? (y/n)`];
-    }
-}

package/dist/tui/engine.d.ts

@@ -1,52 +0,0 @@
-import { type Key, type KeyHandler, type InputStream } from "./input.js";
-export type { Key, KeyHandler };
-/** Writable stream with the small surface the engine needs. */
-export interface OutputStream {
-    isTTY?: boolean;
-    columns?: number;
-    rows?: number;
-    write: (chunk: string) => unknown;
-    on?(event: "resize", listener: () => void): this;
-    off?(event: "resize", listener: () => void): this;
-}
-export interface EngineOptions {
-    input: InputStream;
-    output: OutputStream;
-    onResize?: (cols: number, rows: number) => void;
-    onError?: (error: unknown) => void;
-}
-/**
- * Dependency-free terminal engine: alternate-screen line-diff renderer, named-key routing,
- * resize tracking, and terminal restoration on every exit path including thrown handlers.
- */
-export declare class TerminalEngine {
-    private opts;
-    private frame;
-    private input;
-    private lastLines;
-    private _cols;
-    private _rows;
-    private running;
-    private userHandlers;
-    constructor(opts: EngineOptions);
-    /** Enter the alternate screen, begin listening for keys and resize events. */
-    start(lines: string[]): void;
-    /** Restore the terminal and stop listening. Safe to call multiple times. */
-    stop(): void;
-    /** Update the line model; only changed lines are repainted. */
-    render(lines: string[]): void;
-    /** Register a handler for a named key. */
-    key(name: string, handler: KeyHandler): void;
-    /** Unregister a handler. */
-    unkey(name: string, handler: KeyHandler): void;
-    /** Trigger a full repaint at the new size. */
-    resize(cols: number, rows: number): void;
-    /** Current terminal size as last seen or reported by a resize event. */
-    get size(): {
-        cols: number;
-        rows: number;
-    };
-    private onResize;
-    private attachResize;
-    private detachResize;
-}

package/dist/tui/engine.js

@@ -1,92 +0,0 @@
-import { Frame } from "./frame.js";
-import { InputRouter } from "./input.js";
-/**
- * Dependency-free terminal engine: alternate-screen line-diff renderer, named-key routing,
- * resize tracking, and terminal restoration on every exit path including thrown handlers.
- */
-export class TerminalEngine {
-    opts;
-    frame;
-    input;
-    lastLines = [];
-    _cols;
-    _rows;
-    running = false;
-    userHandlers = new Map();
-    constructor(opts) {
-        this.opts = opts;
-        this.frame = new Frame(opts.output);
-        this.input = new InputRouter(opts.input);
-        this._cols = opts.output.columns ?? 80;
-        this._rows = opts.output.rows ?? 24;
-    }
-    /** Enter the alternate screen, begin listening for keys and resize events. */
-    start(lines) {
-        if (this.running)
-            return;
-        this.running = true;
-        this.lastLines = lines.slice();
-        this.frame.enter(this.lastLines);
-        this.input.start();
-        this.attachResize();
-    }
-    /** Restore the terminal and stop listening. Safe to call multiple times. */
-    stop() {
-        if (!this.running)
-            return;
-        this.detachResize();
-        this.input.stop();
-        this.frame.exit();
-        this.running = false;
-    }
-    /** Update the line model; only changed lines are repainted. */
-    render(lines) {
-        this.lastLines = lines.slice();
-        this.frame.render(this.lastLines);
-    }
-    /** Register a handler for a named key. */
-    key(name, handler) {
-        const wrapped = async (k) => {
-            try {
-                await handler(k);
-            }
-            catch (e) {
-                this.stop();
-                this.opts.onError?.(e);
-            }
-        };
-        this.userHandlers.set(handler, wrapped);
-        this.input.on(name, wrapped);
-    }
-    /** Unregister a handler. */
-    unkey(name, handler) {
-        const wrapped = this.userHandlers.get(handler);
-        if (wrapped) {
-            this.input.off(name, wrapped);
-            this.userHandlers.delete(handler);
-        }
-    }
-    /** Trigger a full repaint at the new size. */
-    resize(cols, rows) {
-        this._cols = cols;
-        this._rows = rows;
-        this.frame.resize(this.lastLines);
-        this.opts.onResize?.(cols, rows);
-    }
-    /** Current terminal size as last seen or reported by a resize event. */
-    get size() {
-        return { cols: this._cols, rows: this._rows };
-    }
-    onResize = () => {
-        this._cols = this.opts.output.columns ?? this._cols;
-        this._rows = this.opts.output.rows ?? this._rows;
-        this.frame.resize(this.lastLines);
-        this.opts.onResize?.(this._cols, this._rows);
-    };
-    attachResize() {
-        this.opts.output.on?.("resize", this.onResize);
-    }
-    detachResize() {
-        this.opts.output.off?.("resize", this.onResize);
-    }
-}

package/dist/tui/frame.d.ts

@@ -1,22 +0,0 @@
-/** A write target — anything with a write(chunk: string) method. */
-export interface OutputSink {
-    write: (chunk: string) => unknown;
-}
-/** Frame state + diff rendering. */
-export declare class Frame {
-    private out;
-    private prev;
-    private active;
-    constructor(out: OutputSink);
-    /** Enter the alternate screen, hide the cursor, and paint the initial frame. */
-    enter(lines: string[]): void;
-    /**
-     * Paint only the lines that differ from the previous model. Lines are addressed with
-     * absolute cursor positioning; unchanged rows produce no output.
-     */
-    render(lines: string[]): void;
-    /** Invalidate the cached frame so the next render writes every line. */
-    resize(lines: string[]): void;
-    /** Restore the terminal: show cursor and return to the normal screen buffer. */
-    exit(): void;
-}

package/dist/tui/frame.js

@@ -1,56 +0,0 @@
-// Line-diff renderer for the alternate screen. Maintains the previous line model and
-// repaints only rows that changed since the last render, keeping terminal traffic small.
-/** Frame state + diff rendering. */
-export class Frame {
-    out;
-    prev = [];
-    active = false;
-    constructor(out) {
-        this.out = out;
-    }
-    /** Enter the alternate screen, hide the cursor, and paint the initial frame. */
-    enter(lines) {
-        this.active = true;
-        this.prev = [];
-        this.out.write("\x1b[?1049h"); // alternate screen buffer
-        this.out.write("\x1b[?25l"); // hide cursor
-        this.render(lines);
-    }
-    /**
-     * Paint only the lines that differ from the previous model. Lines are addressed with
-     * absolute cursor positioning; unchanged rows produce no output.
-     */
-    render(lines) {
-        if (!this.active)
-            return;
-        const curr = lines.slice();
-        const max = Math.max(this.prev.length, curr.length);
-        for (let i = 0; i < max; i++) {
-            if (this.prev[i] !== curr[i]) {
-                this.out.write(`\x1b[${i + 1};1H`); // row i+1, column 1
-                this.out.write(curr[i] ?? "");
-                this.out.write("\x1b[K"); // clear to end of line
-            }
-        }
-        if (curr.length < this.prev.length) {
-            // The frame shrank — clear everything below the new last line.
-            this.out.write(`\x1b[${curr.length + 1};1H`);
-            this.out.write("\x1b[J");
-        }
-        this.prev = curr;
-    }
-    /** Invalidate the cached frame so the next render writes every line. */
-    resize(lines) {
-        this.prev = [];
-        this.render(lines);
-    }
-    /** Restore the terminal: show cursor and return to the normal screen buffer. */
-    exit() {
-        if (!this.active)
-            return;
-        this.out.write("\x1b[?25h"); // show cursor
-        this.out.write("\x1b[?1049l"); // normal screen buffer
-        this.active = false;
-        this.prev = [];
-    }
-}

package/dist/tui/input.d.ts

@@ -1,41 +0,0 @@
-/** Decoded keypress shape. */
-export interface Key {
-    name?: string;
-    sequence?: string;
-    ctrl?: boolean;
-    meta?: boolean;
-    shift?: boolean;
-}
-/** Handler for a named key. May be async. */
-export type KeyHandler = (key: Key) => void | Promise<void>;
-/** Readable stream with the small TTY surface the engine needs. */
-export interface InputStream extends NodeJS.ReadableStream {
-    isTTY?: boolean;
-    setRawMode?: (mode: boolean) => unknown;
-}
-/**
- * Decode the next key at the start of a byte buffer. Returns the decoded key and
- * how many bytes were consumed. Undefined when more bytes are needed.
- */
-export declare function decodeOneKey(buf: Buffer): {
-    key: Key;
-    consumed: number;
-} | undefined;
-/** Routes decoded keypress events to handlers registered by key name. */
-export declare class InputRouter {
-    private input;
-    private handlers;
-    private started;
-    private buffer;
-    constructor(input: InputStream);
-    /** Register a handler for a named key (e.g. "up", "escape", "q"). */
-    on(name: string, handler: KeyHandler): void;
-    /** Remove a previously registered handler. */
-    off(name: string, handler: KeyHandler): void;
-    /** Start decoding keypresses from the input stream. Idempotent. */
-    start(): void;
-    /** Stop decoding and release the stream. Idempotent. */
-    stop(): void;
-    private onData;
-    private dispatch;
-}

package/dist/tui/input.js

@@ -1,100 +0,0 @@
-/**
- * Decode the next key at the start of a byte buffer. Returns the decoded key and
- * how many bytes were consumed. Undefined when more bytes are needed.
- */
-export function decodeOneKey(buf) {
-    if (buf.length === 0)
-        return undefined;
-    const b0 = buf[0];
-    if (b0 === 0x1b) {
-        // CSI arrow sequences: ESC [ A/B/C/D. Keep an incomplete CSI buffered so
-        // arbitrary stream chunking cannot turn an arrow into Escape + plain keys.
-        if (buf[1] === 0x5b) {
-            if (buf.length < 3)
-                return undefined;
-            const name = buf[2] === 0x41 ? "up"
-                : buf[2] === 0x42 ? "down"
-                    : buf[2] === 0x43 ? "right"
-                        : buf[2] === 0x44 ? "left"
-                            : undefined;
-            if (name) {
-                return { key: { name, sequence: buf.subarray(0, 3).toString("binary") }, consumed: 3 };
-            }
-        }
-        // A lone ESC (or ESC followed by something we do not recognise) is Escape.
-        return { key: { name: "escape", sequence: "\x1b" }, consumed: 1 };
-    }
-    if (b0 === 0x0d || b0 === 0x0a) {
-        return { key: { name: "return", sequence: String.fromCharCode(b0) }, consumed: 1 };
-    }
-    if (b0 === 0x03) {
-        return { key: { name: "c", ctrl: true, sequence: "\x03" }, consumed: 1 };
-    }
-    if (b0 >= 0x20 && b0 < 0x7f) {
-        return { key: { name: String.fromCharCode(b0), sequence: String.fromCharCode(b0) }, consumed: 1 };
-    }
-    // Unknown byte: consume it without a name so it does not block the stream.
-    return { key: { sequence: String.fromCharCode(b0) }, consumed: 1 };
-}
-/** Routes decoded keypress events to handlers registered by key name. */
-export class InputRouter {
-    input;
-    handlers = new Map();
-    started = false;
-    buffer = Buffer.alloc(0);
-    constructor(input) {
-        this.input = input;
-    }
-    /** Register a handler for a named key (e.g. "up", "escape", "q"). */
-    on(name, handler) {
-        let set = this.handlers.get(name);
-        if (!set) {
-            set = new Set();
-            this.handlers.set(name, set);
-        }
-        set.add(handler);
-    }
-    /** Remove a previously registered handler. */
-    off(name, handler) {
-        this.handlers.get(name)?.delete(handler);
-    }
-    /** Start decoding keypresses from the input stream. Idempotent. */
-    start() {
-        if (this.started)
-            return;
-        this.started = true;
-        this.input.setRawMode?.(true);
-        this.input.on("data", this.onData);
-        this.input.resume();
-    }
-    /** Stop decoding and release the stream. Idempotent. */
-    stop() {
-        if (!this.started)
-            return;
-        this.input.off("data", this.onData);
-        this.input.setRawMode?.(false);
-        this.input.pause();
-        this.started = false;
-    }
-    onData = (chunk) => {
-        const data = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, "binary");
-        this.buffer = Buffer.concat([this.buffer, data]);
-        while (this.buffer.length > 0) {
-            const result = decodeOneKey(this.buffer);
-            if (!result)
-                break;
-            this.dispatch(result.key);
-            this.buffer = this.buffer.subarray(result.consumed);
-        }
-    };
-    dispatch(key) {
-        const name = key.name ?? key.sequence;
-        if (!name)
-            return;
-        const set = this.handlers.get(name);
-        if (!set)
-            return;
-        for (const handler of set)
-            void handler(key);
-    }
-}