poly-weaver 0.2.5

package/dist/status-bar.js

@@ -0,0 +1,135 @@
+import { visibleLength } from "./ansi.js";
+import { APP_VERSION } from "./version.js";
+function formatContext(ctx) {
+    if (ctx.iteration != null && ctx.maxIterations != null) {
+        return `Iteration ${ctx.iteration}/${ctx.maxIterations}`;
+    }
+    return "";
+}
+const ANIMAL_EMOJIS = [
+    "🐶", "🐱", "🐭", "🐹", "🐰", "🦊", "🐻", "🐼",
+    "🐨", "🐯", "🦁", "🐮", "🐷", "🐸", "🐵", "🐔",
+    "🐧", "🐦", "🐤", "🦆", "🦅", "🦉", "🐴", "🦄",
+    "🐝", "🐛", "🦋", "🐌", "🐙", "🦑", "🐠", "🐬",
+];
+/** Deterministic animal emoji for a branch name (djb2 hash). */
+export function branchAnimalEmoji(branch) {
+    let h = 5381;
+    for (let i = 0; i < branch.length; i++) {
+        h = ((h << 5) + h + branch.charCodeAt(i)) | 0;
+    }
+    return ANIMAL_EMOJIS[Math.abs(h) % ANIMAL_EMOJIS.length];
+}
+export class StatusBar {
+    enabled;
+    barRow;
+    lastCtx;
+    out;
+    resizeHandler;
+    redrawTimer;
+    lastDrawnOutput;
+    gitInfo = null;
+    constructor(out) {
+        this.out = out ?? process.stdout;
+        this.enabled =
+            this.out.isTTY === true && (this.out.rows ?? 0) >= 5;
+        this.barRow = this.out.rows ?? 0;
+    }
+    init() {
+        if (!this.enabled)
+            return;
+        this.barRow = this.out.rows;
+        // Set scroll region with cursor save/restore (no cursor homing)
+        this.out.write(`\x1b7\x1b[1;${this.barRow - 1}r\x1b8`);
+        // Draw initial bar
+        this.drawBar();
+        // Handle terminal resize
+        this.resizeHandler = () => {
+            this.barRow = this.out.rows;
+            this.out.write(`\x1b7\x1b[1;${this.barRow - 1}r\x1b8`);
+            this.drawBar();
+        };
+        this.out.on("resize", this.resizeHandler);
+        // Periodic redraw to repair scroll region disruption
+        this.redrawTimer = setInterval(() => {
+            this.lastDrawnOutput = undefined;
+            this.drawBar();
+        }, 1000);
+    }
+    update(ctx) {
+        if (!this.enabled)
+            return;
+        this.lastCtx = ctx;
+        this.drawBar();
+    }
+    setGitInfo(info) {
+        this.gitInfo = info;
+        if (this.enabled)
+            this.drawBar();
+    }
+    destroy() {
+        if (!this.enabled)
+            return;
+        this.enabled = false;
+        if (this.redrawTimer != null) {
+            clearInterval(this.redrawTimer);
+            this.redrawTimer = undefined;
+        }
+        if (this.resizeHandler) {
+            this.out.removeListener("resize", this.resizeHandler);
+            this.resizeHandler = undefined;
+        }
+        // Clear bar and reset scroll region (cursor-safe)
+        this.out.write(`\x1b7\x1b[${this.barRow};1H\x1b[2K\x1b[r\x1b8`);
+    }
+    get reservedRows() {
+        return this.enabled ? 1 : 0;
+    }
+    formatGitSegment() {
+        if (!this.gitInfo)
+            return null;
+        const animal = branchAnimalEmoji(this.gitInfo.branch);
+        const wt = this.gitInfo.isWorktree ? " \u{1F332}" : "";
+        return `${animal} ${this.gitInfo.branch}${wt}`;
+    }
+    drawBar() {
+        const columns = this.out.columns ?? 80;
+        let content;
+        const gitSeg = this.formatGitSegment();
+        if (!this.lastCtx) {
+            content = gitSeg
+                ? ` poly-weaver v${APP_VERSION} \u2502 ${gitSeg}`
+                : ` poly-weaver v${APP_VERSION}`;
+        }
+        else {
+            const phaseLabel = this.lastCtx.phase;
+            const ctx = formatContext(this.lastCtx);
+            const segments = [` poly-weaver v${APP_VERSION}`];
+            if (gitSeg)
+                segments.push(gitSeg);
+            segments.push(phaseLabel);
+            if (this.lastCtx.agent)
+                segments.push(this.lastCtx.agent);
+            if (ctx)
+                segments.push(ctx);
+            content = segments.join(" \u2502 ");
+        }
+        // Pad visible content to full terminal width
+        const pad = columns - visibleLength(content);
+        const padded = pad > 0 ? content + " ".repeat(pad) : content;
+        // Atomic write: save cursor, re-establish scroll region, draw bar, restore cursor
+        const output = `\x1b7` +
+            `\x1b[1;${this.barRow - 1}r` +
+            `\x1b[${this.barRow};1H` +
+            `\x1b[2K` +
+            `\x1b[7m` +
+            padded +
+            `\x1b[27m` +
+            `\x1b8`;
+        if (output === this.lastDrawnOutput)
+            return;
+        this.lastDrawnOutput = output;
+        this.out.write(output);
+    }
+}
+//# sourceMappingURL=status-bar.js.map

