arkaos 2.85.0 → 2.87.0

package/VERSION

@@ -1 +1 @@
-2.85.0
+2.87.0

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

@@ -2,12 +2,73 @@
 import type { TableColumn } from '@nuxt/ui'
 import type { Agent } from '~/types'
 
-const { fetchApi } = useApi()
+const { fetchApi, apiBase } = useApi()
+const toast = useToast()
 
 const { data, status, error, refresh } = await fetchApi<{ agents: Agent[], total: number }>('/api/agents')
 
+// PR69 v2.86.0 — per-department activity from PR47 telemetry.
+// Used to badge agents whose department has run recently and to
+// surface "no activity yet" hint when a department's never been
+// invoked. Failure-tolerant — returns empty if telemetry unavailable.
+interface ActivityRow {
+  call_count: number
+  total_cost_usd: number | null
+  total_tokens_in: number
+  total_tokens_out: number
+}
+
+const {
+  data: activityData,
+  refresh: refreshActivity,
+} = fetchApi<{ by_department: Record<string, ActivityRow>, period: string }>(
+  '/api/agents/activity?period=week',
+)
+
 const agents = computed(() => data.value?.agents ?? [])
 
+function deptActivity(dept: string): ActivityRow | undefined {
+  return activityData.value?.by_department?.[dept]
+}
+
+const copied = ref<string | null>(null)
+let copyTimer: ReturnType<typeof setTimeout> | null = null
+
+async function copyAgentMention(agent: Agent) {
+  if (typeof navigator === 'undefined' || !navigator.clipboard) {
+    toast.add({ title: 'Clipboard unavailable', color: 'warning' })
+    return
+  }
+  // The most useful copy for an operator: a ready-to-paste mention
+  // that names the agent + their role so the orchestrator can dispatch.
+  const text = `Use ${agent.name} (${agent.role}, dept ${agent.department}, tier ${agent.tier}) for this task.`
+  try {
+    await navigator.clipboard.writeText(text)
+    copied.value = agent.id
+    if (copyTimer) clearTimeout(copyTimer)
+    copyTimer = setTimeout(() => { copied.value = null; copyTimer = null }, 1500)
+    toast.add({
+      title: 'Copied',
+      description: `${agent.name} mention ready to paste.`,
+      color: 'success',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Copy failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  }
+}
+
+onBeforeUnmount(() => {
+  if (copyTimer) clearTimeout(copyTimer)
+})
+
+async function refreshAll() {
+  await Promise.all([refresh(), refreshActivity()])
+}
+
 const search = ref('')
 const departmentFilter = ref('all')
 const tierFilter = ref('all')
@@ -77,35 +138,18 @@ const tierColor = (tier: number) => {
 }
 
 const columns: TableColumn<Agent>[] = [
-  {
-    accessorKey: 'name',
-    header: 'Name'
-  },
-  {
-    accessorKey: 'role',
-    header: 'Role'
-  },
-  {
-    accessorKey: 'department',
-    header: 'Department'
-  },
-  {
-    accessorKey: 'tier',
-    header: 'Tier'
-  },
+  { accessorKey: 'name',       header: 'Name' },
+  { accessorKey: 'role',       header: 'Role' },
+  { accessorKey: 'department', header: 'Department' },
+  { accessorKey: 'tier',       header: 'Tier' },
   {
     accessorFn: (row: Agent) => row.disc?.primary ?? '-',
     id: 'disc',
-    header: 'DISC'
-  },
-  {
-    accessorKey: 'mbti',
-    header: 'MBTI'
+    header: 'DISC',
   },
-  {
-    id: 'actions',
-    header: ''
-  }
+  { accessorKey: 'mbti',       header: 'MBTI' },
+  { id: 'activity',            header: 'Activity (7d)' },
+  { id: 'actions',             header: '' },
 ]
 
 function goToAgent(id: string) {
@@ -134,7 +178,7 @@ function goToAgent(id: string) {
         empty-title="No agents found"
         empty-icon="i-lucide-users"
         loading-label="Loading agents"
-        :on-retry="() => refresh()"
+        :on-retry="() => refreshAll()"
       >
         <div class="flex flex-wrap items-center gap-3 mb-4">
           <UInput
@@ -195,8 +239,33 @@ function goToAgent(id: string) {
           <template #mbti-cell="{ row }">
             <span class="font-mono text-sm">{{ row.original.mbti || '-' }}</span>
           </template>
+          <template #activity-cell="{ row }">
+            <template v-if="deptActivity(row.original.department)">
+              <div class="flex items-center gap-2">
+                <span class="inline-block size-2 rounded-full bg-green-500" />
+                <span class="text-xs font-mono">
+                  {{ deptActivity(row.original.department)?.call_count ?? 0 }} calls
+                </span>
+              </div>
+            </template>
+            <span v-else class="text-xs text-muted">—</span>
+          </template>
           <template #actions-cell="{ row }">
-            <UButton size="xs" variant="ghost" icon="i-lucide-arrow-right" @click="goToAgent(row.original.id)" />
+            <UButton
+              :icon="copied === row.original.id ? 'i-lucide-check' : 'i-lucide-copy'"
+              :color="copied === row.original.id ? 'success' : 'neutral'"
+              variant="ghost"
+              size="xs"
+              aria-label="Copy agent mention"
+              @click.stop="copyAgentMention(row.original)"
+            />
+            <UButton
+              size="xs"
+              variant="ghost"
+              icon="i-lucide-arrow-right"
+              aria-label="Open agent detail"
+              @click="goToAgent(row.original.id)"
+            />
           </template>
         </UTable>
 

package/dashboard/app/pages/health.vue

@@ -1,14 +1,153 @@
 <script setup lang="ts">
-import type { HealthCheck } from '~/types'
+// PR70 v2.87.0 — Health page polish.
+// - 30s auto-refresh (paused while tab is hidden) + manual refresh
+// - Last-checked timestamp in header
+// - Severity-aware rendering (fail = red, warn = yellow)
+// - Copy-fix button when a check has a fix command
+// - Healthy banner ignores warnings (only blocking failures matter)
+
+interface HealthCheck {
+  name: string
+  passed: boolean
+  fix: string
+  severity: 'fail' | 'warn'
+}
+
+interface HealthPayload {
+  checks: HealthCheck[]
+  passed: number
+  total: number
+  failed_blocking: number
+  warning_count: number
+  healthy: boolean
+  ts: string
+}
 
 const { fetchApi } = useApi()
+const toast = useToast()
+
+const {
+  data,
+  status,
+  error,
+  refresh,
+} = await fetchApi<HealthPayload>('/api/health')
+
+// ─── Auto-refresh ───────────────────────────────────────────────────────
+
+let pollTimer: ReturnType<typeof setInterval> | null = null
+
+function startPolling() {
+  stopPolling()
+  pollTimer = setInterval(() => {
+    refresh()
+  }, 30_000)
+}
+
+function stopPolling() {
+  if (pollTimer !== null) {
+    clearInterval(pollTimer)
+    pollTimer = null
+  }
+}
+
+function handleVisibility() {
+  if (typeof document === 'undefined') return
+  if (document.hidden) {
+    stopPolling()
+  } else {
+    refresh()
+    startPolling()
+  }
+}
+
+onMounted(() => {
+  if (typeof document !== 'undefined') {
+    document.addEventListener('visibilitychange', handleVisibility)
+  }
+  startPolling()
+})
+
+onBeforeUnmount(() => {
+  stopPolling()
+  if (typeof document !== 'undefined') {
+    document.removeEventListener('visibilitychange', handleVisibility)
+  }
+})
+
+// ─── Copy fix ───────────────────────────────────────────────────────────
+
+const copied = ref<string | null>(null)
+let copyTimer: ReturnType<typeof setTimeout> | null = null
+
+async function copyFix(check: HealthCheck) {
+  if (!check.fix) return
+  if (typeof navigator === 'undefined' || !navigator.clipboard) {
+    toast.add({ title: 'Clipboard unavailable', color: 'warning' })
+    return
+  }
+  try {
+    await navigator.clipboard.writeText(check.fix)
+    copied.value = check.name
+    if (copyTimer) clearTimeout(copyTimer)
+    copyTimer = setTimeout(() => { copied.value = null; copyTimer = null }, 1500)
+    toast.add({
+      title: 'Fix copied',
+      description: check.fix,
+      color: 'success',
+    })
+  } catch (err) {
+    toast.add({
+      title: 'Copy failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  }
+}
 
-const { data, status, error, refresh } = await fetchApi<{ checks: HealthCheck[], passed: number, total: number }>('/api/health')
+onBeforeUnmount(() => {
+  if (copyTimer) clearTimeout(copyTimer)
+})
 
-const checks = computed(() => data.value?.checks ?? [])
+// ─── Format helpers ─────────────────────────────────────────────────────
+
+function formatTs(iso: string | undefined): string {
+  if (!iso) return ''
+  try {
+    return new Intl.DateTimeFormat('en-US', {
+      hour: '2-digit', minute: '2-digit', second: '2-digit',
+    }).format(new Date(iso))
+  } catch {
+    return iso
+  }
+}
+
+type CheckStatus = 'pass' | 'warn' | 'fail'
+
+function statusOf(c: HealthCheck): CheckStatus {
+  if (c.passed) return 'pass'
+  return c.severity === 'warn' ? 'warn' : 'fail'
+}
+
+const STATUS_META: Record<CheckStatus, { icon: string; color: string; label: string }> = {
+  pass: { icon: 'i-lucide-check-circle', color: 'text-green-500',  label: 'Pass' },
+  warn: { icon: 'i-lucide-alert-circle',  color: 'text-yellow-500', label: 'Warn' },
+  fail: { icon: 'i-lucide-x-circle',      color: 'text-red-500',    label: 'Fail' },
+}
+
+function statusBadgeColor(s: CheckStatus): 'success' | 'warning' | 'error' {
+  return s === 'pass' ? 'success' : s === 'warn' ? 'warning' : 'error'
+}
+
+// ─── Aggregate display ──────────────────────────────────────────────────
+
+const checks = computed<HealthCheck[]>(() => data.value?.checks ?? [])
 const passed = computed(() => data.value?.passed ?? 0)
 const total = computed(() => data.value?.total ?? 0)
-const allPassed = computed(() => passed.value === total.value && total.value > 0)
+const failedBlocking = computed(() => data.value?.failed_blocking ?? 0)
+const warningCount = computed(() => data.value?.warning_count ?? 0)
+const allPassed = computed(() => failedBlocking.value === 0 && warningCount.value === 0 && total.value > 0)
+const someWarnings = computed(() => failedBlocking.value === 0 && warningCount.value > 0)
 </script>
 
 <template>
@@ -19,11 +158,28 @@ const allPassed = computed(() => passed.value === total.value && total.value > 0
           <UDashboardSidebarCollapse />
         </template>
         <template #trailing>
+          <span
+            v-if="data?.ts"
+            class="text-xs text-muted"
+            :title="data.ts"
+          >
+            Last checked {{ formatTs(data.ts) }}
+          </span>
           <UBadge
             v-if="data"
             :label="`${passed}/${total}`"
-            :color="allPassed ? 'success' : 'warning'"
+            :color="allPassed ? 'success' : someWarnings ? 'warning' : 'error'"
             variant="subtle"
+            class="ml-3"
+          />
+        </template>
+        <template #right>
+          <UButton
+            label="Refresh"
+            variant="ghost"
+            icon="i-lucide-refresh-cw"
+            size="sm"
+            @click="refresh()"
           />
         </template>
       </UDashboardNavbar>
@@ -39,45 +195,81 @@ const allPassed = computed(() => passed.value === total.value && total.value > 0
         loading-label="Loading health checks"
         :on-retry="() => refresh()"
       >
-        <!-- Overall Status -->
+        <!-- Overall banner -->
         <div
           class="mb-6 rounded-lg border p-6 text-center"
-          :class="allPassed ? 'border-green-500/30 bg-green-500/5' : 'border-yellow-500/30 bg-yellow-500/5'"
+          :class="allPassed
+            ? 'border-green-500/30 bg-green-500/5'
+            : someWarnings
+              ? 'border-yellow-500/30 bg-yellow-500/5'
+              : 'border-red-500/30 bg-red-500/5'"
         >
           <UIcon
-            :name="allPassed ? 'i-lucide-check-circle' : 'i-lucide-alert-circle'"
-            :class="allPassed ? 'text-green-500' : 'text-yellow-500'"
+            :name="allPassed
+              ? 'i-lucide-check-circle'
+              : someWarnings
+                ? 'i-lucide-alert-circle'
+                : 'i-lucide-x-circle'"
+            :class="allPassed
+              ? 'text-green-500'
+              : someWarnings ? 'text-yellow-500' : 'text-red-500'"
             class="size-12"
           />
           <p class="mt-2 text-lg font-semibold text-highlighted">
-            {{ allPassed ? 'All Checks Passing' : `${total - passed} Check(s) Failing` }}
+            <template v-if="allPassed">All Checks Passing</template>
+            <template v-else-if="someWarnings">
+              {{ warningCount }} Warning{{ warningCount === 1 ? '' : 's' }}
+            </template>
+            <template v-else>
+              {{ failedBlocking }} Blocking Failure{{ failedBlocking === 1 ? '' : 's' }}
+            </template>
+          </p>
+          <p class="text-sm text-muted">
+            {{ passed }} of {{ total }} checks passed
+            <template v-if="warningCount && failedBlocking">
+              · {{ warningCount }} warn · {{ failedBlocking }} blocking
+            </template>
           </p>
-          <p class="text-sm text-muted">{{ passed }} of {{ total }} checks passed</p>
         </div>
 
-        <!-- Individual Checks -->
+        <!-- Check list -->
         <div class="space-y-3">
           <div
             v-for="check in checks"
             :key="check.name"
-            class="flex items-start gap-3 rounded-lg border border-default p-4"
+            class="flex items-start gap-3 rounded-lg border p-4"
+            :class="{
+              'border-default': check.passed,
+              'border-yellow-500/30 bg-yellow-500/5': !check.passed && check.severity === 'warn',
+              'border-red-500/30 bg-red-500/5': !check.passed && check.severity === 'fail',
+            }"
           >
             <UIcon
-              :name="check.passed ? 'i-lucide-check-circle' : 'i-lucide-x-circle'"
-              :class="check.passed ? 'text-green-500' : 'text-red-500'"
+              :name="STATUS_META[statusOf(check)].icon"
+              :class="STATUS_META[statusOf(check)].color"
               class="mt-0.5 size-5 shrink-0"
             />
-            <div class="flex-1">
+            <div class="flex-1 min-w-0">
               <h4 class="font-medium text-highlighted">{{ check.name }}</h4>
               <p v-if="!check.passed && check.fix" class="mt-1 text-sm text-muted">
-                Fix: {{ check.fix }}
+                Fix: <code class="font-mono text-xs">{{ check.fix }}</code>
               </p>
             </div>
+            <UButton
+              v-if="!check.passed && check.fix"
+              :icon="copied === check.name ? 'i-lucide-check' : 'i-lucide-copy'"
+              :color="copied === check.name ? 'success' : 'neutral'"
+              variant="ghost"
+              size="xs"
+              aria-label="Copy fix command"
+              @click="copyFix(check)"
+            />
             <UBadge
-              :label="check.passed ? 'Pass' : 'Fail'"
-              :color="check.passed ? 'success' : 'error'"
+              :label="STATUS_META[statusOf(check)].label"
+              :color="statusBadgeColor(statusOf(check))"
               variant="subtle"
               size="sm"
+              class="shrink-0"
             />
           </div>
         </div>

package/dashboard/app/types/index.d.ts

@@ -175,6 +175,9 @@ export interface HealthCheck {
   name: string
   passed: boolean
   fix: string
+  // PR70 v2.87.0 — backend now tags every check with a severity.
+  // 'fail' is must-pass; 'warn' is recommended but non-blocking.
+  severity?: 'fail' | 'warn'
 }
 
 export interface Persona {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "2.85.0",
+  "version": "2.87.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "2.85.0"
+version = "2.87.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -173,6 +173,51 @@ def agents(dept: Optional[str] = Query(None)):
     return {"agents": data, "total": len(data)}
 
 
+@app.get("/api/agents/activity")
+def agents_activity(period: str = "week"):
+    """Per-department activity from the PR47 LLM cost telemetry.
+
+    Returns ``{by_department: {dev: {call_count, total_cost_usd,
+    total_tokens_in, total_tokens_out}}}`` derived from rows whose
+    ``category`` field starts with ``subagent:``. Each agent's
+    dispatch is currently tagged at the department level — finer
+    per-agent attribution will land when orchestrators set
+    ``ARKA_CALL_CATEGORY=subagent:<dept>:<agent>``.
+    """
+    try:
+        from core.runtime.llm_cost_telemetry import summarise, VALID_PERIODS
+    except Exception:  # pragma: no cover - import guard
+        return {"by_department": {}, "period": period}
+    if period not in VALID_PERIODS:
+        period = "week"
+    summary = summarise(period=period)
+    out: dict[str, dict] = {}
+    for category, row in (summary.by_category or {}).items():
+        if not isinstance(category, str) or not category.startswith("subagent:"):
+            continue
+        dept = category.split(":", 1)[1] or "unknown"
+        bucket = out.setdefault(dept, {
+            "call_count": 0,
+            "total_cost_usd": 0.0,
+            "any_cost_known": False,
+            "total_tokens_in": 0,
+            "total_tokens_out": 0,
+        })
+        bucket["call_count"] += row.get("call_count", 0)
+        bucket["total_tokens_in"] += row.get("total_tokens_in", 0)
+        bucket["total_tokens_out"] += row.get("total_tokens_out", 0)
+        cost = row.get("total_cost_usd")
+        if isinstance(cost, (int, float)):
+            bucket["total_cost_usd"] += float(cost)
+            bucket["any_cost_known"] = True
+    for dept, b in out.items():
+        if not b.pop("any_cost_known"):
+            b["total_cost_usd"] = None
+        else:
+            b["total_cost_usd"] = round(b["total_cost_usd"], 6)
+    return {"by_department": out, "period": period}
+
+
 @app.get("/api/agents/{agent_id}")
 def agent_detail(agent_id: str):
     """Get full agent detail including YAML data."""
@@ -569,18 +614,38 @@ def knowledge_search(q: str = Query(...), top_k: int = Query(5)):
 
 @app.get("/api/health")
 def health():
-    checks = []
+    """PR70 v2.87.0 — per-check severity + response timestamp.
+
+    Each check now carries a `severity` field:
+      - "fail" — must-pass; missing breaks ArkaOS
+      - "warn" — recommended; missing means a degraded but workable env
+
+    Response also carries `ts` so the UI can show "last checked".
+    Frontend polls every 30s and surfaces copy-fix buttons.
+    """
+    from datetime import datetime, timezone
+
+    checks: list[dict] = []
     arkaos_home = Path.home() / ".arkaos"
 
-    def check(name, condition, fix=""):
-        checks.append({"name": name, "passed": condition, "fix": fix})
+    def check(name: str, condition: bool, fix: str = "", severity: str = "fail"):
+        checks.append({
+            "name": name,
+            "passed": condition,
+            "fix": fix,
+            "severity": severity,
+        })
 
-    check("install_dir", arkaos_home.exists(), "Run: npx arkaos install")
-    check("manifest", (arkaos_home / "install-manifest.json").exists(), "Run: npx arkaos install")
+    check("install_dir", arkaos_home.exists(), "npx arkaos install")
+    check("manifest", (arkaos_home / "install-manifest.json").exists(),
+          "npx arkaos install")
     check("constitution", (ARKAOS_ROOT / "config" / "constitution.yaml").exists())
-    check("agents_registry", (ARKAOS_ROOT / "knowledge" / "agents-registry-v2.json").exists())
-    check("commands_registry", (ARKAOS_ROOT / "knowledge" / "commands-registry-v2.json").exists())
-    check("hooks_dir", (arkaos_home / "config" / "hooks").exists(), "Run: npx arkaos install")
+    check("agents_registry",
+          (ARKAOS_ROOT / "knowledge" / "agents-registry-v2.json").exists())
+    check("commands_registry",
+          (ARKAOS_ROOT / "knowledge" / "commands-registry-v2.json").exists())
+    check("hooks_dir", (arkaos_home / "config" / "hooks").exists(),
+          "npx arkaos install")
 
     try:
         subprocess.run(["python3", "--version"], capture_output=True, timeout=2)
@@ -588,10 +653,34 @@ def health():
     except Exception:
         check("python", False, "Install Python 3.11+")
 
-    check("knowledge_db", (arkaos_home / "knowledge.db").exists(), "Run: npx arkaos index")
+    # Telemetry + knowledge — warn-only; missing them is a degraded
+    # but workable state (new installs, never-indexed-anything).
+    check("knowledge_db", (arkaos_home / "knowledge.db").exists(),
+          "Open the Knowledge tab and ingest a source",
+          severity="warn")
+    check("profile",
+          (arkaos_home / "profile.json").exists(),
+          "Open Settings → Profile to introduce yourself",
+          severity="warn")
 
     passed = sum(1 for c in checks if c["passed"])
-    return {"checks": checks, "passed": passed, "total": len(checks), "healthy": passed == len(checks)}
+    failed_blocking = sum(
+        1 for c in checks
+        if not c["passed"] and c["severity"] == "fail"
+    )
+    warning_count = sum(
+        1 for c in checks
+        if not c["passed"] and c["severity"] == "warn"
+    )
+    return {
+        "checks": checks,
+        "passed": passed,
+        "total": len(checks),
+        "failed_blocking": failed_blocking,
+        "warning_count": warning_count,
+        "healthy": failed_blocking == 0,
+        "ts": datetime.now(timezone.utc).isoformat(),
+    }
 
 
 # --- Personas ---