insitu-js 1.0.2 → 1.1.0

package/CHANGELOG.md

@@ -7,7 +7,7 @@ El versionado sigue SemVer (MAJOR.MINOR.PATCH).
 
 ## [1.0.2] - 2026-02-16
 
-### Mejoras en Presentación Visual y Corrección de Dependencias Circulares - Insitu Framework
+### Mejoras en Presentación Visual, Corrección de Dependencias Circulares y Hooks de Seguimiento - Insitu Framework
 
 #### Archivo Nuevo: `lib/utils/colorHelper.js`
 - Creación del módulo `ColorHelper` con códigos ANSI para diferentes colores
@@ -25,11 +25,38 @@ El versionado sigue SemVer (MAJOR.MINOR.PATCH).
 - Creación de una instancia local de `HookSystem` para resolver el problema
 - Solución del warning "Accessing non-existent property 'hooks' of module exports inside circular dependency"
 
+#### Nueva Funcionalidad: Hooks de Seguimiento de Solicitudes
+- Implementación de mensaje en color cyan cuando se dispara el hook `request_received`
+- Adición de mensaje en color magenta cuando se dispara el hook `route_not_found` (equivalente a error 404)
+- Manejo seguro de casos donde el objeto `req` podría ser indefinido en el hook `route_not_found`
+
+#### Nueva Funcionalidad: Hooks before_route_handler y after_route_handler
+- Implementación de los hooks `before_route_handler` y `after_route_handler` para solicitudes que no sean OPTIONS
+- Soporte para filtros y acciones en ambos hooks
+- Posibilidad de modificar objetos `req` y `res` durante la ejecución de los filtros
+- Aplicación exclusiva a solicitudes que no sean del tipo OPTIONS
+
+#### Nueva Funcionalidad: Hooks before_static_file_load y after_static_file_load
+- Implementación de los hooks `before_static_file_load` y `after_static_file_load` para manipulación de archivos estáticos
+- Soporte para filtros y acciones en ambos hooks
+- Posibilidad de modificar objetos `req`, `res`, `filePath` y `staticConfig` durante la ejecución de los filtros
+- Capacidad de modificar el contenido de archivos estáticos a través del parámetro `fileContent` en el hook `after_static_file_load`
+- Aplicación a ambos tipos de carga de archivos estáticos (archivos normales e índices)
+
+#### Nueva Funcionalidad: Hooks before_controller_load y after_controller_load
+- Implementación de los hooks `before_controller_load` y `after_controller_load` para manipulación de carga de controladores
+- Soporte para filtros y acciones en ambos hooks
+- Posibilidad de modificar la ruta del controlador en `before_controller_load`
+- Posibilidad de modificar el módulo del controlador en `after_controller_load`
+- Aplicación tanto en el cargador de controladores como en el sistema de rutas
+- Mantenimiento de compatibilidad con los hooks antiguos `pre_controller_load` y `post_controller_load` con notificación de deprecación
+
 #### Beneficios Obtenidos
 - Mejora en la presentación visual de la aplicación con colores
 - Eliminación de advertencias técnicas que afectaban la experiencia del usuario
 - Mayor claridad visual en la salida de la consola
 - Resolución de problemas técnicos de arquitectura de módulos
+- Mejor seguimiento y monitoreo de solicitudes entrantes y errores 404
 
 ---
 

package/CHANGELOG_1.1.0.md

