arkaos 3.19.0 → 3.21.0

package/VERSION

@@ -1 +1 @@
-3.19.0
+3.21.0

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

@@ -0,0 +1,225 @@
+<script setup lang="ts">
+// PR87c v3.21.0 — Compare two agents side-by-side.
+//
+// Driven by `?ids=a,b` query string. Reads both agent payloads via
+// /api/agents/{id} and renders identity / DNA / knowledge / comms in
+// two columns. Cells where the values differ get a subtle warning
+// tint so the operator can spot deltas quickly.
+
+const route = useRoute()
+const { fetchApi } = useApi()
+
+const ids = computed<string[]>(() => {
+  const raw = route.query.ids
+  const str = Array.isArray(raw) ? raw.join(',') : (raw ?? '')
+  return String(str).split(',').map((s) => s.trim()).filter(Boolean).slice(0, 2)
+})
+
+interface AgentDetail {
+  id: string
+  name?: string
+  role?: string
+  department?: string
+  tier?: number
+  model?: 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
+  }
+  expertise?: { domains?: string[], frameworks?: string[], depth?: string, years_equivalent?: number }
+  mental_models?: { primary?: string[], secondary?: string[] }
+  communication?: {
+    tone?: string
+    vocabulary_level?: string
+    preferred_format?: string
+    language?: string
+  }
+}
+
+const { data: a, status: aStatus } = fetchApi<AgentDetail>(
+  () => ids.value[0] ? `/api/agents/${ids.value[0]}` : '',
+)
+const { data: b, status: bStatus } = fetchApi<AgentDetail>(
+  () => ids.value[1] ? `/api/agents/${ids.value[1]}` : '',
+)
+
+const loading = computed(() => aStatus.value === 'pending' || bStatus.value === 'pending')
+const errorMsg = computed(() => {
+  if (ids.value.length < 2) return 'Pass two agent ids via ?ids=a,b'
+  if (a.value && (a.value as any).error) return `Left agent: ${(a.value as any).error}`
+  if (b.value && (b.value as any).error) return `Right agent: ${(b.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="agents-compare">
+    <template #header>
+      <UDashboardNavbar title="Compare agents">
+        <template #leading>
+          <UButton icon="i-lucide-arrow-left" variant="ghost" size="sm" to="/agents" 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="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="a && b" class="space-y-4 max-w-6xl">
+        <section class="grid grid-cols-2 gap-3">
+          <div class="rounded-lg border border-default p-4">
+            <p class="text-xs text-muted">Left</p>
+            <h2 class="text-xl font-bold">{{ a.name }}</h2>
+            <p class="text-sm text-muted">{{ a.role }} · {{ a.department }}</p>
+          </div>
+          <div class="rounded-lg border border-default p-4">
+            <p class="text-xs text-muted">Right</p>
+            <h2 class="text-xl font-bold">{{ b.name }}</h2>
+            <p class="text-sm text-muted">{{ b.role }} · {{ b.department }}</p>
+          </div>
+        </section>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Identity</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', diffClass(a.tier, b.tier)]">
+            <p class="text-xs text-muted">Tier</p>
+            <p class="text-sm font-mono">{{ a.tier ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.tier, b.tier)]">
+            <p class="text-xs text-muted">Tier</p>
+            <p class="text-sm font-mono">{{ b.tier ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.model, b.model)]">
+            <p class="text-xs text-muted">Model</p>
+            <p class="text-sm font-mono">{{ a.model ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.model, b.model)]">
+            <p class="text-xs text-muted">Model</p>
+            <p class="text-sm font-mono">{{ b.model ?? '—' }}</p>
+          </div>
+        </div>
+
+        <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(a.mbti, b.mbti)]">
+            <p class="text-xs text-muted">MBTI</p>
+            <p class="text-lg font-mono font-bold">{{ a.mbti ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.mbti, b.mbti)]">
+            <p class="text-xs text-muted">MBTI</p>
+            <p class="text-lg font-mono font-bold">{{ b.mbti ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.disc?.primary}/${a.disc?.secondary}`, `${b.disc?.primary}/${b.disc?.secondary}`)]">
+            <p class="text-xs text-muted">DISC</p>
+            <p class="text-lg font-mono font-bold">{{ a.disc?.primary ?? '?' }}/{{ a.disc?.secondary ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.disc?.primary}/${a.disc?.secondary}`, `${b.disc?.primary}/${b.disc?.secondary}`)]">
+            <p class="text-xs text-muted">DISC</p>
+            <p class="text-lg font-mono font-bold">{{ b.disc?.primary ?? '?' }}/{{ b.disc?.secondary ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.enneagram?.type}w${a.enneagram?.wing}`, `${b.enneagram?.type}w${b.enneagram?.wing}`)]">
+            <p class="text-xs text-muted">Enneagram</p>
+            <p class="text-lg font-mono font-bold">{{ a.enneagram?.type ?? '?' }}w{{ a.enneagram?.wing ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.enneagram?.type}w${a.enneagram?.wing}`, `${b.enneagram?.type}w${b.enneagram?.wing}`)]">
+            <p class="text-xs text-muted">Enneagram</p>
+            <p class="text-lg font-mono font-bold">{{ b.enneagram?.type ?? '?' }}w{{ b.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(a.big_five?.[k], b.big_five?.[k])]">
+              <span class="text-xs text-muted w-36 shrink-0 capitalize">{{ k }}</span>
+              <span class="font-mono text-sm">{{ a.big_five?.[k] ?? '—' }}</span>
+            </div>
+            <div :class="['rounded-lg border p-2 flex items-center gap-3', diffClass(a.big_five?.[k], b.big_five?.[k])]">
+              <span class="text-xs text-muted w-36 shrink-0 capitalize">{{ k }}</span>
+              <span class="font-mono text-sm">{{ b.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(a.expertise?.domains, b.expertise?.domains)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="d in a.expertise?.domains" :key="d">{{ d }}</li>
+              <li v-if="!a.expertise?.domains?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(a.expertise?.domains, b.expertise?.domains)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="d in b.expertise?.domains" :key="d">{{ d }}</li>
+              <li v-if="!b.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(a.expertise?.frameworks, b.expertise?.frameworks)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="f in a.expertise?.frameworks" :key="f">{{ f }}</li>
+              <li v-if="!a.expertise?.frameworks?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(a.expertise?.frameworks, b.expertise?.frameworks)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="f in b.expertise?.frameworks" :key="f">{{ f }}</li>
+              <li v-if="!b.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 (primary)</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(a.mental_models?.primary, b.mental_models?.primary)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="m in a.mental_models?.primary" :key="m">{{ m }}</li>
+              <li v-if="!a.mental_models?.primary?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(a.mental_models?.primary, b.mental_models?.primary)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="m in b.mental_models?.primary" :key="m">{{ m }}</li>
+              <li v-if="!b.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 the two agents.
+        </p>
+      </div>
+    </template>
+  </UDashboardPanel>
+</template>

package/dashboard/app/pages/agents/index.vue

@@ -220,6 +220,12 @@ const departmentMoveOptions = [
   onSelect: () => bulkMove(d),
 }))
 
+function openCompare() {
+  if (selected.value.size !== 2) return
+  const ids = Array.from(selected.value).slice(0, 2).join(',')
+  navigateTo(`/agents/compare?ids=${ids}`)
+}
+
 async function bulkMove(targetDept: string) {
   if (selected.value.size === 0) return
   const ids = Array.from(selected.value)
@@ -552,6 +558,14 @@ async function undoTrashIds(ids: string[]) {
               @click="clearSelection"
             />
             <div class="h-5 w-px bg-default" />
+            <UButton
+              label="Compare"
+              icon="i-lucide-columns-2"
+              size="sm"
+              variant="soft"
+              :disabled="selected.size !== 2"
+              @click="openCompare"
+            />
             <UDropdownMenu :items="departmentMoveOptions">
               <UButton
                 label="Move to..."

package/dashboard/app/pages/personas/index.vue

@@ -142,6 +142,56 @@ const favs = useFavorites()
 await favs.load()
 const favoritesOnly = ref(false)
 
+// PR87b v3.20.0 — import .md persona files.
+const importInput = ref<HTMLInputElement | null>(null)
+const importing = ref(false)
+
+function triggerImport() {
+  importInput.value?.click()
+}
+
+async function onImportFiles(event: Event) {
+  const target = event.target as HTMLInputElement
+  const files = Array.from(target.files ?? [])
+  target.value = ''
+  if (files.length === 0) return
+  importing.value = true
+  try {
+    const payload = await Promise.all(
+      files.map(async (f) => ({
+        name: f.name,
+        content: await f.text(),
+      })),
+    )
+    const res = await $fetch<{
+      imported: number
+      failed: number
+      results: Array<{ filename: string, status: string, id?: string, error?: string }>
+      error?: string
+    }>(`${apiBase}/api/personas/import`, { method: 'POST', body: { files: payload } })
+    if (res.error) throw new Error(res.error)
+    toast.add({
+      title: res.imported > 0
+        ? `Imported ${res.imported} persona${res.imported === 1 ? '' : 's'}`
+        : 'Nothing imported',
+      description: res.failed > 0 ? `${res.failed} failed` : undefined,
+      color: res.imported > 0 && res.failed === 0
+        ? 'success'
+        : res.imported > 0 ? 'warning' : 'error',
+      icon: 'i-lucide-file-down',
+    })
+    await refreshAll()
+  } catch (err) {
+    toast.add({
+      title: 'Import failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    importing.value = false
+  }
+}
+
 // PR83b v3.4.0 — bulk selection + delete.
 const toast = useToast()
 const confirmDialog = useConfirmDialog()
@@ -262,6 +312,22 @@ async function undoTrashIds(ids: string[]) {
           />
         </template>
         <template #right>
+          <UButton
+            label="Import .md"
+            icon="i-lucide-file-up"
+            variant="soft"
+            size="sm"
+            :loading="importing"
+            @click="triggerImport"
+          />
+          <input
+            ref="importInput"
+            type="file"
+            accept=".md,text/markdown"
+            multiple
+            class="hidden"
+            @change="onImportFiles"
+          />
           <UButton
             label="New Persona"
             icon="i-lucide-plus"

package/package.json

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

package/scripts/dashboard-api.py

@@ -1494,6 +1494,66 @@ def global_search(q: str = "", limit: int = 20):
     return {"results": results[: max(0, int(limit))]}
 
 
+# --- Persona import from Markdown (PR87b v3.20.0) ---
+
+@app.post("/api/personas/import")
+def personas_import(body: dict):
+    """Import persona Markdown files (frontmatter + body) into the store.
+
+    Body: {"files": [{"name": "Alex.md", "content": "<full file body>"}]}
+    Returns: {imported, failed, results: [{filename, status, id?, error?}]}
+
+    Each file MUST have YAML frontmatter with ``type: persona``. Files
+    lacking the frontmatter are flagged as failed without partial
+    side-effects.
+    """
+    files = body.get("files") or []
+    if not isinstance(files, list):
+        return {"error": "files must be a list"}
+    mgr = _get_persona_manager()
+    if not mgr:
+        return {"error": "Persona manager unavailable"}
+
+    from pathlib import Path as _Path
+
+    from core.personas.obsidian_store import ObsidianPersonaStore
+
+    imported = 0
+    failed = 0
+    results: list[dict] = []
+    for entry in files:
+        if not isinstance(entry, dict):
+            failed += 1
+            results.append({"filename": "(invalid)", "status": "failed", "error": "not an object"})
+            continue
+        filename = str(entry.get("name") or "")
+        content = str(entry.get("content") or "")
+        if not content.strip():
+            failed += 1
+            results.append({"filename": filename, "status": "failed", "error": "empty content"})
+            continue
+        fm = ObsidianPersonaStore._parse_frontmatter(content)
+        if not fm or str(fm.get("type", "")).lower() != "persona":
+            failed += 1
+            results.append({
+                "filename": filename, "status": "failed",
+                "error": "missing or invalid frontmatter (type: persona required)",
+            })
+            continue
+        try:
+            persona = ObsidianPersonaStore._frontmatter_to_persona(
+                fm, _Path(filename or "imported.md"),
+            )
+            mgr.create(persona)
+            imported += 1
+            results.append({"filename": filename, "status": "ok", "id": persona.id})
+        except Exception as exc:  # noqa: BLE001
+            failed += 1
+            results.append({"filename": filename, "status": "failed", "error": str(exc)})
+
+    return {"imported": imported, "failed": failed, "results": results}
+
+
 # --- Trash / Undo (PR85b v3.12.0) ---
 
 @app.get("/api/trash")