aidevops 3.29.12 → 3.29.14

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

package/aidevops.sh

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

package/package.json

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

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

@@ -3,12 +3,29 @@ import { sortConversationMessageParts, sortConversationMessages, type GuiConvers
 import { text } from "./app-model";
 import { conversationThreads } from "./conversation-fixtures";
 
-export function CommsConversationSurface({ mode }: { mode: "channels" | "directMessages" | "people" }) {
-  const conversations = mode === "directMessages" ? conversationThreads.filter((thread) => thread.conversation.type === "dm" || thread.conversation.type === "group_dm") : conversationThreads.filter((thread) => thread.conversation.type === "channel");
-  const selectedThread = conversations[0] ?? conversationThreads[0];
+export function CommsConversationSurface({ mode, threads = conversationThreads }: { mode: "channels" | "directMessages" | "people"; threads?: GuiConversationThread[] }) {
+  const availableThreads = threads ?? [];
+  const conversations = mode === "directMessages" ? availableThreads.filter((thread) => thread.conversation.type === "dm" || thread.conversation.type === "group_dm") : availableThreads.filter((thread) => thread.conversation.type === "channel");
+  const selectedThread = conversations[0] ?? availableThreads[0];
   const partsByMessage = new Map<string, GuiConversationMessagePart[]>();
 
-  for (const part of sortConversationMessageParts(selectedThread.parts)) {
+  if (!selectedThread) {
+    return (
+      <section className="chat-surface comms-surface" aria-label={mode === "directMessages" ? text.directMessages : text.channels} data-tour="comms-conversations">
+        <aside className="chat-thread-panel conversation-list-panel" aria-label="Conversation list">
+          <header className="chat-thread-header">
+            <div>
+              <p className="eyebrow">Unified conversation model</p>
+              <h2>{mode === "directMessages" ? <FiAtSign aria-hidden="true" /> : <FiHash aria-hidden="true" />} {mode === "directMessages" ? text.directMessages : text.channels}</h2>
+            </div>
+          </header>
+          <div className="notice compact-notice">No conversations yet</div>
+        </aside>
+      </section>
+    );
+  }
+
+  for (const part of sortConversationMessageParts(conversationParts(selectedThread))) {
     partsByMessage.set(part.message_id, [...(partsByMessage.get(part.message_id) ?? []), part]);
   }
 
@@ -37,10 +54,10 @@ export function CommsConversationSurface({ mode }: { mode: "channels" | "directM
           <span className="count-pill">{participantSummary(selectedThread)}</span>
         </header>
         <div className="participant-strip">
-          {selectedThread.participants.map((participant) => <span key={participant.id}>{participant.display_name}<small>{participant.kind}</small></span>)}
+          {conversationParticipants(selectedThread).map((participant) => <span key={participant.id}>{participant.display_name}<small>{participant.kind}</small></span>)}
         </div>
         <div className="chat-message-list" data-tour="comms-message-timeline">
-          {sortConversationMessages(selectedThread.messages).map((message) => <ConversationMessageRow key={message.id} message={message} parts={partsByMessage.get(message.id) ?? []} thread={selectedThread} />)}
+          {sortConversationMessages(conversationMessages(selectedThread)).map((message) => <ConversationMessageRow key={message.id} message={message} parts={partsByMessage.get(message.id) ?? []} thread={selectedThread} />)}
         </div>
         <form className="chat-composer" aria-label="Conversation composer">
           <textarea disabled placeholder={text.chatInputPlaceholder} />
@@ -52,7 +69,7 @@ export function CommsConversationSurface({ mode }: { mode: "channels" | "directM
 }
 
 function ConversationListItem({ thread }: { thread: GuiConversationThread }) {
-  const latestMessage = sortConversationMessages(thread.messages).at(-1);
+  const latestMessage = sortConversationMessages(conversationMessages(thread)).at(-1);
   const unread = unreadCount(thread);
 
   return (
@@ -67,8 +84,8 @@ function ConversationListItem({ thread }: { thread: GuiConversationThread }) {
 }
 
 function ConversationMessageRow({ message, parts, thread }: { message: GuiConversationMessage; parts: GuiConversationMessagePart[]; thread: GuiConversationThread }) {
-  const sender = thread.participants.find((participant) => participant.id === message.sender_participant_id);
-  const reactions = thread.reactions.filter((reaction) => reaction.message_id === message.id);
+  const sender = conversationParticipants(thread).find((participant) => participant.id === message.sender_participant_id);
+  const reactions = conversationReactions(thread).filter((reaction) => reaction.message_id === message.id);
   const speaker = message.sender_kind === "human" ? "user" : "assistant";
 
   return (
@@ -82,12 +99,32 @@ function ConversationMessageRow({ message, parts, thread }: { message: GuiConver
 }
 
 function participantSummary(thread: GuiConversationThread): string {
-  const active = thread.participants.filter((participant) => participant.membership_state === "active").length;
+  const active = conversationParticipants(thread).filter((participant) => participant.membership_state === "active").length;
   return `${active} members`;
 }
 
 function unreadCount(thread: GuiConversationThread): number {
-  const lastSequence = Math.max(0, ...thread.messages.map((message) => message.sequence));
-  const localRead = thread.read_states[0]?.last_read_sequence ?? 0;
+  const lastSequence = Math.max(0, ...conversationMessages(thread).map((message) => message.sequence));
+  const localRead = conversationReadStates(thread)[0]?.last_read_sequence ?? 0;
   return Math.max(0, lastSequence - localRead);
 }
+
+function conversationMessages(thread: GuiConversationThread): GuiConversationMessage[] {
+  return thread.messages ?? [];
+}
+
+function conversationParts(thread: GuiConversationThread): GuiConversationMessagePart[] {
+  return thread.parts ?? [];
+}
+
+function conversationParticipants(thread: GuiConversationThread): GuiConversationThread["participants"] {
+  return thread.participants ?? [];
+}
+
+function conversationReactions(thread: GuiConversationThread): GuiConversationThread["reactions"] {
+  return thread.reactions ?? [];
+}
+
+function conversationReadStates(thread: GuiConversationThread): GuiConversationThread["read_states"] {
+  return thread.read_states ?? [];
+}

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

@@ -29,6 +29,8 @@ export function AppsSurface({ status }: { status: GuiStatusData }): ReactElement
   const managedApps = sortedManagedApps(status.managed_apps).map((app) => applyManagedPolicyToggles(app, policyToggles[app.id]));
   const visibleManagedApps = managedApps.filter((app) => managedCategoryForApp(app) === managedCategory);
   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);
@@ -85,7 +87,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={setRecommendedOs} setPlatform={setRecommendedPlatform} />}
+      </> : <RecommendedAppsSurface apps={visibleRecommendedApps} os={recommendedOs} platform={recommendedPlatform} setOs={selectRecommendedOs} setPlatform={selectRecommendedPlatform} />}
     </section>
   );
 }
@@ -120,11 +122,9 @@ function ManagedAppPanel({ app, expanded, job, onJob, onPolicyToggle, onToggle,
       <div className="managed-app-details">
         <ToggleSwitch checked={app.aidevops_install} disabled={lockedPolicy} label="setup installs" onChange={(value) => onPolicyToggle("setup", value)} />
         <ToggleSwitch checked={app.aidevops_update} disabled={lockedPolicy} label="update maintains" onChange={(value) => onPolicyToggle("update", value)} />
-        <AppMeta label="Installed" value={app.installed_version} />
-        <AppMeta label="Latest" value={app.latest_version} />
-        <AppMeta label={text.path} value={app.install_path_ref} />
         {job ? <AppLogLink job={job} /> : null}
       </div>
+      <AppMeta className="managed-app-path" label={text.path} value={app.install_path_ref} />
       {job ? <AppActionTerminal job={job} /> : null}
       {policyJobs.map((policyJob) => <AppActionTerminal job={policyJob} key={policyJob.id} />)}
       {job === null && policyJobs.length === 0 ? <p className="empty-state compact-notice">No recent command output for this app. Run an action or change a policy toggle to open this app's terminal log.</p> : null}
@@ -146,11 +146,11 @@ function OriginLink({ href, label }: { href: string; label: string }): ReactElem
 }
 
 function ToggleSwitch({ checked, disabled = false, label, onChange }: { checked: boolean; disabled?: boolean; label: string; onChange: (checked: boolean) => void }): ReactElement {
-  return <button aria-pressed={checked} className={checked ? "managed-toggle checked" : "managed-toggle"} data-tooltip={disabled ? "Essential aidevops component; policy is locked on" : undefined} disabled={disabled} onClick={() => onChange(!checked)} title={disabled ? "Essential aidevops component; policy is locked on" : undefined} type="button"><span aria-hidden="true" className={checked ? "switch-track checked" : "switch-track"}><span /></span>{label}</button>;
+  return <button aria-pressed={checked} className={checked ? "managed-toggle checked" : "managed-toggle"} data-tooltip={disabled ? "Essential aidevops component; policy is locked on" : undefined} disabled={disabled} onClick={() => onChange(!checked)} title={disabled ? "Essential aidevops component; policy is locked on" : undefined} type="button"><span className="managed-toggle-label">{label}</span><span aria-hidden="true" className={checked ? "switch-track checked" : "switch-track"}><span /></span></button>;
 }
 
-function AppMeta({ label, value }: { label: string; value: string }): ReactElement {
-  return <span className="app-meta"><small>{label}</small><strong>{value}</strong></span>;
+function AppMeta({ className = "", label, value }: { className?: string; label: string; value: string }): ReactElement {
+  return <span className={className.length > 0 ? `app-meta ${className}` : "app-meta"}><small>{label}</small><strong>{value}</strong></span>;
 }
 
 function AppLogLink({ job }: { job: GuiAppActionJobSummary }): ReactElement {
@@ -291,7 +291,7 @@ interface RecommendedApp {
 }
 
 const appCollectionTabs: TabOption<AppCollectionId>[] = [
-  { id: "aidevops", label: "aidevops" },
+  { id: "aidevops", label: "AIDevOps" },
   { id: "recommended", label: "Recommended" },
 ];
 
@@ -379,8 +379,8 @@ function TabNav<T extends string>({ label, onChange, tabs, value }: { label: str
 function RecommendedAppsSurface({ apps, os, platform, setOs, setPlatform }: { apps: RecommendedApp[]; os: RecommendedOsId; platform: RecommendedPlatformFilterId; setOs: (os: RecommendedOsId) => void; setPlatform: (platform: RecommendedPlatformFilterId) => void }): ReactElement {
   return <>
     <div className="recommended-filter-tabs">
-      <TabNav label="Recommended app platform filters" tabs={recommendedPlatformTabs} value={platform} onChange={setPlatform} />
       <TabNav label="Recommended app operating system filters" tabs={recommendedOsTabs} value={os} onChange={setOs} />
+      <TabNav label="Recommended app platform filters" tabs={recommendedPlatformTabs} value={platform} onChange={setPlatform} />
     </div>
     <div className="recommended-app-grid">
       {apps.map((app) => <RecommendedAppCard app={app} key={app.name} setOs={setOs} setPlatform={setPlatform} />)}
@@ -459,6 +459,10 @@ function recommendedAppMatchesFilters(app: RecommendedApp, platform: Recommended
   return platformMatches && osMatches;
 }
 
+export function nextRecommendedFilterValue<T extends string>(current: T, next: T, defaultValue: T): T {
+  return current === next && next !== defaultValue ? defaultValue : next;
+}
+
 function applyManagedPolicyToggles(app: GuiManagedAppSummary, policy: Partial<Record<ManagedPolicyId, boolean>> | undefined): GuiManagedAppSummary {
   if (policy === undefined) {
     return app;

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

@@ -147,7 +147,7 @@ export const text = {
   aidevops: "aidevops",
   appShell: "App shell",
   apps: "Apps",
-  appsIntro: "App and CLI inventory for tools installed or updated by aidevops, with origin links, install/update policy, versions, paths, and allowlisted background actions.",
+  appsIntro: "The app toolkit we use and recommend to enable all the things we can do with AI, development, and operations to create and share our work. Opinionated preferences based on open-source-first, lowest-costs, highest-quality UI & UX, teamwork, data security, privacy, and AI-usage capabilities.",
   appStatusPending: "adapter pending",
   brands: "Brands",
   brandsIntro: "Draft brand inventory for names and website references.",

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

@@ -943,9 +943,8 @@ code {
 .header-actions > .header-action-menu {
   align-items: center;
   display: inline-flex;
-  flex: 0 0 38px;
+  flex: 0 0 auto;
   justify-content: center;
-  width: 38px;
 }
 
 .workspace-search {
@@ -1001,6 +1000,7 @@ code {
 }
 
 .header-action-menu {
+  gap: 10px;
   position: relative;
 }
 
@@ -1784,15 +1784,23 @@ code {
 }
 
 .section-heading {
-  margin-bottom: 18px;
+  margin-bottom: 16px;
   max-width: 860px;
 }
 
+.section-heading .eyebrow {
+  margin: 0 0 9px;
+}
+
 .section-heading h2 {
   font-size: 1.7rem;
   letter-spacing: -0.05em;
   line-height: 1.04;
-  margin: 6px 0 8px;
+  margin: 0 0 16px;
+}
+
+.section-heading p {
+  margin: 0;
 }
 
 .section-heading p,
@@ -2003,13 +2011,25 @@ code {
 }
 
 .apps-surface {
-  display: grid;
   align-content: start;
-  gap: 10px;
+  display: grid;
+  gap: 0;
 }
 
 .apps-surface .section-heading {
-  margin-bottom: 8px;
+  margin-bottom: 18px;
+}
+
+.apps-surface > .app-subnav {
+  margin-bottom: 18px;
+}
+
+.apps-surface > .app-subnav + .app-subnav {
+  margin-bottom: 16px;
+}
+
+.apps-surface .compact-notice {
+  margin-bottom: 0;
 }
 
 .data-table,
@@ -2021,8 +2041,8 @@ code {
 }
 
 .managed-app-list {
-  gap: 12px;
-  margin-bottom: 12px;
+  gap: 16px;
+  margin-bottom: 16px;
   overflow: visible;
 }
 
@@ -2033,7 +2053,7 @@ code {
   border: 1px solid var(--border);
   border-radius: 18px;
   box-shadow: inset 0 1px 0 rgb(255 255 255 / 7%);
-  overflow: hidden;
+  overflow: visible;
   transition: background 140ms ease, border-color 140ms ease;
 }
 
@@ -2071,14 +2091,23 @@ code {
 .managed-app-title-block,
 .app-meta {
   display: grid;
-  gap: 7px;
   min-width: 0;
 }
 
+.managed-app-title-block {
+  gap: 0;
+}
+
+.managed-app-title-block .eyebrow {
+  line-height: 1;
+  margin: 0 0 8px;
+}
+
 .managed-app-title-block strong {
   font-size: clamp(1.12rem, 2vw, 1.4rem);
   letter-spacing: -0.04em;
   line-height: 1.15;
+  margin-bottom: 16px;
 }
 
 .managed-app-title-block > span:last-child {
@@ -2097,14 +2126,16 @@ code {
 
 .managed-summary-chip {
   align-items: center;
+  align-content: center;
   background: color-mix(in srgb, var(--surface-elevated) 92%, transparent);
   border: 1px solid var(--border);
   border-radius: 999px;
   display: inline-grid;
   gap: 1px;
   justify-items: center;
+  min-height: 58px;
   min-width: 118px;
-  padding: 7px 11px;
+  padding: 7px 12px;
   text-align: center;
 }
 
@@ -2120,6 +2151,7 @@ code {
   color: var(--text-primary);
   font-size: 0.84rem;
   font-weight: 800;
+  line-height: 1.15;
   max-width: 18ch;
   overflow: hidden;
   text-overflow: ellipsis;
@@ -2139,7 +2171,7 @@ code {
 .managed-app-body {
   border-top: 1px solid var(--border);
   display: grid;
-  gap: 14px;
+  gap: 16px;
   padding: 0 16px 16px;
   position: relative;
 }
@@ -2147,9 +2179,9 @@ code {
 .managed-app-toolbar {
   align-items: start;
   display: grid;
-  gap: 12px;
+  gap: 16px;
   grid-template-columns: minmax(0, 1fr) auto;
-  padding-top: 14px;
+  padding-top: 16px;
 }
 
 .managed-app-links,
@@ -2195,11 +2227,16 @@ code {
   grid-template-columns: repeat(auto-fit, minmax(168px, 1fr));
 }
 
+.managed-app-path {
+  min-height: auto;
+}
+
 .managed-toggle,
 .app-meta {
   background: var(--surface-elevated);
   border: 1px solid var(--border);
   border-radius: 12px;
+  gap: 7px;
   min-width: 0;
   min-height: 64px;
   padding: 10px 12px;
@@ -2211,10 +2248,15 @@ code {
   display: flex;
   font-size: 0.78rem;
   font-weight: 800;
-  gap: 8px;
+  gap: 12px;
+  justify-content: space-between;
   text-transform: uppercase;
 }
 
+.managed-toggle-label {
+  min-width: 0;
+}
+
 button.managed-toggle {
   cursor: pointer;
   text-align: left;
@@ -2236,6 +2278,7 @@ button.managed-toggle:focus-visible {
   border: 1px solid color-mix(in srgb, #ef4444 44%, var(--border));
   border-radius: 999px;
   display: inline-flex;
+  flex: 0 0 auto;
   padding: 2px;
   width: 34px;
 }
@@ -2293,19 +2336,27 @@ button.managed-toggle:focus-visible {
   color: var(--accent);
   display: inline-flex;
   gap: 7px;
-  min-height: 42px;
   justify-content: center;
+  line-height: 1;
+  min-height: 42px;
   padding: 0 12px;
   position: relative;
   transition: background 140ms ease, border-color 140ms ease, color 140ms ease, transform 140ms ease;
 }
 
 .app-action-button span {
+  align-items: center;
+  display: inline-flex;
   font-size: 0.7rem;
   font-weight: 900;
+  line-height: 1;
   text-transform: uppercase;
 }
 
+.app-action-button svg {
+  flex: 0 0 auto;
+}
+
 .app-action-button:hover,
 .app-action-button:focus-visible {
   background: var(--accent);
@@ -2421,7 +2472,7 @@ button.managed-toggle:focus-visible {
   content: attr(data-tooltip);
   font-size: 0.72rem;
   font-weight: 700;
-  left: clamp(10px, 50%, calc(100vw - 330px));
+  left: 50%;
   line-height: 1.35;
   max-width: min(320px, 72vw);
   opacity: 0;
@@ -2432,7 +2483,7 @@ button.managed-toggle:focus-visible {
   transform: translate(-50%, 4px);
   transition: opacity 140ms ease, transform 140ms ease;
   width: max-content;
-  z-index: 400;
+  z-index: 1000;
 }
 
 [data-tooltip]:hover::after,
@@ -2526,7 +2577,8 @@ button.managed-toggle:focus-visible {
 .recommended-filter-tabs {
   display: flex;
   flex-wrap: wrap;
-  gap: 10px;
+  gap: 16px;
+  margin-bottom: 16px;
 }
 
 .recommended-app-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.12
+# Version: 3.29.14
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)
@@ -1330,6 +1330,8 @@ _setup_run_non_interactive() {
 	# at commit time (t2047). Belt-and-braces with the CI check in
 	# .github/workflows/task-id-collision-check.yml.
 	_time_step "setup_task_id_guard" setup_task_id_guard
+	# Configure the centralized flat linked-worktree directory used by helpers.
+	_time_step "setup_worktree_location" setup_worktree_location
 	# Apply Spotlight + Time Machine exclusions to every worktree across
 	# registered repos so the backup/index cascade triggered by node_modules
 	# copies doesn't burn CPU (t2885). Idempotent. macOS only — Linux