package/dist/status-bar.js.map

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

package/dist/terminal-input.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared terminal input parser — bytes → low-level key identities.
+ *
+ * This module owns the byte-level state machine (normal/esc/csi), kitty
+ * keyboard protocol parsing, kitty dedup tracking, and escape timeout.
+ * It produces {@link TerminalKey} events with no domain semantics.
+ *
+ * Consumers (e.g. RawInputParser for review-phase, TuiInputParser for
+ * startup TUI) wrap this via composition and map TerminalKey → their own
+ * domain event types.
+ */
+export type TerminalKey = {
+    kind: "printable";
+    char: string;
+    source: "plain" | "kitty-u" | "kitty-text";
+} | {
+    kind: "control";
+    byte: number;
+} | {
+    kind: "enter";
+} | {
+    kind: "backspace";
+} | {
+    kind: "escape";
+} | {
+    kind: "arrow";
+    direction: "up" | "down" | "left" | "right";
+} | {
+    kind: "kitty-key";
+    keyCode: number;
+    modifiers: number;
+};
+export declare class TerminalKeyParser {
+    private readonly now;
+    private readonly dedupeWindowMs;
+    private readonly escapeTimeoutMs;
+    private state;
+    private csiParams;
+    private lastKittyPrintable;
+    private escapeTimer;
+    private deferredCallback;
+    constructor(now?: () => number, dedupeWindowMs?: number, escapeTimeoutMs?: number);
+    onDeferredKeys(cb: (keys: TerminalKey[]) => void): void;
+    cancelPendingEscape(): void;
+    parseChunk(chunk: Buffer): TerminalKey[];
+    private handleCsi;
+    private parseKittyEventType;
+    private shouldInsertKittyPrintable;
+    private clearKittyPrintable;
+}
+//# sourceMappingURL=terminal-input.d.ts.map

package/dist/terminal-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-input.d.ts","sourceRoot":"","sources":["../src/terminal-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,qBAAa,iBAAiB;IAU1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAXlC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,kBAAkB,CAEZ;IACd,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,gBAAgB,CAA8C;gBAGnD,GAAG,GAAE,MAAM,MAAiB,EAC5B,cAAc,SAAK,EACnB,eAAe,SAAK;IAGvC,cAAc,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI;IAIvD,mBAAmB,IAAI,IAAI;IAO3B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAqExC,OAAO,CAAC,SAAS;IA+FjB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,0BAA0B;IAyBlC,OAAO,CAAC,mBAAmB;CAG5B"}

package/dist/terminal-input.js

