arkaos 3.22.0 → 3.24.0

package/VERSION

@@ -1 +1 @@
-3.22.0
+3.24.0

package/dashboard/app/layouts/default.vue

@@ -48,6 +48,13 @@ const links = [[{
   onSelect: () => {
     open.value = false
   }
+}, {
+  label: 'Workflows',
+  icon: 'i-lucide-workflow',
+  to: '/workflows',
+  onSelect: () => {
+    open.value = false
+  }
 }, {
   label: 'Knowledge',
   icon: 'i-lucide-brain',

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/dashboard/app/pages/workflows.vue

@@ -0,0 +1,191 @@
+<script setup lang="ts">
+// PR88b v3.24.0 — Workflows browser.
+//
+// Lists every YAML workflow under departments/*/workflows/*.yaml with
+// metadata pulled from the file's frontmatter-ish top keys. Selecting
+// a row opens a side panel with the raw YAML for inspection.
+
+import type { TableColumn } from '@nuxt/ui'
+
+interface Workflow {
+  id: string
+  name: string
+  description: string
+  department: string
+  tier: string
+  command: string
+  phases_count: number
+  file: string
+  content: string
+}
+
+const { fetchApi } = useApi()
+const { data, status, error, refresh } = await fetchApi<{ workflows: Workflow[] }>('/api/workflows')
+
+const workflows = computed(() => data.value?.workflows ?? [])
+const search = ref('')
+const deptFilter = ref<'all' | string>('all')
+const selected = ref<Workflow | null>(null)
+
+const departments = computed(() => {
+  const set = new Set<string>()
+  for (const w of workflows.value) if (w.department) set.add(w.department)
+  return [
+    { label: 'All departments', value: 'all' },
+    ...Array.from(set).sort().map((d) => ({ label: d, value: d })),
+  ]
+})
+
+const filtered = computed(() => {
+  let result = workflows.value
+  if (deptFilter.value !== 'all') {
+    result = result.filter((w) => w.department === deptFilter.value)
+  }
+  const q = search.value.toLowerCase().trim()
+  if (q) {
+    result = result.filter((w) =>
+      w.name.toLowerCase().includes(q)
+      || w.description.toLowerCase().includes(q)
+      || w.command.toLowerCase().includes(q)
+      || w.id.toLowerCase().includes(q),
+    )
+  }
+  return result
+})
+
+const tierColor = (tier: string) => {
+  const m: Record<string, 'primary' | 'success' | 'warning' | 'neutral'> = {
+    enterprise: 'primary',
+    focused: 'success',
+    specialist: 'warning',
+  }
+  return m[tier] ?? 'neutral'
+}
+
+const columns: TableColumn<Workflow>[] = [
+  { accessorKey: 'name', header: 'Name' },
+  { accessorKey: 'department', header: 'Department' },
+  { accessorKey: 'tier', header: 'Tier' },
+  { accessorKey: 'command', header: 'Command' },
+  { accessorKey: 'phases_count', header: 'Phases' },
+]
+</script>
+
+<template>
+  <UDashboardPanel id="workflows">
+    <template #header>
+      <UDashboardNavbar title="Workflows">
+        <template #leading>
+          <UDashboardSidebarCollapse />
+        </template>
+        <template #trailing>
+          <UBadge v-if="workflows.length" :label="String(workflows.length)" variant="subtle" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <DashboardState
+        :status="status"
+        :error="error"
+        :empty="!workflows.length"
+        empty-title="No workflows found"
+        empty-description="YAML workflows live under departments/*/workflows/."
+        empty-icon="i-lucide-workflow"
+        loading-label="Scanning workflows"
+        :on-retry="() => refresh()"
+      >
+        <div class="flex flex-wrap items-center gap-3 mb-4">
+          <UInput
+            v-model="search"
+            class="max-w-sm"
+            icon="i-lucide-search"
+            placeholder="Search name, command, description…"
+          />
+          <USelect
+            v-model="deptFilter"
+            :items="departments"
+            placeholder="Department"
+            class="min-w-44"
+          />
+          <span class="ml-auto text-xs text-muted">
+            {{ filtered.length }} workflow{{ filtered.length === 1 ? '' : 's' }}
+          </span>
+        </div>
+
+        <div class="grid grid-cols-1 xl:grid-cols-[1.4fr_1fr] gap-4">
+          <UTable
+            :data="filtered"
+            :columns="columns"
+            :loading="status === 'pending'"
+            :ui="{
+              tbody: '[&>tr]:cursor-pointer [&>tr]:hover:bg-elevated/50 [&>tr]:transition-colors',
+              th: 'py-2 first:rounded-l-lg last:rounded-r-lg border-y border-default first:border-l last:border-r',
+              td: 'border-b border-default',
+            }"
+            @select="(row: { original: Workflow }) => selected = row.original"
+          >
+            <template #name-cell="{ row }">
+              <div class="min-w-0">
+                <p class="font-medium truncate">{{ row.original.name }}</p>
+                <p class="text-xs text-muted font-mono truncate">{{ row.original.id }}</p>
+              </div>
+            </template>
+            <template #department-cell="{ row }">
+              <UBadge :label="row.original.department" variant="subtle" size="sm" />
+            </template>
+            <template #tier-cell="{ row }">
+              <UBadge
+                v-if="row.original.tier"
+                :label="row.original.tier"
+                :color="tierColor(row.original.tier)"
+                variant="subtle"
+                size="sm"
+              />
+              <span v-else class="text-xs text-muted">—</span>
+            </template>
+            <template #command-cell="{ row }">
+              <code v-if="row.original.command" class="text-xs font-mono">{{ row.original.command }}</code>
+              <span v-else class="text-xs text-muted">—</span>
+            </template>
+            <template #phases_count-cell="{ row }">
+              <span class="font-mono text-sm">{{ row.original.phases_count }}</span>
+            </template>
+          </UTable>
+
+          <div
+            v-if="selected"
+            class="rounded-lg border border-default overflow-hidden flex flex-col"
+          >
+            <div class="px-4 py-3 border-b border-default bg-elevated/30">
+              <div class="flex items-start justify-between gap-3">
+                <div class="min-w-0">
+                  <p class="text-xs text-muted uppercase tracking-wide">YAML preview</p>
+                  <p class="font-semibold truncate">{{ selected.name }}</p>
+                  <p class="text-xs text-muted font-mono truncate">{{ selected.file }}</p>
+                </div>
+                <UButton
+                  icon="i-lucide-x"
+                  variant="ghost"
+                  size="xs"
+                  aria-label="Close preview"
+                  @click="selected = null"
+                />
+              </div>
+              <p v-if="selected.description" class="text-xs text-muted mt-2">
+                {{ selected.description }}
+              </p>
+            </div>
+            <pre class="p-4 text-xs font-mono overflow-x-auto whitespace-pre">{{ selected.content }}</pre>
+          </div>
+          <div
+            v-else
+            class="rounded-lg border border-dashed border-default p-8 text-center text-sm text-muted self-start"
+          >
+            Click a row to preview its YAML.
+          </div>
+        </div>
+      </DashboardState>
+    </template>
+  </UDashboardPanel>
+</template>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.22.0",
+  "version": "3.24.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.22.0"
+version = "3.24.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,46 @@ def agent_export_to_vault(agent_id: str):
     return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
 
 
+# --- Workflows (PR88b v3.24.0) ---
+
+@app.get("/api/workflows")
+def workflows_list():
+    """Scan departments/*/workflows/*.yaml and return metadata + content."""
+    out: list[dict] = []
+    dept_root = ARKAOS_ROOT / "departments"
+    if not dept_root.exists():
+        return {"workflows": []}
+    try:
+        import yaml as _yaml
+    except ImportError:
+        return {"workflows": [], "error": "PyYAML unavailable"}
+    for path in sorted(dept_root.glob("*/workflows/*.yaml")):
+        try:
+            content = path.read_text(encoding="utf-8")
+        except OSError:
+            continue
+        try:
+            raw = _yaml.safe_load(content) or {}
+        except Exception:  # noqa: BLE001
+            raw = {}
+        if not isinstance(raw, dict):
+            continue
+        phases = raw.get("phases") if isinstance(raw.get("phases"), list) else []
+        rel = path.relative_to(ARKAOS_ROOT).as_posix()
+        out.append({
+            "id": str(raw.get("id") or path.stem),
+            "name": str(raw.get("name") or path.stem),
+            "description": str(raw.get("description") or ""),
+            "department": str(raw.get("department") or path.parent.parent.name),
+            "tier": str(raw.get("tier") or ""),
+            "command": str(raw.get("command") or ""),
+            "phases_count": len(phases),
+            "file": rel,
+            "content": content,
+        })
+    return {"workflows": out}
+
+
 # --- Sidebar stats widget (PR87d v3.22.0) ---
 
 @app.get("/api/sidebar-stats")