helloloop 0.9.1 → 0.10.0

package/src/dashboard_web_client.mjs

@@ -0,0 +1,167 @@
+export const DASHBOARD_WEB_CSS = `
+  :root {
+    color-scheme: dark;
+    --bg: #081122;
+    --panel: #0f1a2f;
+    --panel-2: #13213c;
+    --border: rgba(148, 163, 184, 0.2);
+    --text: #e5eefc;
+    --muted: #9fb2d1;
+    --accent: #5eead4;
+    --warn: #fbbf24;
+    --danger: #f87171;
+    --ok: #34d399;
+    --shadow: 0 16px 40px rgba(0, 0, 0, 0.28);
+    font-family: Inter, "Segoe UI", system-ui, sans-serif;
+  }
+  * { box-sizing: border-box; }
+  body { margin: 0; background: radial-gradient(circle at top, #13284a 0%, var(--bg) 40%, #050b16 100%); color: var(--text); }
+  header { position: sticky; top: 0; z-index: 10; backdrop-filter: blur(14px); background: rgba(8, 17, 34, 0.86); border-bottom: 1px solid var(--border); padding: 20px 24px 16px; }
+  .title-row, .stats-row, .repo-header-top, .repo-meta { display: flex; gap: 12px; align-items: center; justify-content: space-between; flex-wrap: wrap; }
+  .title h1 { margin: 0; font-size: 24px; font-weight: 700; }
+  .title p { margin: 6px 0 0; color: var(--muted); font-size: 14px; }
+  .pill, .badge, .drawer-close { border-radius: 999px; border: 1px solid var(--border); background: rgba(19, 33, 60, 0.9); color: var(--text); }
+  .pill { display: inline-flex; align-items: center; gap: 8px; padding: 8px 14px; font-size: 13px; }
+  .stats-row { margin-top: 16px; }
+  .stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(110px, 1fr)); gap: 12px; width: min(100%, 760px); }
+  .stat, .repo-board { background: rgba(15, 26, 47, 0.9); border: 1px solid var(--border); box-shadow: var(--shadow); }
+  .stat { border-radius: 16px; padding: 14px; }
+  .stat-label, .column-count, .repo-meta, .empty, .card-meta, .drawer-section h4 { color: var(--muted); font-size: 12px; }
+  .stat-value { margin-top: 6px; font-size: 22px; font-weight: 700; }
+  main { padding: 20px 24px 80px; display: grid; gap: 20px; }
+  .repo-board { border-radius: 22px; overflow: hidden; }
+  .repo-header { padding: 18px 20px 14px; border-bottom: 1px solid var(--border); background: linear-gradient(180deg, rgba(19, 33, 60, 0.96) 0%, rgba(15, 26, 47, 0.96) 100%); }
+  .repo-header h2 { margin: 0; font-size: 20px; }
+  .repo-meta { margin-top: 12px; font-size: 13px; }
+  .columns { display: grid; grid-template-columns: repeat(5, minmax(220px, 1fr)); gap: 16px; padding: 18px; overflow-x: auto; }
+  .column { min-height: 180px; background: rgba(9, 16, 29, 0.72); border: 1px solid rgba(148, 163, 184, 0.14); border-radius: 18px; padding: 14px; display: flex; flex-direction: column; gap: 12px; }
+  .column h3, .drawer h3 { margin: 0; font-size: 15px; }
+  .cards { display: grid; gap: 10px; align-content: start; }
+  .card { width: 100%; text-align: left; background: rgba(19, 33, 60, 0.96); border: 1px solid rgba(148, 163, 184, 0.16); border-radius: 14px; padding: 12px; cursor: pointer; color: inherit; }
+  .card:hover { border-color: rgba(94, 234, 212, 0.42); transform: translateY(-1px); }
+  .card-title { font-size: 14px; font-weight: 600; line-height: 1.45; }
+  .badges, .repo-badges { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 10px; }
+  .badge { padding: 4px 10px; font-size: 11px; border-color: transparent; background: rgba(148, 163, 184, 0.14); }
+  .badge.ok { background: rgba(52, 211, 153, 0.15); color: var(--ok); }
+  .badge.warn { background: rgba(251, 191, 36, 0.14); color: var(--warn); }
+  .badge.danger { background: rgba(248, 113, 113, 0.14); color: var(--danger); }
+  .badge.accent { background: rgba(94, 234, 212, 0.12); color: var(--accent); }
+  .card-meta { margin-top: 10px; line-height: 1.5; }
+  aside.drawer { position: fixed; top: 0; right: 0; width: min(480px, 100vw); height: 100vh; background: rgba(6, 13, 26, 0.98); border-left: 1px solid var(--border); box-shadow: var(--shadow); transform: translateX(100%); transition: transform 180ms ease; padding: 24px; overflow-y: auto; z-index: 20; }
+  aside.drawer.open { transform: translateX(0); }
+  .drawer h3 { font-size: 20px; }
+  .drawer-section { margin-top: 18px; }
+  .drawer-section h4 { margin: 0 0 8px; text-transform: uppercase; }
+  .drawer-list { margin: 0; padding-left: 18px; line-height: 1.6; }
+  .drawer-close { position: sticky; top: 0; float: right; padding: 6px 12px; cursor: pointer; }
+  @media (max-width: 1100px) { .columns { grid-template-columns: repeat(2, minmax(240px, 1fr)); } }
+  @media (max-width: 760px) { header, main { padding-left: 14px; padding-right: 14px; } .columns { grid-template-columns: 1fr; } }
+`;
+
+export const DASHBOARD_WEB_JS = `
+  const STATUS_COLUMNS = [
+    { key: "pending", label: "待处理" },
+    { key: "in_progress", label: "进行中" },
+    { key: "done", label: "已完成" },
+    { key: "blocked", label: "阻塞" },
+    { key: "failed", label: "失败" },
+  ];
+  const boardEl = document.getElementById("board");
+  const statsEl = document.getElementById("stats");
+  const sessionPillEl = document.getElementById("session-pill");
+  const updatePillEl = document.getElementById("update-pill");
+  const drawerEl = document.getElementById("drawer");
+  const drawerContentEl = document.getElementById("drawer-content");
+  const drawerCloseEl = document.getElementById("drawer-close");
+  let currentSnapshot = window.__HELLOLOOP_INITIAL_SNAPSHOT__;
+
+  function badgeClass(kind) {
+    if (kind === "done" || kind === "running" || kind === "ready") return "ok";
+    if (kind === "blocked" || kind === "failed") return "danger";
+    if (kind === "retry_waiting" || kind === "watchdog_waiting") return "warn";
+    return "accent";
+  }
+
+  function formatRuntime(session) {
+    const runtime = session.runtime || {};
+    const bits = [runtime.status || "idle"];
+    if (Number.isFinite(Number(runtime.recoveryCount)) && Number(runtime.recoveryCount) > 0) bits.push("recovery=" + runtime.recoveryCount);
+    if (Number.isFinite(Number(runtime?.heartbeat?.idleSeconds)) && Number(runtime.heartbeat.idleSeconds) > 0) bits.push("idle=" + runtime.heartbeat.idleSeconds + "s");
+    return bits.join(" | ");
+  }
+
+  function groupTasks(tasks) {
+    const grouped = Object.fromEntries(STATUS_COLUMNS.map((column) => [column.key, []]));
+    for (const task of Array.isArray(tasks) ? tasks : []) {
+      const key = task.status || "pending";
+      if (!grouped[key]) grouped[key] = [];
+      grouped[key].push(task);
+    }
+    return grouped;
+  }
+
+  function renderStats(snapshot) {
+    const totals = snapshot.taskTotals || {};
+    const items = [["仓库总数", snapshot.repoCount || 0], ["活跃会话", snapshot.activeCount || 0], ["任务总计", totals.total || 0], ["待处理", totals.pending || 0], ["进行中", totals.inProgress || 0], ["已完成", totals.done || 0], ["阻塞", totals.blocked || 0], ["失败", totals.failed || 0]];
+    statsEl.innerHTML = items.map(([label, value]) => '<div class="stat"><div class="stat-label">' + label + '</div><div class="stat-value">' + value + '</div></div>').join("");
+    sessionPillEl.textContent = "仓库 " + (snapshot.repoCount || 0) + " · 活跃会话 " + (snapshot.activeCount || 0);
+    updatePillEl.textContent = "最近刷新 " + (snapshot.generatedAt || "unknown");
+  }
+
+  function renderTaskCard(task, session) {
+    const isCurrent = task.id && task.id === session.latestStatus?.taskId;
+    const docsCount = Array.isArray(task.docs) ? task.docs.length : 0;
+    const pathsCount = Array.isArray(task.paths) ? task.paths.length : 0;
+    return '<button class="card" data-session="' + encodeURIComponent(session.sessionId || "") + '" data-task="' + encodeURIComponent(task.id || "") + '"><div class="card-title">' + (task.title || task.id || "未命名任务") + '</div><div class="badges"><span class="badge accent">' + (task.priority || "P2") + '</span><span class="badge ' + badgeClass(task.status || "pending") + '">' + (task.status || "pending") + '</span><span class="badge ' + badgeClass(task.risk || "low") + '">' + (task.risk || "low") + '</span>' + (isCurrent ? '<span class="badge warn">当前执行</span>' : "") + '</div><div class="card-meta">docs ' + docsCount + ' · paths ' + pathsCount + '</div></button>';
+  }
+
+  function renderSessionBoard(session) {
+    const grouped = groupTasks(session.tasks || []);
+    const repoBadges = ['<span class="badge ' + badgeClass(session.supervisor?.status || "running") + '">supervisor ' + (session.supervisor?.status || "unknown") + '</span>', '<span class="badge ' + badgeClass(session.runtime?.status || "idle") + '">runtime ' + formatRuntime(session) + '</span>', (session.latestStatus?.taskTitle ? '<span class="badge accent">当前任务 ' + session.latestStatus.taskTitle + '</span>' : "")].filter(Boolean).join("");
+    const columnsHtml = STATUS_COLUMNS.map((column) => {
+      const tasks = grouped[column.key] || [];
+      return '<section class="column"><div><h3>' + column.label + '</h3><div class="column-count">' + tasks.length + ' 个任务</div></div><div class="cards">' + (tasks.length ? tasks.map((task) => renderTaskCard(task, session)).join("") : '<div class="empty">当前列为空</div>') + '</div></section>';
+    }).join("");
+    return '<section class="repo-board"><div class="repo-header"><div class="repo-header-top"><div><h2>' + session.repoName + '</h2><div class="repo-meta"><span>仓库：' + session.repoRoot + '</span><span>会话：' + session.sessionId + '</span></div></div><div class="repo-badges">' + repoBadges + '</div></div><div class="repo-meta"><span>当前动作：' + (session.activity?.current?.label || session.latestStatus?.message || session.runtime?.failureReason || "等待新事件") + '</span><span>宿主续跑：' + (session.hostResume?.issue?.label || (session.hostResume?.supervisorActive ? "后台仍在运行，可直接接续观察" : "需要按续跑提示继续")) + '</span></div></div><div class="columns">' + columnsHtml + '</div></section>';
+  }
+
+  function renderSnapshot(snapshot) {
+    currentSnapshot = snapshot;
+    renderStats(snapshot);
+    if (!Array.isArray(snapshot.sessions) || !snapshot.sessions.length) {
+      boardEl.innerHTML = '<section class="repo-board"><div class="repo-header"><h2>当前没有已登记仓库或后台会话</h2></div></section>';
+      return;
+    }
+    boardEl.innerHTML = snapshot.sessions.map(renderSessionBoard).join("");
+  }
+
+  function openDrawer(task, session) {
+    const docs = Array.isArray(task.docs) ? task.docs : [];
+    const paths = Array.isArray(task.paths) ? task.paths : [];
+    const acceptance = Array.isArray(task.acceptance) ? task.acceptance : [];
+    drawerContentEl.innerHTML = '<h3>' + (task.title || task.id || "未命名任务") + '</h3><div class="badges"><span class="badge accent">仓库 ' + session.repoName + '</span><span class="badge accent">优先级 ' + (task.priority || "P2") + '</span><span class="badge ' + badgeClass(task.status || "pending") + '">状态 ' + (task.status || "pending") + '</span><span class="badge ' + badgeClass(task.risk || "low") + '">风险 ' + (task.risk || "low") + '</span></div><div class="drawer-section"><h4>目标</h4><div>' + (task.goal || "无") + '</div></div><div class="drawer-section"><h4>文档</h4><ul class="drawer-list">' + (docs.length ? docs.map((item) => '<li>' + item + '</li>').join("") : "<li>无</li>") + '</ul></div><div class="drawer-section"><h4>路径</h4><ul class="drawer-list">' + (paths.length ? paths.map((item) => '<li>' + item + '</li>').join("") : "<li>无</li>") + '</ul></div><div class="drawer-section"><h4>验收</h4><ul class="drawer-list">' + (acceptance.length ? acceptance.map((item) => '<li>' + item + '</li>').join("") : "<li>无</li>") + '</ul></div>';
+    drawerEl.classList.add("open");
+  }
+
+  boardEl.addEventListener("click", (event) => {
+    const button = event.target.closest(".card");
+    if (!button) return;
+    const sessionId = decodeURIComponent(button.dataset.session || "");
+    const taskId = decodeURIComponent(button.dataset.task || "");
+    const session = (currentSnapshot.sessions || []).find((item) => item.sessionId === sessionId);
+    const task = (session?.tasks || []).find((item) => item.id === taskId);
+    if (session && task) openDrawer(task, session);
+  });
+
+  drawerCloseEl.addEventListener("click", () => drawerEl.classList.remove("open"));
+  window.addEventListener("keydown", (event) => { if (event.key === "Escape") drawerEl.classList.remove("open"); });
+
+  function connectEvents() {
+    const source = new EventSource("/events");
+    source.onmessage = (event) => { try { renderSnapshot(JSON.parse(event.data)); } catch (error) { console.error("snapshot parse failed", error); } };
+    source.onerror = () => { source.close(); setTimeout(connectEvents, 1500); };
+  }
+
+  renderSnapshot(currentSnapshot);
+  connectEvents();
+`;