@@ -0,0 +1,212 @@
+/**
+ * Shared terminal input parser — bytes → low-level key identities.
+ *
+ * This module owns the byte-level state machine (normal/esc/csi), kitty
+ * keyboard protocol parsing, kitty dedup tracking, and escape timeout.
+ * It produces {@link TerminalKey} events with no domain semantics.
+ *
+ * Consumers (e.g. RawInputParser for review-phase, TuiInputParser for
+ * startup TUI) wrap this via composition and map TerminalKey → their own
+ * domain event types.
+ */
+export class TerminalKeyParser {
+    now;
+    dedupeWindowMs;
+    escapeTimeoutMs;
+    state = "normal";
+    csiParams = "";
+    lastKittyPrintable;
+    escapeTimer;
+    deferredCallback;
+    constructor(now = Date.now, dedupeWindowMs = 30, escapeTimeoutMs = 50) {
+        this.now = now;
+        this.dedupeWindowMs = dedupeWindowMs;
+        this.escapeTimeoutMs = escapeTimeoutMs;
+    }
+    onDeferredKeys(cb) {
+        this.deferredCallback = cb;
+    }
+    cancelPendingEscape() {
+        if (this.escapeTimer != null) {
+            clearTimeout(this.escapeTimer);
+            this.escapeTimer = undefined;
+        }
+    }
+    parseChunk(chunk) {
+        const keys = [];
+        for (const byte of chunk) {
+            switch (this.state) {
+                case "normal":
+                    if (byte === 0x1b) {
+                        this.cancelPendingEscape();
+                        this.state = "esc";
+                    }
+                    else if (byte === 0x0d || byte === 0x0a) {
+                        this.clearKittyPrintable();
+                        keys.push({ kind: "enter" });
+                    }
+                    else if (byte === 0x7f || byte === 0x08) {
+                        this.clearKittyPrintable();
+                        keys.push({ kind: "backspace" });
+                    }
+                    else if (byte < 0x20) {
+                        this.clearKittyPrintable();
+                        keys.push({ kind: "control", byte });
+                    }
+                    else {
+                        this.clearKittyPrintable();
+                        keys.push({
+                            kind: "printable",
+                            char: String.fromCharCode(byte),
+                            source: "plain",
+                        });
+                    }
+                    break;
+                case "esc":
+                    if (byte === 0x5b) {
+                        this.state = "csi";
+                        this.csiParams = "";
+                    }
+                    else {
+                        this.state = "normal";
+                        this.clearKittyPrintable();
+                        keys.push({ kind: "escape" });
+                        // Re-process current byte in normal mode
+                        keys.push(...this.parseChunk(Buffer.from([byte])));
+                    }
+                    break;
+                case "csi":
+                    if (byte >= 0x40 && byte <= 0x7e) {
+                        keys.push(...this.handleCsi(this.csiParams, String.fromCharCode(byte)));
+                        this.state = "normal";
+                    }
+                    else {
+                        this.csiParams += String.fromCharCode(byte);
+                    }
+                    break;
+            }
+        }
+        // Bare ESC at end of chunk: start escape timeout
+        if (this.state === "esc" && this.escapeTimer == null) {
+            this.escapeTimer = setTimeout(() => {
+                this.escapeTimer = undefined;
+                if (this.state === "esc") {
+                    this.state = "normal";
+                    this.clearKittyPrintable();
+                    this.deferredCallback?.([{ kind: "escape" }]);
+                }
+            }, this.escapeTimeoutMs);
+        }
+        return keys;
+    }
+    handleCsi(params, finalByte) {
+        // Standard arrow keys: CSI A/B/C/D (with optional params like "1;1")
+        if (finalByte === "A") {
+            this.clearKittyPrintable();
+            return [{ kind: "arrow", direction: "up" }];
+        }
+        if (finalByte === "B") {
+            this.clearKittyPrintable();
+            return [{ kind: "arrow", direction: "down" }];
+        }
+        if (finalByte === "C") {
+            this.clearKittyPrintable();
+            return [{ kind: "arrow", direction: "right" }];
+        }
+        if (finalByte === "D") {
+            this.clearKittyPrintable();
+            return [{ kind: "arrow", direction: "left" }];
+        }
+        // CSI Z: standard Shift+Tab — normalize to Kitty protocol representation
+        if (finalByte === "Z") {
+            this.clearKittyPrintable();
+            return [{ kind: "kitty-key", keyCode: 9, modifiers: 2 }];
+        }
+        if (finalByte !== "u" && finalByte !== "_") {
+            this.clearKittyPrintable();
+            return [];
+        }
+        const parts = params.split(";");
+        const keyCode = parseInt(parts[0]?.split(":")[0] ?? "", 10) || 0;
+        const modifiers = parseInt(parts[1]?.split(":")[0] ?? "1", 10) || 1;
+        const eventType = this.parseKittyEventType(parts[1]);
+        // Ignore key-release events
+        if (eventType === 3) {
+            this.clearKittyPrintable();
+            return [];
+        }
+        // Enter with Ctrl modifier → kitty-key (so consumer can distinguish Ctrl+Enter)
+        if ((keyCode === 13 || keyCode === 10) && (modifiers - 1) & 0x04) {
+            this.clearKittyPrintable();
+            return [{ kind: "kitty-key", keyCode, modifiers }];
+        }
+        // Enter (no Ctrl)
+        if (keyCode === 13 || keyCode === 10) {
+            this.clearKittyPrintable();
+            return [{ kind: "enter" }];
+        }
+        // Backspace
+        if (keyCode === 127 || keyCode === 8) {
+            this.clearKittyPrintable();
+            return [{ kind: "backspace" }];
+        }
+        // Special keycodes → kitty-key (consumer decides semantics)
+        if (keyCode === 9 || keyCode === 27 || keyCode === 3) {
+            this.clearKittyPrintable();
+            return [{ kind: "kitty-key", keyCode, modifiers }];
+        }
+        // Kitty text event (_): extract codepoints
+        if (finalByte === "_" && parts.length >= 3) {
+            const cps = parts[2]
+                .split(":")
+                .map(Number)
+                .filter((cp) => cp >= 32);
+            const result = [];
+            for (const cp of cps) {
+                const ch = String.fromCodePoint(cp);
+                if (this.shouldInsertKittyPrintable(ch, "kitty-text")) {
+                    result.push({ kind: "printable", char: ch, source: "kitty-text" });
+                }
+            }
+            return result;
+        }
+        // Printable keycodes via 'u'
+        if (keyCode >= 32 && keyCode < 127) {
+            const ch = String.fromCharCode(keyCode);
+            if (this.shouldInsertKittyPrintable(ch, "kitty-u")) {
+                return [{ kind: "printable", char: ch, source: "kitty-u" }];
+            }
+            return [];
+        }
+        this.clearKittyPrintable();
+        return [];
+    }
+    parseKittyEventType(modsAndEvent) {
+        if (!modsAndEvent)
+            return 1;
+        const raw = modsAndEvent.split(":")[1];
+        const parsed = raw ? parseInt(raw, 10) : NaN;
+        return Number.isFinite(parsed) ? parsed : 1;
+    }
+    shouldInsertKittyPrintable(char, source) {
+        const ts = this.now();
+        const prev = this.lastKittyPrintable;
+        if (prev && ts - prev.at > this.dedupeWindowMs) {
+            this.lastKittyPrintable = undefined;
+        }
+        const currentPrev = this.lastKittyPrintable;
+        if (currentPrev &&
+            currentPrev.char === char &&
+            currentPrev.source !== source &&
+            ts - currentPrev.at <= this.dedupeWindowMs) {
+            this.lastKittyPrintable = undefined;
+            return false;
+        }
+        this.lastKittyPrintable = { char, source, at: ts };
+        return true;
+    }
+    clearKittyPrintable() {
+        this.lastKittyPrintable = undefined;
+    }
+}
+//# sourceMappingURL=terminal-input.js.map

