@cairn-tool/cairn 3.4.0 → 3.6.0

package/dist/qa/demo.js

@@ -0,0 +1,194 @@
+import { RENDER_HZ } from "./config.js";
+import { frame } from "./layout.js";
+import { Screen } from "./screen.js";
+import { sleep } from "./async.js";
+const TRANSCRIPT = [
+    "\x1b[2mmodel cursor-grok-4.6-high\x1b[0m",
+    "\x1b[2m> \x1b[0mReading the plan to work out which files this case touches.",
+    "\x1b[36m! \x1b[0mRead  work/tc-runs/_plans/tc-11.yaml",
+    "» Starting on the migration checks described in the plan.",
+    "\x1b[36m! \x1b[0mShell  npm run build && npm test -- --reporter=dot",
+    "\x1b[31mx \x1b[0mShell  npm run build && npm test -- --reporter=dot",
+    "\x1b[2m> \x1b[0mThe build failed on a type error; re-reading the offending module.",
+    "\x1b[36m! \x1b[0mGlob  src/**/*.{ts,tsx}",
+    "» ⚠️ One expected result could not be confirmed — recording it as UNVERIFIED.",
+    "\x1b[36m! \x1b[0mWrite  work/tc-runs/tc-11-temp/_results.md",
+];
+const usage = (n) => ({
+    inputTokens: 1200 * n + 431,
+    outputTokens: 90 * n + 17,
+    cacheReadTokens: 5600 * n,
+    cacheWriteTokens: n % 3 === 0 ? 0 : 128 * n,
+});
+const MODELS = ["cursor-grok-4.6-high", "composer-2.5", "cursor-grok-4.6-high", "composer-2.5"];
+function demoPanes() {
+    const shapes = [
+        ["run", false],
+        ["run", true],
+        ["ok", true],
+        ["error", false],
+        ["timeout", false],
+        ["no-output", false],
+        ["no-folder", false],
+        ["idle", false],
+    ];
+    return shapes.map(([status, withUsage], i) => ({
+        slot: i,
+        name: status === "idle" ? null : `tc-${i * 7 + 11}`,
+        model: MODELS[i % MODELS.length],
+        status,
+        elapsedSeconds: status === "idle" ? 0 : 37 + i * 211,
+        tools: status === "idle" ? 0 : 3 + i * 17,
+        streamedBytes: status === "idle" ? 0 : 1024 * (i + 1) * 37,
+        usage: withUsage ? usage(i + 1) : null,
+        note: status === "timeout" ? "agent exceeded the 60 minute deadline" : "",
+        transcript: status === "run" || status === "ok" ? TRANSCRIPT : TRANSCRIPT.slice(0, 3),
+        thinking: status === "run" ? "Now checking the remaining assertions" : "",
+    }));
+}
+function demoTable() {
+    const rows = [];
+    for (let i = 1; i <= 40; i += 1) {
+        const kind = i % 5;
+        if (kind === 0) {
+            rows.push({
+                name: `tc-${i}`,
+                status: "Prior",
+                outcome: "Passed",
+                duration: "—",
+                tools: "—",
+                inn: "—",
+                out: "—",
+                cache_r: "—",
+                cache_w: "—",
+            });
+        }
+        else if (kind === 1) {
+            rows.push({
+                name: `tc-${i}`,
+                status: "Pending",
+                outcome: "—",
+                duration: "—",
+                tools: "—",
+                inn: "—",
+                out: "—",
+                cache_r: "—",
+                cache_w: "—",
+            });
+        }
+        else if (kind === 2) {
+            rows.push({
+                name: `tc-${i}`,
+                status: "Running",
+                outcome: "—",
+                duration: "04:31",
+                tools: "87",
+                inn: "—",
+                out: "—",
+                cache_r: "—",
+                cache_w: "—",
+            });
+        }
+        else if (kind === 3) {
+            rows.push({
+                name: `tc-${i}`,
+                status: "Done",
+                outcome: "Passed",
+                duration: "12:04",
+                tools: "143",
+                inn: "1.2k",
+                out: "340",
+                cache_r: "5.6k",
+                cache_w: "128",
+            });
+        }
+        else {
+            rows.push({
+                name: `tc-${i}`,
+                status: "Failed",
+                outcome: i % 3 === 0 ? "Unverified" : "Timeout",
+                duration: "1:02:03",
+                tools: "12",
+                inn: "1.5M",
+                out: "12.3k",
+                cache_r: "999",
+                cache_w: "0",
+            });
+        }
+    }
+    return rows;
+}
+const TOTALS = {
+    name: "Total",
+    status: "—",
+    outcome: "—",
+    duration: "3:41:12",
+    tools: "1834",
+    inn: "1.5M",
+    out: "48.2k",
+    cache_r: "212.4k",
+    cache_w: "3.1k",
+};
+/** A canned frame, so the TUI can be eyeballed at any size without launching an agent. */
+export async function runDemo(opts) {
+    const panes = demoPanes();
+    const table = demoTable();
+    const screen = new Screen(opts.once !== true);
+    if (opts.table)
+        screen.mode = "table";
+    const shown = panes.slice(0, opts.panes ?? panes.length);
+    const build = () => {
+        screen.visibleSlots = shown.map((p) => p.slot);
+        return {
+            mode: screen.mode,
+            zoom: screen.zoom,
+            scroll: screen.scroll,
+            running: shown.filter((p) => p.status === "run").length,
+            parallel: panes.length,
+            queued: 27,
+            paused: false,
+            draining: false,
+            panes: shown,
+            panesNote: "waiting on tag: build",
+            table,
+            totals: TOTALS,
+            statusLeft: " 2+27/40  1:14:22  in 1.5M  out 48.2k  cache-r 212.4k  cache-w 3.1k",
+        };
+    };
+    const size = () => {
+        const [r, c] = screen.size();
+        return [opts.rows ?? r, opts.cols ?? c];
+    };
+    if (opts.once === true || !screen.enabled) {
+        const [rows, cols] = [opts.rows ?? 24, opts.cols ?? 80];
+        process.stdout.write(`${frame(build(), rows, cols).lines.join("\n")}\n`);
+        return 0;
+    }
+    let stop = false;
+    screen.enter();
+    const restore = () => screen.restore();
+    process.once("exit", restore);
+    screen.listen({
+        requestStop: () => {
+            stop = true;
+        },
+        requestDrain: () => { },
+        togglePause: () => { },
+    });
+    try {
+        while (!stop) {
+            const [rows, cols] = size();
+            const laid = frame(build(), rows, cols);
+            screen.scroll = laid.scroll;
+            screen.page = laid.page;
+            screen.render(laid.lines, rows, cols);
+            await sleep(1000 / RENDER_HZ);
+        }
+    }
+    finally {
+        screen.restore();
+        process.off("exit", restore);
+    }
+    return 0;
+}
+//# sourceMappingURL=demo.js.map

