arkaos 3.21.0 → 3.23.0

package/VERSION

@@ -1 +1 @@
-3.21.0
+3.23.0

package/dashboard/app/components/SidebarStatsWidget.vue

@@ -0,0 +1,61 @@
+<script setup lang="ts">
+// PR87d v3.22.0 — compact stats card mounted at the bottom of the
+// sidebar. Polls /api/sidebar-stats every 60s.
+
+interface SidebarStats {
+  agents: number
+  personas: number
+  departments: number
+  today_cost_usd: number | null
+  today_calls: number
+}
+
+const { fetchApi } = useApi()
+const { data, refresh } = fetchApi<SidebarStats>('/api/sidebar-stats')
+
+let timer: ReturnType<typeof setInterval> | null = null
+onMounted(() => {
+  timer = setInterval(() => { refresh() }, 60_000)
+})
+onBeforeUnmount(() => {
+  if (timer) clearInterval(timer)
+})
+
+function formatCost(cost: number | null): string {
+  if (cost === null || cost === undefined) return '—'
+  if (cost < 0.01) return '<$0.01'
+  if (cost < 1) return `$${cost.toFixed(3)}`
+  return `$${cost.toFixed(2)}`
+}
+</script>
+
+<template>
+  <div
+    v-if="data"
+    class="rounded-lg border border-default bg-elevated/20 p-3 mx-2 mb-2 text-xs space-y-1.5"
+    aria-label="Workspace quick stats"
+  >
+    <div class="flex items-center justify-between">
+      <span class="text-muted">Agents</span>
+      <span class="font-mono font-semibold">{{ data.agents }}</span>
+    </div>
+    <div class="flex items-center justify-between">
+      <span class="text-muted">Personas</span>
+      <span class="font-mono font-semibold">{{ data.personas }}</span>
+    </div>
+    <div class="flex items-center justify-between">
+      <span class="text-muted">Departments</span>
+      <span class="font-mono font-semibold">{{ data.departments }}</span>
+    </div>
+    <div class="border-t border-default/60 mt-2 pt-1.5 flex items-center justify-between">
+      <span class="text-muted">Today</span>
+      <span class="font-mono font-semibold text-primary">
+        {{ formatCost(data.today_cost_usd) }}
+      </span>
+    </div>
+    <div class="flex items-center justify-between text-[10px] text-muted/70">
+      <span>{{ data.today_calls }} call{{ data.today_calls === 1 ? '' : 's' }}</span>
+      <span>auto · 60s</span>
+    </div>
+  </div>
+</template>

package/dashboard/app/layouts/default.vue

