@cairn-tool/cairn 3.3.1 → 3.5.0

package/dist/qa/cases.js

@@ -0,0 +1,144 @@
+import { existsSync, statSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative } from "node:path";
+import { displayBinary, resolveAgent, resolveBinary } from "./agents/index.js";
+import { loadCaseFiles } from "./casefile.js";
+export class Case {
+    name;
+    number;
+    /** Absolute path to `_plans/tc-N.yaml`. */
+    file;
+    outDir;
+    repo;
+    /** The YAML `name` — a human title, distinct from `name` above, which is the identity. */
+    title;
+    agentName;
+    model;
+    parallel;
+    tags;
+    /** The plan text itself, verbatim from the YAML block scalar. */
+    plan;
+    constructor(spec, outDir, repo, defaultModel) {
+        this.name = spec.name;
+        this.number = spec.number;
+        this.file = spec.file;
+        this.outDir = outDir;
+        this.repo = repo;
+        this.title = spec.title;
+        this.agentName = spec.agent;
+        this.model = spec.model ?? defaultModel;
+        this.parallel = spec.parallel;
+        this.tags = spec.tags;
+        this.plan = spec.plan;
+    }
+    /** Python: Path.relative_to(repo).as_posix(), falling back to the absolute path. */
+    rel(path) {
+        const rel = relative(this.repo, path);
+        if (rel === "" || rel.startsWith("..") || isAbsolute(rel))
+            return path;
+        return rel;
+    }
+    get fileRel() {
+        return this.rel(this.file);
+    }
+    get outRel() {
+        return `${this.rel(this.outDir)}/`;
+    }
+    get tempDir() {
+        return join(dirname(this.outDir), `${basename(this.outDir)}-temp`);
+    }
+    get tempRel() {
+        return `${this.rel(this.tempDir)}/`;
+    }
+    /** How this case schedules, for the dry-run listing and the pane note. */
+    get constraint() {
+        if (this.parallel)
+            return "parallel";
+        if (this.tags.length === 0)
+            return "exclusive";
+        return `tags ${this.tags.join(", ")}`;
+    }
+    /**
+     * Load-bearing: handed verbatim to cursor-agent. The dash is an em dash (U+2014). The plan is
+     * inlined rather than @-referenced, so the write constraint is stated before it, not after.
+     */
+    get prompt() {
+        return (`Perform the test-case plan below. Write every deliverable to ${this.tempRel}, ` +
+            `creating that folder yourself. Do not write to ${this.outRel} — the harness ` +
+            `renames the temp folder there only after this run succeeds.\n\n---\n\n${this.plan}`);
+    }
+}
+/** Python: int(re.search(r"(\d+)", name).group(1)) */
+export function caseNumber(name) {
+    const match = /(\d+)/.exec(name);
+    if (!match)
+        throw new Error(`no number in case name: ${name}`);
+    return Number.parseInt(match[1], 10);
+}
+function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function fallbackModel(spec, defaults) {
+    if (typeof defaults === "string")
+        return spec.model ?? defaults;
+    return spec.model ?? defaults[spec.agent] ?? resolveAgent(spec.agent).defaultModel;
+}
+/** Every case under `_plans/`, whether or not it has been run, plus every load error. */
+export function catalog(runs, repo, defaultModel) {
+    const loaded = loadCaseFiles(join(runs, "_plans"));
+    const cases = loaded.cases.map((spec) => new Case(spec, join(runs, spec.name), repo, fallbackModel(spec, defaultModel)));
+    // loadCaseFiles already sorts numerically — tc-2 must precede tc-10.
+    return { cases, errors: loaded.errors };
+}
+/** Cases whose run folder does not exist, natural-sorted, then filtered. */
+export function discover(all, only = null, limit = null) {
+    let cases = all.filter((c) => !existsSync(c.outDir));
+    if (only !== null)
+        cases = cases.filter((c) => only.has(c.name));
+    if (limit !== null)
+        cases = cases.slice(0, limit);
+    return cases;
+}
+export function stillEligible(kase) {
+    return isFile(kase.file) && !existsSync(kase.outDir);
+}
+export function agentCommand(binary, kase) {
+    return resolveAgent(kase.agentName).buildArgv({ repo: kase.repo, model: kase.model, prompt: kase.prompt }, binary);
+}
+export function commandFor(kase, explicitAgent) {
+    return agentCommand(resolveBinary(kase.agentName, explicitAgent), kase);
+}
+/** Python: shlex._find_unsafe = re.compile(r'[^\w@%+=:,./-]', re.ASCII).search */
+const SHELL_SAFE = /^[A-Za-z0-9_@%+=:,./-]+$/;
+export function shellQuote(s) {
+    if (SHELL_SAFE.test(s))
+        return s;
+    return `'${s.replaceAll("'", `'"'"'`)}'`;
+}
+export function shellJoin(argv) {
+    return argv.map(shellQuote).join(" ");
+}
+/** The argv with the plan body elided, for a `--dry-run` listing that stays readable. */
+export function elidedCommand(binary, kase) {
+    const argv = agentCommand(binary, kase);
+    const head = kase.prompt.slice(0, kase.prompt.indexOf("\n\n---\n\n"));
+    const hidden = kase.plan.length;
+    argv[argv.length - 1] = `${head} …[+${hidden.toLocaleString("en-US")} chars of plan]…`;
+    return argv;
+}
+/** Argv for the --dry-run listing: never spawned, so an absent backend is not an error. */
+export function displayCommandFor(kase, explicitAgent) {
+    return agentCommand(displayBinary(kase.agentName, explicitAgent), kase);
+}
+export function elidedCommandFor(kase, explicitAgent) {
+    const argv = displayCommandFor(kase, explicitAgent);
+    const head = kase.prompt.slice(0, kase.prompt.indexOf("\n\n---\n\n"));
+    const hidden = kase.plan.length;
+    argv[argv.length - 1] = `${head} …[+${hidden.toLocaleString("en-US")} chars of plan]…`;
+    return argv;
+}
+//# sourceMappingURL=cases.js.map

