fix: registrar agentes de nucleo, corregir herramientas MCP y pipeline del dashboard

- Registrar los 7 agentes de nucleo en plugin.json (antes solo opcionales)
- Corregir 5 nombres de herramientas MCP fantasma en librarian.md
- Auto-crear config con memoria activada en session-start.sh
- Crear iteracion de sesion automatica para asociar commits
- Fallback a datos globales en get_full_state() sin iteracion activa
- Detectar puertos ocupados y buscar alternativas en el dashboard
- Alinear comentarios de cabecera del servidor MCP con nombres reales
- Bump version a 0.3.6

Author: 686f6c61

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "alfred-dev",
       "description": "Plugin de ingeniería de software completa: 15 agentes (8 de núcleo + 7 opcionales), 59 skills, memoria persistente, dashboard web en tiempo real, quality gates y compliance europeo integrado.",
-      "version": "0.3.5",
+      "version": "0.3.6",
       "source": "./",
       "author": {
         "name": "686f6c61"

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "alfred-dev",
   "description": "Plugin de ingeniería de software completa: 8 agentes de núcleo y 7 opcionales con personalidad propia, memoria persistente por proyecto, quality gates y flujos automatizados desde la idea hasta producción.",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "author": {
     "name": "00b"
   },
@@ -23,6 +23,13 @@
     "./commands/update.md"
   ],
   "agents": [
+    "./agents/product-owner.md",
+    "./agents/architect.md",
+    "./agents/senior-dev.md",
+    "./agents/security-officer.md",
+    "./agents/qa-engineer.md",
+    "./agents/devops-engineer.md",
+    "./agents/tech-writer.md",
     "./agents/optional/data-engineer.md",
     "./agents/optional/ux-reviewer.md",
     "./agents/optional/performance-engineer.md",

CHANGELOG.md

@@ -7,6 +7,16 @@ y el proyecto usa [versionado semántico](https://semver.org/lang/es/).
 
 ---
 
+## [0.3.6] - 2026-03-10
+
+### Fixed
+
+- **Agentes de nucleo registrados en plugin.json**: los 7 agentes de nucleo (product-owner, architect, senior-dev, security-officer, qa-engineer, devops-engineer, tech-writer) no estaban registrados en el manifiesto del plugin, por lo que Claude Code no podia cargar sus system prompts como subagentes. Ahora los 14 agentes (7 nucleo + 7 opcionales) estan registrados.
+- **Herramientas MCP fantasma en librarian**: el agente librarian referenciaba 5 herramientas MCP con nombres incorrectos (`memory_record_decision`, `memory_record_iteration`, `memory_record_event`, `memory_record_commit`, `memory_link_commit`). Corregidos a los nombres reales del servidor MCP.
+- **Dashboard vacio en primera sesion**: el pipeline de datos del dashboard fallaba en cascada por 3 causas: (1) la configuracion local no se creaba con memoria activada, (2) sin iteracion activa los commits no se asociaban, (3) `get_full_state()` devolvia arrays vacios sin iteracion. Corregido con auto-creacion de config, iteracion de sesion automatica y fallback a datos globales.
+- **Conflicto de puertos del dashboard**: si otro proyecto ya usaba los puertos 7533/7534, el dashboard no arrancaba. Ahora detecta puertos ocupados y busca alternativas automaticamente.
+- **Comentarios de cabecera del servidor MCP**: los nombres de herramientas en el docstring del modulo no coincidian con los registrados. Alineados.
+
 ## [0.3.5] - 2026-03-10
 
 ### Changed

README.md

@@ -106,7 +106,7 @@ Los agentes con modelo `opus` realizan tareas que requieren razonamiento complej
 
 ### Agentes opcionales (7)
 
-Agentes predefinidos que el usuario activa segun las necesidades de su proyecto con `/alfred config`. Se sugieren automaticamente en funcion del stack detectado. Desde v0.3.5, Alfred tambien propone agentes opcionales de forma dinamica al arrancar cada flujo, analizando la descripcion de la tarea con keywords contextuales y combinandolas con las senales del proyecto. La seleccion dinamica es efimera (solo para esa sesion) y no modifica la configuracion persistente. Mas detalles en la [documentacion de configuracion](docs/configuration.md#composicion-dinamica-de-equipo).
+Agentes predefinidos que el usuario activa segun las necesidades de su proyecto con `/alfred config`. Se sugieren automaticamente en funcion del stack detectado. Desde v0.3.6, Alfred tambien propone agentes opcionales de forma dinamica al arrancar cada flujo, analizando la descripcion de la tarea con keywords contextuales y combinandolas con las senales del proyecto. La seleccion dinamica es efimera (solo para esa sesion) y no modifica la configuracion persistente. Mas detalles en la [documentacion de configuracion](docs/configuration.md#composicion-dinamica-de-equipo).
 
 | Agente | Rol | Cuando es util |
 |--------|-----|----------------|
@@ -242,7 +242,7 @@ Funcionalidades principales:
 
 > **Fase Alpha** -- Funcionalidad en desarrollo activo. La interfaz y el protocolo pueden cambiar entre versiones menores.
 
-A partir de v0.3.0, Alfred Dev incluye un dashboard web que muestra el estado completo del proyecto en tiempo real sin intervenir en el terminal de Claude Code. La v0.3.1 refuerza la estabilidad del servidor (lectura robusta de frames WebSocket, cabeceras de seguridad HTTP, soporte movil) y anade inyeccion dinamica de version y puerto. La v0.3.5 corrige la nomenclatura de comandos en la web y actualiza las estadisticas. Se lanza con `/alfred gui` y se abre automaticamente en el navegador.
+A partir de v0.3.0, Alfred Dev incluye un dashboard web que muestra el estado completo del proyecto en tiempo real sin intervenir en el terminal de Claude Code. La v0.3.1 refuerza la estabilidad del servidor (lectura robusta de frames WebSocket, cabeceras de seguridad HTTP, soporte movil) y anade inyeccion dinamica de version y puerto. La v0.3.6 corrige la nomenclatura de comandos en la web y actualiza las estadisticas. Se lanza con `/alfred gui` y se abre automaticamente en el navegador.
 
 El dashboard actua como fuente de verdad externa: persiste toda la informacion de la sesion independientemente de la compactacion de contexto de Claude Code. Si la conversacion se compacta y se pierde contexto, el dashboard sigue mostrando el historial completo.
 

agents/optional/librarian.md

@@ -101,11 +101,11 @@ Las herramientas de consulta que El Bibliotecario ha utilizado desde su origen.
 | `memory_get_iteration` | Obtener el detalle completo de una iteración por su ID. |
 | `memory_get_timeline` | Recuperar la línea temporal de eventos de una iteración o período. |
 | `memory_stats` | Contadores generales de la memoria: decisiones, iteraciones, commits, eventos. |
-| `memory_record_decision` | Registrar una nueva decisión con contexto, alternativas y justificación. |
-| `memory_record_iteration` | Registrar una nueva iteración con su comando, descripción y fase. |
-| `memory_record_event` | Registrar un evento en la cronología del proyecto. |
-| `memory_record_commit` | Registrar un commit con su SHA, mensaje y ficheros afectados. |
-| `memory_link_commit` | Vincular un commit con una decisión existente. |
+| `memory_log_decision` | Registrar una nueva decisión con contexto, alternativas y justificación. |
+| `memory_manage_iteration` | Registrar o gestionar una iteración con su comando, descripción y fase. |
+| `memory_log_event` | Registrar un evento en la cronología del proyecto. |
+| `memory_log_commit` | Registrar un commit con su SHA, mensaje y ficheros afectados. |
+| `memory_link_decisions` | Vincular dos decisiones relacionadas entre sí. |
 
 ### Bloque de gestión (5 herramientas nuevas)
 

docs/architecture.md

@@ -68,9 +68,9 @@ La capa core contiene la logica de negocio pura del plugin, escrita en Python. E
 
 La capa se compone de tres modulos:
 
-- **`orchestrator.py`** -- Maquina de estados que define 5 flujos de trabajo (feature, fix, spike, ship, audit), cada uno con sus fases secuenciales y quality gates. El orquestador gestiona la creacion de sesiones, la evaluacion de gates y el avance entre fases. El estado se persiste en un fichero JSON plano (`.claude/alfred-dev-state.json`). Desde v0.3.5, la funcion `run_flow()` acepta un parametro opcional `equipo_sesion` que permite inyectar un equipo efimero de agentes opcionales generado por la composicion dinamica (ver [configuration.md](configuration.md#composicion-dinamica-de-equipo)).
+- **`orchestrator.py`** -- Maquina de estados que define 5 flujos de trabajo (feature, fix, spike, ship, audit), cada uno con sus fases secuenciales y quality gates. El orquestador gestiona la creacion de sesiones, la evaluacion de gates y el avance entre fases. El estado se persiste en un fichero JSON plano (`.claude/alfred-dev-state.json`). Desde v0.3.6, la funcion `run_flow()` acepta un parametro opcional `equipo_sesion` que permite inyectar un equipo efimero de agentes opcionales generado por la composicion dinamica (ver [configuration.md](configuration.md#composicion-dinamica-de-equipo)).
 
-- **`config_loader.py`** -- Cargador de configuracion que lee las preferencias del usuario desde un fichero `.local.md` con frontmatter YAML y detecta automaticamente el stack tecnologico del proyecto (runtime, lenguaje, framework, ORM, test runner, bundler). Incluye un parser YAML basico como fallback para entornos sin PyYAML. Desde v0.3.5, el modulo incorpora la funcion `match_task_keywords()` y la constante `TASK_KEYWORDS` para la composicion dinamica de equipo: puntuan agentes opcionales segun la descripcion de la tarea del usuario combinada con senales del proyecto y la configuracion activa.
+- **`config_loader.py`** -- Cargador de configuracion que lee las preferencias del usuario desde un fichero `.local.md` con frontmatter YAML y detecta automaticamente el stack tecnologico del proyecto (runtime, lenguaje, framework, ORM, test runner, bundler). Incluye un parser YAML basico como fallback para entornos sin PyYAML. Desde v0.3.6, el modulo incorpora la funcion `match_task_keywords()` y la constante `TASK_KEYWORDS` para la composicion dinamica de equipo: puntuan agentes opcionales segun la descripcion de la tarea del usuario combinada con senales del proyecto y la configuracion activa.
 
 - **`personality.py`** -- Motor de personalidad que define la identidad, voz y frases caracteristicas de cada agente. El tono se adapta a un nivel de sarcasmo configurable (1 = profesional, 5 = acido). Con niveles altos se anaden frases mordaces al repertorio de cada agente.
 

gui/dashboard.html

@@ -316,7 +316,7 @@
     <button class="mobile-toggle" id="mobile-toggle" aria-label="Menu de navegacion">
       <svg width="18" height="18" viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"><line x1="3" y1="5" x2="15" y2="5"/><line x1="3" y1="9" x2="15" y2="9"/><line x1="3" y1="13" x2="15" y2="13"/></svg>
     </button>
-    <div class="header-logo">Alfred <span>Dev</span> <span class="header-version" style="color:var(--text-dim);font-size:11px;font-weight:400;">v0.3.5</span></div>
+    <div class="header-logo">Alfred <span>Dev</span> <span class="header-version" style="color:var(--text-dim);font-size:11px;font-weight:400;">v0.3.6</span></div>
     <div class="header-sep"></div>
     <div class="header-project">
       Proyecto: <strong id="header-project-name">—</strong>
@@ -519,7 +519,7 @@
     <span>Ultima actividad: <span id="footer-activity">—</span></span>
     <div class="footer-sep"></div>
     <span>WS puerto <span id="footer-ws-port" style="font-family:var(--font-mono);color:var(--text-muted);">7534</span></span>
-    <span class="footer-right">Alfred Dev v0.3.5</span>
+    <span class="footer-right">Alfred Dev v0.3.6</span>
   </footer>
 
 </div>

gui/server.py

@@ -227,6 +227,23 @@ def get_full_state(self) -> Dict[str, Any]:
                 (active["id"],),
             ).fetchall()
             commits = [dict(r) for r in rows]
+        else:
+            # Sin iteración activa: devolver los últimos datos globales
+            # para que el dashboard no esté vacío.
+            rows = conn.execute(
+                "SELECT * FROM decisions ORDER BY id DESC LIMIT 50"
+            ).fetchall()
+            decisions = [dict(r) for r in rows]
+
+            rows = conn.execute(
+                "SELECT * FROM events ORDER BY id DESC LIMIT 100"
+            ).fetchall()
+            events = [dict(r) for r in rows]
+
+            rows = conn.execute(
+                "SELECT * FROM commits ORDER BY id DESC LIMIT 50"
+            ).fetchall()
+            commits = [dict(r) for r in rows]
 
         # Marcados: no dependen de la iteracion
         rows = conn.execute(
@@ -645,10 +662,20 @@ def run(self) -> None:
         servidor WebSocket y el watcher se ejecutan en el bucle asyncio
         del hilo principal.
         """
-        # Seleccionar puertos disponibles si se pidio auto-deteccion
-        if self._http_port == 0:
-            self._http_port = find_available_port(_DEFAULT_HTTP_PORT)
-        if self._ws_port == 0:
+        # Verificar que los puertos están disponibles. Si el puerto solicitado
+        # está ocupado (otra instancia del dashboard u otro servicio), se busca
+        # automáticamente uno libre. Esto permite tener varios proyectos con
+        # dashboards activos simultáneamente sin conflictos.
+        try:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                s.bind(("127.0.0.1", self._http_port))
+        except OSError:
+            self._http_port = find_available_port(self._http_port + 1)
+
+        try:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                s.bind(("127.0.0.1", self._ws_port))
+        except OSError:
             self._ws_port = find_available_port(self._http_port + 1)
 
         print(f"Alfred Dev Dashboard")

hooks/session-start.sh

@@ -157,6 +157,96 @@ db.close()
 " "$MEMORY_DB" "$PLUGIN_ROOT" 2>/dev/null || echo "[Alfred Dev] Aviso: no se pudo crear la BD de memoria" >&2
 fi
 
+# --- Asegurar que la memoria está habilitada por defecto ---
+#
+# Si el fichero de configuración local no existe, se crea con la memoria
+# activada para que los hooks de captura registren datos desde la primera
+# sesión y el dashboard tenga contenido real desde el minuto 1.
+
+LOCAL_CONFIG="${PROJECT_DIR}/.claude/alfred-dev.local.md"
+
+if [[ ! -f "$LOCAL_CONFIG" ]]; then
+  # Crear con memoria habilitada por defecto
+  cat > "$LOCAL_CONFIG" <<'LOCALCFG'
+---
+memoria:
+  enabled: true
+  capture_decisions: true
+  capture_commits: true
+  retention_days: 365
+---
+
+# Configuración local de Alfred Dev
+
+Este fichero se genera automáticamente en la primera sesión.
+Puedes personalizarlo con `/alfred-dev:config`.
+LOCALCFG
+else
+  # El fichero existe: verificar que la memoria está habilitada.
+  # Se usa Python para un parsing fiable del frontmatter YAML en vez de
+  # sed (cuya sintaxis varía entre BSD/macOS y GNU/Linux).
+  PYTHONPATH="${PLUGIN_ROOT}" python3 -c "
+import re, sys
+
+config_path = sys.argv[1]
+with open(config_path, 'r', encoding='utf-8') as f:
+    content = f.read()
+
+# Comprobar si ya tiene memoria habilitada (mismo regex que memory-capture.py)
+pattern = r'memoria:\s*\n(?:\s*#[^\n]*\n|\s*\w+:[^\n]*\n)*?\s*enabled:\s*true'
+if re.search(pattern, content):
+    sys.exit(0)  # Ya habilitada, no hacer nada
+
+# Inyectar la seccion de memoria en el frontmatter
+memoria_block = '''memoria:
+  enabled: true
+  capture_decisions: true
+  capture_commits: true
+  retention_days: 365'''
+
+if content.startswith('---'):
+    # Tiene frontmatter: insertar tras el primer ---
+    idx = content.index('---') + 3
+    content = content[:idx] + '\n' + memoria_block + content[idx:]
+else:
+    # Sin frontmatter: envolver con --- e insertar al principio
+    content = '---\n' + memoria_block + '\n---\n\n' + content
+
+with open(config_path, 'w', encoding='utf-8') as f:
+    f.write(content)
+" "$LOCAL_CONFIG" 2>/dev/null || true
+fi
+
+# --- Asegurar iteración activa para el dashboard ---
+#
+# Si la BD existe pero no hay iteración activa, se crea una de tipo "session"
+# para que los commits y eventos capturados durante el trabajo normal se
+# asocien a algo y el dashboard tenga contenido desde el primer uso.
+# Si el usuario inicia un flujo (/alfred-dev:feature, etc.), la iteración
+# "session" se completará y se creará una nueva del flujo correspondiente.
+
+if [[ -f "$MEMORY_DB" ]]; then
+  PYTHONPATH="${PLUGIN_ROOT}" python3 -c "
+import sys
+sys.path.insert(0, sys.argv[2])
+from core.memory import MemoryDB
+
+db = MemoryDB(sys.argv[1])
+active = db.get_active_iteration()
+if active is None:
+    iteration_id = db.start_iteration(
+        command='session',
+        description='Sesion de trabajo general',
+    )
+    db.log_event(
+        event_type='session_started',
+        payload={'source': 'session-start.sh'},
+        iteration_id=iteration_id,
+    )
+db.close()
+" "$MEMORY_DB" "$PLUGIN_ROOT" 2>/dev/null || true
+fi
+
 # --- Memoria persistente del proyecto ---
 
 # Si el proyecto tiene memoria (.claude/alfred-memory.db), se extrae

install.ps1

@@ -19,7 +19,7 @@ $ErrorActionPreference = 'Stop'
 
 $Repo = "686f6c61/alfred-dev"
 $PluginName = "alfred-dev"
-$Version = "0.3.5"
+$Version = "0.3.6"
 
 # -- Funciones auxiliares ---------------------------------------------------