jules-orchestrator-kit 0.52.8 → 0.53.0

package/src/ux/palette.mjs

@@ -1,179 +0,0 @@
-import { listCommandsByCategory } from "../ops/command-registry.mjs";
-import { clipText } from "./layout.mjs";
-import { getSymbols } from "./capabilities.mjs";
-
-/**
- * @typedef {import("../ops/command-registry.mjs").CommandDescriptor} CommandDescriptor
- * @typedef {import("../ops/command-registry.mjs").CommandCategory} CommandCategory
- * @typedef {import("./capabilities.mjs").TerminalCapabilities} TerminalCapabilities
- * @typedef {import("./renderer.mjs").RenderFrame} RenderFrame
- */
-
-/**
- * Create command palette state manager.
- * @param {Object} [opts]
- * @param {CommandCategory} [opts.initialCategory]
- */
-export function createPaletteState(opts = {}) {
-  let filter = "";
-  let category = opts.initialCategory || null;
-  let selectedIndex = 0;
-
-  function getFilteredCommands() {
-    let pool = listCommandsByCategory(category || undefined);
-    if (!filter || !filter.trim()) return pool;
-
-    const tokens = filter.trim().toLowerCase().split(/\s+/);
-    return pool.filter((cmd) => {
-      const text = `${cmd.id} ${cmd.title} ${cmd.description} ${cmd.category} ${cmd.shortcuts.join(" ")}`.toLowerCase();
-      return tokens.every((token) => text.includes(token));
-    });
-  }
-
-  function clampSelection() {
-    const list = getFilteredCommands();
-    if (list.length === 0) {
-      selectedIndex = 0;
-      return;
-    }
-    if (selectedIndex < 0) selectedIndex = 0;
-    if (selectedIndex >= list.length) selectedIndex = list.length - 1;
-  }
-
-  clampSelection();
-
-  return {
-    get filter() {
-      return filter;
-    },
-    set filter(val) {
-      filter = String(val);
-      selectedIndex = 0;
-      clampSelection();
-    },
-    get category() {
-      return category;
-    },
-    set category(val) {
-      category = val;
-      selectedIndex = 0;
-      clampSelection();
-    },
-    get selectedIndex() {
-      return selectedIndex;
-    },
-
-    move(delta) {
-      const list = getFilteredCommands();
-      if (list.length === 0) return;
-      selectedIndex += delta;
-      clampSelection();
-    },
-
-    nextCategory() {
-      const categories = [null, "Create", "Inspect", "Operate", "Repair", "Configure"];
-      const currentIdx = categories.indexOf(category);
-      const nextIdx = (currentIdx + 1) % categories.length;
-      this.category = categories[nextIdx];
-    },
-
-    getSelectedCommand() {
-      const list = getFilteredCommands();
-      return list[selectedIndex] || null;
-    },
-
-    getFilteredCommands,
-  };
-}
-
-/**
- * Render native command palette view frame.
- * @param {ReturnType<typeof createPaletteState>} state
- * @param {TerminalCapabilities} caps
- * @returns {RenderFrame}
- */
-export function renderPaletteView(state, caps) {
-  const width = caps.columns || 80;
-  const height = caps.rows || 24;
-  const symbols = getSymbols(caps);
-
-  const lines = [];
-
-  // Header line
-  const titleStr = " agentctl · Command Palette ";
-  lines.push({
-    runs: [{ text: clipText(titleStr, width), style: { fg: "cyan", bold: true, inverse: true } }],
-  });
-
-  // Filter input line
-  const promptStr = ` > ${state.filter}${symbols.bullet}`;
-  lines.push({
-    runs: [{ text: clipText(promptStr, width), style: { fg: "yellow" } }],
-  });
-
-  // Category tabs line
-  const categories = [
-    { label: "All", value: null },
-    { label: "Create", value: "Create" },
-    { label: "Inspect", value: "Inspect" },
-    { label: "Operate", value: "Operate" },
-    { label: "Repair", value: "Repair" },
-    { label: "Configure", value: "Configure" },
-  ];
-
-  const tabRuns = [];
-  for (const cat of categories) {
-    const isSelected = state.category === cat.value;
-    const label = `[${cat.label}] `;
-    if (isSelected) {
-      tabRuns.push({ text: label, style: { fg: "cyan", bold: true, underline: true } });
-    } else {
-      tabRuns.push({ text: label, style: { fg: "white", dim: true } });
-    }
-  }
-  lines.push({ runs: tabRuns });
-
-  // Command items body
-  const filtered = state.getFilteredCommands();
-  const maxBodyLines = height - 5;
-
-  if (filtered.length === 0) {
-    lines.push({
-      runs: [{ text: " No matching commands found.", style: { fg: "yellow", dim: true } }],
-    });
-  } else {
-    for (let i = 0; i < Math.min(filtered.length, maxBodyLines); i++) {
-      const cmd = filtered[i];
-      const isSelected = i === state.selectedIndex;
-
-      const pointer = isSelected ? `${symbols.select} ` : "  ";
-      const catBadge = `[${cmd.category.padEnd(9)}] `;
-      const cmdTitle = cmd.title.padEnd(16);
-      const desc = cmd.description;
-
-      const lineText = `${pointer}${catBadge}${cmdTitle} ${desc}`;
-      const style = isSelected ? { fg: "cyan", bold: true } : { fg: "default" };
-
-      lines.push({
-        runs: [{ text: clipText(lineText, width), style }],
-      });
-    }
-  }
-
-  // Pad remaining height
-  while (lines.length < height - 1) {
-    lines.push({ runs: [{ text: " ".repeat(width), style: { fg: "default" } }] });
-  }
-
-  // Footer status bar line
-  lines.push({
-    runs: [
-      {
-        text: clipText("Up/Down: move  Enter: select  Tab: category  Esc: quit", width),
-        style: { fg: "cyan", dim: true },
-      },
-    ],
-  });
-
-  return { width, height, lines };
-}