package/dist/terminal-input.js.map

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

package/dist/user/dsl.d.ts

@@ -0,0 +1,13 @@
+import type { UserStep } from "../flow/types.js";
+import type { WhenCondition, PhaseLabelSpec } from "../flow/dsl.js";
+export declare function user(label: string, opts?: {
+    id?: string;
+    when?: WhenCondition;
+    whenLabel?: string;
+    reads?: Record<string, string>;
+    writes?: Record<string, string>;
+    feedbackToTask?: boolean;
+    breakOnAccept?: boolean;
+    phaseLabel?: PhaseLabelSpec;
+}): UserStep;
+//# sourceMappingURL=dsl.d.ts.map

package/dist/user/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../src/user/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAEjF,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,GAAG,QAAQ,CAiBX"}

package/dist/user/dsl.js

@@ -0,0 +1,19 @@
+export function user(label, opts) {
+    const _phaseLabel = opts?.phaseLabel ?? "👤 User Review...";
+    const raw = {
+        type: "user",
+        id: opts?.id ?? "",
+        role: "user",
+        reads: opts?.reads ?? { display: "plan" },
+        writes: opts?.writes ?? {},
+        feedbackToTask: opts?.feedbackToTask ?? true,
+        breakOnAccept: opts?.breakOnAccept,
+        phaseLabel: typeof _phaseLabel === "string" ? _phaseLabel : "",
+        _idPrefix: `user-${label}`,
+        _when: opts?.when,
+        _whenLabel: opts?.whenLabel,
+        _phaseLabel,
+    };
+    return raw;
+}
+//# sourceMappingURL=dsl.js.map

