arkaos 3.12.0 → 3.14.0

package/VERSION

@@ -1 +1 @@
-3.12.0
+3.14.0

package/dashboard/app/components/GlobalSearch.vue

@@ -0,0 +1,154 @@
+<script setup lang="ts">
+// PR85d v3.14.0 — global search command palette.
+//
+// Opens via `/` shortcut. Debounced fetch against /api/search hits
+// agents, personas, departments, commands. Navigate by Enter or click.
+
+const { searchOpen } = useDashboard()
+const { apiBase } = useApi()
+const router = useRouter()
+
+interface SearchResult {
+  kind: 'agent' | 'persona' | 'department' | 'command'
+  id: string
+  label: string
+  sublabel: string
+  to: string
+}
+
+const query = ref('')
+const results = ref<SearchResult[]>([])
+const loading = ref(false)
+let abortCtl: AbortController | null = null
+let debounceTimer: ReturnType<typeof setTimeout> | null = null
+
+watch(query, (q) => {
+  if (debounceTimer) clearTimeout(debounceTimer)
+  if (abortCtl) abortCtl.abort()
+  if (!q.trim()) {
+    results.value = []
+    loading.value = false
+    return
+  }
+  debounceTimer = setTimeout(async () => {
+    loading.value = true
+    abortCtl = new AbortController()
+    try {
+      const res = await $fetch<{ results: SearchResult[] }>(
+        `${apiBase}/api/search`,
+        { query: { q, limit: 20 }, signal: abortCtl.signal },
+      )
+      results.value = res.results ?? []
+    } catch {
+      results.value = []
+    } finally {
+      loading.value = false
+    }
+  }, 180)
+})
+
+watch(searchOpen, (open) => {
+  if (!open) {
+    query.value = ''
+    results.value = []
+  }
+})
+
+function pickResult(r: SearchResult) {
+  searchOpen.value = false
+  router.push(r.to)
+}
+
+const kindMeta: Record<SearchResult['kind'], { icon: string, color: string }> = {
+  agent:      { icon: 'i-lucide-users',          color: 'text-primary' },
+  persona:    { icon: 'i-lucide-user-plus',      color: 'text-emerald-500' },
+  department: { icon: 'i-lucide-folder-tree',    color: 'text-amber-500' },
+  command:    { icon: 'i-lucide-terminal',       color: 'text-blue-500' },
+}
+</script>
+
+<template>
+  <UModal
+    v-model:open="searchOpen"
+    title="Search"
+    :ui="{ content: 'max-w-2xl' }"
+  >
+    <template #content>
+      <UCard :ui="{ body: 'p-0' }">
+        <template #header>
+          <div class="flex items-center gap-3">
+            <UIcon name="i-lucide-search" class="size-5 text-muted shrink-0" />
+            <UInput
+              v-model="query"
+              placeholder="Search agents, personas, departments, commands…"
+              size="lg"
+              autofocus
+              :ui="{ root: 'flex-1', base: 'border-0 shadow-none ring-0 focus:ring-0 px-0' }"
+            />
+            <kbd class="px-1.5 py-0.5 rounded bg-elevated/50 text-xs font-mono text-muted shrink-0">
+              esc
+            </kbd>
+          </div>
+        </template>
+
+        <div class="max-h-[60vh] overflow-y-auto">
+          <div v-if="loading" class="p-6 text-center text-sm text-muted">
+            <UIcon name="i-lucide-loader-2" class="size-4 animate-spin inline" />
+            Searching…
+          </div>
+          <div
+            v-else-if="!query.trim()"
+            class="p-6 text-center text-sm text-muted"
+          >
+            Start typing to search across the whole workspace.
+          </div>
+          <div
+            v-else-if="results.length === 0"
+            class="p-6 text-center text-sm text-muted"
+          >
+            No matches for <span class="font-mono">{{ query }}</span>.
+          </div>
+          <ul v-else class="divide-y divide-default">
+            <li
+              v-for="r in results"
+              :key="`${r.kind}:${r.id}`"
+              class="px-4 py-2.5 hover:bg-elevated/40 cursor-pointer transition-colors"
+              @click="pickResult(r)"
+            >
+              <div class="flex items-center gap-3">
+                <UIcon
+                  :name="kindMeta[r.kind].icon"
+                  class="size-4 shrink-0"
+                  :class="kindMeta[r.kind].color"
+                />
+                <div class="min-w-0 flex-1">
+                  <p class="text-sm font-semibold truncate">{{ r.label }}</p>
+                  <p class="text-xs text-muted truncate">{{ r.sublabel }}</p>
+                </div>
+                <UBadge
+                  :label="r.kind"
+                  variant="subtle"
+                  size="xs"
+                  class="capitalize shrink-0"
+                />
+              </div>
+            </li>
+          </ul>
+        </div>
+
+        <template #footer>
+          <div class="text-xs text-muted flex items-center gap-3">
+            <span>
+              <kbd class="px-1.5 py-0.5 rounded bg-elevated/50 font-mono">/</kbd>
+              opens this
+            </span>
+            <span>
+              <kbd class="px-1.5 py-0.5 rounded bg-elevated/50 font-mono">esc</kbd>
+              closes
+            </span>
+          </div>
+        </template>
+      </UCard>
+    </template>
+  </UModal>
+</template>

