@cairn-tool/cairn 3.3.1 → 3.5.0

package/dist/qa/schedule.js

@@ -0,0 +1,145 @@
+/**
+ * The work queue plus the per-case concurrency constraints.
+ *
+ * A `parallel: true` case is unconstrained (except by the per-backend cap). A
+ * `parallel: false` case with tags holds each of those tags as a mutex while it
+ * runs. A `parallel: false` case with no tags is a barrier: nothing runs beside
+ * it, and nothing behind it starts while it waits for the agents in front to finish.
+ *
+ * Invariant: with `running === 0` and a non-empty queue this never returns null —
+ * no tag can be held, an exclusive case is startable, and a per-backend cap is
+ * skipped when the queue is idle so a cap can never deadlock an idle queue.
+ */
+export class Scheduler {
+    pending;
+    heldTags = new Set();
+    caps;
+    agentRunning = new Map();
+    running = 0;
+    exclusive = null;
+    waiters = [];
+    /** Bumped by every wake. A worker samples it before `take()` so a wake cannot be lost. */
+    generation = 0;
+    /** Set by `take()` when it returns null, so the TUI can say why nothing is starting. */
+    blocked = null;
+    constructor(cases, caps = new Map()) {
+        this.pending = [...cases];
+        this.caps = caps;
+    }
+    /** Cases not yet dispatched. */
+    get size() {
+        return this.pending.length;
+    }
+    get inFlight() {
+        return this.running;
+    }
+    /** Sample before `take()`; hand back to `changed()` so a wake in between is not missed. */
+    get generationId() {
+        return this.generation;
+    }
+    capFor(kase) {
+        return this.caps.get(kase.agentName) ?? Number.POSITIVE_INFINITY;
+    }
+    atCap(kase) {
+        return (this.agentRunning.get(kase.agentName) ?? 0) >= this.capFor(kase);
+    }
+    /**
+     * The first case that may start right now, with its tags reserved. Null when the queue is empty
+     * or every startable candidate is blocked.
+     *
+     * Invariant: with `running === 0` and a non-empty queue this never returns null — no tag can be
+     * held and an exclusive case is startable — so a queue can never stall with nothing in flight.
+     */
+    take() {
+        if (this.pending.length === 0) {
+            this.blocked = null;
+            return null;
+        }
+        if (this.exclusive !== null) {
+            this.blocked = `${this.exclusive.name} is running alone`;
+            return null;
+        }
+        const waitingOn = new Set();
+        const waitingAgents = new Set();
+        for (const [i, kase] of this.pending.entries()) {
+            if (this.atCap(kase) && this.running > 0) {
+                waitingAgents.add(kase.agentName);
+                continue;
+            }
+            if (kase.parallel)
+                return this.claim(i, kase);
+            if (kase.tags.length === 0) {
+                if (this.running === 0)
+                    return this.claim(i, kase);
+                // A barrier: hold everything behind it rather than starving it.
+                this.blocked = `waiting for ${this.running} agent(s) to finish before ${kase.name}`;
+                return null;
+            }
+            const clash = kase.tags.filter((t) => this.heldTags.has(t));
+            if (clash.length === 0)
+                return this.claim(i, kase);
+            for (const tag of clash)
+                waitingOn.add(tag);
+        }
+        if (waitingAgents.size > 0) {
+            this.blocked = `waiting on agent cap: ${[...waitingAgents].sort().join(", ")}`;
+            return null;
+        }
+        this.blocked =
+            waitingOn.size > 0 ? `waiting on tag: ${[...waitingOn].sort().join(", ")}` : null;
+        return null;
+    }
+    claim(index, kase) {
+        this.pending.splice(index, 1);
+        this.running += 1;
+        this.agentRunning.set(kase.agentName, (this.agentRunning.get(kase.agentName) ?? 0) + 1);
+        this.blocked = null;
+        if (kase.parallel)
+            return kase;
+        if (kase.tags.length === 0)
+            this.exclusive = kase;
+        else
+            for (const tag of kase.tags)
+                this.heldTags.add(tag);
+        return kase;
+    }
+    /** Give back whatever `take()` reserved, then wake every parked worker to re-scan. */
+    release(kase) {
+        this.running = Math.max(0, this.running - 1);
+        const held = (this.agentRunning.get(kase.agentName) ?? 1) - 1;
+        if (held <= 0)
+            this.agentRunning.delete(kase.agentName);
+        else
+            this.agentRunning.set(kase.agentName, held);
+        if (this.exclusive === kase)
+            this.exclusive = null;
+        for (const tag of kase.tags)
+            this.heldTags.delete(tag);
+        this.wake();
+    }
+    /** Release parked workers without freeing anything — for stop and drain. */
+    wake() {
+        this.generation += 1;
+        const parked = this.waiters;
+        this.waiters = [];
+        for (const resume of parked)
+            resume();
+    }
+    /**
+     * Park until something is released, or the harness wakes us to shut down. `seen` is the
+     * generation sampled before the `take()` that came back empty: if a wake landed in between,
+     * this returns immediately rather than sleeping through it.
+     */
+    changed(seen) {
+        if (seen !== this.generation)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            this.waiters.push(resolve);
+        });
+    }
+    /** Why nothing can start, for the pane region when no agent is running. */
+    blockedReason() {
+        return this.blocked;
+    }
+}
+//# sourceMappingURL=schedule.js.map