@@ -0,0 +1,198 @@
+# Changelog
+
+Todos los cambios relevantes de este framework se documentan en este archivo.
+El versionado sigue SemVer (MAJOR.MINOR.PATCH).
+
+---
+
+## [1.1.0] - 2026-02-16
+
+### Nueva Funcionalidad Principal: Sistema Avanzado de Hooks y Filtros - Insitu Framework
+
+#### Hooks y Filtros para Manipulación de Rutas
+- Implementación de los hooks `before_route_handler` y `after_route_handler` para manipulación de solicitudes
+- Soporte para filtros y acciones en ambos hooks
+- Posibilidad de modificar objetos `req` y `res` durante la ejecución de los filtros
+- Aplicación exclusiva a solicitudes que no sean del tipo OPTIONS
+
+#### Hooks y Filtros para Manipulación de Archivos Estáticos
+- Implementación de los hooks `before_static_file_load` y `after_static_file_load` para manipulación de archivos estáticos
+- Soporte para filtros y acciones en ambos hooks
+- Posibilidad de modificar objetos `req`, `res`, `filePath` y `staticConfig` durante la ejecución de los filtros
+- Capacidad de modificar el contenido de archivos estáticos a través del parámetro `fileContent` en el hook `after_static_file_load`
+- Aplicación a ambos tipos de carga de archivos estáticos (archivos normales e índices)
+
+#### Hooks y Filtros para Manipulación de Controladores
+- Implementación de los hooks `before_controller_load` y `after_controller_load` para manipulación de carga de controladores
+- Soporte para filtros y acciones en ambos hooks
+- Posibilidad de modificar la ruta del controlador en `before_controller_load`
+- Posibilidad de modificar el módulo del controlador en `after_controller_load`
+- Aplicación tanto en el cargador de controladores como en el sistema de rutas
+- Mantenimiento de compatibilidad con los hooks antiguos `pre_controller_load` y `post_controller_load` con notificación de deprecación
+
+#### Sistema de Filtros Mejorado
+- Soporte para filtros que permiten modificar parámetros en múltiples puntos del framework
+- Sistema de prioridades configurable para el orden de ejecución
+- Integración completa con el sistema de hooks existente
+- Soporte para operaciones asíncronas en filtros
+
+#### Mejoras en el Sistema de Hooks
+- Soporte para operaciones asíncronas en hooks
+- Resolución de promesas en la cadena de hooks y filtros
+- Manejo adecuado de errores en operaciones asíncronas
+- Mantenimiento del orden de ejecución incluso con operaciones asíncronas
+
+#### Nueva Funcionalidad: Filtro para Personalización de Respuesta 404
+- Implementación del filtro `customize_404_response` para personalizar la respuesta de error 404
+- Soporte para modificar completamente la respuesta 404 o evitar la respuesta estándar
+- Parámetros del filtro: `({ shouldSendDefaultResponse, pathname, req, res }, pathname, req, res)`
+- Posibilidad de enviar respuestas personalizadas en lugar del mensaje estándar de 404
+
+#### Beneficios Obtenidos
+- Mayor flexibilidad para extender el comportamiento del framework
+- Control preciso sobre el flujo de ejecución en múltiples puntos
+- Soporte para operaciones asíncronas en hooks y filtros
+- Compatibilidad hacia atrás con hooks existentes
+- Documentación completa de todos los hooks y filtros disponibles
+- Mayor capacidad de personalización sin modificar el núcleo del framework
+- Posibilidad de personalizar completamente la experiencia de usuario ante errores 404
+
+---
+
+## [1.0.2] - 2026-02-16
+
+### Mejoras en Presentación Visual, Corrección de Dependencias Circulares y Hooks de Seguimiento - Insitu Framework
+
+#### Archivo Nuevo: `lib/utils/colorHelper.js`
+- Creación del módulo `ColorHelper` con códigos ANSI para diferentes colores
+- Implementación de métodos para aplicar colores a texto en consola
+- Adición de funciones para combinar múltiples colores en un solo texto
+
+#### Archivo Modificado: `index.js`
+- Integración del `ColorHelper` para colorear el logo ASCII art
+- Aplicación de color amarillo al texto de la versión
+- Mantenimiento del formato original del mensaje de bienvenida
+
+#### Corrección de Advertencia de Dependencia Circular
+- Modificación de `lib/queue/GlobalQueueStorage.js` para evitar dependencia circular
+- Eliminación de la referencia directa a `framework.hooks` desde `index.js`
+- Creación de una instancia local de `HookSystem` para resolver el problema
+- Solución del warning "Accessing non-existent property 'hooks' of module exports inside circular dependency"
+
+#### Nueva Funcionalidad: Hooks de Seguimiento de Solicitudes
+- Implementación de mensaje en color cyan cuando se dispara el hook `request_received`
+- Adición de mensaje en color magenta cuando se dispara el hook `route_not_found` (equivalente a error 404)
+- Manejo seguro de casos donde el objeto `req` podría ser indefinido en el hook `route_not_found`
+
+#### Beneficios Obtenidos
+- Mejora en la presentación visual de la aplicación con colores
+- Eliminación de advertencias técnicas que afectaban la experiencia del usuario
+- Mayor claridad visual en la salida de la consola
+- Resolución de problemas técnicos de arquitectura de módulos
+- Mejor seguimiento y monitoreo de solicitudes entrantes y errores 404
+
+---
+
+## [1.0.1] - 2026-02-13
+
+### Refactorización DRY y Mejoras en el WAF - Insitu Framework
+
+#### Archivo Nuevo: `lib/utils/executeMiddleware.js`
+- Creación del módulo centralizado `executeMiddleware` para la ejecución de middlewares
+- Implementación del método reutilizable `executeMiddleware(middleware, req, res, nextFn = null)` con manejo de promesas
+
+#### Archivos Modificados:
+- `lib/core/server.js`
+- `lib/loader/routeLoader.js`
+- `lib/core/router.js`
+- `lib/security/globalWAFStats.js`
+- `lib/security/firewall.js`
+- `lib/admin/modules/WAFModule.js`
+
+#### Implementación de Método Centralizado executeMiddleware
+- Eliminación de múltiples instancias de código repetido para ejecución de middlewares
+- Reemplazo de lógica local con importación y uso del módulo centralizado
+- Actualización del método `use` en el router para usar el método centralizado
+- Implementación de definición dinámica de métodos HTTP en el router
+
+#### Implementación de Funcionalidades de Log y Monitor en el WAF
+- Añadida propiedad `monitoredRequests` al objeto global de estadísticas del WAF
+- Implementación completa de la acción "monitor" en el middleware de firewall
+- Almacenamiento de solicitudes monitoreadas en el mapa global `monitoredRequests`
+- Añadido comando `waf-monitored` al módulo de administración WAF
+- Implementación del método `showMonitoredRequests()` para mostrar solicitudes monitoreadas
+- Actualización del comando `waf-logs` para mostrar solicitudes registradas con acción "log"
+
+#### Aplicación del Principio DRY (Don't Repeat Yourself)
+- Creación del método `createAuthenticatedHandler()` para manejar lógica de autenticación
+- Implementación de métodos para respuestas HTTP comunes (`sendJsonResponse()`, `sendForbiddenResponse()`, `sendNotFoundResponse()`, `sendRequestTooLargeResponse()`)
+- Uso del método reutilizable `handleError()` en lugar de llamar directamente a ErrorHandler.handle()
+
+#### Mejoras en el Manejo de Errores y Configuración
+- Centralización del manejo de errores con el método `handleError()`
+- Creación del método `isJsonRequest()` para verificar tipo de contenido
+- Implementación del método `setStaticFileHeaders()` para configurar headers de archivos estáticos
+
+#### Optimizaciones de Estadísticas y Hooks
+- Método `setupResponseCapture()` para capturar datos de respuesta para estadísticas
+- Método `updateRequestProcessingStats()` para actualizar estadísticas de procesamiento
+- Método `registerRouteAndEndpointStats()` para registrar estadísticas de acceso
+- Métodos para manejar eventos de hooks de solicitud (`handleRouteMatched()`, `handleMiddlewareResponseFinished()`)
+
+#### Mejoras en Verificaciones y Validaciones
+- Método `isMiddlewareFunction()` para verificar si un middleware es una función
+- Método `isAsyncFunction()` para verificar si una función es asíncrona
+
+#### Beneficios Obtenidos
+- Eliminación significativa de código duplicado
+- Mejor mantenibilidad: cambios en lógica común solo se realizan en un lugar
+- Mayor consistencia en el manejo de operaciones repetitivas
+- Funcionalidad completa de las acciones "log" y "monitor" en el WAF
+- Almacenamiento eficiente de solicitudes registradas y monitoreadas
+- Visibilidad mejorada a través de comandos específicos (`waf-logs`, `waf-monitored`)
+- Reducción de posibles errores por inconsistencias
+- Claridad mejorada del código
+
+---
+
+## [1.0.0] - 2026-02-12
+
+### Consolidated Release - Insitu Framework
+
+#### Framework Renaming
+- Cambio de nombre del framework de "JERK Framework" a "Insitu Framework"
+- Actualización de todos los nombres de paquetes, referencias y documentación
+- Renombrado de archivos y directorios relacionados con el antiguo nombre
+
+#### Version Standardization
+- Consolidación de todas las versiones anteriores a la versión única 1.0.0
+- Actualización de todos los números de versión en comentarios, documentación y código
+- Unificación de la numeración de versiones en todos los componentes
+
+#### Architecture & Core Features
+- Sistema de enrutamiento avanzado con soporte para rutas estáticas y parametrizadas
+- Arquitectura modular con componentes desacoplados
+- Sistema de hooks y filters para extensibilidad
+- Motor de vistas con soporte para includes, variables y filtros
+- Sistema de modelos con soporte para diferentes adaptadores (memoria, MariaDB, SQLite)
+
+#### Security & Performance
+- Firewall WAF integrado con reglas configurables
+- Sistema de autenticación con múltiples estrategias (JWT, API Keys, Sesiones)
+- Sistema de sesiones con cookies seguras
+- Optimizaciones de rendimiento con índices y caché
+- Protección contra ataques XSS y SQL Injection
+
+#### Administration & Monitoring
+- Extensión de administración con servidor TCP local
+- Módulos de administración para gestión de rutas, vistas y estadísticas
+- Sistema de colas con soporte para múltiples colas concurrentes
+- Monitorización en tiempo real de métricas del servidor
+
+#### Development Experience
+- CLI de administración con autocompletado
+- Generador interactivo de controladores
+- Carga de rutas desde archivos JSON o programáticamente
+- Documentación completa y ejemplos de uso
+
+---

