@qubiit/lmagent 2.7.0 → 3.0.0

package/{config → .agents/config}/models.yaml

@@ -1,7 +1,7 @@
 # LMAgent LLM Models Configuration
 # Configuración de proveedores de modelos de lenguaje
 
-version: "1.0"
+version: "3.0.0"
 
 # Configuración global
 settings:

package/{config → .agents/config}/settings.yaml

@@ -1,7 +1,7 @@
 # LMAgent Global Settings
 # Configuración global personalizable del framework
 
-version: "2.3.0"
+version: "3.0.0"
 
 # ============================================
 # PERSONALIZACIÓN DEL FRAMEWORK

package/{docs → .agents/docs}/getting-started.md

@@ -27,7 +27,7 @@ pip install -e .
 3. Verifica que funcione:
 ```bash
 lmagent --version
-# Debería mostrar: LMAgent v2.0.0
+# Debería mostrar: LMAgent v3.0.0
 ```
 
 ### Opción A: Proyecto Nuevo (Desde Cero)

package/{docs → .agents/docs}/how-to-start.md

@@ -239,4 +239,4 @@ Luego crea un PROJECT_KICKOFF.md describiendo lo que quieres agregar.
 
 ---
 
-*LMAgent v3.0 (SPEC+LM) - Build More, Automate Dreams* 🚀
+*LMAgent v3.0.0 (SPEC+LM) - Build More, Automate Dreams* 🚀

package/{rules/_bootstrap.md → .agents/rules/00-master.md}

@@ -1,6 +1,6 @@
 # 🚀 LMAgent Bootstrap — Instrucciones Iniciales
 
-> **Tipo**: `rule` | **Versión**: 2.7.0 | **Prioridad**: MÁXIMA
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Prioridad**: MÁXIMA
 > Esta regla se aplica **SIEMPRE** como primer paso antes de cualquier tarea.
 
 ---
@@ -15,10 +15,10 @@
 
 ## 🧠 Framework
 
-Estás trabajando con **LMAgent v2.7.0**. Antes de implementar cualquier cambio:
+Estás trabajando con **LMAgent v3.0.0**. Antes de implementar cualquier cambio:
 
 1. **Lee `AGENTS.md`** — Catálogo completo de skills, rules y workflows
-2. **Clasifica la tarea** — Nivel 0-4 según complejidad (ver `rules/workflow.md`)
+2. **Clasifica la tarea** — Nivel 0-4 según complejidad (ver `.agents/rules/01-workflow.md`)
 3. **Activa el skill apropiado** — Según la tabla de abajo
 
 ---
@@ -107,18 +107,19 @@ Activa el skill apropiado según la tarea. Cada skill tiene `SKILL.md` con instr
 
 ---
 
-## ⚠️ Reglas Críticas
-
-1. 📖 **Siempre leer AGENTS.md primero**
-2. 🧠 **Activar el skill apropiado** para la tarea
-3. 🎯 **Clasificar correctamente el nivel** (0-4)
-4. 📝 **Planear antes de implementar** (Level 2+)
-5. ✅ **Tests para todo código nuevo**
-6. 📐 **Seguir patrones existentes** del proyecto
-7. 🔄 **Commits pequeños y descriptivos**
-8. 📚 **Documentar cambios significativos** (ver `rules/documentation.md`)
-9. 🔒 **Nunca hardcodear secretos** — usar variables de entorno
-10. ❓ **Si hay duda, preguntar**
+### Estructura de Reglas (Orden de Lectura)
+
+1. **[00-master.md](.agents/rules/00-master.md)**: Este índice.
+2. **[01-workflow.md](.agents/rules/01-workflow.md)**: Ciclo de vida del desarrollo.
+3. **[02-tech-stack.md](.agents/rules/02-tech-stack.md)**: Tecnologías y herramientas.
+4. **[03-code-style.md](.agents/rules/03-code-style.md)**: Convenciones de código.
+5. **[04-security.md](.agents/rules/04-security.md)**: Seguridad y secretos.
+6. **[05-testing.md](.agents/rules/05-testing.md)**: Estrategias de prueba.
+7. **[06-api-design.md](.agents/rules/06-api-design.md)**: Estándares REST API.
+8. **[07-documentation.md](.agents/rules/07-documentation.md)**: Guías de documentación.
+9. **[08-agents-ai.md](.agents/rules/08-agents-ai.md)**: Construcción de Agentes.
+10. **[09-automations.md](.agents/rules/09-automations.md)**: Integraciones n8n.
+11. **[10-git-flow.md](.agents/rules/10-git-flow.md)**: Gestión de versiones y commits.
 
 ---
 

