arkaos 2.82.0 → 2.83.0

package/VERSION

@@ -1 +1 @@
-2.82.0
+2.83.0

package/core/profile/manager.py

@@ -82,7 +82,11 @@ class ProfileManager:
     """
 
     def __init__(self, path: Path | None = None) -> None:
-        self._path = path or DEFAULT_PROFILE_PATH
+        # Resolve at call time so HOME changes (tests, multi-tenant
+        # daemons) are honoured. DEFAULT_PROFILE_PATH stays as a
+        # module-level constant for callers that want the canonical
+        # path explicitly.
+        self._path = path or (Path.home() / ".arkaos" / "profile.json")
 
     @property
     def path(self) -> Path:

package/dashboard/app/pages/index.vue

@@ -1,39 +1,139 @@
 <script setup lang="ts">
-import type { OverviewData } from '~/types'
+// PR66 v2.83.0 — Command center.
+//
+// Replaces the 6-stat-card Overview that just counted things you
+// already knew (agents=62, skills=256, ...) with telemetry-driven
+// information the operator actually uses: greeting, today's cost,
+// per-project state, recent incidents, quick actions.
+
+interface ProjectRow {
+  name: string
+  path: string
+  stack: string[]
+  status: string
+  ecosystem: string
+  last_commit_days: number | null
+}
+
+interface IncidentRow {
+  ts: string
+  tool: string
+  reason: string
+  cwd: string
+  bypass_used: boolean
+  kind: 'bypass' | 'blocked'
+}
+
+interface QuickAction {
+  command: string
+  description: string
+}
+
+interface CommandCenterPayload {
+  greeting: {
+    name: string
+    role: string
+    company: string
+    language: string
+  }
+  today_cost: {
+    total_usd: number | null
+    call_count: number
+    tokens_in: number
+    tokens_out: number
+    cache_hit_rate: number
+  }
+  projects: ProjectRow[]
+  recent_incidents: IncidentRow[]
+  quick_actions: QuickAction[]
+}
 
 const { fetchApi } = useApi()
 
-const { data: overview, status, error, refresh } = await fetchApi<OverviewData>('/api/overview')
+const {
+  data,
+  status,
+  error,
+  refresh,
+} = await fetchApi<CommandCenterPayload>('/api/overview/command-center')
+
+const greetingLabel = computed(() => {
+  const name = data.value?.greeting?.name?.trim()
+  const language = data.value?.greeting?.language ?? 'en'
+  if (!name) return language === 'pt' ? 'Olá' : 'Welcome'
+  return language === 'pt' ? `Olá, ${name}` : `Hi, ${name}`
+})
+
+const todayCost = computed(() => data.value?.today_cost)
+
+function formatCost(value: number | null | undefined): string {
+  if (value === null || value === undefined) return 'n/a'
+  if (value === 0) return '$0'
+  if (value < 0.01) return `$${value.toFixed(4)}`
+  return `$${value.toFixed(2)}`
+}
+
+function formatTokens(n: number): string {
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}K`
+  return n.toString()
+}
+
+function statusColor(status: string): 'success' | 'warning' | 'neutral' | 'error' {
+  switch (status) {
+    case 'active': return 'success'
+    case 'paused': return 'warning'
+    case 'archived': return 'neutral'
+    case 'error': return 'error'
+    default: return 'neutral'
+  }
+}
 
-const stats = computed(() => [
-  { label: 'Agents', value: overview.value?.agents ?? 0, icon: 'i-lucide-users' },
-  { label: 'Skills', value: overview.value?.skills ?? 0, icon: 'i-lucide-sparkles' },
-  { label: 'Departments', value: overview.value?.departments ?? 0, icon: 'i-lucide-building-2' },
-  { label: 'Tests', value: overview.value?.tests ?? 0, icon: 'i-lucide-test-tubes' },
-  { label: 'Commands', value: overview.value?.commands ?? 0, icon: 'i-lucide-terminal' },
-  { label: 'Workflows', value: overview.value?.workflows ?? 0, icon: 'i-lucide-git-branch' }
-])
+function commitFreshness(days: number | null): { color: string; label: string } {
+  if (days === null) return { color: 'text-muted', label: 'no git' }
+  if (days === 0) return { color: 'text-green-500', label: 'today' }
+  if (days === 1) return { color: 'text-green-500', label: '1 day ago' }
+  if (days < 7) return { color: 'text-primary', label: `${days} days ago` }
+  if (days < 30) return { color: 'text-yellow-500', label: `${days} days ago` }
+  return { color: 'text-red-500', label: `${days} days ago` }
+}
 
-const budgetPercent = computed(() => overview.value?.budget?.percent_used ?? 0)
-const budgetUsed = computed(() => overview.value?.budget?.used ?? 0)
-const budgetAllocated = computed(() => overview.value?.budget?.allocated ?? 0)
-const budgetUnlimited = computed(() => overview.value?.budget?.is_unlimited ?? false)
+function formatIncidentTs(iso: string): string {
+  if (!iso) return ''
+  try {
+    return new Intl.DateTimeFormat('en-US', {
+      month: 'short',
+      day: 'numeric',
+      hour: '2-digit',
+      minute: '2-digit',
+    }).format(new Date(iso))
+  } catch {
+    return iso
+  }
+}
 
-function formatCurrency(value: number): string {
-  return new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD', maximumFractionDigits: 0 }).format(value)
+function copyCommand(cmd: string) {
+  if (typeof navigator !== 'undefined' && navigator.clipboard) {
+    navigator.clipboard.writeText(cmd).catch(() => { /* ignore */ })
+  }
 }
 </script>
 
 <template>
   <UDashboardPanel id="overview">
     <template #header>
-      <UDashboardNavbar title="Overview">
+      <UDashboardNavbar title="Command Center">
         <template #leading>
           <UDashboardSidebarCollapse />
         </template>
-
         <template #right>
-          <UBadge v-if="overview?.version" :label="`v${overview.version}`" variant="subtle" color="primary" />
+          <UButton
+            label="Refresh"
+            variant="ghost"
+            icon="i-lucide-refresh-cw"
+            size="sm"
+            @click="refresh()"
+          />
         </template>
       </UDashboardNavbar>
     </template>
@@ -42,72 +142,171 @@ function formatCurrency(value: number): string {
       <DashboardState
         :status="status"
         :error="error"
-        loading-label="Loading overview"
+        loading-label="Loading command center"
         :on-retry="() => refresh()"
       >
-        <!-- Stats Grid -->
-        <div class="grid grid-cols-2 gap-4 sm:grid-cols-3 lg:grid-cols-6">
-          <div
-            v-for="stat in stats"
-            :key="stat.label"
-            class="flex flex-col gap-2 rounded-lg border border-default p-4"
-          >
-            <div class="flex items-center gap-2">
-              <UIcon :name="stat.icon" class="size-4 text-muted" />
-              <span class="text-sm text-muted">{{ stat.label }}</span>
-            </div>
-            <span class="text-2xl font-semibold text-highlighted">{{ stat.value }}</span>
-          </div>
-        </div>
-
-        <!-- Budget Gauge -->
-        <div class="mt-6 rounded-lg border border-default p-6">
-          <h3 class="mb-4 text-lg font-semibold text-highlighted">Budget</h3>
-          <div v-if="budgetUnlimited" class="text-sm text-muted">
-            Unlimited budget configured.
-          </div>
-          <div v-else class="space-y-3">
-            <div class="flex items-center justify-between text-sm">
-              <span class="text-muted">Used: {{ formatCurrency(budgetUsed) }}</span>
-              <span class="text-muted">Allocated: {{ formatCurrency(budgetAllocated) }}</span>
-            </div>
-            <UProgress :value="budgetPercent" :max="100" size="md" />
-            <p class="text-xs text-muted">{{ budgetPercent.toFixed(1) }}% of budget used</p>
-          </div>
-        </div>
-
-        <!-- Bottom Row: Tasks + Knowledge -->
-        <div class="mt-6 grid grid-cols-1 gap-4 md:grid-cols-2">
-          <!-- Tasks Summary -->
-          <div class="rounded-lg border border-default p-6">
-            <h3 class="mb-4 text-lg font-semibold text-highlighted">Tasks</h3>
-            <div class="grid grid-cols-3 gap-4">
-              <div class="text-center">
-                <p class="text-2xl font-semibold text-highlighted">{{ overview?.tasks?.total ?? 0 }}</p>
-                <p class="text-xs text-muted">Total</p>
+        <div class="space-y-6">
+          <!-- Hero: greeting + today's cost -->
+          <UCard>
+            <div class="flex flex-col gap-2 md:flex-row md:items-baseline md:justify-between">
+              <div>
+                <h1 class="text-2xl font-bold">{{ greetingLabel }}.</h1>
+                <p class="text-sm text-muted mt-1">
+                  <template v-if="data?.greeting?.role && data?.greeting?.company">
+                    {{ data.greeting.role }} @ {{ data.greeting.company }}
+                  </template>
+                  <template v-else>
+                    Set your profile in Settings to personalise this view.
+                  </template>
+                </p>
               </div>
-              <div class="text-center">
-                <p class="text-2xl font-semibold text-primary">{{ overview?.tasks?.active ?? 0 }}</p>
-                <p class="text-xs text-muted">Active</p>
+              <div v-if="todayCost" class="flex items-baseline gap-6 text-right">
+                <div>
+                  <p class="text-xs font-semibold text-muted uppercase tracking-wider">
+                    Today's cost
+                  </p>
+                  <p class="text-2xl font-bold">{{ formatCost(todayCost.total_usd) }}</p>
+                </div>
+                <div>
+                  <p class="text-xs font-semibold text-muted uppercase tracking-wider">
+                    Calls
+                  </p>
+                  <p class="text-2xl font-bold">{{ todayCost.call_count }}</p>
+                </div>
+                <div>
+                  <p class="text-xs font-semibold text-muted uppercase tracking-wider">
+                    Cache
+                  </p>
+                  <p class="text-2xl font-bold">
+                    {{ (todayCost.cache_hit_rate * 100).toFixed(0) }}%
+                  </p>
+                </div>
               </div>
-              <div class="text-center">
-                <p class="text-2xl font-semibold text-muted">{{ overview?.tasks?.queued ?? 0 }}</p>
-                <p class="text-xs text-muted">Queued</p>
+            </div>
+          </UCard>
+
+          <!-- Two columns: projects + incidents -->
+          <div class="grid grid-cols-1 lg:grid-cols-[2fr_1fr] gap-6">
+            <!-- Projects -->
+            <div>
+              <div class="flex items-baseline justify-between mb-3">
+                <h2 class="text-sm font-semibold uppercase tracking-wider text-muted">
+                  Projects
+                </h2>
+                <NuxtLink to="/settings" class="text-xs text-muted hover:text-primary">
+                  Configure dirs →
+                </NuxtLink>
               </div>
+              <DashboardState
+                :status="status"
+                :empty="!data?.projects?.length"
+                empty-title="No projects discovered yet"
+                empty-description="Add your project directories in Settings → Projects."
+                empty-icon="i-lucide-folder-open"
+              >
+                <div class="space-y-2">
+                  <div
+                    v-for="p in data?.projects"
+                    :key="p.name"
+                    class="rounded-lg border border-default p-3 hover:border-primary/40 transition-colors"
+                  >
+                    <div class="flex items-start justify-between gap-3">
+                      <div class="min-w-0 flex-1">
+                        <div class="flex items-center gap-2 mb-1">
+                          <span class="text-sm font-semibold truncate">{{ p.name }}</span>
+                          <UBadge
+                            v-if="p.status"
+                            :label="p.status"
+                            :color="statusColor(p.status)"
+                            variant="subtle"
+                            size="xs"
+                          />
+                          <UBadge
+                            v-if="p.ecosystem"
+                            :label="p.ecosystem"
+                            color="primary"
+                            variant="outline"
+                            size="xs"
+                          />
+                        </div>
+                        <p class="text-xs text-muted font-mono truncate">{{ p.path }}</p>
+                        <div class="flex items-center gap-2 mt-2 flex-wrap">
+                          <UBadge
+                            v-for="s in p.stack"
+                            :key="s"
+                            :label="s"
+                            variant="soft"
+                            size="xs"
+                          />
+                        </div>
+                      </div>
+                      <span
+                        class="text-xs font-mono shrink-0"
+                        :class="commitFreshness(p.last_commit_days).color"
+                      >
+                        {{ commitFreshness(p.last_commit_days).label }}
+                      </span>
+                    </div>
+                  </div>
+                </div>
+              </DashboardState>
             </div>
-          </div>
 
-          <!-- Knowledge Summary -->
-          <div class="rounded-lg border border-default p-6">
-            <h3 class="mb-4 text-lg font-semibold text-highlighted">Knowledge Base</h3>
-            <div class="grid grid-cols-2 gap-4">
-              <div class="text-center">
-                <p class="text-2xl font-semibold text-highlighted">{{ overview?.knowledge?.total_chunks ?? 0 }}</p>
-                <p class="text-xs text-muted">Chunks</p>
+            <!-- Incidents + Quick actions -->
+            <div class="space-y-6">
+              <div>
+                <h2 class="text-sm font-semibold uppercase tracking-wider text-muted mb-3">
+                  Recent incidents
+                </h2>
+                <DashboardState
+                  :status="status"
+                  :empty="!data?.recent_incidents?.length"
+                  empty-title="No incidents"
+                  empty-description="Bypass uses and flow blocks show up here."
+                  empty-icon="i-lucide-shield-check"
+                >
+                  <div class="space-y-2">
+                    <div
+                      v-for="(i, idx) in data?.recent_incidents"
+                      :key="idx"
+                      class="rounded-lg border border-default p-3"
+                    >
+                      <div class="flex items-center gap-2 mb-1">
+                        <UBadge
+                          :label="i.kind"
+                          :color="i.kind === 'bypass' ? 'warning' : 'error'"
+                          variant="subtle"
+                          size="xs"
+                        />
+                        <span class="text-xs text-muted">{{ formatIncidentTs(i.ts) }}</span>
+                      </div>
+                      <p class="text-xs font-mono text-muted truncate" :title="i.reason">
+                        {{ i.tool }} — {{ i.reason }}
+                      </p>
+                    </div>
+                  </div>
+                </DashboardState>
               </div>
-              <div class="text-center">
-                <p class="text-2xl font-semibold text-highlighted">{{ overview?.knowledge?.total_files ?? 0 }}</p>
-                <p class="text-xs text-muted">Files</p>
+
+              <div>
+                <h2 class="text-sm font-semibold uppercase tracking-wider text-muted mb-3">
+                  Quick actions
+                </h2>
+                <div class="space-y-1">
+                  <button
+                    v-for="a in data?.quick_actions"
+                    :key="a.command"
+                    type="button"
+                    class="w-full text-left p-3 rounded-lg border border-default hover:border-primary/40 hover:bg-elevated/30 transition-colors"
+                    @click="copyCommand(a.command)"
+                  >
+                    <div class="flex items-center gap-2">
+                      <code class="text-sm font-mono font-semibold text-primary">{{ a.command }}</code>
+                      <UIcon name="i-lucide-clipboard" class="size-3 text-muted ml-auto" />
+                    </div>
+                    <p class="text-xs text-muted mt-1">{{ a.description }}</p>
+                  </button>
+                </div>
               </div>
             </div>
           </div>

package/package.json

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

package/scripts/dashboard-api.py

@@ -729,6 +729,176 @@ def persona_build(body: dict):
     }
 
 
+# --- Command center (PR66 v2.83.0) ---
+
+@app.get("/api/overview/command-center")
+def overview_command_center():
+    """Telemetry-driven overview surfacing what the operator actually needs.
+
+    Returns greeting, today's cost, project list with stack + last-commit
+    + status, recent enforcement incidents, and suggested quick actions.
+    """
+    from core.profile import ProfileManager
+    from core.profile.manager import parse_projects_dirs
+    from core.runtime.llm_cost_telemetry import summarise
+
+    profile = ProfileManager().read()
+    today_cost = summarise(period="today")
+
+    return {
+        "greeting": {
+            "name": profile.name,
+            "role": profile.role,
+            "company": profile.company,
+            "language": profile.language,
+        },
+        "today_cost": {
+            "total_usd": today_cost.total_cost_usd,
+            "call_count": today_cost.call_count,
+            "tokens_in": today_cost.total_tokens_in,
+            "tokens_out": today_cost.total_tokens_out,
+            "cache_hit_rate": today_cost.cache_hit_rate,
+        },
+        "projects": _scan_projects(parse_projects_dirs(profile.projectsDir)),
+        "recent_incidents": _recent_incidents(limit=8),
+        "quick_actions": [
+            {"command": "/arka update", "description": "Sync projects + skills"},
+            {"command": "/arka costs", "description": "View detailed LLM cost breakdown"},
+            {"command": "/arka conclave", "description": "Convene the personal AI advisory board"},
+            {"command": "/dev review", "description": "Run a code review on the current branch"},
+        ],
+    }
+
+
+def _scan_projects(projects_dirs: list[str]) -> list[dict]:
+    """Read each project descriptor and enrich with last-commit info.
+
+    Best-effort: never raises. Returns an empty list when descriptors
+    or scan directories are missing.
+    """
+    from datetime import datetime, timezone
+    descriptor_dir = Path.home() / ".arkaos" / "projects"
+    if not descriptor_dir.exists():
+        return []
+
+    rows: list[dict] = []
+    for entry in sorted(descriptor_dir.iterdir()):
+        if entry.is_dir():
+            descriptor = entry / "PROJECT.md"
+        elif entry.suffix == ".md":
+            descriptor = entry
+        else:
+            continue
+        if not descriptor.exists():
+            continue
+        try:
+            data = _parse_descriptor(descriptor)
+        except Exception:
+            continue
+        rows.append(data)
+
+    # Sort by last_commit_days ascending (most recently active first).
+    rows.sort(key=lambda r: (
+        r.get("last_commit_days") if r.get("last_commit_days") is not None else 9999,
+        r.get("name", ""),
+    ))
+    return rows[:30]  # cap to keep payload bounded
+
+
+def _parse_descriptor(path: Path) -> dict:
+    """Extract frontmatter + last-commit-days from a project descriptor."""
+    text = path.read_text(encoding="utf-8", errors="replace")
+    fm: dict = {}
+    if text.startswith("---\n"):
+        end = text.find("\n---", 4)
+        if end > 0:
+            import yaml as _yaml
+            try:
+                fm = _yaml.safe_load(text[4:end]) or {}
+            except Exception:
+                fm = {}
+    name = str(fm.get("name") or path.stem)
+    project_path = str(fm.get("path") or "")
+    stack = fm.get("stack") or []
+    if not isinstance(stack, list):
+        stack = [str(stack)]
+    status = str(fm.get("status") or "unknown")
+    ecosystem = str(fm.get("ecosystem") or "")
+    last_commit_days = _last_commit_days(project_path) if project_path else None
+    return {
+        "name": name,
+        "path": project_path,
+        "stack": [str(s) for s in stack][:6],
+        "status": status,
+        "ecosystem": ecosystem,
+        "last_commit_days": last_commit_days,
+    }
+
+
+def _last_commit_days(project_path: str) -> Optional[int]:
+    """Return days since the last git commit, or None when unknown."""
+    import os
+    if not project_path or not os.path.isdir(project_path):
+        return None
+    git_dir = os.path.join(project_path, ".git")
+    if not os.path.exists(git_dir):
+        return None
+    try:
+        from datetime import datetime, timezone
+        result = subprocess.run(
+            ["git", "-C", project_path, "log", "-1", "--format=%ct"],
+            capture_output=True, text=True, timeout=3, check=False,
+        )
+        if result.returncode != 0 or not result.stdout.strip():
+            return None
+        committed_at = datetime.fromtimestamp(int(result.stdout.strip()), tz=timezone.utc)
+        delta = datetime.now(timezone.utc) - committed_at
+        return max(0, delta.days)
+    except (OSError, ValueError, subprocess.TimeoutExpired):
+        return None
+
+
+def _recent_incidents(limit: int = 8) -> list[dict]:
+    """Recent enforcement / bypass events from telemetry.
+
+    Reads the tail of ~/.arkaos/telemetry/enforcement.jsonl and keeps
+    rows where the operator hit a bypass or a flow-marker block. The
+    UI uses these to show "what went sideways recently".
+    """
+    log = Path.home() / ".arkaos" / "telemetry" / "enforcement.jsonl"
+    if not log.exists():
+        return []
+    try:
+        text = log.read_text(encoding="utf-8", errors="replace")
+    except OSError:
+        return []
+    rows: list[dict] = []
+    # Walk lines in reverse; stop when we've gathered `limit` matches.
+    for line in reversed(text.splitlines()):
+        if len(rows) >= limit:
+            break
+        if not line.strip():
+            continue
+        try:
+            entry = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+        # Interesting events: bypass used OR allow=False (a block).
+        bypass = bool(entry.get("bypass_used"))
+        allowed = entry.get("allow")
+        if not bypass and allowed is not False:
+            continue
+        rows.append({
+            "ts": entry.get("ts", ""),
+            "tool": entry.get("tool", ""),
+            "reason": entry.get("reason", ""),
+            "cwd": entry.get("cwd", ""),
+            "bypass_used": bypass,
+            "kind": "bypass" if bypass else "blocked",
+        })
+    return rows
+
+
 # --- LLM Costs (PR65 v2.82.0) ---
 
 @app.get("/api/llm-costs")