arkaos 3.59.0 → 3.61.0

package/VERSION

@@ -1 +1 @@
-3.59.0
+3.61.0

package/core/favorites.py

@@ -89,3 +89,36 @@ def set_favorite(kind: str, item_id: str, favorited: bool) -> dict:
     state[kind] = bucket
     _save(state)
     return {"kind": kind, "id": item_id, "favorited": favorited}
+
+
+def set_many(kind: str, ids: list[str], favorited: bool) -> dict:
+    """PR97c v3.61.0 — bulk-set favourite state for many ids.
+
+    Returns ``{kind, favorited, applied: N, total: N}`` where applied
+    counts how many ids actually changed state.
+    """
+    if kind not in _VALID_KINDS:
+        return {"error": f"unknown kind: {kind!r}", "applied": 0, "total": 0}
+    if not isinstance(ids, list):
+        return {"error": "ids must be a list", "applied": 0, "total": 0}
+    state = _load()
+    bucket = state.setdefault(kind, [])
+    existing = set(bucket)
+    applied = 0
+    for item_id in ids:
+        if not isinstance(item_id, str) or not item_id:
+            continue
+        if favorited and item_id not in existing:
+            existing.add(item_id)
+            applied += 1
+        elif not favorited and item_id in existing:
+            existing.discard(item_id)
+            applied += 1
+    state[kind] = list(existing)
+    _save(state)
+    return {
+        "kind": kind,
+        "favorited": favorited,
+        "applied": applied,
+        "total": len([i for i in ids if isinstance(i, str) and i]),
+    }

package/dashboard/app/composables/useFavorites.ts

@@ -43,6 +43,35 @@ const _useFavorites = () => {
     return state.value.personas.includes(id)
   }
 
