aidevops 3.29.18 → 3.29.20

package/README.md

@@ -58,7 +58,7 @@ The result: an AI operations platform that manages projects across every busines
 [![Copyright](https://img.shields.io/badge/Copyright-Marcus%20Quinn%202025--2026-blue.svg)](https://github.com/marcusquinn)
 
 <!-- Release & Version Info -->
-[![Version](https://img.shields.io/badge/Version-3.29.18-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.29.20-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
 [![npm version](https://img.shields.io/npm/v/aidevops)](https://www.npmjs.com/package/aidevops)
 [![Homebrew](https://img.shields.io/badge/homebrew-marcusquinn%2Ftap-orange)](https://github.com/marcusquinn/homebrew-tap)
 [![GitHub repository](https://img.shields.io/badge/github-repository-181717.svg?logo=github)](https://github.com/marcusquinn/aidevops)

package/VERSION

@@ -1 +1 @@
-3.29.18
+3.29.20

package/aidevops.sh

@@ -5,7 +5,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.29.18
+# Version: 3.29.20
 
 set -euo pipefail
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "3.29.18",
+  "version": "3.29.20",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "workspaces": [

package/packages/gui-api/src/status-adapter-utils.ts

@@ -1,5 +1,5 @@
 import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { accessSync, constants, existsSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
 
 export function readJsonObject(pathName: string): { health: "present" | "missing" | "invalid"; value: Record<string, unknown> } {
@@ -112,12 +112,34 @@ export function firstExistingPathRef(pathRefs: string[]): string | null {
   return pathRefs.find((pathRef) => existsSync(expandHome(pathRef))) ?? null;
 }
 
+export function firstExecutablePathRef(pathRefs: string[]): string | null {
+  return pathRefs.find((pathRef) => isExecutable(expandHome(pathRef))) ?? null;
+}
+
+export function isExecutable(pathName: string): boolean {
+  try {
+    if (!statSync(pathName).isFile()) {
+      return false;
+    }
+    accessSync(pathName, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 export function resolveBinary(binary: string): string | null {
+  const candidatePath = binaryPathCandidates(binary).find((pathName) => isExecutable(pathName));
+  if (candidatePath !== undefined) {
+    return candidatePath;
+  }
+
   try {
     const output = execFileSync("which", [binary], {
+      env: { ...process.env, PATH: expandedPath() },
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
-      timeout: 200,
+      timeout: 350,
     }).trim();
     return output.split("\n").find((line) => line.length > 0) ?? null;
   } catch {
@@ -125,6 +147,27 @@ export function resolveBinary(binary: string): string | null {
   }
 }
 
+function binaryPathCandidates(binary: string): string[] {
+  return expandedPath().split(":").filter(Boolean).map((dir) => join(dir, binary));
+}
+
+function expandedPath(): string {
+  const home = process.env.HOME ?? "";
+  const extraPaths = [
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+    "/usr/bin",
+    "/bin",
+    "/usr/sbin",
+    "/sbin",
+    join(home, ".bun/bin"),
+    join(home, ".local/bin"),
+    join(home, ".cursor/bin"),
+    join(home, ".qlty/bin"),
+  ];
+  return [...new Set([...(process.env.PATH ?? "").split(":"), ...extraPaths].filter(Boolean))].join(":");
+}
+
 export function readBinaryVersion(binaryPath: string, args: string[]): string {
   if (args.length === 0) {
     return "unknown";
@@ -132,9 +175,10 @@ export function readBinaryVersion(binaryPath: string, args: string[]): string {
 
   try {
     const output = execFileSync(binaryPath, args, {
+      env: { ...process.env, PATH: expandedPath() },
       encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 150,
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 650,
     }).trim();
     return output.split("\n").find((line) => line.length > 0) ?? "unknown";
   } catch {

package/packages/gui-api/src/status-managed-apps.ts

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
 import type { GuiAppActionId, GuiManagedAppSummary } from "../../gui-shared/src";
-import { collapseHome, expandHome, firstExistingPathRef, readBinaryVersion, resolveBinary } from "./status-adapter-utils";
+import { collapseHome, expandHome, firstExecutablePathRef, firstExistingPathRef, readBinaryVersion, resolveBinary } from "./status-adapter-utils";
 
 type ManagedAppActionCommands = Partial<Record<GuiAppActionId, string>>;
 
@@ -180,7 +180,7 @@ function setupScopeActions(scope: string): ManagedAppActionCommands {
 }
 
 function managedAppSummary(definition: ManagedAppDefinition, latestVersion: string, installedVersion: string): GuiManagedAppSummary {
-  const binaryPath = definition.binary === null ? null : resolveBinary(definition.binary);
+  const binaryPath = definition.binary === null ? null : executableInstallPath(definition.install_path_refs) ?? resolveBinary(definition.binary);
   const installPathRef = firstExistingPathRef(definition.install_path_refs) ?? definition.install_path_refs[0] ?? "not found";
   const installedVersionText = readManagedAppVersion(definition, binaryPath, installedVersion);
   const latestVersionText = definition.latest_version_source === "aidevops"
@@ -231,7 +231,13 @@ function readManagedAppVersion(definition: ManagedAppDefinition, binaryPath: str
     return readAppBundleVersion(existingPathRef) ?? "installed";
   }
 
-  return readBinaryVersion(binaryPath, definition.version_args);
+  const versionText = readBinaryVersion(binaryPath, definition.version_args);
+  return versionText === "unknown" ? "installed" : versionText;
+}
+
+function executableInstallPath(pathRefs: string[]): string | null {
+  const executablePathRef = firstExecutablePathRef(pathRefs);
+  return executablePathRef === null ? null : expandHome(executablePathRef);
 }
 
 function readAppBundleVersion(pathRef: string): string | null {
@@ -239,5 +245,11 @@ function readAppBundleVersion(pathRef: string): string | null {
     return null;
   }
 
-  return readBinaryVersion("/usr/libexec/PlistBuddy", ["-c", "Print :CFBundleShortVersionString", `${expandHome(pathRef)}/Contents/Info.plist`]);
+  const version = readBinaryVersion("/usr/libexec/PlistBuddy", ["-c", "Print :CFBundleShortVersionString", `${expandHome(pathRef)}/Contents/Info.plist`]);
+  if (version !== "unknown") {
+    return version;
+  }
+
+  const bundleVersion = readBinaryVersion("/usr/libexec/PlistBuddy", ["-c", "Print :CFBundleVersion", `${expandHome(pathRef)}/Contents/Info.plist`]);
+  return bundleVersion === "unknown" ? null : bundleVersion;
 }

package/packages/gui-desktop/scripts/install-macos-app.sh

@@ -338,7 +338,7 @@ final class DraggableTitlebarView: NSView {
     }
 }
 
-final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate, WKScriptMessageHandler, NSMenuItemValidation, NSWindowDelegate {
+final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate, WKUIDelegate, WKScriptMessageHandler, NSMenuItemValidation, NSWindowDelegate {
     private var window: NSWindow!
     private var aboutWindow: NSWindow?
     private var titlebarToggleButton: NSButton?
@@ -416,6 +416,18 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
         decisionHandler(.allow)
     }
 
+    func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? {
+        guard let url = navigationAction.request.url else {
+            return nil
+        }
+
+        if url.scheme == "http" || url.scheme == "https" {
+            NSWorkspace.shared.open(url)
+        }
+
+        return nil
+    }
+
     private func isLocalAppURL(_ url: URL) -> Bool {
         let host = url.host ?? ""
         return (host == "127.0.0.1" || host == "localhost") && url.port == Int(webPort)
@@ -677,11 +689,13 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
     private func configureWindow() {
         let configuration = WKWebViewConfiguration()
         configuration.defaultWebpagePreferences.allowsContentJavaScript = true
+        configuration.preferences.javaScriptCanOpenWindowsAutomatically = true
         let userContentController = WKUserContentController()
         userContentController.add(self, name: "accentHue")
         configuration.userContentController = userContentController
         webView = WKWebView(frame: .zero, configuration: configuration)
         webView.navigationDelegate = self
+        webView.uiDelegate = self
         webView.translatesAutoresizingMaskIntoConstraints = false
 
         let contentContainer = NSView()

package/packages/gui-web/src/App.tsx

@@ -4,13 +4,9 @@ import { MachineRail, Sidebar } from "./AppNavigation";
 import { Workspace } from "./AppWorkspace";
 import type { ConversationMode, FontPreference, FontSizePreference, ShellMode, SurfaceId, ThemePreference } from "./app-model";
 import { DEFAULT_ACCENT_HUE, DEFAULT_FONT, DEFAULT_FONT_SIZE, fileRootBySurface, findSurface, findSurfaceSectionLabel, fontFamilyForPreference, fontSizeForPreference, getSystemTheme, isFontPreference, isFontSizePreference } from "./app-model";
+import { type NavigationHistory, nextHistoryIndex, useNavigationHistoryKeyboard } from "./navigation-history";
 import { fetchStatus, mockedStatus } from "./status-client";
 
-interface NavigationHistory {
-  entries: SurfaceId[];
-  index: number;
-}
-
 interface WebKitBridgeWindow extends Window {
   webkit?: {
     messageHandlers?: {
@@ -37,7 +33,7 @@ export const appearanceStorageKeys = {
 } as const;
 
 const defaultSidebarWidth = 302;
-const minSidebarWidth = 248;
+const minSidebarWidth = 300;
 const maxSidebarWidth = 520;
 export const loadingSkeletonPanelLabels = ["machine rail", "sidebar", "workspace", "status bar"] as const;
 export const loadingBrandGlyph = ">_";
@@ -93,6 +89,7 @@ export function App(): ReactElement {
   const canGoBack = navigation.index > 0;
   const canGoForward = navigation.index < navigation.entries.length - 1;
   const fileRoot = fileRootBySurface[activeSurface];
+  useNavigationHistoryKeyboard(setNavigation);
 
   const setActiveSurface = (surface: SurfaceId) => {
     setNavigation((current) => {
@@ -108,11 +105,11 @@ export function App(): ReactElement {
   };
 
   const goBack = () => {
-    setNavigation((current) => ({ ...current, index: Math.max(0, current.index - 1) }));
+    setNavigation((current) => ({ ...current, index: nextHistoryIndex(current, -1) }));
   };
 
   const goForward = () => {
-    setNavigation((current) => ({ ...current, index: Math.min(current.entries.length - 1, current.index + 1) }));
+    setNavigation((current) => ({ ...current, index: nextHistoryIndex(current, 1) }));
   };
 
   useEffect(() => {

package/packages/gui-web/src/AppNavigation.tsx

@@ -145,7 +145,7 @@ export function Sidebar({ activeSurface, accentHue, conversationMode, fontPrefer
 
   return (
     <aside className="app-sidebar" aria-label={text.navigationLabel}>
-      <SidebarHeader setShellMode={setShellMode} shellMode={shellMode} />
+      <SidebarHeader setActiveSurface={setActiveSurface} setShellMode={setShellMode} shellMode={shellMode} />
       <nav className="sidebar-content">
         {shellMode === "devices" ? <>
           <SidebarModeTabs mode={sidebarMode} setMode={(mode) => setSidebarMode(mode as SidebarMode)} />
@@ -357,17 +357,18 @@ function SidebarItem({ activeSurface, item, recordCount, setActiveSurface, showC
   );
 }
 
-function SidebarHeader({ setShellMode, shellMode }: {
+function SidebarHeader({ setActiveSurface, setShellMode, shellMode }: {
+  setActiveSurface: (surface: SurfaceId) => void;
   setShellMode: (mode: ShellMode) => void;
   shellMode: ShellMode;
 }) {
   return (
     <header className="sidebar-header">
       <div className="sidebar-titlebar">
-        <div className="brand-lockup">
+        <button className="brand-lockup" onClick={() => setActiveSurface(dashboardNavItem.id)} title="Return to dashboard" type="button">
           <span className="terminal-mark" aria-hidden="true">›_</span>
           <strong>{text.aidevops}</strong>
-        </div>
+        </button>
         <IconSwitch
           ariaLabel="Navigation scope"
           options={[
@@ -501,14 +502,25 @@ function SidebarFooter({ accentHue, fontPreference, fontSizePreference, setAccen
               id="font-size-slider"
               max={fontSizeOptions.length - 1}
               min="0"
-              onChange={(event) => setFontSizePreference(fontSizeOptions[Number.parseInt(event.currentTarget.value, 10)]?.value ?? "m")}
+              onChange={(event) => setFontSizePreference(fontSizeOptions[Number.parseInt(event.currentTarget.value, 10)]?.value ?? "xs")}
               step="1"
               type="range"
               value={fontSizeIndex}
             />
-            <div className="range-labels" aria-hidden="true">
-              {fontSizeOptions.map((option) => <span className={option.value === fontSizePreference ? "active" : ""} key={option.value}>{option.label}</span>)}
-            </div>
+            <fieldset className="range-labels">
+              <legend className="sr-only">Font size shortcuts</legend>
+              {fontSizeOptions.map((option) => (
+                <button
+                  aria-pressed={option.value === fontSizePreference}
+                  className={option.value === fontSizePreference ? "active" : ""}
+                  key={option.value}
+                  onClick={() => setFontSizePreference(option.value)}
+                  type="button"
+                >
+                  {option.label}
+                </button>
+              ))}
+            </fieldset>
           </div>
           <div className="font-control">
             <span id="appearance-font-selector-label">{text.font}</span>

package/packages/gui-web/src/InventorySurfaces.tsx

@@ -1,5 +1,5 @@
 import type { GuiAppActionId, GuiAppActionJobSummary, GuiManagedAppSummary, GuiResponseEnvelope, GuiStatusData } from "@aidevops/gui-shared";
-import { type Dispatch, type MouseEvent as ReactMouseEvent, type ReactElement, type ReactNode, type SetStateAction, useEffect, useRef, useState } from "react";
+import { type CSSProperties, type Dispatch, type FocusEvent as ReactFocusEvent, type MouseEvent as ReactMouseEvent, type PointerEvent as ReactPointerEvent, type ReactElement, type ReactNode, type SetStateAction, useEffect, useRef, useState } from "react";
 import type { IconType } from "react-icons";
 import { FaApple, FaLinux, FaWindows } from "react-icons/fa";
 import { FiChevronDown, FiCode, FiDownload, FiExternalLink, FiGlobe, FiMonitor, FiRefreshCw, FiRepeat, FiTerminal, FiTrash2, FiX } from "react-icons/fi";
@@ -24,18 +24,20 @@ export function AppsSurface({ status }: { status: GuiStatusData }): ReactElement
   const [expandedAppId, setExpandedAppId] = useState<string | null>(() => sortedManagedApps(status.managed_apps).find((app) => managedCategoryForApp(app) === "core")?.id ?? null);
   const [jobs, setJobs] = useState<Record<string, GuiAppActionJobSummary>>({});
   const [dismissedJobIds, setDismissedJobIds] = useState<Set<string>>(() => new Set());
+  const [tooltip, setTooltip] = useState<AppTooltipState | null>(null);
   const [policyJobs, setPolicyJobs] = useState<Record<string, GuiAppActionJobSummary[]>>({});
   const [policyToggles, setPolicyToggles] = useState<ManagedPolicyToggleState>(() => readManagedPolicyToggles());
   const selectedJob = selectedJobId === null ? null : jobs[selectedJobId] ?? null;
   const managedApps = sortedManagedApps(status.managed_apps).map((app) => applyManagedPolicyToggles(app, policyToggles[app.id]));
   const visibleManagedApps = managedApps.filter((app) => managedCategoryForApp(app) === managedCategory);
+  const firstVisibleManagedAppId = visibleManagedApps[0]?.id ?? null;
   const visibleRecommendedApps = recommendedApps.filter((app) => recommendedAppMatchesFilters(app, recommendedPlatform, recommendedOs));
   const selectRecommendedPlatform = (value: RecommendedPlatformFilterId) => setRecommendedPlatform((current) => nextRecommendedFilterValue(current, value, "all"));
   const selectRecommendedOs = (value: RecommendedOsId) => setRecommendedOs((current) => nextRecommendedFilterValue(current, value, "all"));
 
   useEffect(() => {
-    setExpandedAppId(visibleManagedApps[0]?.id ?? null);
-  }, [managedCategory, status.managed_apps]);
+    setExpandedAppId(firstVisibleManagedAppId);
+  }, [firstVisibleManagedAppId]);
 
   const runningJobIdsKey = Object.values(jobs).filter((job) => job.status === "running").map((job) => job.id).sort().join("|");
 
@@ -57,7 +59,7 @@ export function AppsSurface({ status }: { status: GuiStatusData }): ReactElement
   }, [runningJobIdsKey]);
 
   return (
-    <section className="apps-surface" aria-label={text.apps}>
+    <section className="apps-surface" aria-label={text.apps} onBlur={() => setTooltip(null)} onFocus={showFocusedAppTooltip(setTooltip)} onPointerLeave={() => setTooltip(null)} onPointerMove={showPointedAppTooltip(setTooltip)}>
       <div className="section-heading">
         <p className="eyebrow">{text.infrastructure}</p>
         <h2>{text.apps}</h2>
@@ -103,6 +105,7 @@ export function AppsSurface({ status }: { status: GuiStatusData }): ReactElement
         </div>
         <p className="empty-state compact-notice">Install/update actions run as allowlisted background jobs and stream inside each app panel. xterm.js with a node-pty bridge is the right next step for full TUI apps such as OpenCode; this view starts with non-interactive command logs.</p>
       </> : <RecommendedAppsSurface apps={visibleRecommendedApps} os={recommendedOs} platform={recommendedPlatform} setOs={selectRecommendedOs} setPlatform={selectRecommendedPlatform} />}
+      {tooltip === null ? null : <AppTooltip tooltip={tooltip} />}
     </section>
   );
 }
@@ -151,7 +154,8 @@ function ManagedAppPanel({ app, dismissedJobIds, expanded, job, onDismissJob, on
 }
 
 function SummaryChip({ label, value }: { label: string; value: string }): ReactElement {
-  return <span className="managed-summary-chip"><small>{label}</small><span>{value}</span></span>;
+  const tooltip = `${label}: ${value}`;
+  return <span className="managed-summary-chip" data-tooltip={tooltip} title={tooltip}><small>{label}</small><span>{value}</span></span>;
 }
 
 function OriginLink({ href, label }: { href: string; label: string }): ReactElement {
@@ -159,7 +163,7 @@ function OriginLink({ href, label }: { href: string; label: string }): ReactElem
     return <span className="origin-missing">{label}: source pending</span>;
   }
 
-  return <a href={href} onClick={(event) => openExternalLink(event, href)} rel="noreferrer" target="_blank" title={href}>{label} <FiExternalLink aria-hidden="true" /></a>;
+  return <a data-tooltip={href} href={href} onClick={(event) => openExternalLink(event, href)} rel="noreferrer" target="_blank" title={href}>{label} <FiExternalLink aria-hidden="true" /></a>;
 }
 
 function ToggleSwitch({ checked, disabled = false, label, onChange }: { checked: boolean; disabled?: boolean; label: string; onChange: (checked: boolean) => void }): ReactElement {
@@ -218,7 +222,7 @@ function AppActionTerminal({ job, onDismiss }: { job: GuiAppActionJobSummary; on
     if (outputRef.current !== null) {
       outputRef.current.scrollTop = outputRef.current.scrollHeight;
     }
-  }, [job.output]);
+  }, [job.output.length]);
 
   return (
     <section className="app-terminal" id={`app-job-${job.id}`} aria-label="App action terminal output">
@@ -594,17 +598,70 @@ function writeManagedPolicyToggles(policy: ManagedPolicyToggleState): void {
   window.localStorage.setItem("aidevops-gui-managed-app-policy", JSON.stringify(policy));
 }
 
+interface AppTooltipState {
+  text: string;
+  x: number;
+  y: number;
+}
+
+function showPointedAppTooltip(setTooltip: Dispatch<SetStateAction<AppTooltipState | null>>) {
+  return (event: ReactPointerEvent<HTMLElement>) => {
+    const target = tooltipTarget(event.target);
+    setTooltip(target === null ? null : tooltipForElement(target));
+  };
+}
+
+function showFocusedAppTooltip(setTooltip: Dispatch<SetStateAction<AppTooltipState | null>>) {
+  return (event: ReactFocusEvent<HTMLElement>) => {
+    const target = tooltipTarget(event.target);
+    if (target !== null) {
+      setTooltip(tooltipForElement(target));
+    }
+  };
+}
+
+function tooltipTarget(target: EventTarget): HTMLElement | null {
+  return target instanceof HTMLElement ? target.closest<HTMLElement>("[data-tooltip]") : null;
+}
+
+function tooltipForElement(element: HTMLElement): AppTooltipState | null {
+  const textValue = element.dataset.tooltip;
+  if (textValue === undefined || textValue.length === 0) {
+    return null;
+  }
+
+  const rect = element.getBoundingClientRect();
+  return { text: textValue, x: rect.left + (rect.width / 2), y: rect.top };
+}
+
+function AppTooltip({ tooltip }: { tooltip: AppTooltipState }): ReactElement {
+  const style = {
+    "--tooltip-x": `${tooltip.x}px`,
+    "--tooltip-y": `${tooltip.y}px`,
+  } as CSSProperties;
+
+  return <div className="app-global-tooltip" role="tooltip" style={style}>{tooltip.text}</div>;
+}
+
 function openExternalLink(event: ReactMouseEvent<HTMLAnchorElement>, href: string): void {
   event.stopPropagation();
   if (event.defaultPrevented || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
     return;
   }
 
+  event.preventDefault();
+  if (document.documentElement.dataset.desktopShell === "macos") {
+    window.location.assign(href);
+    return;
+  }
+
   const opened = window.open(href, "_blank", "noopener,noreferrer");
   if (opened !== null) {
-    event.preventDefault();
     opened.opener = null;
+    return;
   }
+
+  window.location.assign(href);
 }
 
 export function InstallationSurface(): ReactElement {

package/packages/gui-web/src/app-model.ts

@@ -303,15 +303,15 @@ export const text = {
 } as const;
 
 export const DEFAULT_ACCENT_HUE = 123;
-export const DEFAULT_FONT: FontPreference = "Menlo";
-export const DEFAULT_FONT_SIZE: FontSizePreference = "m";
+export const DEFAULT_FONT: FontPreference = "Inter";
+export const DEFAULT_FONT_SIZE: FontSizePreference = "xs";
 
 export const fontOptions: FontOption[] = [
   { value: "IBM Plex Mono", label: "IBM Plex Mono", fontFamily: '"IBM Plex Mono", Menlo, Monaco, Consolas, monospace' },
   { value: "IBM Plex Sans", label: "IBM Plex Sans", fontFamily: '"IBM Plex Sans", Inter, system-ui, sans-serif' },
   { value: "IBM Plex Serif", label: "IBM Plex Serif", fontFamily: '"IBM Plex Serif", Georgia, serif' },
-  { value: "Inter", label: "Inter", fontFamily: 'Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' },
-  { value: "Menlo", label: "Menlo (default)", fontFamily: 'Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace' },
+  { value: "Inter", label: "Inter (default)", fontFamily: 'Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' },
+  { value: "Menlo", label: "Menlo", fontFamily: 'Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace' },
   { value: "Playpen Sans", label: "Playpen Sans", fontFamily: '"Playpen Sans", "Comic Sans MS", Inter, system-ui, sans-serif' },
   { value: "Poppins", label: "Poppins", fontFamily: 'Poppins, Inter, system-ui, sans-serif' },
   { value: "Source Sans", label: "Source Sans", fontFamily: '"Source Sans 3", "Source Sans Pro", "Source Sans", Inter, system-ui, sans-serif' },
@@ -543,11 +543,11 @@ export function getSystemTheme(): "light" | "dark" {
 }
 
 export function fontFamilyForPreference(font: FontPreference): string {
-  return fontOptions.find((option) => option.value === font)?.fontFamily ?? fontOptions.find((option) => option.value === DEFAULT_FONT)?.fontFamily ?? "Menlo, monospace";
+  return fontOptions.find((option) => option.value === font)?.fontFamily ?? fontOptions.find((option) => option.value === DEFAULT_FONT)?.fontFamily ?? "Inter, system-ui, sans-serif";
 }
 
 export function fontSizeForPreference(size: FontSizePreference): string {
-  return fontSizeOptions.find((option) => option.value === size)?.cssSize ?? fontSizeOptions.find((option) => option.value === DEFAULT_FONT_SIZE)?.cssSize ?? "16px";
+  return fontSizeOptions.find((option) => option.value === size)?.cssSize ?? fontSizeOptions.find((option) => option.value === DEFAULT_FONT_SIZE)?.cssSize ?? "14px";
 }
 
 export function isFontPreference(value: string | null): value is FontPreference {

package/packages/gui-web/src/dashboard.ts

@@ -55,7 +55,7 @@ export function renderDashboardHtml(status: GuiResponseEnvelope<GuiStatusData>):
     `<h1>aidevops app interface</h1>`,
     `<p>Made for creators.</p>`,
     `<p>AI-assisted development workflows, code quality, and deployment automation.</p>`,
-    `<p>Theme follows system preferences with light and dark overrides. Sidebar modes: DevOps and Comms. Appearance controls can be hidden or shown, and include editable Hue, icon Reset, Show borders toggle, Show counts toggle, Font size choices xs, s, m, lg, xl, and Font options: IBM Plex Mono, IBM Plex Sans, IBM Plex Serif, Inter, Menlo (default), Playpen Sans, Poppins, Source Sans, Source Serif, Tilt Neon, Ubuntu Mono. The workspace header includes a command palette, reserved signposts/help slot immediately left of notifications, notifications menu, AI Assistant panel, and profile menu with Settings, Theme, Language, Community, Admin, and Logout entries. Notifications reuse the OpenCode toast status cache and GUI readiness data. A desktop status bar shows local readiness, repo totals, secret reference count, provider accounts, and update state.</p>`,
+    `<p>Theme follows system preferences with light and dark overrides. Sidebar modes: DevOps and Comms. Appearance controls can be hidden or shown, and include editable Hue, icon Reset, Show borders toggle, Show counts toggle, Font size choices xs, s, m, lg, xl, and Font options: IBM Plex Mono, IBM Plex Sans, IBM Plex Serif, Inter (default), Menlo, Playpen Sans, Poppins, Source Sans, Source Serif, Tilt Neon, Ubuntu Mono. The workspace header includes a command palette, reserved signposts/help slot immediately left of notifications, notifications menu, AI Assistant panel, and profile menu with Settings, Theme, Language, Community, Admin, and Logout entries. Notifications reuse the OpenCode toast status cache and GUI readiness data. A desktop status bar shows local readiness, repo totals, secret reference count, provider accounts, and update state.</p>`,
     `<p>Secret references stay read-only and redacted.</p>`,
     `<p>Vault surfaces show padlock indicators. Encrypted by aidevops Vault; contents visible only when unlocked through app or authorised vault commands.</p>`,
     `<p>${escapeHtml(status.data.update.message)}</p>`,

package/packages/gui-web/src/navigation-history.ts

@@ -0,0 +1,49 @@
+import { type Dispatch, type SetStateAction, useEffect } from "react";
+import type { SurfaceId } from "./app-model";
+
+export interface NavigationHistory {
+  entries: SurfaceId[];
+  index: number;
+}
+
+export function nextHistoryIndex(current: NavigationHistory, direction: -1 | 1): number {
+  return Math.min(Math.max(0, current.entries.length - 1), Math.max(0, current.index + direction));
+}
+
+export function useNavigationHistoryKeyboard(setNavigation: Dispatch<SetStateAction<NavigationHistory>>): void {
+  useEffect(() => {
+    const navigateHistoryWithKeyboard = (event: globalThis.KeyboardEvent) => {
+      if (shouldIgnoreHistoryShortcut(event)) {
+        return;
+      }
+
+      const direction = historyShortcutDirection(event.key);
+      if (direction === null) {
+        return;
+      }
+
+      event.preventDefault();
+      setNavigation((current) => ({ ...current, index: nextHistoryIndex(current, direction) }));
+    };
+
+    window.addEventListener("keydown", navigateHistoryWithKeyboard);
+
+    return () => window.removeEventListener("keydown", navigateHistoryWithKeyboard);
+  }, [setNavigation]);
+}
+
+function shouldIgnoreHistoryShortcut(event: globalThis.KeyboardEvent): boolean {
+  return !(event.metaKey || event.ctrlKey) || isEditableKeyboardTarget(event.target) || isEditableKeyboardTarget(document.activeElement);
+}
+
+function historyShortcutDirection(key: string): -1 | 1 | null {
+  return key === "[" ? -1 : key === "]" ? 1 : null;
+}
+
+function isEditableKeyboardTarget(target: EventTarget | null): boolean {
+  if (typeof HTMLElement === "undefined" || !(target instanceof HTMLElement)) {
+    return false;
+  }
+
+  return target.isContentEditable || target.closest("input, textarea, select, [contenteditable], [role='textbox']") !== null;
+}

package/packages/gui-web/src/styles.css

@@ -10,8 +10,8 @@
   --border-hover: color-mix(in srgb, rgb(0 0 0 / 24%) 64%, rgb(255 255 255 / 48%));
   --code-bg: hsl(var(--accent-hue) 55% 91%);
   --desktop-titlebar-height: 0px;
-  --font-family-app: Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
-  --font-size-app: 16px;
+  --font-family-app: Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --font-size-app: 14px;
   --glass-panel-shadow: inset 0 1px 0 rgb(255 255 255 / 58%), inset 0 -1px 0 rgb(0 0 0 / 3%), var(--shadow-soft);
   --notification-error-bg: rgb(207 34 46 / 10%);
   --notification-error-fg: #cf222e;
@@ -119,7 +119,7 @@ code {
 .app-shell {
   display: grid;
   column-gap: 8px;
-  grid-template-columns: 72px var(--sidebar-width, 302px) 8px minmax(0, 1fr);
+  grid-template-columns: 72px var(--sidebar-width, 302px) 6px minmax(0, 1fr);
   grid-template-rows: minmax(0, 1fr) auto;
   height: 100vh;
   padding: calc(var(--shell-gutter) + var(--desktop-titlebar-height)) var(--shell-gutter) var(--shell-gutter);
@@ -127,7 +127,7 @@ code {
 }
 
 .app-shell.machine-rail-collapsed {
-  grid-template-columns: var(--sidebar-width, 302px) 8px minmax(0, 1fr);
+  grid-template-columns: var(--sidebar-width, 302px) 6px minmax(0, 1fr);
 }
 
 .desktop-titlebar-tagline {
@@ -296,10 +296,19 @@ code {
 }
 
 .brand-lockup {
+  background: transparent;
+  border: 0;
+  color: var(--text-primary);
   gap: 12px;
   padding: 2px 4px;
 }
 
+.brand-lockup:hover,
+.brand-lockup:focus-visible {
+  color: var(--accent);
+  outline: none;
+}
+
 .sidebar-titlebar {
   gap: 10px;
   justify-content: space-between;
@@ -819,28 +828,32 @@ code {
 }
 
 .range-labels {
+  border: 0;
   color: var(--text-muted);
   display: grid;
   font-size: 0.7rem;
   font-weight: 900;
   grid-template-columns: repeat(5, 1fr);
+  margin: 0;
+  padding: 0;
   text-transform: uppercase;
 }
 
-.range-labels span {
+.range-labels button {
+  background: transparent;
+  border: 0;
+  border-radius: 8px;
+  color: inherit;
+  font: inherit;
+  padding: 3px 0;
   text-align: center;
 }
 
-.range-labels span:first-child {
-  text-align: left;
-}
-
-.range-labels span:last-child {
-  text-align: right;
-}
-
-.range-labels .active {
+.range-labels button:hover,
+.range-labels button:focus-visible,
+.range-labels button.active {
   color: var(--accent);
+  outline: none;
 }
 
 .font-control select {
@@ -2206,7 +2219,7 @@ code {
   align-items: center;
   color: var(--text-secondary);
   display: inline-flex;
-  font-size: 0.95em;
+  font-size: 1em;
   font-weight: 800;
   gap: 4px;
   max-width: 100%;
@@ -2545,6 +2558,32 @@ button.managed-toggle:focus-visible {
   transform: translate(-50%, 0);
 }
 
+.apps-surface [data-tooltip]::after {
+  content: none;
+}
+
+.app-global-tooltip {
+  background: color-mix(in srgb, var(--surface-elevated) 94%, black);
+  border: 1px solid color-mix(in srgb, var(--accent) 36%, var(--border));
+  border-radius: 10px;
+  box-shadow: 0 18px 46px rgb(0 0 0 / 38%);
+  color: var(--text-primary);
+  font-size: 0.72rem;
+  font-weight: 700;
+  left: clamp(12px, var(--tooltip-x), calc(100vw - 12px));
+  line-height: 1.35;
+  max-width: min(440px, 72vw);
+  overflow-wrap: anywhere;
+  padding: 8px 10px;
+  pointer-events: none;
+  position: fixed;
+  text-align: left;
+  top: var(--tooltip-y);
+  transform: translate(-50%, calc(-100% - 10px));
+  width: max-content;
+  z-index: 10000;
+}
+
 .data-row,
 .editable-row {
   display: grid;

package/setup.sh

@@ -12,7 +12,7 @@ shopt -s inherit_errexit 2>/dev/null || true
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 3.29.18
+# Version: 3.29.20
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)