ralphctl 0.7.2 → 0.7.3

package/dist/cli.mjs

@@ -4,7 +4,7 @@
 import { Command } from "commander";
 
 // src/application/ui/tui/launch.ts
-import React65 from "react";
+import React66 from "react";
 
 // src/application/bootstrap/storage-paths.ts
 import { promises as fs } from "fs";
@@ -4360,7 +4360,7 @@ var createNpmVersionChecker = (deps) => {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.7.2",
+  version: "0.7.3",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code & GitHub Copilot across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -5219,7 +5219,7 @@ var getRunInTerminal = () => (fn) => ref.current(fn);
 
 // src/application/ui/tui/App.tsx
 import "react";
-import { Box as Box49 } from "ink";
+import { Box as Box50 } from "ink";
 
 // src/application/ui/tui/runtime/deps-context.tsx
 import { createContext, useContext } from "react";
@@ -6497,10 +6497,17 @@ var spinnerGlyph = (frame) => glyphs.spinner[frame % glyphs.spinner.length] ?? "
 
 // src/application/ui/tui/components/spinner.tsx
 import { jsxs as jsxs6 } from "react/jsx-runtime";
-var Spinner = ({ label, color = inkColors.info }) => {
-  const frame = useSpinnerFrame();
+var Spinner = ({ label, color = inkColors.info, active = true, dim }) => {
+  const frame = useSpinnerFrame(active);
+  const glyph = spinnerGlyph(frame);
+  if (dim === true) {
+    return /* @__PURE__ */ jsxs6(Text7, { dimColor: true, children: [
+      glyph,
+      label !== void 0 && label.length > 0 ? ` ${label}` : ""
+    ] });
+  }
   return /* @__PURE__ */ jsxs6(Text7, { color, children: [
-    spinnerGlyph(frame),
+    glyph,
     label !== void 0 && label.length > 0 ? ` ${label}` : ""
   ] });
 };
@@ -17819,20 +17826,20 @@ import { Box as Box34, Text as Text36, useInput as useInput15 } from "ink";
 import { useMemo as useMemo10 } from "react";
 import { Box as Box30, Text as Text32 } from "ink";
 import { jsx as jsx42, jsxs as jsxs31 } from "react/jsx-runtime";
-var glyphFor = (status, frame) => {
+var glyphFor = (status) => {
   switch (status) {
     case "completed":
-      return [glyphs.phaseDone, inkColors.success];
+      return { kind: "static", glyph: glyphs.phaseDone, color: inkColors.success };
     case "failed":
-      return [glyphs.cross, inkColors.error];
+      return { kind: "static", glyph: glyphs.cross, color: inkColors.error };
     case "aborted":
-      return [glyphs.warningGlyph, inkColors.warning];
+      return { kind: "static", glyph: glyphs.warningGlyph, color: inkColors.warning };
     case "skipped":
-      return [glyphs.phaseDisabled, inkColors.muted];
+      return { kind: "static", glyph: glyphs.phaseDisabled, color: inkColors.muted };
     case "running":
-      return [spinnerGlyph(frame), inkColors.info];
+      return { kind: "spinner", color: inkColors.info };
     case "pending":
-      return [glyphs.phasePending, inkColors.muted];
+      return { kind: "static", glyph: glyphs.phasePending, color: inkColors.muted };
   }
 };
 var trailingLabelFor = (status) => {
@@ -17882,7 +17889,6 @@ var StepTrace = ({
   inFlightLabel,
   plan
 }) => {
-  const frame = useSpinnerFrame(running);
   const traceLastEntry = trace[trace.length - 1];
   const merged = useMemo10(
     () => plan !== void 0 ? mergePlanWithTrace(plan, trace, running) : traceToRows(trace),
@@ -17896,11 +17902,11 @@ var StepTrace = ({
   const rows = runningIdx >= 0 ? filtered.slice(Math.max(0, runningIdx - Math.floor(maxRows / 2))).slice(0, maxRows) : filtered.slice(-maxRows);
   return /* @__PURE__ */ jsxs31(Box30, { flexDirection: "column", children: [
     rows.map((row, i) => {
-      const [g, color] = glyphFor(row.status, frame);
+      const instruction = glyphFor(row.status);
       const trailing = trailingLabelFor(row.status);
       const dimRow = row.status === "pending";
       return /* @__PURE__ */ jsxs31(Box30, { paddingX: spacing.indent, children: [
-        /* @__PURE__ */ jsx42(Text32, { color, bold: true, children: g }),
+        instruction.kind === "spinner" ? /* @__PURE__ */ jsx42(Spinner, { active: running, color: instruction.color }) : /* @__PURE__ */ jsx42(Text32, { color: instruction.color, bold: true, children: instruction.glyph }),
         /* @__PURE__ */ jsxs31(Text32, { dimColor: dimRow, children: [
           " ",
           row.name
@@ -17911,7 +17917,7 @@ var StepTrace = ({
           " ",
           fmtDuration(row.durationMs)
         ] }),
-        trailing !== void 0 && /* @__PURE__ */ jsxs31(Text32, { color, children: [
+        trailing !== void 0 && /* @__PURE__ */ jsxs31(Text32, { color: instruction.color, children: [
           "  ",
           glyphs.emDash,
           " ",
@@ -17926,7 +17932,7 @@ var StepTrace = ({
       ] }, `${row.name}-${String(i)}`);
     }),
     plan === void 0 && running && inFlightLabel !== void 0 && /* @__PURE__ */ jsxs31(Box30, { paddingX: spacing.indent, children: [
-      /* @__PURE__ */ jsx42(Text32, { color: inkColors.info, bold: true, children: spinnerGlyph(frame) }),
+      /* @__PURE__ */ jsx42(Spinner, { active: running, color: inkColors.info }),
       /* @__PURE__ */ jsxs31(Text32, { dimColor: true, children: [
         " ",
         inFlightLabel
@@ -18062,14 +18068,9 @@ var EvaluationLine = ({ evaluation }) => {
     evaluation.dimensions.length > 0 && /* @__PURE__ */ jsx43(Box31, { paddingLeft: 6, children: /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: evaluation.dimensions.map((d) => `${d.dimension}: ${String(d.score)}/5 ${d.passed ? glyphs.check : glyphs.cross}`).join(`  ${glyphs.bullet}  `) }) })
   ] });
 };
-var SubStepLine = ({
-  sub,
-  running,
-  spinner
-}) => {
+var SubStepLine = ({ sub, running }) => {
   const presentation = SUB_STEP_PRESENTATION[sub.status];
   const glyph = running && sub.status === "completed" ? presentation.glyph : presentation.glyph;
-  void spinner;
   return /* @__PURE__ */ jsxs32(Box31, { children: [
     /* @__PURE__ */ jsxs32(Text33, { color: presentation.color, bold: true, children: [
       glyphs.activityArrow,
@@ -18098,15 +18099,20 @@ var TaskBlock = ({
   task,
   running,
   display,
-  maxSignals
+  maxSignals,
+  maxSubSteps,
+  maxEvaluations
 }) => {
   const presentation = STATUS_PRESENTATION[task.status];
-  const frame = useSpinnerFrame(running && task.status === "running");
-  const glyph = task.status === "running" ? spinnerGlyph(frame) : presentation.glyph;
+  const isSpinning = task.status === "running";
   const signalRows = task.signals.slice(-maxSignals);
+  const subStepRows = task.subSteps.slice(-maxSubSteps);
+  const subStepElided = task.subSteps.length - subStepRows.length;
+  const evalRows = task.evaluations.slice(-maxEvaluations);
+  const evalElided = task.evaluations.length - evalRows.length;
   return /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", marginBottom: spacing.section, children: [
     /* @__PURE__ */ jsxs32(Box31, { children: [
-      /* @__PURE__ */ jsx43(Text33, { color: presentation.color, bold: true, children: glyph }),
+      isSpinning ? /* @__PURE__ */ jsx43(Spinner, { active: running, color: presentation.color }) : /* @__PURE__ */ jsx43(Text33, { color: presentation.color, bold: true, children: presentation.glyph }),
       /* @__PURE__ */ jsxs32(Text33, { bold: true, children: [
         " ",
         display
@@ -18132,8 +18138,14 @@ var TaskBlock = ({
       ] })
     ] }),
     task.errorMessage !== void 0 && /* @__PURE__ */ jsx43(Box31, { paddingLeft: 2, children: /* @__PURE__ */ jsx43(Text33, { color: inkColors.error, children: task.errorMessage }) }),
-    task.subSteps.length > 0 && /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, children: task.subSteps.map((s, i) => /* @__PURE__ */ jsx43(SubStepLine, { sub: s, running, spinner: spinnerGlyph(frame) }, `${task.id}-sub-${String(i)}`)) }),
-    task.evaluations.length > 0 && /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: task.evaluations.map((e, i) => /* @__PURE__ */ jsx43(EvaluationLine, { evaluation: e }, `${task.id}-eval-${String(i)}`)) }),
+    subStepRows.length > 0 && /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingLeft: 2, children: [
+      subStepElided > 0 && /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: `\u2026 ${String(subStepElided)} earlier sub-steps` }),
+      subStepRows.map((s, i) => /* @__PURE__ */ jsx43(SubStepLine, { sub: s, running }, `${task.id}-sub-${String(i)}`))
+    ] }),
+    evalRows.length > 0 && /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: [
+      evalElided > 0 && /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: `\u2026 ${String(evalElided)} earlier evaluations` }),
+      evalRows.map((e, i) => /* @__PURE__ */ jsx43(EvaluationLine, { evaluation: e }, `${task.id}-eval-${String(i)}`))
+    ] }),
     signalRows.length > 0 && /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: [
       /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: "signals" }),
       /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, children: signalRows.map((s, i) => /* @__PURE__ */ jsx43(SignalLine, { signal: s }, `${task.id}-sig-${String(i)}`)) })
@@ -18159,7 +18171,9 @@ var TasksPanel = ({
   running,
   nameById,
   maxSignalsPerTask = 8,
-  maxOrphanSignals = 6
+  maxOrphanSignals = 6,
+  maxSubStepsPerTask = 12,
+  maxEvaluationsPerTask = 6
 }) => {
   if (bucketed.tasks.length === 0 && bucketed.orphanSignals.length === 0) {
     return /* @__PURE__ */ jsx43(Box31, { paddingX: spacing.indent, children: /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: "(no tasks yet)" }) });
@@ -18169,7 +18183,18 @@ var TasksPanel = ({
     /* @__PURE__ */ jsx43(OrphanSignals, { signals: bucketed.orphanSignals, max: maxOrphanSignals }),
     bucketed.tasks.map((task) => {
       const display = nameById?.get(task.id) ?? `${task.id.slice(0, 8)}\u2026`;
-      return /* @__PURE__ */ jsx43(TaskBlock, { task, running, display, maxSignals: maxSignalsPerTask }, task.id);
+      return /* @__PURE__ */ jsx43(
+        TaskBlock,
+        {
+          task,
+          running,
+          display,
+          maxSignals: maxSignalsPerTask,
+          maxSubSteps: maxSubStepsPerTask,
+          maxEvaluations: maxEvaluationsPerTask
+        },
+        task.id
+      );
     })
   ] });
 };
@@ -18480,7 +18505,6 @@ var ExecuteView = () => {
     filter: (e) => "chainId" in e && e.chainId === sessionId2,
     limit: 2e3
   });
-  const frame = useSpinnerFrame(session?.descriptor.status === "running");
   const term = useTerminalSize();
   const isRunning = session?.descriptor.status === "running";
   useViewHints(
@@ -18573,10 +18597,7 @@ var ExecuteView = () => {
           String(tasksTotal)
         ] })
       ] }),
-      isRunning && /* @__PURE__ */ jsx46(Box34, { marginLeft: 2, children: /* @__PURE__ */ jsxs35(Text36, { color: inkColors.info, children: [
-        spinnerGlyph(frame),
-        " live"
-      ] }) })
+      isRunning && /* @__PURE__ */ jsx46(Box34, { marginLeft: 2, children: /* @__PURE__ */ jsx46(Spinner, { active: isRunning, color: inkColors.info, label: "live" }) })
     ] }),
     currentTask !== void 0 && currentTaskName !== void 0 && /* @__PURE__ */ jsxs35(Box34, { children: [
       /* @__PURE__ */ jsxs35(Text36, { dimColor: true, children: [
@@ -21120,8 +21141,40 @@ var useGlobalKeys = (opts = {}) => {
   });
 };
 
+// src/application/ui/tui/components/memory-pressure-banner.tsx
+import { useEffect as useEffect34, useState as useState41 } from "react";
+import { Box as Box49, Text as Text51 } from "ink";
+import { jsxs as jsxs50 } from "react/jsx-runtime";
+var formatMb = (bytes) => `${(bytes / 1048576).toFixed(0)} MB`;
+var formatPercent = (ratio) => `${Math.round(ratio * 100)}%`;
+var MemoryPressureBanner = () => {
+  const deps = useDeps();
+  const [latest, setLatest] = useState41(void 0);
+  useEffect34(() => {
+    const unsub = deps.eventBus.subscribe((event) => {
+      if (event.type === "memory-pressure") setLatest(event);
+    });
+    return unsub;
+  }, [deps.eventBus]);
+  if (latest === void 0 || latest.severity === "recovered") return null;
+  const tone = latest.severity === "critical" ? inkColors.error : inkColors.warning;
+  const headline = latest.severity === "critical" ? `memory critical \u2014 ${formatPercent(latest.ratio)} of heap; auto-cleared in-memory buffers` : `memory pressure \u2014 ${formatPercent(latest.ratio)} of heap used; consider aborting and restarting`;
+  const detail = `(${formatMb(latest.heapUsed)} / ${formatMb(latest.heapLimit)})`;
+  return /* @__PURE__ */ jsxs50(Box49, { paddingX: spacing.indent, flexDirection: "row", children: [
+    /* @__PURE__ */ jsxs50(Text51, { bold: true, color: tone, children: [
+      glyphs.warningGlyph,
+      " ",
+      headline
+    ] }),
+    /* @__PURE__ */ jsxs50(Text51, { dimColor: true, children: [
+      " ",
+      detail
+    ] })
+  ] });
+};
+
 // src/application/ui/tui/App.tsx
-import { jsx as jsx62 } from "react/jsx-runtime";
+import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 var App = ({
   deps,
   storage: storage2,
@@ -21144,7 +21197,10 @@ var Layout = ({ children }) => {
   const ui = useUiState();
   const { rows } = useTerminalSize();
   useGlobalKeys({ disabled: ui.promptActive });
-  return /* @__PURE__ */ jsx62(Box49, { flexDirection: "column", height: rows, children });
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", height: rows, children: [
+    /* @__PURE__ */ jsx62(MemoryPressureBanner, {}),
+    children
+  ] });
 };
 
 // src/application/ui/tui/launch-routing.ts
@@ -21228,6 +21284,69 @@ var createLogLevelGate = (initial) => {
   };
 };
 
+// src/integration/observability/heap-watchdog.ts
+import * as v8 from "v8";
+var MIN_INTERVAL_MS = 1e3;
+var DEFAULT_INTERVAL_MS = 1e4;
+var DEFAULT_WARNING_RATIO = 0.8;
+var DEFAULT_CRITICAL_RATIO = 0.95;
+var defaultReadHeap = () => {
+  const stats = v8.getHeapStatistics();
+  return { heapUsed: stats.used_heap_size, heapLimit: stats.heap_size_limit };
+};
+var classify = (ratio, warning, critical) => {
+  if (ratio >= critical) return "critical";
+  if (ratio >= warning) return "warning";
+  return "ok";
+};
+var startHeapWatchdog = (deps) => {
+  const intervalMs = Math.max(MIN_INTERVAL_MS, deps.intervalMs ?? DEFAULT_INTERVAL_MS);
+  const warning = deps.warningRatio ?? DEFAULT_WARNING_RATIO;
+  const critical = deps.criticalRatio ?? DEFAULT_CRITICAL_RATIO;
+  const clock = deps.clock ?? IsoTimestamp.now;
+  const readHeap = deps.readHeap ?? defaultReadHeap;
+  let stopped = false;
+  let previousBand = "ok";
+  const emit = (severity, reading, ratio) => {
+    deps.eventBus.publish({
+      type: "memory-pressure",
+      severity,
+      ratio,
+      heapUsed: reading.heapUsed,
+      heapLimit: reading.heapLimit,
+      at: clock()
+    });
+  };
+  const sample = () => {
+    if (stopped) return;
+    const reading = readHeap();
+    const ratio = reading.heapLimit > 0 ? reading.heapUsed / reading.heapLimit : 0;
+    const band = classify(ratio, warning, critical);
+    if (band === previousBand) return;
+    if (band === "warning") emit("warning", reading, ratio);
+    else if (band === "critical") {
+      emit("critical", reading, ratio);
+      try {
+        deps.onCritical?.();
+      } catch (err) {
+        console.warn("[heap-watchdog] onCritical threw:", err);
+      }
+    } else {
+      emit("recovered", reading, ratio);
+    }
+    previousBand = band;
+  };
+  const handle = setInterval(sample, intervalMs);
+  handle.unref?.();
+  return {
+    stop() {
+      if (stopped) return;
+      stopped = true;
+      clearInterval(handle);
+    }
+  };
+};
+
 // src/application/ui/tui/launch.ts
 var bootstrap = async () => {
   const paths = resolveStoragePaths();
@@ -21251,6 +21370,13 @@ var bootstrap = async () => {
   const unsubLogForward = deps.eventBus.subscribe((event) => {
     if (event.type === "log" && passesLogLevel(event.level, logLevelGate.get())) logBus.emit(event);
   });
+  const heapWatchdog = startHeapWatchdog({
+    eventBus: deps.eventBus,
+    onCritical: () => {
+      harnessBus.clear();
+      logBus.clear();
+    }
+  });
   const sessions = createSessionManager();
   const queue = createPromptQueue();
   void createInkInteractivePrompt(queue);
@@ -21287,6 +21413,7 @@ var bootstrap = async () => {
     drain: () => {
       queue.drain(new Error("TUI shutting down"));
       unsubLogForward();
+      heapWatchdog.stop();
     }
   };
 };
@@ -21301,7 +21428,7 @@ var launchTui = async () => {
     process.exitCode = 1;
     return;
   }
-  const appElement = React65.createElement(App, booted.app);
+  const appElement = React66.createElement(App, booted.app);
   const host = createInkHost({ appElement });
   setRunInTerminal(host.runInTerminal);
   try {

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-05-19T19:29:09.887Z",
+  "generatedAt": "2026-05-20T06:49:10.467Z",
   "assets": [
     "prompts/_partials/harness-context.md",
     "prompts/_partials/signals-evaluation.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralphctl",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Agent harness for long-running AI coding tasks — orchestrates Claude Code & GitHub Copilot across repositories",
   "homepage": "https://github.com/lukas-grigis/ralphctl",
   "type": "module",