package/README.md

@@ -1,101 +1,108 @@
 # 🚀 INSITU - JS Framework
 
-Un framework backend **rápido, modular y extensible**, diseñado para construir APIs y servicios HTTP de alto rendimiento con enfoque en **rendimiento real, control total y cero dependencias innecesarias**.
+A **fast, modular and extensible** backend framework designed to build high-performance HTTP APIs and services with focus on **real performance, full control and zero unnecessary dependencies**.
 
-Pensado para desarrolladores que prefieren **infraestructura directa, predecible y eficiente**, no capas de abstracción pesadas.
+Built for developers who prefer **direct, predictable and efficient infrastructure**, not heavy abstraction layers.
 
 ---
 
-## ⚡ Principios
+## ⚡ Principles
 
-- Performance first — rutas indexadas, cachés y estructuras O(1)
-- Arquitectura modular — hooks, filtros y módulos desacoplados
-- Observabilidad integrada — administración en tiempo real
-- Seguridad por defecto
-- Sin magia oculta — comportamiento explícito y depurable
+- Performance first — indexed routes, caches and O(1) structures
+- Modular architecture — hooks, filters and decoupled modules
+- Built-in observability — real-time administration
+- Security by default
+- No hidden magic — explicit and debuggable behavior
 
 ---
 