package/dist/qa/cases.js.map

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

package/dist/qa/config.d.ts

@@ -0,0 +1,50 @@
+/** Every `raise SystemExit("msg")` in the Python becomes one of these. */
+export declare class UserError extends Error {
+}
+export declare const DEFAULT_PARALLEL = 8;
+export declare const DEFAULT_TIMEOUT_MIN = 60;
+export declare const REPORT = "_report.md";
+export declare const RESULTS = "_results.md";
+export declare const TRANSCRIPT_CAP = 400;
+export declare const RENDER_HZ = 4;
+/** Digits 1..9 zoom a pane; a tenth pane simply has no key. */
+export declare const MAX_ZOOM_KEYS = 9;
+/**
+ * A case's plan travels inside the prompt argv, so it is bounded by ARG_MAX (1 MiB here, shared
+ * with the environment). Well under it, with a message that names the file instead of E2BIG.
+ */
+export declare const MAX_PROMPT_BYTES: number;
+export declare const DONE_OK = "ok";
+export declare const DONE_FAIL: ReadonlySet<string>;
+export interface Options {
+    repo: string;
+    runsDir: string;
+    /** Maximum agents in flight; per-case `parallel`/`tags` may hold it below this. */
+    parallel: number;
+    /**
+     * Session-log label for `--model`. Per-case fallbacks live on the Case via
+     * `models` / the profile default — a mixed queue does not share one slug.
+     */
+    model: string;
+    only: ReadonlySet<string> | null;
+    limit: number | null;
+    dryRun: boolean;
+    showPrompts: boolean;
+    noTui: boolean;
+    timeoutMs: number;
+    /** Explicit binary for every backend, or null to resolve per profile on PATH. */
+    agent: string | null;
+    /** When true, main() does not print the human console summary (JSON owns stdout). */
+    json: boolean;
+}
+/** Python: resolve_dir(raw, base, what) */
+export declare function resolveDir(raw: string, base: string, what: string): string;
+/** Python: shutil.which — POSIX PATH walk, no PATHEXT handling. */
+export declare function which(name: string): string | null;
+/**
+ * An explicit `--agent` path. Kept expanduser'd as given — it is not absolutized,
+ * and the result goes verbatim into command.txt and --dry-run output.
+ */
+export declare function findExplicitAgent(explicit: string): string;
+/** Python: parse_only("27, tc-28,") -> {"tc-27", "tc-28"} */
+export declare function parseOnly(raw: string | null | undefined): ReadonlySet<string> | null;