package/dist/qa/schedule.js.map

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

package/dist/qa/screen.d.ts

@@ -0,0 +1,31 @@
+/** What Screen needs from the harness to act on a keypress. */
+export interface KeyTarget {
+    requestStop(): void;
+    requestDrain(): void;
+    togglePause(): void;
+}
+export declare class Screen {
+    readonly enabled: boolean;
+    mode: "panes" | "table";
+    /** The zoomed *slot id*, not a screen position — panes come and go as cases start and finish. */
+    zoom: number | null;
+    /** Slot ids currently on screen, in order, refreshed each frame. Digit `k` picks the k-th. */
+    visibleSlots: readonly number[];
+    scroll: number;
+    page: number;
+    private entered;
+    private restored;
+    private stopKeys;
+    constructor(enabled: boolean);
+    enter(): void;
+    /** Idempotent, synchronous, safe to call from an exit handler. */
+    restore(): void;
+    size(): [rows: number, cols: number];
+    render(frame: readonly string[], rows: number, cols: number): void;
+    /**
+     * Read keys in raw mode. The 250 ms debounce replaces the Python's separate keyboard task:
+     * a buffer still holding a lone ESC after that long is a real Escape keypress.
+     */
+    listen(target: KeyTarget, onKey?: () => void): void;
+    handleKey(key: string, target: KeyTarget): void;
+}

package/dist/qa/screen.js

@@ -0,0 +1,146 @@
+import { writeSync } from "node:fs";
+import { padClip } from "./format.js";
+import { KeyDecoder } from "./keys.js";
+const ENTER = "\x1b[?1049h\x1b[?7l\x1b[?25l\x1b[H\x1b[2J";
+const LEAVE = "\x1b[?7h\x1b[?25h\x1b[?1049l";
+export class Screen {
+    enabled;
+    mode = "panes";
+    /** The zoomed *slot id*, not a screen position — panes come and go as cases start and finish. */
+    zoom = null;
+    /** Slot ids currently on screen, in order, refreshed each frame. Digit `k` picks the k-th. */
+    visibleSlots = [];
+    scroll = 0;
+    page = 10;
+    entered = false;
+    restored = false;
+    stopKeys = null;
+    constructor(enabled) {
+        this.enabled = enabled && process.stdout.isTTY === true && process.stdin.isTTY === true;
+    }
+    enter() {
+        if (!this.enabled || this.entered)
+            return;
+        this.entered = true;
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        // writeSync, not process.stdout.write: guaranteed to land even during teardown.
+        writeSync(1, ENTER);
+    }
+    /** Idempotent, synchronous, safe to call from an exit handler. */
+    restore() {
+        if (!this.entered || this.restored)
+            return;
+        this.restored = true;
+        this.stopKeys?.();
+        this.stopKeys = null;
+        try {
+            writeSync(1, LEAVE);
+        }
+        catch {
+            /* stdout already gone */
+        }
+        try {
+            process.stdin.setRawMode(false);
+        }
+        catch {
+            /* not a tty any more */
+        }
+        // Not optional: a resumed TTY holds an active handle and the CLI would hang on exit.
+        process.stdin.pause();
+    }
+    size() {
+        return [process.stdout.rows || 24, process.stdout.columns || 80];
+    }
+    render(frame, rows, cols) {
+        if (!this.enabled)
+            return;
+        const shown = frame.slice(0, rows);
+        const buf = ["\x1b[H"];
+        const last = shown.length - 1;
+        for (const [i, line] of shown.entries()) {
+            buf.push(padClip(line, cols), "\x1b[K");
+            if (i !== last)
+                buf.push("\r\n");
+        }
+        if (shown.length < rows)
+            buf.push("\x1b[J");
+        process.stdout.write(buf.join(""));
+    }
+    /**
+     * Read keys in raw mode. The 250 ms debounce replaces the Python's separate keyboard task:
+     * a buffer still holding a lone ESC after that long is a real Escape keypress.
+     */
+    listen(target, onKey) {
+        if (!this.enabled || this.stopKeys)
+            return;
+        const decoder = new KeyDecoder();
+        let timer;
+        const deliver = (keys) => {
+            for (const key of keys)
+                this.handleKey(key, target);
+            if (keys.length > 0)
+                onKey?.();
+        };
+        const onData = (chunk) => {
+            if (timer)
+                clearTimeout(timer);
+            deliver(decoder.push(chunk.toString("utf8")));
+            if (decoder.pending) {
+                timer = setTimeout(() => deliver(decoder.flush()), 250);
+                timer.unref();
+            }
+        };
+        process.stdin.on("data", onData);
+        this.stopKeys = () => {
+            process.stdin.off("data", onData);
+            if (timer)
+                clearTimeout(timer);
+        };
+    }
+    handleKey(key, target) {
+        if (key === "q" || key === "Q" || key === "\x03") {
+            target.requestStop();
+            return;
+        }
+        if (key === "p" || key === "P") {
+            target.togglePause();
+            return;
+        }
+        if (key === "d" || key === "D") {
+            target.requestDrain();
+            return;
+        }
+        if (key === "r" || key === "R") {
+            this.mode = this.mode === "table" ? "panes" : "table";
+            return;
+        }
+        if (this.mode === "table") {
+            if (key === "esc" || key === "0")
+                this.mode = "panes";
+            else if (key === "up")
+                this.scroll -= 1;
+            else if (key === "down")
+                this.scroll += 1;
+            else if (key === "pgup")
+                this.scroll -= this.page;
+            else if (key === "pgdn")
+                this.scroll += this.page;
+            else if (key === "home")
+                this.scroll = 0;
+            else if (key === "end")
+                this.scroll = 10 ** 9;
+            return;
+        }
+        if (key === "esc" || key === "0") {
+            this.zoom = null;
+        }
+        else if (key.length === 1 && key >= "1" && key <= "9") {
+            // The digit is the pane's position on screen, which is the number its header shows.
+            const slot = this.visibleSlots[Number.parseInt(key, 10) - 1];
+            if (slot !== undefined)
+                this.zoom = this.zoom === slot ? null : slot;
+        }
+    }
+}
+//# sourceMappingURL=screen.js.map

