jules-orchestrator-kit 0.52.8 → 0.53.0

package/src/ux/diff-viewer.mjs

@@ -1,289 +0,0 @@
-import { sanitizeControlChars } from "./renderer.mjs";
-import { clipText } from "./layout.mjs";
-
-/**
- * @typedef {Object} DiffLine
- * @property {"context" | "add" | "delete" | "header" | "no-newline"} kind
- * @property {number} [oldLine]
- * @property {number} [newLine]
- * @property {string} text
- */
-
-/**
- * @typedef {Object} DiffHunk
- * @property {string} header
- * @property {number} oldStart
- * @property {number} oldCount
- * @property {number} newStart
- * @property {number} newCount
- * @property {DiffLine[]} lines
- */
-
-/**
- * @typedef {Object} DiffFile
- * @property {string} oldPath
- * @property {string} newPath
- * @property {"added" | "modified" | "deleted" | "renamed" | "binary"} status
- * @property {DiffHunk[]} hunks
- * @property {number} additions
- * @property {number} deletions
- */
-
-/**
- * @typedef {Object} DiffDocument
- * @property {DiffFile[]} files
- * @property {boolean} truncated
- * @property {number} totalBytes
- */
-
-/**
- * Parse unified diff text into structured DiffDocument.
- * @param {string} text
- * @param {Object} [options]
- * @param {number} [options.maxBytes=1000000]
- * @param {number} [options.maxFiles=100]
- * @param {number} [options.maxLines=5000]
- * @returns {DiffDocument}
- */
-export function parseUnifiedDiff(text, options = {}) {
-  const maxBytes = options.maxBytes ?? 1_000_000;
-  const maxFiles = options.maxFiles ?? 100;
-  const maxLines = options.maxLines ?? 5000;
-
-  let truncated = false;
-  text = typeof text === "string" ? text : String(text || "");
-  const totalBytes = Buffer.byteLength(text, "utf-8");
-  const byteLimit = Number.isFinite(maxBytes) ? Math.max(0, Math.floor(maxBytes)) : 1_000_000;
-
-  if (totalBytes > byteLimit) {
-    text = Buffer.from(text, "utf-8").subarray(0, byteLimit).toString("utf-8");
-    truncated = true;
-  }
-
-  const rawLines = text.split(/\r?\n/);
-  const files = [];
-
-  let currentFile = null;
-  let currentHunk = null;
-  let oldLineNum = 0;
-  let newLineNum = 0;
-  let lineCount = 0;
-
-  for (let rawIndex = 0; rawIndex < rawLines.length; rawIndex++) {
-    const rawLine = rawLines[rawIndex];
-    if (lineCount >= maxLines) {
-      truncated = true;
-      break;
-    }
-    lineCount++;
-
-    const line = sanitizeControlChars(rawLine);
-    if (line === "" && rawLine === "" && rawIndex === rawLines.length - 1) {
-      continue;
-    }
-
-    if (line.startsWith("diff --git ")) {
-      if (files.length >= maxFiles) {
-        truncated = true;
-        break;
-      }
-      const parts = line.split(" ");
-      const oldPath = parts[2] ? parts[2].replace(/^a\//, "") : "";
-      const newPath = parts[3] ? parts[3].replace(/^b\//, "") : "";
-
-      currentFile = {
-        oldPath,
-        newPath,
-        status: "modified",
-        hunks: [],
-        additions: 0,
-        deletions: 0,
-      };
-      files.push(currentFile);
-      currentHunk = null;
-      continue;
-    }
-
-    if (!currentFile && (line.startsWith("--- ") || line.startsWith("+++ "))) {
-      currentFile = {
-        oldPath: "",
-        newPath: "",
-        status: "modified",
-        hunks: [],
-        additions: 0,
-        deletions: 0,
-      };
-      files.push(currentFile);
-    }
-    if (!currentFile) continue;
-
-    if (!currentHunk && line.startsWith("--- ")) {
-      currentFile.oldPath = line.slice(4).replace(/^a\//, "");
-      continue;
-    }
-    if (!currentHunk && line.startsWith("+++ ")) {
-      currentFile.newPath = line.slice(4).replace(/^b\//, "");
-      continue;
-    }
-
-    if (line.startsWith("new file mode ")) {
-      currentFile.status = "added";
-      continue;
-    }
-    if (line.startsWith("deleted file mode ")) {
-      currentFile.status = "deleted";
-      continue;
-    }
-    if (line.startsWith("similarity index ") || line.startsWith("rename from ") || line.startsWith("rename to ")) {
-      currentFile.status = "renamed";
-      if (line.startsWith("rename from ")) currentFile.oldPath = line.slice("rename from ".length);
-      if (line.startsWith("rename to ")) currentFile.newPath = line.slice("rename to ".length);
-      continue;
-    }
-    if (line.startsWith("Binary files ")) {
-      currentFile.status = "binary";
-      continue;
-    }
-
-    // Hunk header: @@ -oldStart,oldCount +newStart,newCount @@
-    const hunkMatch = line.match(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/);
-    if (hunkMatch) {
-      oldLineNum = parseInt(hunkMatch[1], 10);
-      const oldCount = hunkMatch[2] !== undefined ? parseInt(hunkMatch[2], 10) : 1;
-      newLineNum = parseInt(hunkMatch[3], 10);
-      const newCount = hunkMatch[4] !== undefined ? parseInt(hunkMatch[4], 10) : 1;
-
-      currentHunk = {
-        header: line,
-        oldStart: oldLineNum,
-        oldCount,
-        newStart: newLineNum,
-        newCount,
-        lines: [],
-      };
-      currentFile.hunks.push(currentHunk);
-      continue;
-    }
-
-    if (!currentHunk) continue;
-
-    if (line.startsWith("+")) {
-      currentFile.additions++;
-      currentHunk.lines.push({
-        kind: "add",
-        newLine: newLineNum++,
-        text: line.slice(1),
-      });
-    } else if (line.startsWith("-")) {
-      currentFile.deletions++;
-      currentHunk.lines.push({
-        kind: "delete",
-        oldLine: oldLineNum++,
-        text: line.slice(1),
-      });
-    } else if (line.startsWith("\\ No newline")) {
-      currentHunk.lines.push({
-        kind: "no-newline",
-        text: line,
-      });
-    } else {
-      currentHunk.lines.push({
-        kind: "context",
-        oldLine: oldLineNum++,
-        newLine: newLineNum++,
-        text: line.startsWith(" ") ? line.slice(1) : line,
-      });
-    }
-  }
-
-  return { files, truncated, totalBytes };
-}
-
-/**
- * Render unified diff view frame.
- * @param {DiffDocument} document
- * @param {Record<string, any>} state
- * @param {import("./capabilities.mjs").TerminalCapabilities} caps
- * @returns {import("./renderer.mjs").RenderFrame}
- */
-export function renderDiffView(document, state, caps) {
-  const width = caps.columns || 80;
-  const height = caps.rows || 24;
-
-  const fileIdx = Math.max(0, Math.min((document.files.length || 1) - 1, state.fileIdx || 0));
-  const currentFile = document.files[fileIdx];
-
-  const lines = [];
-
-  // Header line
-  const title = ` Diff · File [${fileIdx + 1}/${document.files.length || 0}] ${currentFile ? currentFile.newPath || currentFile.oldPath : ""} `;
-  lines.push({
-    runs: [
-      { text: clipText(title, width), style: { fg: "cyan", bold: true, inverse: true } },
-    ],
-  });
-
-  if (!currentFile) {
-    lines.push({ runs: [{ text: "No files changed.", style: { dim: true } }] });
-    return { width, height, lines };
-  }
-
-  // File summary line
-  const metaStr = ` Status: ${currentFile.status.toUpperCase()}  +${currentFile.additions} -${currentFile.deletions} `;
-  lines.push({ runs: [{ text: metaStr, style: { fg: "yellow" } }] });
-
-  let lineOffset = state.lineOffset || 0;
-  let renderCount = 0;
-  const maxBodyLines = height - 3;
-
-  for (const hunk of currentFile.hunks) {
-    if (renderCount >= maxBodyLines) break;
-
-    // Hunk header line
-    lines.push({
-      runs: [{ text: clipText(hunk.header, width), style: { fg: "cyan", dim: true } }],
-    });
-    renderCount++;
-
-    for (const line of hunk.lines) {
-      if (renderCount >= maxBodyLines) break;
-
-      if (lineOffset > 0) {
-        lineOffset--;
-        continue;
-      }
-
-      const oldNumStr = line.oldLine !== undefined ? String(line.oldLine).padStart(5) : "     ";
-      const newNumStr = line.newLine !== undefined ? String(line.newLine).padStart(5) : "     ";
-      const numCol = `${oldNumStr} | ${newNumStr} | `;
-
-      /** @type {import("./renderer.mjs").TextStyle} */
-      let style = { fg: "default" };
-      let prefix = " ";
-
-      if (line.kind === "add") {
-        style = { fg: "green" };
-        prefix = "+";
-      } else if (line.kind === "delete") {
-        style = { fg: "red" };
-        prefix = "-";
-      }
-
-      const lineText = clipText(`${numCol}${prefix}${line.text}`, width);
-      lines.push({ runs: [{ text: lineText, style }] });
-      renderCount++;
-    }
-  }
-
-  // Footer keybindings line
-  lines.push({
-    runs: [
-      {
-        text: clipText("[/]: switch file  n/N: hunk  Up/Down: scroll  q: exit", width),
-        style: { fg: "cyan", dim: true },
-      },
-    ],
-  });
-
-  return { width, height, lines };
-}

package/src/ux/layout.mjs

@@ -1,195 +0,0 @@
-const ANSI_ESCAPE_REGEX = /(?:\u001b\][\s\S]*?(?:\u0007|\u001b\\)|\u001b\[[0-?]*[ -/]*[@-~]|\u001b[@-Z\\-_]|\u009b[0-?]*[ -/]*[@-~])/g;
-
-/**
- * Remove terminal control sequences before measuring or rendering text.
- * @param {string} value
- * @returns {string}
- */
-export function stripAnsi(value) {
-  if (value === null || value === undefined) return "";
-  return String(value).replace(ANSI_ESCAPE_REGEX, "").replace(/\u001b\][\s\S]*$/g, "");
-}
-
-function isCombining(code) {
-  return (
-    (code >= 0x0300 && code <= 0x036f) ||
-    (code >= 0x1ab0 && code <= 0x1aff) ||
-    (code >= 0x1dc0 && code <= 0x1dff) ||
-    (code >= 0x20d0 && code <= 0x20ff) ||
-    (code >= 0xfe00 && code <= 0xfe0f) ||
-    (code >= 0xe0100 && code <= 0xe01ef) ||
-    (code >= 0x1f3fb && code <= 0x1f3ff) ||
-    code === 0x200d
-  );
-}
-
-function isEmoji(code) {
-  return (
-    (code >= 0x1f000 && code <= 0x1faff) ||
-    (code >= 0x2600 && code <= 0x27ff)
-  );
-}
-
-function graphemeClusters(value) {
-  if (typeof Intl?.Segmenter === "function") {
-    const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-    return Array.from(segmenter.segment(value), ({ segment }) => segment);
-  }
-  return Array.from(value);
-}
-
-/**
- * Calculate display width of string without external dependencies.
- * Handles wide characters, emoji ranges, and combining characters.
- * @param {string} str
- * @returns {number}
- */
-export function getStringWidth(str) {
-  const plain = stripAnsi(str);
-  if (!plain) return 0;
-
-  let width = 0;
-  let joinNext = false;
-  let regionalIndicators = 0;
-  for (const char of plain) {
-    const code = char.codePointAt(0) || 0;
-
-    if (isCombining(code)) {
-      if (code === 0x200d) joinNext = true;
-      continue;
-    }
-    if (code < 32 || (code >= 0x7f && code <= 0x9f)) {
-      continue;
-    }
-
-    if (code >= 0x1f1e6 && code <= 0x1f1ff) {
-      if (regionalIndicators % 2 === 0) width += 2;
-      regionalIndicators++;
-      continue;
-    }
-    regionalIndicators = 0;
-
-    if (joinNext) {
-      joinNext = false;
-      continue;
-    }
-
-    if (
-      (code >= 0x1100 && code <= 0x115f) ||
-      (code >= 0x2e80 && code <= 0xa4cf) ||
-      (code >= 0xac00 && code <= 0xd7a3) ||
-      (code >= 0xf900 && code <= 0xfaff) ||
-      (code >= 0xfe10 && code <= 0xfe19) ||
-      (code >= 0xfe30 && code <= 0xfe6f) ||
-      (code >= 0xff00 && code <= 0xff60) ||
-      (code >= 0xffe0 && code <= 0xffe6) ||
-      isEmoji(code)
-    ) {
-      width += 2;
-    } else {
-      width += 1;
-    }
-  }
-  return width;
-}
-
-/**
- * Truncate or clip text to fit maximum display width.
- * @param {string} text
- * @param {number} maxWidth
- * @param {string} [ellipsis="…"]
- * @returns {string}
- */
-export function clipText(text, maxWidth, ellipsis = "…") {
-  const widthLimit = Number.isFinite(maxWidth) ? Math.max(0, Math.floor(maxWidth)) : 0;
-  if (widthLimit === 0) return "";
-
-  const plain = stripAnsi(text);
-  if (getStringWidth(plain) <= widthLimit) return plain;
-
-  const cleanEllipsis = stripAnsi(ellipsis);
-  const ellipsisWidth = getStringWidth(cleanEllipsis);
-  if (ellipsisWidth >= widthLimit) {
-    let fitted = "";
-    for (const cluster of graphemeClusters(cleanEllipsis)) {
-      if (getStringWidth(fitted + cluster) > widthLimit) break;
-      fitted += cluster;
-    }
-    return fitted;
-  }
-
-  const targetWidth = widthLimit - ellipsisWidth;
-  let truncated = "";
-  let accumulatedWidth = 0;
-  for (const cluster of graphemeClusters(plain)) {
-    const clusterWidth = getStringWidth(cluster);
-    if (accumulatedWidth + clusterWidth > targetWidth) break;
-    accumulatedWidth += clusterWidth;
-    truncated += cluster;
-  }
-  return truncated + cleanEllipsis;
-}
-
-/**
- * Pad text to a fixed display width.
- * @param {string} text
- * @param {number} width
- * @param {"left" | "right" | "center"} [align="left"]
- * @returns {string}
- */
-export function padText(text, width, align = "left") {
-  const textWidth = getStringWidth(text);
-  if (textWidth >= width) return clipText(text, width);
-
-  const missing = width - textWidth;
-  if (align === "right") {
-    return " ".repeat(missing) + text;
-  }
-  if (align === "center") {
-    const leftPad = Math.floor(missing / 2);
-    const rightPad = missing - leftPad;
-    return " ".repeat(leftPad) + text + " ".repeat(rightPad);
-  }
-  return text + " ".repeat(missing);
-}
-
-/**
- * Compute responsive layout panes based on terminal dimensions.
- * @param {number} width
- * @param {number} height
- */
-export function computeResponsiveLayout(width, height) {
-  const headerHeight = Math.min(4, Math.max(2, Math.floor(height * 0.1)));
-  const footerHeight = 2;
-  const bodyHeight = Math.max(4, height - headerHeight - footerHeight);
-
-  /** @type {"single" | "tabs" | "split-55" | "split-50"} */
-  let layoutMode = "single";
-  let mainWidth = width;
-  let detailWidth = 0;
-
-  if (width >= 140) {
-    layoutMode = "split-50";
-    mainWidth = Math.floor(width * 0.5);
-    detailWidth = width - mainWidth - 1;
-  } else if (width >= 100) {
-    layoutMode = "split-55";
-    mainWidth = Math.floor(width * 0.55);
-    detailWidth = width - mainWidth - 1;
-  } else if (width >= 60) {
-    layoutMode = "tabs";
-  } else {
-    layoutMode = "single";
-  }
-
-  return {
-    width,
-    height,
-    headerHeight,
-    footerHeight,
-    bodyHeight,
-    layoutMode,
-    mainWidth,
-    detailWidth,
-  };
-}

package/src/ux/log-viewer.mjs

@@ -1,110 +0,0 @@
-import { sanitizeControlChars } from "./renderer.mjs";
-import { clipText } from "./layout.mjs";
-
-/**
- * @typedef {Object} LogLine
- * @property {number} number
- * @property {string} [timestamp]
- * @property {"stdout" | "stderr" | "system"} [stream]
- * @property {"debug" | "info" | "warn" | "error"} [level]
- * @property {string} text
- */
-
-/**
- * @typedef {Object} LogDocument
- * @property {LogLine[]} lines
- * @property {string} source
- * @property {number} truncatedBefore
- * @property {number} truncatedAfter
- * @property {boolean} followable
- */
-
-/**
- * Render bounded log viewer frame.
- * @param {LogDocument} document
- * @param {Record<string, any>} state
- * @param {import("./capabilities.mjs").TerminalCapabilities} caps
- * @returns {import("./renderer.mjs").RenderFrame}
- */
-export function renderLogView(document, state, caps) {
-  const width = caps.columns || 80;
-  const height = caps.rows || 24;
-
-  const rawLines = document.lines || [];
-  const filter = (state.filter || "").toLowerCase();
-  const errorsOnly = Boolean(state.errorsOnly);
-  const follow = Boolean(state.follow);
-
-  // Filter lines
-  const filtered = rawLines.filter((l) => {
-    if (errorsOnly && l.level !== "error" && l.stream !== "stderr") {
-      return false;
-    }
-    if (filter) {
-      const clean = (l.text || "").toLowerCase();
-      if (!clean.includes(filter)) return false;
-    }
-    return true;
-  });
-
-  const maxBodyLines = Math.max(2, height - 3);
-  let offset = state.offset || 0;
-
-  if (follow) {
-    offset = Math.max(0, filtered.length - maxBodyLines);
-  } else {
-    offset = Math.max(0, Math.min(filtered.length - 1, offset));
-  }
-
-  const lines = [];
-
-  // Header line
-  const headerStr = ` Log Viewer · ${document.source || "Output"} · Showing ${filtered.length} lines ${errorsOnly ? "(Errors Only)" : ""} `;
-  lines.push({
-    runs: [{ text: clipText(headerStr, width), style: { fg: "cyan", bold: true, inverse: true } }],
-  });
-
-  // Status sub-header line
-  const subHeader = ` Filter: ${filter || "none"}  Follow: ${follow ? "ON" : "OFF"}  Showing ${offset + 1}-${Math.min(filtered.length, offset + maxBodyLines)} of ${filtered.length} `;
-  lines.push({
-    runs: [{ text: clipText(subHeader, width), style: { fg: "yellow", dim: true } }],
-  });
-
-  // Body lines
-  const slice = filtered.slice(offset, offset + maxBodyLines);
-  for (const item of slice) {
-    const numStr = String(item.number).padStart(5);
-    const streamStr = item.stream ? item.stream.padStart(6) : "      ";
-    const cleanText = sanitizeControlChars(item.text);
-
-    /** @type {import("./renderer.mjs").TextStyle} */
-    let style = { fg: "default" };
-    if (item.level === "error" || item.stream === "stderr") {
-      style = { fg: "red" };
-    } else if (item.level === "warn") {
-      style = { fg: "yellow" };
-    } else if (item.stream === "system") {
-      style = { fg: "cyan", dim: true };
-    }
-
-    const lineText = clipText(`${numStr} | ${streamStr} | ${cleanText}`, width);
-    lines.push({ runs: [{ text: lineText, style }] });
-  }
-
-  // Pad remaining height
-  while (lines.length < height - 1) {
-    lines.push({ runs: [{ text: " ".repeat(width), style: { fg: "default" } }] });
-  }
-
-  // Footer status bar
-  lines.push({
-    runs: [
-      {
-        text: clipText("Up/Down: scroll  PgUp/PgDn  / search  e: errors only  f: follow  q: back", width),
-        style: { fg: "cyan", dim: true },
-      },
-    ],
-  });
-
-  return { width, height, lines };
-}