@qubiit/lmagent 2.5.0

package/templates/backend-python/README.md

@@ -0,0 +1,78 @@
+# LMAgent Backend Python Template
+
+Template de proyecto FastAPI con la estructura y configuración recomendada por LMAgent.
+
+## Estructura
+
+```
+backend-python/
+├── app/
+│   ├── __init__.py
+│   ├── main.py              # Entry point FastAPI
+│   ├── config.py            # Configuración con Pydantic Settings
+│   ├── routers/             # Endpoints API
+│   │   ├── __init__.py
+│   │   ├── health.py        # Health check
+│   │   └── v1/              # API v1
+│   │       ├── __init__.py
+│   │       └── users.py     # Ejemplo: users endpoints
+│   ├── services/            # Lógica de negocio
+│   │   ├── __init__.py
+│   │   └── user_service.py
+│   ├── repositories/        # Acceso a datos
+│   │   ├── __init__.py
+│   │   └── user_repository.py
+│   ├── models/              # SQLModel models
+│   │   ├── __init__.py
+│   │   └── user.py
+│   ├── schemas/             # Pydantic schemas
+│   │   ├── __init__.py
+│   │   └── user.py
+│   └── core/                # Utilidades compartidas
+│       ├── __init__.py
+│       ├── database.py      # Database connection
+│       └── exceptions.py    # Custom exceptions
+├── tests/
+│   ├── conftest.py          # Fixtures de pytest
+│   └── test_health.py
+├── Dockerfile
+├── requirements.txt
+├── requirements-dev.txt
+└── pyproject.toml
+```
+
+## Quick Start
+
+```bash
+# Crear entorno virtual
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# venv\Scripts\activate   # Windows
+
+# Instalar dependencias
+pip install -r requirements.txt
+pip install -r requirements-dev.txt
+
+# Configurar variables de entorno
+cp .env.example .env
+# Editar .env con tus valores
+
+# Ejecutar en desarrollo
+uvicorn app.main:app --reload
+
+# Ejecutar tests
+pytest --cov=app
+```
+
+## Dependencias Principales
+
+- **FastAPI**: Framework web async
+- **SQLModel**: ORM + validación
+- **Pydantic**: Validación de datos
+- **Uvicorn**: Servidor ASGI
+- **Redis**: Cache
+- **pytest**: Testing
+
+## Patrones de Código
+
+Ver `rules/code-style.md` y `personas/backend-engineer.md` para guías detalladas.

package/templates/backend-python/app/core/config.py

@@ -0,0 +1,12 @@
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    PROJECT_NAME: str = "LMAgent Project"
+    API_V1_STR: str = "/api/v1"
+    DATABASE_URL: str = "sqlite:///./dev.db"
+    
+    class Config:
+        case_sensitive = True
+        env_file = ".env"
+
+settings = Settings()

package/templates/backend-python/app/core/database.py

@@ -0,0 +1,12 @@
+from sqlmodel import SQLModel, create_engine, Session
+from app.core.config import settings
+
+connect_args = {"check_same_thread": False} if "sqlite" in settings.DATABASE_URL else {}
+engine = create_engine(settings.DATABASE_URL, echo=True, connect_args=connect_args)
+
+def get_session():
+    with Session(engine) as session:
+        yield session
+
+def init_db():
+    SQLModel.metadata.create_all(engine)

package/templates/backend-python/app/main.py

@@ -0,0 +1,17 @@
+from fastapi import FastAPI
+from app.core.config import settings
+from app.routers import health
+# from app.routers.v1 import users  # Uncomment when created
+
+app = FastAPI(
+    title=settings.PROJECT_NAME,
+    openapi_url=f"{settings.API_V1_STR}/openapi.json"
+)
+
+app.include_router(health.router, tags=["health"])
+# app.include_router(users.router, prefix=f"{settings.API_V1_STR}/users", tags=["users"])
+
+@app.on_event("startup")
+def on_startup():
+    from app.core.database import init_db
+    init_db()

package/templates/backend-python/app/routers/__init__.py

@@ -0,0 +1 @@
+from . import health

package/templates/backend-python/app/routers/health.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.get("/health", status_code=200)
+def health_check():
+    return {"status": "ok"}

package/templates/backend-python/requirements-dev.txt

@@ -0,0 +1,6 @@
+pytest>=7.4.0
+pytest-cov>=4.1.0
+httpx>=0.24.1
+black>=23.3.0
+isort>=5.12.0
+mypy>=1.4.1

package/templates/backend-python/requirements.txt

@@ -0,0 +1,4 @@
+fastapi>=0.100.0
+uvicorn>=0.23.0
+sqlmodel>=0.0.8
+pydantic-settings>=2.0.0

package/templates/backend-python/tests/test_health.py

