arkaos 3.23.0 → 3.25.0

package/VERSION

@@ -1 +1 @@
-3.23.0
+3.25.0

package/core/knowledge/vector_store.py

@@ -283,6 +283,19 @@ class VectorStore:
             "db_path": self._db_path,
         }
 
+    def list_sources(self) -> list[dict]:
+        """PR88c v3.25.0 — distinct sources with chunk counts.
+
+        Returns rows sorted by chunk count desc so the noisiest
+        sources surface first.
+        """
+        rows = self._db.execute(
+            "SELECT source, COUNT(*) AS chunks FROM chunks "
+            "WHERE source IS NOT NULL AND source != '' "
+            "GROUP BY source ORDER BY chunks DESC"
+        ).fetchall()
+        return [{"source": r["source"], "chunks": int(r["chunks"])} for r in rows]
+
     def clear(self) -> None:
         """Remove all data."""
         if self._vec_available:

package/dashboard/app/components/KnowledgeSourcesList.vue

@@ -0,0 +1,157 @@
+<script setup lang="ts">
+// PR88c v3.25.0 — Listing + management of indexed knowledge sources.
+//
+// Sits below the ingest UI on /knowledge. Loads GET /api/knowledge/sources
+// (returns `{sources: [{source, chunks}], total}`), supports search,
+// per-row Delete (DELETE /api/knowledge/sources?source=...). Pagination
+// inline.
+
+interface SourceRow {
+  source: string
+  chunks: number
+}
+
+const { fetchApi, apiBase } = useApi()
+const toast = useToast()
+const confirmDialog = useConfirmDialog()
+
+const { data, status, error, refresh } = await fetchApi<{
+  sources: SourceRow[]
+  total: number
+}>('/api/knowledge/sources')
+
+const sources = computed(() => data.value?.sources ?? [])
+const search = ref('')
+const page = ref(1)
+const pageSize = 15
+
+const filtered = computed(() => {
+  const q = search.value.toLowerCase().trim()
+  if (!q) return sources.value
+  return sources.value.filter((s) => s.source.toLowerCase().includes(q))
+})
+const totalPages = computed(() => Math.max(1, Math.ceil(filtered.value.length / pageSize)))
+const paged = computed(() =>
+  filtered.value.slice((page.value - 1) * pageSize, page.value * pageSize),
+)
+
+watch(search, () => { page.value = 1 })
+
+async function remove(row: SourceRow) {
+  const ok = await confirmDialog({
+    title: 'Delete source?',
+    description: `Removes ${row.chunks} chunk${row.chunks === 1 ? '' : 's'} from the vector store. This cannot be undone.`,
+    confirmLabel: 'Delete',
+    cancelLabel: 'Cancel',
+    variant: 'danger',
+  })
+  if (!ok) return
+  try {
+    const res = await $fetch<{ deleted?: number, error?: string }>(
+      `${apiBase}/api/knowledge/sources`,
+      { method: 'DELETE', query: { source: row.source } },
+    )
+    if (res.error) throw new Error(res.error)
+    toast.add({
+      title: `Removed ${res.deleted ?? 0} chunks`,
+      description: row.source,
+      color: 'success',
+    })
+    await refresh()
+  } catch (err) {
+    toast.add({
+      title: 'Delete failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  }
+}
+
+function sourceLabel(src: string): string {
+  if (src.startsWith('http')) {
+    try {
+      const u = new URL(src)
+      return u.hostname + u.pathname
+    } catch {
+      return src
+    }
+  }
+  return src
+}
+</script>
+
+<template>
+  <UCard>
+    <template #header>
+      <div class="flex items-center justify-between gap-3">
+        <div>
+          <h3 class="text-lg font-bold">Indexed sources</h3>
+          <p class="text-xs text-muted mt-0.5">
+            Every distinct source contributing chunks to the vector store.
+            <span v-if="data?.total">{{ data.total }} total.</span>
+          </p>
+        </div>
+        <UButton
+          icon="i-lucide-refresh-cw"
+          variant="ghost"
+          size="sm"
+          aria-label="Refresh"
+          :loading="status === 'pending'"
+          @click="refresh"
+        />
+      </div>
+    </template>
+
+    <div v-if="error" class="py-6 text-center text-sm text-error">
+      Failed to load sources.
+    </div>
+    <div v-else-if="!sources.length" class="py-6 text-center text-sm text-muted">
+      <UIcon name="i-lucide-database" class="size-6 mx-auto mb-2" />
+      No sources indexed yet. Use the ingest panel above to add content.
+    </div>
+    <div v-else class="space-y-3">
+      <UInput
+        v-model="search"
+        icon="i-lucide-search"
+        placeholder="Filter by source URL or path…"
+        class="w-full"
+      />
+
+      <ul class="space-y-1.5">
+        <li
+          v-for="row in paged"
+          :key="row.source"
+          class="flex items-center gap-3 rounded-lg border border-default p-2.5 hover:border-primary/40 transition-colors"
+        >
+          <UIcon
+            :name="row.source.startsWith('http') ? 'i-lucide-link' : 'i-lucide-file-text'"
+            class="size-4 text-muted shrink-0"
+          />
+          <div class="flex-1 min-w-0">
+            <p class="text-sm font-mono truncate" :title="row.source">
+              {{ sourceLabel(row.source) }}
+            </p>
+          </div>
+          <UBadge :label="`${row.chunks} chunk${row.chunks === 1 ? '' : 's'}`" variant="subtle" size="xs" />
+          <UButton
+            icon="i-lucide-trash-2"
+            color="error"
+            variant="ghost"
+            size="xs"
+            aria-label="Delete source"
+            @click="remove(row)"
+          />
+        </li>
+      </ul>
+
+      <div v-if="totalPages > 1" class="flex items-center justify-center pt-2">
+        <UPagination
+          :page="page"
+          :total="filtered.length"
+          :items-per-page="pageSize"
+          @update:page="(val) => page = val"
+        />
+      </div>
+    </div>
+  </UCard>
+</template>

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/knowledge.vue

@@ -906,6 +906,11 @@ function escapeRegex(value: string): string {
               </div>
             </template>
           </div>
+
+          <!-- PR88c v3.25.0 — Indexed sources management -->
+          <div class="mt-6">
+            <KnowledgeSourcesList />
+          </div>
         </template>
       </template>
     </template>

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.25.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.25.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -839,6 +839,23 @@ def knowledge_search(q: str = Query(...), top_k: int = Query(5)):
     return {"results": results, "query": q, "total": len(results)}
 
 
+@app.get("/api/knowledge/sources")
+def knowledge_list_sources():
+    """PR88c v3.25.0 — list every distinct source + chunk count.
+
+    Returns ``{sources: [{source, chunks}], total: N}``. Sorted
+    descending by chunk count.
+    """
+    store = _get_vector_store()
+    if not store:
+        return {"sources": [], "total": 0, "error": "vector store unavailable"}
+    try:
+        rows = store.list_sources()
+    except Exception as exc:  # noqa: BLE001
+        return {"sources": [], "total": 0, "error": str(exc)}
+    return {"sources": rows, "total": len(rows)}
+
+
 @app.delete("/api/knowledge/sources")
 def knowledge_delete_source(source: str = Query(...)):
     """PR71 v2.88.0 — remove all chunks from a given source.
@@ -1387,6 +1404,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")