arkaos 3.25.0 → 3.26.0

package/VERSION

@@ -1 +1 @@
-3.25.0
+3.26.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.25.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.25.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.