arkaos 3.28.0 → 3.30.0

package/VERSION

@@ -1 +1 @@
-3.28.0
+3.30.0

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

@@ -105,6 +105,41 @@ function markedHtml(src: string): string {
   }
 }
 
+// PR89d v3.30.0 — download YAML.
+const downloadingYaml = ref(false)
+async function downloadYaml() {
+  if (!agent.value) return
+  downloadingYaml.value = true
+  try {
+    const blob = await $fetch<Blob>(
+      `${apiBase}/api/agents/${agentId}/yaml`,
+      { responseType: 'blob' },
+    )
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `${agentId}.yaml`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+    toast.add({
+      title: 'YAML downloaded',
+      description: `${agentId}.yaml`,
+      color: 'success',
+      icon: 'i-lucide-download',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Download failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    downloadingYaml.value = false
+  }
+}
+
 // PR86c v3.17.0 — export to Obsidian.
 const exporting = ref(false)
 async function exportToVault() {
@@ -359,6 +394,14 @@ function formatTokens(n: number): string {
                     :loading="exporting"
                     @click="exportToVault"
                   />
+                  <UButton
+                    label="YAML"
+                    icon="i-lucide-download"
+                    variant="ghost"
+                    size="sm"
+                    :loading="downloadingYaml"
+                    @click="downloadYaml"
+                  />
                   <UButton
                     label="Edit"
                     icon="i-lucide-pencil"

package/dashboard/app/pages/settings.vue

@@ -50,6 +50,45 @@ watch(profile, (p) => {
 
 const savingProfile = ref(false)
 
+// PR89c v3.29.0 — vault connection test.
+interface VaultStatus {
+  configured: boolean
+  vault_path: string
+  exists: boolean
+  personas: { dir: string, count: number }
+  agents: { dir: string, count: number }
+}
+const vaultStatus = ref<VaultStatus | null>(null)
+const testingVault = ref(false)
+
+async function testVault() {
+  testingVault.value = true
+  try {
+    // Save first so the backend reads the current value
+    if (profileDraft.value.vaultPath !== profile.value?.vaultPath) {
+      await $fetch(`${apiBase}/api/profile`, {
+        method: 'POST',
+        body: { vaultPath: profileDraft.value.vaultPath },
+      })
+    }
+    vaultStatus.value = await $fetch<VaultStatus>(`${apiBase}/api/settings/vault`)
+    toast.add({
+      title: vaultStatus.value.exists ? 'Vault reachable' : 'Vault not found',
+      description: vaultStatus.value.vault_path || 'Set a path first',
+      color: vaultStatus.value.exists ? 'success' : 'warning',
+      icon: vaultStatus.value.exists ? 'i-lucide-check-circle' : 'i-lucide-alert-circle',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Test failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    testingVault.value = false
+  }
+}
+
 async function saveProfile() {
   savingProfile.value = true
   try {
@@ -326,8 +365,18 @@ const activeSection = ref<SectionId>('profile')
 
                   <UFormField
                     label="Vault path"
-                    help="Where your Obsidian vault lives. Used by the KB-first hook."
+                    help="Where your Obsidian vault lives. Used by the KB-first hook + Persona/Agent exporters."
                   >
+                    <template #hint>
+                      <UButton
+                        label="Test connection"
+                        icon="i-lucide-plug-zap"
+                        size="xs"
+                        variant="soft"
+                        :loading="testingVault"
+                        @click="testVault"
+                      />
+                    </template>
                     <UInput
                       v-model="profileDraft.vaultPath"
                       placeholder="/Users/you/Documents/Vault"
@@ -335,6 +384,50 @@ const activeSection = ref<SectionId>('profile')
                     />
                   </UFormField>
 
+                  <!-- PR89c v3.29.0 — vault connection test result -->
+                  <div
+                    v-if="vaultStatus"
+                    class="rounded-lg border p-3 text-xs space-y-1"
+                    :class="
+                      vaultStatus.exists
+                        ? 'border-emerald-500/40 bg-emerald-500/5'
+                        : 'border-yellow-500/40 bg-yellow-500/5'
+                    "
+                  >
+                    <div class="flex items-center gap-2 font-semibold">
+                      <UIcon
+                        :name="vaultStatus.exists ? 'i-lucide-check-circle' : 'i-lucide-alert-circle'"
+                        :class="vaultStatus.exists ? 'text-emerald-500 size-4' : 'text-yellow-500 size-4'"
+                      />
+                      <span v-if="!vaultStatus.configured">Vault not configured</span>
+                      <span v-else-if="!vaultStatus.exists">Path does not exist</span>
+                      <span v-else>Vault reachable</span>
+                    </div>
+                    <p v-if="vaultStatus.exists" class="text-muted font-mono">
+                      {{ vaultStatus.vault_path }}
+                    </p>
+                    <ul v-if="vaultStatus.exists" class="space-y-0.5 pt-1">
+                      <li class="flex items-center gap-2">
+                        <UIcon name="i-lucide-folder" class="size-3 text-muted" />
+                        <span class="font-mono">Personas/</span>
+                        <UBadge
+                          :label="`${vaultStatus.personas.count} files`"
+                          variant="subtle"
+                          size="xs"
+                        />
+                      </li>
+                      <li class="flex items-center gap-2">
+                        <UIcon name="i-lucide-folder" class="size-3 text-muted" />
+                        <span class="font-mono">Agents/</span>
+                        <UBadge
+                          :label="`${vaultStatus.agents.count} files`"
+                          variant="subtle"
+                          size="xs"
+                        />
+                      </li>
+                    </ul>
+                  </div>
+
                   <div class="flex justify-end pt-2">
                     <UButton
                       label="Save profile"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.28.0",
+  "version": "3.30.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.28.0"
+version = "3.30.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,30 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
     }
 
 
+@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.
+
+    Responds with ``application/x-yaml`` and an attachment Content-
+    Disposition so browsers prompt a Save As. Refuses unknown agents.
+    """
+    yaml_file = _resolve_agent_yaml(agent_id)
+    if yaml_file is None:
+        return {"error": "Agent not found"}
+    try:
+        content = yaml_file.read_text(encoding="utf-8")
+    except OSError as exc:
+        return {"error": f"read failed: {exc}"}
+    from fastapi import Response
+    return Response(
+        content=content,
+        media_type="application/x-yaml",
+        headers={
+            "Content-Disposition": f'attachment; filename="{yaml_file.name}"',
+        },
+    )
+
+
 @app.get("/api/agents/{agent_id}/history")
 def agent_history(agent_id: str, limit: int = 20):
     """PR88d v3.26.0 — combined history for an agent.
@@ -2500,6 +2524,44 @@ def settings_plugins():
 
 # --- Profile (PR63 v2.81.0) ---
 
+@app.get("/api/settings/vault")
+def settings_vault():
+    """PR89c v3.29.0 — vault path connection test.
+
+    Reads ``profile.vaultPath`` and reports back whether the path
+    exists, whether ``Personas/`` and ``Agents/`` subdirs are present,
+    and how many ``*.md`` files each contains.
+
+    Returns ``{configured, vault_path, exists, personas: {dir, count},
+    agents: {dir, count}}``.
+    """
+    from core.profile import ProfileManager
+    profile = ProfileManager().read()
+    configured = bool(profile.vaultPath)
+    vault = Path(profile.vaultPath).expanduser() if configured else None
+    exists = bool(vault and vault.exists() and vault.is_dir())
+
+    def _subdir_info(name: str) -> dict:
+        if not exists:
+            return {"dir": "", "count": 0}
+        sub = vault / name
+        if not sub.exists():
+            return {"dir": str(sub), "count": 0}
+        try:
+            count = sum(1 for _ in sub.glob("*.md"))
+        except OSError:
+            count = 0
+        return {"dir": str(sub), "count": count}
+
+    return {
+        "configured": configured,
+        "vault_path": str(vault) if vault else "",
+        "exists": exists,
+        "personas": _subdir_info("Personas"),
+        "agents": _subdir_info("Agents"),
+    }
+
+
 @app.get("/api/profile")
 def profile_get():
     """Return the operator profile from ~/.arkaos/profile.json.