arkaos 3.14.0 → 3.15.0

package/VERSION

@@ -1 +1 @@
-3.14.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/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/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.14.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.14.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,20 @@ 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")