arkaos 3.34.0 → 3.35.0

package/VERSION

@@ -1 +1 @@
-3.34.0
+3.35.0

package/dashboard/app/components/AgentSuggestionsCard.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+// PR91a v3.35.0 — "What's missing?" home page card.
+//
+// Lists empty departments (high severity) and depts missing a Tier 2
+// specialist (medium). Each suggestion is a link to /agents/new.
+
+interface Suggestion {
+  department: string
+  reason: string
+  recommended_tier: 1 | 2
+  severity: 'high' | 'medium'
+}
+
+const { fetchApi } = useApi()
+const { data, status } = fetchApi<{ suggestions: Suggestion[], total_gaps: number }>(
+  '/api/agents/suggestions?limit=6',
+)
+
+const suggestions = computed<Suggestion[]>(() => data.value?.suggestions ?? [])
+
+function severityColor(s: string): 'error' | 'warning' | 'neutral' {
+  return s === 'high' ? 'error' : s === 'medium' ? 'warning' : 'neutral'
+}
+</script>
+
+<template>
+  <UCard v-if="status !== 'pending' && suggestions.length > 0">
+    <template #header>
+      <div class="flex items-center justify-between">
+        <div>
+          <h3 class="text-lg font-semibold">What's missing?</h3>
+          <p class="text-xs text-muted mt-0.5">
+            {{ data?.total_gaps }} gap{{ data?.total_gaps === 1 ? '' : 's' }} across departments. Showing top {{ suggestions.length }}.
+          </p>
+        </div>
+        <UIcon name="i-lucide-sparkles" class="size-5 text-primary" />
+      </div>
+    </template>
+
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-2">
+      <NuxtLink
+        v-for="s in suggestions"
+        :key="`${s.department}:${s.recommended_tier}`"
+        to="/agents/new"
+        class="flex items-center gap-3 rounded-lg border border-default p-3 hover:border-primary/40 transition-colors"
+      >
+        <UBadge
+          :label="s.severity"
+          :color="severityColor(s.severity)"
+          variant="subtle"
+          size="xs"
+        />
+        <div class="flex-1 min-w-0">
+          <p class="text-sm font-semibold capitalize truncate">{{ s.department }}</p>
+          <p class="text-xs text-muted truncate">{{ s.reason }}</p>
+        </div>
+        <span class="text-xs font-mono text-muted shrink-0">T{{ s.recommended_tier }}</span>
+        <UIcon name="i-lucide-arrow-right" class="size-4 text-muted shrink-0" />
+      </NuxtLink>
+    </div>
+  </UCard>
+</template>

package/dashboard/app/pages/index.vue

@@ -204,6 +204,9 @@ function copyCommand(cmd: string) {
             </div>
           </UCard>
 
+          <!-- PR91a v3.35.0 — Agent gap suggestions -->
+          <AgentSuggestionsCard class="mb-6" />
+
           <!-- PR84d v3.10.0 — Top departments + Recent personas row -->
           <div class="grid grid-cols-1 md:grid-cols-2 gap-6 mb-6">
             <div>

package/package.json

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

package/scripts/dashboard-api.py

@@ -1567,6 +1567,63 @@ def agent_export_to_vault(agent_id: str):
     return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
 
 
+# --- Agent gap suggestions (PR91a v3.35.0) ---
+
+_KNOWN_DEPARTMENTS = (
+    "dev", "marketing", "brand", "finance", "strategy", "ecom", "kb",
+    "ops", "pm", "saas", "landing", "content", "community", "sales",
+    "leadership", "org",
+)
+
+
+@app.get("/api/agents/suggestions")
+def agents_suggestions(limit: int = 6):
+    """PR91a v3.35.0 — recommend agents the operator should consider creating.
+
+    Heuristics:
+      1. Departments with zero agents at all (severity: high).
+      2. Departments missing a Tier 2 specialist (severity: medium).
+
+    Each suggestion includes ``reason`` and ``recommended_tier``. Used
+    by the home page "What's missing?" card.
+    """
+    agents = _load_agents()
+    by_dept: dict[str, dict] = {}
+    for a in agents:
+        dept = a.get("department") or ""
+        if not dept:
+            continue
+        row = by_dept.setdefault(dept, {"count": 0, "tiers": set()})
+        row["count"] += 1
+        try:
+            row["tiers"].add(int(a.get("tier") or 99))
+        except (TypeError, ValueError):
+            pass
+
+    suggestions: list[dict] = []
+    for dept in _KNOWN_DEPARTMENTS:
+        info = by_dept.get(dept)
+        if info is None or info["count"] == 0:
+            suggestions.append({
+                "department": dept,
+                "reason": "no agents — department is empty",
+                "recommended_tier": 1,
+                "severity": "high",
+            })
+            continue
+        if 2 not in info["tiers"]:
+            suggestions.append({
+                "department": dept,
+                "reason": "no Tier 2 specialist",
+                "recommended_tier": 2,
+                "severity": "medium",
+            })
+    return {
+        "suggestions": suggestions[: max(0, int(limit))],
+        "total_gaps": len(suggestions),
+    }
+
+
 # --- Departments (PR89a v3.27.0) ---
 
 @app.get("/api/departments")