Skip to content

v0.5.0 — Fase 1 (Robustez Absoluta) 🚀

Choose a tag to compare

View all tags
@gonzoblasco gonzoblasco released this 30 Jun 18:03
· 40 commits to main since this release
v0.5.0
7b8ef24

Release Notes: v0.5.0 — Fase 1 (Robustez Absoluta) 🚀

Esta versión marca la finalización de la Fase 1 del Roadmap, enfocada íntegramente en hacer el CLI create-stack-next a prueba de balas frente a cualquier condición del entorno local.

✨ Novedades

Inicialización Git Inteligente y Robusta

Antes, el CLI podía fallar si no tenías configurado tu nombre o email en Git globalmente. Ahora:

  • Detectamos si git está instalado en el sistema. Si no lo está, saltamos este paso con un aviso amigable y continuamos la generación del proyecto.
  • Si Git está instalado pero user.name o user.email no están configurados, usamos valores genéricos de fallback (create-stack-next y noreply@create-stack-next) para garantizar que el "initial commit" se cree exitosamente, y te recordamos por consola cómo configurarlo para tus próximos commits.

Manejo Amigable de Directorios Destino

¿Creaste una carpeta vacía y entraste antes de correr el comando? Antes el CLI fallaba porque el directorio ya existía.
Ahora el CLI es más inteligente: acepta directorios existentes siempre y cuando estén vacíos (ignorando archivos inofensivos del sistema como .DS_Store o Thumbs.db). Además, validamos permisos de escritura de antemano para evitar fallos a la mitad de la copia.

Salida de Consola Dinámica

El bloque final de "Próximos pasos" ahora lee qué package manager elegiste (--pm pnpm, yarn, bun, etc.) y te muestra los comandos exactos que debés correr, en lugar de mostrar siempre npm run dev.

🤖 Para los Agentes IA (AI-Native)

Nuevo: AGENT_TASKS.md

Como pioneros en el Desarrollo Dirigido por IA, agregamos un archivo maestro en la raíz del proyecto llamado AGENT_TASKS.md. Funciona como una guía de proceso viva y granular ("sprint plan") para cualquier agente (OpenClaw, Cursor, Claude) que trabaje en las entrañas del CLI. Estandariza el flujo de trabajo (contexto → ADR → implementación → tests → changelog) y documenta las decisiones de diseño aprobadas.

ADRs Documentados

Hemos empezado a registrar todas las Decisiones Arquitectónicas (ADRs) en docs/decisions.md (ej. D002 a D004) para mantener la persistencia de memoria entre diferentes sesiones de agentes IA.

🛠️ Bajo el capó: Tests y Refactorización

Reescribimos la base para ser infinitamente más testeable y segura:

  • Test Suite Multiplicada: Pasamos de 13 a 44 tests unitarios (un aumento de cobertura de 3.4x).
  • Verificación Exhaustiva: Ahora nuestros tests verifican que el 100% de los archivos del template se copien de forma íntegra, incluyendo dotfiles (.openclaw, .github, etc.) y estructuras anidadas.
  • Refactor de CLI: Desacoplamos las validaciones internas (como validateProjectName) permitiendo testeos directos en lugar de depender de simulaciones. Todo el código pasó por un formateo completo usando Biome.

Siguiente parada: Fase 2 (Flexibilidad Interna y DX), donde traeremos soporte avanzado para Monorepos (Workspaces) y un pulido visual extremo para la terminal. ¡Sigamos construyendo! 🛠️

Assets 2
Loading