aidevops 3.29.42 → 3.30.0

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.42-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.30.0-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.42
+3.30.0

package/aidevops.sh

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

package/package.json

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

package/packages/gui-api/src/app.ts

@@ -122,9 +122,8 @@ export function createGuiApiApp() {
 
   app.post(PULSE_WORKERS_ACTION_ROUTE_MANIFEST.route, (context) => {
     const action = context.req.param("action") as GuiPulseWorkerActionId;
-    const actionCommand = pulseWorkerActionCommands[action];
 
-    if (actionCommand === undefined) {
+    if (!Object.hasOwn(pulseWorkerActionCommands, action)) {
       return context.json(createEnvelope({
         operation_id: PULSE_WORKERS_ACTION_ROUTE_MANIFEST.operation_id,
         source: { surface: "pulse_workers", authority: "allowlisted local command runner", path_refs: [] },
@@ -133,6 +132,7 @@ export function createGuiApiApp() {
       }), 400);
     }
 
+    const actionCommand = pulseWorkerActionCommands[action];
     const job = startPulseWorkerActionJob(action, actionCommand.command, actionCommand.target_ref, actionCommand.audit_ref);
     return context.json(createEnvelope({
       operation_id: PULSE_WORKERS_ACTION_ROUTE_MANIFEST.operation_id,
@@ -199,6 +199,7 @@ export function createGuiApiApp() {
 
 function startAppActionJob(appId: string, action: GuiAppActionId, command: string[]): GuiAppActionJobSummary {
   const now = new Date().toISOString();
+  const redactLine = createOutputLineRedactor();
   const job: GuiAppActionJobSummary = {
     id: `${Date.now()}-${Math.random().toString(36).slice(2)}`,
     app_id: appId,
@@ -219,11 +220,11 @@ function startAppActionJob(appId: string, action: GuiAppActionId, command: strin
   });
   if (child.stdout !== null) {
     const stdoutLines = readline.createInterface({ input: child.stdout, terminal: false });
-    stdoutLines.on("line", (line) => appendJobLine(job, line));
+    stdoutLines.on("line", (line) => appendJobLine(job, line, redactLine));
   }
   if (child.stderr !== null) {
     const stderrLines = readline.createInterface({ input: child.stderr, terminal: false });
-    stderrLines.on("line", (line) => appendJobLine(job, line));
+    stderrLines.on("line", (line) => appendJobLine(job, line, redactLine));
   }
   child.on("error", (error) => {
     appendJobLine(job, error.message);
@@ -240,11 +241,11 @@ function startAppActionJob(appId: string, action: GuiAppActionId, command: strin
   return job;
 }
 
-function appendJobLine(job: GuiAppActionJobSummary, line: string): void {
+function appendJobLine(job: GuiAppActionJobSummary, line: string, redactLine: (line: string) => string = redactOutputLine): void {
   if (line.length === 0) {
     return;
   }
-  job.output.push(redactOutputLine(line));
+  job.output.push(redactLine(line));
   if (job.output.length > 400) {
     job.output.splice(1, job.output.length - 400);
   }
@@ -252,6 +253,7 @@ function appendJobLine(job: GuiAppActionJobSummary, line: string): void {
 
 function startPulseWorkerActionJob(action: GuiPulseWorkerActionId, command: string[], targetRef: string, auditRef: string): GuiPulseWorkerActionJobSummary {
   const now = new Date().toISOString();
+  const redactLine = createOutputLineRedactor();
   const job: GuiPulseWorkerActionJobSummary = {
     id: `${Date.now()}-${Math.random().toString(36).slice(2)}`,
     action,
@@ -265,7 +267,7 @@ function startPulseWorkerActionJob(action: GuiPulseWorkerActionId, command: stri
     audit_ref: auditRef,
   };
   pulseWorkerActionJobs.set(job.id, job);
-  startBackgroundProcess(command, (line) => appendPulseWorkerJobLine(job, line), (code) => {
+  startBackgroundProcess(command, (line) => appendPulseWorkerJobLine(job, line, redactLine), (code) => {
     job.status = code === 0 ? "completed" : "failed";
     job.finished_at = new Date().toISOString();
     job.exit_code = code;
@@ -274,17 +276,26 @@ function startPulseWorkerActionJob(action: GuiPulseWorkerActionId, command: stri
   return job;
 }
 
-function appendPulseWorkerJobLine(job: GuiPulseWorkerActionJobSummary, line: string): void {
+function appendPulseWorkerJobLine(job: GuiPulseWorkerActionJobSummary, line: string, redactLine: (line: string) => string = redactOutputLine): void {
   if (line.length === 0) {
     return;
   }
-  job.output.push(redactOutputLine(line));
+  job.output.push(redactLine(line));
   if (job.output.length > 400) {
     job.output.splice(1, job.output.length - 400);
   }
 }
 
 function startBackgroundProcess(command: string[], appendLine: (line: string) => void, finish: (code: number) => void): void {
+  let finished = false;
+  const safeFinish = (code: number): void => {
+    if (finished) {
+      return;
+    }
+    finished = true;
+    finish(code);
+  };
+
   const child = spawn(command[0], command.slice(1), {
     cwd: process.cwd(),
     env: { ...process.env, AIDEVOPS_NON_INTERACTIVE: "true", CLICOLOR_FORCE: "1", FORCE_COLOR: "1", TERM: process.env.TERM ?? "xterm-256color" },
@@ -298,9 +309,29 @@ function startBackgroundProcess(command: string[], appendLine: (line: string) =>
   }
   child.on("error", (error) => {
     appendLine(error.message);
-    finish(127);
+    safeFinish(127);
   });
-  child.on("close", (code) => finish(code ?? 1));
+  child.on("close", (code) => safeFinish(code ?? 1));
+}
+
+export function createOutputLineRedactor(): (line: string) => string {
+  let inPrivateKeyBlock = false;
+
+  return (line: string): string => {
+    if (/-----BEGIN [A-Z ]+ PRIVATE KEY-----/.test(line)) {
+      inPrivateKeyBlock = !/-----END [A-Z ]+ PRIVATE KEY-----/.test(line);
+      return "[redacted private key]";
+    }
+
+    if (inPrivateKeyBlock) {
+      if (/-----END [A-Z ]+ PRIVATE KEY-----/.test(line)) {
+        inPrivateKeyBlock = false;
+      }
+      return "[redacted private key]";
+    }
+
+    return redactOutputLine(line);
+  };
 }
 
 function redactOutputLine(line: string): string {

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

@@ -341,6 +341,7 @@ final class DraggableTitlebarView: NSView {
 final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate, WKUIDelegate, WKScriptMessageHandler, NSMenuItemValidation, NSWindowDelegate {
     private var window: NSWindow!
     private var aboutWindow: NSWindow?
+    private var titlebarCameraButton: NSButton?
     private var titlebarToggleButton: NSButton?
     private var webView: WKWebView!
     private let apiPort = ProcessInfo.processInfo.environment["AIDEVOPS_GUI_API_PORT"] ?? "8787"
@@ -408,9 +409,22 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
             return
         }
 
+        if revealFileURL(url) {
+            return
+        }
+
         _ = openExternalURL(url)
     }
 
+    private func revealFileURL(_ url: URL) -> Bool {
+        guard url.isFileURL else {
+            return false
+        }
+
+        NSWorkspace.shared.activateFileViewerSelecting([url])
+        return true
+    }
+
     func webView(_ webView: WKWebView, decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
         guard let url = navigationAction.request.url else {
             decisionHandler(.allow)
@@ -552,7 +566,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
             return webView?.canGoBack ?? false
         case #selector(goForward(_:)):
             return webView?.canGoForward ?? false
-        case #selector(reloadPage(_:)), #selector(stopLoading(_:)), #selector(resetZoom(_:)), #selector(zoomIn(_:)), #selector(zoomOut(_:)):
+        case #selector(reloadPage(_:)), #selector(stopLoading(_:)), #selector(resetZoom(_:)), #selector(zoomIn(_:)), #selector(zoomOut(_:)), #selector(captureAppScreenshot(_:)), #selector(capturePageScreenshot(_:)):
             return webView != nil
         default:
             return true
@@ -779,11 +793,30 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
 
         overlay.addSubview(toggleButton)
         titlebarToggleButton = toggleButton
+
+        let cameraButton = NSButton(frame: .zero)
+        cameraButton.action = #selector(showScreenshotMenu(_:))
+        cameraButton.bezelStyle = .regularSquare
+        cameraButton.contentTintColor = defaultButtonAccent
+        cameraButton.image = cameraImage()
+        cameraButton.imagePosition = .imageOnly
+        cameraButton.isBordered = false
+        cameraButton.setButtonType(.momentaryChange)
+        cameraButton.target = self
+        cameraButton.toolTip = "Capture an aidevops screenshot"
+        cameraButton.translatesAutoresizingMaskIntoConstraints = false
+
+        overlay.addSubview(cameraButton)
+        titlebarCameraButton = cameraButton
         NSLayoutConstraint.activate([
             toggleButton.leadingAnchor.constraint(equalTo: overlay.leadingAnchor, constant: 92),
             toggleButton.centerYAnchor.constraint(equalTo: overlay.centerYAnchor, constant: 3.5),
             toggleButton.heightAnchor.constraint(equalToConstant: 22),
-            toggleButton.widthAnchor.constraint(equalToConstant: 22)
+            toggleButton.widthAnchor.constraint(equalToConstant: 22),
+            cameraButton.trailingAnchor.constraint(equalTo: overlay.trailingAnchor, constant: -92),
+            cameraButton.centerYAnchor.constraint(equalTo: overlay.centerYAnchor, constant: 3.5),
+            cameraButton.heightAnchor.constraint(equalToConstant: 22),
+            cameraButton.widthAnchor.constraint(equalToConstant: 22)
         ])
 
         return overlay
@@ -791,6 +824,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
 
     private func updateTitlebarAccent(hue: CGFloat) {
         let normalizedHue = min(359, max(0, hue))
+        titlebarCameraButton?.contentTintColor = accentColor(hueDegrees: normalizedHue, alpha: 0.9)
         titlebarToggleButton?.contentTintColor = accentColor(hueDegrees: normalizedHue, alpha: 0.9)
     }
 
@@ -866,10 +900,191 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
         return image
     }
 
+    private func cameraImage() -> NSImage {
+        let image = NSImage(size: NSSize(width: 20, height: 20), flipped: false) { _ in
+            let body = NSBezierPath(roundedRect: NSRect(x: 3, y: 6, width: 14, height: 10), xRadius: 2.7, yRadius: 2.7)
+            body.lineWidth = 2
+            NSColor.labelColor.setStroke()
+            body.stroke()
+
+            let prism = NSBezierPath(roundedRect: NSRect(x: 6, y: 14, width: 5, height: 2.3), xRadius: 1, yRadius: 1)
+            prism.lineWidth = 1.8
+            prism.stroke()
+
+            let lens = NSBezierPath(ovalIn: NSRect(x: 7.1, y: 8.1, width: 5.8, height: 5.8))
+            lens.lineWidth = 1.8
+            lens.stroke()
+
+            return true
+        }
+        image.isTemplate = true
+        return image
+    }
+
     @objc private func toggleMachineRail(_ sender: Any?) {
         webView.evaluateJavaScript("window.dispatchEvent(new CustomEvent('aidevops:toggle-machine-rail')); true;", completionHandler: nil)
     }
 
+    @objc private func showScreenshotMenu(_ sender: Any?) {
+        guard let button = sender as? NSButton else {
+            return
+        }
+
+        let menu = NSMenu(title: "Screenshots")
+        menu.addItem(menuItem("Screenshot App", action: #selector(captureAppScreenshot(_:)), target: self))
+        menu.addItem(menuItem("Screenshot Page", action: #selector(capturePageScreenshot(_:)), target: self))
+        menu.popUp(positioning: nil, at: NSPoint(x: 0, y: button.bounds.height + 3), in: button)
+    }
+
+    @objc private func captureAppScreenshot(_ sender: Any?) {
+        guard let contentView = window.contentView else {
+            return
+        }
+
+        let bounds = contentView.bounds
+        guard let representation = contentView.bitmapImageRepForCachingDisplay(in: bounds) else {
+            return
+        }
+
+        contentView.cacheDisplay(in: bounds, to: representation)
+        let image = NSImage(size: bounds.size)
+        image.addRepresentation(representation)
+        saveScreenshot(image: image, nameComponent: "window")
+    }
+
+    @objc private func capturePageScreenshot(_ sender: Any?) {
+        let script = """
+        (() => {
+          const el = document.querySelector('.workspace-scroll');
+          const title = document.querySelector('.header-title h1')?.textContent || document.title || 'page';
+          if (!el) return null;
+          const rect = el.getBoundingClientRect();
+          return { x: rect.left, y: rect.top, width: rect.width, height: rect.height, scrollHeight: el.scrollHeight, title, originalScrollTop: el.scrollTop };
+        })();
+        """
+
+        webView.evaluateJavaScript(script) { [weak self] result, _ in
+            guard let self = self, let info = result as? [String: Any] else {
+                return
+            }
+
+            self.captureScrollableWorkspace(info: info)
+        }
+    }
+
+    private func captureScrollableWorkspace(info: [String: Any]) {
+        guard let x = info["x"] as? NSNumber,
+              let y = info["y"] as? NSNumber,
+              let width = info["width"] as? NSNumber,
+              let height = info["height"] as? NSNumber,
+              let scrollHeight = info["scrollHeight"] as? NSNumber else {
+            return
+        }
+
+        let viewportHeight = max(1, CGFloat(height.doubleValue))
+        let contentHeight = max(viewportHeight, CGFloat(scrollHeight.doubleValue))
+        let contentWidth = max(1, CGFloat(width.doubleValue))
+        let captureRect = CGRect(x: CGFloat(x.doubleValue), y: CGFloat(y.doubleValue), width: contentWidth, height: viewportHeight)
+        let pageName = sanitizeFilenameComponent((info["title"] as? String) ?? "page")
+        let originalScrollTop = CGFloat((info["originalScrollTop"] as? NSNumber)?.doubleValue ?? 0)
+        let composite = NSImage(size: NSSize(width: contentWidth, height: contentHeight))
+        captureWorkspaceChunk(rect: captureRect, contentHeight: contentHeight, viewportHeight: viewportHeight, originalScrollTop: originalScrollTop, targetOffset: 0, pageName: pageName, composite: composite, capturedOffsets: Set<Int>())
+    }
+
+    private func captureWorkspaceChunk(rect: CGRect, contentHeight: CGFloat, viewportHeight: CGFloat, originalScrollTop: CGFloat, targetOffset: CGFloat, pageName: String, composite: NSImage, capturedOffsets: Set<Int>) {
+        let scrollScript = """
+        (() => {
+          const el = document.querySelector('.workspace-scroll');
+          if (!el) return null;
+          el.scrollTop = \(Int(targetOffset));
+          return el.scrollTop;
+        })();
+        """
+
+        webView.evaluateJavaScript(scrollScript) { [weak self] result, _ in
+            guard let self = self else {
+                return
+            }
+
+            let actualOffset = CGFloat((result as? NSNumber)?.doubleValue ?? Double(targetOffset))
+            let offsetKey = Int(actualOffset.rounded())
+            var nextCapturedOffsets = capturedOffsets
+            if capturedOffsets.contains(offsetKey) {
+                self.restoreWorkspaceScroll(originalScrollTop)
+                self.saveScreenshot(image: composite, nameComponent: pageName)
+                return
+            }
+            nextCapturedOffsets.insert(offsetKey)
+
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.08) {
+                let configuration = WKSnapshotConfiguration()
+                configuration.rect = rect
+                self.webView.takeSnapshot(with: configuration) { snapshot, _ in
+                    if let snapshot = snapshot {
+                        composite.lockFocus()
+                        snapshot.draw(in: NSRect(x: 0, y: contentHeight - actualOffset - viewportHeight, width: rect.width, height: viewportHeight), from: .zero, operation: .copy, fraction: 1)
+                        composite.unlockFocus()
+                    }
+
+                    if actualOffset + viewportHeight >= contentHeight - 1 {
+                        self.restoreWorkspaceScroll(originalScrollTop)
+                        self.saveScreenshot(image: composite, nameComponent: pageName)
+                    } else {
+                        let nextOffset = min(contentHeight - viewportHeight, actualOffset + viewportHeight)
+                        self.captureWorkspaceChunk(rect: rect, contentHeight: contentHeight, viewportHeight: viewportHeight, originalScrollTop: originalScrollTop, targetOffset: nextOffset, pageName: pageName, composite: composite, capturedOffsets: nextCapturedOffsets)
+                    }
+                }
+            }
+        }
+    }
+
+    private func restoreWorkspaceScroll(_ scrollTop: CGFloat) {
+        webView.evaluateJavaScript("document.querySelector('.workspace-scroll')?.scrollTo({ top: \(Int(scrollTop)), behavior: 'instant' }); true;", completionHandler: nil)
+    }
+
+    private func saveScreenshot(image: NSImage, nameComponent: String) {
+        guard let tiff = image.tiffRepresentation,
+              let bitmap = NSBitmapImageRep(data: tiff),
+              let data = bitmap.representation(using: .png, properties: [:]) else {
+            return
+        }
+
+        let directory = FileManager.default.homeDirectoryForCurrentUser.appendingPathComponent("Screenshots", isDirectory: true)
+        do {
+            try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
+            let fileURL = directory.appendingPathComponent("aidevops-app-screenshot-\(sanitizeFilenameComponent(nameComponent))-\(screenshotTimestamp()).png")
+            try data.write(to: fileURL, options: .atomic)
+            NSPasteboard.general.clearContents()
+            NSPasteboard.general.setString(fileURL.path, forType: .string)
+            notifyScreenshotCaptured(fileURL: fileURL)
+        } catch {
+            NSSound.beep()
+        }
+    }
+
+    private func screenshotTimestamp() -> String {
+        let formatter = DateFormatter()
+        formatter.dateFormat = "yyMMdd-HHmmss"
+        return formatter.string(from: Date())
+    }
+
+    private func sanitizeFilenameComponent(_ value: String) -> String {
+        let allowed = CharacterSet.alphanumerics.union(CharacterSet(charactersIn: "-_"))
+        let mapped = value.lowercased().unicodeScalars.map { allowed.contains($0) ? String($0) : "-" }.joined()
+        let collapsed = mapped.split(separator: "-").joined(separator: "-")
+        return collapsed.isEmpty ? "page" : collapsed
+    }
+
+    private func notifyScreenshotCaptured(fileURL: URL) {
+        guard let payloadData = try? JSONSerialization.data(withJSONObject: ["path": fileURL.path, "url": fileURL.absoluteString], options: []),
+              let payload = String(data: payloadData, encoding: .utf8) else {
+            return
+        }
+
+        let script = "window.dispatchEvent(new CustomEvent('aidevops:screenshot-captured', { detail: \(payload) })); true;"
+        webView.evaluateJavaScript(script, completionHandler: nil)
+    }
+
     private func saveMainWindowFrame() {
         guard window != nil else {
             return

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

@@ -4,7 +4,9 @@ import { MachineRail, Sidebar } from "./AppNavigation";
 import { Workspace } from "./AppWorkspace";
 import type { ContrastPreference, ConversationMode, FontPreference, FontSizePreference, ShellMode, SurfaceId, ThemePreference } from "./app-model";
 import { DEFAULT_ACCENT_HUE, DEFAULT_CONTRAST, DEFAULT_FONT, DEFAULT_FONT_SIZE, fileRootBySurface, findSurface, findSurfaceSectionLabel, fontFamilyForPreference, fontSizeForPreference, getSystemTheme, isContrastPreference, isFontPreference, isFontSizePreference } from "./app-model";
+import { DesktopStatusBar } from "./DesktopStatusBar";
 import { type NavigationHistory, nextHistoryIndex, useNavigationHistoryKeyboard } from "./navigation-history";
+import { ScreenshotCaptureNotificationHost } from "./ScreenshotCaptureNotification";
 import { fetchStatus, mockedStatus } from "./status-client";
 
 interface WebKitBridgeWindow extends Window {
@@ -214,6 +216,7 @@ export function App(): ReactElement {
   return (
     <main className={machineRailVisible ? "app-shell" : "app-shell machine-rail-collapsed"}>
       <div className="desktop-titlebar-tagline" aria-hidden="true">Your data protected. Your systems managed. Your creations published.</div>
+      <ScreenshotCaptureNotificationHost />
       {machineRailVisible ? <MachineRail machine={status.data.machine} /> : null}
       <Sidebar
         activeSurface={activeSurface}
@@ -423,29 +426,3 @@ function readStoredBoolean(storage: ReadableAppearanceStorage | undefined, key:
 
   return fallback;
 }
-
-function DesktopStatusBar({ status }: { status: GuiStatusData }): ReactElement {
-  const version = status.update.installed_version !== "unknown" ? status.update.installed_version : status.aidevops_version;
-  const versionLabel = version === "unknown" || version.startsWith("v") ? version : `v${version}`;
-  const needsUpdate = status.setup_targets.filter((target) => target.needs_update).length + status.ai_apps.filter((app) => app.needs_update).length;
-  const oauthAccounts = status.oauth_pool.providers.reduce((total, provider) => total + provider.total, 0);
-  const localRepoCount = status.local_repos.total || status.local_repos.repos.length;
-  const remoteRepoCount = status.repos.total || status.repos.repos.length;
-  const statusLabel = status.update.restart_required ? "Restart required" : "Ready";
-  const vaultLabel = status.vault?.unlocked ? "Vault unlocked" : `Vault ${status.vault?.status ?? "unknown"}`;
-
-  return (
-    <div className="desktop-status-bar" role="status">
-      <span className={status.update.restart_required ? "status-dot warn" : "status-dot"} aria-hidden="true" />
-      <strong>{statusLabel}</strong>
-      <span>Read-only local GUI</span>
-      <span>{versionLabel}</span>
-      <span>{localRepoCount} local repos</span>
-      <span>{remoteRepoCount} remote repos</span>
-      <span>{status.secrets.length} secrets</span>
-      <span>{vaultLabel}</span>
-      <span>{oauthAccounts} provider accounts</span>
-      <span>{needsUpdate} need update</span>
-    </div>
-  );
-}

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

@@ -0,0 +1,28 @@
+import type { GuiStatusData } from "@aidevops/gui-shared";
+import type { ReactElement } from "react";
+
+export function DesktopStatusBar({ status }: { status: GuiStatusData }): ReactElement {
+  const version = status.update.installed_version !== "unknown" ? status.update.installed_version : status.aidevops_version;
+  const versionLabel = version === "unknown" || version.startsWith("v") ? version : `v${version}`;
+  const needsUpdate = status.setup_targets.filter((target) => target.needs_update).length + status.ai_apps.filter((app) => app.needs_update).length;
+  const oauthAccounts = status.oauth_pool.providers.reduce((total, provider) => total + provider.total, 0);
+  const localRepoCount = status.local_repos.total || status.local_repos.repos.length;
+  const remoteRepoCount = status.repos.total || status.repos.repos.length;
+  const statusLabel = status.update.restart_required ? "Restart required" : "Ready";
+  const vaultLabel = status.vault?.unlocked ? "Vault unlocked" : `Vault ${status.vault?.status ?? "unknown"}`;
+
+  return (
+    <div className="desktop-status-bar" role="status">
+      <span className={status.update.restart_required ? "status-dot warn" : "status-dot"} aria-hidden="true" />
+      <strong>{statusLabel}</strong>
+      <span>Read-only local GUI</span>
+      <span>{versionLabel}</span>
+      <span>{localRepoCount} local repos</span>
+      <span>{remoteRepoCount} remote repos</span>
+      <span>{status.secrets.length} secrets</span>
+      <span>{vaultLabel}</span>
+      <span>{oauthAccounts} provider accounts</span>
+      <span>{needsUpdate} need update</span>
+    </div>
+  );
+}

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

@@ -16,7 +16,7 @@ function DevOpsCard({ validation }: { validation: GuiTamboValidationResult }) {
   const entries = Object.entries(props).filter(([key]) => key !== "title" && key !== "disabled");
 
   return (
-    <section className="genui-card" data-genui-component={validation.component ?? "unknown"} aria-label={`${validation.component} ${text.devOpsCard}`}>
+    <section className="genui-card" data-genui-component={validation.component ?? "unknown"} aria-label={`${validation.component ?? "unknown"} ${text.devOpsCard}`}>
       <header>
         <p className="eyebrow">{text.tamboGenUiReadOnly}</p>
         <h3>{stringProp(props.title) ?? validation.component}</h3>

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

@@ -266,7 +266,10 @@ function PulseDrilldownPanel({ event }: { event: PulseEvent | undefined }): Reac
 }
 
 function relatedFindings(event: PulseEvent): string[] {
-  return event.drilldown_sections?.filter((section) => section.label.toLowerCase().includes("systemic") || section.label.toLowerCase().includes("verification")).map((section) => `${section.label}: ${section.body}`) ?? [];
+  return event.drilldown_sections?.filter((section) => {
+    const label = section.label?.toLowerCase();
+    return label?.includes("systemic") || label?.includes("verification");
+  }).map((section) => `${section.label}: ${section.body}`) ?? [];
 }
 
 function buildFilterGroups(pulse: GuiStatusData["pulse_workers"]): PulseFilterGroup[] {

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

@@ -0,0 +1,51 @@
+import { type ReactElement, useEffect, useState } from "react";
+
+export interface ScreenshotCapturedDetail {
+  path: string;
+  url: string;
+}
+
+interface WebKitExternalLinkWindow extends Window {
+  webkit?: {
+    messageHandlers?: {
+      externalLink?: {
+        postMessage: (href: string) => void;
+      };
+    };
+  };
+}
+
+export function ScreenshotCaptureNotification({ notification, onDismiss }: { notification: ScreenshotCapturedDetail; onDismiss: () => void }): ReactElement {
+  const revealScreenshot = () => {
+    const webkit = (window as WebKitExternalLinkWindow).webkit;
+    webkit?.messageHandlers?.externalLink?.postMessage(notification.url);
+  };
+
+  return (
+    <div className="screenshot-capture-notification" role="status">
+      <div>
+        <strong>Screenshot captured</strong>
+        <span>Saved to <button onClick={revealScreenshot} type="button">{notification.path}</button>; path copied to clipboard.</span>
+      </div>
+      <button aria-label="Dismiss screenshot notification" onClick={onDismiss} type="button">×</button>
+    </div>
+  );
+}
+
+export function ScreenshotCaptureNotificationHost(): ReactElement | null {
+  const [screenshotNotification, setScreenshotNotification] = useState<ScreenshotCapturedDetail | undefined>();
+
+  useEffect(() => {
+    const showScreenshotNotification = (event: Event) => {
+      const detail = (event as CustomEvent<Partial<ScreenshotCapturedDetail>>).detail;
+      if (detail !== undefined && typeof detail.path === "string" && typeof detail.url === "string") {
+        setScreenshotNotification({ path: detail.path, url: detail.url });
+      }
+    };
+
+    window.addEventListener("aidevops:screenshot-captured", showScreenshotNotification);
+    return () => window.removeEventListener("aidevops:screenshot-captured", showScreenshotNotification);
+  }, []);
+
+  return screenshotNotification ? <ScreenshotCaptureNotification notification={screenshotNotification} onDismiss={() => setScreenshotNotification(undefined)} /> : null;
+}

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

@@ -218,7 +218,7 @@ body {
 }
 
 :root[data-theme="dark"] body {
-  background:
+  background-image:
     radial-gradient(ellipse 78% 64% at top left,
       hsl(var(--accent-hue) 96% 22% / 62%) 0%,
       hsl(var(--accent-hue) 92% 18% / 34%) 34%,
@@ -298,6 +298,68 @@ code {
   z-index: 20;
 }
 
+.screenshot-capture-notification {
+  align-items: center;
+  background: color-mix(in srgb, var(--surface-elevated) 94%, transparent);
+  border: 1px solid var(--border-accent);
+  border-radius: 999px;
+  box-shadow: var(--glass-panel-shadow);
+  color: var(--text-secondary);
+  display: flex;
+  gap: 12px;
+  left: 50%;
+  max-width: min(720px, calc(100vw - 48px));
+  padding: 8px 10px 8px 14px;
+  position: fixed;
+  top: calc(var(--desktop-titlebar-height) + 10px);
+  transform: translateX(-50%);
+  z-index: 40;
+}
+
+.screenshot-capture-notification > div {
+  display: grid;
+  gap: 1px;
+  min-width: 0;
+}
+
+.screenshot-capture-notification strong {
+  color: var(--text-primary);
+  font-size: 0.78rem;
+  line-height: 1.2;
+}
+
+.screenshot-capture-notification span {
+  font-size: 0.74rem;
+  line-height: 1.25;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.screenshot-capture-notification button {
+  background: transparent;
+  border: 0;
+  color: var(--accent);
+  font: inherit;
+  padding: 0;
+  text-decoration: underline;
+}
+
+.screenshot-capture-notification > button {
+  align-items: center;
+  background: var(--surface-muted);
+  border: 1px solid transparent;
+  border-radius: 999px;
+  color: var(--text-secondary);
+  display: inline-flex;
+  flex: 0 0 auto;
+  font-size: 1rem;
+  height: 24px;
+  justify-content: center;
+  line-height: 1;
+  width: 24px;
+}
+
 .machine-rail,
 .app-sidebar,
 .app-inset {

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.42
+# Version: 3.30.0
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)