aidevops 3.29.0 → 3.29.2

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

package/aidevops.sh

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

package/package.json

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

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

@@ -35,6 +35,14 @@ const appActionJobs = new Map<string, GuiAppActionJobSummary>();
 export function createGuiApiApp() {
   const app = new Hono();
 
+  app.get("/api/health", (context) => {
+    return context.json(createEnvelope({
+      operation_id: "capabilities.read",
+      source: { surface: "health", authority: "in-process readiness probe", path_refs: [] },
+      data: { status: "ok", service: "aidevops-gui-api" },
+    }));
+  });
+
   app.get(STATUS_ROUTE_MANIFEST.route, (context) => {
     return context.json(readStatus());
   });

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

@@ -134,7 +134,7 @@ export function readBinaryVersion(binaryPath: string, args: string[]): string {
     const output = execFileSync(binaryPath, args, {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
-      timeout: 500,
+      timeout: 150,
     }).trim();
     return output.split("\n").find((line) => line.length > 0) ?? "unknown";
   } catch {

package/packages/gui-api/src/status-vault.ts

@@ -63,7 +63,7 @@ function readVaultCommand<T extends string>(
     const output = execFileSync("sh", [helperPath, ...args], {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"],
-      timeout: 1_000,
+      timeout: 300,
     }).trim();
     const firstLine = output.split(/\r?\n/).find((line) => line.trim().length > 0)?.trim() ?? "";
     return isAllowed(firstLine) ? firstLine : null;

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

@@ -135,6 +135,8 @@ set -euo pipefail
 REPO_ROOT="${root}"
 API_PORT="\${AIDEVOPS_GUI_API_PORT:-8787}"
 WEB_PORT="\${AIDEVOPS_GUI_WEB_PORT:-5173}"
+API_HEALTH_URL="http://127.0.0.1:\${API_PORT}/api/health"
+WEB_HEALTH_URL="http://127.0.0.1:\${WEB_PORT}/"
 LOG_DIR="\${HOME}/Library/Logs/aidevops-gui"
 LAUNCHER_LOG="\${LOG_DIR}/launcher.log"
 BUN_BIN=""
@@ -223,20 +225,18 @@ replace_stale_gui_on_port() {
   local pid=""
   local cwd=""
 
-  if ! url_ready "\${health_url}"; then
-    return 0
+  if url_ready "\${health_url}"; then
+    while IFS= read -r pid; do
+      if [[ -z "\${pid}" ]]; then
+        continue
+      fi
+      cwd="\$(pid_cwd "\${pid}" || true)"
+      if [[ "\${cwd}" == "\${REPO_ROOT}" ]]; then
+        return 0
+      fi
+    done < <(port_pids "\${port}")
   fi
 
-  while IFS= read -r pid; do
-    if [[ -z "\${pid}" ]]; then
-      continue
-    fi
-    cwd="\$(pid_cwd "\${pid}" || true)"
-    if [[ "\${cwd}" == "\${REPO_ROOT}" ]]; then
-      return 0
-    fi
-  done < <(port_pids "\${port}")
-
   while IFS= read -r pid; do
     if [[ -z "\${pid}" ]]; then
       continue
@@ -274,16 +274,6 @@ stop_gui_services() {
   return 0
 }
 
-api_contract_current() {
-  local payload=""
-
-  payload="\$(curl --silent --fail --max-time 2 "http://127.0.0.1:\${API_PORT}/api/status" 2>/dev/null || true)"
-  if [[ "\${payload}" == *'"local_repos"'* && "\${payload}" == *'"oauth_pool"'* ]]; then
-    return 0
-  fi
-  return 1
-}
-
 if [[ "\${MODE}" == "stop" ]]; then
   stop_gui_services
   exit 0
@@ -297,36 +287,33 @@ if [[ -f "\${HOME}/.aidevops/agents/VERSION" && -f "\${REPO_ROOT}/VERSION" ]]; t
   fi
 fi
 
-replace_stale_gui_on_port "\${API_PORT}" "http://127.0.0.1:\${API_PORT}/api/status"
-replace_stale_gui_on_port "\${WEB_PORT}" "http://127.0.0.1:\${WEB_PORT}/"
-if url_ready "http://127.0.0.1:\${API_PORT}/api/status" && ! api_contract_current; then
-  kill_gui_on_port_for_repo "\${API_PORT}"
-  kill_gui_on_port_for_repo "\${WEB_PORT}"
-fi
+replace_stale_gui_on_port "\${API_PORT}" "\${API_HEALTH_URL}"
+replace_stale_gui_on_port "\${WEB_PORT}" "\${WEB_HEALTH_URL}"
 sleep 1
 
-if ! url_ready "http://127.0.0.1:\${API_PORT}/api/status" || ! url_ready "http://127.0.0.1:\${WEB_PORT}/"; then
+if ! url_ready "\${API_HEALTH_URL}" || ! url_ready "\${WEB_HEALTH_URL}"; then
   require_bun
 fi
 
-if ! url_ready "http://127.0.0.1:\${API_PORT}/api/status"; then
+if ! url_ready "\${API_HEALTH_URL}"; then
   nohup env AIDEVOPS_GUI_API_PORT="\${API_PORT}" "\${BUN_BIN}" run packages/gui-api/src/server.ts >"\${LOG_DIR}/api.log" 2>&1 &
 fi
-if ! url_ready "http://127.0.0.1:\${WEB_PORT}/"; then
+if ! url_ready "\${WEB_HEALTH_URL}"; then
   nohup "\${BUN_BIN}" ./node_modules/vite/bin/vite.js --config packages/gui-web/vite.config.ts --host 127.0.0.1 --port "\${WEB_PORT}" >"\${LOG_DIR}/web.log" 2>&1 &
 fi
 
-if ! wait_for_url "http://127.0.0.1:\${API_PORT}/api/status" 20 1; then
+if ! wait_for_url "\${API_HEALTH_URL}" 20 0.25; then
   printf 'aidevops GUI API did not become ready. Check %s/api.log.\n' "\${LOG_DIR}" >"\${LAUNCHER_LOG}"
   notify "aidevops GUI API did not become ready. Check \${LOG_DIR}/api.log."
   exit 1
 fi
-if ! wait_for_url "http://127.0.0.1:\${WEB_PORT}/" 30 1; then
+if ! wait_for_url "\${WEB_HEALTH_URL}" 30 0.25; then
   printf 'aidevops GUI web did not become ready. Check %s/web.log.\n' "\${LOG_DIR}" >"\${LAUNCHER_LOG}"
   notify "aidevops GUI web did not become ready. Check \${LOG_DIR}/web.log."
   exit 1
 fi
 
+printf 'aidevops GUI services ready: API %s, web %s\n' "\${API_HEALTH_URL}" "\${WEB_HEALTH_URL}" >"\${LAUNCHER_LOG}"
 exit 0
 LAUNCHER
   chmod 755 "$helper_path"
@@ -362,6 +349,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
     private let mainWindowFrameAutosaveName = "aidevops-main-window"
     private let titlebarHeight: CGFloat = 24
     private let serviceQueue = DispatchQueue(label: "sh.aidevops.gui.services")
+    private var hasLoadedDashboard = false
     private var servicesStopped = false
 
     func applicationDidFinishLaunching(_ notification: Notification) {
@@ -604,7 +592,9 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
     @objc private func openDashboard(_ sender: Any?) {
         window.makeKeyAndOrderFront(nil)
         NSApp.activate(ignoringOtherApps: true)
-        loadAppURL()
+        if !hasLoadedDashboard {
+            loadAppURL()
+        }
     }
 
     @objc private func hideWindow(_ sender: Any?) {
@@ -895,12 +885,27 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
             loadStatusHTML(title: "Invalid aidevops URL", detail: "The configured web port is not valid: \(webPort)")
             return
         }
+        hasLoadedDashboard = true
         webView.load(URLRequest(url: url))
     }
 
     private func loadStatusHTML(title: String, detail: String) {
         let escapedTitle = escapeHTML(title)
         let escapedDetail = escapeHTML(detail).replacingOccurrences(of: "\n", with: "<br>")
+        let contentHTML: String
+        if title == "Starting aidevops" {
+            contentHTML = """
+            <main class="shell" aria-busy="true" aria-label="Loading aidevops interface">
+              <section class="brand" aria-label="Starting aidevops"><strong><span>aidevops</span><b>&gt;</b><em>_</em></strong><small>Preparing local GUI</small></section>
+              <aside class="rail panel"><i></i><i></i><i></i><i></i><i></i><i></i></aside>
+              <aside class="sidebar panel"><header><b></b><span></span></header><nav><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></nav><footer><i></i><i></i></footer></aside>
+              <section class="workspace panel"><header><b></b><span></span><i></i><i></i></header><article><h1>\(escapedTitle)</h1><p>\(escapedDetail)</p><div class="cards"><i></i><i></i><i></i><i></i><i></i><i></i></div><div class="block"></div></article></section>
+              <footer class="status"><i></i><span></span><span></span><span></span><span></span><span></span></footer>
+            </main>
+            """
+        } else {
+            contentHTML = "<main class=\"message\"><h1>\(escapedTitle)</h1><p>\(escapedDetail)</p></main>"
+        }
         let html = """
         <!doctype html>
         <html lang="en">
@@ -908,14 +913,48 @@ final class AppDelegate: NSObject, NSApplicationDelegate, WKNavigationDelegate,
           <meta charset="utf-8">
           <meta name="viewport" content="width=device-width, initial-scale=1">
           <style>
-            body { align-items: center; background: #0a0a0a; color: #f6f7f2; display: flex; font: 15px -apple-system, BlinkMacSystemFont, sans-serif; height: 100vh; justify-content: center; margin: 0; }
-            main { background: #11130f; border: 1px solid #2c3324; border-radius: 18px; max-width: 560px; padding: 28px; }
+            :root { --accent: #b2e969; --border: #2c3324; --panel: #11130f; --muted: #b9c3b0; }
+            * { box-sizing: border-box; }
+            body { background: radial-gradient(ellipse at top left, rgb(178 233 105 / 10%), transparent 34%), #0a0a0a; color: #f6f7f2; font: 15px -apple-system, BlinkMacSystemFont, sans-serif; height: 100vh; margin: 0; }
+            .message { background: var(--panel); border: 1px solid var(--border); border-radius: 18px; left: 50%; max-width: 560px; padding: 28px; position: fixed; top: 50%; transform: translate(-50%, -50%); }
             h1 { font-size: 22px; margin: 0 0 10px; }
             p { color: #b9c3b0; line-height: 1.5; margin: 0; }
             code { color: #b2e969; }
+            .shell { display: grid; gap: 8px; grid-template-columns: 72px 302px minmax(0, 1fr); grid-template-rows: minmax(0, 1fr) 30px; height: 100vh; padding: 30px 8px 8px; }
+            .brand { align-items: center; backdrop-filter: blur(18px); background: rgb(17 19 15 / 78%); border: 1px solid rgb(178 233 105 / 34%); border-radius: 24px; box-shadow: 0 24px 90px rgb(178 233 105 / 14%), 0 20px 80px rgb(0 0 0 / 35%); display: grid; gap: 10px; justify-items: center; left: 50%; padding: 26px 30px; position: fixed; top: 50%; transform: translate(-50%, -50%); width: min(360px, calc(100vw - 48px)); z-index: 20; }
+            .brand strong { align-items: baseline; display: inline-flex; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; font-size: clamp(34px, 7vw, 64px); font-weight: 900; letter-spacing: -0.08em; line-height: .9; }
+            .brand span { color: #f6f7f2; font-size: .48em; letter-spacing: -0.04em; margin-right: .18em; }
+            .brand b, .brand em { color: var(--accent); font-style: normal; }
+            .brand em { animation: cursor 0.95s steps(1, end) infinite; }
+            .brand small { color: var(--muted); font-size: 11px; font-weight: 800; letter-spacing: .1em; text-transform: uppercase; }
+            .panel, .status { background: rgb(17 19 15 / 92%); border: 1px solid var(--border); border-radius: 18px; box-shadow: inset 0 1px 0 rgb(255 255 255 / 8%); overflow: hidden; }
+            .rail { align-content: start; display: grid; gap: 10px; justify-items: center; padding: 12px 8px; }
+            .rail i, .sidebar b, .workspace b { border-radius: 12px; height: 44px; width: 44px; }
+            .sidebar { display: grid; grid-template-rows: auto 1fr auto; }
+            .sidebar header, .workspace header { align-items: center; display: flex; gap: 12px; padding: 16px; }
+            .sidebar header span { flex: 1; height: 18px; }
+            .sidebar nav, .sidebar footer, .workspace article { display: grid; gap: 12px; padding: 16px; }
+            .sidebar nav i { height: 18px; }
+            .sidebar footer { border-top: 1px solid var(--border); }
+            .workspace { display: grid; grid-template-rows: auto 1fr; }
+            .workspace header { border-bottom: 1px solid var(--border); }
+            .workspace header span { flex: 1; height: 38px; }
+            .workspace header i { border-radius: 999px; height: 34px; width: 34px; }
+            .workspace article { align-content: start; gap: 18px; }
+            .cards { display: grid; gap: 14px; grid-template-columns: repeat(3, minmax(0, 1fr)); }
+            .cards i { border-radius: 18px; height: 128px; }
+            .block { border-radius: 20px; height: 220px; }
+            .status { align-items: center; display: flex; gap: 10px; grid-column: 1 / -1; justify-content: center; padding: 0 12px; }
+            .status i { border-radius: 999px; height: 8px; width: 8px; }
+            .status span { height: 10px; width: 96px; }
+            .rail i, .sidebar b, .sidebar span, .sidebar i, .workspace b, .workspace span, .workspace i, .cards i, .block, .status i, .status span { animation: pulse 1.35s ease-in-out infinite; background: linear-gradient(90deg, #1a2116, rgb(178 233 105 / 18%), #1a2116); background-size: 220% 100%; border: 1px solid var(--border); border-radius: 999px; display: block; }
+            .block, .cards i { border-radius: 18px; }
+            @keyframes pulse { 0% { background-position: 120% 0; opacity: .52; } 50% { opacity: .95; } 100% { background-position: -120% 0; opacity: .52; } }
+            @keyframes cursor { 0%, 48% { opacity: 1; } 49%, 100% { opacity: 0; } }
+            @media (prefers-reduced-motion: reduce) { .rail i, .sidebar b, .sidebar span, .sidebar i, .workspace b, .workspace span, .workspace i, .cards i, .block, .status i, .status span, .brand em { animation: none; } }
           </style>
         </head>
-        <body><main><h1>\(escapedTitle)</h1><p>\(escapedDetail)</p></main></body>
+        <body>\(contentHTML)</body>
         </html>
         """
         webView.loadHTMLString(html, baseURL: nil)

package/packages/gui-shared/src/contracts.ts

@@ -185,6 +185,100 @@ export interface GuiOpenCodeSessionRegistrySummary {
   sessions: GuiOpenCodeSessionSummary[];
 }
 
+export type GuiConversationType = "ai_session" | "channel" | "dm" | "group_dm" | "worker_thread";
+
+export type GuiConversationParticipantKind = "human" | "ai_assistant" | "worker" | "system_bot";
+
+export type GuiConversationMessageSenderKind = GuiConversationParticipantKind | "system";
+
+export type GuiConversationMessagePartKind = "text" | "file" | "tool_call" | "source" | "tambo_component" | "approval_prompt" | "event_marker";
+
+export interface GuiConversationScope {
+  tenant_ref: string;
+  workspace_ref: string;
+  repo_ref: string | null;
+}
+
+export interface GuiConversation {
+  id: string;
+  type: GuiConversationType;
+  title: string;
+  scope: GuiConversationScope;
+  source_ref: string;
+  status: "active" | "archived" | "read_only";
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GuiConversationParticipant {
+  id: string;
+  conversation_id: string;
+  kind: GuiConversationParticipantKind;
+  display_name: string;
+  identity_ref: string | null;
+  agent_ref: string | null;
+  worker_ref: string | null;
+  membership_state: "active" | "invited" | "left" | "removed";
+  joined_at: string;
+}
+
+export interface GuiConversationUsageMetadata {
+  provider_ref: string | null;
+  model_ref: string | null;
+  input_tokens: number;
+  output_tokens: number;
+  total_tokens: number;
+  cost_ref: string | null;
+}
+
+export interface GuiConversationMessage {
+  id: string;
+  conversation_id: string;
+  sender_participant_id: string | null;
+  sender_kind: GuiConversationMessageSenderKind;
+  sequence: number;
+  status: "draft" | "sent" | "delivered" | "failed" | "redacted";
+  usage: GuiConversationUsageMetadata | null;
+  created_at: string;
+  edited_at: string | null;
+}
+
+export interface GuiConversationMessagePart {
+  id: string;
+  message_id: string;
+  kind: GuiConversationMessagePartKind;
+  ordinal: number;
+  text: string | null;
+  payload_json: Record<string, unknown> | null;
+  file_ref: string | null;
+  source_ref: string | null;
+}
+
+export interface GuiConversationReaction {
+  id: string;
+  message_id: string;
+  participant_id: string;
+  reaction: string;
+  created_at: string;
+}
+
+export interface GuiConversationReadState {
+  conversation_id: string;
+  participant_id: string;
+  last_read_message_id: string | null;
+  last_read_sequence: number;
+  updated_at: string;
+}
+
+export interface GuiConversationThread {
+  conversation: GuiConversation;
+  participants: GuiConversationParticipant[];
+  messages: GuiConversationMessage[];
+  parts: GuiConversationMessagePart[];
+  reactions: GuiConversationReaction[];
+  read_states: GuiConversationReadState[];
+}
+
 export type GuiAiProviderId = "anthropic" | "openai" | "cursor" | "google";
 
 export interface GuiOAuthPoolAccountSummary {
@@ -499,3 +593,19 @@ export function assertNoSecretSentinels(value: unknown): void {
 export function isReadOnlyManifest(manifest: GuiRouteManifest): boolean {
   return manifest.method === "GET" && manifest.classification === "read";
 }
+
+export function sortConversationMessages<TMessage extends Pick<GuiConversationMessage, "sequence" | "created_at">>(messages: TMessage[]): TMessage[] {
+  return [...messages].sort((left, right) => left.sequence - right.sequence || left.created_at.localeCompare(right.created_at));
+}
+
+export function sortConversationMessageParts<TPart extends Pick<GuiConversationMessagePart, "ordinal">>(parts: TPart[]): TPart[] {
+  return [...parts].sort((left, right) => left.ordinal - right.ordinal);
+}
+
+export function participantCanReadConversation(thread: GuiConversationThread, participantId: string): boolean {
+  return thread.participants.some((participant) => participant.id === participantId && participant.membership_state === "active");
+}
+
+export function conversationHasScope(thread: GuiConversationThread, scope: GuiConversationScope): boolean {
+  return thread.conversation.scope.tenant_ref === scope.tenant_ref && thread.conversation.scope.workspace_ref === scope.workspace_ref && thread.conversation.scope.repo_ref === scope.repo_ref;
+}

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

@@ -39,6 +39,8 @@ export const appearanceStorageKeys = {
 const defaultSidebarWidth = 302;
 const minSidebarWidth = 248;
 const maxSidebarWidth = 520;
+export const loadingSkeletonPanelLabels = ["machine rail", "sidebar", "workspace", "status bar"] as const;
+export const loadingBrandGlyph = ">_";
 
 export interface StoredAppearancePreferences {
   accentHue: number;
@@ -70,6 +72,7 @@ export function readStoredAppearancePreferences(storage: ReadableAppearanceStora
 export function App(): ReactElement {
   const [storedAppearancePreferences] = useState<StoredAppearancePreferences>(() => readStoredAppearancePreferences());
   const [status, setStatus] = useState<GuiResponseEnvelope<GuiStatusData>>(mockedStatus());
+  const [statusLoading, setStatusLoading] = useState(true);
   const [navigation, setNavigation] = useState<NavigationHistory>({ entries: ["overview"], index: 0 });
   const [themePreference, setThemePreference] = useState<ThemePreference>(storedAppearancePreferences.themePreference);
   const [accentHue, setAccentHue] = useState(storedAppearancePreferences.accentHue);
@@ -159,7 +162,8 @@ export function App(): ReactElement {
   useEffect(() => {
     fetchStatus()
       .then(setStatus)
-      .catch(() => setStatus(mockedStatus()));
+      .catch(() => setStatus(mockedStatus()))
+      .finally(() => setStatusLoading(false));
   }, []);
 
   useEffect(() => {
@@ -179,6 +183,10 @@ export function App(): ReactElement {
     setSelectedLocalRepoIndex((current) => Math.min(current, Math.max(0, status.data.local_repos.repos.length - 1)));
   }, [status.data.local_repos.repos.length]);
 
+  if (statusLoading) {
+    return <AppLoadingSkeleton machineRailVisible={machineRailVisible} />;
+  }
+
   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>
@@ -234,6 +242,67 @@ export function App(): ReactElement {
   );
 }
 
+export function AppLoadingSkeleton({ machineRailVisible }: { machineRailVisible: boolean }): ReactElement {
+  return (
+    <main className={machineRailVisible ? "app-shell app-loading-shell" : "app-shell app-loading-shell machine-rail-collapsed"} aria-busy="true" aria-label="Loading aidevops interface">
+      <div className="desktop-titlebar-tagline loading-line loading-titlebar" aria-hidden="true" />
+      <LoadingBrandOverlay />
+      {machineRailVisible ? (
+        <section className="machine-rail loading-panel" aria-label={loadingSkeletonPanelLabels[0]}>
+          {Array.from({ length: 6 }, (_, index) => <span className="loading-orb" key={index} />)}
+        </section>
+      ) : null}
+      <section className="app-sidebar loading-panel" aria-label={loadingSkeletonPanelLabels[1]}>
+        <div className="loading-sidebar-header">
+          <span className="loading-logo" />
+          <span className="loading-line loading-line-wide" />
+        </div>
+        <span className="loading-pill" />
+        <div className="loading-list">
+          {Array.from({ length: 12 }, (_, index) => <span className={index % 3 === 0 ? "loading-line loading-line-short" : "loading-line"} key={index} />)}
+        </div>
+        <div className="loading-sidebar-footer">
+          <span className="loading-pill" />
+          <span className="loading-line" />
+        </div>
+      </section>
+      <SidebarResizeHandle />
+      <section className="app-inset loading-panel" aria-label={loadingSkeletonPanelLabels[2]}>
+        <div className="workspace-header loading-workspace-header">
+          <span className="loading-icon" />
+          <span className="loading-line loading-line-wide" />
+          <span className="loading-search" />
+          <span className="loading-circle" />
+          <span className="loading-circle" />
+        </div>
+        <div className="loading-workspace-body">
+          <span className="loading-line loading-line-hero" />
+          <div className="loading-card-grid">
+            {Array.from({ length: 6 }, (_, index) => <span className="loading-card" key={index} />)}
+          </div>
+          <span className="loading-panel-block" />
+        </div>
+      </section>
+      <div className="desktop-status-bar loading-status-bar" aria-label={loadingSkeletonPanelLabels[3]}>
+        {Array.from({ length: 8 }, (_, index) => <span className={index === 0 ? "loading-dot" : "loading-line"} key={index} />)}
+      </div>
+    </main>
+  );
+}
+
+function LoadingBrandOverlay(): ReactElement {
+  return (
+    <div className="loading-brand-overlay" aria-label="Starting aidevops">
+      <span className="loading-brand-mark" aria-hidden="true">
+        <span className="loading-brand-word">aidevops</span>
+        <span className="loading-brand-chevron">&gt;</span>
+        <span className="loading-brand-cursor">_</span>
+      </span>
+      <span className="loading-brand-status">Preparing local GUI</span>
+    </div>
+  );
+}
+
 export function clampSidebarWidth(width: number): number {
   return Math.min(maxSidebarWidth, Math.max(minSidebarWidth, Math.round(width)));
 }

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

@@ -2168,6 +2168,213 @@ code {
   text-transform: uppercase;
 }
 
+.app-loading-shell .loading-panel {
+  overflow: hidden;
+  position: relative;
+}
+
+.loading-brand-overlay {
+  align-items: center;
+  backdrop-filter: blur(18px);
+  background: color-mix(in srgb, var(--surface) 78%, transparent);
+  border: 1px solid color-mix(in srgb, var(--accent) 34%, var(--border));
+  border-radius: 24px;
+  box-shadow: 0 24px 90px color-mix(in srgb, var(--accent) 14%, transparent), var(--shadow-soft);
+  display: grid;
+  gap: 10px;
+  justify-items: center;
+  left: 50%;
+  padding: 26px 30px;
+  position: fixed;
+  top: 50%;
+  transform: translate(-50%, -50%);
+  width: min(360px, calc(100vw - 48px));
+  z-index: 20;
+}
+
+.loading-brand-mark {
+  align-items: baseline;
+  color: var(--text-primary);
+  display: inline-flex;
+  font-family: var(--font-family-mono);
+  font-size: clamp(2.1rem, 7vw, 4rem);
+  font-weight: 900;
+  letter-spacing: -0.08em;
+  line-height: 0.9;
+}
+
+.loading-brand-word {
+  color: color-mix(in srgb, var(--text-primary) 86%, var(--accent));
+  font-size: 0.48em;
+  letter-spacing: -0.04em;
+  margin-right: 0.18em;
+}
+
+.loading-brand-chevron { color: var(--accent); }
+
+.loading-brand-cursor {
+  animation: loading-cursor-blink 0.95s steps(1, end) infinite;
+  color: var(--accent);
+}
+
+.loading-brand-status {
+  color: var(--text-secondary);
+  font-size: 0.78rem;
+  font-weight: 800;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+}
+
+.loading-line,
+.loading-pill,
+.loading-orb,
+.loading-logo,
+.loading-icon,
+.loading-search,
+.loading-circle,
+.loading-card,
+.loading-panel-block,
+.loading-dot {
+  animation: loading-pulse 1.35s ease-in-out infinite;
+  background: linear-gradient(90deg, color-mix(in srgb, var(--surface-muted) 76%, transparent), color-mix(in srgb, var(--accent) 16%, var(--surface-elevated)), color-mix(in srgb, var(--surface-muted) 76%, transparent));
+  background-size: 220% 100%;
+  border: 1px solid var(--border);
+  display: block;
+}
+
+.loading-line {
+  border-radius: 999px;
+  height: 14px;
+  width: 100%;
+}
+
+.loading-line-wide { width: min(72%, 260px); }
+.loading-line-short { width: 58%; }
+.loading-line-hero { height: 34px; width: min(56%, 520px); }
+.loading-titlebar { height: 10px; margin: 7px auto 0; width: min(42%, 520px); }
+
+.loading-orb,
+.loading-logo,
+.loading-icon,
+.loading-circle,
+.loading-dot {
+  border-radius: 999px;
+  flex: 0 0 auto;
+}
+
+.loading-orb {
+  height: 48px;
+  width: 48px;
+}
+
+.loading-logo {
+  border-radius: 11px;
+  height: 44px;
+  width: 44px;
+}
+
+.loading-icon,
+.loading-circle {
+  height: 34px;
+  width: 34px;
+}
+
+.loading-dot {
+  height: 8px;
+  width: 8px;
+}
+
+.loading-pill,
+.loading-search {
+  border-radius: 999px;
+  height: 40px;
+  width: 100%;
+}
+
+.loading-sidebar-header,
+.loading-workspace-header {
+  align-items: center;
+  display: flex;
+  gap: 12px;
+}
+
+.loading-sidebar-header,
+.loading-sidebar-footer,
+.loading-list,
+.loading-workspace-body {
+  display: grid;
+  gap: 12px;
+  padding: 16px;
+}
+
+.loading-list {
+  padding-top: 0;
+}
+
+.loading-sidebar-footer {
+  border-top: 1px solid var(--border);
+  margin-top: auto;
+}
+
+.loading-workspace-header .loading-search {
+  flex: 1 1 auto;
+  max-width: 560px;
+}
+
+.loading-workspace-body {
+  align-content: start;
+  gap: 18px;
+  overflow: hidden;
+}
+
+.loading-card-grid {
+  display: grid;
+  gap: 14px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+}
+
+.loading-card {
+  border-radius: 18px;
+  height: 128px;
+}
+
+.loading-panel-block {
+  border-radius: 20px;
+  height: 240px;
+}
+
+.loading-status-bar .loading-line {
+  height: 10px;
+  width: 96px;
+}
+
+@keyframes loading-pulse {
+  0% { background-position: 120% 0; opacity: 0.52; }
+  50% { opacity: 0.95; }
+  100% { background-position: -120% 0; opacity: 0.52; }
+}
+
+@keyframes loading-cursor-blink {
+  0%, 48% { opacity: 1; }
+  49%, 100% { opacity: 0; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .loading-line,
+  .loading-pill,
+  .loading-orb,
+  .loading-logo,
+  .loading-icon,
+  .loading-search,
+  .loading-circle,
+  .loading-card,
+  .loading-panel-block,
+  .loading-dot,
+  .loading-brand-cursor {
+    animation: none;
+  }
+}
+
 .desktop-status-bar {
   align-items: center;
   background: color-mix(in srgb, var(--surface-elevated) 96%, transparent);

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