bosun 0.42.2 → 0.42.4

package/tui/lib/header-config.mjs

@@ -0,0 +1,68 @@
+import { loadConfig } from "../../config/config.mjs";
+
+function isTruthy(value) {
+  return ["1", "true", "yes", "on"].includes(String(value || "").trim().toLowerCase());
+}
+
+function hasValue(value) {
+  return String(value || "").trim().length > 0;
+}
+
+function resolveProjectLabel(config = {}) {
+  const candidates = [
+    config?.linearUrl,
+    config?.linear?.url,
+    config?.kanban?.url,
+    config?.kanban?.projectUrl,
+    config?.vkPublicUrl,
+    config?.vkEndpointUrl,
+    config?.projectUrl,
+    config?.kanban?.projectId,
+    config?.projectId,
+  ];
+  const label = candidates.find((candidate) => hasValue(candidate));
+  return label ? String(label).trim() : "No project";
+}
+
+function resolveConfiguredProviders(config = {}) {
+  const primaryAgent = String(config?.primaryAgent || "").trim().toLowerCase();
+  return {
+    claude: primaryAgent === "claude-sdk" || hasValue(process.env.ANTHROPIC_API_KEY),
+    codex:
+      primaryAgent === "codex-sdk" ||
+      config?.codexEnabled === true ||
+      hasValue(process.env.OPENAI_API_KEY) ||
+      hasValue(process.env.AZURE_OPENAI_API_KEY),
+    gemini:
+      primaryAgent === "gemini-sdk" ||
+      hasValue(process.env.GEMINI_API_KEY) ||
+      hasValue(process.env.GOOGLE_API_KEY),
+    copilot:
+      primaryAgent === "copilot-sdk" ||
+      (!isTruthy(process.env.COPILOT_SDK_DISABLED) && (hasValue(process.env.COPILOT_CLI_TOKEN) || hasValue(process.env.GITHUB_PAT))),
+  };
+}
+
+export function readTuiHeaderConfig(configDir) {
+  try {
+    const argv = ["node", "bosun-tui"];
+    if (configDir) {
+      argv.push("--config-dir", String(configDir));
+    }
+    const config = loadConfig(argv, { reloadEnv: false });
+    return {
+      configuredProviders: resolveConfiguredProviders(config),
+      projectLabel: resolveProjectLabel(config),
+    };
+  } catch {
+    return {
+      configuredProviders: {
+        claude: hasValue(process.env.ANTHROPIC_API_KEY),
+        codex: hasValue(process.env.OPENAI_API_KEY) || hasValue(process.env.AZURE_OPENAI_API_KEY),
+        gemini: hasValue(process.env.GEMINI_API_KEY) || hasValue(process.env.GOOGLE_API_KEY),
+        copilot: hasValue(process.env.COPILOT_CLI_TOKEN) || hasValue(process.env.GITHUB_PAT),
+      },
+      projectLabel: "No project",
+    };
+  }
+}

package/tui/lib/ws-bridge.mjs

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 
 import { resolveTuiAuthToken as resolveSharedTuiAuthToken } from "../../infra/tui-bridge.mjs";
@@ -17,6 +18,27 @@ function normalizeProtocol(protocol) {
 	return value === "wss" ? "wss" : "ws";
 }
 