package/dist/qa/screen.js.map

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

package/dist/qa/slot.d.ts

@@ -0,0 +1,28 @@
+import type { Usage } from "./outcome.js";
+import type { Case } from "./cases.js";
+import type { QaEvent } from "./agents/types.js";
+export type SlotStatus = "idle" | "run" | "ok" | "error" | "timeout" | "no-output" | "no-folder" | "skipped";
+export declare class Slot {
+    readonly index: number;
+    case: Case | null;
+    status: SlotStatus;
+    startedMs: number | null;
+    endedMs: number | null;
+    tools: number;
+    currentTool: string;
+    streamedBytes: number;
+    usage: Usage | null;
+    sessionId: string;
+    exitCode: number | null;
+    note: string;
+    thinking: string;
+    transcript: string[];
+    logDir: string | null;
+    private transcriptFd;
+    constructor(index: number);
+    reset(kase: Case | null, logDir?: string | null): void;
+    closeTranscript(): void;
+    add(line: string): void;
+    elapsedSeconds(nowMs: number): number;
+    applyEvent(event: QaEvent): void;
+}

package/dist/qa/slot.js

@@ -0,0 +1,126 @@
+import { closeSync, mkdirSync, openSync, writeSync } from "node:fs";
+import { join } from "node:path";
+import { CYAN, DIM, RED, RESET, flatten, pyStrip } from "./format.js";
+import { TRANSCRIPT_CAP } from "./config.js";
+export class Slot {
+    index;
+    case = null;
+    status = "idle";
+    startedMs = null;
+    endedMs = null;
+    tools = 0;
+    currentTool = "";
+    streamedBytes = 0;
+    usage = null;
+    sessionId = "";
+    exitCode = null;
+    note = "";
+    thinking = "";
+    transcript = [];
+    logDir = null;
+    transcriptFd = null;
+    constructor(index) {
+        this.index = index;
+    }
+    reset(kase, logDir = null) {
+        this.closeTranscript();
+        this.case = kase;
+        this.status = kase === null ? "idle" : "run";
+        this.startedMs = kase ? performance.now() : null;
+        this.endedMs = null;
+        this.tools = 0;
+        this.currentTool = "";
+        this.streamedBytes = 0;
+        this.usage = null;
+        this.sessionId = "";
+        this.exitCode = null;
+        this.note = "";
+        this.thinking = "";
+        this.transcript = [];
+        this.logDir = logDir;
+        if (logDir !== null) {
+            mkdirSync(logDir, { recursive: true });
+            // Append + writeSync per line: a SIGKILLed harness must leave a complete transcript.
+            this.transcriptFd = openSync(join(logDir, "transcript.txt"), "a");
+        }
+    }
+    closeTranscript() {
+        if (this.transcriptFd === null)
+            return;
+        try {
+            closeSync(this.transcriptFd);
+        }
+        catch {
+            /* already gone */
+        }
+        this.transcriptFd = null;
+    }
+    add(line) {
+        const text = line.replace(/\n+$/, "");
+        if (text === "")
+            return;
+        this.transcript.push(text);
+        if (this.transcript.length > TRANSCRIPT_CAP) {
+            this.transcript.splice(0, this.transcript.length - TRANSCRIPT_CAP);
+        }
+        if (this.transcriptFd !== null) {
+            try {
+                writeSync(this.transcriptFd, `${text}\n`);
+            }
+            catch {
+                /* the log is best-effort; never take the run down for it */
+            }
+        }
+    }
+    elapsedSeconds(nowMs) {
+        if (this.startedMs === null)
+            return 0;
+        const end = this.endedMs ?? nowMs;
+        return (end - this.startedMs) / 1000;
+    }
+    applyEvent(event) {
+        if (event.sessionId && !this.sessionId)
+            this.sessionId = event.sessionId;
+        if (event.kind === "thinking") {
+            if (event.phase === "delta") {
+                this.thinking += event.text ?? "";
+            }
+            else {
+                const text = event.text ?? this.thinking;
+                if (pyStrip(text) !== "") {
+                    this.add(`${DIM}> ${RESET}${flatten(text)}`);
+                }
+                this.thinking = "";
+            }
+            return;
+        }
+        if (event.kind === "text") {
+            this.add(`» ${flatten(event.text)}`);
+            return;
+        }
+        if (event.kind === "tool") {
+            const shown = `${event.name}  ${event.summary}`.replace(/[ \t\n\r\v\f]+$/, "");
+            if (event.phase === "started") {
+                this.tools += 1;
+                this.currentTool = shown;
+                this.add(`${CYAN}! ${RESET}${shown}`);
+            }
+            else {
+                this.currentTool = "";
+                if (event.failed)
+                    this.add(`${RED}x ${RESET}${shown}`);
+            }
+            return;
+        }
+        if (event.kind === "usage") {
+            this.usage = event.usage;
+            if (event.error)
+                this.note = flatten(event.error).slice(0, 160);
+            return;
+        }
+        if (event.kind === "init" && event.model) {
+            this.add(`${DIM}model ${event.model}${RESET}`);
+        }
+    }
+}
+//# sourceMappingURL=slot.js.map

