arkaos 3.25.0 → 3.27.0

package/VERSION

@@ -1 +1 @@
-3.25.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/agents/[id].vue

@@ -28,6 +28,35 @@ const deptActivity = computed<ActivityRow | null>(() =>
   (activityData.value?.by_department?.[agent.value?.department ?? ''] ?? null),
 )
 
+// PR88d v3.26.0 — agent history (git log + trash entries)
+interface HistoryEvent {
+  kind: string
+  ts: string | null
+  summary: string
+  ref?: string
+  author?: string
+}
+const { data: historyData } = fetchApi<{ events: HistoryEvent[] }>(
+  `/api/agents/${agentId}/history?limit=20`,
+)
+
+const historyEvents = computed<HistoryEvent[]>(() => historyData.value?.events ?? [])
+
+function historyKindIcon(kind: string): string {
+  return ({
+    'git-commit': 'i-lucide-git-commit',
+    'agent-delete': 'i-lucide-trash-2',
+    'agent-move': 'i-lucide-folder-tree',
+  } as Record<string, string>)[kind] ?? 'i-lucide-circle'
+}
+function historyKindColor(kind: string): string {
+  return ({
+    'git-commit': 'text-blue-500',
+    'agent-delete': 'text-red-500',
+    'agent-move': 'text-amber-500',
+  } as Record<string, string>)[kind] ?? 'text-muted'
+}
+
 // PR83d v3.6.0 + PR86b v3.16.0 — activity strip (30d, agent or dept scope)
 interface ActivityStrip {
   period: string
@@ -443,6 +472,43 @@ function formatTokens(n: number): string {
           />
         </section>
 
+        <!-- ===== HISTORY TIMELINE (PR88d) ===== -->
+        <section
+          v-if="historyEvents.length > 0"
+          class="rounded-xl border border-default bg-elevated/10 p-5"
+        >
+          <h3 class="text-sm font-semibold uppercase tracking-wide text-muted mb-4">
+            History
+          </h3>
+          <ol class="relative border-l border-default ml-2 space-y-3">
+            <li
+              v-for="(ev, idx) in historyEvents"
+              :key="idx"
+              class="ml-4"
+            >
+              <span
+                class="absolute -left-1.5 size-3 rounded-full bg-elevated border border-default flex items-center justify-center"
+              >
+                <UIcon :name="historyKindIcon(ev.kind)" :class="['size-2', historyKindColor(ev.kind)]" />
+              </span>
+              <div class="rounded-lg border border-default p-3 bg-elevated/20">
+                <div class="flex items-center gap-2 flex-wrap text-xs">
+                  <span class="font-mono text-muted">{{ ev.ts ? formatRelative(ev.ts) : '—' }}</span>
+                  <UBadge
+                    :label="ev.kind"
+                    :color="ev.kind === 'git-commit' ? 'primary' : ev.kind === 'agent-move' ? 'warning' : 'error'"
+                    variant="subtle"
+                    size="xs"
+                  />
+                  <code v-if="ev.ref" class="font-mono text-muted">{{ ev.ref }}</code>
+                  <span v-if="ev.author" class="text-muted">· {{ ev.author }}</span>
+                </div>
+                <p class="text-sm mt-1">{{ ev.summary }}</p>
+              </div>
+            </li>
+          </ol>
+        </section>
+
         <AgentEditDrawer
           v-model="editOpen"
           :agent="agent"

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.25.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.25.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

@@ -322,6 +322,96 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
     }
 
 
+@app.get("/api/agents/{agent_id}/history")
+def agent_history(agent_id: str, limit: int = 20):
+    """PR88d v3.26.0 — combined history for an agent.
+
+    Sources:
+      - git log of the YAML file (commit hash, date, subject, author)
+      - trash entries (agent-delete + agent-move) where ``item_id``
+        matches
+
+    Returns ``{events: [{kind, ts, summary, ref?, author?}]}`` sorted
+    desc by ts.
+    """
+    events: list[dict] = []
+    yaml_file = _resolve_agent_yaml(agent_id)
+    if yaml_file is not None:
+        events.extend(_agent_git_log(yaml_file, limit=limit))
+    try:
+        from core import trash as _trash
+        for entry in _trash.list_trash(limit=50):
+            if entry.get("item_id") == agent_id and str(entry.get("kind", "")).startswith("agent-"):
+                events.append({
+                    "kind": entry.get("kind"),
+                    "ts": _trash_ts_to_iso(entry.get("timestamp")),
+                    "summary": _trash_summary(entry),
+                    "ref": entry.get("id"),
+                })
+    except Exception:  # noqa: BLE001
+        pass
+    events.sort(key=lambda e: str(e.get("ts") or ""), reverse=True)
+    return {"events": events[: max(0, int(limit))]}
+
+
+def _agent_git_log(yaml_file: Path, limit: int = 20) -> list[dict]:
+    """Run ``git log`` on the YAML file. Best-effort — empty on error."""
+    try:
+        rel = yaml_file.relative_to(ARKAOS_ROOT).as_posix()
+    except ValueError:
+        return []
+    try:
+        result = subprocess.run(
+            [
+                "git", "log", "--follow", f"-n{int(limit)}",
+                "--pretty=format:%H%x09%cI%x09%an%x09%s",
+                "--", rel,
+            ],
+            cwd=str(ARKAOS_ROOT),
+            capture_output=True, text=True, timeout=5,
+        )
+    except (subprocess.SubprocessError, OSError):
+        return []
+    if result.returncode != 0:
+        return []
+    rows: list[dict] = []
+    for line in result.stdout.strip().split("\n"):
+        if not line:
+            continue
+        parts = line.split("\t", 3)
+        if len(parts) < 4:
+            continue
+        sha, iso, author, subject = parts
+        rows.append({
+            "kind": "git-commit",
+            "ts": iso,
+            "summary": subject,
+            "ref": sha[:8],
+            "author": author,
+        })
+    return rows
+
+
+def _trash_ts_to_iso(ts: object) -> str | None:
+    if ts is None:
+        return None
+    try:
+        from datetime import datetime, timezone
+        return datetime.fromtimestamp(float(ts), tz=timezone.utc).isoformat()
+    except (TypeError, ValueError, OSError):
+        return None
+
+
+def _trash_summary(entry: dict) -> str:
+    kind = entry.get("kind") or ""
+    if kind == "agent-move":
+        new_path = entry.get("new_path") or ""
+        return f"Moved to {Path(new_path).parent.parent.name if new_path else '?'}"
+    if kind == "agent-delete":
+        return "Deleted (restorable from /trash)"
+    return kind
+
+
 @app.get("/api/agents/{agent_id}/activity")
 def agent_activity_detail(agent_id: str, period: str = "month"):
     """PR86b v3.16.0 — alias for /activity-strip. Same payload shape.
@@ -1404,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")