+  // PR97c v3.61.0 — bulk set N ids in one POST.
+  async function setMany(
+    kind: 'agents' | 'personas',
+    ids: string[],
+    favorited: boolean,
+  ) {
+    try {
+      const res = await $fetch<{
+        applied?: number
+        total?: number
+        error?: string
+      }>(`${apiBase}/api/favorites/bulk`, {
+        method: 'POST',
+        body: { kind, ids, favorited },
+      })
+      if (res.error) throw new Error(res.error)
+      // Sync local state with the new server truth.
+      await load(true)
+      return res.applied ?? 0
+    } catch (err) {
+      toast.add({
+        title: 'Favorites bulk update failed',
+        description: err instanceof Error ? err.message : 'unknown error',
+        color: 'error',
+      })
+      return null
+    }
+  }
+
   async function toggle(kind: 'agents' | 'personas', id: string) {
     try {
       const res = await $fetch<{ favorited?: boolean, error?: string }>(
@@ -67,7 +96,7 @@ const _useFavorites = () => {
     }
   }
 
-  return { state, load, isAgentFavorite, isPersonaFavorite, toggle, loaded }
+  return { state, load, isAgentFavorite, isPersonaFavorite, toggle, setMany, loaded }
 }
 
 export const useFavorites = createSharedComposable(_useFavorites)

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

@@ -416,6 +416,22 @@ async function bulkDelete() {
   await refreshAll()
 }
 
+// PR97c v3.61.0 — bulk star / unstar selected agents.
+async function bulkStar(favorited: boolean) {
+  if (selected.value.size === 0) return
+  const ids = Array.from(selected.value)
+  const applied = await favs.setMany('agents', ids, favorited)
+  if (applied === null) return
+  toast.add({
+    title: favorited
+      ? `Starred ${applied} agent${applied === 1 ? '' : 's'}`
+      : `Unstarred ${applied} agent${applied === 1 ? '' : 's'}`,
+    description: applied < ids.length ? `${ids.length - applied} already in state` : undefined,
+    color: 'success',
+    icon: favorited ? 'i-lucide-star' : 'i-lucide-star-off',
+  })
+}
+
 async function undoTrashIds(ids: string[]) {
   const results = await Promise.allSettled(
     ids.map((tid) =>
@@ -636,6 +652,22 @@ async function undoTrashIds(ids: string[]) {
               @click="clearSelection"
             />
             <div class="h-5 w-px bg-default" />
+            <UButton
+              icon="i-lucide-star"
+              size="sm"
+              variant="soft"
+              color="warning"
+              aria-label="Star selected"
+              @click="bulkStar(true)"
+            />
+            <UButton
+              icon="i-lucide-star-off"
+              size="sm"
+              variant="ghost"
+              color="neutral"
+              aria-label="Unstar selected"
+              @click="bulkStar(false)"
+            />
             <UButton
               label="Compare"
               icon="i-lucide-columns-2"

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

@@ -226,6 +226,19 @@ function csvToList(value: string): string[] {
 type SuggestField = 'mental_models' | 'frameworks' | 'expertise_domains' | 'communication_avoid' | 'key_quotes'
 const suggestingField = ref<SuggestField | null>(null)
 
+// PR97b v3.60.0 — weekly usage timeline (when did agents clone from here).
+interface UsageWeek { week_start: string, count: number }
+const { data: usageTimelineData } = fetchApi<{
+  weeks: UsageWeek[]
+  total_agents: number
+  period_weeks: number
+}>(`/api/personas/${personaId}/usage-timeline?weeks=12`)
+const usageWeeks = computed<UsageWeek[]>(() => usageTimelineData.value?.weeks ?? [])
+const usageMaxCount = computed(() =>
+  Math.max(1, usageWeeks.value.reduce((acc, w) => Math.max(acc, w.count), 0)),
+)
+const usageTotalLinks = computed(() => usageTimelineData.value?.total_agents ?? 0)
+
 // PR86a v3.15.0 — favorites.
 const favs = useFavorites()
 await favs.load()
@@ -650,6 +663,44 @@ const vocabOptions = [
             </div>
           </section>
 
+          <!-- PR97b v3.60.0 — usage timeline (when agents linked) -->
+          <section
+            v-if="usageTotalLinks > 0"
+            class="rounded-xl border border-default bg-elevated/10 p-5"
+          >
+            <div class="flex items-center justify-between text-xs mb-2">
+              <span class="font-semibold text-muted uppercase tracking-wide">
+                Usage timeline (12 weeks)
+              </span>
+              <span class="font-mono text-muted">
+                {{ usageTotalLinks }} agent{{ usageTotalLinks === 1 ? '' : 's' }} linking · peak {{ usageMaxCount }}/wk
+              </span>
+            </div>
+            <svg
+              :viewBox="`0 0 ${usageWeeks.length * 16} 48`"
+              class="w-full h-12"
+              preserveAspectRatio="none"
+            >
+              <rect
+                v-for="(w, idx) in usageWeeks"
+                :key="w.week_start"
+                :x="idx * 16 + 2"
+                :y="48 - (w.count / usageMaxCount) * 46"
+                width="12"
+                :height="(w.count / usageMaxCount) * 46"
+                class="fill-primary"
+                :class="w.count === 0 ? 'opacity-20' : 'opacity-90'"
+              >
+                <title>{{ w.week_start }} · {{ w.count }} agent{{ w.count === 1 ? '' : 's' }} linked</title>
+              </rect>
+            </svg>
+            <p class="text-xs text-muted mt-1.5">
+              Buckets reflect the YAML mtime of agents that currently link to
+              this persona — approximation of when they were cloned / edited
+              to depend on this profile.
+            </p>
+          </section>
+
           <!-- BIO (PR86d) -->
           <section
             v-if="(detail as any).bio_md"

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

@@ -418,6 +418,22 @@ async function bulkDelete() {
   await refreshAll()
 }
 
+// PR97c v3.61.0 — bulk star / unstar selected personas.
+async function bulkStar(favorited: boolean) {
+  if (selected.value.size === 0) return
+  const ids = Array.from(selected.value)
+  const applied = await favs.setMany('personas', ids, favorited)
+  if (applied === null) return
+  toast.add({
+    title: favorited
+      ? `Starred ${applied} persona${applied === 1 ? '' : 's'}`
+      : `Unstarred ${applied} persona${applied === 1 ? '' : 's'}`,
+    description: applied < ids.length ? `${ids.length - applied} already in state` : undefined,
+    color: 'success',
+    icon: favorited ? 'i-lucide-star' : 'i-lucide-star-off',
+  })
+}
+
 async function undoTrashIds(ids: string[]) {
   const results = await Promise.allSettled(
     ids.map((tid) =>
@@ -721,6 +737,22 @@ async function undoTrashIds(ids: string[]) {
               @click="clearSelection"
             />
             <div class="h-5 w-px bg-default" />
+            <UButton
+              icon="i-lucide-star"
+              size="sm"
+              variant="soft"
+              color="warning"
+              aria-label="Star selected"
+              @click="bulkStar(true)"
+            />
+            <UButton
+              icon="i-lucide-star-off"
+              size="sm"
+              variant="ghost"
+              color="neutral"
+              aria-label="Unstar selected"
+              @click="bulkStar(false)"
+            />
             <UButton
               label="Export ZIP"
               icon="i-lucide-archive"

package/package.json

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

package/scripts/dashboard-api.py

@@ -1371,6 +1371,74 @@ def _obsidian_store_available() -> bool:
         return False
 
 
+@app.get("/api/personas/{persona_id}/usage-timeline")
+def persona_usage_timeline(persona_id: str, weeks: int = 12):
+    """PR97b v3.60.0 — histogram of agent YAML mtimes for agents that
+    link to this persona. Approximation of "when did people clone /
+    create agents from this persona over time".
+
+    Returns ``{weeks: [{week_start, count}], total_agents, period_weeks}``
+    bucketed by ISO week start (Monday). Capped at 52 weeks.
+
+    Uses filesystem mtime for the agent YAML — works even without a
+    git history.
+    """
+    try:
+        weeks_int = int(weeks) if weeks is not None else 12
+    except (TypeError, ValueError):
+        weeks_int = 12
+    capped_weeks = max(1, min(weeks_int, 52))
+
+    try:
+        import yaml as _yaml
+    except ImportError:
+        return {"weeks": [], "total_agents": 0, "period_weeks": capped_weeks}
+
+    dept_root = ARKAOS_ROOT / "departments"
+    if not dept_root.exists():
+        return {"weeks": [], "total_agents": 0, "period_weeks": capped_weeks}
+
+    from datetime import datetime, timedelta, timezone
+    now = datetime.now(timezone.utc)
+    today = now.date()
+    # Monday of current ISO week.
+    current_monday = today - timedelta(days=today.weekday())
+    buckets: dict[str, int] = {}
+    for offset in range(capped_weeks):
+        m = current_monday - timedelta(weeks=capped_weeks - 1 - offset)
+        buckets[m.isoformat()] = 0
+    cutoff_monday = current_monday - timedelta(weeks=capped_weeks - 1)
+
+    linked_total = 0
+    for path in dept_root.glob("*/agents/*.yaml"):
+        try:
+            raw = _yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+        except Exception:  # noqa: BLE001
+            continue
+        if not isinstance(raw, dict):
+            continue
+        linked = raw.get("linked_personas") or []
+        if not isinstance(linked, list) or persona_id not in linked:
+            continue
+        linked_total += 1
+        try:
+            mtime = datetime.fromtimestamp(path.stat().st_mtime, tz=timezone.utc).date()
+        except OSError:
+            continue
+        if mtime < cutoff_monday:
+            continue
+        monday = mtime - timedelta(days=mtime.weekday())
+        key = monday.isoformat()
+        if key in buckets:
+            buckets[key] += 1
+
+    out = [
+        {"week_start": k, "count": buckets[k]}
+        for k in sorted(buckets.keys())
+    ]
+    return {"weeks": out, "total_agents": linked_total, "period_weeks": capped_weeks}
+
+
 @app.get("/api/personas/usage")
 def personas_usage():
     """PR77 v2.95.0 — reverse lookup: how many agents link to each
@@ -2539,6 +2607,22 @@ def favorites_toggle(kind: str, item_id: str):
     return _fav.toggle(kind, item_id)
 
 
+@app.post("/api/favorites/bulk")
+def favorites_bulk(body: dict):
+    """PR97c v3.61.0 — bulk star/unstar many ids in one shot.
+
+    Body: ``{"kind": "agents"|"personas", "ids": [...], "favorited": bool}``
+    Returns ``{kind, favorited, applied, total}``.
+    """
+    if not isinstance(body, dict):
+        return {"error": "body must be an object"}
+    kind = (body.get("kind") or "").strip()
+    ids = body.get("ids") or []
+    favorited = bool(body.get("favorited"))
+    from core import favorites as _fav
+    return _fav.set_many(kind, ids if isinstance(ids, list) else [], favorited)
+
+
 # --- Global search (PR85d v3.14.0) ---
 
 @app.get("/api/search")