package/dist/user/dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.js","sourceRoot":"","sources":["../../src/user/dsl.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,IASnC;IACC,MAAM,WAAW,GAAG,IAAI,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC5D,MAAM,GAAG,GAAgB;QACvB,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE;QAClB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;QACzC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;QAC1B,cAAc,EAAE,IAAI,EAAE,cAAc,IAAI,IAAI;QAC5C,aAAa,EAAE,IAAI,EAAE,aAAa;QAClC,UAAU,EAAE,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QAC9D,SAAS,EAAE,QAAQ,KAAK,EAAE;QAC1B,KAAK,EAAE,IAAI,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI,EAAE,SAAS;QAC3B,WAAW;KACZ,CAAC;IACF,OAAO,GAA0B,CAAC;AACpC,CAAC"}

package/dist/user/handler.d.ts

@@ -0,0 +1,16 @@
+import type { UserPromptHandler } from "./prompt.js";
+import type { BaseStep, StepContext, StepSignal, RetryFn, RoleHandler } from "../flow/types.js";
+/**
+ * RoleHandler adapter that bridges UserPromptHandler with the flow executor.
+ * Registered as the "user" role so user steps are dispatched uniformly.
+ *
+ * On rejection, writes a unified verdict artifact with data, text, and meta.
+ * This ensures `artifactData("verdict", "approved")` evaluates correctly when
+ * the user rejects after a reviewer approves.
+ */
+export declare class UserRoleHandler implements RoleHandler {
+    private userPhase;
+    constructor(userPhase: UserPromptHandler);
+    execute(step: BaseStep, ctx: StepContext, _retry: RetryFn): Promise<StepSignal>;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/user/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/user/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EACV,QAAQ,EAER,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACrC,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,iBAAiB;IAE1C,OAAO,CACX,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,UAAU,CAAC;CAsCvB"}

package/dist/user/handler.js

@@ -0,0 +1,49 @@
+/**
+ * RoleHandler adapter that bridges UserPromptHandler with the flow executor.
+ * Registered as the "user" role so user steps are dispatched uniformly.
+ *
+ * On rejection, writes a unified verdict artifact with data, text, and meta.
+ * This ensures `artifactData("verdict", "approved")` evaluates correctly when
+ * the user rejects after a reviewer approves.
+ */
+export class UserRoleHandler {
+    userPhase;
+    constructor(userPhase) {
+        this.userPhase = userPhase;
+    }
+    async execute(step, ctx, _retry) {
+        const displayArtifact = step.reads.display;
+        const displayText = displayArtifact
+            ? ctx.artifacts.getText(displayArtifact) ?? "" : "";
+        // Build prompt context from the verdict artifact
+        const verdictArtifactName = step.writes.verdict;
+        const verdictData = verdictArtifactName
+            ? ctx.artifacts.getData(verdictArtifactName)
+            : undefined;
+        const verdictSource = verdictArtifactName
+            ? ctx.artifacts.getMeta(verdictArtifactName, "source")
+            : undefined;
+        const promptCtx = {
+            verdictApproved: verdictData?.approved,
+            isFirstReview: verdictData === undefined,
+            verdictSource,
+            previousStepRole: ctx.previousStepRole,
+        };
+        const result = await this.userPhase.prompt(displayText, step.id, promptCtx);
+        if (result.accepted) {
+            const userStep = step;
+            return { kind: userStep.breakOnAccept ? "break-loop" : "continue" };
+        }
+        // Rejected — write to verdict artifact with data + text + meta
+        const verdictKey = step.writes.verdict;
+        if (verdictKey) {
+            ctx.artifacts.set(verdictKey, {
+                data: { approved: false },
+                text: result.comments ?? "",
+                meta: { source: "user" },
+            });
+        }
+        return { kind: "restart-loop" };
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/user/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/user/handler.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,SAA4B;QAA5B,cAAS,GAAT,SAAS,CAAmB;IAAG,CAAC;IAEpD,KAAK,CAAC,OAAO,CACX,IAAc,EACd,GAAgB,EAChB,MAAe;QAEf,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC3C,MAAM,WAAW,GAAG,eAAe;YACjC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtD,iDAAiD;QACjD,MAAM,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAChD,MAAM,WAAW,GAAG,mBAAmB;YACrC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAyB,mBAAmB,CAAC;YACpE,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,aAAa,GAAG,mBAAmB;YACvC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAS,mBAAmB,EAAE,QAAQ,CAAC;YAC9D,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,SAAS,GAAsB;YACnC,eAAe,EAAE,WAAW,EAAE,QAAQ;YACtC,aAAa,EAAE,WAAW,KAAK,SAAS;YACxC,aAAa;YACb,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;SACvC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAE5E,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAgB,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QACtE,CAAC;QAED,+DAA+D;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACvC,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE;gBAC5B,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;gBACzB,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;gBAC3B,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aACzB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/user/index.d.ts

@@ -0,0 +1,5 @@
+export type { UserPromptHandler, UserPromptResult, UserPromptContext } from "./prompt.js";
+export { InteractiveUserPrompt, AutoUserPrompt, RawInputParser } from "./prompt.js";
+export { UserRoleHandler } from "./handler.js";
+export { user } from "./dsl.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/user/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/user/index.js

@@ -0,0 +1,4 @@
+export { InteractiveUserPrompt, AutoUserPrompt, RawInputParser } from "./prompt.js";
+export { UserRoleHandler } from "./handler.js";
+export { user } from "./dsl.js";
+//# sourceMappingURL=index.js.map

package/dist/user/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/user/prompt.d.ts

@@ -0,0 +1,86 @@
+import { type FeatureGates } from "../providers/registry.js";
+import type { BuiltinRole } from "../flow/types.js";
+export interface UserPromptResult {
+    accepted: boolean;
+    comments?: string;
+}
+type RawInputEvent = {
+    type: "insert";
+    text: string;
+} | {
+    type: "backspace";
+} | {
+    type: "submit";
+} | {
+    type: "newline";
+} | {
+    type: "ctrl-c";
+} | {
+    type: "arrow";
+    direction: "up" | "down";
+};
+/**
+ * Stateful parser for raw stdin bytes in normal mode and kitty keyboard protocol mode.
+ *
+ * Kitty may emit both key (`...u`) and text (`..._`) variants for one printable
+ * keystroke. We deduplicate matching adjacent variants so one physical keypress
+ * produces exactly one inserted character.
+ */
+export declare class RawInputParser {
+    private parser;
+    constructor(now?: () => number, dedupeWindowMs?: number);
+    parseChunk(chunk: Buffer): RawInputEvent[];
+    private mapKey;
+}
+export interface UserPromptContext {
+    /** Whether the reviewer approved the plan. undefined = no verdict yet. */
+    verdictApproved?: boolean;
+    /** True when no prior verdict exists (first review before any reviewer runs). */
+    isFirstReview?: boolean;
+    /** Who produced the verdict: "user" | "reviewer" | undefined. */
+    verdictSource?: string;
+    /** Role of the step that executed immediately before this user step. */
+    previousStepRole?: BuiltinRole | "user";
+}
+export interface UserPromptHandler {
+    /**
+     * Present the plan to the user and collect their decision.
+     * @param plan - The full plan text. Displayed unless the provider streamed it natively (see FeatureGates.nativePlanMode).
+     * @param phase - Which checkpoint triggered this prompt
+     * @param context - Optional context with verdict status
+     */
+    prompt(plan: string, phase: string, context?: UserPromptContext): Promise<UserPromptResult>;
+}
+/**
+ * Interactive user prompt handler.
+ * Displays the plan (unless nativePlanMode gate suppresses it) and collects multiline input.
+ * Empty input = accept, non-empty = comments for revision.
+ *
+ * Uses a raw stdin reader instead of readline so that input works even
+ * when the terminal is in kitty keyboard protocol mode (which spawned
+ * PTY processes like Claude Code may leave enabled).
+ */
+export declare class InteractiveUserPrompt implements UserPromptHandler {
+    readonly gates: FeatureGates;
+    constructor(gates?: FeatureGates);
+    prompt(plan: string, phase: string, context?: UserPromptContext): Promise<UserPromptResult>;
+    /** True unless the provider already streamed the plan natively (planner → user). */
+    private shouldDisplayPlan;
+    private printPlan;
+    /**
+     * Two-row selector: "Approve" row and multiline feedback input area.
+     * `❯` arrow moves between rows to indicate which is active.
+     * Input row is active by default — just start typing.
+     * Enter inserts a newline; Ctrl+D submits.
+     * Approve requires ↑ then Enter.
+     */
+    private collectDecision;
+}
+/**
+ * No-op handler that always accepts. Used for --auto mode and as the default.
+ */
+export declare class AutoUserPrompt implements UserPromptHandler {
+    prompt(): Promise<UserPromptResult>;
+}
+export {};
+//# sourceMappingURL=prompt.d.ts.map