-## ✨ Características principales
-
-### 🧭 Enrutamiento de alto rendimiento
-- Índices por segmentos y prefijos
-- Buckets por aridad
-- Rutas estáticas y dinámicas (regex)
-- Cache de rutas con estadísticas de hits/misses
-
-### 🧩 Sistema modular
-- Hooks y filtros
-- Plugins externos sin modificar el core
-- Carga dinámica de módulos
-
-### 🛠 Consola de administración integrada
-Servidor TCP local para inspección en tiempo real:
-
-- rutas activas
-- estadísticas del servidor
-- estado del sistema
-- colas
-- cachés
-- generación de controladores
-
-### 📬 Sistema de colas
-- Múltiples colas concurrentes
-- Prioridades
-- Reintentos automáticos
+## ✨ Key Features
+
+### 🧭 High-performance Routing
+- Segment and prefix indexing
+- Arity buckets
+- Static and dynamic routes (regex)
+- Route caching with hit/miss statistics
+
+### 🧩 Modular System
+- Hooks and filters
+  - Hook system with support for actions and filters
+  - Filters that allow modifying `req`, `res`, routes and file content
+  - Configurable priorities for execution order
+- External plugins without modifying the core
+- Dynamic module loading
+- Advanced hooks for route and static file handling
+  - `before_route_handler` and `after_route_handler` for request manipulation
+  - `before_static_file_load` and `after_static_file_load` for static file manipulation
+  - Support for filters that allow modifying `req`, `res` and file content
+
+### 🛠 Built-in Administration Console
+Local TCP server for real-time inspection:
+
+- active routes
+- server statistics
+- system status
+- queues
+- caches
+- controller generation
+
+### 📬 Queue System
+- Multiple concurrent queues
+- Priorities
+- Automatic retries
 - Fallbacks
