arkaos 3.58.0 → 3.60.0

package/VERSION

@@ -1 +1 @@
-3.58.0
+3.60.0

package/dashboard/app/pages/departments/[dept].vue

@@ -37,6 +37,25 @@ const { data, status, error, refresh } = await fetchApi<DeptDetail>(
   `/api/departments/${deptId.value}`,
 )
 
+// PR97a v3.59.0 — 30d activity sparkline for this department.
+interface SparklineDay {
+  date: string
+  calls: number
+  cost_usd: number | null
+}
+const { data: sparklineData } = fetchApi<{
+  days: SparklineDay[]
+  period_days: number
+  department: string
+}>(() => deptId.value ? `/api/departments/${deptId.value}/activity-sparkline?days=30` : '')
+const sparkline = computed<SparklineDay[]>(() => sparklineData.value?.days ?? [])
+const sparklineMaxCalls = computed(() =>
+  Math.max(1, sparkline.value.reduce((acc, d) => Math.max(acc, d.calls), 0)),
+)
+const sparklineTotalCalls = computed(() =>
+  sparkline.value.reduce((acc, d) => acc + d.calls, 0),
+)
+
 // PR90b v3.32.0 — Compare with another department.
 const { data: deptListData } = fetchApi<{ departments: Array<{ department: string }> }>(
   '/api/departments',
@@ -177,6 +196,39 @@ const tierColor = (tier: number | undefined) => {
         :on-retry="() => refresh()"
       >
         <div v-if="detail" class="space-y-5 max-w-5xl">
+          <!-- PR97a v3.59.0 — 30d sparkline -->
+          <section
+            v-if="sparklineTotalCalls > 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">
+                Daily calls (30d)
+              </span>
+              <span class="font-mono text-muted">
+                {{ sparklineTotalCalls }} total · max {{ sparklineMaxCalls }}/day
+              </span>
+            </div>
+            <svg
+              :viewBox="`0 0 ${sparkline.length * 8} 48`"
+              class="w-full h-12"
+              preserveAspectRatio="none"
+            >
+              <rect
+                v-for="(day, idx) in sparkline"
+                :key="day.date"
+                :x="idx * 8 + 1"
+                :y="48 - (day.calls / sparklineMaxCalls) * 46"
+                width="6"
+                :height="(day.calls / sparklineMaxCalls) * 46"
+                class="fill-primary"
+                :class="day.calls === 0 ? 'opacity-20' : 'opacity-90'"
+              >
+                <title>{{ day.date }} · {{ day.calls }} calls</title>
+              </rect>
+            </svg>
+          </section>
+
           <!-- Stats row -->
           <section class="grid grid-cols-2 md:grid-cols-4 gap-3">
             <div class="rounded-xl border border-default p-4 bg-elevated/20">

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.58.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.58.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
@@ -1941,6 +2009,80 @@ def department_merge(src: str, dst: str):
     }
 
 
+@app.get("/api/departments/{dept_id}/activity-sparkline")
+def department_activity_sparkline(dept_id: str, days: int = 30):
+    """PR97a v3.59.0 — daily calls/cost series for a department.
+
+    Returns ``{days: [{date, calls, cost_usd}], period_days, department}``
+    pre-seeded with zeros so the SVG renders without gaps. Counts every
+    telemetry row with ``subagent:<dept>`` or ``subagent:<dept>:<agent>``
+    category. Capped at 90 days.
+    """
+    dept_id = dept_id.strip().lower()
+    try:
+        days_int = int(days) if days is not None else 30
+    except (TypeError, ValueError):
+        days_int = 30
+    capped_days = max(1, min(days_int, 90))
+
+    # Bail early if department has no agents — keep parity with detail endpoint.
+    if not any(a.get("department") == dept_id for a in _load_agents()):
+        return {"error": "Department not found or has no agents"}
+
+    try:
+        from core.runtime.llm_cost_telemetry import read_entries
+    except Exception:
+        return {"days": []}
+
+    from datetime import datetime, timedelta, timezone
+    today = datetime.now(timezone.utc).date()
+    buckets: dict[str, dict] = {}
+    for offset in range(capped_days):
+        d = today - timedelta(days=capped_days - 1 - offset)
+        buckets[d.isoformat()] = {
+            "date": d.isoformat(),
+            "calls": 0,
+            "cost_usd": 0.0,
+            "cost_known": False,
+        }
+    cutoff = today - timedelta(days=capped_days - 1)
+    prefix_dept = f"subagent:{dept_id}"
+    for entry in read_entries():
+        raw_ts = entry.get("ts") or ""
+        if not isinstance(raw_ts, str):
+            continue
+        try:
+            ts = datetime.fromisoformat(raw_ts.replace("Z", "+00:00"))
+        except ValueError:
+            continue
+        if ts.date() < cutoff:
+            continue
+        cat = str(entry.get("category") or "")
+        # subagent:<dept> OR subagent:<dept>:<agent>
+        if cat != prefix_dept and not cat.startswith(prefix_dept + ":"):
+            continue
+        key = ts.date().isoformat()
+        if key not in buckets:
+            continue
+        buckets[key]["calls"] += 1
+        cost = entry.get("estimated_cost_usd")
+        if isinstance(cost, (int, float)):
+            buckets[key]["cost_usd"] += float(cost)
+            buckets[key]["cost_known"] = True
+
+    out: list[dict] = []
+    for k in sorted(buckets.keys()):
+        bucket = buckets[k]
+        out.append({
+            "date": bucket["date"],
+            "calls": bucket["calls"],
+            "cost_usd": (
+                round(bucket["cost_usd"], 6) if bucket["cost_known"] else None
+            ),
+        })
+    return {"days": out, "period_days": capped_days, "department": dept_id}
+
+
 @app.get("/api/departments/{dept_id}")
 def department_detail(dept_id: str):
     """Full department detail: agents, workflows, 30d cost."""