arkaos 3.34.0 → 3.36.0

package/VERSION

@@ -1 +1 @@
-3.34.0
+3.36.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/dashboard/app/pages/personas/index.vue

@@ -143,13 +143,55 @@ await favs.load()
 const favoritesOnly = ref(false)
 
 // PR87b v3.20.0 — import .md persona files.
+// PR91b v3.36.0 — extended with URL import.
 const importInput = ref<HTMLInputElement | null>(null)
 const importing = ref(false)
+const urlImportOpen = ref(false)
+const urlImportText = ref('')
 
 function triggerImport() {
   importInput.value?.click()
 }
 
+async function runUrlImport() {
+  const urls = urlImportText.value
+    .split('\n')
+    .map((s) => s.trim())
+    .filter(Boolean)
+  if (urls.length === 0) return
+  importing.value = true
+  try {
+    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: { urls } })
+    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-globe',
+    })
+    await refreshAll()
+    urlImportText.value = ''
+    urlImportOpen.value = false
+  } catch (err) {
+    toast.add({
+      title: 'URL import failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    importing.value = false
+  }
+}
+
 async function onImportFiles(event: Event) {
   const target = event.target as HTMLInputElement
   const files = Array.from(target.files ?? [])
@@ -312,14 +354,21 @@ 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"
-          />
+          <UDropdownMenu
+            :items="[
+              { label: 'Pick .md files…', icon: 'i-lucide-file-up', onSelect: triggerImport },
+              { label: 'From URLs…', icon: 'i-lucide-globe', onSelect: () => urlImportOpen = true },
+            ]"
+          >
+            <UButton
+              label="Import"
+              icon="i-lucide-file-up"
+              variant="soft"
+              size="sm"
+              :loading="importing"
+              trailing-icon="i-lucide-chevron-down"
+            />
+          </UDropdownMenu>
           <input
             ref="importInput"
             type="file"
@@ -328,6 +377,38 @@ async function undoTrashIds(ids: string[]) {
             class="hidden"
             @change="onImportFiles"
           />
+          <UModal v-model:open="urlImportOpen" title="Import from URLs">
+            <template #content>
+              <UCard>
+                <template #header>
+                  <h2 class="text-lg font-bold">Import personas from URLs</h2>
+                  <p class="text-xs text-muted mt-0.5">
+                    One raw .md URL per line. Files must have YAML
+                    frontmatter with <code>type: persona</code>.
+                  </p>
+                </template>
+                <UTextarea
+                  v-model="urlImportText"
+                  :rows="6"
+                  placeholder="https://raw.githubusercontent.com/owner/repo/main/personas/alex.md"
+                  class="w-full font-mono text-sm"
+                />
+                <template #footer>
+                  <div class="flex items-center justify-end gap-2">
+                    <UButton label="Cancel" variant="ghost" :disabled="importing" @click="urlImportOpen = false" />
+                    <UButton
+                      label="Import"
+                      icon="i-lucide-globe"
+                      color="primary"
+                      :loading="importing"
+                      :disabled="!urlImportText.trim()"
+                      @click="runUrlImport"
+                    />
+                  </div>
+                </template>
+              </UCard>
+            </template>
+          </UModal>
           <UButton
             label="New Persona"
             icon="i-lucide-plus"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.34.0",
+  "version": "3.36.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.36.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")
@@ -1947,16 +2004,24 @@ def global_search(q: str = "", limit: int = 20):
 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?}]}
+    Body:
+      {"files": [{"name": "Alex.md", "content": "..."}]}  # local picker
+      {"urls":  ["https://example.com/raw.md", ...]}      # remote import
+
+    Both keys are accepted; URLs are fetched server-side (PR91b
+    v3.36.0) and converted into the same `{name, content}` shape
+    before processing.
 
-    Each file MUST have YAML frontmatter with ``type: persona``. Files
-    lacking the frontmatter are flagged as failed without partial
-    side-effects.
+    Returns: {imported, failed, results: [{filename, status, id?, error?}]}
     """
-    files = body.get("files") or []
-    if not isinstance(files, list):
+    raw_files = body.get("files")
+    raw_urls = body.get("urls")
+    if raw_files is not None and not isinstance(raw_files, list):
         return {"error": "files must be a list"}
+    if raw_urls is not None and not isinstance(raw_urls, list):
+        return {"error": "urls must be a list"}
+    files = list(raw_files or [])
+    urls = list(raw_urls or [])
     mgr = _get_persona_manager()
     if not mgr:
         return {"error": "Persona manager unavailable"}
@@ -1965,6 +2030,10 @@ def personas_import(body: dict):
 
     from core.personas.obsidian_store import ObsidianPersonaStore
 
+    # Resolve URLs into {name, content} entries.
+    if urls:
+        files.extend(_fetch_url_entries(urls))
+
     imported = 0
     failed = 0
     results: list[dict] = []
@@ -1975,6 +2044,14 @@ def personas_import(body: dict):
             continue
         filename = str(entry.get("name") or "")
         content = str(entry.get("content") or "")
+        # Carry forward URL-fetch errors so the operator sees them.
+        if entry.get("fetch_error"):
+            failed += 1
+            results.append({
+                "filename": filename, "status": "failed",
+                "error": str(entry["fetch_error"]),
+            })
+            continue
         if not content.strip():
             failed += 1
             results.append({"filename": filename, "status": "failed", "error": "empty content"})
@@ -2001,6 +2078,38 @@ def personas_import(body: dict):
     return {"imported": imported, "failed": failed, "results": results}
 
 
+def _fetch_url_entries(urls: list[str]) -> list[dict]:
+    """Fetch each URL and return ``{name, content}`` entries. PR91b."""
+    import urllib.error
+    import urllib.parse
+    import urllib.request
+    out: list[dict] = []
+    for raw in urls:
+        url = str(raw or "").strip()
+        if not url:
+            continue
+        parsed = urllib.parse.urlparse(url)
+        if parsed.scheme not in ("http", "https"):
+            out.append({"name": url, "fetch_error": "scheme must be http(s)"})
+            continue
+        try:
+            req = urllib.request.Request(url, headers={"User-Agent": "ArkaOS/persona-import"})
+            with urllib.request.urlopen(req, timeout=10) as resp:
+                content = resp.read().decode("utf-8", errors="replace")
+        except urllib.error.URLError as exc:
+            out.append({"name": url, "fetch_error": f"fetch failed: {exc.reason}"})
+            continue
+        except (TimeoutError, OSError) as exc:
+            out.append({"name": url, "fetch_error": f"fetch failed: {exc}"})
+            continue
+        # Derive a filename from the URL path.
+        name = (parsed.path.rsplit("/", 1)[-1] or "imported.md").strip()
+        if not name.endswith(".md"):
+            name = f"{name or 'imported'}.md"
+        out.append({"name": name, "content": content})
+    return out
+
+
 # --- Trash / Undo (PR85b v3.12.0) ---
 
 @app.get("/api/trash")