+function readUiInstanceLock(configDir = defaultConfigDir()) {
+	try {
+		const lockPath = resolve(configDir, ".cache", "ui-server.instance.lock.json");
+		if (!existsSync(lockPath)) return null;
+		const parsed = JSON.parse(readFileSync(lockPath, "utf8"));
+		if (!parsed || typeof parsed !== "object") return null;
+		return parsed;
+	} catch {
+		return null;
+	}
+}
+
+function resolveWebSocketProtocol({ protocol, configDir } = {}) {
+	const explicit = String(protocol || "").trim().toLowerCase();
+	if (explicit === "ws" || explicit === "wss") {
+		return explicit;
+	}
+	const instance = readUiInstanceLock(configDir);
+	return String(instance?.protocol || "").trim().toLowerCase() === "https" ? "wss" : "ws";
+}
+
 function resolveTuiAuthToken(options = {}) {
 	return resolveSharedTuiAuthToken({
 		env: options.env || process.env,
@@ -54,10 +76,12 @@ class TuiWsBridge {
 		this.reconnectDelay = 1000;
 		this.reconnectTimer = null;
 		this._connected = false;
+		this._connectionState = "offline";
+		this._manualDisconnect = false;
 		this._url = buildTuiWebSocketUrl({
 			host,
 			port,
-			protocol,
+			protocol: resolveWebSocketProtocol({ protocol, configDir: this.configDir }),
 			token: resolveTuiAuthToken({ configDir: this.configDir }),
 		});
 	}
@@ -66,24 +90,26 @@ class TuiWsBridge {
 		if (this.ws && this.ws.readyState === WebSocket.OPEN) {
 			return;
 		}
+		this._manualDisconnect = false;
 
 		try {
 			this._url = buildTuiWebSocketUrl({
 				host: this.host,
 				port: this.port,
-				protocol: this.protocol,
+				protocol: resolveWebSocketProtocol({ protocol: this.protocol, configDir: this.configDir }),
 				token: resolveTuiAuthToken({ configDir: this.configDir }),
 			});
 			this.ws = new WebSocket(this._url);
 
 			this.ws.onopen = () => {
 				this._connected = true;
+				this._connectionState = "connected";
 				this.reconnectAttempts = 0;
 				this.send("subscribe", {
 					channels: ["monitor", "stats", "sessions", "tasks", "workflows", "tui"],
 				});
+				this._emit("connection:state", { state: this._connectionState });
 				this._emit("connect", {});
-				console.log("[ws-bridge] Connected to UI server");
 			};
 
 			this.ws.onmessage = (event) => {
@@ -91,28 +117,35 @@ class TuiWsBridge {
 					const data = JSON.parse(event.data);
 					this._handleMessage(data);
 				} catch (err) {
-					console.warn("[ws-bridge] Failed to parse message:", err.message);
+					this._emit("error", { message: err?.message || "Failed to parse message" });
 				}
 			};
 
 			this.ws.onclose = () => {
 				this._connected = false;
+				this._connectionState = this._manualDisconnect ? "offline" : "reconnecting";
+				this._emit("connection:state", { state: this._connectionState });
 				this._emit("disconnect", {});
 				console.log("[ws-bridge] Disconnected from UI server");
-				this._scheduleReconnect();
+				if (!this._manualDisconnect) {
+					this._scheduleReconnect();
+				}
 			};
 
 			this.ws.onerror = (err) => {
-				console.error("[ws-bridge] WebSocket error:", err.message);
-				this._emit("error", { message: err.message || "WebSocket error" });
+				const message = err?.message || err?.error?.message || "WebSocket error";
+				this._emit("error", { message });
+				this._emit("error", { message });
+				this._emit("error", { message });
 			};
 		} catch (err) {
-			console.error("[ws-bridge] Failed to connect:", err.message);
+			this._emit("error", { message: err?.message || "Failed to connect" });
 			this._scheduleReconnect();
 		}
 	}
 
 	disconnect() {
+		this._manualDisconnect = true;
 		if (this.reconnectTimer) {
 			clearTimeout(this.reconnectTimer);
 			this.reconnectTimer = null;
@@ -122,19 +155,32 @@ class TuiWsBridge {
 			this.ws = null;
 		}
 		this._connected = false;
+		this._connectionState = "offline";
+		this._emit("connection:state", { state: this._connectionState });
 	}
 
 	_scheduleReconnect() {
 		if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+			this._connectionState = "offline";
+			this._emit("connection:state", { state: this._connectionState });
 			this._emit("error", { message: "Max reconnection attempts reached" });
 			return;
 		}
 
 		const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts);
 		this.reconnectAttempts++;
+		this._connectionState = "reconnecting";
+		this._emit("connection:state", {
+			state: this._connectionState,
+			attempt: this.reconnectAttempts,
+			delayMs: delay,
+		});
+		this._emit("reconnecting", {
+			attempt: this.reconnectAttempts,
+			delayMs: delay,
+		});
 
 		this.reconnectTimer = setTimeout(() => {
-			console.log(`[ws-bridge] Reconnecting (attempt ${this.reconnectAttempts})...`);
 			this.connect();
 		}, delay);
 	}
@@ -232,6 +278,10 @@ class TuiWsBridge {
 	get isConnected() {
 		return this._connected;
 	}
+
+	get connectionState() {
+		return this._connectionState;
+	}
 }
 
 let _instance = null;
@@ -279,5 +329,7 @@ export {
 	buildTuiWebSocketUrl,
 	createWsBridge,
 	defaultConfigDir,
+	resolveWebSocketProtocol,
 	resolveTuiAuthToken,
 };
+

package/tui/screens/agents.mjs

@@ -155,6 +155,8 @@ export default function AgentsScreen({ wsBridge, host = "127.0.0.1", port = 3080
     };
   }, [refreshData]);
 
+  const selectedSession = entries.find((entry) => entry.id === selectedId)?.session || entries[0]?.session || null;
+
   React.useEffect(() => {
     if (!wsBridge || typeof wsBridge.on !== "function") return undefined;
     const handlers = [
@@ -166,7 +168,80 @@ export default function AgentsScreen({ wsBridge, host = "127.0.0.1", port = 3080
             : [];
         applySessionSnapshot(sessions, Date.now());
       }),
+      wsBridge.on("session:event", (payload) => {
+        const session = payload?.session;
+        if (!session?.id) return;
+        const nextSessions = Array.isArray(liveSessionsRef.current)
+          ? [...liveSessionsRef.current]
+          : [];
+        const existingIndex = nextSessions.findIndex((candidate) => candidate.id === session.id);
+        if (existingIndex >= 0) nextSessions[existingIndex] = session;
+        else nextSessions.unshift(session);
+        applySessionSnapshot(nextSessions, Date.now());
+
+        if (selectedId === session.id) {
+          setDetailView(detailLines(payload));
+          const hasMessages = Array.isArray(payload?.session?.messages);
+          const isMessageEvent = payload?.event?.kind === "message";
+          if (hasMessages || isMessageEvent) {
+            setLogLines(sessionMessagesToLogLines(payload));
+          }
+          const isMessageEvent = payload?.event?.kind === "message";
+          if (hasMessages || isMessageEvent) {
+            setLogLines(sessionMessagesToLogLines(payload));
+          }
+          const isMessageEvent = payload?.event?.kind === "message";
+          if (hasMessages || isMessageEvent) {
+            setLogLines(sessionMessagesToLogLines(payload));
+          }
+          const isMessageEvent = payload?.event?.kind === "message";
+          if (hasMessages || isMessageEvent) {
+            setLogLines(sessionMessagesToLogLines(payload));
+          }
+        }
+      }),
+      wsBridge.on("retry:update", applyRetryQueue),
+      wsBridge.on("retry-queue-updated", applyRetryQueue),
+    ];
+
+    return () => {
+      handlers.forEach((handler) => {
+        if (typeof handler === "function") handler();
+      });
+    };
+  }, [applyRetryQueue, applySessionSnapshot, selectedId, wsBridge]);
+
+  useInput((input, key) => {
+    if (confirmKill) {
+      if ((input === "y" || input === "Y") && selectedSession?.id) {
+        void fetchJson(resolvedHost, resolvedPort, sessionActionPath(selectedSession.id, "stop"), {
+          method: "POST",
+        }).then(() => {
+          setStatusLine(`Stopped ${describeSelection(selectedSession)}`);
+        }).catch((error) => {
+          setStatusLine(error.message || String(error));
+        });
+      }
+      setConfirmKill(false);
+      return;
+    }
 
+    const selectableEntries = entries.filter((entry) => entry?.session);
+    const selectedIndex = selectableEntries.findIndex((entry) => entry.id === selectedId);
+
+    if (key.upArrow && selectedIndex > 0) {
+      setSelectedId(selectableEntries[selectedIndex - 1].id);
+      return;
+    }
+    if (key.downArrow && selectedIndex >= 0 && selectedIndex < selectableEntries.length - 1) {
+      setSelectedId(selectableEntries[selectedIndex + 1].id);
+      return;
+    }
+    if (key.return && selectedSession?.id) {
+      setDetailView(detailLines({ session: selectedSession }));
+      return;
+    }
+    if (input === "c" || input === "C") {
       if (selectedSession?.id) {
         stdout.write(buildOsc52CopySequence(selectedSession.id));
         setStatusLine(`Copied ${selectedSession.id}`);
@@ -177,6 +252,58 @@ export default function AgentsScreen({ wsBridge, host = "127.0.0.1", port = 3080
       setShowBackoff((current) => !current);
       return;
     }
+    if (input === "p" || input === "P") {
+      if (selectedSession?.id) {
+        void fetchJson(resolvedHost, resolvedPort, sessionActionPath(selectedSession.id, "pause"), {
+          method: "POST",
+        }).then(() => setStatusLine(`Paused ${describeSelection(selectedSession)}`)).catch((error) => {
+          setStatusLine(error.message || String(error));
+        });
+      }
+      return;
+    }
+    if (input === "r" || input === "R") {
+      if (selectedSession?.id) {
+        void fetchJson(resolvedHost, resolvedPort, sessionActionPath(selectedSession.id, "resume"), {
+          method: "POST",
+        }).then(() => setStatusLine(`Resumed ${describeSelection(selectedSession)}`)).catch((error) => {
+          setStatusLine(error.message || String(error));
+        });
+      }
+      return;
+    }
+    if (input === "k" || input === "K") {
+      if (selectedSession?.id) {
+        setConfirmKill(true);
+      }
+      return;
+    }
+    if (input === "l" || input === "L") {
+      if (selectedSession?.id) {
+        void fetchJson(resolvedHost, resolvedPort, `/api/sessions/${encodeURIComponent(selectedSession.id)}?workspace=all&full=1`)
+          .then((payload) => {
+            setLogLines(sessionMessagesToLogLines(payload));
+            setStatusLine(`Loaded logs for ${describeSelection(selectedSession)}`);
+          })
+          .catch((error) => {
+            setStatusLine(error.message || String(error));
+          });
+      }
+      return;
+    }
+    if (input === "d" || input === "D") {
+      if (selectedSession?.id) {
+        void fetchJson(resolvedHost, resolvedPort, sessionActionPath(selectedSession.id, "diff"))
+          .then((payload) => {
+            setDiffView(summarizeDiff(payload));
+            setStatusLine(`Loaded diff for ${describeSelection(selectedSession)}`);
+          })
+          .catch((error) => {
+            setStatusLine(error.message || String(error));
+          });
+      }
+      return;
+    }
     if (key.escape) {
       setDetailView(null);
       setLogLines([]);

package/tui/screens/tasks.mjs

@@ -1,48 +1 @@
-import React from "react";
-import htm from "htm";
-import { Box, Text } from "ink";
-
-const html = htm.bind(React.createElement);
-
-const COLUMNS = ["todo", "inprogress", "inreview", "blocked", "done"];
-
-function formatTask(task) {
-  const id = String(task?.id || "").slice(0, 8) || "--------";
-  const title = String(task?.title || "Untitled");
-  return `${id}  ${title}`;
-}
-
-export default function TasksScreen({ tasks }) {
-  const buckets = new Map(COLUMNS.map((column) => [column, []]));
-  for (const task of Array.isArray(tasks) ? tasks : []) {
-    const status = String(task?.status || "todo").toLowerCase();
-    if (!buckets.has(status)) buckets.set(status, []);
-    buckets.get(status).push(task);
-  }
-
-  return html`
-    <${Box} flexDirection="column" paddingY=${1}>
-      <${Text} dimColor>Task board view is read-only in the terminal build.<//>
-      <${Box} marginTop=${1}>
-        ${COLUMNS.map((column) => html`
-          <${Box}
-            key=${column}
-            flexDirection="column"
-            borderStyle="single"
-            paddingX=${1}
-            marginRight=${1}
-            width=${24}
-          >
-            <${Text} bold>${column} (${(buckets.get(column) || []).length})<//>
-            ${(buckets.get(column) || []).slice(0, 8).map((task) => html`
-              <${Text} key=${task.id} wrap="truncate-end">${formatTask(task)}<//>
-            `)}
-            ${(buckets.get(column) || []).length === 0 && html`
-              <${Text} dimColor>No tasks<//>
-            `}
-          <//>
-        `)}
-      <//>
-    <//>
-  `;
-}
+export { default } from "../../ui/tui/TasksScreen.js";

package/ui/app.js

@@ -276,6 +276,7 @@ import {
 import { formatRelative } from "./modules/utils.js";
 import {
   buildSessionApiPath,
+  shouldFallbackToAllSessions,
   getSessionLifecycleState,
   getSessionRecencyTimestamp,
   getSessionRuntimeState,
@@ -1050,11 +1051,11 @@ function InspectorPanel({ onResizeStart, onResizeReset, showResizer }) {
         try {
           res = await apiFetch(fullSessionPath, { _silent: true });
         } catch (err) {
-          const errorText = String(err?.message || "").toLowerCase();
-          const shouldRetryAll =
-            Boolean(fallbackSessionPath) &&
-            fallbackSessionPath !== fullSessionPath &&
-            (errorText.includes("session not found") || errorText.includes("request failed (404)"));
+          const shouldRetryAll = shouldFallbackToAllSessions(
+            err,
+            fullSessionPath,
+            fallbackSessionPath,
+          );
           if (!shouldRetryAll) throw err;
           res = await apiFetch(fallbackSessionPath, { _silent: true });
         }
@@ -2688,3 +2689,5 @@ const remountApp = () => {
 };
 globalThis.__veRemountApp = remountApp;
 mountApp();
+
+

package/ui/components/kanban-board.js

@@ -14,6 +14,7 @@ import {
   loadTasks,
   normalizeTaskLifecycleStatus,
   classifyTaskLifecycleAction,
+  mergeTaskRecords,
 } from "../modules/state.js";
 import { apiFetch } from "../modules/api.js";
 import { haptic, showConfirm } from "../modules/telegram.js";
@@ -249,6 +250,56 @@ function getTaskBaseBranch(task) {
   );
 }
 
+function getTaskPrLinkage(task) {
+  if (!task) return [];
+  const records = [];
+  const seen = new Set();
+  const append = (record) => {
+    if (!record || typeof record !== "object") return;
+    const branchName = String(record.branchName || "").trim();
+    const prUrl = String(record.prUrl || "").trim();
+    const prNumber = Number.parseInt(String(record.prNumber ?? ""), 10);
+    if (!branchName && !prUrl && !(Number.isFinite(prNumber) && prNumber > 0)) return;
+    const normalized = {
+      branchName,
+      prUrl,
+      prNumber: Number.isFinite(prNumber) && prNumber > 0 ? prNumber : null,
+      source: String(record.source || task?.meta?.prLinkageSource || "").trim(),
+      freshness: String(record.freshness || task?.meta?.prLinkageFreshness || "").trim(),
+      linkedAt: String(record.linkedAt || "").trim(),
+      updatedAt: String(record.updatedAt || task?.meta?.prLinkageUpdatedAt || "").trim(),
+    };
+    const key = [normalized.branchName.toLowerCase(), normalized.prNumber || "", normalized.prUrl.toLowerCase()].join("|");
+    if (seen.has(key)) return;
+    seen.add(key);
+    records.push(normalized);
+  };
+  (Array.isArray(task.prLinkage) ? task.prLinkage : []).forEach(append);
+  (Array.isArray(task?.meta?.prLinkage) ? task.meta.prLinkage : []).forEach(append);
+  append(task);
+  return records;
+}
+
+function getPrimaryTaskPrLinkage(task) {
+  return getTaskPrLinkage(task)[0] || null;
+}
+
+function formatPrLinkageFreshnessLabel(linkage) {
+  const freshness = String(linkage?.freshness || "").trim().toLowerCase();
+  const timestamp = String(linkage?.updatedAt || linkage?.linkedAt || "").trim();
+  const relative = timestamp ? formatRelative(timestamp) : "";
+  if (freshness === "stale") {
+    return relative ? `PR freshness: Stale (${relative})` : "PR freshness: Stale";
+  }
+  if (freshness === "fresh") {
+    return relative ? `PR freshness: Fresh (${relative})` : "PR freshness: Fresh";
+  }
+  if (relative) {
+    return `PR freshness: Updated ${relative}`;
+  }
+  return "PR freshness: Linked";
+}
+
 function getTaskRuntimeSnapshot(task) {
   return task?.runtimeSnapshot || task?.meta?.runtimeSnapshot || null;
 }
@@ -444,7 +495,7 @@ async function executeBoardTransition(task, newStatus, columnLabel) {
         const merged = detail?.data || startRes?.data || null;
         if (merged) {
           tasksData.value = tasksData.value.map((t) =>
-            matchTaskId(t.id, taskId) ? { ...t, ...merged } : t,
+            matchTaskId(t.id, taskId) ? mergeTaskRecords(t, merged) : t,
           );
         }
         return startRes;
@@ -462,7 +513,7 @@ async function executeBoardTransition(task, newStatus, columnLabel) {
       });
       if (res?.data) {
         tasksData.value = tasksData.value.map((t) =>
-          matchTaskId(t.id, taskId) ? { ...t, ...res.data } : t,
+          matchTaskId(t.id, taskId) ? mergeTaskRecords(t, res.data) : t,
         );
       }
       return res;
@@ -621,6 +672,7 @@ function KanbanCard({ task, onOpen }) {
   const storyPoints = getTaskStoryPoints(task);
   const dueDate = getTaskDueDate(task);
   const blockedPreview = getTaskBlockedPreview(task);
+  const prLinkage = getPrimaryTaskPrLinkage(task);
   const repoName = task.repo || task.repository || "";
   const issueNum = task.issueNumber || task.issue_number || (typeof task.id === "string" && /^\d+$/.test(task.id) ? task.id : null);
   const hasAgent = Boolean(
@@ -693,6 +745,14 @@ function KanbanCard({ task, onOpen }) {
             ${dueDate && html`<${Chip} label=${`Due: ${truncate(dueDate, 18)}`} size="small" variant="outlined" color="warning" sx=${{ height: 20, fontSize: '0.65rem' }} />`}
           </${Stack}>
         `}
+        ${prLinkage && html`
+          <${Stack} direction="row" spacing=${0.5} flexWrap="wrap" sx=${{ mt: 0.75 }}>
+            ${prLinkage.prNumber && html`<${Chip} label=${`PR #${prLinkage.prNumber}`} size="small" variant="outlined" sx=${{ height: 20, fontSize: '0.65rem' }} />`}
+            ${prLinkage.branchName && html`<${Chip} label=${`Branch: ${truncate(prLinkage.branchName, 18)}`} size="small" variant="outlined" sx=${{ height: 20, fontSize: '0.65rem' }} />`}
+            ${prLinkage.source && html`<${Chip} label=${`PR source: ${truncate(prLinkage.source, 16)}`} size="small" variant="outlined" sx=${{ height: 20, fontSize: '0.65rem' }} />`}
+            ${(prLinkage.freshness || prLinkage.updatedAt || prLinkage.linkedAt) && html`<${Chip} label=${formatPrLinkageFreshnessLabel(prLinkage)} size="small" color=${prLinkage.freshness === "stale" ? "warning" : "success"} sx=${{ height: 20, fontSize: '0.65rem' }} />`}
+          </${Stack}>
+        `}
         ${baseBranch && html`
           <${Typography} variant="caption" color="text.secondary" sx=${{ display: 'block', mt: 0.5 }}>Base: ${truncate(baseBranch, 24)}</${Typography}>
         `}
@@ -845,7 +905,7 @@ function KanbanColumn({
           });
           if (res?.data) {
             tasksData.value = tasksData.value.map((t) =>
-              matchTaskId(t.id, taskId) ? { ...t, ...res.data } : t,
+              matchTaskId(t.id, taskId) ? mergeTaskRecords(t, res.data) : t,
             );
           }
           return res;
@@ -1180,3 +1240,5 @@ export function KanbanBoard({ onOpenTask, hasMoreTasks = false, loadingMoreTasks
     </${Box}>
   `;
 }
+
+