package/src/ux/queue-model.mjs

@@ -1,206 +0,0 @@
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { createHash } from "node:crypto";
-import { parseEnvelopeHeader } from "../envelope.mjs";
-import { isPidAlive } from "../state.mjs";
-
-/**
- * @typedef {"pending" | "dispatching" | "remote-queued" | "planning" | "awaiting-plan-approval" | "awaiting-user-feedback" | "running" | "output-ready" | "verifying" | "deferred" | "quarantined" | "failed" | "completed" | "cancelled"} TaskState
- *
- * @typedef {Object} QueueTaskSummary
- * @property {string} id
- * @property {string} title
- * @property {TaskState} state
- * @property {string} riskTier
- * @property {number} attempt
- * @property {number} maxAttempts
- * @property {string} createdAt
- * @property {string} updatedAt
- * @property {number} durationMs
- * @property {string} [source]
- * @property {string} [startingBranch]
- * @property {boolean} autoPr
- * @property {boolean} requirePlanApproval
- * @property {string} [verifyCmd]
- * @property {string} [slotId]
- * @property {number} [pid]
- * @property {string} [worktree]
- * @property {string} [errorSummary]
- * @property {string} envelopeHash
- * @property {string | null} stateHash
- * @property {number} stateRevision
- * @property {string} taskFile
- */
-
-function isQueueTaskFile(fileName, content = "") {
-  if (!fileName || fileName.toLowerCase() === "readme.md" || !fileName.toLowerCase().endsWith(".md")) {
-    return false;
-  }
-  if (/^task-.*\.md$/i.test(fileName)) return true;
-  return Boolean(parseEnvelopeHeader(content) || content.includes("# Task ID:"));
-}
-
-/**
- * @typedef {Object} QueueSnapshot
- * @property {"agentctl/queue-snapshot-v1"} schema
- * @property {string} repository
- * @property {string} generatedAt
- * @property {string} revision
- * @property {Record<TaskState, number>} counts
- * @property {QueueTaskSummary[]} tasks
- * @property {string[]} warnings
- */
-
-/**
- * Build immutable QueueSnapshot by reading canonical .agent/jules-queue/ tasks and sidecars.
- * @param {string} root
- * @param {Object} [options]
- * @param {boolean} [options.includeCompleted=true]
- * @param {number} [options.limit=100]
- * @returns {Promise<QueueSnapshot>}
- */
-export async function buildQueueSnapshot(root, options = {}) {
-  const repoRoot = resolve(root || process.cwd());
-  const queueDir = join(repoRoot, ".agent", "jules-queue");
-  const warnings = [];
-  const limit = Number.isFinite(options.limit) ? Math.max(0, Math.floor(options.limit)) : 100;
-  const includeCompleted = options.includeCompleted !== false;
-  /** @type {QueueTaskSummary[]} */
-  const tasks = [];
-
-  const counts = {
-    pending: 0,
-    dispatching: 0,
-    "remote-queued": 0,
-    planning: 0,
-    "awaiting-plan-approval": 0,
-    "awaiting-user-feedback": 0,
-    running: 0,
-    "output-ready": 0,
-    verifying: 0,
-    deferred: 0,
-    quarantined: 0,
-    failed: 0,
-    completed: 0,
-    cancelled: 0,
-  };
-
-  if (!existsSync(queueDir)) {
-    warnings.push("Canonical queue directory .agent/jules-queue does not exist.");
-  } else {
-    try {
-      const files = readdirSync(queueDir).filter((f) => f.toLowerCase().endsWith(".md"));
-      for (const file of files) {
-        const taskId = file.replace(/\.md$/, "");
-        const taskPath = join(queueDir, file);
-        const statePath = join(queueDir, `${taskId}.state.json`);
-
-        try {
-          const content = readFileSync(taskPath, "utf-8");
-          if (!isQueueTaskFile(file, content)) continue;
-          const envelope = parseEnvelopeHeader(content) || {};
-          const envelopeHash = "sha256:" + createHash("sha256").update(content).digest("hex");
-
-          let sidecar = {};
-          let stateHash = null;
-          if (existsSync(statePath)) {
-            try {
-              const stateContent = readFileSync(statePath, "utf-8");
-              stateHash = "sha256:" + createHash("sha256").update(stateContent).digest("hex");
-              sidecar = JSON.parse(stateContent);
-            } catch {
-              warnings.push(`Malformed sidecar file for task ${taskId}`);
-            }
-          }
-
-          const knownStates = new Set([
-            "pending", "dispatching", "remote-queued", "planning", "awaiting-plan-approval",
-            "awaiting-user-feedback", "running", "output-ready", "verifying", "deferred",
-            "quarantined", "failed", "completed", "cancelled",
-          ]);
-          let state = knownStates.has(sidecar.state) ? sidecar.state : "pending";
-          if (sidecar.state && state === "pending" && sidecar.state !== "pending") {
-            warnings.push(`Unknown state '${sidecar.state}' for task ${taskId}; treating it as pending`);
-          }
-          if ((state === "running" || state === "verifying") && sidecar.pid !== undefined && !isPidAlive(sidecar.pid)) {
-            state = "failed";
-            warnings.push(`Task ${taskId} references dead PID ${sidecar.pid}; treating it as failed`);
-          }
-          counts[state] = (counts[state] || 0) + 1;
-
-          if (!includeCompleted && (state === "completed" || state === "cancelled")) {
-            continue;
-          }
-
-          tasks.push({
-            id: taskId,
-            title: envelope.title || taskId,
-            state,
-            riskTier: envelope.riskTier || "R1",
-            attempt: sidecar.attempt ?? 0,
-            maxAttempts: sidecar.maxAttempts ?? envelope.maxAttempts ?? 3,
-            createdAt: sidecar.createdAt || envelope.createdAt || new Date().toISOString(),
-            updatedAt: sidecar.updatedAt || new Date().toISOString(),
-            durationMs: sidecar.durationMs ?? 0,
-            source: envelope.source,
-            startingBranch: envelope.startingBranch,
-            autoPr: Boolean(envelope.autoPr),
-            requirePlanApproval: Boolean(envelope.requirePlanApproval),
-            verifyCmd: envelope.verifyCmd,
-            slotId: sidecar.slotId,
-            pid: sidecar.pid,
-            worktree: sidecar.worktree,
-            errorSummary: sidecar.errorSummary,
-            envelopeHash,
-            stateHash,
-            stateRevision: sidecar.revision ?? 1,
-            taskFile: `.agent/jules-queue/${file}`,
-          });
-        } catch (err) {
-          warnings.push(`Failed to read task ${taskId}: ${err.message}`);
-        }
-      }
-    } catch (err) {
-      warnings.push(`Failed to list queue directory: ${err.message}`);
-    }
-  }
-
-  // Sort tasks by updatedAt descending
-  tasks.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
-
-  const generatedAt = new Date().toISOString();
-  const revisionPayload = JSON.stringify({ repository: repoRoot, generatedAt, counts, taskCount: tasks.length });
-  const revision = "sha256:" + createHash("sha256").update(revisionPayload).digest("hex");
-
-  return {
-    schema: "agentctl/queue-snapshot-v1",
-    repository: repoRoot,
-    generatedAt,
-    revision,
-    counts,
-    tasks: tasks.slice(0, limit),
-    warnings,
-  };
-}
-
-/**
- * Queue state reducer for updating view navigation state.
- * @param {Record<string, any>} state
- * @param {import("../key-decoder.mjs").KeyEvent | { type: string, payload?: any }} event
- * @returns {Record<string, any>}
- */
-export function reduceQueueState(state, event) {
-  const nextState = { ...state };
-  if (!event) return nextState;
-
-  if (typeof event === "object" && "type" in event) {
-    if (event.type === "SET_FILTER") {
-      nextState.filter = String(event.payload || "");
-      nextState.selectedIndex = 0;
-    } else if (event.type === "SELECT_TASK") {
-      nextState.selectedTaskId = String(event.payload || "");
-    }
-  }
-
-  return nextState;
-}