package/dist/qa/demo.js.map

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

package/dist/qa/format.d.ts

@@ -0,0 +1,38 @@
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const DIM = "\u001B[2m";
+export declare const REV = "\u001B[7m";
+export declare const RED = "\u001B[31m";
+export declare const GREEN = "\u001B[32m";
+export declare const YELLOW = "\u001B[33m";
+export declare const CYAN = "\u001B[36m";
+/** Terminal cell width of one code point: 0, 1, or 2. Python: char_width. */
+export declare function charWidth(cp: number): 0 | 1 | 2;
+export interface Token {
+    readonly text: string;
+    readonly w: number;
+    readonly ansi: boolean;
+}
+/**
+ * One pass over `text`, yielding either a whole CSI sequence (width 0) or a single CODE POINT.
+ * Every width-aware function goes through here — Python iterates code points, and JS string
+ * indexing iterates UTF-16 units, so a naive port splits every astral emoji in half.
+ */
+export declare function tokens(text: string): Generator<Token>;
+/** Visible cell width, ignoring CSI. Wide glyphs count as 2. */
+export declare function displayWidth(text: string): number;
+/** Keep at most `width` display cells, preserving CSI, and always reset. */
+export declare function clipAnsi(text: string, width: number): string;
+/** Full-width reverse-video bar. Re-opens reverse after any RESET in `text`. */
+export declare function invertBar(text: string, width: number): string;
+export declare function padClip(text: string, width: number): string;
+/** Wrap `text` to `width` display cells, breaking on spaces when possible. */
+export declare function wrapAnsi(text: string, width: number): string[];
+export declare function fmtDuration(seconds: number): string;
+export declare function fmtCount(n: number): string;
+export declare function fmtBytes(n: number): string;
+export declare function flatten(text: string): string;
+/** Python: `not line.strip()` */
+export declare function isBlank(text: string): boolean;
+/** Python: text.strip() — the wide whitespace set. */
+export declare function pyStrip(text: string): string;