package/{rules/workflow.md → .agents/rules/01-workflow.md}

@@ -1,17 +1,17 @@
 # Flujo de Trabajo - LMAgent
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 
 | Paso | Acción |
 |------|--------|
-| 1. **Entender** | Leer AGENTS.md + reglas aplicables |
+| 1. **Entender** | Leer [00-master.md](.agents/rules/00-master.md) + reglas aplicables |
 | 2. **Clasificar** | Determinar Level (0-4) + skill(s) |
 | 3. **Planear** | (Level 2+) Crear `implementation_plan.md` + pedir aprobación |
 | 4. **Implementar** | Modelos → Repos → Services → Routers → Tests |
 | 5. **Validar** | `pytest` + `ruff check` + `ruff format` |
-| 6. **Documentar** | Actualizar docs si hay cambios de uso |
+| 6. **Documentar** | Actualizar docs ([07-documentation.md](.agents/rules/07-documentation.md)) |
 
 ### Escalado Automático
 - Auth/Security → Mínimo Level 2
@@ -244,26 +244,9 @@ Tiempo estimado: [T]
 6. Documentación
 ```
 
-### Commits
+### Gestión de Versiones
 
-Formato: `type(scope): descripción`
-
-Tipos:
-- `feat`: Nueva funcionalidad
-- `fix`: Corrección de bug
-- `refactor`: Refactorización
-- `docs`: Documentación
-- `test`: Tests
-- `chore`: Mantenimiento
-
-Ejemplos:
-```
-feat(users): add email verification endpoint
-fix(auth): handle expired tokens correctly
-refactor(services): extract validation logic
-docs(api): update user endpoints documentation
-test(users): add tests for email verification
-```
+> **Ver [10-git-flow.md](.agents/rules/10-git-flow.md) para reglas detalladas de commits y ramas.**
 
 ---
 

package/{rules/stack.md → .agents/rules/02-tech-stack.md}

@@ -1,6 +1,6 @@
 # Stack Tecnológico - LMAgent
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 

package/{rules/code-style.md → .agents/rules/03-code-style.md}

@@ -1,6 +1,6 @@
 # Guía de Estilo de Código - LMAgent
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 
@@ -562,6 +562,17 @@ counter += 1  # Increment counter
 - [ ] Docstrings en funciones públicas
 - [ ] Imports ordenados (stdlib → 3rd party → local)
 
+### Prohibidas ❌
+- [ ] Credenciales en código
+- [ ] `print()` en lugar de logging
+- [ ] `import *`
+- [ ] Lógica de negocio en routers
+- [ ] SQL sin parametrizar
+- [ ] Commits sin tests
+- [ ] PRs gigantes sin dividir
+
+> **Nota**: Para convenciones de Commits y Git, ver **[10-git-flow.md](.agents/rules/10-git-flow.md)**.
+
 ### TypeScript
 - [ ] `eslint .` pasa sin errores
 - [ ] `prettier --check .` pasa

package/{rules/security.md → .agents/rules/04-security.md}

@@ -1,6 +1,6 @@
 # LMAgent Security Rules
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 
@@ -296,13 +296,15 @@ logger.info(f"Card number: {card_number}")  # PII
 
 ---
 
-## ✅ Checklist de Validación (Security Review)
-
-### Código
-- [ ] Sin credenciales/secrets hardcodeados
-- [ ] Inputs validados con Pydantic/Zod
-- [ ] Queries SQL parametrizadas (no f-strings)
-- [ ] Outputs sanitizados (no XSS)
+## ✅ Checklist de Seguridad (Antes de Deploy)
+- [ ] **Secretos**: Ningún secreto en código/git (`gitleaks detect`)
+- [ ] **Auth**: Endpoints protegidos por default (deny-all)
+- [ ] **Inputs**: Pydantic models para TO-DO input
+- [ ] **Headers**: HTTPS + HSTS + CSP habilitados
+- [ ] **SQL**: Cero f-strings en queries
+- [ ] **Deps**: `npm audit` / `pip-audit` limpios
+- [ ] **Logs**: No PII ni clues en logs
+- [ ] **Rate Limit**: Configurado en endpoints públicos (no XSS)
 
 ### Auth
 - [ ] JWT con expiración corta (<= 15 min)

package/{rules/testing.md → .agents/rules/05-testing.md}

@@ -1,6 +1,6 @@
 # LMAgent Testing Rules
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 
@@ -314,13 +314,15 @@ test:
 ## Antes de Push
 - [ ] Tests unitarios para nueva lógica
 - [ ] Tests de integración para endpoints
-- [ ] Coverage no disminuyó
-- [ ] No hay tests skipped sin razón
-- [ ] Tests locales pasan
+- [ ] Coverage no disminuyó (>80%)
+- [ ] No hay tests skipped sin razón explicita
+- [ ] Tests locales pasan en < 2min (si no, optimizar)
+- [ ] Happy Path + Edge Cases + Error Cases cubiertos
 
 ## Para Bugs
 - [ ] Test que reproduce el bug (falla primero)
 - [ ] Fix implementado
 - [ ] Test ahora pasa
 - [ ] Otros tests no rompieron
+- [ ] Regression test agregado a suite
 ```