package/src/ux/renderer.mjs

@@ -1,188 +0,0 @@
-import { getStringWidth, clipText, stripAnsi } from "./layout.mjs";
-
-/**
- * @typedef {Object} TextStyle
- * @property {"default" | "red" | "green" | "yellow" | "blue" | "cyan" | "white"} [fg]
- * @property {"default" | "blue" | "cyan" | "bgRed" | "bgGreen"} [bg]
- * @property {boolean} [bold]
- * @property {boolean} [dim]
- * @property {boolean} [underline]
- * @property {boolean} [inverse]
- */
-
-/**
- * @typedef {Object} CellRun
- * @property {string} text
- * @property {TextStyle} style
- */
-
-/**
- * @typedef {Object} ScreenLine
- * @property {CellRun[]} runs
- * @property {string} [key]
- */
-
-/**
- * @typedef {Object} RenderFrame
- * @property {number} width
- * @property {number} height
- * @property {ScreenLine[]} lines
- * @property {{ row: number, column: number, visible: boolean }} [cursor]
- * @property {string} [title]
- */
-
-const FG_CODES = {
-  red: 31,
-  green: 32,
-  yellow: 33,
-  blue: 34,
-  cyan: 36,
-  white: 37,
-};
-
-const BG_CODES = {
-  blue: 44,
-  cyan: 46,
-  bgRed: 41,
-  bgGreen: 42,
-};
-
-/**
- * Strip or sanitize untrusted control characters and ANSI escape sequences.
- * @param {string} text
- * @returns {string}
- */
-export function sanitizeControlChars(text) {
-  if (text === null || text === undefined) return "";
-  // Strip CSI, OSC, and single-byte ANSI sequences before removing controls.
-  return stripAnsi(text).replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/g, "");
-}
-
-/**
- * Encode style to ANSI escape code sequence.
- * @param {TextStyle} [style]
- * @returns {string}
- */
-export function encodeAnsiStyle(style) {
-  if (!style) return "";
-  const codes = [];
-
-  if (style.bold) codes.push(1);
-  if (style.dim) codes.push(2);
-  if (style.underline) codes.push(4);
-  if (style.inverse) codes.push(7);
-
-  if (style.fg && FG_CODES[style.fg]) {
-    codes.push(FG_CODES[style.fg]);
-  }
-  if (style.bg && BG_CODES[style.bg]) {
-    codes.push(BG_CODES[style.bg]);
-  }
-
-  if (codes.length === 0) return "";
-  return `\u001b[${codes.join(";")}m`;
-}
-
-/**
- * Format cell runs into line string with ANSI styling applied.
- * @param {ScreenLine} line
- * @param {number} maxWidth
- * @param {import("./capabilities.mjs").TerminalCapabilities} capabilities
- * @returns {string}
- */
-export function renderLineToAnsi(line, maxWidth, capabilities) {
-  let lineText = "";
-  let currentWidth = 0;
-
-  for (const run of line.runs || []) {
-    if (currentWidth >= maxWidth) break;
-    const cleanText = sanitizeControlChars(run.text);
-    const runWidth = getStringWidth(cleanText);
-
-    let textToDraw = cleanText;
-    if (currentWidth + runWidth > maxWidth) {
-      textToDraw = clipText(cleanText, maxWidth - currentWidth, "");
-    }
-
-    const runDrawWidth = getStringWidth(textToDraw);
-    currentWidth += runDrawWidth;
-
-    if (capabilities.ansi && run.style) {
-      const styleAnsi = encodeAnsiStyle(run.style);
-      if (styleAnsi) {
-        lineText += `${styleAnsi}${textToDraw}\u001b[0m`;
-      } else {
-        lineText += textToDraw;
-      }
-    } else {
-      lineText += textToDraw;
-    }
-  }
-
-  // Pad remaining line width with spaces
-  if (currentWidth < maxWidth) {
-    lineText += " ".repeat(maxWidth - currentWidth);
-  }
-
-  return lineText;
-}
-
-/**
- * Render complete frame into ANSI string buffer.
- * @param {RenderFrame} frame
- * @param {import("./capabilities.mjs").TerminalCapabilities} capabilities
- * @returns {string}
- */
-export function renderFrameToAnsi(frame, capabilities) {
-  if (!capabilities.ansi) {
-    return renderFrameToString(frame);
-  }
-
-  let output = capabilities.alternateScreen ? "\u001b[H" : "\u001b[1;1H";
-
-  const renderLines = frame.lines.slice(0, frame.height);
-  for (let i = 0; i < frame.height; i++) {
-    const line = renderLines[i] || { runs: [] };
-    const lineAnsi = renderLineToAnsi(line, frame.width, capabilities);
-    output += lineAnsi;
-    if (i < frame.height - 1) {
-      output += "\n";
-    }
-  }
-
-  if (frame.cursor && frame.cursor.visible) {
-    const row = Math.min(frame.height, Math.max(1, frame.cursor.row));
-    const col = Math.min(frame.width, Math.max(1, frame.cursor.column));
-    output += `\u001b[${row};${col}H\u001b[?25h`;
-  } else {
-    output += "\u001b[?25l";
-  }
-
-  return output;
-}
-
-/**
- * Render frame into plain string lines for non-TTY or testing assertions.
- * @param {RenderFrame} frame
- * @returns {string}
- */
-export function renderFrameToString(frame) {
-  const lines = [];
-  for (let i = 0; i < frame.height; i++) {
-    const line = frame.lines[i] || { runs: [] };
-    let lineStr = "";
-    let width = 0;
-    for (const run of line.runs || []) {
-      const clean = sanitizeControlChars(run.text);
-      lineStr += clean;
-      width += getStringWidth(clean);
-    }
-    if (width < frame.width) {
-      lineStr += " ".repeat(frame.width - width);
-    } else if (width > frame.width) {
-      lineStr = clipText(lineStr, frame.width, "");
-    }
-    lines.push(lineStr);
-  }
-  return lines.join("\n");
-}