package/dashboard/app/components/KeyboardShortcutsHelp.vue

@@ -0,0 +1,90 @@
+<script setup lang="ts">
+// PR85c v3.13.0 — Keyboard shortcuts help overlay.
+//
+// Triggered by `?` (defineShortcuts in useDashboard). Lists all
+// registered shortcuts grouped by category.
+
+const { shortcutsHelpOpen } = useDashboard()
+
+const groups = [
+  {
+    title: 'Navigation',
+    items: [
+      { keys: ['g', 'h'], label: 'Home / command center' },
+      { keys: ['g', 'a'], label: 'Agents' },
+      { keys: ['g', 'p'], label: 'Personas' },
+      { keys: ['g', 'c'], label: 'Commands' },
+      { keys: ['g', 'b'], label: 'Budget' },
+      { keys: ['g', 't'], label: 'Tasks' },
+      { keys: ['g', 'k'], label: 'Knowledge' },
+      { keys: ['g', 'e'], label: 'Health' },
+      { keys: ['g', 'r'], label: 'Trash' },
+      { keys: ['g', 's'], label: 'Settings' },
+    ],
+  },
+  {
+    title: 'Actions',
+    items: [
+      { keys: ['/'], label: 'Open global search' },
+      { keys: ['n'], label: 'New (context-aware — agent / persona)' },
+      { keys: ['?'], label: 'Toggle this help' },
+    ],
+  },
+]
+</script>
+
+<template>
+  <UModal
+    v-model:open="shortcutsHelpOpen"
+    title="Keyboard shortcuts"
+    :ui="{ content: 'max-w-lg' }"
+  >
+    <template #content>
+      <UCard>
+        <template #header>
+          <div class="flex items-center justify-between gap-3">
+            <div>
+              <h2 class="text-lg font-bold">Keyboard shortcuts</h2>
+              <p class="text-xs text-muted mt-0.5">
+                Press <kbd class="px-1.5 py-0.5 rounded bg-elevated/50 text-xs font-mono">?</kbd> anywhere to toggle this.
+              </p>
+            </div>
+            <UButton
+              icon="i-lucide-x"
+              variant="ghost"
+              size="sm"
+              aria-label="Close"
+              @click="shortcutsHelpOpen = false"
+            />
+          </div>
+        </template>
+
+        <div class="space-y-5">
+          <div v-for="g in groups" :key="g.title">
+            <h3 class="text-xs font-semibold uppercase tracking-wide text-muted mb-2">
+              {{ g.title }}
+            </h3>
+            <ul class="space-y-1.5">
+              <li
+                v-for="item in g.items"
+                :key="item.label"
+                class="flex items-center justify-between gap-3 text-sm"
+              >
+                <span>{{ item.label }}</span>
+                <div class="flex items-center gap-1">
+                  <kbd
+                    v-for="(k, idx) in item.keys"
+                    :key="idx"
+                    class="px-2 py-0.5 rounded bg-elevated/50 border border-default text-xs font-mono font-semibold"
+                  >
+                    {{ k }}
+                  </kbd>
+                </div>
+              </li>
+            </ul>
+          </div>
+        </div>
+      </UCard>
+    </template>
+  </UModal>
+</template>

package/dashboard/app/composables/useDashboard.ts

@@ -1,19 +1,38 @@
 import { createSharedComposable } from '@vueuse/core'
 
