arkaos 3.26.0 → 3.27.0

package/VERSION

@@ -1 +1 @@
-3.26.0
+3.27.0

package/dashboard/app/layouts/default.vue

@@ -20,6 +20,13 @@ const links = [[{
   onSelect: () => {
     open.value = false
   }
+}, {
+  label: 'Departments',
+  icon: 'i-lucide-folder-tree',
+  to: '/departments',
+  onSelect: () => {
+    open.value = false
+  }
 }, {
   label: 'Personas',
   icon: 'i-lucide-user-plus',

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

@@ -0,0 +1,158 @@
+<script setup lang="ts">
+// PR89a v3.27.0 — Department detail page.
+//
+// Shows agents in the department + its workflows + 30d cost.
+
+const route = useRoute()
+const deptId = computed(() => String(route.params.dept ?? ''))
+const { fetchApi } = useApi()
+
+interface AgentLite {
+  id: string
+  name?: string
+  role?: string
+  tier?: number
+  mbti?: string
+  disc?: { primary?: string, secondary?: string }
+}
+
+interface WorkflowLite {
+  id: string
+  name: string
+  tier: string
+  command: string
+  phases_count: number
+}
+
+interface DeptDetail {
+  department: string
+  agents: AgentLite[]
+  workflows: WorkflowLite[]
+  calls_30d: number
+  cost_usd_30d: number | null
+  error?: string
+}
+
+const { data, status, error, refresh } = await fetchApi<DeptDetail>(
+  `/api/departments/${deptId.value}`,
+)
+
+const errorMsg = computed(() => data.value?.error || error.value?.message || null)
+const detail = computed<DeptDetail | null>(() => {
+  if (!data.value || data.value.error) return null
+  return data.value
+})
+
+function formatCost(cost: number | null): string {
+  if (cost === null || cost === undefined) return '—'
+  if (cost < 0.01) return '<$0.01'
+  if (cost < 1) return `$${cost.toFixed(3)}`
+  return `$${cost.toFixed(2)}`
+}
+
+const tierColor = (tier: number | undefined) => {
+  const colors: Record<number, 'error' | 'warning' | 'primary' | 'neutral'> = {
+    0: 'error', 1: 'warning', 2: 'primary', 3: 'neutral',
+  }
+  return colors[tier ?? 99] ?? 'neutral'
+}
+</script>
+
+<template>
+  <UDashboardPanel :id="`dept-${deptId}`">
+    <template #header>
+      <UDashboardNavbar :title="`Department · ${deptId}`">
+        <template #leading>
+          <UButton icon="i-lucide-arrow-left" variant="ghost" size="sm" to="/departments" aria-label="Back" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <DashboardState
+        :status="status"
+        :error="errorMsg ? new Error(errorMsg) : null"
+        :empty="!detail"
+        empty-title="Department not found"
+        empty-icon="i-lucide-folder-x"
+        loading-label="Loading department"
+        :on-retry="() => refresh()"
+      >
+        <div v-if="detail" class="space-y-5 max-w-5xl">
+          <!-- 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">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Agents</p>
+              <p class="text-2xl font-bold">{{ detail.agents.length }}</p>
+            </div>
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Workflows</p>
+              <p class="text-2xl font-bold">{{ detail.workflows.length }}</p>
+            </div>
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Calls (30d)</p>
+              <p class="text-2xl font-bold">{{ detail.calls_30d }}</p>
+            </div>
+            <div class="rounded-xl border border-default p-4 bg-elevated/20">
+              <p class="text-sm font-semibold text-muted uppercase tracking-wide mb-1">Cost (30d)</p>
+              <p class="text-2xl font-bold">{{ formatCost(detail.cost_usd_30d) }}</p>
+            </div>
+          </section>
+
+          <!-- Agents -->
+          <section>
+            <h2 class="text-sm font-semibold uppercase tracking-wide text-muted mb-3">Agents</h2>
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-2">
+              <NuxtLink
+                v-for="a in detail.agents"
+                :key="a.id"
+                :to="`/agents/${a.id}`"
+                class="block rounded-lg border border-default p-3 hover:border-primary/40 transition-colors"
+              >
+                <div class="flex items-center justify-between gap-3">
+                  <div class="min-w-0">
+                    <p class="font-semibold truncate">{{ a.name }}</p>
+                    <p class="text-xs text-muted truncate">{{ a.role || '—' }}</p>
+                  </div>
+                  <div class="flex items-center gap-2 shrink-0">
+                    <UBadge
+                      :label="`T${a.tier}`"
+                      :color="tierColor(a.tier)"
+                      variant="subtle"
+                      size="xs"
+                    />
+                    <UBadge v-if="a.mbti" :label="a.mbti" variant="soft" size="xs" />
+                  </div>
+                </div>
+              </NuxtLink>
+            </div>
+          </section>
+
+          <!-- Workflows -->
+          <section v-if="detail.workflows.length > 0">
+            <h2 class="text-sm font-semibold uppercase tracking-wide text-muted mb-3">Workflows</h2>
+            <div class="space-y-2">
+              <NuxtLink
+                v-for="w in detail.workflows"
+                :key="w.id"
+                to="/workflows"
+                class="block rounded-lg border border-default p-3 hover:border-primary/40 transition-colors"
+              >
+                <div class="flex items-center justify-between gap-3">
+                  <div class="min-w-0">
+                    <p class="font-semibold truncate">{{ w.name }}</p>
+                    <p class="text-xs text-muted font-mono truncate">{{ w.command || w.id }}</p>
+                  </div>
+                  <div class="flex items-center gap-2 shrink-0 text-xs">
+                    <UBadge v-if="w.tier" :label="w.tier" variant="subtle" size="xs" />
+                    <span class="text-muted">{{ w.phases_count }} phase{{ w.phases_count === 1 ? '' : 's' }}</span>
+                  </div>
+                </div>
+              </NuxtLink>
+            </div>
+          </section>
+        </div>
+      </DashboardState>
+    </template>
+  </UDashboardPanel>
+</template>

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

@@ -0,0 +1,127 @@
+<script setup lang="ts">
+// PR89a v3.27.0 — Departments index.
+//
+// Lists every department with agent count, tier distribution, and 30d
+// cost. Click a row to drill into /departments/{dept}.
+
+import type { TableColumn } from '@nuxt/ui'
+
+interface DeptRow {
+  department: string
+  agent_count: number
+  tier_counts: Record<'0' | '1' | '2' | '3', number>
+  calls_30d: number
+  cost_usd_30d: number | null
+}
+
+const { fetchApi } = useApi()
+const { data, status, error, refresh } = await fetchApi<{
+  departments: DeptRow[]
+  total: number
+}>('/api/departments')
+
+const rows = computed<DeptRow[]>(() => data.value?.departments ?? [])
+const search = ref('')
+const filtered = computed(() => {
+  const q = search.value.toLowerCase().trim()
+  if (!q) return rows.value
+  return rows.value.filter((r) => r.department.toLowerCase().includes(q))
+})
+
+const columns: TableColumn<DeptRow>[] = [
+  { accessorKey: 'department', header: 'Department' },
+  { accessorKey: 'agent_count', header: 'Agents' },
+  { id: 'tiers', header: 'Tiers (0/1/2/3)' },
+  { accessorKey: 'calls_30d', header: 'Calls (30d)' },
+  { accessorKey: 'cost_usd_30d', header: 'Cost (30d)' },
+  { id: 'actions', header: '' },
+]
+
+function formatCost(cost: number | null): string {
+  if (cost === null || cost === undefined) return '—'
+  if (cost < 0.01) return '<$0.01'
+  if (cost < 1) return `$${cost.toFixed(3)}`
+  return `$${cost.toFixed(2)}`
+}
+</script>
+
+<template>
+  <UDashboardPanel id="departments">
+    <template #header>
+      <UDashboardNavbar title="Departments">
+        <template #leading>
+          <UDashboardSidebarCollapse />
+        </template>
+        <template #trailing>
+          <UBadge v-if="data?.total" :label="String(data.total)" variant="subtle" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <DashboardState
+        :status="status"
+        :error="error"
+        :empty="!rows.length"
+        empty-title="No departments yet"
+        empty-icon="i-lucide-folder-tree"
+        loading-label="Loading departments"
+        :on-retry="() => refresh()"
+      >
+        <div class="flex items-center gap-3 mb-4">
+          <UInput
+            v-model="search"
+            class="max-w-sm"
+            icon="i-lucide-search"
+            placeholder="Filter departments…"
+          />
+          <span class="ml-auto text-xs text-muted">
+            {{ filtered.length }} dept{{ filtered.length === 1 ? '' : 's' }}
+          </span>
+        </div>
+
+        <UTable
+          :data="filtered"
+          :columns="columns"
+          :loading="status === 'pending'"
+          :ui="{
+            tbody: '[&>tr]:cursor-pointer [&>tr]:hover:bg-elevated/50 [&>tr]:transition-colors',
+            th: 'py-2 first:rounded-l-lg last:rounded-r-lg border-y border-default first:border-l last:border-r',
+            td: 'border-b border-default',
+          }"
+          @select="(row: { original: DeptRow }) => navigateTo(`/departments/${row.original.department}`)"
+        >
+          <template #department-cell="{ row }">
+            <span class="font-semibold capitalize">{{ row.original.department }}</span>
+          </template>
+          <template #agent_count-cell="{ row }">
+            <span class="font-mono font-semibold">{{ row.original.agent_count }}</span>
+          </template>
+          <template #tiers-cell="{ row }">
+            <div class="flex items-center gap-1 text-xs font-mono">
+              <UBadge v-if="row.original.tier_counts['0'] > 0" :label="`0:${row.original.tier_counts['0']}`" color="error" variant="subtle" size="xs" />
+              <UBadge v-if="row.original.tier_counts['1'] > 0" :label="`1:${row.original.tier_counts['1']}`" color="warning" variant="subtle" size="xs" />
+              <UBadge v-if="row.original.tier_counts['2'] > 0" :label="`2:${row.original.tier_counts['2']}`" color="primary" variant="subtle" size="xs" />
+              <UBadge v-if="row.original.tier_counts['3'] > 0" :label="`3:${row.original.tier_counts['3']}`" color="neutral" variant="subtle" size="xs" />
+            </div>
+          </template>
+          <template #calls_30d-cell="{ row }">
+            <span class="font-mono text-sm">{{ row.original.calls_30d }}</span>
+          </template>
+          <template #cost_usd_30d-cell="{ row }">
+            <span class="font-mono text-sm font-semibold">{{ formatCost(row.original.cost_usd_30d) }}</span>
+          </template>
+          <template #actions-cell="{ row }">
+            <UButton
+              icon="i-lucide-arrow-right"
+              variant="ghost"
+              size="xs"
+              aria-label="Open department"
+              @click.stop="navigateTo(`/departments/${row.original.department}`)"
+            />
+          </template>
+        </UTable>
+      </DashboardState>
+    </template>
+  </UDashboardPanel>
+</template>

package/package.json

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

package/scripts/dashboard-api.py

@@ -1494,6 +1494,127 @@ def agent_export_to_vault(agent_id: str):
     return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
 
 
+# --- Departments (PR89a v3.27.0) ---
+
+@app.get("/api/departments")
+def departments_list():
+    """List every department with agent count + 30d cost summary."""
+    agents = _load_agents()
+    by_dept: dict[str, dict] = {}
+    for a in agents:
+        dept = a.get("department") or ""
+        if not dept:
+            continue
+        row = by_dept.setdefault(dept, {
+            "department": dept,
+            "agent_count": 0,
+            "tier_counts": {"0": 0, "1": 0, "2": 0, "3": 0},
+        })
+        row["agent_count"] += 1
+        tier_key = str(a.get("tier") or "")
+        if tier_key in row["tier_counts"]:
+            row["tier_counts"][tier_key] += 1
+    cost_map: dict[str, dict] = {}
+    try:
+        from core.runtime.llm_cost_telemetry import summarise
+        s = summarise(period="month")
+        for category, row in (s.by_category or {}).items():
+            if not isinstance(category, str) or not category.startswith("subagent:"):
+                continue
+            parts = category.split(":", 2)
+            dept = parts[1] if len(parts) >= 2 else "unknown"
+            bucket = cost_map.setdefault(dept, {
+                "calls_30d": 0,
+                "cost_usd_30d": 0.0,
+                "any_cost_known": False,
+            })
+            bucket["calls_30d"] += int(row.get("call_count", 0))
+            cost = row.get("total_cost_usd")
+            if isinstance(cost, (int, float)):
+                bucket["cost_usd_30d"] += float(cost)
+                bucket["any_cost_known"] = True
+    except Exception:  # noqa: BLE001
+        pass
+    out: list[dict] = []
+    for dept in sorted(by_dept.keys()):
+        row = by_dept[dept]
+        cost = cost_map.get(dept, {})
+        row["calls_30d"] = cost.get("calls_30d", 0)
+        row["cost_usd_30d"] = (
+            round(cost.get("cost_usd_30d", 0.0), 6)
+            if cost.get("any_cost_known") else None
+        )
+        out.append(row)
+    return {"departments": out, "total": len(out)}
+
+
+@app.get("/api/departments/{dept_id}")
+def department_detail(dept_id: str):
+    """Full department detail: agents, workflows, 30d cost."""
+    dept_id = dept_id.strip().lower()
+    agents = [a for a in _load_agents() if a.get("department") == dept_id]
+    if not agents:
+        return {"error": "Department not found or has no agents"}
+    workflows: list[dict] = []
+    try:
+        import yaml as _yaml
+        wf_dir = ARKAOS_ROOT / "departments" / dept_id / "workflows"
+        if wf_dir.exists():
+            for path in sorted(wf_dir.glob("*.yaml")):
+                try:
+                    raw = _yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+                except Exception:  # noqa: BLE001
+                    raw = {}
+                if not isinstance(raw, dict):
+                    continue
+                workflows.append({
+                    "id": str(raw.get("id") or path.stem),
+                    "name": str(raw.get("name") or path.stem),
+                    "tier": str(raw.get("tier") or ""),
+                    "command": str(raw.get("command") or ""),
+                    "phases_count": len(raw.get("phases") or []),
+                })
+    except ImportError:
+        pass
+    calls_30d = 0
+    cost_usd_30d: Optional[float] = None
+    try:
+        from core.runtime.llm_cost_telemetry import summarise
+        s = summarise(period="month")
+        total_cost = 0.0
+        any_known = False
+        for category, row in (s.by_category or {}).items():
+            if not isinstance(category, str) or not category.startswith("subagent:"):
+                continue
+            parts = category.split(":", 2)
+            if len(parts) >= 2 and parts[1] == dept_id:
+                calls_30d += int(row.get("call_count", 0))
+                cost = row.get("total_cost_usd")
+                if isinstance(cost, (int, float)):
+                    total_cost += float(cost)
+                    any_known = True
+        cost_usd_30d = round(total_cost, 6) if any_known else None
+    except Exception:  # noqa: BLE001
+        pass
+    return {
+        "department": dept_id,
+        "agents": [
+            {
+                "id": a.get("id"),
+                "name": a.get("name"),
+                "role": a.get("role"),
+                "tier": a.get("tier"),
+                "mbti": a.get("mbti"),
+                "disc": a.get("disc"),
+            }
+            for a in agents
+        ],
+        "workflows": workflows,
+        "calls_30d": calls_30d,
+        "cost_usd_30d": cost_usd_30d,
+    }
+
+
 # --- Workflows (PR88b v3.24.0) ---
 
 @app.get("/api/workflows")