arkaos 3.13.0 → 3.15.0

package/VERSION

@@ -1 +1 @@
-3.13.0
+3.15.0

package/core/favorites.py

@@ -0,0 +1,91 @@
+"""Favorites store for agents and personas (PR86a v3.15.0).
+
+Single JSON file at ``~/.arkaos/favorites.json`` shaped as
+``{"agents": ["<id>", ...], "personas": ["<id>", ...]}``.
+
+Survives across sessions, mutated by the dashboard. No tier-0 protection
+needed — favouriting is read-only intent.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Literal
+
+FavoriteKind = Literal["agents", "personas"]
+_VALID_KINDS: tuple[str, ...] = ("agents", "personas")
+
+
+def _store_path() -> Path:
+    return Path.home() / ".arkaos" / "favorites.json"
+
+
+def _load() -> dict[str, list[str]]:
+    path = _store_path()
+    if not path.exists():
+        return {"agents": [], "personas": []}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return {"agents": [], "personas": []}
+    if not isinstance(data, dict):
+        return {"agents": [], "personas": []}
+    return {
+        "agents": [str(x) for x in (data.get("agents") or []) if isinstance(x, str)],
+        "personas": [str(x) for x in (data.get("personas") or []) if isinstance(x, str)],
+    }
+
+
+def _save(state: dict[str, list[str]]) -> None:
+    path = _store_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    tmp = path.with_suffix(".json.tmp")
+    tmp.write_text(json.dumps(state, indent=2), encoding="utf-8")
+    tmp.replace(path)
+
+
+def list_favorites() -> dict[str, list[str]]:
+    """Return the current favourites payload."""
+    return _load()
+
+
+def is_favorite(kind: str, item_id: str) -> bool:
+    if kind not in _VALID_KINDS:
+        return False
+    state = _load()
+    return item_id in state.get(kind, [])
+
+
+def toggle(kind: str, item_id: str) -> dict:
+    """Flip the favourite state. Returns ``{kind, id, favorited}``."""
+    if kind not in _VALID_KINDS:
+        return {"error": f"unknown kind: {kind!r}"}
+    if not item_id:
+        return {"error": "id is required"}
+    state = _load()
+    bucket = state.setdefault(kind, [])
+    if item_id in bucket:
+        bucket.remove(item_id)
+        favorited = False
+    else:
+        bucket.append(item_id)
+        favorited = True
+    state[kind] = bucket
+    _save(state)
+    return {"kind": kind, "id": item_id, "favorited": favorited}
+
+
+def set_favorite(kind: str, item_id: str, favorited: bool) -> dict:
+    """Force a specific state. Useful for tests / bulk operations."""
+    if kind not in _VALID_KINDS:
+        return {"error": f"unknown kind: {kind!r}"}
+    state = _load()
+    bucket = state.setdefault(kind, [])
+    if favorited and item_id not in bucket:
+        bucket.append(item_id)
+    elif not favorited and item_id in bucket:
+        bucket.remove(item_id)
+    state[kind] = bucket
+    _save(state)
+    return {"kind": kind, "id": item_id, "favorited": favorited}

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

@@ -25,6 +25,7 @@ const groups = [
   {
     title: 'Actions',
     items: [
+      { keys: ['/'], label: 'Open global search' },
       { keys: ['n'], label: 'New (context-aware — agent / persona)' },
       { keys: ['?'], label: 'Toggle this help' },
     ],

package/dashboard/app/composables/useDashboard.ts

@@ -5,6 +5,8 @@ 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
@@ -27,9 +29,10 @@ const _useDashboard = () => {
     'g-r': () => router.push('/trash'),
     n: () => contextualNew(),
     '?': () => { shortcutsHelpOpen.value = !shortcutsHelpOpen.value },
+    '/': () => { searchOpen.value = true },
   })
 
-  return { shortcutsHelpOpen }
+  return { shortcutsHelpOpen, searchOpen }
 }
 
 export const useDashboard = createSharedComposable(_useDashboard)

package/dashboard/app/composables/useFavorites.ts

@@ -0,0 +1,73 @@
+// PR86a v3.15.0 — shared favourites state + toggle helper.
+//
+// Single source of truth for the dashboard so the star button in
+// agents/personas detail pages stays in sync with the filter chip
+// on the index tables.
+
+import { createSharedComposable } from '@vueuse/core'
+
+interface FavoritesPayload {
+  agents: string[]
+  personas: string[]
+}
+
+const _useFavorites = () => {
+  const { apiBase } = useApi()
+  const toast = useToast()
+  const state = useState<FavoritesPayload>('favorites', () => ({
+    agents: [],
+    personas: [],
+  }))
+  const loaded = useState<boolean>('favoritesLoaded', () => false)
+
+  async function load(force = false) {
+    if (loaded.value && !force) return
+    try {
+      const res = await $fetch<FavoritesPayload>(`${apiBase}/api/favorites`)
+      state.value = {
+        agents: res.agents ?? [],
+        personas: res.personas ?? [],
+      }
+      loaded.value = true
+    } catch {
+      // Best-effort — leave defaults
+      loaded.value = true
+    }
+  }
+
+  function isAgentFavorite(id: string): boolean {
+    return state.value.agents.includes(id)
+  }
+
+  function isPersonaFavorite(id: string): boolean {
+    return state.value.personas.includes(id)
+  }
+
+  async function toggle(kind: 'agents' | 'personas', id: string) {
+    try {
+      const res = await $fetch<{ favorited?: boolean, error?: string }>(
+        `${apiBase}/api/favorites/${kind}/${id}`,
+        { method: 'POST' },
+      )
+      if (res.error) throw new Error(res.error)
+      const bucket = state.value[kind]
+      if (res.favorited && !bucket.includes(id)) {
+        state.value = { ...state.value, [kind]: [...bucket, id] }
+      } else if (!res.favorited) {
+        state.value = { ...state.value, [kind]: bucket.filter((x) => x !== id) }
+      }
+      return res.favorited
+    } catch (err) {
+      toast.add({
+        title: 'Favorite toggle failed',
+        description: err instanceof Error ? err.message : 'unknown error',
+        color: 'error',
+      })
+      return null
+    }
+  }
+
+  return { state, load, isAgentFavorite, isPersonaFavorite, toggle, loaded }
+}
+
+export const useFavorites = createSharedComposable(_useFavorites)

package/dashboard/app/layouts/default.vue

@@ -133,5 +133,6 @@ const links = [[{
 
     <slot />
     <KeyboardShortcutsHelp />
+    <GlobalSearch />
   </UDashboardGroup>
 </template>

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

@@ -59,6 +59,10 @@ function formatRelative(iso: string | null): string {
   return `${months}mo ago`
 }
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+
 // PR76 — edit drawer state
 const editOpen = ref(false)
 
@@ -268,12 +272,22 @@ function formatTokens(n: number): string {
                   </h1>
                   <p class="text-base md:text-lg text-muted mt-0.5">{{ agent.role }}</p>
                 </div>
-                <UButton
-                  label="Edit"
-                  icon="i-lucide-pencil"
-                  size="sm"
-                  @click="openEditor"
-                />
+                <div class="flex items-center gap-2">
+                  <UButton
+                    icon="i-lucide-star"
+                    :color="favs.isAgentFavorite(agent.id) ? 'warning' : 'neutral'"
+                    :variant="favs.isAgentFavorite(agent.id) ? 'soft' : 'ghost'"
+                    size="sm"
+                    :aria-label="favs.isAgentFavorite(agent.id) ? 'Unfavorite' : 'Favorite'"
+                    @click="favs.toggle('agents', agent.id)"
+                  />
+                  <UButton
+                    label="Edit"
+                    icon="i-lucide-pencil"
+                    size="sm"
+                    @click="openEditor"
+                  />
+                </div>
               </div>
               <div class="flex flex-wrap items-center gap-2 pt-1">
                 <UBadge :label="agent.department" variant="subtle" />

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

@@ -111,6 +111,10 @@ const filteredAgents = computed(() => {
     result = result.filter(agent => String(agent.tier) === tierFilter.value)
   }
 
+  if (favoritesOnly.value) {
+    result = result.filter(agent => favs.isAgentFavorite(agent.id))
+  }
+
   return result
 })
 
@@ -139,6 +143,7 @@ const tierColor = (tier: number) => {
 
 const columns: TableColumn<Agent>[] = [
   { id: 'select',              header: '' },
+  { id: 'favorite',            header: '' },
   { accessorKey: 'name',       header: 'Name' },
   { accessorKey: 'role',       header: 'Role' },
   { accessorKey: 'department', header: 'Department' },
@@ -157,6 +162,11 @@ function goToAgent(id: string) {
   navigateTo(`/agents/${id}`)
 }
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+const favoritesOnly = ref(false)
+
 // PR83b v3.4.0 — bulk selection + delete.
 // PR84b v3.8.0 — bulk move department.
 const confirmDialog = useConfirmDialog()
@@ -371,6 +381,15 @@ async function undoTrashIds(ids: string[]) {
             aria-label="Filter by tier"
           />
 
+          <UButton
+            :label="favoritesOnly ? 'All' : 'Favorites'"
+            :icon="favoritesOnly ? 'i-lucide-star' : 'i-lucide-star'"
+            :color="favoritesOnly ? 'warning' : 'neutral'"
+            :variant="favoritesOnly ? 'soft' : 'outline'"
+            size="sm"
+            @click="favoritesOnly = !favoritesOnly"
+          />
+
           <span class="ml-auto text-xs text-muted">
             {{ totalFiltered }} agent{{ totalFiltered !== 1 ? 's' : '' }}
           </span>
@@ -404,6 +423,16 @@ async function undoTrashIds(ids: string[]) {
               @click.stop
             />
           </template>
+          <template #favorite-cell="{ row }">
+            <UButton
+              :icon="favs.isAgentFavorite(row.original.id) ? 'i-lucide-star' : 'i-lucide-star'"
+              :color="favs.isAgentFavorite(row.original.id) ? 'warning' : 'neutral'"
+              :variant="favs.isAgentFavorite(row.original.id) ? 'soft' : 'ghost'"
+              size="xs"
+              :aria-label="favs.isAgentFavorite(row.original.id) ? 'Unfavorite' : 'Favorite'"
+              @click.stop="favs.toggle('agents', row.original.id)"
+            />
+          </template>
           <template #name-cell="{ row }">
             <button class="text-left font-medium text-primary hover:underline" @click="goToAgent(row.original.id)">
               {{ row.original.name }}

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

@@ -226,6 +226,10 @@ function csvToList(value: string): string[] {
 type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains' | 'communication_avoid' | 'key_quotes'
 const suggestingField = ref<SuggestField | null>(null)
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+
 // PR85a v3.11.0 — Clone to Agent dialog.
 const cloneOpen = ref(false)
 function onCloned(agentId: string) {
@@ -473,6 +477,14 @@ const vocabOptions = [
                     </p>
                   </div>
                   <div class="flex items-center gap-2">
+                    <UButton
+                      icon="i-lucide-star"
+                      :color="favs.isPersonaFavorite(detail.id) ? 'warning' : 'neutral'"
+                      :variant="favs.isPersonaFavorite(detail.id) ? 'soft' : 'ghost'"
+                      size="sm"
+                      :aria-label="favs.isPersonaFavorite(detail.id) ? 'Unfavorite' : 'Favorite'"
+                      @click="favs.toggle('personas', detail.id)"
+                    />
                     <UButton
                       label="Clone to Agent"
                       icon="i-lucide-copy-plus"

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

@@ -77,6 +77,9 @@ const filteredPersonas = computed<Persona[]>(() => {
       return src === sourceFilter.value
     })
   }
+  if (favoritesOnly.value) {
+    result = result.filter((p) => favs.isPersonaFavorite(p.id))
+  }
   return result
 })
 
@@ -119,6 +122,7 @@ function agentCount(personaId: string): number {
 
 const columns: TableColumn<Persona>[] = [
   { id: 'select',              header: '' },
+  { id: 'favorite',            header: '' },
   { accessorKey: 'name',       header: 'Name' },
   { accessorKey: 'title',      header: 'Title' },
   { accessorKey: 'source',     header: 'Source' },
@@ -133,6 +137,11 @@ function goToPersona(id: string) {
   navigateTo(`/personas/${id}`)
 }
 
+// PR86a v3.15.0 — favorites.
+const favs = useFavorites()
+await favs.load()
+const favoritesOnly = ref(false)
+
 // PR83b v3.4.0 — bulk selection + delete.
 const toast = useToast()
 const confirmDialog = useConfirmDialog()
@@ -299,6 +308,15 @@ async function undoTrashIds(ids: string[]) {
             aria-label="Filter by source store"
           />
 
+          <UButton
+            :label="favoritesOnly ? 'All' : 'Favorites'"
+            icon="i-lucide-star"
+            :color="favoritesOnly ? 'warning' : 'neutral'"
+            :variant="favoritesOnly ? 'soft' : 'outline'"
+            size="sm"
+            @click="favoritesOnly = !favoritesOnly"
+          />
+
           <span class="ml-auto text-xs text-muted">
             {{ totalFiltered }} persona{{ totalFiltered !== 1 ? 's' : '' }}
           </span>
@@ -333,6 +351,16 @@ async function undoTrashIds(ids: string[]) {
               @click.stop
             />
           </template>
+          <template #favorite-cell="{ row }">
+            <UButton
+              icon="i-lucide-star"
+              :color="favs.isPersonaFavorite(row.original.id) ? 'warning' : 'neutral'"
+              :variant="favs.isPersonaFavorite(row.original.id) ? 'soft' : 'ghost'"
+              size="xs"
+              :aria-label="favs.isPersonaFavorite(row.original.id) ? 'Unfavorite' : 'Favorite'"
+              @click.stop="favs.toggle('personas', row.original.id)"
+            />
+          </template>
           <template #name-cell="{ row }">
             <span class="font-medium">{{ row.original.name }}</span>
           </template>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.13.0",
+  "version": "3.15.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.13.0"
+version = "3.15.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,113 @@ def persona_delete(persona_id: str):
     return {"error": "Persona not found"}
 
 
+# --- Favorites (PR86a v3.15.0) ---
+
+@app.get("/api/favorites")
+def favorites_list():
+    from core import favorites as _fav
+    return _fav.list_favorites()
+
+
+@app.post("/api/favorites/{kind}/{item_id}")
+def favorites_toggle(kind: str, item_id: str):
+    from core import favorites as _fav
+    return _fav.toggle(kind, item_id)
+
+
+# --- 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")