nightralph 0.0.8 → 0.0.10

package/README.md

@@ -141,7 +141,8 @@ Flags:
 | `-X` | no | -- | Stop on merge conflict instead of re-spawning |
 | `--timeout` | no | `300` | Kill agent after N seconds |
 
-Notes:
+
+**Notes**:
 
 * When `--spec <name>` is omitted, the CLI looks for
   `.scratch/<feature>/issues/` directories. If multiple features exist,
@@ -213,9 +214,17 @@ This is expected to run for a long time, like overnight.
 
 ### Mac OS
 
+#### Claude
+
 ```sh
 caffeinate -i npx nightralph claude -m claude-opus-4-6
 ```
 
+##### Run with `pi` and an OpenRouter model
+
+```sh
+caffeinate -i npx nightralph pi -m openrouter/z-ai/glm-5.3-flash
+```
+
 That command will prevent your machine from sleeping, but the display can still
 go dark.

package/dist/demo-display.js

@@ -0,0 +1,298 @@
+// src/display.ts
+var ESC = "\x1B[";
+var ansi = {
+  cursorUp(n) {
+    return `${ESC}${n}A`;
+  },
+  cursorTo(col) {
+    return `${ESC}${col}G`;
+  },
+  eraseLine() {
+    return `${ESC}2K`;
+  },
+  eraseLines(n) {
+    let out = "";
+    for (let i = 0; i < n; i++) {
+      out += ansi.eraseLine();
+      if (i < n - 1) out += ansi.cursorUp(1);
+    }
+    return out;
+  },
+  cursorHide() {
+    return `${ESC}?25l`;
+  },
+  cursorShow() {
+    return `${ESC}?25h`;
+  }
+};
+var color = {
+  green(text) {
+    return `${ESC}32m${text}${ESC}0m`;
+  },
+  yellow(text) {
+    return `${ESC}33m${text}${ESC}0m`;
+  },
+  red(text) {
+    return `${ESC}31m${text}${ESC}0m`;
+  },
+  dim(text) {
+    return `${ESC}2m${text}${ESC}0m`;
+  }
+};
+var FILLED_DOT = "\u25CF";
+var EMPTY_DOT = "\u25CB";
+function renderDot(status) {
+  switch (status) {
+    case "pending":
+      return color.dim(EMPTY_DOT);
+    case "in-progress":
+      return color.yellow(FILLED_DOT);
+    case "done":
+      return color.green(FILLED_DOT);
+    case "failed":
+      return color.red(FILLED_DOT);
+  }
+}
+var StatusDisplay = class {
+  wave = null;
+  messages = [];
+  renderedLines = 0;
+  config;
+  viewportStart = 0;
+  resizeListener = null;
+  signalHandler = null;
+  constructor(config) {
+    this.config = {
+      messageLines: config?.messageLines ?? 10,
+      stream: config?.stream ?? process.stdout
+    };
+  }
+  getAvailableRows() {
+    const termHeight = this.config.stream.rows ?? 24;
+    const overhead = 2 + this.config.messageLines;
+    const available = termHeight - overhead;
+    return Math.max(1, available);
+  }
+  startWave(waveNum, totalWaves, tickets2) {
+    this.wave = {
+      waveNum,
+      totalWaves,
+      tickets: tickets2.map((t) => ({
+        ...t,
+        status: "pending"
+      }))
+    };
+    this.messages = [];
+    this.viewportStart = 0;
+    this.config.stream.write(ansi.cursorHide());
+    if (this.config.stream.isTTY) {
+      if (this.resizeListener) {
+        this.config.stream.removeListener(
+          "resize",
+          this.resizeListener
+        );
+      }
+      this.resizeListener = () => this.render();
+      this.config.stream.on(
+        "resize",
+        this.resizeListener
+      );
+    }
+    if (this.signalHandler) {
+      process.removeListener("SIGINT", this.signalHandler);
+      process.removeListener("SIGTERM", this.signalHandler);
+    }
+    this.signalHandler = () => this.cleanup();
+    process.on("SIGINT", this.signalHandler);
+    process.on("SIGTERM", this.signalHandler);
+    this.render();
+  }
+  setTicketStatus(num, status) {
+    if (!this.wave) return;
+    const ticket = this.wave.tickets.find((t) => t.num === num);
+    if (ticket) {
+      ticket.status = status;
+      if (status === "in-progress") {
+        const ticketIndex = this.wave.tickets.indexOf(ticket);
+        const availableRows = this.getAvailableRows();
+        const totalTickets = this.wave.tickets.length;
+        if (ticketIndex < this.viewportStart) {
+          this.viewportStart = ticketIndex;
+        } else if (ticketIndex >= this.viewportStart + availableRows) {
+          this.viewportStart = ticketIndex - availableRows + 3;
+        }
+        this.viewportStart = Math.max(
+          0,
+          Math.min(
+            this.viewportStart,
+            totalTickets - 1
+          )
+        );
+      }
+      this.render();
+    }
+  }
+  log(message) {
+    this.messages.push(message);
+    if (this.messages.length > this.config.messageLines) {
+      this.messages.shift();
+    }
+    this.render();
+  }
+  cleanup() {
+    if (this.resizeListener && this.config.stream.isTTY) {
+      this.config.stream.removeListener("resize", this.resizeListener);
+    }
+    if (this.signalHandler) {
+      process.removeListener("SIGINT", this.signalHandler);
+      process.removeListener("SIGTERM", this.signalHandler);
+    }
+    this.config.stream.write(ansi.cursorShow());
+  }
+  render() {
+    if (!this.wave) return;
+    let output = "";
+    if (this.renderedLines > 0) {
+      output += ansi.eraseLines(this.renderedLines + 1);
+    }
+    const completed = this.wave.tickets.filter(
+      (t) => t.status === "done"
+    ).length;
+    const total = this.wave.tickets.length;
+    const pct = total === 0 ? 0 : Math.round(completed / total * 100);
+    output += `Wave ${this.wave.waveNum}/${this.wave.totalWaves} -- ${pct}% complete
+`;
+    const availableRows = this.getAvailableRows();
+    const tickets2 = this.wave.tickets;
+    let renderedTicketCount = 0;
+    if (tickets2.length <= availableRows) {
+      for (const ticket of tickets2) {
+        const dot = renderDot(ticket.status);
+        output += `${dot} ${ticket.filename}
+`;
+      }
+      renderedTicketCount = tickets2.length;
+    } else {
+      this.viewportStart = Math.max(
+        0,
+        Math.min(
+          this.viewportStart,
+          tickets2.length - 1
+        )
+      );
+      let hasMoreAbove = this.viewportStart > 0;
+      let tentativeCount = availableRows - (hasMoreAbove ? 1 : 0);
+      let hasMoreBelow = this.viewportStart + tentativeCount < tickets2.length;
+      let ticketsToShow = Math.max(
+        0,
+        tentativeCount - (hasMoreBelow ? 1 : 0)
+      );
+      const maxStart = Math.max(
+        0,
+        tickets2.length - Math.max(1, ticketsToShow)
+      );
+      if (this.viewportStart > maxStart) {
+        this.viewportStart = maxStart;
+        hasMoreAbove = this.viewportStart > 0;
+        tentativeCount = availableRows - (hasMoreAbove ? 1 : 0);
+        hasMoreBelow = this.viewportStart + tentativeCount < tickets2.length;
+        ticketsToShow = Math.max(
+          0,
+          tentativeCount - (hasMoreBelow ? 1 : 0)
+        );
+      }
+      if (hasMoreAbove) {
+        const moreCount = this.viewportStart;
+        output += `  ... ${moreCount} more above
+`;
+      }
+      const visibleTickets = tickets2.slice(
+        this.viewportStart,
+        this.viewportStart + ticketsToShow
+      );
+      for (const ticket of visibleTickets) {
+        const dot = renderDot(ticket.status);
+        output += `${dot} ${ticket.filename}
+`;
+      }
+      if (hasMoreBelow) {
+        const moreCount = tickets2.length - (this.viewportStart + ticketsToShow);
+        output += `  ... ${moreCount} more below
+`;
+      }
+      renderedTicketCount = (hasMoreAbove ? 1 : 0) + visibleTickets.length + (hasMoreBelow ? 1 : 0);
+    }
+    output += "-".repeat(50) + "\n";
+    const msgLines = Math.max(
+      0,
+      this.config.messageLines - this.messages.length
+    );
+    for (const msg of this.messages) {
+      output += `${msg}
+`;
+    }
+    for (let i = 0; i < msgLines; i++) {
+      output += "\n";
+    }
+    this.renderedLines = 2 + renderedTicketCount + this.config.messageLines;
+    this.config.stream.write(output);
+  }
+};
+
+// demo-display.ts
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+var tickets = [
+  { num: 1, filename: "001-add-login-page.md" },
+  { num: 2, filename: "002-fix-header-alignment.md" },
+  { num: 3, filename: "003-refactor-auth-module.md" },
+  { num: 4, filename: "004-update-dependencies.md" },
+  { num: 5, filename: "005-add-dark-mode.md" },
+  { num: 6, filename: "006-improve-error-messages.md" },
+  { num: 7, filename: "007-add-search-feature.md" },
+  { num: 8, filename: "008-optimize-queries.md" }
+];
+async function main() {
+  const display = new StatusDisplay();
+  const wave1 = tickets.slice(0, 4);
+  display.startWave(1, 3, wave1);
+  display.log("Starting wave 1...");
+  for (const t of wave1) {
+    await sleep(600);
+    display.setTicketStatus(t.num, "in-progress");
+    display.log(`Agent working on ${t.filename}`);
+    await sleep(1200);
+    const status = t.num === 3 ? "failed" : "done";
+    display.setTicketStatus(t.num, status);
+    display.log(
+      status === "done" ? `Completed ${t.filename}` : `Failed ${t.filename}`
+    );
+  }
+  await sleep(1e3);
+  const wave2 = tickets.slice(4, 7);
+  display.startWave(2, 3, wave2);
+  display.log("Starting wave 2...");
+  for (const t of wave2) {
+    await sleep(600);
+    display.setTicketStatus(t.num, "in-progress");
+    display.log(`Agent working on ${t.filename}`);
+    await sleep(1e3);
+    display.setTicketStatus(t.num, "done");
+    display.log(`Completed ${t.filename}`);
+  }
+  await sleep(1e3);
+  const wave3 = tickets.slice(7);
+  display.startWave(3, 3, wave3);
+  display.log("Starting wave 3...");
+  await sleep(600);
+  display.setTicketStatus(8, "in-progress");
+  display.log("Agent working on 008-optimize-queries.md");
+  await sleep(1500);
+  display.setTicketStatus(8, "done");
+  display.log("Completed 008-optimize-queries.md");
+  await sleep(800);
+  display.cleanup();
+  console.log("\nDemo complete.");
+}
+main();

