arkaos 3.59.0 → 3.60.0

package/VERSION

@@ -1 +1 @@
-3.59.0
+3.60.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.59.0",
+  "version": "3.60.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.60.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