package/{rules/api-design.md → .agents/rules/06-api-design.md}

@@ -1,6 +1,6 @@
 # LMAgent API Design Rules
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 

package/{rules/documentation.md → .agents/rules/07-documentation.md}

@@ -1,14 +1,14 @@
 # Documentación Continua
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 
 | ¿Qué documentar? | ¿Dónde? |
 |------------------|--------|
-| Decisiones de stack | `rules/stack.md` |
-| Patrones de código | `rules/code-style.md` |
-| Flujos de trabajo | `rules/workflow.md` |
+| Decisiones de stack | `02-tech-stack.md` |
+| Patrones de código | `03-code-style.md` |
+| Flujos de trabajo | `01-workflow.md` |
 | Comandos del proyecto | `config/commands.yaml` |
 | Cambios de versión | `CHANGELOG.md` |
 
@@ -27,7 +27,7 @@
 ### Después de CADA implementación significativa:
 
 1. **Nuevas funcionalidades** → Actualizar README o docs relevantes
-2. **Cambios de arquitectura** → Actualizar `rules/stack.md` o crear diagrama
+2. **Cambios de arquitectura** → Actualizar `02-tech-stack.md` o crear diagrama
 3. **Nuevos patrones** → Documentar en reglas aplicables
 4. **Bugs resueltos** → Agregar a CHANGELOG o notas
 5. **Decisiones técnicas** → Documentar el "por qué"
@@ -43,9 +43,9 @@
 
 | Tipo | Dónde | Ejemplo |
 |------|-------|---------|
-| Decisiones de stack | `rules/stack.md` | "Usamos PostgreSQL porque..." |
-| Patrones de código | `rules/code-style.md` | "Nombres de funciones en snake_case" |
-| Flujos de trabajo | `rules/workflow.md` | "PRs requieren 2 reviewers" |
+| Decisiones de stack | `02-tech-stack.md` | "Usamos PostgreSQL porque..." |
+| Patrones de código | `03-code-style.md` | "Nombres de funciones en snake_case" |
+| Flujos de trabajo | `01-workflow.md` | "PRs requieren 2 reviewers" |
 | Comandos del proyecto | `config/commands.yaml` | Alias personalizados |
 | Changelog | `CHANGELOG.md` | Versiones y cambios |
 

package/{rules/agents-ia.md → .agents/rules/08-agents-ai.md}

@@ -1,17 +1,21 @@
 # Reglas para Agentes de IA - LMAgent
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 
 | Principio | Regla |
 |-----------|-------|