package/dist/qa/config.js

@@ -0,0 +1,105 @@
+import { accessSync, constants, realpathSync, statSync } from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
+import { homedir } from "node:os";
+/** Every `raise SystemExit("msg")` in the Python becomes one of these. */
+export class UserError extends Error {
+}
+export const DEFAULT_PARALLEL = 8;
+export const DEFAULT_TIMEOUT_MIN = 60;
+export const REPORT = "_report.md";
+export const RESULTS = "_results.md";
+export const TRANSCRIPT_CAP = 400;
+export const RENDER_HZ = 4;
+/** Digits 1..9 zoom a pane; a tenth pane simply has no key. */
+export const MAX_ZOOM_KEYS = 9;
+/**
+ * A case's plan travels inside the prompt argv, so it is bounded by ARG_MAX (1 MiB here, shared
+ * with the environment). Well under it, with a message that names the file instead of E2BIG.
+ */
+export const MAX_PROMPT_BYTES = 256 * 1024;
+export const DONE_OK = "ok";
+export const DONE_FAIL = new Set([
+    "error",
+    "timeout",
+    "no-output",
+    "no-folder",
+]);
+function expandUser(raw) {
+    if (raw === "~")
+        return homedir();
+    if (raw.startsWith("~/"))
+        return join(homedir(), raw.slice(2));
+    return raw;
+}
+/** Python: resolve_dir(raw, base, what) */
+export function resolveDir(raw, base, what) {
+    const expanded = expandUser(raw);
+    const joined = isAbsolute(expanded) ? expanded : join(base, expanded);
+    // Python's Path.resolve() also resolves symlinks — on macOS /tmp is a link to /private/tmp,
+    // so path.resolve() alone would produce a different --workspace and different log paths.
+    let path;
+    try {
+        path = realpathSync(joined);
+    }
+    catch {
+        path = resolve(joined);
+    }
+    let dir = false;
+    try {
+        dir = statSync(path).isDirectory();
+    }
+    catch {
+        /* keep false */
+    }
+    if (!dir)
+        throw new UserError(`${what} is not a directory: ${path}`);
+    return path;
+}
+function isExecutableFile(path) {
+    try {
+        if (!statSync(path).isFile())
+            return false;
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Python: shutil.which — POSIX PATH walk, no PATHEXT handling. */
+export function which(name) {
+    if (name.includes("/"))
+        return isExecutableFile(name) ? name : null;
+    const path = process.env["PATH"] ?? "";
+    for (const dir of path.split(":")) {
+        const candidate = join(dir === "" ? "." : dir, name);
+        if (isExecutableFile(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * An explicit `--agent` path. Kept expanduser'd as given — it is not absolutized,
+ * and the result goes verbatim into command.txt and --dry-run output.
+ */
+export function findExplicitAgent(explicit) {
+    const path = expandUser(explicit);
+    if (!isExecutableFile(path)) {
+        throw new UserError(`--agent is not an executable file: ${explicit}`);
+    }
+    return path;
+}
+/** Python: parse_only("27, tc-28,") -> {"tc-27", "tc-28"} */
+export function parseOnly(raw) {
+    if (raw === null || raw === undefined || raw === "")
+        return null;
+    const names = new Set();
+    for (const part of raw.split(",")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        names.add(trimmed.startsWith("tc-") ? trimmed : `tc-${trimmed}`);
+    }
+    return names;
+}
+//# sourceMappingURL=config.js.map

package/dist/qa/config.js.map

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

package/dist/qa/demo.d.ts

@@ -0,0 +1,10 @@
+export interface DemoOptions {
+    rows?: number;
+    cols?: number;
+    table?: boolean;
+    once?: boolean;
+    /** How many panes to show, so the dynamic pane region can be eyeballed at any width. */
+    panes?: number;
+}
+/** A canned frame, so the TUI can be eyeballed at any size without launching an agent. */
+export declare function runDemo(opts: DemoOptions): Promise<number>;

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;