-- Pausa / reanudación
-- Limpieza y reintentos manuales
-
-### 📊 Observabilidad
-- Métricas de requests/responses
-- Endpoints más utilizados
-- Estadísticas de caché de vistas
-- Estado de recursos del sistema
-- Monitorización en tiempo real
-
-### 🔐 Seguridad
-- Autenticación JWT
-- Roles y capacidades
-- Middleware de seguridad
-- WAF básico
-- Cookies con flags configurables (`Secure`, `SameSite`, etc.)
-- Protección XSS / SQL Injection
-
-### 🗄 Base de datos
-- Sistema de modelos
-- QueryBuilder integrado
-- Soporte MariaDB y SQLite
-- Migraciones
+- Pause / resume
+- Manual cleanup and retries
+
+### 📊 Observability
+- Request/response metrics
+- Most used endpoints
+- View cache statistics
+- System resource status
+- Real-time monitoring
+
+### 🔐 Security
+- JWT authentication
+- Roles and capabilities
+- Security middleware
+- Basic WAF
+- Configurable cookie flags (`Secure`, `SameSite`, etc.)
+- XSS / SQL Injection protection
+
+### 🗄 Database
+- Model system
+- Integrated QueryBuilder
+- MariaDB and SQLite support
+- Migrations
 
 ### 🎨 Developer Experience
-- Generador interactivo de controladores
-- Gestor de rutas
-- CLI coloreada
-- Configuración mínima
+- Interactive controller generator
+- Route manager
+- Colored CLI
+- Minimal configuration
 
 ---
 
-## 🧠 Uso
+## 🧠 Usage
 
-El framework **no impone comandos mágicos ni wrappers propietarios**.
+The framework **does not impose magic commands or proprietary wrappers**.
 
-Se integra directamente en tu binario/servidor, y la administración se realiza a través de:
+It integrates directly into your binary/server, and administration is performed through:
 
-- consola TCP local de administración
-- módulos CLI
-- hooks y extensiones
+- local TCP administration console
+- CLI modules
+- hooks and extensions
 
-Consulta la documentación del proyecto para ejemplos específicos de inicialización según tu aplicación.
+Check the project documentation for specific initialization examples based on your application.
 
 ---
 
-## 🧱 Arquitectura
+## 🧱 Architecture
 
 ```
 Request
    ↓
-Router (indexado)
+Router (indexed)
    ↓
 Middleware / Hooks
    ↓
@@ -104,52 +111,52 @@ Controller
 View / JSON / Stream
 ```
 
-Componentes desacoplados → extensibles → reemplazables.
+Decoupled components → extensible → replaceable.
 
 ---
 
-## 🔌 Extensibilidad
+## 🔌 Extensibility
 
-Puedes extender sin modificar el core:
+You can extend without modifying the core:
 
-- módulos de administración
-- hooks personalizados
-- filtros de seguridad
+- administration modules
+- custom hooks
+- security filters
 - middlewares
-- plugins externos
+- external plugins
 
 ---
 
-## 📈 Rendimiento
+## 📈 Performance
 
-Optimizado para:
+Optimized for:
 
-- menos asignaciones
-- menos normalización de rutas
-- menos búsquedas lineales
-- más indexación y caché
+- fewer allocations
+- less route normalization
+- fewer linear searches
+- more indexing and caching
 
-Resultado: **menor CPU, menor latencia y mayor throughput**.
+Result: **lower CPU, lower latency and higher throughput**.
 
 ---
 
-## 🗂 Versionado
+## 🗂 Versioning
 
-Seguimos **Semantic Versioning (SemVer)**.
+We follow **Semantic Versioning (SemVer)**.
 
-Consulta cambios detallados en:
+Check detailed changes at:
 👉 `CHANGELOG.md`
 
 ---
 
-## 🤝 Filosofía
+## 🤝 Philosophy
 
-> Menos framework. Más control. Más rendimiento.
+> Less framework. More control. More performance.
 
-Diseñado para equipos que prefieren entender el sistema completo en lugar de depender de abstracciones innecesarias.
+Designed for teams that prefer to understand the complete system rather than depend on unnecessary abstractions.
 
 ---
 
-## 📄 Licencia
+## 📄 License
 
-APACHE 2.0
+APACHE 2.0

package/README_es.md