-| **Tool-first** | El LLM decide, las tools ejecutan. NUNCA ejecutar código directo del LLM. |
-| **Stateless** | Agentes sin estado en memoria. Usar Redis para persistencia. |
-| **Observable** | Logging de TODAS las interacciones LLM + Cost Tracking obligatorio. |
-| **MCP Standard** | Usar Model Context Protocol (MCP) para definir herramientas. |
-| **Guardrails** | Timeout, rate limit y validación de outputs OBLIGATORIOS. |
-
+| **00-master.md** | ⭐ Entry point: startup, skills, reglas críticas |
+| **01-workflow.md** | Git flow, niveles de complejidad, flujo de trabajo |
+| **02-tech-stack.md** | Stack tecnológico aprobado y librerías autorizadas |
+| **03-code-style.md** | Linter, naming conventions, estructura de proyecto |
+| **04-security.md** | Validación de inputs, gestión de secretos, OWASP Top 10 |
+| **05-testing.md** | TDD obligatorio, requisitos de cobertura |
+| **06-api-design.md** | Estándares REST/GraphQL, error handling, versionado |
+| **07-documentation.md** | ⚠️ Documentación continua, READMEs, ADRs |
+| **09-automations.md** | Best practices para workflows n8n robustos |
+| **10-git-flow.md** | Gestión de ramas, commits y PRs |
 ### 👥 Roles que usan esta regla
 `ai-agent-engineer`, `prompt-engineer`, `backend-engineer`, `architect`
 

package/{rules/automations-n8n.md → .agents/rules/09-automations.md}

@@ -1,6 +1,6 @@
 # Reglas para Integraciones con n8n - LMAgent
 
-> **Tipo**: `rule` | **Versión**: 2.1 | **Actualización**: 2026-01
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
 
 ## 📌 Quick Reference
 

package/.agents/rules/10-git-flow.md