+// PR85c v3.13.0 — extended shortcut map + context-aware `n` + help modal.
 const _useDashboard = () => {
   const router = useRouter()
+  const route = useRoute()
+  const shortcutsHelpOpen = useState('shortcutsHelpOpen', () => false)
+  // PR85d v3.14.0 — global search palette state.
+  const searchOpen = useState('searchOpen', () => false)
+
+  function contextualNew() {
+    const path = route.path
+    if (path.startsWith('/agents')) return router.push('/agents/new')
+    if (path.startsWith('/personas')) return router.push('/personas/new')
+    // Default: go to agents/new (most common new-thing action)
+    return router.push('/agents/new')
+  }
 
   defineShortcuts({
     'g-h': () => router.push('/'),
     'g-a': () => router.push('/agents'),
+    'g-p': () => router.push('/personas'),
     'g-c': () => router.push('/commands'),
     'g-b': () => router.push('/budget'),
     'g-t': () => router.push('/tasks'),
     'g-k': () => router.push('/knowledge'),
-    'g-e': () => router.push('/health')
+    'g-e': () => router.push('/health'),
+    'g-s': () => router.push('/settings'),
+    'g-r': () => router.push('/trash'),
+    n: () => contextualNew(),
+    '?': () => { shortcutsHelpOpen.value = !shortcutsHelpOpen.value },
+    '/': () => { searchOpen.value = true },
   })
 
-  return {}
+  return { shortcutsHelpOpen, searchOpen }
 }
 
 export const useDashboard = createSharedComposable(_useDashboard)

package/dashboard/app/layouts/default.vue

@@ -1,6 +1,9 @@
 <script setup lang="ts">
 import type { NavigationMenuItem } from '@nuxt/ui'
 
+// PR85c v3.13.0 — registers keyboard shortcuts globally.
+useDashboard()
+
 const open = ref(false)
 
 const links = [[{
@@ -129,5 +132,7 @@ const links = [[{
     </UDashboardSidebar>
 
     <slot />
+    <KeyboardShortcutsHelp />
+    <GlobalSearch />
   </UDashboardGroup>
 </template>

package/package.json

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

package/scripts/dashboard-api.py

@@ -1331,6 +1331,99 @@ def persona_delete(persona_id: str):
     return {"error": "Persona not found"}
 
 
+# --- Global search (PR85d v3.14.0) ---
+
+@app.get("/api/search")
+def global_search(q: str = "", limit: int = 20):
+    """Fuzzy substring search across agents, personas, departments, commands.
+
+    Returns a flat list of result objects with a shape the dashboard
+    UCommandPalette can render directly:
+      {results: [{kind, id, label, sublabel, to}]}
+    """
+    query = (q or "").strip().lower()
+    if not query:
+        return {"results": []}
+    results: list[dict] = []
+
+    # Agents
+    for a in _load_agents():
+        haystack = " ".join(filter(None, [
+            str(a.get("name") or ""),
+            str(a.get("role") or ""),
+            str(a.get("department") or ""),
+            str(a.get("id") or ""),
+        ])).lower()
+        if query in haystack:
+            results.append({
+                "kind": "agent",
+                "id": a.get("id"),
+                "label": a.get("name") or a.get("id"),
+                "sublabel": f"{a.get('role') or '—'} · {a.get('department') or '—'}",
+                "to": f"/agents/{a.get('id')}",
+            })
+
+    # Personas
+    mgr = _get_persona_manager()
+    if mgr:
+        try:
+            for p in (mgr.list() or []):
+                haystack = " ".join(filter(None, [
+                    str(p.get("name") or ""),
+                    str(p.get("title") or ""),
+                    str(p.get("source") or ""),
+                    str(p.get("mbti") or ""),
+                    str(p.get("id") or ""),
+                ])).lower()
+                if query in haystack:
+                    results.append({
+                        "kind": "persona",
+                        "id": p.get("id"),
+                        "label": p.get("name") or p.get("id"),
+                        "sublabel": f"{p.get('title') or '—'} · {p.get('mbti') or '—'}",
+                        "to": f"/personas/{p.get('id')}",
+                    })
+        except Exception:
+            pass
+
+    # Departments — derive distinct list from agents
+    seen_depts: set[str] = set()
+    for a in _load_agents():
+        d = a.get("department")
+        if d:
+            seen_depts.add(d)
+    for d in sorted(seen_depts):
+        if query in d.lower():
+            results.append({
+                "kind": "department",
+                "id": d,
+                "label": d.capitalize(),
+                "sublabel": "Department",
+                "to": f"/agents?department={d}",
+            })
+
+    # Commands
+    try:
+        for c in _load_commands():
+            haystack = " ".join(filter(None, [
+                str(c.get("command") or ""),
+                str(c.get("description") or ""),
+                str(c.get("department") or ""),
+            ])).lower()
+            if query in haystack:
+                results.append({
+                    "kind": "command",
+                    "id": c.get("command"),
+                    "label": c.get("command"),
+                    "sublabel": c.get("description") or c.get("department") or "",
+                    "to": "/commands",
+                })
+    except Exception:
+        pass
+
+    return {"results": results[: max(0, int(limit))]}
+
+
 # --- Trash / Undo (PR85b v3.12.0) ---
 
 @app.get("/api/trash")