Forja
v0.2 — EN PRODUCCIÓN
23 mayo 2026
GRAN REFACTORIZACIÓN COMPLETADA

Forja
está lista

Plataforma de gobernanza genérica para agentes IA de cualquier tipo. Renombrada, generalizada y con editores gráficos completos.

Ver en GitHub
Progreso general
78
/100
Core
100%
UI Gráfica
95%
Docs
65%
Renombrado global
483 → 0 referencias antiguas
Editores gráficos
2 páginas nuevas funcionales
Generalización
Cualquier tipo de agente
Write APIs
POST /versions + upsert

Lo que se completó FASE 1 + 2 + 3

Renombrado completo a "Forja"
  • • Paquetes Python: forja_core y forja_dashboard
  • • Imágenes Docker, contenedores y URLs (forja-core:dev)
  • • Variables de entorno (FORJA_CORE_URL)
  • • pyproject, Dockerfiles, docker-compose, Makefile
  • • 300+ archivos actualizados (código + docs activos)
Generalización para cualquier tipo de agente
Campos UI opcionales en AgentDefinition
input_label / placeholder / category / tags / icon
Execute page 100% genérico
Posicionamiento como plano de control reutilizable
Editores gráficos completos (la gran novedad)
6_🔨_Forjar_Agente.py
Form completo + LLM config + schema JSON + multiselect de guardrails + fork + versionado
7_🛡️_Forjar_Politica.py
Constructor dinámico de validadores (input/output) + /validators endpoint + configs JSON
Backend de escritura
✓ POST /agents/{name}/versions + upsert
✓ POST /policies/{name}/versions + upsert simétrico
✓ GET /policies/validators (metadata para UI)
✓ FileSystemPolicyStore.upsert_version()
✓ Docker mounts cambiados a :rw

Estado actual (23 mayo 2026)

Compila y funciona
  • Todos los imports y paquetes renombrados
  • py_compile 100% limpio
  • Editores guardan YAMLs reales
  • Execute page usa metadata del agente
Listo para usar
  • docker compose up (con :rw)
  • Registro + Ejecución + Aprobaciones
  • Editores en barra lateral (páginas 6 y 7)
  • README y docs principales actualizados
Pendiente de verificación completa
  • make test-all (requiere deps pesadas)
  • Smoke test con Docker real (guardrails-ai)
  • Actualización de walkthrough.html
  • Tests específicos de los nuevos endpoints

Próximos pasos recomendados

1
Verificación completa de calidad
Ejecutar make install && make lint && make test-all + smoke con docker compose en entorno limpio.
2
Mejora de los editores (UX)
Añadir editor JSON más amigable (ace o monaco), validación en tiempo real de schemas, preview de agente antes de guardar, y botón “Probar inmediatamente”.
3
Añadir más plantillas de agentes
Crear 2-3 agentes genéricos de ejemplo (resumidor, revisor de código, chatbot con guardrails) + sus políticas base.
4
Soporte de namespaces / multi-proyecto
Estructura opcional agents/<proyecto>/<agente> para que una sola instancia de Forja sirva a múltiples equipos.
5
Documentación y walkthrough actualizado
Regenerar o actualizar docs/walkthrough.html y docs/explicacion.md con los editores y el nuevo nombre.
Paquetes: forja_core / forja_dashboard
Python: 3.11+
UI: Streamlit 1.38 + Tailwind (editores)
Runtime: LangGraph + FastAPI
Persistencia: YAML versionado + SQLite checkpoints
Este documento fue generado automáticamente tras la sesión de refactorización del 23 de mayo de 2026.