arkaos 3.30.0 → 3.32.0

package/VERSION

@@ -1 +1 @@
-3.30.0
+3.32.0

package/dashboard/app/pages/departments/[dept].vue

@@ -37,6 +37,21 @@ const { data, status, error, refresh } = await fetchApi<DeptDetail>(
   `/api/departments/${deptId.value}`,
 )
 
+// PR90b v3.32.0 — Compare with another department.
+const { data: deptListData } = fetchApi<{ departments: Array<{ department: string }> }>(
+  '/api/departments',
+)
+const compareOptions = computed(() =>
+  (deptListData.value?.departments ?? [])
+    .filter((d) => d.department !== deptId.value)
+    .map((d) => ({
+      label: `Compare with ${d.department}`,
+      icon: 'i-lucide-columns-2',
+      onSelect: () =>
+        navigateTo(`/departments/compare?a=${deptId.value}&b=${d.department}`),
+    })),
+)
+
 const errorMsg = computed(() => data.value?.error || error.value?.message || null)
 const detail = computed<DeptDetail | null>(() => {
   if (!data.value || data.value.error) return null
@@ -65,6 +80,17 @@ const tierColor = (tier: number | undefined) => {
         <template #leading>
           <UButton icon="i-lucide-arrow-left" variant="ghost" size="sm" to="/departments" aria-label="Back" />
         </template>
+        <template #right>
+          <UDropdownMenu v-if="compareOptions.length > 0" :items="compareOptions">
+            <UButton
+              label="Compare"
+              icon="i-lucide-columns-2"
+              variant="soft"
+              size="sm"
+              trailing-icon="i-lucide-chevron-down"
+            />
+          </UDropdownMenu>
+        </template>
       </UDashboardNavbar>
     </template>
 

package/dashboard/app/pages/departments/compare.vue

@@ -0,0 +1,192 @@
+<script setup lang="ts">
+// PR90b v3.32.0 — Compare two departments side-by-side.
+//
+// Driven by `?a=dept1&b=dept2`. Reuses /api/departments/{id}. Shows
+// agent count + tier distribution + workflows count + 30d cost.
+
+const route = useRoute()
+const { fetchApi } = useApi()
+
+const deptA = computed(() => String(route.query.a ?? ''))
+const deptB = computed(() => String(route.query.b ?? ''))
+
+interface AgentLite {
+  id: string
+  name?: string
+  role?: string
+  tier?: number
+  mbti?: string
+}
+interface WorkflowLite {
+  id: string
+  name: string
+  tier: string
+  command: string
+  phases_count: number
+}
+interface DeptDetail {
+  department: string
+  agents: AgentLite[]
+  workflows: WorkflowLite[]
+  calls_30d: number
+  cost_usd_30d: number | null
+  error?: string
+}
+
+const { data: a } = fetchApi<DeptDetail>(
+  () => deptA.value ? `/api/departments/${deptA.value}` : '',
+)
+const { data: b } = fetchApi<DeptDetail>(
+  () => deptB.value ? `/api/departments/${deptB.value}` : '',
+)
+
+const errorMsg = computed(() => {
+  if (!deptA.value || !deptB.value) return 'Pass ?a=dept1&b=dept2'
+  if (a.value?.error) return `Left: ${a.value.error}`
+  if (b.value?.error) return `Right: ${b.value.error}`
+  return null
+})
+
+function diffClass(left: unknown, right: unknown): string {
+  return left !== right ? 'bg-yellow-500/10 border-yellow-500/30' : ''
+}
+
+function formatCost(cost: number | null | undefined): 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)}`
+}
+
+const tierColor = (tier: number | undefined) => {
+  const m: Record<number, 'error' | 'warning' | 'primary' | 'neutral'> = {
+    0: 'error', 1: 'warning', 2: 'primary', 3: 'neutral',
+  }
+  return m[tier ?? 99] ?? 'neutral'
+}
+</script>
+
+<template>
+  <UDashboardPanel id="departments-compare">
+    <template #header>
+      <UDashboardNavbar title="Compare departments">
+        <template #leading>
+          <UButton icon="i-lucide-arrow-left" variant="ghost" size="sm" to="/departments" aria-label="Back" />
+        </template>
+        <template #trailing>
+          <UBadge label="2-way" 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="!a || !b" 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 class="space-y-4 max-w-6xl">
+        <section class="grid grid-cols-2 gap-3">
+          <NuxtLink :to="`/departments/${a.department}`" class="rounded-lg border border-default p-4 hover:border-primary/40">
+            <p class="text-xs text-muted uppercase tracking-wide">Left</p>
+            <h2 class="text-xl font-bold capitalize">{{ a.department }}</h2>
+          </NuxtLink>
+          <NuxtLink :to="`/departments/${b.department}`" class="rounded-lg border border-default p-4 hover:border-primary/40">
+            <p class="text-xs text-muted uppercase tracking-wide">Right</p>
+            <h2 class="text-xl font-bold capitalize">{{ b.department }}</h2>
+          </NuxtLink>
+        </section>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Stats</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', diffClass(a.agents.length, b.agents.length)]">
+            <p class="text-xs text-muted">Agents</p>
+            <p class="text-2xl font-bold">{{ a.agents.length }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.agents.length, b.agents.length)]">
+            <p class="text-xs text-muted">Agents</p>
+            <p class="text-2xl font-bold">{{ b.agents.length }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.workflows.length, b.workflows.length)]">
+            <p class="text-xs text-muted">Workflows</p>
+            <p class="text-2xl font-bold">{{ a.workflows.length }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.workflows.length, b.workflows.length)]">
+            <p class="text-xs text-muted">Workflows</p>
+            <p class="text-2xl font-bold">{{ b.workflows.length }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.calls_30d, b.calls_30d)]">
+            <p class="text-xs text-muted">Calls (30d)</p>
+            <p class="text-2xl font-bold">{{ a.calls_30d }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.calls_30d, b.calls_30d)]">
+            <p class="text-xs text-muted">Calls (30d)</p>
+            <p class="text-2xl font-bold">{{ b.calls_30d }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.cost_usd_30d, b.cost_usd_30d)]">
+            <p class="text-xs text-muted">Cost (30d)</p>
+            <p class="text-2xl font-bold">{{ formatCost(a.cost_usd_30d) }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.cost_usd_30d, b.cost_usd_30d)]">
+            <p class="text-xs text-muted">Cost (30d)</p>
+            <p class="text-2xl font-bold">{{ formatCost(b.cost_usd_30d) }}</p>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Agents</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div class="rounded-lg border border-default p-3 space-y-1">
+            <NuxtLink
+              v-for="ag in a.agents"
+              :key="ag.id"
+              :to="`/agents/${ag.id}`"
+              class="flex items-center gap-2 text-sm hover:text-primary truncate"
+            >
+              <UBadge :label="`T${ag.tier}`" :color="tierColor(ag.tier)" variant="subtle" size="xs" />
+              <span class="font-medium truncate">{{ ag.name }}</span>
+              <span class="text-xs text-muted truncate">— {{ ag.role }}</span>
+            </NuxtLink>
+          </div>
+          <div class="rounded-lg border border-default p-3 space-y-1">
+            <NuxtLink
+              v-for="ag in b.agents"
+              :key="ag.id"
+              :to="`/agents/${ag.id}`"
+              class="flex items-center gap-2 text-sm hover:text-primary truncate"
+            >
+              <UBadge :label="`T${ag.tier}`" :color="tierColor(ag.tier)" variant="subtle" size="xs" />
+              <span class="font-medium truncate">{{ ag.name }}</span>
+              <span class="text-xs text-muted truncate">— {{ ag.role }}</span>
+            </NuxtLink>
+          </div>
+        </div>
+
+        <h3
+          v-if="a.workflows.length > 0 || b.workflows.length > 0"
+          class="text-sm font-semibold uppercase tracking-wide text-muted pt-2"
+        >
+          Workflows
+        </h3>
+        <div v-if="a.workflows.length > 0 || b.workflows.length > 0" class="grid grid-cols-2 gap-3">
+          <div class="rounded-lg border border-default p-3 space-y-1">
+            <p v-for="w in a.workflows" :key="w.id" class="text-sm truncate">
+              <span class="font-mono text-xs text-muted">{{ w.command || w.id }}</span>
+              · {{ w.name }}
+            </p>
+            <p v-if="!a.workflows.length" class="text-sm text-muted italic">No workflows</p>
+          </div>
+          <div class="rounded-lg border border-default p-3 space-y-1">
+            <p v-for="w in b.workflows" :key="w.id" class="text-sm truncate">
+              <span class="font-mono text-xs text-muted">{{ w.command || w.id }}</span>
+              · {{ w.name }}
+            </p>
+            <p v-if="!b.workflows.length" class="text-sm text-muted italic">No workflows</p>
+          </div>
+        </div>
+
+        <p class="text-xs text-muted pt-4 italic">
+          Cells with a yellow tint differ between the two departments.
+        </p>
+      </div>
+    </template>
+  </UDashboardPanel>
+</template>

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

@@ -241,6 +241,41 @@ function markedHtml(src: string): string {
   }
 }
 
+// PR90a v3.31.0 — download persona as Markdown.
+const downloadingMd = ref(false)
+async function downloadMarkdown() {
+  if (!detail.value) return
+  downloadingMd.value = true
+  try {
+    const blob = await $fetch<Blob>(
+      `${apiBase}/api/personas/${personaId}/markdown`,
+      { responseType: 'blob' },
+    )
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `${detail.value.name || personaId}.md`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+    toast.add({
+      title: 'Markdown downloaded',
+      description: `${detail.value.name || personaId}.md`,
+      color: 'success',
+      icon: 'i-lucide-download',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Download failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    downloadingMd.value = false
+  }
+}
+
 // PR85a v3.11.0 — Clone to Agent dialog.
 const cloneOpen = ref(false)
 function onCloned(agentId: string) {
@@ -526,6 +561,14 @@ const vocabOptions = [
                       size="sm"
                       @click="cloneOpen = true"
                     />
+                    <UButton
+                      label="MD"
+                      icon="i-lucide-download"
+                      variant="ghost"
+                      size="sm"
+                      :loading="downloadingMd"
+                      @click="downloadMarkdown"
+                    />
                     <UButton label="Edit" icon="i-lucide-pencil" size="sm" @click="startEdit" />
                     <UButton
                       icon="i-lucide-trash-2"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.30.0",
+  "version": "3.32.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.30.0"
+version = "3.32.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -322,6 +322,55 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
     }
 
 
+@app.get("/api/personas/{persona_id}/markdown")
+def persona_download_markdown(persona_id: str):
+    """PR90a v3.31.0 — return the persona as a Markdown file.
+
+    Renders via ObsidianPersonaStore._render so the output matches
+    exactly what gets written when the operator clicks Save with a
+    configured vault. Responds with ``text/markdown`` and an
+    attachment Content-Disposition.
+    """
+    detail = persona_detail(persona_id)
+    if "error" in detail:
+        return detail
+    from core.personas.obsidian_store import ObsidianPersonaStore
+    from core.personas.schema import (
+        Persona, PersonaDISC, PersonaEnneagram, PersonaBigFive, PersonaCommunication,
+    )
+    try:
+        persona = Persona(
+            id=detail.get("id", ""),
+            name=detail.get("name", ""),
+            title=detail.get("title", ""),
+            tagline=detail.get("tagline", ""),
+            source=detail.get("source", ""),
+            disc=PersonaDISC(**(detail.get("disc") or {})),
+            enneagram=PersonaEnneagram(**(detail.get("enneagram") or {})),
+            big_five=PersonaBigFive(**(detail.get("big_five") or {})),
+            mbti=detail.get("mbti", "INTJ"),
+            mental_models=detail.get("mental_models") or [],
+            expertise_domains=detail.get("expertise_domains") or [],
+            frameworks=detail.get("frameworks") or [],
+            key_quotes=detail.get("key_quotes") or [],
+            communication=PersonaCommunication(**(detail.get("communication") or {})),
+            bio_md=detail.get("bio_md", "") or "",
+            created_at=detail.get("created_at", ""),
+        )
+    except (TypeError, ValueError) as exc:
+        return {"error": f"persona schema mismatch: {exc}"}
+    content = ObsidianPersonaStore._render(persona)
+    filename = f"{persona.name or persona.id}.md".replace("/", "-")
+    from fastapi import Response
+    return Response(
+        content=content,
+        media_type="text/markdown",
+        headers={
+            "Content-Disposition": f'attachment; filename="{filename}"',
+        },
+    )
+
+
 @app.get("/api/agents/{agent_id}/yaml")
 def agent_download_yaml(agent_id: str):
     """PR89d v3.30.0 — return the raw YAML for the agent.