litmus-cli 1.4.6 → 1.4.7-eng1502.0

package/dist/lib/editor.js

@@ -0,0 +1,222 @@
+/**
+ * Opening — and later closing — the candidate's editor on their own machine.
+ *
+ * `litmus init` offers the editors it can actually launch and opens the
+ * assessment in the chosen one; `litmus submit` closes that window again once
+ * the work is in, so the agent chat session that was open against the
+ * assessment ends with the assessment instead of outliving it.
+ *
+ * Closing is best-effort and SILENT. Neither VS Code nor Cursor exposes a
+ * "close this window" command, so every route here is an OS window-manager
+ * trick that can legitimately be unavailable: macOS gates UI scripting behind
+ * Accessibility permission, and a Linux box may have neither wmctrl nor
+ * xdotool. A candidate who has just submitted should not be handed a warning
+ * about a window they can close themselves, so a failure produces no output at
+ * all.
+ */
+import os from "os";
+import path from "path";
+import { existsSync } from "fs";
+import { execFileSync, spawn } from "child_process";
+const EDITORS = [
+    { id: "vscode", label: "VS Code", cli: "code", macApp: "Visual Studio Code", macProcess: "Code", processName: "Code" },
+    { id: "cursor", label: "Cursor", cli: "cursor", macApp: "Cursor", macProcess: "Cursor", processName: "Cursor" },
+];
+function onPath(cmd) {
+    try {
+        if (process.platform === "win32") {
+            execFileSync("where.exe", [cmd], { stdio: "ignore", timeout: 5000 });
+        }
+        else {
+            // `command -v` rather than `which`: POSIX, and present on the minimal
+            // shells some candidates run. cmd is a literal from EDITORS, never input.
+            execFileSync("/bin/sh", ["-c", `command -v ${cmd}`], { stdio: "ignore", timeout: 5000 });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function macAppPath(bundleName) {
+    if (process.platform !== "darwin")
+        return null;
+    for (const base of ["/Applications", path.join(os.homedir(), "Applications")]) {
+        const p = path.join(base, `${bundleName}.app`);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * The editors we can actually open on this machine, in menu order. An editor
+ * the candidate has installed but never added to PATH still shows up on macOS
+ * (we open the bundle directly) — that gap is common enough with Cursor that
+ * omitting it would hide the option most candidates want.
+ */
+export function detectEditors() {
+    const found = [];
+    for (const spec of EDITORS) {
+        if (onPath(spec.cli)) {
+            found.push({ spec, how: "cli" });
+            continue;
+        }
+        const appPath = macAppPath(spec.macApp);
+        if (appPath)
+            found.push({ spec, how: "app", appPath });
+    }
+    return found;
+}
+/**
+ * Open `dir` in the chosen editor. Resolves false only when the launcher itself
+ * is missing — spawn reports that asynchronously via 'error', so we give it a
+ * short grace period rather than reporting success and printing a line that
+ * turns out to be a lie. The editor is detached: it outlives the CLI.
+ */
+export function openInEditor(editor, dir) {
+    const [cmd, args] = editor.how === "cli" ? [editor.spec.cli, [dir]] : ["open", ["-a", editor.appPath, dir]];
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (ok) => {
+            if (!settled) {
+                settled = true;
+                resolve(ok);
+            }
+        };
+        try {
+            const child = spawn(cmd, args, { detached: true, stdio: "ignore" });
+            child.on("error", () => done(false));
+            child.unref();
+            setTimeout(() => done(true), 400).unref();
+        }
+        catch {
+            done(false);
+        }
+    });
+}
+/** AppleScript string literal escaping (backslash, then quote). */
+function escapeAppleScript(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+/** PowerShell single-quoted string escaping (double the quote). */
+function escapePowerShell(s) {
+    return s.replace(/'/g, "''");
+}
+/**
+ * Close every window of `process` whose title mentions `folderName`, by
+ * pressing its close button through the Accessibility API. Editor window titles
+ * carry the workspace folder ("index.ts — acme-backend"), so this hits the
+ * assessment window and leaves the candidate's other projects alone.
+ *
+ * Exported for tests: the escaping is the part worth pinning.
+ */
+export function macCloseScript(processName, folderName) {
+    const proc = escapeAppleScript(processName);
+    const folder = escapeAppleScript(folderName);
+    return [
+        'tell application "System Events"',
+        `  if not (exists process "${proc}") then return`,
+        `  tell process "${proc}"`,
+        `    repeat with w in (every window whose name contains "${folder}")`,
+        "      try",
+        '        perform action "AXPress" of (first button of w whose subrole is "AXCloseButton")',
+        "      end try",
+        "    end repeat",
+        "  end tell",
+        "end tell",
+    ].join("\n");
+}
+/**
+ * Windows equivalent. `.Contains` rather than `-like '*x*'` so a folder name
+ * with a wildcard character in it can't widen the match. CloseMainWindow is the
+ * polite close — an editor with unsaved work still gets to prompt.
+ */
+export function winCloseScript(processName, folderName) {
+    const proc = escapePowerShell(processName);
+    const folder = escapePowerShell(folderName);
+    return (`Get-Process -Name '${proc}' -ErrorAction SilentlyContinue | ` +
+        `Where-Object { $_.MainWindowTitle -and $_.MainWindowTitle.Contains('${folder}') } | ` +
+        `ForEach-Object { $_.CloseMainWindow() | Out-Null }`);
+}
+/**
+ * Launch a close attempt and walk away.
+ *
+ * MEASURED, and the reason this is detached rather than a sync call: the first
+ * UI-scripting attempt on macOS blocks until the candidate answers a system
+ * permission dialog — a probe with a 10s cap timed out rather than returning.
+ * Waiting on that would freeze `litmus submit` at the exact moment the
+ * candidate has been told they are done. Detached, the attempt outlives us and
+ * either lands or doesn't; either way submit keeps moving. A new process group
+ * also means the hang-up submit sends to the assessment shell moments later
+ * doesn't take this with it.
+ */
+function fireAndForget(command, args) {
+    try {
+        const child = spawn(command, args, { detached: true, stdio: "ignore" });
+        child.on("error", () => {
+            // Launcher missing (no osascript, no powershell) — nothing to say.
+        });
+        child.unref();
+    }
+    catch {
+        // Silent by design — see the file header.
+    }
+}
+/** Linux: ask the window manager, if the candidate has wmctrl. */
+function linuxCloseWindow(processName, folderName) {
+    // -lx adds WM_CLASS ("code.Code", "cursor.Cursor"), so we can require both the
+    // right app and the right title before closing anything.
+    const listing = execFileSync("wmctrl", ["-lx"], { encoding: "utf8", timeout: 3000 });
+    const wantClass = processName.toLowerCase();
+    for (const line of listing.split("\n")) {
+        const m = line.match(/^(0x[0-9a-fA-F]+)\s+\S+\s+(\S+)\s+\S+\s+(.*)$/);
+        if (!m)
+            continue;
+        const [, winId, wmClass, title] = m;
+        if (!wmClass.toLowerCase().includes(wantClass))
+            continue;
+        if (!title.includes(folderName))
+            continue;
+        try {
+            execFileSync("wmctrl", ["-ic", winId], { stdio: "ignore", timeout: 5000 });
+        }
+        catch {
+            // one window refusing to close doesn't stop the rest
+        }
+    }
+}
+/**
+ * Best-effort, silent close of the assessment's editor window. Every failure
+ * mode — no permission, no window manager, editor already quit, window renamed
+ * — is a no-op with no output.
+ */
+export function closeEditorWindow(editorId, folderName) {
+    const spec = EDITORS.find((e) => e.id === editorId);
+    // A one- or two-character folder name would match far too many window titles
+    // to be safe to close on.
+    if (!spec || folderName.trim().length < 3)
+        return;
+    try {
+        if (process.platform === "darwin") {
+            fireAndForget("osascript", ["-e", macCloseScript(spec.macProcess, folderName)]);
+        }
+        else if (process.platform === "win32") {
+            fireAndForget("powershell.exe", [
+                "-NoProfile",
+                "-NonInteractive",
+                "-Command",
+                winCloseScript(spec.processName, folderName),
+            ]);
+        }
+        else {
+            // The X11 route needs the window list back before it can close anything,
+            // so it is the one synchronous path — wmctrl answers immediately and asks
+            // no permission of anyone.
+            linuxCloseWindow(spec.processName, folderName);
+        }
+    }
+    catch {
+        // Silent by design — see the file header.
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/lib/editor.js.map

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

package/dist/lib/select.d.ts

@@ -0,0 +1,64 @@
+/**
+ * A single-choice arrow-key picker for the candidate-facing prompts.
+ *
+ * Written by hand rather than pulled from a prompt library: the CLI ships to
+ * candidates' machines, so every dependency is one more thing that can fail to
+ * install on an unknown Node/npm. The surface here is one function.
+ *
+ * Non-interactive stdin (piped, CI, the watcher's auto-submit) never blocks —
+ * `select` resolves to null immediately and the caller falls back to printing
+ * instructions.
+ */
+export interface SelectChoice<T> {
+    value: T;
+    label: string;
+    /** Dim trailing text — e.g. "not installed", "recommended". */
+    hint?: string;
+}
+export type SelectKey = "up" | "down" | "select" | "abort";
+/**
+ * Escape sequence → intent. Exported for tests; there is no other way to
+ * exercise key handling without a real TTY.
+ *
+ * A bare ESC deliberately means nothing. An arrow key IS an ESC followed by two
+ * more bytes, and a terminal is free to deliver those bytes in separate reads —
+ * so a lone ESC is far more likely to be half an arrow than a candidate asking
+ * to dismiss the picker. Dismissing has its own row in the list; navigation
+ * that closes the picker at random does not.
+ */
+export declare function decodeKey(seq: string): SelectKey | null;
+/**
+ * Pull every complete keypress out of the bytes read so far, and hand back
+ * whatever trailing fragment is still the start of a sequence.
+ *
+ * Reads are not keypresses in either direction: holding an arrow key down
+ * coalesces several presses into one read, and a slow link or a multiplexer can
+ * split a single arrow across two. The caller carries `pending` into the next
+ * read, so a split arrow still arrives as one "up".
+ *
+ * A fragment that turns out NOT to be a sequence start — ESC then a plain
+ * letter — drops just the ESC and re-reads the rest, so the letter is not
+ * swallowed along with it.
+ */
+export declare function consumeKeys(buffer: string): {
+    keys: SelectKey[];
+    pending: string;
+};
+/**
+ * The rendered block, one string per terminal line. Pure, so tests can assert
+ * which row carries the pointer without driving a TTY.
+ */
+export declare function renderBlock<T>(title: string, choices: SelectChoice<T>[], active: number): string[];
+/** Whether we can drive a picker at all: both ends must be a TTY. */
+export declare function isInteractive(): boolean;
+/**
+ * Show `title` above `choices` and let the candidate move with ↑/↓ and confirm
+ * with enter. Resolves to the chosen value, or to null when the picker can't
+ * run at all (non-TTY). Ctrl-C exits with 130 — the same thing an un-swallowed
+ * SIGINT would have done.
+ *
+ * The block is erased on exit, so the caller owns what the candidate is left
+ * looking at.
+ */
+export declare function select<T>(title: string, choices: SelectChoice<T>[]): Promise<T | null>;
+//# sourceMappingURL=select.d.ts.map

package/dist/lib/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/lib/select.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAA;IACR,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAK1D;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAkBvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAgBlF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAelG;AAED,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA4DtF"}

package/dist/lib/select.js

@@ -0,0 +1,170 @@
+/**
+ * A single-choice arrow-key picker for the candidate-facing prompts.
+ *
+ * Written by hand rather than pulled from a prompt library: the CLI ships to
+ * candidates' machines, so every dependency is one more thing that can fail to
+ * install on an unknown Node/npm. The surface here is one function.
+ *
+ * Non-interactive stdin (piped, CI, the watcher's auto-submit) never blocks —
+ * `select` resolves to null immediately and the caller falls back to printing
+ * instructions.
+ */
+import { stdin, stdout } from "process";
+import chalk from "chalk";
+const ESC = "\u001b";
+const CTRL_C = "\u0003";
+/** The starts of sequences we understand — held back rather than acted on. */
+const SEQUENCE_PREFIXES = new Set([ESC, `${ESC}[`, `${ESC}O`]);
+/**
+ * Escape sequence → intent. Exported for tests; there is no other way to
+ * exercise key handling without a real TTY.
+ *
+ * A bare ESC deliberately means nothing. An arrow key IS an ESC followed by two
+ * more bytes, and a terminal is free to deliver those bytes in separate reads —
+ * so a lone ESC is far more likely to be half an arrow than a candidate asking
+ * to dismiss the picker. Dismissing has its own row in the list; navigation
+ * that closes the picker at random does not.
+ */
+export function decodeKey(seq) {
+    switch (seq) {
+        case `${ESC}[A`: // arrow up, normal mode
+        case `${ESC}OA`: // arrow up, application mode (tmux, some terminals)
+        case "k":
+            return "up";
+        case `${ESC}[B`:
+        case `${ESC}OB`:
+        case "j":
+            return "down";
+        case "\r":
+        case "\n":
+            return "select";
+        case CTRL_C: // raw mode swallows SIGINT, so we handle Ctrl-C ourselves
+            return "abort";
+        default:
+            return null;
+    }
+}
+/**
+ * Pull every complete keypress out of the bytes read so far, and hand back
+ * whatever trailing fragment is still the start of a sequence.
+ *
+ * Reads are not keypresses in either direction: holding an arrow key down
+ * coalesces several presses into one read, and a slow link or a multiplexer can
+ * split a single arrow across two. The caller carries `pending` into the next
+ * read, so a split arrow still arrives as one "up".
+ *
+ * A fragment that turns out NOT to be a sequence start — ESC then a plain
+ * letter — drops just the ESC and re-reads the rest, so the letter is not
+ * swallowed along with it.
+ */
+export function consumeKeys(buffer) {
+    const keys = [];
+    let rest = buffer;
+    while (rest.length > 0) {
+        const three = rest.length >= 3 ? decodeKey(rest.slice(0, 3)) : null;
+        if (three) {
+            keys.push(three);
+            rest = rest.slice(3);
+            continue;
+        }
+        if (SEQUENCE_PREFIXES.has(rest))
+            break; // incomplete — wait for the rest
+        const one = decodeKey(rest[0]);
+        if (one)
+            keys.push(one);
+        rest = rest.slice(1);
+    }
+    return { keys, pending: rest };
+}
+/**
+ * The rendered block, one string per terminal line. Pure, so tests can assert
+ * which row carries the pointer without driving a TTY.
+ */
+export function renderBlock(title, choices, active) {
+    const rows = choices.map((c, i) => {
+        const on = i === active;
+        const pointer = on ? chalk.cyan("❯") : " ";
+        const label = on ? chalk.cyan.bold(c.label) : c.label;
+        const hint = c.hint ? " " + chalk.dim(c.hint) : "";
+        return `  ${pointer} ${label}${hint}`;
+    });
+    return [
+        `  ${chalk.bold(title)}`,
+        "",
+        ...rows,
+        "",
+        chalk.dim("  ↑/↓ to move · enter to choose"),
+    ];
+}
+/** Whether we can drive a picker at all: both ends must be a TTY. */
+export function isInteractive() {
+    return Boolean(stdin.isTTY && stdout.isTTY && typeof stdin.setRawMode === "function");
+}
+/**
+ * Show `title` above `choices` and let the candidate move with ↑/↓ and confirm
+ * with enter. Resolves to the chosen value, or to null when the picker can't
+ * run at all (non-TTY). Ctrl-C exits with 130 — the same thing an un-swallowed
+ * SIGINT would have done.
+ *
+ * The block is erased on exit, so the caller owns what the candidate is left
+ * looking at.
+ */
+export function select(title, choices) {
+    if (!isInteractive() || choices.length === 0)
+        return Promise.resolve(null);
+    let active = 0;
+    const lineCount = renderBlock(title, choices, active).length;
+    const paint = (first) => {
+        if (!first)
+            stdout.write(`${ESC}[${lineCount}A`);
+        for (const line of renderBlock(title, choices, active)) {
+            stdout.write(`${ESC}[2K${line}\n`);
+        }
+    };
+    const erase = () => {
+        stdout.write(`${ESC}[${lineCount}A${ESC}[0J`);
+    };
+    return new Promise((resolve) => {
+        const wasRaw = stdin.isRaw;
+        stdout.write(`${ESC}[?25l`); // hide cursor
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding("utf8");
+        paint(true);
+        const cleanup = () => {
+            stdin.off("data", onData);
+            stdin.setRawMode(Boolean(wasRaw));
+            stdin.pause();
+            stdout.write(`${ESC}[?25h`); // show cursor
+        };
+        // Carries a half-delivered escape sequence from one read to the next.
+        let pending = "";
+        const onData = (chunk) => {
+            const read = consumeKeys(pending + chunk);
+            pending = read.pending;
+            for (const key of read.keys) {
+                if (key === "up") {
+                    active = (active - 1 + choices.length) % choices.length;
+                    paint(false);
+                }
+                else if (key === "down") {
+                    active = (active + 1) % choices.length;
+                    paint(false);
+                }
+                else if (key === "select") {
+                    erase();
+                    cleanup();
+                    resolve(choices[active].value);
+                    return;
+                }
+                else if (key === "abort") {
+                    erase();
+                    cleanup();
+                    process.exit(130);
+                }
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+//# sourceMappingURL=select.js.map

package/dist/lib/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/lib/select.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,GAAG,GAAG,QAAQ,CAAA;AACpB,MAAM,MAAM,GAAG,QAAQ,CAAA;AAWvB,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;AAE9D;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,wBAAwB;QACzC,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,oDAAoD;QACrE,KAAK,GAAG;YACN,OAAO,IAAI,CAAA;QACb,KAAK,GAAG,GAAG,IAAI,CAAC;QAChB,KAAK,GAAG,GAAG,IAAI,CAAC;QAChB,KAAK,GAAG;YACN,OAAO,MAAM,CAAA;QACf,KAAK,IAAI,CAAC;QACV,KAAK,IAAI;YACP,OAAO,QAAQ,CAAA;QACjB,KAAK,MAAM,EAAE,0DAA0D;YACrE,OAAO,OAAO,CAAA;QAChB;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,IAAI,GAAgB,EAAE,CAAA;IAC5B,IAAI,IAAI,GAAG,MAAM,CAAA;IACjB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACnE,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAChB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACpB,SAAQ;QACV,CAAC;QACD,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAK,CAAC,iCAAiC;QACxE,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9B,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,KAAa,EAAE,OAA0B,EAAE,MAAc;IACtF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAA;QACvB,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QACrD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,OAAO,KAAK,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,CAAA;IACvC,CAAC,CAAC,CAAA;IACF,OAAO;QACL,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACxB,EAAE;QACF,GAAG,IAAI;QACP,EAAE;QACF,KAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC;KAC7C,CAAA;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAA;AACvF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAI,KAAa,EAAE,OAA0B;IACjE,IAAI,CAAC,aAAa,EAAE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1E,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAA;IAE5D,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,SAAS,GAAG,CAAC,CAAA;QAChD,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,CAAA;QACpC,CAAC;IACH,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,SAAS,IAAI,GAAG,KAAK,CAAC,CAAA;IAC/C,CAAC,CAAA;IAED,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAA;QAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAA,CAAC,cAAc;QAC1C,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACtB,KAAK,CAAC,MAAM,EAAE,CAAA;QACd,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QACzB,KAAK,CAAC,IAAI,CAAC,CAAA;QAEX,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACzB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;YACjC,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAA,CAAC,cAAc;QAC5C,CAAC,CAAA;QAED,sEAAsE;QACtE,IAAI,OAAO,GAAG,EAAE,CAAA;QAEhB,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC,CAAA;YACzC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YACtB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACjB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAA;oBACvD,KAAK,CAAC,KAAK,CAAC,CAAA;gBACd,CAAC;qBAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;oBAC1B,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAA;oBACtC,KAAK,CAAC,KAAK,CAAC,CAAA;gBACd,CAAC;qBAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;oBAC5B,KAAK,EAAE,CAAA;oBACP,OAAO,EAAE,CAAA;oBACT,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAA;oBAC9B,OAAM;gBACR,CAAC;qBAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;oBAC3B,KAAK,EAAE,CAAA;oBACP,OAAO,EAAE,CAAA;oBACT,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACnB,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QAED,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/lib/session.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The assessment shell — how `litmus init` puts the candidate *inside* their
+ * assessment folder, and how `litmus submit` takes them back out.
+ *
+ * A process cannot change its parent shell's working directory, so "cd into the
+ * folder for them" has exactly one honest implementation: init spawns an
+ * interactive shell rooted in the assessment directory and waits on it. The
+ * candidate works in that shell. When submit succeeds it hangs that shell up,
+ * the shell exits, init's wait returns, and the candidate is back at the prompt
+ * they started from, in the directory they started in — the `cd ..` they never
+ * had to type.
+ *
+ * Two independent facts have to line up before we signal anything:
+ *   - LITMUS_ASSESSMENT_SHELL=1 in our own environment, which only a shell we
+ *     spawned can have set, and
+ *   - a .litmus/shell.pid written by that same init, for this same folder,
+ *     naming a process that is genuinely one of our ancestors.
+ * Either alone could be stale; together they can only describe the shell we are
+ * actually standing in.
+ */
+/** Set in the spawned shell's environment; read back by `litmus submit`. */
+export declare const SHELL_ENV_MARKER = "LITMUS_ASSESSMENT_SHELL";
+/**
+ * Whether init should hand the candidate a shell at all. Piped stdin (the e2e
+ * suite, a CI script, `litmus init | tee`) must never get one — it would hang
+ * forever on a shell nobody can type into.
+ */
+export declare function shouldEnterShell(optIn: boolean | undefined): boolean;
+/** The candidate's own shell, falling back to something that certainly exists. */
+export declare function resolveShell(): {
+    command: string;
+    args: string[];
+};
+/**
+ * Drop the candidate into `projectRoot` in their own shell and block until they
+ * leave it — by typing exit, or by `litmus submit` hanging it up.
+ *
+ * Resolves to "submitted" when the folder is gone by the time the shell exits
+ * (submit deleted it), "exited" when the candidate just left.
+ *
+ * Closing the shell has two triggers, because the two cases know different
+ * things: an in-shell `litmus submit` signals it directly (instant, and ordered
+ * against its own output), while a submit that happens elsewhere — the deadline
+ * auto-submit in the watcher, or a second terminal — is noticed here by the
+ * assessment folder disappearing.
+ */
+export declare function enterAssessmentShell(projectRoot: string, folderName: string): Promise<"submitted" | "exited">;
+/** The pid init recorded for this folder's shell, if there is one. */
+export declare function readAssessmentShellPid(projectRoot: string): number | null;
+/**
+ * Are we running inside the shell init opened for this folder? Both the
+ * environment marker and an ancestry check have to agree — see the file header.
+ *
+ * Callers use this before printing anything about where the candidate will end
+ * up, since leaving the shell moves them out of the folder for free.
+ */
+export declare function inAssessmentShell(shellPid: number | null): boolean;
+/**
+ * End the assessment shell. Returns true when the hang-up went out.
+ *
+ * Call this LAST and print nothing after it: the shell hangs up its jobs on the
+ * way out, and this process is one of them.
+ */
+export declare function hangUpAssessmentShell(shellPid: number | null): boolean;
+//# sourceMappingURL=session.d.ts.map

package/dist/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,4BAA4B,CAAA;AAQzD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAIpE;AAED,kFAAkF;AAClF,wBAAgB,YAAY,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAOlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,CAmEjC;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzE;AA6BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAkBtE"}