package/dist/qa/slot.js.map

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

package/dist/qa/tracker.d.ts

@@ -0,0 +1,36 @@
+export interface CaseAudit {
+    has: Record<string, boolean>;
+    artifacts: number;
+    notes: string[];
+    verdict: string;
+    passed: number;
+    failed: number;
+    total: number;
+    ticked: number;
+    unticked: number;
+    fidelity: string;
+}
+/** The verbatim body of the fenced block under a `## Script <name>` heading. */
+export declare function sourceScript(scripts: string, name: string): string | null;
+/** The case's title and priority as the index states them. */
+export declare function indexRow(tc: number, indexText: string): [string, string];
+/** The body of `## <number>. …` up to `## <following>.`, or "" when absent. */
+export declare function section(text: string, number: string, following: string): string;
+/** The Verdict column only. A tick elsewhere in the row is prose, not a result. */
+export declare function rowVerdict(row: string): string;
+/** Whether the executed script matches its documented source, and how it differs if not. */
+export declare function scriptFidelity(folder: string, files: ReadonlySet<string>, scripts: string | null): [string, string];
+/** Python: int(name.split("-")[1].removesuffix(".md")) */
+export declare function caseNumber(name: string): number;
+/** Everything the tracker knows about one case, whether or not it has been run. */
+export declare function audit(tc: number, runs: string, scripts: string | null, planFile?: string | null): CaseAudit;
+/** Python: date.today().isoformat() — LOCAL date. toISOString() would be UTC and can be a day off. */
+export declare function todayIso(d?: Date): string;
+export interface TrackerResult {
+    path: string;
+    planned: number;
+    run: number;
+    tally: Record<string, number>;
+}
+/** Write `<runs_dir>/summary.md`, re-deriving every column from the files on disk. */
+export declare function writeCaseTracker(runsDir: string): TrackerResult;