arkaos 3.24.0 → 3.26.0

package/VERSION

@@ -1 +1 @@
-3.24.0
+3.26.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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.24.0",
+  "version": "3.26.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.24.0"
+version = "3.26.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.
@@ -839,6 +929,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.