package/dist/qa/format.js

@@ -0,0 +1,208 @@
+import { eastAsianWidthType } from "get-east-asian-width";
+export const RESET = "\x1b[0m";
+export const BOLD = "\x1b[1m";
+export const DIM = "\x1b[2m";
+export const REV = "\x1b[7m";
+export const RED = "\x1b[31m";
+export const GREEN = "\x1b[32m";
+export const YELLOW = "\x1b[33m";
+export const CYAN = "\x1b[36m";
+/** Sticky so `exec` anchors at `lastIndex`, matching Python's `CSI.match(text, i)`. */
+// eslint-disable-next-line no-control-regex
+const CSI = /\x1b\[[0-9;]*[A-Za-z]/y;
+/** Python: unicodedata.category(ch) in ("Mn", "Me", "Cf") */
+const ZERO_CATEGORY = /^[\p{Mn}\p{Me}\p{Cf}]$/u;
+/**
+ * Python's whitespace set for `str` — what `str.strip()` and `re.sub(r"\s+")` act on.
+ * Spelled out rather than reusing JS `\s`, which differs at both ends: it omits
+ * \x1c-\x1f and \x85, and it *adds* \ufeff (the BOM), which Python treats as ordinary.
+ */
+const PY_WS = "\\t\\n\\v\\f\\r\\x1c\\x1d\\x1e\\x1f\\x20\\x85\\xa0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000";
+const PY_SPACE = new RegExp(`[${PY_WS}]`, "u");
+const PY_SPACE_RUN = new RegExp(`[${PY_WS}]+`, "gu");
+const PY_BLANK = new RegExp(`^[${PY_WS}]*$`, "u");
+const bmpCache = new Int8Array(0x10000).fill(-1);
+function computeWidth(cp) {
+    if (cp === 0)
+        return 0;
+    if (ZERO_CATEGORY.test(String.fromCodePoint(cp)))
+        return 0;
+    if (cp < 32 || (cp >= 0x7f && cp < 0xa0))
+        return 0;
+    const eaw = eastAsianWidthType(cp);
+    if (eaw === "fullwidth" || eaw === "wide")
+        return 2;
+    if (cp >= 0x1f300)
+        return 2;
+    return 1;
+}
+/** Terminal cell width of one code point: 0, 1, or 2. Python: char_width. */
+export function charWidth(cp) {
+    if (cp < 0x10000) {
+        const cached = bmpCache[cp];
+        if (cached >= 0)
+            return cached;
+        const width = computeWidth(cp);
+        bmpCache[cp] = width;
+        return width;
+    }
+    return computeWidth(cp);
+}
+/**
+ * One pass over `text`, yielding either a whole CSI sequence (width 0) or a single CODE POINT.
+ * Every width-aware function goes through here — Python iterates code points, and JS string
+ * indexing iterates UTF-16 units, so a naive port splits every astral emoji in half.
+ */
+export function* tokens(text) {
+    let i = 0;
+    while (i < text.length) {
+        if (text[i] === "\x1b") {
+            CSI.lastIndex = i;
+            const match = CSI.exec(text);
+            if (match) {
+                yield { text: match[0], w: 0, ansi: true };
+                i = CSI.lastIndex;
+                continue;
+            }
+        }
+        const cp = text.codePointAt(i);
+        const s = String.fromCodePoint(cp);
+        yield { text: s, w: charWidth(cp), ansi: false };
+        i += s.length;
+    }
+}
+/** Visible cell width, ignoring CSI. Wide glyphs count as 2. */
+export function displayWidth(text) {
+    let width = 0;
+    for (const token of tokens(text))
+        width += token.w;
+    return width;
+}
+/** Keep at most `width` display cells, preserving CSI, and always reset. */
+export function clipAnsi(text, width) {
+    if (width <= 0)
+        return RESET;
+    const out = [];
+    let vis = 0;
+    for (const token of tokens(text)) {
+        if (vis >= width)
+            break;
+        if (token.ansi) {
+            out.push(token.text);
+            continue;
+        }
+        if (vis + token.w > width)
+            break;
+        out.push(token.text);
+        vis += token.w;
+    }
+    return out.join("") + RESET;
+}
+/** Full-width reverse-video bar. Re-opens reverse after any RESET in `text`. */
+export function invertBar(text, width) {
+    const clipped = clipAnsi(text, width);
+    const pad = " ".repeat(Math.max(0, width - displayWidth(clipped)));
+    const body = clipped.replaceAll(RESET, RESET + REV) + pad;
+    return `${REV}${body}${RESET}`;
+}
+export function padClip(text, width) {
+    const clipped = clipAnsi(text, width);
+    const pad = width - displayWidth(clipped);
+    return pad > 0 ? clipped + " ".repeat(pad) : clipped;
+}
+/** Python: text.strip(" ") / text.rstrip(" ") — U+0020 ONLY, never .trim(). */
+const stripSpaces = (s) => s.replace(/^ +/, "").replace(/ +$/, "");
+const rstripSpaces = (s) => s.replace(/ +$/, "");
+/** Wrap `text` to `width` display cells, breaking on spaces when possible. */
+export function wrapAnsi(text, width) {
+    if (width < 1)
+        return [];
+    if (displayWidth(text) <= width)
+        return text ? [text] : [];
+    const toks = [...tokens(text)];
+    const lines = [];
+    let current = [];
+    let currentW = 0;
+    let spaceAt = -1;
+    const emit = (parts) => {
+        const line = parts.map((t) => t.text).join("");
+        if (stripSpaces(line) || parts.some((t) => t.ansi))
+            lines.push(rstripSpaces(line));
+    };
+    for (const token of toks) {
+        const { w } = token;
+        if (w > 0 && currentW + w > width && current.length > 0) {
+            if (spaceAt >= 0) {
+                emit(current.slice(0, spaceAt + 1));
+                const rest = current.slice(spaceAt + 1);
+                current = rest.filter((t) => !(t.text === " " && t.w === 1));
+                currentW = current.reduce((sum, t) => sum + t.w, 0);
+                spaceAt = -1;
+            }
+            else {
+                emit(current);
+                current = [];
+                currentW = 0;
+                spaceAt = -1;
+            }
+            if (w > 0 && currentW + w > width) {
+                emit([token]);
+                continue;
+            }
+        }
+        current.push(token);
+        currentW += w;
+        if (token.text === " " && w === 1)
+            spaceAt = current.length - 1;
+    }
+    if (current.length > 0)
+        emit(current);
+    return lines.length > 0 ? lines : text ? [text] : [];
+}
+export function fmtDuration(seconds) {
+    const total = Math.max(0, Math.trunc(seconds));
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    const secs = total % 60;
+    const pad = (n) => String(n).padStart(2, "0");
+    return hours ? `${hours}:${pad(minutes)}:${pad(secs)}` : `${pad(minutes)}:${pad(secs)}`;
+}
+/**
+ * Python f"{x:.1f}". Both `toFixed` and Python's formatter round the *exact* double, and they
+ * only disagree on a true midpoint — which needs value = odd/20, never a dyadic rational, so it
+ * cannot arise from the n/1000 and n/1000000 divisions here. Do NOT pre-scale by 10: that
+ * collapses 1.05000000000000004 to exactly 10.5 and rounds the wrong way.
+ */
+const fixed1 = (value) => value.toFixed(1);
+export function fmtCount(n) {
+    if (n >= 1_000_000)
+        return `${fixed1(n / 1_000_000)}M`;
+    if (n >= 1_000)
+        return `${fixed1(n / 1_000)}k`;
+    return String(n);
+}
+export function fmtBytes(n) {
+    if (n >= 1_000_000)
+        return `${fixed1(n / 1_000_000)} MB`;
+    if (n >= 1_000)
+        return `${Math.round(n / 1_000)} KB`;
+    return `${n} B`;
+}
+export function flatten(text) {
+    return text.replace(PY_SPACE_RUN, " ").replace(/^ +| +$/g, "");
+}
+/** Python: `not line.strip()` */
+export function isBlank(text) {
+    return PY_BLANK.test(text);
+}
+/** Python: text.strip() — the wide whitespace set. */
+export function pyStrip(text) {
+    let start = 0;
+    let end = text.length;
+    while (start < end && PY_SPACE.test(text[start]))
+        start += 1;
+    while (end > start && PY_SPACE.test(text[end - 1]))
+        end -= 1;
+    return text.slice(start, end);
+}
+//# sourceMappingURL=format.js.map

package/dist/qa/format.js.map

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

package/dist/qa/harness.d.ts

@@ -0,0 +1,68 @@
+import type { Options } from "./config.js";
+import type { Case } from "./cases.js";
+import type { ViewModel } from "./layout.js";
+import type { Rec, SessionInfo, SessionStats } from "./reports.js";
+/** datetime.now(timezone.utc).strftime("%Y%m%d-%H%M%S") */
+export declare function runId(d?: Date): string;
+export declare class Harness {
+    private readonly options;
+    private readonly cases;
+    private readonly allCases;
+    private readonly prior;
+    private readonly byName;
+    private sched;
+    private readonly slots;
+    private readonly live;
+    private readonly records;
+    private readonly gate;
+    private readonly cleanup;
+    private readonly screen;
+    private readonly startedMs;
+    private readonly runId;
+    private readonly pid;
+    private readonly logRoot;
+    private readonly sessionLog;
+    private trackerPath;
+    private lock;
+    paused: boolean;
+    draining: boolean;
+    stopLevel: number;
+    constructor(options: Options, cases: Case[], allCases: Case[]);
+    private get info();
+    private progress;
+    private finishedRecords;
+    sessionStats(): SessionStats;
+    private tableRows;
+    private tableTotals;
+    recordOutcome: (rec: Rec) => string;
+    private statusLeft;
+    private paneView;
+    /**
+     * The slots worth a pane: the ones actually running. With nothing running and nothing left to
+     * dispatch — the end of a session — the finished slots stand in so the final frame still shows
+     * every result. With work still queued, the region stays empty and says why instead, since a
+     * queue held up by a barrier or a tag is exactly the state worth seeing.
+     */
+    private visibleSlots;
+    viewModel(): ViewModel;
+    /** Why the pane region is empty — without this a tag-blocked queue looks like a hang. */
+    private panesNote;
+    private renderOnce;
+    togglePause(): void;
+    requestDrain(): void;
+    requestStop(): void;
+    private logPlain;
+    private writeSummary;
+    private writeTracker;
+    exitCode(): number;
+    private runCase;
+    private recordSkipped;
+    private recordHarnessError;
+    private worker;
+    private renderLoop;
+    run(): Promise<number>;
+    /** Acquire the lock, run inside the alt screen, print the summary, always clean up. */
+    main(): Promise<number>;
+    get sessionRecords(): readonly Rec[];
+    get sessionInfo(): SessionInfo;
+}