arkaos 3.58.0 → 3.59.0

package/VERSION

@@ -1 +1 @@
-3.58.0
+3.59.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/package.json

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

package/scripts/dashboard-api.py

@@ -1941,6 +1941,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."""