package/dist/display.js

@@ -0,0 +1,280 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const ESC = "\x1B[";
+const ansi = {
+  cursorUp(n) {
+    return `${ESC}${n}A`;
+  },
+  cursorTo(col) {
+    return `${ESC}${col}G`;
+  },
+  eraseLine() {
+    return `${ESC}2K`;
+  },
+  eraseLines(n) {
+    let out = "";
+    for (let i = 0; i < n; i++) {
+      out += ansi.eraseLine();
+      if (i < n - 1) out += ansi.cursorUp(1);
+    }
+    return out;
+  },
+  cursorHide() {
+    return `${ESC}?25l`;
+  },
+  cursorShow() {
+    return `${ESC}?25h`;
+  }
+};
+const color = {
+  green(text) {
+    return `${ESC}32m${text}${ESC}0m`;
+  },
+  yellow(text) {
+    return `${ESC}33m${text}${ESC}0m`;
+  },
+  red(text) {
+    return `${ESC}31m${text}${ESC}0m`;
+  },
+  dim(text) {
+    return `${ESC}2m${text}${ESC}0m`;
+  }
+};
+const FILLED_DOT = "\u25CF";
+const EMPTY_DOT = "\u25CB";
+function renderDot(status) {
+  switch (status) {
+    case "pending":
+      return color.dim(EMPTY_DOT);
+    case "in-progress":
+      return color.yellow(FILLED_DOT);
+    case "done":
+      return color.green(FILLED_DOT);
+    case "failed":
+      return color.red(FILLED_DOT);
+  }
+}
+__name(renderDot, "renderDot");
+class StatusDisplay {
+  static {
+    __name(this, "StatusDisplay");
+  }
+  wave = null;
+  messages = [];
+  renderedLines = 0;
+  config;
+  viewportStart = 0;
+  resizeListener = null;
+  signalHandler = null;
+  constructor(config) {
+    this.config = {
+      messageLines: config?.messageLines ?? 10,
+      stream: config?.stream ?? process.stdout
+    };
+  }
+  getAvailableRows() {
+    const termHeight = this.config.stream.rows ?? 24;
+    const overhead = 2 + this.config.messageLines;
+    const available = termHeight - overhead;
+    return Math.max(1, available);
+  }
+  startWave(waveNum, totalWaves, tickets) {
+    this.wave = {
+      waveNum,
+      totalWaves,
+      tickets: tickets.map((t) => ({
+        ...t,
+        status: "pending"
+      }))
+    };
+    this.messages = [];
+    this.viewportStart = 0;
+    this.config.stream.write(ansi.cursorHide());
+    if (this.config.stream.isTTY) {
+      if (this.resizeListener) {
+        this.config.stream.removeListener(
+          "resize",
+          this.resizeListener
+        );
+      }
+      this.resizeListener = () => this.render();
+      this.config.stream.on(
+        "resize",
+        this.resizeListener
+      );
+    }
+    if (this.signalHandler) {
+      process.removeListener("SIGINT", this.signalHandler);
+      process.removeListener("SIGTERM", this.signalHandler);
+    }
+    this.signalHandler = () => this.cleanup();
+    process.on("SIGINT", this.signalHandler);
+    process.on("SIGTERM", this.signalHandler);
+    this.render();
+  }
+  setTicketStatus(num, status) {
+    if (!this.wave) return;
+    const ticket = this.wave.tickets.find((t) => t.num === num);
+    if (ticket) {
+      ticket.status = status;
+      if (status === "in-progress") {
+        const ticketIndex = this.wave.tickets.indexOf(ticket);
+        const availableRows = this.getAvailableRows();
+        const totalTickets = this.wave.tickets.length;
+        if (ticketIndex < this.viewportStart) {
+          this.viewportStart = ticketIndex;
+        } else if (ticketIndex >= this.viewportStart + availableRows) {
+          this.viewportStart = ticketIndex - availableRows + 3;
+        }
+        this.viewportStart = Math.max(
+          0,
+          Math.min(
+            this.viewportStart,
+            totalTickets - 1
+          )
+        );
+      }
+      this.render();
+    }
+  }
+  log(message) {
+    this.messages.push(message);
+    if (this.messages.length > this.config.messageLines) {
+      this.messages.shift();
+    }
+    this.render();
+  }
+  cleanup() {
+    if (this.resizeListener && this.config.stream.isTTY) {
+      this.config.stream.removeListener("resize", this.resizeListener);
+    }
+    if (this.signalHandler) {
+      process.removeListener("SIGINT", this.signalHandler);
+      process.removeListener("SIGTERM", this.signalHandler);
+    }
+    this.config.stream.write(ansi.cursorShow());
+  }
+  render() {
+    if (!this.wave) return;
+    let output = "";
+    if (this.renderedLines > 0) {
+      output += ansi.eraseLines(this.renderedLines + 1);
+    }
+    const completed = this.wave.tickets.filter(
+      (t) => t.status === "done"
+    ).length;
+    const total = this.wave.tickets.length;
+    const pct = total === 0 ? 0 : Math.round(completed / total * 100);
+    output += `Wave ${this.wave.waveNum}/${this.wave.totalWaves} -- ${pct}% complete
+`;
+    const availableRows = this.getAvailableRows();
+    const tickets = this.wave.tickets;
+    let renderedTicketCount = 0;
+    if (tickets.length <= availableRows) {
+      for (const ticket of tickets) {
+        const dot = renderDot(ticket.status);
+        output += `${dot} ${ticket.filename}
+`;
+      }
+      renderedTicketCount = tickets.length;
+    } else {
+      this.viewportStart = Math.max(
+        0,
+        Math.min(
+          this.viewportStart,
+          tickets.length - 1
+        )
+      );
+      let hasMoreAbove = this.viewportStart > 0;
+      let tentativeCount = availableRows - (hasMoreAbove ? 1 : 0);
+      let hasMoreBelow = this.viewportStart + tentativeCount < tickets.length;
+      let ticketsToShow = Math.max(
+        0,
+        tentativeCount - (hasMoreBelow ? 1 : 0)
+      );
+      const maxStart = Math.max(
+        0,
+        tickets.length - Math.max(1, ticketsToShow)
+      );
+      if (this.viewportStart > maxStart) {
+        this.viewportStart = maxStart;
+        hasMoreAbove = this.viewportStart > 0;
+        tentativeCount = availableRows - (hasMoreAbove ? 1 : 0);
+        hasMoreBelow = this.viewportStart + tentativeCount < tickets.length;
+        ticketsToShow = Math.max(
+          0,
+          tentativeCount - (hasMoreBelow ? 1 : 0)
+        );
+      }
+      if (hasMoreAbove) {
+        const moreCount = this.viewportStart;
+        output += `  ... ${moreCount} more above
+`;
+      }
+      const visibleTickets = tickets.slice(
+        this.viewportStart,
+        this.viewportStart + ticketsToShow
+      );
+      for (const ticket of visibleTickets) {
+        const dot = renderDot(ticket.status);
+        output += `${dot} ${ticket.filename}
+`;
+      }
+      if (hasMoreBelow) {
+        const moreCount = tickets.length - (this.viewportStart + ticketsToShow);
+        output += `  ... ${moreCount} more below
+`;
+      }
+      renderedTicketCount = (hasMoreAbove ? 1 : 0) + visibleTickets.length + (hasMoreBelow ? 1 : 0);
+    }
+    output += "-".repeat(50) + "\n";
+    const msgLines = Math.max(
+      0,
+      this.config.messageLines - this.messages.length
+    );
+    for (const msg of this.messages) {
+      output += `${msg}
+`;
+    }
+    for (let i = 0; i < msgLines; i++) {
+      output += "\n";
+    }
+    this.renderedLines = 2 + renderedTicketCount + this.config.messageLines;
+    this.config.stream.write(output);
+  }
+}
+class PlainDisplay {
+  static {
+    __name(this, "PlainDisplay");
+  }
+  startWave(waveNum, _totalWaves, tickets) {
+    console.log(
+      `
+Wave ${waveNum}: ` + tickets.map((t) => t.filename).join(", ")
+    );
+  }
+  setTicketStatus(_num, _status) {
+  }
+  log(message) {
+    console.log(message);
+  }
+  cleanup() {
+  }
+}
+function createDisplay(stream) {
+  const s = stream ?? process.stdout;
+  if (s.isTTY) {
+    return new StatusDisplay({ stream: s });
+  }
+  return new PlainDisplay();
+}
+__name(createDisplay, "createDisplay");
+export {
+  PlainDisplay,
+  StatusDisplay,
+  ansi,
+  color,
+  createDisplay,
+  renderDot
+};
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/display.ts"],
+  "sourcesContent": ["export type TicketStatus =\n    | 'pending'\n    | 'in-progress'\n    | 'done'\n    | 'failed'\n\nexport type DisplayTicket = {\n    readonly num:number\n    readonly filename:string\n    status:TicketStatus\n}\n\nexport type WaveState = {\n    readonly waveNum:number\n    readonly totalWaves:number\n    readonly tickets:Array<DisplayTicket>\n}\n\nexport type DisplayConfig = {\n    readonly messageLines:number\n    readonly stream:NodeJS.WriteStream\n}\n\nexport type Display = {\n    startWave(\n        waveNum:number,\n        totalWaves:number,\n        tickets:ReadonlyArray<{\n            num:number\n            filename:string\n        }>\n    ):void\n    setTicketStatus(num:number, status:TicketStatus):void\n    log(message:string):void\n    cleanup():void\n}\n\nconst ESC = '\\x1b['\n\nexport const ansi = {\n    cursorUp (n:number):string {\n        return `${ESC}${n}A`\n    },\n    cursorTo (col:number):string {\n        return `${ESC}${col}G`\n    },\n    eraseLine ():string {\n        return `${ESC}2K`\n    },\n    eraseLines (n:number):string {\n        let out = ''\n        for (let i = 0; i < n; i++) {\n            out += ansi.eraseLine()\n            if (i < n - 1) out += ansi.cursorUp(1)\n        }\n        return out\n    },\n    cursorHide ():string {\n        return `${ESC}?25l`\n    },\n    cursorShow ():string {\n        return `${ESC}?25h`\n    },\n} as const\n\nexport const color = {\n    green (text:string):string {\n        return `${ESC}32m${text}${ESC}0m`\n    },\n    yellow (text:string):string {\n        return `${ESC}33m${text}${ESC}0m`\n    },\n    red (text:string):string {\n        return `${ESC}31m${text}${ESC}0m`\n    },\n    dim (text:string):string {\n        return `${ESC}2m${text}${ESC}0m`\n    },\n} as const\n\nconst FILLED_DOT = '\u25CF'\nconst EMPTY_DOT = '\u25CB'\n\nexport function renderDot (status:TicketStatus):string {\n    switch (status) {\n        case 'pending':\n            return color.dim(EMPTY_DOT)\n        case 'in-progress':\n            return color.yellow(FILLED_DOT)\n        case 'done':\n            return color.green(FILLED_DOT)\n        case 'failed':\n            return color.red(FILLED_DOT)\n    }\n}\n\nexport class StatusDisplay implements Display {\n    private wave:WaveState|null = null\n    private messages:Array<string> = []\n    private renderedLines:number = 0\n    private config:DisplayConfig\n    private viewportStart:number = 0\n    private resizeListener:(() => void)|null = null\n    private signalHandler:(() => void)|null = null\n\n    constructor (config?:Readonly<Partial<DisplayConfig>>) {\n        this.config = {\n            messageLines:config?.messageLines ?? 10,\n            stream:config?.stream ?? process.stdout,\n        }\n    }\n\n    private getAvailableRows ():number {\n        const termHeight = this.config.stream.rows ?? 24\n        const overhead = 2 + this.config.messageLines\n        const available = termHeight - overhead\n        return Math.max(1, available)\n    }\n\n    startWave (\n        waveNum:number,\n        totalWaves:number,\n        tickets:Array<Readonly<{ num:number; filename:string }>>,\n    ):void {\n        this.wave = {\n            waveNum,\n            totalWaves,\n            tickets:tickets.map(t => ({\n                ...t,\n                status:'pending' as const,\n            })),\n        }\n        this.messages = []\n        this.viewportStart = 0\n        this.config.stream.write(ansi.cursorHide())\n\n        if (this.config.stream.isTTY) {\n            if (this.resizeListener) {\n                this.config.stream.removeListener(\n                    'resize', this.resizeListener,\n                )\n            }\n            this.resizeListener = () => this.render()\n            this.config.stream.on(\n                'resize', this.resizeListener,\n            )\n        }\n\n        // Register signal handler to restore cursor on interruption\n        if (this.signalHandler) {\n            process.removeListener('SIGINT', this.signalHandler)\n            process.removeListener('SIGTERM', this.signalHandler)\n        }\n        this.signalHandler = () => this.cleanup()\n        process.on('SIGINT', this.signalHandler)\n        process.on('SIGTERM', this.signalHandler)\n\n        this.render()\n    }\n\n    setTicketStatus (num:number, status:TicketStatus):void {\n        if (!this.wave) return\n\n        const ticket = this.wave.tickets.find(t => t.num === num)\n        if (ticket) {\n            ticket.status = status\n\n            if (status === 'in-progress') {\n                const ticketIndex =\n                    this.wave.tickets.indexOf(ticket)\n                const availableRows =\n                    this.getAvailableRows()\n                const totalTickets =\n                    this.wave.tickets.length\n\n                if (ticketIndex < this.viewportStart) {\n                    this.viewportStart = ticketIndex\n                } else if (\n                    ticketIndex >=\n                    this.viewportStart + availableRows\n                ) {\n                    // offset by 3 to keep context visible below\n                    // the active ticket\n                    this.viewportStart =\n                        ticketIndex - availableRows + 3\n                }\n                this.viewportStart = Math.max(\n                    0,\n                    Math.min(\n                        this.viewportStart,\n                        totalTickets - 1,\n                    ),\n                )\n            }\n\n            this.render()\n        }\n    }\n\n    log (message:string):void {\n        this.messages.push(message)\n        if (this.messages.length > this.config.messageLines) {\n            this.messages.shift()\n        }\n        this.render()\n    }\n\n    cleanup ():void {\n        // Remove resize listener if it exists\n        if (this.resizeListener && this.config.stream.isTTY) {\n            this.config.stream.removeListener('resize', this.resizeListener)\n        }\n        // Remove signal handlers\n        if (this.signalHandler) {\n            process.removeListener('SIGINT', this.signalHandler)\n            process.removeListener('SIGTERM', this.signalHandler)\n        }\n        this.config.stream.write(ansi.cursorShow())\n    }\n\n    private render ():void {\n        if (!this.wave) return\n\n        let output = ''\n\n        if (this.renderedLines > 0) {\n            output +=\n                ansi.eraseLines(this.renderedLines + 1)\n        }\n\n        const completed = this.wave.tickets.filter(\n            t => t.status === 'done',\n        ).length\n        const total = this.wave.tickets.length\n        const pct = total === 0 ? 0 : Math.round((completed / total) * 100)\n\n        output += `Wave ${this.wave.waveNum}/` +\n            `${this.wave.totalWaves} -- ` +\n            `${pct}% complete\\n`\n\n        // Pagination logic\n        const availableRows = this.getAvailableRows()\n        const tickets = this.wave.tickets\n        let renderedTicketCount = 0\n\n        if (tickets.length <= availableRows) {\n            // All tickets fit, no pagination\n            for (const ticket of tickets) {\n                const dot = renderDot(ticket.status)\n                output += `${dot} ${ticket.filename}\\n`\n            }\n            renderedTicketCount = tickets.length\n        } else {\n            // Need pagination -- iterative clamp\n            this.viewportStart = Math.max(\n                0,\n                Math.min(\n                    this.viewportStart,\n                    tickets.length - 1,\n                ),\n            )\n\n            let hasMoreAbove = this.viewportStart > 0\n            let tentativeCount =\n                availableRows - (hasMoreAbove ? 1 : 0)\n            let hasMoreBelow =\n                this.viewportStart + tentativeCount <\n                tickets.length\n            let ticketsToShow = Math.max(\n                0,\n                tentativeCount - (hasMoreBelow ? 1 : 0),\n            )\n\n            const maxStart = Math.max(\n                0,\n                tickets.length - Math.max(1, ticketsToShow),\n            )\n            if (this.viewportStart > maxStart) {\n                this.viewportStart = maxStart\n                hasMoreAbove = this.viewportStart > 0\n                tentativeCount =\n                    availableRows - (hasMoreAbove ? 1 : 0)\n                hasMoreBelow =\n                    this.viewportStart + tentativeCount <\n                    tickets.length\n                ticketsToShow = Math.max(\n                    0,\n                    tentativeCount -\n                    (hasMoreBelow ? 1 : 0),\n                )\n            }\n\n            // Show \"more above\" indicator if needed\n            if (hasMoreAbove) {\n                const moreCount = this.viewportStart\n                output += `  ... ${moreCount} more above\\n`\n            }\n\n            // Get visible tickets and render them\n            const visibleTickets = tickets.slice(\n                this.viewportStart,\n                this.viewportStart + ticketsToShow,\n            )\n\n            for (const ticket of visibleTickets) {\n                const dot = renderDot(ticket.status)\n                output += `${dot} ${ticket.filename}\\n`\n            }\n\n            // Show \"more below\" indicator if needed\n            if (hasMoreBelow) {\n                const moreCount =\n                    tickets.length -\n                    (this.viewportStart + ticketsToShow)\n                output += `  ... ${moreCount} more below\\n`\n            }\n\n            renderedTicketCount = (hasMoreAbove ? 1 : 0) +\n                visibleTickets.length +\n                (hasMoreBelow ? 1 : 0)\n        }\n\n        output += '-'.repeat(50) + '\\n'\n\n        const msgLines = Math.max(\n            0,\n            this.config.messageLines - this.messages.length,\n        )\n        for (const msg of this.messages) {\n            output += `${msg}\\n`\n        }\n        for (let i = 0; i < msgLines; i++) {\n            output += '\\n'\n        }\n\n        this.renderedLines = 2 + renderedTicketCount + this.config.messageLines\n        this.config.stream.write(output)\n    }\n}\n\nexport class PlainDisplay implements Display {\n    startWave (\n        waveNum:number,\n        _totalWaves:number,\n        tickets:ReadonlyArray<{\n            num:number\n            filename:string\n        }>\n    ):void {\n        console.log(\n            `\\nWave ${waveNum}: ` +\n            tickets.map(t => t.filename).join(', ')\n        )\n    }\n\n    setTicketStatus (\n        _num:number,\n        _status:TicketStatus\n    ):void {\n        // no-op: plain mode reports via log()\n    }\n\n    log (message:string):void {\n        console.log(message)\n    }\n\n    cleanup ():void {\n        // no-op\n    }\n}\n\nexport function createDisplay (\n    stream?:NodeJS.WriteStream\n):Display {\n    const s = stream ?? process.stdout\n    if (s.isTTY) {\n        return new StatusDisplay({ stream:s })\n    }\n    return new PlainDisplay()\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.js

@@ -14,6 +14,7 @@ import {
   runWaves,
   runWavesIsolated
 } from "./orchestrator.js";
+import { createDisplay } from "./display.js";
 import {
   findFeatureDirs,
   resolveIssuesDir,
@@ -178,6 +179,7 @@ async function runExecute(argv) {
     }
     return;
   }
+  const display = createDisplay();
   let result;
   if (isGitRepo()) {
     result = await runWavesIsolated({
@@ -188,7 +190,8 @@ async function runExecute(argv) {
       timeout,
       logsDir,
       featureName,
-      conflictStrategy
+      conflictStrategy,
+      display
     });
   } else {
     result = await runWaves(
@@ -197,7 +200,8 @@ async function runExecute(argv) {
       argv.provider,
       argv.model ?? null,
       timeout,
-      logsDir
+      logsDir,
+      display
     );
   }
   if (!result.allDone) {