package/src/dashboard_web_page.mjs

@@ -0,0 +1,49 @@
+import { DASHBOARD_WEB_CSS, DASHBOARD_WEB_JS } from "./dashboard_web_client.mjs";
+
+function escapeInlineJson(value) {
+  return JSON.stringify(value)
+    .replace(/</gu, "\\u003c")
+    .replace(/>/gu, "\\u003e")
+    .replace(/&/gu, "\\u0026");
+}
+
+export function renderDashboardWebHtml(options = {}) {
+  const initialSnapshot = options.initialSnapshot || {
+    generatedAt: "",
+    activeCount: 0,
+    taskTotals: {},
+    sessions: [],
+  };
+
+  return `<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>HelloLoop Dashboard</title>
+  <style>${DASHBOARD_WEB_CSS}</style>
+</head>
+<body>
+  <header>
+    <div class="title-row">
+      <div class="title">
+        <h1>HelloLoop Dashboard</h1>
+        <p>本地实时多仓开发看板。页面会持续订阅后台会话状态，不依赖宿主聊天流刷新。</p>
+      </div>
+      <div class="pill" id="update-pill">等待首帧</div>
+    </div>
+    <div class="stats-row">
+      <div class="stats" id="stats"></div>
+      <div class="pill" id="session-pill">仓库 0 · 活跃会话 0</div>
+    </div>
+  </header>
+  <main id="board"></main>
+  <aside class="drawer" id="drawer">
+    <button class="drawer-close" id="drawer-close">关闭</button>
+    <div id="drawer-content"></div>
+  </aside>
+  <script>window.__HELLOLOOP_INITIAL_SNAPSHOT__ = ${escapeInlineJson(initialSnapshot)};</script>
+  <script>${DASHBOARD_WEB_JS}</script>
+</body>
+</html>`;
+}