@@ -0,0 +1,122 @@
+# Git Flow & Version Control - LMAgent
+
+> **Tipo**: `rule` | **Versión**: 3.0.0 | **Actualización**: 2026-02
+
+## 📌 Quick Reference
+
+| Concepto | Convención |
+|----------|------------|
+| **Rama Principal** | `main` (protegida) |
+| **Rama Desarrollo** | `dev` (integración) |
+| **Feature Branch** | `feat/nombre-feature` |
+| **Fix Branch** | `fix/nombre-bug` |
+| **Commits** | `type(scope): descripción` (Conventional Commits) |
+| **PRs** | Título descriptivo + Link a issue/task |
+
+### 👥 Roles que usan esta regla
+`todos`
+
+---
+
+## Estrategia de Ramas
+
+Usamos una variante simplificada de **Git Flow**:
+
+1. **`main`**: Producción estable. Solo recibe merges de release tags.
+2. **`dev`**: Rama de integración principal. Todo desarrollo se une aquí.
+3. **`feat/...`**: Nuevas funcionalidades. Salen de `dev`, vuelven a `dev`.
+4. **`fix/...`**: Corrección de bugs. Salen de `dev`, vuelven a `dev`.
+5. **`hotfix/...`**: Bugs críticos en producción. Salen de `main`, vuelven a `main` y `dev`.
+
+### Naming Conventions
+
+- `feat/user-auth`
+- `fix/login-error`
+- `chore/update-deps`
+- `docs/update-readme`
+- `refactor/api-structure`
+
+---
+
+## Conventional Commits
+
+Es **OBLIGATORIO** usar [Conventional Commits](https://www.conventionalcommits.org/).
+
+### Formato
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Tipos Permitidos
+
+| Tipo | Uso | Ejemplo |
+|------|-----|---------|
+| **feat** | Nueva funcionalidad | `feat(auth): implement jwt logic` |
+| **fix** | Corrección de bug | `fix(api): handle 404 errors` |
+| **refactor** | Cambio de código sin feat/fix | `refactor(db): optimize query` |
+| **docs** | Solo documentación | `docs: update install guide` |
+| **test** | Tests unitarios/e2e | `test(user): add login tests` |
+| **chore** | Build, deps, herramientas | `chore: update packages` |
+| **perf** | Mejora de rendimiento | `perf(img): compress assets` |
+| **ci** | CI/CD changes | `ci: fix github action` |
+
+### Reglas de Mensajes
+
+1. **Imperativo**: "add feature" no "added feature"
+2. **Minúsculas**: "feat: ..." no "Feat: ..."
+3. **Sin punto final**: "fix: bug" no "fix: bug."
+4. **Scope opcional**: El scope es el módulo afectado (api, ui, db, deps).
+
+---
+
+## Pull Requests (PRs)
+
+### Checklist para PRs
+
+- [ ] Título sigue Conventional Commits (`feat: ...`)
+- [ ] Descripción explica EL POR QUÉ del cambio
+- [ ] Tests pasan en local
+- [ ] Linting pasa en local
+- [ ] No hay conflictos con `dev`
+- [ ] Review de al menos 1 peer (para merges a `dev`)
+
+### Proceso de Merge
+
+1. **Squash & Merge** (Recomendado): Mantiene history lineal.
+2. **Rebase & Merge**: Si se necesita mantener commits individuales.
+3. **Merge Commit**: Evitar salvo releases.
+
+---
+
+## Buenas Prácticas
+
+### 1. Atomic Commits
+Cada commit debe hacer una sola cosa y el proyecto debe compilar/funcionar en cada commit.
+
+❌ **Mal**: "Fix bugs and add login and update readme"
+✅ **Bien**: 
+- `fix(auth): resolve token error`
+- `feat(ui): add login form`
+- `docs: update readme`
+
+### 2. No Secrets
+NUNCA commitear `.env` files, claves privadas, o credenciales.
+Usar `.gitignore` estricto.
+
+### 3. Sync Frecuente
+Hacer `git pull origin dev` frecuentemente en tu feature branch para evitar conflictos masivos al final.
+
+---
+
+## ✅ Checklist de Validación (Antes de Push)
+
+- [ ] ¿Estoy en la rama correcta? (`git branch`)
+- [ ] ¿He corrido los tests?
+- [ ] ¿El mensaje de commit sigue el estándar?
+- [ ] ¿No he dejado `console.log` o código muerto?
+- [ ] ¿He revisado mis propios cambios (`git diff`)?

package/{scripts → .agents/scripts}/create_skill.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * LMAgent Skill Generator — v2.7.0
+ * LMAgent Skill Generator — v3.0.0
  * 
  * Genera la estructura completa de un nuevo skill interactivamente.
  * 
@@ -92,7 +92,7 @@ name: ${data.name}
 description: ${data.description}
 role: ${data.role}
 type: ${data.type}
-version: 2.7
+version: 3.0.0
 icon: ${data.icon}
 expertise:
 ${expertise}
@@ -212,7 +212,7 @@ Antes de considerar una tarea terminada, verifica TODO:
 
 // ─── Main ─────────────────────────────────────────────────────
 async function main() {
-    console.log(c.bold('\n🛠️  LMAgent Skill Generator v2.7.0\n'));
+    console.log(c.bold('\n🛠️  LMAgent Skill Generator v3.0.0\n'));
 
     const prompt = createPrompt();
 

package/{scripts → .agents/scripts}/validate_skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * LMAgent Skills Validator — v2.7.0
+ * LMAgent Skills Validator — v3.0.0
  * 
  * Valida la integridad de todos los skills del framework.
  * Verifica: frontmatter YAML, campos obligatorios, estructura de directorio.
@@ -29,7 +29,7 @@ const SKILLS_DIR = join(ROOT, 'skills');
 // ─── Configuración ────────────────────────────────────────────
 const REQUIRED_FIELDS = ['name', 'description', 'role', 'type', 'version', 'icon', 'expertise', 'activates_on', 'triggers'];
 const VALID_TYPES = ['agent_persona', 'methodology'];
-const CURRENT_VERSION = 2.7;
+const CURRENT_VERSION = '3.0.0';
 const OPTIONAL_DIRS = ['scripts', 'references', 'assets'];
 
 // ─── Colores (sin dependencias) ───────────────────────────────
@@ -122,9 +122,10 @@ function validateSkill(skillDir) {
 
     // 5. Verificar versión
     if (fm.version) {
-        const ver = parseFloat(fm.version);
+        // Force string comparison for semver
+        const ver = String(fm.version);
         if (ver !== CURRENT_VERSION) {
-            warnings.push(`Versión ${fm.version} ≠ ${CURRENT_VERSION} (actual del framework)`);
+            warnings.push(`Versión ${ver} ≠ ${CURRENT_VERSION} (actual del framework)`);
         }
     }
 
@@ -196,7 +197,7 @@ function main() {
 
     const c = chalk;
 
-    console.log(c.bold('\n🔍 LMAgent Skill Validator v2.7.0\n'));
+    console.log(c.bold('\n🔍 LMAgent Skill Validator v3.0.0\n'));
     console.log(chalk.dim(`   Directorio: ${SKILLS_DIR}`));
     console.log(chalk.dim(`   Campos obligatorios: ${REQUIRED_FIELDS.length}`));
     console.log('');