@@ -121,12 +121,15 @@ const links = [[{
           popover
         />
 
+        <!-- PR87d v3.22.0 — quick stats widget above the bottom nav. -->
+        <SidebarStatsWidget v-if="!collapsed" class="mt-auto" />
+
         <UNavigationMenu
           :collapsed="collapsed"
           :items="links[1]"
           orientation="vertical"
           tooltip
-          class="mt-auto"
+          :class="collapsed ? 'mt-auto' : ''"
         />
       </template>
     </UDashboardSidebar>

package/dashboard/app/pages/personas/[id].vue

@@ -247,6 +247,17 @@ function onCloned(agentId: string) {
   navigateTo(`/agents/${agentId}`)
 }
 
+// PR88a v3.23.0 — Compare with linked agent.
+const compareWithOptions = computed(() =>
+  linkedAgentIds.value.map((aid) => ({
+    label: `Compare with ${aid}`,
+    icon: 'i-lucide-columns-2',
+    onSelect: () => navigateTo(
+      `/personas/compare-with-agent?persona=${personaId}&agent=${aid}`,
+    ),
+  })),
+)
+
 // PR84c v3.9.0 — Auto-fill empty lists in one go.
 const autofilling = ref(false)
 
@@ -496,6 +507,18 @@ const vocabOptions = [
                       :aria-label="favs.isPersonaFavorite(detail.id) ? 'Unfavorite' : 'Favorite'"
                       @click="favs.toggle('personas', detail.id)"
                     />
+                    <UDropdownMenu
+                      v-if="compareWithOptions.length > 0"
+                      :items="compareWithOptions"
+                    >
+                      <UButton
+                        label="Compare"
+                        icon="i-lucide-columns-2"
+                        variant="soft"
+                        size="sm"
+                        trailing-icon="i-lucide-chevron-down"
+                      />
+                    </UDropdownMenu>
                     <UButton
                       label="Clone to Agent"
                       icon="i-lucide-copy-plus"

package/dashboard/app/pages/personas/compare-with-agent.vue

@@ -0,0 +1,218 @@
+<script setup lang="ts">
+// PR88a v3.23.0 — Compare a persona against one of its linked agents.
+//
+// Driven by `?persona=p&agent=a`. Useful to see how an agent diverged
+// from the persona it was cloned from (or whose DNA inspired it).
+
+const route = useRoute()
+const { fetchApi } = useApi()
+
+const personaId = computed(() => String(route.query.persona ?? ''))
+const agentId = computed(() => String(route.query.agent ?? ''))
+
+interface PersonaDetail {
+  id: string
+  name?: string
+  title?: string
+  source?: string
+  mbti?: string
+  disc?: { primary?: string, secondary?: string }
+  enneagram?: { type?: number, wing?: number }
+  big_five?: {
+    openness?: number
+    conscientiousness?: number
+    extraversion?: number
+    agreeableness?: number
+    neuroticism?: number
+  }
+  mental_models?: string[]
+  expertise_domains?: string[]
+  frameworks?: string[]
+  communication?: { tone?: string, vocabulary_level?: string, avoid?: string[] }
+}
+
+interface AgentDetail {
+  id: string
+  name?: string
+  role?: string
+  department?: string
+  mbti?: string
+  disc?: { primary?: string, secondary?: string }
+  enneagram?: { type?: number, wing?: number }
+  big_five?: PersonaDetail['big_five']
+  mental_models?: { primary?: string[], secondary?: string[] }
+  expertise?: { domains?: string[], frameworks?: string[] }
+  communication?: { tone?: string, vocabulary_level?: string, avoid?: string[] }
+}
+
+const { data: persona, status: pStatus } = fetchApi<PersonaDetail>(
+  () => personaId.value ? `/api/personas/${personaId.value}` : '',
+)
+const { data: agent, status: aStatus } = fetchApi<AgentDetail>(
+  () => agentId.value ? `/api/agents/${agentId.value}` : '',
+)
+
+const loading = computed(() => pStatus.value === 'pending' || aStatus.value === 'pending')
+const errorMsg = computed(() => {
+  if (!personaId.value || !agentId.value) {
+    return 'Pass ?persona=p&agent=a'
+  }
+  if (persona.value && (persona.value as any).error) return `Persona: ${(persona.value as any).error}`
+  if (agent.value && (agent.value as any).error) return `Agent: ${(agent.value as any).error}`
+  return null
+})
+
+function diffClass(left: unknown, right: unknown): string {
+  return left !== right
+    ? 'bg-yellow-500/10 border-yellow-500/30'
+    : ''
+}
+function listDiffClass(left: unknown[] | undefined, right: unknown[] | undefined): string {
+  const a = JSON.stringify([...(left ?? [])].sort())
+  const b = JSON.stringify([...(right ?? [])].sort())
+  return a !== b ? 'bg-yellow-500/10 border-yellow-500/30' : ''
+}
+
+const bigFiveKeys = ['openness', 'conscientiousness', 'extraversion', 'agreeableness', 'neuroticism'] as const
+</script>
+
+<template>
+  <UDashboardPanel id="persona-vs-agent">
+    <template #header>
+      <UDashboardNavbar title="Persona vs Agent">
+        <template #leading>
+          <UButton
+            v-if="personaId"
+            icon="i-lucide-arrow-left"
+            variant="ghost"
+            size="sm"
+            :to="`/personas/${personaId}`"
+            aria-label="Back to persona"
+          />
+        </template>
+        <template #trailing>
+          <UBadge label="diverge view" variant="subtle" size="sm" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <div v-if="errorMsg" class="p-6 text-center text-sm text-error">
+        {{ errorMsg }}
+      </div>
+      <div v-else-if="loading" class="p-6 text-center text-sm text-muted">
+        <UIcon name="i-lucide-loader-2" class="size-4 animate-spin inline" /> Loading…
+      </div>
+      <div v-else-if="persona && agent" class="space-y-4 max-w-6xl">
+        <section class="grid grid-cols-2 gap-3">
+          <NuxtLink :to="`/personas/${persona.id}`" class="rounded-lg border border-default p-4 hover:border-primary/40">
+            <p class="text-xs text-muted uppercase tracking-wide">Persona</p>
+            <h2 class="text-xl font-bold">{{ persona.name }}</h2>
+            <p class="text-sm text-muted">{{ persona.title || '—' }}</p>
+          </NuxtLink>
+          <NuxtLink :to="`/agents/${agent.id}`" class="rounded-lg border border-default p-4 hover:border-primary/40">
+            <p class="text-xs text-muted uppercase tracking-wide">Agent</p>
+            <h2 class="text-xl font-bold">{{ agent.name }}</h2>
+            <p class="text-sm text-muted">{{ agent.role }} · {{ agent.department }}</p>
+          </NuxtLink>
+        </section>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Behavioural DNA</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', diffClass(persona.mbti, agent.mbti)]">
+            <p class="text-xs text-muted">MBTI</p>
+            <p class="text-lg font-mono font-bold">{{ persona.mbti ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(persona.mbti, agent.mbti)]">
+            <p class="text-xs text-muted">MBTI</p>
+            <p class="text-lg font-mono font-bold">{{ agent.mbti ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${persona.disc?.primary}/${persona.disc?.secondary}`, `${agent.disc?.primary}/${agent.disc?.secondary}`)]">
+            <p class="text-xs text-muted">DISC</p>
+            <p class="text-lg font-mono font-bold">{{ persona.disc?.primary ?? '?' }}/{{ persona.disc?.secondary ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${persona.disc?.primary}/${persona.disc?.secondary}`, `${agent.disc?.primary}/${agent.disc?.secondary}`)]">
+            <p class="text-xs text-muted">DISC</p>
+            <p class="text-lg font-mono font-bold">{{ agent.disc?.primary ?? '?' }}/{{ agent.disc?.secondary ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${persona.enneagram?.type}w${persona.enneagram?.wing}`, `${agent.enneagram?.type}w${agent.enneagram?.wing}`)]">
+            <p class="text-xs text-muted">Enneagram</p>
+            <p class="text-lg font-mono font-bold">{{ persona.enneagram?.type ?? '?' }}w{{ persona.enneagram?.wing ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${persona.enneagram?.type}w${persona.enneagram?.wing}`, `${agent.enneagram?.type}w${agent.enneagram?.wing}`)]">
+            <p class="text-xs text-muted">Enneagram</p>
+            <p class="text-lg font-mono font-bold">{{ agent.enneagram?.type ?? '?' }}w{{ agent.enneagram?.wing ?? '?' }}</p>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Big Five (OCEAN)</h3>
+        <div class="space-y-1">
+          <div v-for="k in bigFiveKeys" :key="k" class="grid grid-cols-2 gap-3">
+            <div :class="['rounded-lg border p-2 flex items-center gap-3', diffClass(persona.big_five?.[k], agent.big_five?.[k])]">
+              <span class="text-xs text-muted w-36 shrink-0 capitalize">{{ k }}</span>
+              <span class="font-mono text-sm">{{ persona.big_five?.[k] ?? '—' }}</span>
+            </div>
+            <div :class="['rounded-lg border p-2 flex items-center gap-3', diffClass(persona.big_five?.[k], agent.big_five?.[k])]">
+              <span class="text-xs text-muted w-36 shrink-0 capitalize">{{ k }}</span>
+              <span class="font-mono text-sm">{{ agent.big_five?.[k] ?? '—' }}</span>
+            </div>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Expertise domains</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(persona.expertise_domains, agent.expertise?.domains)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="d in persona.expertise_domains" :key="d">{{ d }}</li>
+              <li v-if="!persona.expertise_domains?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(persona.expertise_domains, agent.expertise?.domains)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="d in agent.expertise?.domains" :key="d">{{ d }}</li>
+              <li v-if="!agent.expertise?.domains?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Frameworks</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(persona.frameworks, agent.expertise?.frameworks)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="f in persona.frameworks" :key="f">{{ f }}</li>
+              <li v-if="!persona.frameworks?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(persona.frameworks, agent.expertise?.frameworks)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="f in agent.expertise?.frameworks" :key="f">{{ f }}</li>
+              <li v-if="!agent.expertise?.frameworks?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Mental models</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(persona.mental_models, agent.mental_models?.primary)]">
+            <p class="text-xs text-muted mb-2">Persona — flat list</p>
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="m in persona.mental_models" :key="m">{{ m }}</li>
+              <li v-if="!persona.mental_models?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(persona.mental_models, agent.mental_models?.primary)]">
+            <p class="text-xs text-muted mb-2">Agent — primary</p>
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="m in agent.mental_models?.primary" :key="m">{{ m }}</li>
+              <li v-if="!agent.mental_models?.primary?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+        </div>
+
+        <p class="text-xs text-muted pt-4 italic">
+          Cells with a yellow tint differ between persona and agent.
+        </p>
+      </div>
+    </template>
+  </UDashboardPanel>
+</template>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.21.0",
+  "version": "3.23.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "3.21.0"
+version = "3.23.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -1387,6 +1387,43 @@ def agent_export_to_vault(agent_id: str):
     return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
 
 
+# --- Sidebar stats widget (PR87d v3.22.0) ---
+
+@app.get("/api/sidebar-stats")
+def sidebar_stats():
+    """Compact payload for the sidebar status widget.
+
+    Returns counts the widget actually displays — agents, personas,
+    departments, today's spend. Cheaper than /api/overview/command-center
+    because it skips project scanning, incidents, and quick actions.
+    """
+    agents = _load_agents()
+    departments = {a.get("department") for a in agents if a.get("department")}
+    persona_count = 0
+    mgr = _get_persona_manager()
+    if mgr:
+        try:
+            persona_count = len(mgr.list() or [])
+        except Exception:
+            persona_count = 0
+    today_cost_usd: float | None = None
+    call_count = 0
+    try:
+        from core.runtime.llm_cost_telemetry import summarise
+        s = summarise(period="today")
+        today_cost_usd = s.total_cost_usd
+        call_count = s.call_count
+    except Exception:
+        pass
+    return {
+        "agents": len(agents),
+        "personas": persona_count,
+        "departments": len(departments),
+        "today_cost_usd": today_cost_usd,
+        "today_calls": call_count,
+    }
+
+
 # --- Favorites (PR86a v3.15.0) ---
 
 @app.get("/api/favorites")