genoma-evolution 1.0.0

package/.claude/worktrees/phase-2-mcp/.brv/.obsidian/workspace.json

@@ -0,0 +1,195 @@
+{
+  "main": {
+    "id": "c77e0f710c930fa7",
+    "type": "split",
+    "children": [
+      {
+        "id": "bf710331cf454ac1",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "7dd2f10c3fd70295",
+            "type": "leaf",
+            "state": {
+              "type": "graph",
+              "state": {},
+              "icon": "lucide-git-fork",
+              "title": "Vista gráfica"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "vertical"
+  },
+  "left": {
+    "id": "c280d4ac82a6f39c",
+    "type": "split",
+    "children": [
+      {
+        "id": "213aee7d13cc7978",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "ad49f6491e09a413",
+            "type": "leaf",
+            "state": {
+              "type": "file-explorer",
+              "state": {
+                "sortOrder": "alphabetical",
+                "autoReveal": false
+              },
+              "icon": "lucide-folder-closed",
+              "title": "Explorador de archivos"
+            }
+          },
+          {
+            "id": "69a2759aa29d947d",
+            "type": "leaf",
+            "state": {
+              "type": "search",
+              "state": {
+                "query": "",
+                "matchingCase": false,
+                "explainSearch": false,
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical"
+              },
+              "icon": "lucide-search",
+              "title": "Buscar"
+            }
+          },
+          {
+            "id": "c4483da973b7d874",
+            "type": "leaf",
+            "state": {
+              "type": "bookmarks",
+              "state": {},
+              "icon": "lucide-bookmark",
+              "title": "Marcadores"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300
+  },
+  "right": {
+    "id": "25616962a4dd7a61",
+    "type": "split",
+    "children": [
+      {
+        "id": "d54d0da84f5701f9",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "d2e9a9e03a699c8e",
+            "type": "leaf",
+            "state": {
+              "type": "backlink",
+              "state": {
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical",
+                "showSearch": false,
+                "searchQuery": "",
+                "backlinkCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-coming-in",
+              "title": "Enlaces entrantes"
+            }
+          },
+          {
+            "id": "108efca68daf192a",
+            "type": "leaf",
+            "state": {
+              "type": "outgoing-link",
+              "state": {
+                "linksCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-going-out",
+              "title": "Enlaces salientes"
+            }
+          },
+          {
+            "id": "5a555d7a5be6a236",
+            "type": "leaf",
+            "state": {
+              "type": "tag",
+              "state": {
+                "sortOrder": "frequency",
+                "useHierarchy": true,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-tags",
+              "title": "Etiquetas"
+            }
+          },
+          {
+            "id": "b52e6b9b21f82923",
+            "type": "leaf",
+            "state": {
+              "type": "all-properties",
+              "state": {
+                "sortOrder": "frequency",
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-archive",
+              "title": "Todas las propiedades"
+            }
+          },
+          {
+            "id": "a49dc511283fa2c6",
+            "type": "leaf",
+            "state": {
+              "type": "outline",
+              "state": {
+                "followCursor": false,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-list",
+              "title": "Esquema"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300,
+    "collapsed": true
+  },
+  "left-ribbon": {
+    "hiddenItems": {
+      "switcher:Abrir selector rápido": false,
+      "graph:Abrir vista gráfica": false,
+      "canvas:Crear nuevo lienzo": false,
+      "daily-notes:Abrir la nota de hoy": false,
+      "templates:Insertar plantilla": false,
+      "command-palette:Abrir paleta de comandos": false,
+      "bases:Crear nueva base": false
+    }
+  },
+  "active": "7dd2f10c3fd70295",
+  "lastOpenFiles": [
+    "Sin título.canvas",
+    "Sin título 2.canvas",
+    "Sin título 1.canvas",
+    "context-tree/frontend/hermes_dashboard/architecture_overview.md",
+    "context-tree/frontend/hermes_dashboard/_index.md",
+    "context-tree/backend/backend/main.overview.md",
+    "context-tree/backend/backend/requirements.abstract.md",
+    "context-tree/backend/backend/requirements.overview.md",
+    "context-tree/backend/backend/main.md",
+    "context-tree/backend/backend/job_tracker.md",
+    "context-tree/backend/backend/_index.md",
+    "context-tree/frontend/hermes_dashboard/architecture_overview.abstract.md",
+    "context-tree/meta/_index.md"
+  ]
+}

package/.claude/worktrees/phase-2-mcp/.brv/Sin t/303/255tulo 1.canvas"

@@ -0,0 +1 @@
+{}

package/.claude/worktrees/phase-2-mcp/.brv/Sin t/303/255tulo 2.canvas"

@@ -0,0 +1 @@
+{}

package/.claude/worktrees/phase-2-mcp/.brv/Sin t/303/255tulo.canvas"

@@ -0,0 +1 @@
+{}

package/.claude/worktrees/phase-2-mcp/.brv/_queue_status.json

@@ -0,0 +1 @@
+{"failed":0,"pending":0,"processed":4,"processing":false}

package/.claude/worktrees/phase-2-mcp/.brv/config.json

@@ -0,0 +1,5 @@
+{
+  "createdAt": "2026-04-22T03:04:07.873Z",
+  "cwd": "/home/leandro/.hermes/hermes-dashboard",
+  "version": "0.0.1"
+}

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/_index.md

@@ -0,0 +1,60 @@
+---
+children_hash: 28dd785d82a778d1717dc864f2d77eefc970e447e4654c326b49c4865c35a44a
+compression_ratio: 0.42490272373540855
+condensation_order: 3
+covers: [backend/_index.md, docs/_index.md, frontend/_index.md, meta/_index.md]
+covers_token_total: 1285
+summary_level: d3
+token_count: 546
+type: summary
+---
+# Hermes Dashboard — System Architecture
+
+## Overview
+
+Full-stack monitoring dashboard bridging Next.js frontend to hermes-agent-self-evolution via FastAPI backend.
+
+## Architecture
+
+```
+Next.js (port 3000) ←→ FastAPI (port 8000, configurable)
+                    ←→ WebSocket for real-time job streaming
+```
+
+## Frontend Layer
+
+- **Stack:** Next.js 16 · React Query · Framer Motion · CSS gradients
+- **8 Navigation Sections:** Overview · Skills · Evolution · Datasets · Memory · Metrics · Logs · Settings
+- **API Client** (`frontend/src/lib/api.ts`): 15s timeouts, WebSocket 3s auto-reconnect, lazy-loaded session
+- **Key Components:** `Sidebar` (collapsible 64px/240px, dual themes), `SettingsPage` (system paths, env vars)
+
+## Backend Layer
+
+- **Core Modules:** `job_tracker` (JobStatus enum, 10 states; EvolutionJob dataclass; log parsing via regex), `main` (~20 endpoints + WebSocket)
+- **Dependencies:** fastapi>=0.115.0, uvicorn[standard]>=0.34.0, websockets>=13.0, pyyaml>=6.0
+- **EvolutionJob lifecycle:** queued → loading_skill → building_dataset → validating → configuring → optimizing → evaluating → saving → completed/failed
+
+## API Contract
+
+| Group | Endpoints |
+|-------|-----------|
+| Skills | `GET /api/skills`, `GET /api/skills/{name}`, `GET /api/skills/{name}/evolution-history` |
+| Evolution | `GET /api/evolution/runs`, `POST /api/evolution/start` |
+| Jobs | `GET/DELETE /api/jobs/{jobId}`, `GET /api/jobs/{jobId}/logs` |
+| Health | `GET /api/health` |
+
+## Key Relationships
+
+- Backend imports `job_tracker` singleton; both reference `HERMES_AGENT_REPO` / `EVOLUTION_DIR` paths
+- Frontend lazy-loads all pages via `next/dynamic`; backend streams job progress via WebSocket
+- `ApiError` kinds: `network`, `timeout`, `server` (5xx), `client` (4xx)
+
+## Drill-Down
+
+| Area | Source |
+|------|--------|
+| Full architecture | `frontend/hermes_dashboard/architecture_overview.md` |
+| API specification | `docs/api/hermes_api_openapi_specification.md` |
+| Sidebar implementation | `frontend/src/components/sidebar_navigation_component.md` |
+| API client details | `frontend/src/lib/api_client_library.md` |
+| Job tracking | `backend/job_tracker.md`, `backend/main.md` |

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/_manifest.json

@@ -0,0 +1,165 @@
+{
+  "active_context": [
+    {
+      "order": 3,
+      "path": "_index.md",
+      "tokens": 546,
+      "type": "summary"
+    },
+    {
+      "order": 2,
+      "path": "backend/_index.md",
+      "tokens": 198,
+      "type": "summary"
+    },
+    {
+      "order": 2,
+      "path": "docs/_index.md",
+      "tokens": 275,
+      "type": "summary"
+    },
+    {
+      "order": 2,
+      "path": "frontend/_index.md",
+      "tokens": 409,
+      "type": "summary"
+    },
+    {
+      "order": 2,
+      "path": "meta/_index.md",
+      "tokens": 147,
+      "type": "summary"
+    },
+    {
+      "order": 1,
+      "path": "backend/backend/_index.md",
+      "tokens": 423,
+      "type": "summary"
+    },
+    {
+      "abstractPath": "backend/backend/init.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "backend/backend/init.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "backend/backend/job_tracker.abstract.md",
+      "abstractTokens": 62,
+      "importance": 50,
+      "path": "backend/backend/job_tracker.md",
+      "tokens": 62,
+      "type": "context"
+    },
+    {
+      "abstractPath": "backend/backend/main.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "backend/backend/main.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "backend/backend/requirements.abstract.md",
+      "abstractTokens": 51,
+      "importance": 50,
+      "path": "backend/backend/requirements.md",
+      "tokens": 51,
+      "type": "context"
+    },
+    {
+      "importance": 50,
+      "path": "docs/api/context.md",
+      "tokens": 55,
+      "type": "context"
+    },
+    {
+      "abstractPath": "docs/api/hermes_api_openapi_specification.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "docs/api/hermes_api_openapi_specification.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/hermes_dashboard/architecture_overview.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "frontend/hermes_dashboard/architecture_overview.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/src/components/sidebar_navigation_component.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "frontend/src/components/sidebar_navigation_component.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "importance": 50,
+      "path": "frontend/src/context.md",
+      "tokens": 49,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/src/functioncallingpage.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "frontend/src/functioncallingpage.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/src/lib/api_client_library.abstract.md",
+      "abstractTokens": 59,
+      "importance": 50,
+      "path": "frontend/src/lib/api_client_library.md",
+      "tokens": 59,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/src/page.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "frontend/src/page.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/src/settingspage.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "frontend/src/settingspage.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "frontend/src/sidebar.abstract.md",
+      "abstractTokens": 0,
+      "importance": 50,
+      "path": "frontend/src/sidebar.md",
+      "tokens": 0,
+      "type": "context"
+    },
+    {
+      "abstractPath": "meta/curation_context/empty_context.abstract.md",
+      "abstractTokens": 47,
+      "importance": 50,
+      "path": "meta/curation_context/empty_context.md",
+      "tokens": 47,
+      "type": "context"
+    }
+  ],
+  "generated_at": "2026-04-28T03:48:43.119Z",
+  "lane_tokens": {
+    "contexts": 323,
+    "stubs": 0,
+    "summaries": 1998
+  },
+  "source_fingerprint": "f717f55629192fff9133dba5a7fa2b99fdf11cd9cedfa38aab2cc7247db0c17b",
+  "total_tokens": 2321,
+  "version": 1
+}

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/backend/_index.md

@@ -0,0 +1,24 @@
+---
+children_hash: 12f1830600dd1d745816e9834ba900a01ae72ef7e912baf47f5fecd1d9fa273f
+compression_ratio: 0.4008097165991903
+condensation_order: 2
+covers: [backend/_index.md]
+covers_token_total: 494
+summary_level: d2
+token_count: 198
+type: summary
+---
+# Backend Domain Summary
+
+FastAPI backend bridging Next.js frontend to hermes-agent-self-evolution system.
+
+## Core Modules
+
+- **init** — Empty module placeholder
+- **job_tracker** — Persistent job tracking with JobStatus enum (10 states), EvolutionJob dataclass, JobTracker class managing lifecycle and log parsing via regex
+- **main** — FastAPI app with ~20 endpoints + WebSocket for skills, evolution, jobs, datasets, and graph visualization
+- **requirements** — Dependencies: fastapi>=0.115.0, uvicorn[standard]>=0.34.0, websockets>=13.0, pyyaml>=6.0
+
+## Key Relationships
+
+`main.py` imports `job_tracker` module (singleton tracker). Both modules reference HERMES_AGENT_REPO and EVOLUTION_DIR paths. Job tracker provides real-time progress parsing for evolution streaming via WebSocket.

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/backend/backend/_index.md

@@ -0,0 +1,40 @@
+---
+children_hash: fa7fc518cdde3800a2beb0727fae728f6acd2a999b0fe58a86d5d01fc641ca17
+compression_ratio: 0.02604840199519675
+condensation_order: 1
+covers: [init.md, job_tracker.md, main.md, requirements.md]
+covers_token_total: 16239
+summary_level: d1
+token_count: 423
+type: summary
+---
+# Backend Domain Summary
+
+The Backend domain contains the hermes-dashboard FastAPI backend modules that bridge the Next.js frontend to the hermes-agent-self-evolution system.
+
+## Entry Overview
+
+- **[init.md](backend/backend/init.md)** — Empty Python module placeholder
+
+- **[job_tracker.md](backend/backend/job_tracker.md)** — Persistent job tracking system for evolution runs
+  - **JobStatus** enum: 10 states (QUEUED → COMPLETED/FAILED)
+  - **EvolutionJob** dataclass: tracks skill_name, iterations, progress, scores, logs
+  - **JobTracker** class: manages job lifecycle, parses log output via PHASE_PATTERNS, SCORE_PATTERN, ITER_PATTERN regex
+  - Persists logs to `~/.hermes/evolution-logs/`
+
+- **[main.md](backend/backend/main.md)** — FastAPI application with ~20 REST endpoints + WebSocket
+  - **Skill endpoints**: list providers, refresh, toggle, delete, get content
+  - **Evolution endpoints**: start run, list runs, history, diff, metrics
+  - **Job endpoints**: list, get, get logs, cancel
+  - **Dataset endpoints**: list, get, import sessions
+  - **Graph endpoint**: generates vis.js format from skills, memory, and evolution runs (with community detection)
+  - **Metrics & constraints validation**
+  - Uses Ollama when available, falls back to cloud providers
+
+- **[requirements.md](backend/backend/requirements.md)** — Dependencies: fastapi>=0.115.0, uvicorn[standard]>=0.34.0, websockets>=13.0, pyyaml>=6.0
+
+## Key Relationships
+
+- `main.py` imports and uses `job_tracker` module (tracker singleton, JobStatus, EvolutionJob)
+- Both modules reference HERMES_AGENT_REPO and EVOLUTION_DIR paths
+- Job tracker provides real-time progress parsing for evolution streaming via WebSocket

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/backend/backend/init.md

@@ -0,0 +1,27 @@
+---
+title: __init__
+summary: ''
+tags: []
+related: []
+keywords: []
+createdAt: '2026-04-28T01:33:30.560Z'
+updatedAt: '2026-04-28T01:33:30.560Z'
+---
+## Reason
+Preserving complete backend/__init__.py from hermes-dashboard project
+
+## Raw Concept
+**Task:**
+Preserve backend/__init__.py
+
+**Files:**
+- backend/__init__.py
+
+**Timestamp:** 2026-04-28
+
+## Narrative
+### Structure
+Python file with 0 classes and 0 functions
+
+### Highlights
+Source: hermes-dashboard/backend/__init__.py

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/backend/backend/init.overview.md

@@ -0,0 +1,29 @@
+# Document Overview: `backend/__init__.py`
+
+## Key Points
+
+- **File:** `backend/__init__.py`
+- **Project:** hermes-dashboard
+- **Content:** Empty Python package initialization file
+- **Contains:** 0 classes, 0 functions
+- **Purpose:** Marks the `backend/` directory as a Python package
+- **Timestamp:** 2026-04-28
+
+## Structure
+
+- **Reason:** Preservation of the file from hermes-dashboard project
+- **Raw Concept:** Task metadata indicating file to preserve
+- **Narrative:** States file structure (no classes/functions)
+
+## Notable Entities
+
+| Entity | Value |
+|--------|-------|
+| Project | hermes-dashboard |
+| File | backend/__init__.py |
+| Classes | 0 |
+| Functions | 0 |
+
+## Notes
+
+This is a minimal Python `__init__.py` file serving only as a package marker. The file contains no executable code, imports, or definitions. These placeholder files are commonly included to ensure proper Python package discovery.

package/.claude/worktrees/phase-2-mcp/.brv/context-tree/backend/backend/job_tracker.abstract.md

@@ -0,0 +1 @@
+job_tracker.py provides a JobTracker class with EvolutionJob dataclass to manage evolution job lifecycles, tracking status transitions across defined phases, logging output, extracting scores and iteration progress, and persisting job state to disk.