package/src/engine_event_parser_codex.mjs

@@ -0,0 +1,167 @@
+function normalizeWhitespace(value) {
+  return String(value || "").replace(/\s+/gu, " ").trim();
+}
+
+function stripMarkdown(value) {
+  return normalizeWhitespace(String(value || "")
+    .replace(/\*\*(.*?)\*\*/gu, "$1")
+    .replace(/`([^`]+)`/gu, "$1")
+    .replace(/^#+\s*/gmu, ""));
+}
+
+function shorten(value, maxLength = 160) {
+  const text = normalizeWhitespace(value);
+  if (!text) {
+    return "";
+  }
+  return text.length <= maxLength ? text : `${text.slice(0, Math.max(0, maxLength - 1))}…`;
+}
+
+function summarizeText(value, maxLength = 160) {
+  const sections = String(value || "")
+    .replace(/\r\n/gu, "\n")
+    .split(/\n\s*\n/gu)
+    .map((item) => stripMarkdown(item))
+    .filter(Boolean);
+  return shorten(sections[0] || stripMarkdown(value), maxLength);
+}
+
+function normalizeExitCode(value) {
+  const code = Number(value);
+  return Number.isFinite(code) ? code : null;
+}
+
+function normalizeTodoItems(items) {
+  const normalized = Array.isArray(items)
+    ? items.map((item) => ({
+      text: shorten(item?.text || "", 140),
+      completed: item?.completed === true,
+    }))
+    : [];
+  const completed = normalized.filter((item) => item.completed).length;
+  return {
+    items: normalized,
+    total: normalized.length,
+    completed,
+    pending: Math.max(0, normalized.length - completed),
+  };
+}
+
+function normalizeChanges(changes) {
+  return Array.isArray(changes)
+    ? changes.map((change) => ({
+      path: String(change?.path || "").trim(),
+      kind: String(change?.kind || "update").trim() || "update",
+    }))
+    : [];
+}
+
+function buildFileChangeLabel(changes) {
+  if (!changes.length) {
+    return "文件变更";
+  }
+  if (changes.length === 1) {
+    const change = changes[0];
+    return `${change.kind} ${shorten(change.path, 100)}`;
+  }
+  return `${changes.length} 个文件变更`;
+}
+
+export function parseCodexJsonlEventLine(line) {
+  const payload = JSON.parse(line);
+  const type = String(payload?.type || "").trim();
+
+  if (type === "thread.started") {
+    return {
+      kind: "thread",
+      status: "started",
+      label: "线程已启动",
+      threadId: String(payload.thread_id || "").trim(),
+    };
+  }
+
+  if (type === "turn.started") {
+    return {
+      kind: "turn",
+      status: "started",
+      label: "轮次开始",
+    };
+  }
+
+  if (type === "turn.completed") {
+    return {
+      kind: "turn",
+      status: "completed",
+      label: "轮次完成",
+    };
+  }
+
+  if (!type.startsWith("item.")) {
+    return {
+      kind: "event",
+      status: "info",
+      label: shorten(type, 120) || "事件更新",
+    };
+  }
+
+  const item = payload.item || {};
+  const itemId = String(item.id || "").trim();
+  const itemStatus = type === "item.started"
+    ? "in_progress"
+    : (String(item.status || "").trim() || "completed");
+
+  if (item.type === "reasoning") {
+    const summary = summarizeText(item.text || "", 180);
+    return {
+      kind: "reasoning",
+      itemId,
+      status: itemStatus,
+      label: summary || "推理更新",
+      summary,
+    };
+  }
+
+  if (item.type === "todo_list") {
+    const todo = normalizeTodoItems(item.items);
+    return {
+      kind: "todo",
+      itemId,
+      status: itemStatus,
+      label: todo.total > 0
+        ? `待办 ${todo.completed}/${todo.total}`
+        : "待办清单更新",
+      todo,
+    };
+  }
+
+  if (item.type === "command_execution") {
+    const command = shorten(item.command || "", 220);
+    return {
+      kind: "command",
+      itemId,
+      status: itemStatus,
+      label: command || "命令执行",
+      command,
+      exitCode: normalizeExitCode(item.exit_code),
+      outputSummary: summarizeText(item.aggregated_output || "", 160),
+    };
+  }
+
+  if (item.type === "file_change") {
+    const changes = normalizeChanges(item.changes);
+    return {
+      kind: "file_change",
+      itemId,
+      status: itemStatus,
+      label: buildFileChangeLabel(changes),
+      changes,
+    };
+  }
+
+  return {
+    kind: String(item.type || "item").trim() || "item",
+    itemId,
+    status: itemStatus,
+    label: summarizeText(item.text || item.command || item.type || type, 160) || "活动更新",
+  };
+}

package/src/engine_process_support.mjs

@@ -26,6 +26,7 @@ export function runChild(command, args, options = {}) {
       },
       stdio: ["pipe", "pipe", "pipe"],
       shell: Boolean(options.shell),
+      windowsHide: process.platform === "win32",
     });
 
     let stdout = "";

package/src/engine_selection.mjs

@@ -273,6 +273,30 @@ export async function resolveEngineSelection({
     };
   }
 
+  const recommendedEngine = recommendEngine({
+    hostContext,
+    availableEngines,
+    projectConfig,
+    userSettings,
+  });
+  if (!interactive && recommendedEngine) {
+    return buildResolution({
+      engine: recommendedEngine,
+      source: "remembered_default",
+      basis: [
+        buildRecommendationBasis({
+          hostContext,
+          projectConfig,
+          userSettings,
+          recommendedEngine,
+        }) || `继续沿用已确认过的默认执行引擎：${getEngineDisplayName(recommendedEngine)}。`,
+        "当前为无人值守续跑场景，HelloLoop 直接复用之前确认过的可用引擎。",
+      ],
+      hostContext,
+      probes,
+    });
+  }
+
   if (!interactive) {
     return {
       ok: false,

package/src/engine_selection_probe.mjs

@@ -1,7 +1,7 @@
 import { spawnSync } from "node:child_process";
 
 import { getEngineDisplayName, getEngineMetadata, listKnownEngines, normalizeEngineName } from "./engine_metadata.mjs";
-import { resolveCliInvocation } from "./shell_invocation.mjs";
+import { resolveCliInvocation, resolveCodexInvocation } from "./shell_invocation.mjs";
 
 function resolveExecutableOverride(policy = {}, engine) {
   const envExecutable = String(process.env[`HELLOLOOP_${String(engine || "").toUpperCase()}_EXECUTABLE`] || "").trim();
@@ -13,11 +13,14 @@ function resolveExecutableOverride(policy = {}, engine) {
 
 function probeEngineAvailability(engine, policy = {}) {
   const meta = getEngineMetadata(engine);
-  const invocation = resolveCliInvocation({
-    commandName: meta.commandName,
-    toolDisplayName: meta.displayName,
-    explicitExecutable: resolveExecutableOverride(policy, engine),
-  });
+  const explicitExecutable = resolveExecutableOverride(policy, engine);
+  const invocation = engine === "codex"
+    ? resolveCodexInvocation({ explicitExecutable })
+    : resolveCliInvocation({
+      commandName: meta.commandName,
+      toolDisplayName: meta.displayName,
+      explicitExecutable,
+    });
 
   if (invocation.error) {
     return {
@@ -30,6 +33,7 @@ function probeEngineAvailability(engine, policy = {}) {
   const result = spawnSync(invocation.command, [...invocation.argsPrefix, "--version"], {
     encoding: "utf8",
     shell: invocation.shell,
+    windowsHide: process.platform === "win32",
   });
   const ok = result.status === 0;
   return {

package/src/engine_selection_settings.mjs

@@ -3,6 +3,14 @@ import path from "node:path";
 
 import { fileExists, readJson, readText, timestampForFile, writeJson, writeText } from "./common.mjs";
 import { normalizeEngineName } from "./engine_metadata.mjs";
+import {
+  defaultObserverRetrySettings,
+  defaultSupervisorKeepAliveSettings,
+  defaultTerminalConcurrencySettings,
+  normalizeObserverRetrySettings,
+  normalizeSupervisorKeepAliveSettings,
+  normalizeTerminalConcurrencySettings,
+} from "./runtime_settings.mjs";
 
 function defaultEmailNotificationSettings() {
   return {
@@ -24,15 +32,6 @@ function defaultEmailNotificationSettings() {
   };
 }
 
-function defaultTerminalConcurrencySettings() {
-  return {
-    enabled: true,
-    visibleMax: 8,
-    backgroundMax: 8,
-    totalMax: 8,
-  };
-}
-
 function defaultUserSettings() {
   return {
     defaultEngine: "",
@@ -42,6 +41,8 @@ function defaultUserSettings() {
     },
     runtime: {
       terminalConcurrency: defaultTerminalConcurrencySettings(),
+      observerRetry: defaultObserverRetrySettings(),
+      supervisorKeepAlive: defaultSupervisorKeepAliveSettings(),
     },
   };
 }
@@ -66,16 +67,6 @@ function normalizePositiveInteger(value, fallback, minimum = 1) {
   return numericValue;
 }
 
-function normalizeTerminalConcurrencySettings(settings = {}) {
-  const defaults = defaultTerminalConcurrencySettings();
-  return {
-    enabled: normalizeBoolean(settings?.enabled, defaults.enabled),
-    visibleMax: normalizePositiveInteger(settings?.visibleMax, defaults.visibleMax, 0),
-    backgroundMax: normalizePositiveInteger(settings?.backgroundMax, defaults.backgroundMax, 0),
-    totalMax: normalizePositiveInteger(settings?.totalMax, defaults.totalMax, 0),
-  };
-}
-
 function mergeValueBySchema(schemaValue, baseValue, patchValue) {
   if (!isPlainObject(schemaValue)) {
     return patchValue === undefined ? baseValue : patchValue;
@@ -141,6 +132,8 @@ export function syncUserSettingsShape(settings = {}) {
     },
     runtime: {
       terminalConcurrency: normalizeTerminalConcurrencySettings(settings?.runtime?.terminalConcurrency || {}),
+      observerRetry: normalizeObserverRetrySettings(settings?.runtime?.observerRetry || {}),
+      supervisorKeepAlive: normalizeSupervisorKeepAliveSettings(settings?.runtime?.supervisorKeepAlive || {}),
     },
   };
 }

package/src/execution_interactivity.mjs

@@ -0,0 +1,12 @@
+export function shouldPromptForEngineSelection(options = {}) {
+  if (options.yes) {
+    return false;
+  }
+  if (options.detach) {
+    return false;
+  }
+  if (process.env.HELLOLOOP_SUPERVISOR_ACTIVE === "1") {
+    return false;
+  }
+  return Boolean(process.stdout?.isTTY);
+}