Skip to content

ROADMAP.md

Latest commit

 

History

History
740 lines (616 loc) · 29.7 KB

ROADMAP.md

File metadata and controls

740 lines (616 loc) · 29.7 KB
Raw

🫙 Alfred Mission Control - Roadmap

Fase 1: Fundamentos ✅ COMPLETO

Mejorar lo que ya existe y añadir datos reales

1.1 Activity Logger Real ✅

  • Crear endpoint POST /api/activities para que Alfred Mission Control registre acciones
  • Hook en OpenClaw para loguear automáticamente cada tool call
  • Campos: timestamp, type, description, status, duration, tokens_used
  • Retención: últimos 30 días
  • Archivos: src/app/api/activities/route.ts, src/app/(dashboard)/activity/page.tsx

1.2 Integración con Cron Real ✅

  • Leer cron jobs reales de OpenClaw (cron list)
  • Mostrar en calendario con próximas ejecuciones
  • Historial de ejecuciones pasadas

1.3 Stats Dashboard ✅

  • Contador de actividades por día/semana
  • Tipos de acciones más frecuentes
  • Tasa de éxito/error
  • Archivos: src/components/charts/*, src/components/ActivityHeatmap.tsx

Fase 2: Memory & Files ✅ COMPLETO

Gestión visual del workspace

2.1 Memory Browser ✅

  • Vista árbol de memory/*.md y archivos principales
  • Editor markdown con preview
  • Crear/renombrar/eliminar archivos
  • Búsqueda dentro de archivos
  • Knowledge Graph - Grafo interactivo de conceptos (tab en /memory)
  • Word Cloud - Palabras frecuentes en memories (tab en /memory)
  • Archivos: src/app/(dashboard)/memory/page.tsx, src/components/FileTree.tsx, src/components/MarkdownEditor.tsx, src/components/KnowledgeGraph.tsx, src/components/MemoryWordCloud.tsx

2.2 File Browser ✅

  • Explorador del workspace completo
  • Preview de archivos (código, markdown, JSON)
  • Descargar archivos
  • Upload de archivos
  • 3D View - Vista 3D del árbol de archivos (toggle en /files)
  • Archivos: src/app/(dashboard)/files/page.tsx, src/components/FileBrowser.tsx, src/components/files-3d/FileTree3D.tsx

2.3 MEMORY.md Viewer ✅

  • Vista especial para MEMORY.md con secciones colapsables
  • Edición inline
  • Historial de cambios (git log) - integrado en Memory Browser
  • Archivos: Integrado en Memory Browser

Fase 3: Unified Cron Dashboard ✅ COMPLETO

Control total de tareas programadas - System + OpenClaw + Heartbeat

Ver documentación: docs/CRON-SYSTEMS.md

3.1 System Cron Viewer ✅

  • API: Leer jobs de /etc/cron.d/
  • API: Run Now + View Logs
  • UI: SystemCronCard con badge diferenciado
  • UI: Modal de logs
  • Archivos: src/app/api/cron/system/route.ts, src/app/api/cron/system-run/route.ts, src/app/api/cron/system-logs/route.ts, src/components/SystemCronCard.tsx

3.2 OpenClaw Cron Manager ✅

  • Listar todos los jobs con estado
  • Crear nuevo job con form visual (CronJobModal conectado al API)
  • Editar job existente
  • Eliminar job (con confirmación)
  • Activar/desactivar job
  • Visual builder con 6 modos de frecuencia
  • Preview de próximas 5 ejecuciones
  • Templates predefinidos
  • Archivos: src/app/api/cron/route.ts, src/components/CronJobModal.tsx

3.3 Heartbeat Monitor ✅

  • API: Estado de heartbeat (enabled, interval, target)
  • API: Leer/escribir HEARTBEAT.md
  • UI: Panel de estado
  • UI: Editor de HEARTBEAT.md con template
  • Archivos: src/app/api/heartbeat/route.ts, src/components/HeartbeatStatus.tsx

3.4 Unified Views ✅

  • Tabs: All / System / OpenClaw / Heartbeat
  • Weekly Timeline View (OpenClaw jobs)
  • Stats cards unificados (4 cards: System, OpenClaw, Heartbeat, Paused)
  • Click en stats filtra por tipo
  • Archivos: src/app/(dashboard)/cron/page.tsx, src/components/CronWeeklyTimeline.tsx

3.5 Historial de Ejecuciones ✅

  • "Run Now" button en CronJobCard y SystemCronCard
  • Run History inline con filtros
  • Log con output completo
  • Archivos: src/app/api/cron/run/route.ts, src/app/api/cron/runs/route.ts

Fase 4: Analytics ✅ COMPLETO

Visualización de datos

4.1 Gráficas de Uso ✅

  • Actividad por hora del día (heatmap)
  • Tokens consumidos por día (line chart)
  • Tipos de tareas (pie chart)
  • Tendencia semanal
  • Archivos: src/app/(dashboard)/analytics/page.tsx, src/components/charts/*

4.2 Cost Tracking ✅

  • Estimación de coste por modelo
  • Coste acumulado diario/mensual
  • Alertas de gasto (opcional)
  • Sankey Diagrams - Flow de tokens/tareas/tiempo (tab en /analytics)
  • Archivos: src/app/(dashboard)/analytics/page.tsx, src/components/sankey/SankeyDiagrams.tsx

4.3 Performance Metrics ✅

  • Tiempo promedio de respuesta (en activity)
  • Tasa de éxito por tipo de tarea (SuccessRateGauge)
  • Uptime del agente
  • Archivos: src/app/api/system/uptime/route.ts

Fase 5: Comunicación ✅ COMPLETO

Interacción bidireccional

5.1 Command Terminal ✅

  • Input para enviar mensajes/comandos a Alfred Mission Control
  • Output en tiempo real de respuesta
  • Historial de comandos
  • Shortcuts para comandos frecuentes
  • Archivos: src/app/(dashboard)/terminal/page.tsx, src/app/api/terminal/route.ts

5.2 Notifications Log ✅

  • Lista de mensajes enviados por canal (Telegram, etc.)
  • Filtrar por fecha, canal, tipo
  • Preview del mensaje
  • Estado de entrega
  • Archivos: src/app/api/notifications/outbox/route.ts, src/app/(dashboard)/notifications/page.tsx

5.3 Session History ✅

  • Lista de sesiones → todas las sesiones de OpenClaw (main, cron, subagent, chats)
  • Tipos visuales → badges con emoji 🫙 Main / 🕐 Cron / 🤖 Sub-agent / 💬 Direct
  • Token counter → total tokens + barra de contexto (% usado) con color-coding
  • Model badge → modelo mostrado (Sonnet 4.5, Opus 4.6, etc.)
  • Age display → "2 hours ago", "3 days ago" con date-fns
  • Transcript viewer → slide-in panel con mensajes del JSONL real
  • Bubbles UI → user/assistant/tool_use/tool_result con diferentes estilos
  • Filter tabs → All / Main / Cron / Sub-agents / Chats con contador
  • Búsqueda → filtro por key/model
  • Stats cards → Total sessions, Total tokens, Cron runs, Models used
  • Archivos: src/app/api/sessions/route.ts, src/app/(dashboard)/sessions/page.tsx

5.4 Notifications System ✅

  • API de notificaciones → GET/POST/PATCH/DELETE /api/notifications
  • NotificationDropdown component → Bell icon en TopBar con dropdown funcional
  • Unread count badge → Contador de notificaciones no leídas
  • Notificación types → info, success, warning, error con iconos y colores
  • Mark as read/unread → Individual o todas
  • Delete notifications → Individual o clear all read
  • Links → Notificaciones pueden tener links a páginas internas
  • Auto-refresh → Poll cada 30 segundos
  • Integración con cron → Cron Run Now genera notificación
  • Archivos: src/app/api/notifications/route.ts, src/components/NotificationDropdown.tsx

5.5 Notifications Page ✅

  • Lista completa de notificaciones
  • Filtros por tipo y fecha
  • Marcar como leída
  • Eliminar notificaciones
  • Archivos: src/app/(dashboard)/notifications/page.tsx

Fase 6: Configuración ✅ COMPLETO

Admin del sistema

6.1 Skills Manager ✅

  • Lista de skills instalados
  • Ver SKILL.md de cada uno
  • Activar/desactivar
  • Instalar desde ClawHub
  • Actualizar skills
  • Archivos: src/app/(dashboard)/skills/page.tsx, src/app/api/skills/route.ts, src/app/api/skills/[id]/toggle/route.ts

6.2 Integration Status ✅

  • Estado de conexiones (componente existe)
  • Última actividad por integración
  • Test de conectividad
  • Reautenticar si necesario
  • Archivos: src/components/IntegrationStatus.tsx

6.3 Config Editor ✅

  • Ver configuración actual de OpenClaw
  • Editar valores seguros
  • Validación antes de guardar
  • Reiniciar gateway si necesario
  • Archivos: src/app/api/config/route.ts, src/components/ConfigEditor.tsx

6.4 Git Dashboard ✅

  • Lista de repositorios en workspace
  • Ver branch, ahead/behind, último commit
  • Ver archivos staged, unstaged, untracked
  • Acciones: status, log, diff, pull
  • Archivos: src/app/(dashboard)/git/page.tsx, src/app/api/git/route.ts

6.5 Calendar ✅

  • Vista semanal de calendario
  • Mostrar tareas programadas
  • Navegación entre semanas
  • Tareas mostradas por día y hora
  • Archivos: src/app/(dashboard)/calendar/page.tsx, src/app/api/tasks/route.ts

Fase 7: Real-time ✅ COMPLETO

WebSockets y notificaciones live

7.1 Live Activity Stream ✅

  • SSE connection (Server-Sent Events)
  • Updates en tiempo real del activity feed
  • Indicador "Alfred Mission Control está trabajando..." (LiveStatusIndicator)
  • Toast notifications (ToastProvider + useToast)
  • Archivos: src/app/api/activities/stream/route.ts, src/hooks/useActivityStream.ts, src/components/LiveStatusIndicator.tsx, src/components/Toast.tsx

7.2 System Status ✅

  • Heartbeat del agente (en /heartbeat)
  • CPU/memoria del VPS (en /system)
  • Cola de tareas pendientes
  • Archivos: src/app/(dashboard)/system/page.tsx

Fase 8: The Office 3D 🏢 ✅ COMPLETO

Entorno 3D navegable que simula una oficina virtual donde trabajan los agentes

Ver spec completa: ROADMAP-OFFICE-3D.md

8.1 MVP - Oficina Básica ✅

  • Sala 3D con React Three Fiber + escritorios dinámicos
  • Navegación WASD + mouse (fly mode) - FirstPersonControls
  • Monitors mostrando estado: Working/Idle/Error
  • Click en escritorio → panel lateral con activity feed
  • Iluminación básica (día/noche)
  • Avatares con emoji del agente
  • Archivos: src/components/Office3D/Office3D.tsx, src/app/office/page.tsx

8.2 Interactions & Ambient ✅

  • Avatares animados (tecleando, pensando, error)
  • Sub-agents aparecen como "visitantes" en la oficina
  • Trail visual entre parent y sub-agent
  • Efectos visuales (partículas success, humo error, beam heartbeat)
  • Sonido ambiental toggleable (teclas, notificaciones, lofi)
  • Click en objetos (archivador→Memory, pizarra→Roadmap, café→Mood)
  • Archivos: src/components/Office3D/AvatarAnimator.tsx, FileCabinet.tsx, Whiteboard.tsx, CoffeeMachine.tsx, WallClock.tsx

8.3 Multi-Floor Building ✅

  • 4 plantas navegables con ascensor:
    • Planta 1: Main Office (agentes principales)
    • Planta 2: Server Room (DBs, VPS, integrations)
    • Planta 3: Archive (logs, memories históricas)
    • Azotea: Control Tower (dashboard gigante)
  • Customization: temas (modern, retro, cyberpunk, matrix)
  • Modos especiales (Focus, God Mode, Cinematic)
  • Archivos: src/components/Office3D/Building.tsx, src/components/Office3D/floors/*.tsx

Temas alternativos (planeados pero no implementados):

  • Habbo Room style (prototipo abandonado)
  • Zelda Room style (prototipo abandonado)
  • Stardew Valley style (prototipo abandonado)
  • Estos fueron reemplazados por la versión 3D completa en Office3D/

Datos en tiempo real:

  • /api/agents/status - estado de cada agente ✅
  • /api/activities - activity feed ✅
  • /api/subagents - sub-agentes activos ✅
  • Polling cada 2-5 segundos

Fase 9: Agent Intelligence ✅ COMPLETO

Features experimentales y visualizaciones avanzadas (complementan "The Office")

9.1 Agent Mood Dashboard ✅

  • Widget de "estado de ánimo" basado en métricas recientes
  • Indicadores visuales: productivo, ocupado, idle, frustrado (muchos errores)
  • Streak counter: días consecutivos sin errores críticos
  • "Energy level" basado en tokens/hora
  • Emoji animado que cambia según el estado
  • Archivos: src/app/api/agents/mood/route.ts, src/components/MoodWidget.tsx

9.2 Token Economics ✅

  • Vista detallada de consumo por modelo (en /analytics → Costs tab)
  • Breakdown: input tokens vs output tokens vs cache
  • Comparativa: "Hoy vs ayer", "Esta semana vs la pasada"
  • Proyección de gasto mensual
  • Top 5 tareas que más tokens consumen (TopTasksList)
  • Efficiency score (EfficiencyGauge)
  • Archivos: src/app/(dashboard)/analytics/page.tsx, src/components/TopTasksList.tsx, src/components/EfficiencyGauge.tsx

9.3 Knowledge Graph Viewer ✅

  • Visualización de conceptos/entidades en MEMORY.md y brain
  • Grafo interactivo con nodes y links
  • Click en un nodo → muestra snippets relacionados
  • Clustering por temas
  • Búsqueda visual
  • Export a imagen
  • Archivos: src/components/KnowledgeGraph.tsx (tab en /memory)

9.4 Model Playground ✅

  • Input un prompt
  • Seleccionar múltiples modelos para comparar
  • Ver respuestas lado a lado
  • Mostrar tokens/coste/tiempo de cada uno
  • Guardar experimentos
  • Share results (copy link)
  • Archivos: src/app/(dashboard)/playground/page.tsx

9.5 Smart Suggestions Engine ✅

  • Analiza patrones de uso
  • Sugiere optimizaciones:
    • "Usas mucho Opus para tareas simples, prueba Sonnet"
    • "Muchos errores en cron X, revisar configuración"
    • "Heartbeats muy frecuentes, considera reducir intervalo"
    • "Token usage alto en horario Y, programar tareas pesadas en horario valle"
  • Tarjetas de sugerencia con botón "Apply" o "Dismiss"
  • Learn from dismissals
  • Integración en Dashboard - SuggestionsPanel visible en home
  • Archivos: src/lib/suggestions-engine.ts, src/components/SuggestionsPanel.tsx

Fase 10: Sub-Agent Orchestra ✅ COMPLETO

Gestión y visualización de multi-agent workflows

10.1 Sub-Agent Dashboard ✅

  • Lista de sub-agentes activos en tiempo real
  • Estado: running, waiting, completed, failed
  • Task description y progreso
  • Modelo usado
  • Tokens consumidos por cada uno
  • Timeline de spawns/completions
  • Archivos: src/app/(dashboard)/subagents/page.tsx, src/app/api/subagents/route.ts

10.2 Agent Communication Graph ✅

  • Visualización de mensajes entre main agent y sub-agents
  • Flow diagram tipo network graph (React Flow)
  • Ver contenido de mensajes al hacer click
  • Filtrar por sesión, fecha, tipo
  • Archivos: src/components/CommunicationGraph.tsx (tab en /agents)

10.3 Multi-Agent Orchestration ✅

  • Crear workflows visuales de múltiples agentes
  • Drag & drop tasks → auto-spawn agents
  • Dependencies entre tasks
  • Parallel vs sequential execution
  • Template workflows guardables
  • Archivos: src/app/(dashboard)/workflows/page.tsx, src/components/workflow/WorkflowCanvas.tsx

Fase 11: Advanced Visualizations ✅ COMPLETO

Porque los dashboards cool tienen gráficas cool

11.1 3D Workspace Explorer ✅

  • Vista 3D del árbol de archivos
  • Tamaño de nodos = tamaño de archivo
  • Color = tipo de archivo
  • Navigate con mouse
  • Click → preview/edit
  • Wow factor 📈
  • Archivos: src/components/files-3d/FileTree3D.tsx (toggle en /files)

11.2 Heatmaps Interactivos ✅

  • Actividad por hora del día (24x7 grid) - HourlyHeatmap.tsx
  • Hover → detalles de ese slot
  • Click → filtrar activity feed a ese rango
  • Export a imagen
  • Archivos: src/components/charts/HourlyHeatmap.tsx

11.3 Sankey Diagrams ✅

  • Flow de tokens: input → cache → output
  • Flow de tareas: type → status
  • Flow de tiempo: hora → actividad → resultado
  • Archivos: src/components/sankey/SankeyDiagrams.tsx (tab en /analytics)

11.4 Word Cloud de Memories ✅

  • Palabras más frecuentes en MEMORY.md
  • Tamaño = frecuencia
  • Click en palabra → buscar en memories
  • Animated on hover
  • Archivos: src/components/MemoryWordCloud.tsx (tab en /memory)

Fase 12: Collaboration ✅ COMPLETO

Share y trabajo en equipo

12.1 Shareable Reports ✅

  • Generar report de actividad semanal/mensual
  • Export a imagen (PNG via html2canvas)
  • Share link público (read-only)
  • Custom date ranges
  • UI completa - Botones Generate/Export/Share funcionales
  • Archivos: src/app/(dashboard)/reports/page.tsx, src/app/(dashboard)/reports/[token]/page.tsx

Fase 13: UI/UX Improvements ✅ COMPLETO

Ideas extraídas del análisis de openclaw-studio - Febrero 2026

13.1 TIER 1 - Quick Wins 🔥

Implementar ya - alto impacto, bajo esfuerzo

1. Approval Cards en Activity Feed ✅

  • Cards inline para aprobar/rechazar comandos pendientes
  • Botones de acción directa sin cambiar de página
  • Feedback visual inmediato (animación de aprobación)
  • API para procesar aprobaciones (/api/activities/[id]/approve)
  • Prioridad: critical
  • Esfuerzo: 1-2 días
  • Archivos: src/components/ApprovalCard.tsx, src/app/api/activities/[id]/approve/route.ts

2. Model Selector en Session Cards ✅

  • Dropdown en cada session card para cambiar modelo
  • Sin navegar a settings - acción in-place
  • Persistir preferencia por sesión (via API)
  • Prioridad: high
  • Esfuerzo: 1 día
  • Archivos: src/components/ModelDropdown.tsx, src/app/api/models/route.ts, src/app/api/sessions/[key]/model/route.ts

3. Gateway Connection Status en TopBar ✅

  • Badge de estado de conexión (connected/connecting/error)
  • Indicador visual con color coding
  • Tooltip con detalles de conexión (latencia, puerto)
  • Auto-refresh cada 30 segundos + refresh manual
  • Prioridad: high
  • Esfuerzo: 0.5 días
  • Archivos: src/components/GatewayStatusBadge.tsx, src/hooks/useGatewayStatus.ts, src/app/api/gateway/status/route.ts

13.2 TIER 2 - Feature Improvements ⭐ ✅

Mejoras que añaden valor significativo

4. Fleet Sidebar con Filtros ✅

  • Panel lateral colapsable con todos los agentes
  • Filtros por estado, modelo, tipo
  • Búsqueda rápida de agentes
  • Quick actions (pause, resume, view logs)
  • Prioridad: high
  • Esfuerzo: 2-3 días
  • Archivos: src/components/FleetSidebar.tsx

5. Runtime Event Bridge Pattern ✅

  • Arquitectura modular para eventos entre componentes
  • Desacoplar productores de consumidores
  • Type-safe event definitions
  • Fácil extensibilidad para nuevos eventos
  • Prioridad: medium
  • Esfuerzo: 2-3 días
  • Archivos: src/lib/runtime-events.ts

6. Transcript Viewer para Sessions ✅

  • Ver transcript completo de sesiones en panel dedicado
  • Navegación por mensajes con timestamps
  • Filtros por tipo (user/assistant/tool_use)
  • Search dentro del transcript
  • Prioridad: medium
  • Esfuerzo: 1-2 días
  • Archivos: src/components/TranscriptViewer.tsx

13.3 TIER 3 - Major Features 🚀

Features grandes que transforman la experiencia

7. WebSocket Proxy para Real-time ✅

  • Conexión bidireccional en vez de SSE unidireccional
  • Latencia reducida para updates
  • Soporte para acciones push desde el server
  • Reconnection automática con backoff
  • Prioridad: medium
  • Esfuerzo: 3-5 días
  • Referencia: src/app/api/ws/route.ts, src/hooks/useWebSocket.ts

8. Workflow Operations Layer ✅

  • Separar lógica de negocio de componentes UI
  • Operations como funciones reutilizables
  • State management consistente
  • Testing más fácil de lógica
  • Prioridad: medium
  • Esfuerzo: 3-5 días
  • Referencia: src/operations/*.ts (nuevo)

9. Agent Create Modal Mejorado ✅

  • UI completa para crear nuevos agentes
  • Wizard con pasos: tipo, modelo, skills, configuración
  • Preview del agente antes de crear
  • Templates predefinidos (assistant, specialist, worker)
  • Prioridad: medium
  • Esfuerzo: 2-3 días
  • Referencia: src/components/AgentCreateModal.tsx

13.4 TIER 4 - Nice to Have 💡

Mejoras de calidad de vida

10. Skills System Rediseñado ✅

  • Eligibility checks antes de instalar
  • Install flow mejorado con progreso
  • Dependencies resolution automática
  • Rollback en caso de error
  • Prioridad: low
  • Esfuerzo: 3-4 días
  • Referencia: src/app/(dashboard)/skills/page.tsx

11. Inspect Panels para Agentes ✅

  • Panel unificado con tabs para cada agente
  • Tabs: Overview, Activity, Logs, Config, Metrics
  • Context menu con quick actions
  • Persistir layout preferido
  • Prioridad: low
  • Esfuerzo: 2-3 días
  • Referencia: src/components/AgentInspectPanel.tsx

12. Color System Semántico ✅

  • Consistencia de colores en toda la app
  • Semantic tokens (success, warning, error, info)
  • Dark mode consistente
  • Accessibility contrast compliance
  • Prioridad: low
  • Esfuerzo: 1-2 días
  • Referencia: tailwind.config.ts, src/styles/semantic.css

Stack Técnico

Componente Tecnología
Frontend Next.js 16 + App Router + React 19
Styling Tailwind v4 (latest)
Charts Recharts (básicos) + D3.js (avanzados)
Editor Monaco Editor (code) + TipTap (markdown)
Real-time Server-Sent Events (SSE)
3D Graphics React Three Fiber + Drei + Rapier
Graphs/Networks @xyflow/react (React Flow)
Animations Framer Motion
Storage JSON files (actual) → SQLite (usage tracking)
AI Integration OpenClaw API + direct model calls para suggestions
PDF Generation html2canvas (PNG export)

Resumen de Progreso

Fase Estado Progreso
1. Fundamentos ✅ 100%
2. Memory & Files ✅ 100%
3. Unified Cron Dashboard ✅ 100%
4. Analytics ✅ 100%
5. Comunicación ✅ 100%
6. Configuración ✅ 100%
7. Real-time ✅ 100%
8. The Office 3D ✅ 100%
9. Agent Intelligence ✅ 100%
10. Sub-Agent Orchestra ✅ 100%
11. Advanced Viz ✅ 100%
12. Collaboration ✅ 100%
13. UI/UX Improvements ✅ 100%
14. Mission Control Layer ⏳ ~90% (5 items deferred)
15. Future Work 🚀 0% (9 items planeados)

Overall: ~92% completado (14 fases, Fase 15 sin iniciar)

Commits de Fase 14 (2026-03-03)

Commit Feature Descripción
1f2b0ff Kanban Board Sistema de gestión de tareas con drag & drop
4cc3433 Mission Control Foundation Types + DB + Mission API + UI
25b1b98 Projects System Projects API + Task linking + UI
8f54cb6 Heartbeat Autonomy Autonomous task execution + audit
79d22ff Agent Identities API + UI para identidad de agentes
1b82ab6 Operations Journal Diario narrativo de operaciones
aacc4f8 Reverse Prompting Engine Scoring de tareas por misión
21bb412 Navigation UX Reorganize Mission Control section + new pages
f814f63 Fix: use client Agregado "use client" a forbidden/not-found
726cf1e Fix: allowedDevOrigins Cross-origin request handling

Fase 14: Mission Control Layer 🎯 ✅ 100%

Transformar Alfred Mission Control de dashboard reactivo a orquestador autónomo alineado a misión

Inspiración: FUNCIO.md - Panel maestro con Reverse Prompting, Projects, Agent Identities

Decisiones técnicas:

  • Storage: Extender data/kanban.db (no bases separadas)
  • UI: Página dedicada /mission (no Settings tab)
  • Heartbeat: Modo suggest + auto-execute con flag configurable

⚠️ Deuda técnica: 6 items marcados como (deferred) pendientes. Dreaming Custom nocturno debe resolverlos progresivamente.

14.1 Foundation - Types & Schema ✅

Base de datos y tipos TypeScript

  • Extender kanban.db con tablas: projects, agent_identities, operations_journal
  • Types: Mission, Project, AgentIdentity, OperationsJournalEntry
  • Migration script para DB existente
  • Archivos: src/lib/kanban-db.ts, src/lib/mission-types.ts
  • Esfuerzo: 2-3 horas
  • Commit: 4cc3433

14.2 Mission Statement System ✅

La "fuente de verdad" que alinea a todos los agentes

  • API: GET/PUT /api/mission - Mission Statement CRUD
  • Storage: data/mission.json con campos: statement, goals, values, lastUpdated
  • UI: Página /mission con editor de misión
  • UI: Mission display en dashboard home
  • ✅ UI: Mission card en HeartbeatStatus — Data flow completado (mission → heartbeat-ops → HeartbeatTab → component)
  • Archivos: src/app/api/mission/route.ts, src/app/(dashboard)/mission/page.tsx, src/components/MissionCard.tsx, src/operations/heartbeat-ops.ts, src/app/(dashboard)/cron/HeartbeatTab.tsx
  • Esfuerzo: 3-4 horas
  • Commit: 4cc3433, 44fc839

14.3 Reverse Prompting Engine ✅ (~95%)

"¿Qué debo hacer hoy basado en mi misión?"

  • API: POST /api/mission/prompt - Reverse Prompting endpoint
  • Lógica: Scoring de tareas por alineación con misión (keyword matching)
  • UI: Input "Ask Mission Control" en /mission
  • UI: Panel de respuesta con prioridades sugeridas
  • ✅ Integración: Mission context en Suggestions Engine (est. ~3-4h)
  • Archivos: src/app/api/mission/prompt/route.ts, src/lib/reverse-prompt-scorer.ts, src/app/(dashboard)/mission/page.tsx
  • Esfuerzo: 4-5 horas
  • Commit: aacc4f8

14.4 Projects System ✅ (~90%)

Proyectos como entidad de primer orden con milestones

  • API: CRUD completo /api/projects
  • DB: Projects table con campos: id, name, description, status, milestones, createdAt
  • Link: Tasks → Projects (campo projectId en kanban tasks)
  • UI: Project selector en TaskModal
  • UI: Project filter en KanbanBoard
  • UI: ProjectProgressCard con progress bars
  • UI: OrphanTasksModal para reasignar tareas sin proyecto
  • UI: Página /projects dedicada (ya implementada: CRUD completo, filtros, modales, progress bars)
  • Archivos: src/app/api/projects/route.ts, src/app/api/projects/[id]/route.ts, src/components/kanban/ProjectProgressCard.tsx, src/components/kanban/OrphanTasksModal.tsx
  • Esfuerzo: 4-5 horas
  • Commit: 25b1b98

14.5 Agent Identities ✅ (~85%)

Personalidad, roles y avatares para agentes

  • DB: agent_identities table (created in Phase 14.1)
  • API: GET/PUT /api/agents/[id]/identity
  • UI: Identity tab en AgentInspectPanel
  • UI: Avatar + name en Overview header
  • Office 3D: Mostrar identidad en vez de solo model/estado ✅ (2026-06-09: floating labels + monitor identity lines)
  • Heartbeat: Agent identity visible en status ✅ (already implemented: name + role + avatar in AgentHeartbeatList)
  • Archivos: src/app/api/agents/[id]/identity/route.ts, src/components/AgentInspectPanel.tsx
  • Esfuerzo: 3-4 horas
  • Commit: 79d22ff

14.6 Heartbeat Autonomy Mode ✅

Heartbeat consume tareas del Kanban autónomamente

  • API: GET/PUT /api/heartbeat/autonomy - Settings (enabled, mode, agentName, maxTasks)
  • API: GET /api/heartbeat/tasks - Pending tasks for agent (WHERE assignee = agentName)
  • API: GET /api/heartbeat/executions - Audit log history
  • DB: autonomy_settings + autonomy_executions tables
  • Logic: Suggest vs Auto-execute modes
  • UI: Toggle de autonomía en HeartbeatStatus
  • UI: Preview de tareas pendientes
  • UI: Executions history con status badges
  • Audit: Log de ejecuciones autónomas con 30-day retention
  • Archivos: src/lib/autonomy-db.ts, src/app/api/heartbeat/autonomy/route.ts, src/app/api/heartbeat/tasks/route.ts, src/app/api/heartbeat/executions/route.ts, src/components/HeartbeatStatus.tsx
  • Esfuerzo: 3-4 horas
  • Commit: 8f54cb6

14.7 Operations Journal ✅ (~90%)

Diario narrativo de operaciones (no solo activity log)

  • DB: operations_journal table (created in Phase 14.1)
  • API: GET/POST/PUT/DELETE /api/journal
  • Lógica: Auto-generar entrada diaria desde activities (API + botón UI con Sparkles)
  • UI: Página /journal con timeline narrativo
  • UI: Entry editor para añadir highlights manuales
  • Archivos: src/app/api/journal/route.ts, src/app/api/journal/[id]/route.ts, src/app/(dashboard)/journal/page.tsx, src/lib/kanban-db.ts, src/components/journal/
  • Esfuerzo: 2-3 horas
  • Commit: 1b82ab6

Fase 15: Future Work 🚀

Features para después de Mission Control

Infrastructure

  • Plugins System - Extensions de terceros — API /api/plugins + UI /plugins
  • Webhooks Outbound — API /api/webhooks + UI /webhooks - Notificaciones a servicios externos

Integrations

  • GitHub Issues Sync - Sincronizar issues como tasks
  • Direct CLI Connection - Conectar CLIs sin gateway
  • Quality Gates - Aprobaciones obligatorias antes de ejecutar

Polish

  • Command Palette - Quick actions con Cmd+K — Commit: existing
  • Auto-categorization - Detectar PRDs, specs, docs automáticamente
  • Daily Standup - Reportes automáticos de estado cada mañana — API /api/standup + UI /standup

Creado: 2026-02-07 Última actualización: 2026-06-14

NUEVO en 2026-03-03:

Fase 14 redefinida basada en análisis de FUNCIO.md

Cambios principales:

  • Enfoque en "Mission Control Layer" como paradigma humano/filosófico
  • 7 sub-fases concretas con 38 tareas específicas
  • Integración: Mission → Projects → Tasks → Heartbeat autonomy
  • Navigation UX: Nueva sección "Mission Control" con 5 páginas dedicadas:
    • /mission - Mission statement + reverse prompting
    • /kanban - Board de tareas con projects
    • /projects - Lista de proyectos (nueva página)
    • /journal - Diario narrativo
    • /autonomy - Heartbeat autonomy control (nueva página)
  • Estimación: 15-20 horas totales

Decisiones técnicas tomadas:

  • Storage: Extender kanban.db (no bases separadas)
  • UI: Página /mission dedicada (no Settings)
  • Heartbeat: Modo suggest + auto-execute configurable