@@ -0,0 +1,162 @@
+# 🚀 INSITU - JS Framework
+
+Un framework backend **rápido, modular y extensible**, diseñado para construir APIs y servicios HTTP de alto rendimiento con enfoque en **rendimiento real, control total y cero dependencias innecesarias**.
+
+Pensado para desarrolladores que prefieren **infraestructura directa, predecible y eficiente**, no capas de abstracción pesadas.
+
+---
+
+## ⚡ Principios
+
+- Performance first — rutas indexadas, cachés y estructuras O(1)
+- Arquitectura modular — hooks, filtros y módulos desacoplados
+- Observabilidad integrada — administración en tiempo real
+- Seguridad por defecto
+- Sin magia oculta — comportamiento explícito y depurable
+
+---
+
+## ✨ Características principales
+
+### 🧭 Enrutamiento de alto rendimiento
+- Índices por segmentos y prefijos
+- Buckets por aridad
+- Rutas estáticas y dinámicas (regex)
+- Cache de rutas con estadísticas de hits/misses
+
+### 🧩 Sistema modular
+- Hooks y filtros
+  - Sistema de hooks con soporte para acciones y filtros
+  - Filtros que permiten modificar objetos `req`, `res`, rutas y contenido de archivos
+  - Prioridades configurables para el orden de ejecución
+- Plugins externos sin modificar el core
+- Carga dinámica de módulos
+- Hooks avanzados para manejo de rutas y archivos estáticos
+  - `before_route_handler` y `after_route_handler` para manipulación de solicitudes
+  - `before_static_file_load` y `after_static_file_load` para manipulación de archivos estáticos
+  - Soporte para filtros que permiten modificar objetos `req`, `res` y contenido de archivos
+
+### 🛠 Consola de administración integrada
+Servidor TCP local para inspección en tiempo real:
+
+- rutas activas
+- estadísticas del servidor
+- estado del sistema
+- colas
+- cachés
+- generación de controladores
+
+### 📬 Sistema de colas
+- Múltiples colas concurrentes
+- Prioridades
+- Reintentos automáticos
+- Fallbacks
+- Pausa / reanudación
+- Limpieza y reintentos manuales
+
+### 📊 Observabilidad
+- Métricas de requests/responses
+- Endpoints más utilizados
+- Estadísticas de caché de vistas
+- Estado de recursos del sistema
+- Monitorización en tiempo real
+
+### 🔐 Seguridad
+- Autenticación JWT
+- Roles y capacidades
+- Middleware de seguridad
+- WAF básico
+- Cookies con flags configurables (`Secure`, `SameSite`, etc.)
+- Protección XSS / SQL Injection
+
+### 🗄 Base de datos
+- Sistema de modelos
+- QueryBuilder integrado
+- Soporte MariaDB y SQLite
+- Migraciones
+
+### 🎨 Developer Experience
+- Generador interactivo de controladores
+- Gestor de rutas
+- CLI coloreada
+- Configuración mínima
+
+---
+
+## 🧠 Uso
+
+El framework **no impone comandos mágicos ni wrappers propietarios**.
+
+Se integra directamente en tu binario/servidor, y la administración se realiza a través de:
+
+- consola TCP local de administración
+- módulos CLI
+- hooks y extensiones
+
+Consulta la documentación del proyecto para ejemplos específicos de inicialización según tu aplicación.
+
+---
+
+## 🧱 Arquitectura
+
+```
+Request
+   ↓
+Router (indexado)
+   ↓
+Middleware / Hooks
+   ↓
+Controller
+   ↓
+View / JSON / Stream
+```
+
+Componentes desacoplados → extensibles → reemplazables.
+
+---
+
+## 🔌 Extensibilidad
+
+Puedes extender sin modificar el core:
+
+- módulos de administración
+- hooks personalizados
+- filtros de seguridad
+- middlewares
+- plugins externos
+
+---
+
+## 📈 Rendimiento
+
+Optimizado para:
+
+- menos asignaciones
+- menos normalización de rutas
+- menos búsquedas lineales
+- más indexación y caché
+
+Resultado: **menor CPU, menor latencia y mayor throughput**.
+
+---
+
+## 🗂 Versionado
+
+Seguimos **Semantic Versioning (SemVer)**.
+
+Consulta cambios detallados en:
+👉 `CHANGELOG.md`
+
+---
+
+## 🤝 Filosofía
+
+> Menos framework. Más control. Más rendimiento.
+
+Diseñado para equipos que prefieren entender el sistema completo en lugar de depender de abstracciones innecesarias.
+
+---
+
+## 📄 Licencia
+
+APACHE 2.0