@@ -0,0 +1,9 @@
+from fastapi.testclient import TestClient
+from app.main import app
+
+client = TestClient(app)
+
+def test_health_check():
+    response = client.get("/health")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}

package/templates/checkpoint.yaml

@@ -0,0 +1,117 @@
+# Checkpoint & Backup System
+# LMAgent Framework v3.0 - Ultra-Robust State Persistence
+#
+# Este archivo define el sistema de checkpoints automáticos y backups
+# para garantizar que NUNCA se pierda el estado del proyecto.
+#
+# UBICACIÓN: .lmagent/checkpoints/ (directorio)
+
+---
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                    SISTEMA DE CHECKPOINTS AUTOMÁTICOS
+# ═══════════════════════════════════════════════════════════════════════════
+#
+# El agente debe crear un checkpoint en estos momentos:
+#
+# 1. FASE COMPLETADA
+#    - Después de aprobar spec.yaml → checkpoint "phase_specify_complete"
+#    - Después de aprobar plan.yaml → checkpoint "phase_plan_complete"
+#    - Después de crear tasks.yaml → checkpoint "phase_tasks_complete"
+#    - Después de verificar → checkpoint "phase_verify_complete"
+#
+# 2. TASK COMPLETADA
+#    - Después de completar cada task → checkpoint "task_T00X_complete"
+#
+# 3. DECISIÓN IMPORTANTE
+#    - Después de decisiones arquitectónicas → checkpoint "decision_DXXX"
+#
+# 4. SESIÓN FINALIZADA
+#    - Cuando el usuario cierra la sesión → checkpoint "session_X_end"
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                          ESTRUCTURA DE CHECKPOINT
+# ═══════════════════════════════════════════════════════════════════════════
+
+checkpoint:
+  id: "chk_20260123_143052"  # Formato: chk_YYYYMMDD_HHMMSS
+  created_at: "2026-01-23T14:30:52"
+  trigger: "task_complete"  # phase_complete | task_complete | decision | session_end | manual
+  
+  # Qué disparó este checkpoint
+  trigger_details:
+    type: "task"
+    id: "T002"
+    title: "Crear endpoint GET /users"
+  
+  # Snapshot del estado completo
+  state_snapshot:
+    current_phase: "implement"
+    spec_status: "approved"
+    plan_status: "approved"
+    tasks_total: 15
+    tasks_completed: 2
+    tasks_in_progress: 1
+    tasks_pending: 12
+    current_task_id: "T003"
+  
+  # Archivos que cambiaron desde el último checkpoint
+  changed_files:
+    - path: "src/models/user.py"
+      action: "created"
+    - path: "src/api/users.py"
+      action: "modified"
+    - path: "tests/test_users.py"
+      action: "created"
+  
+  # Resumen en lenguaje natural (para que cualquier LLM entienda rápido)
+  summary: |
+    Fase: Implementación
+    Completé: T002 - Endpoint GET /users
+    Creé: user.py, users.py, test_users.py
+    Próximo: T003 - Endpoint POST /users
+    Tests passing: 5/5
+
+# ═══════════════════════════════════════════════════════════════════════════
+#                       INSTRUCCIONES PARA EL AGENTE
+# ═══════════════════════════════════════════════════════════════════════════
+#
+# 🤖 CREAR CHECKPOINT:
+#
+# Después de cada milestone significativo, ejecuta:
+#
+# ```python
+# checkpoint = {
+#     "id": f"chk_{datetime.now().strftime('%Y%m%d_%H%M%S')}",
+#     "created_at": datetime.now().isoformat(),
+#     "trigger": "task_complete",  # o el trigger correspondiente
+#     "trigger_details": {...},
+#     "state_snapshot": {...},
+#     "changed_files": [...],
+#     "summary": "..."
+# }
+# 
+# # Guardar en .lmagent/checkpoints/chk_YYYYMMDD_HHMMSS.yaml
+# ```
+#
+# 🤖 RECUPERAR DE CHECKPOINT:
+#
+# Si el usuario dice "algo salió mal" o "volver atrás":
+#
+# 1. Listar checkpoints: ls .lmagent/checkpoints/
+# 2. Mostrar últimos 5 al usuario
+# 3. El usuario elige uno
+# 4. Leer ese checkpoint y restaurar el estado
+#
+# ═══════════════════════════════════════════════════════════════════════════
+#                          POLÍTICA DE RETENCIÓN
+# ═══════════════════════════════════════════════════════════════════════════
+#
+# Mantener:
+# - Últimos 20 checkpoints de tasks
+# - Todos los checkpoints de fases (nunca borrar)
+# - Últimos 10 checkpoints de sesión
+#
+# Limpiar automáticamente cuando hay más de 50 checkpoints totales.
+#
+# ═══════════════════════════════════════════════════════════════════════════