arkaos 3.23.0 → 3.24.0

package/VERSION

@@ -1 +1 @@
-3.23.0
+3.24.0

package/dashboard/app/layouts/default.vue

@@ -48,6 +48,13 @@ const links = [[{
   onSelect: () => {
     open.value = false
   }
+}, {
+  label: 'Workflows',
+  icon: 'i-lucide-workflow',
+  to: '/workflows',
+  onSelect: () => {
+    open.value = false
+  }
 }, {
   label: 'Knowledge',
   icon: 'i-lucide-brain',

package/dashboard/app/pages/workflows.vue

@@ -0,0 +1,191 @@
+<script setup lang="ts">
+// PR88b v3.24.0 — Workflows browser.
+//
+// Lists every YAML workflow under departments/*/workflows/*.yaml with
+// metadata pulled from the file's frontmatter-ish top keys. Selecting
+// a row opens a side panel with the raw YAML for inspection.
+
+import type { TableColumn } from '@nuxt/ui'
+
+interface Workflow {
+  id: string
+  name: string
+  description: string
+  department: string
+  tier: string
+  command: string
+  phases_count: number
+  file: string
+  content: string
+}
+
+const { fetchApi } = useApi()
+const { data, status, error, refresh } = await fetchApi<{ workflows: Workflow[] }>('/api/workflows')
+
+const workflows = computed(() => data.value?.workflows ?? [])
+const search = ref('')
+const deptFilter = ref<'all' | string>('all')
+const selected = ref<Workflow | null>(null)
+
+const departments = computed(() => {
+  const set = new Set<string>()
+  for (const w of workflows.value) if (w.department) set.add(w.department)
+  return [
+    { label: 'All departments', value: 'all' },
+    ...Array.from(set).sort().map((d) => ({ label: d, value: d })),
+  ]
+})
+
+const filtered = computed(() => {
+  let result = workflows.value
+  if (deptFilter.value !== 'all') {
+    result = result.filter((w) => w.department === deptFilter.value)
+  }
+  const q = search.value.toLowerCase().trim()
+  if (q) {
+    result = result.filter((w) =>
+      w.name.toLowerCase().includes(q)
+      || w.description.toLowerCase().includes(q)
+      || w.command.toLowerCase().includes(q)
+      || w.id.toLowerCase().includes(q),
+    )
+  }
+  return result
+})
+
+const tierColor = (tier: string) => {
+  const m: Record<string, 'primary' | 'success' | 'warning' | 'neutral'> = {
+    enterprise: 'primary',
+    focused: 'success',
+    specialist: 'warning',
+  }
+  return m[tier] ?? 'neutral'
+}
+
+const columns: TableColumn<Workflow>[] = [
+  { accessorKey: 'name', header: 'Name' },
+  { accessorKey: 'department', header: 'Department' },
+  { accessorKey: 'tier', header: 'Tier' },
+  { accessorKey: 'command', header: 'Command' },
+  { accessorKey: 'phases_count', header: 'Phases' },
+]
+</script>
+
+<template>
+  <UDashboardPanel id="workflows">
+    <template #header>
+      <UDashboardNavbar title="Workflows">
+        <template #leading>
+          <UDashboardSidebarCollapse />
+        </template>
+        <template #trailing>
+          <UBadge v-if="workflows.length" :label="String(workflows.length)" variant="subtle" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <DashboardState
+        :status="status"
+        :error="error"
+        :empty="!workflows.length"
+        empty-title="No workflows found"
+        empty-description="YAML workflows live under departments/*/workflows/."
+        empty-icon="i-lucide-workflow"
+        loading-label="Scanning workflows"
+        :on-retry="() => refresh()"
+      >
+        <div class="flex flex-wrap items-center gap-3 mb-4">
+          <UInput
+            v-model="search"
+            class="max-w-sm"
+            icon="i-lucide-search"
+            placeholder="Search name, command, description…"
+          />
+          <USelect
+            v-model="deptFilter"
+            :items="departments"
+            placeholder="Department"
+            class="min-w-44"
+          />
+          <span class="ml-auto text-xs text-muted">
+            {{ filtered.length }} workflow{{ filtered.length === 1 ? '' : 's' }}
+          </span>
+        </div>
+
+        <div class="grid grid-cols-1 xl:grid-cols-[1.4fr_1fr] gap-4">
+          <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: Workflow }) => selected = row.original"
+          >
+            <template #name-cell="{ row }">
+              <div class="min-w-0">
+                <p class="font-medium truncate">{{ row.original.name }}</p>
+                <p class="text-xs text-muted font-mono truncate">{{ row.original.id }}</p>
+              </div>
+            </template>
+            <template #department-cell="{ row }">
+              <UBadge :label="row.original.department" variant="subtle" size="sm" />
+            </template>
+            <template #tier-cell="{ row }">
+              <UBadge
+                v-if="row.original.tier"
+                :label="row.original.tier"
+                :color="tierColor(row.original.tier)"
+                variant="subtle"
+                size="sm"
+              />
+              <span v-else class="text-xs text-muted">—</span>
+            </template>
+            <template #command-cell="{ row }">
+              <code v-if="row.original.command" class="text-xs font-mono">{{ row.original.command }}</code>
+              <span v-else class="text-xs text-muted">—</span>
+            </template>
+            <template #phases_count-cell="{ row }">
+              <span class="font-mono text-sm">{{ row.original.phases_count }}</span>
+            </template>
+          </UTable>
+
+          <div
+            v-if="selected"
+            class="rounded-lg border border-default overflow-hidden flex flex-col"
+          >
+            <div class="px-4 py-3 border-b border-default bg-elevated/30">
+              <div class="flex items-start justify-between gap-3">
+                <div class="min-w-0">
+                  <p class="text-xs text-muted uppercase tracking-wide">YAML preview</p>
+                  <p class="font-semibold truncate">{{ selected.name }}</p>
+                  <p class="text-xs text-muted font-mono truncate">{{ selected.file }}</p>
+                </div>
+                <UButton
+                  icon="i-lucide-x"
+                  variant="ghost"
+                  size="xs"
+                  aria-label="Close preview"
+                  @click="selected = null"
+                />
+              </div>
+              <p v-if="selected.description" class="text-xs text-muted mt-2">
+                {{ selected.description }}
+              </p>
+            </div>
+            <pre class="p-4 text-xs font-mono overflow-x-auto whitespace-pre">{{ selected.content }}</pre>
+          </div>
+          <div
+            v-else
+            class="rounded-lg border border-dashed border-default p-8 text-center text-sm text-muted self-start"
+          >
+            Click a row to preview its YAML.
+          </div>
+        </div>
+      </DashboardState>
+    </template>
+  </UDashboardPanel>
+</template>

package/package.json

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

package/scripts/dashboard-api.py

@@ -1387,6 +1387,46 @@ def agent_export_to_vault(agent_id: str):
     return {"exported": True, "path": str(res.path), "vault_path": str(res.vault_path)}
 
 
+# --- Workflows (PR88b v3.24.0) ---
+
+@app.get("/api/workflows")
+def workflows_list():
+    """Scan departments/*/workflows/*.yaml and return metadata + content."""
+    out: list[dict] = []
+    dept_root = ARKAOS_ROOT / "departments"
+    if not dept_root.exists():
+        return {"workflows": []}
+    try:
+        import yaml as _yaml
+    except ImportError:
+        return {"workflows": [], "error": "PyYAML unavailable"}
+    for path in sorted(dept_root.glob("*/workflows/*.yaml")):
+        try:
+            content = path.read_text(encoding="utf-8")
+        except OSError:
+            continue
+        try:
+            raw = _yaml.safe_load(content) or {}
+        except Exception:  # noqa: BLE001
+            raw = {}
+        if not isinstance(raw, dict):
+            continue
+        phases = raw.get("phases") if isinstance(raw.get("phases"), list) else []
+        rel = path.relative_to(ARKAOS_ROOT).as_posix()
+        out.append({
+            "id": str(raw.get("id") or path.stem),
+            "name": str(raw.get("name") or path.stem),
+            "description": str(raw.get("description") or ""),
+            "department": str(raw.get("department") or path.parent.parent.name),
+            "tier": str(raw.get("tier") or ""),
+            "command": str(raw.get("command") or ""),
+            "phases_count": len(phases),
+            "file": rel,
+            "content": content,
+        })
+    return {"workflows": out}
+
+
 # --- Sidebar stats widget (PR87d v3.22.0) ---
 
 @app.get("/api/sidebar-stats")