refacil-sdd-ai 1.0.0

package/skills/test/testing-patterns.md

@@ -0,0 +1,150 @@
+# Patrones de Testing del Equipo
+
+## Estructura de archivos de test
+
+```
+archivo.ts          → archivo.spec.ts      (en la misma carpeta)
+mi-servicio.ts      → mi-servicio.spec.ts
+product.mapper.ts   → product.mapper.spec.ts
+```
+
+## Patron para servicios NestJS
+
+```typescript
+import { Test, TestingModule } from '@nestjs/testing';
+import { MiServicio } from './mi-servicio';
+
+// Mocks declarados fuera del describe
+const mockDependencia = {
+  metodo1: jest.fn(),
+  metodo2: jest.fn(),
+};
+
+describe('MiServicio', () => {
+  let service: MiServicio;
+
+  beforeEach(async () => {
+    jest.clearAllMocks();
+
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [
+        MiServicio,
+        { provide: 'DEPENDENCIA_PORT', useValue: mockDependencia },
+      ],
+    }).compile();
+
+    service = module.get<MiServicio>(MiServicio);
+  });
+
+  describe('metodoPublico', () => {
+    it('should [resultado esperado] when [condicion]', async () => {
+      // Arrange
+      mockDependencia.metodo1.mockResolvedValue({ /* datos */ });
+
+      // Act
+      const result = await service.metodoPublico(/* params */);
+
+      // Assert
+      expect(result).toEqual(/* esperado */);
+      expect(mockDependencia.metodo1).toHaveBeenCalledWith(/* params */);
+    });
+  });
+});
+```
+
+## Patron para funciones utilitarias (puras)
+
+```typescript
+import { miFuncion } from './mi-util';
+
+describe('miFuncion', () => {
+  it('should [resultado] with valid input', () => {
+    expect(miFuncion('input')).toBe('expected');
+  });
+
+  it('should handle null input', () => {
+    expect(miFuncion(null)).toBeNull();
+  });
+
+  it('should handle edge case [X]', () => {
+    expect(miFuncion('')).toBe('default');
+  });
+});
+```
+
+## Patron para mappers
+
+```typescript
+import { MiMapper } from './mi.mapper';
+
+describe('MiMapper', () => {
+  describe('toDomain', () => {
+    it('should map ORM entity to domain entity', () => {
+      const ormEntity = { id: '123', name: 'test', status: 'ACTIVE' };
+      const result = MiMapper.toDomain(ormEntity);
+
+      expect(result.id).toBe('123');
+      expect(result.name).toBe('test');
+      expect(result.status).toBe('ACTIVE');
+    });
+  });
+
+  describe('toOrm', () => {
+    it('should map domain entity to ORM entity', () => {
+      // ...
+    });
+  });
+});
+```
+
+## Patron para mocks de gRPC
+
+```typescript
+const mockGrpcClient = {
+  getService: jest.fn().mockReturnValue({
+    metodoGrpc: jest.fn().mockReturnValue(
+      of({ data: 'response' }) // Observable
+    ),
+  }),
+};
+```
+
+## Patron para mocks de BullMQ
+
+```typescript
+const mockQueue = {
+  add: jest.fn().mockResolvedValue({ id: 'job-1' }),
+  getJob: jest.fn(),
+  process: jest.fn(),
+};
+```
+
+## Patron para mocks de Logger
+
+```typescript
+const mockLogger = {
+  log: jest.fn(),
+  error: jest.fn(),
+  warn: jest.fn(),
+  debug: jest.fn(),
+};
+```
+
+## Naming conventions
+
+```typescript
+// Formato: should [verbo] [resultado] when [condicion]
+it('should return product request when valid id is provided', () => {});
+it('should throw NotFoundException when product does not exist', () => {});
+it('should update status to SOLD when payment is confirmed', () => {});
+it('should create refund when sale fails after successful topup', () => {});
+```
+
+## Anti-patrones a evitar
+
+- NO testear propiedades privadas directamente
+- NO testear implementacion interna (orden de llamadas) a menos que sea critico
+- NO crear tests sin assertions (expect)
+- NO crear tests que dependan del orden de ejecucion
+- NO mockear todo — solo los limites del sistema
+- NO crear tests fragiles que se rompen con cambios cosmeticos

package/skills/verify/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: refacil:verify
+description: Validar que la implementacion cumple con las specs — verifica completitud, correccion y coherencia del cambio
+user-invocable: true
+---
+
+# refacil:verify — Verificacion de Implementacion
+
+Este comando envuelve la funcionalidad de OpenSpec verify y agrega verificacion de tests.
+
+## Antes de empezar
+
+Si existe `AGENTS.md` en la raiz del proyecto, leelo para entender las convenciones.
+Si NO existe `AGENTS.md`, informa al usuario: "No se encontro AGENTS.md. Ejecuta /refacil:setup para generarlo." y detente.
+
+## Instrucciones
+
+### Paso 1: Delegar a OpenSpec verify
+
+Ejecuta internamente las instrucciones de la skill `openspec-verify-change` que esta instalada en `.claude/skills/openspec-verify-change/SKILL.md` (o `.cursor/skills/openspec-verify-change/SKILL.md`).
+
+Lee esa skill y sigue sus instrucciones pasandole el argumento del usuario: **$ARGUMENTS**
+
+Esto generara un reporte de verificacion con issues CRITICAL/WARNING/SUGGESTION.
+
+### Paso 2: Verificar tests (aporte Refacil)
+
+Ademas de la verificacion de OpenSpec, ejecuta `npm test` y verifica:
+- Todos los tests pasan
+- Los tests cubren los criterios de aceptacion de la spec
+- No hay tests faltantes para requisitos clave
+- Si hay un comando de coverage (`npm run test:cov`), ejecutalo y reporta el porcentaje
+
+### Paso 3: Reporte combinado (aporte Refacil)
+
+Combina el reporte de OpenSpec con la verificacion de tests en un reporte unificado:
+
+```
+=== Reporte de Verificacion ===
+
+--- OpenSpec Verify ---
+[Resultados del reporte de OpenSpec: CRITICAL, WARNING, SUGGESTION]
+
+--- Tests (Refacil) ---
+ [PASS/FAIL] Tests ejecutados: [N]
+ [PASS/FAIL] Tests pasaron: [N]
+ [PASS/FAIL] Coverage: [X]% (minimo requerido: 80%)
+
+RESULTADO: APROBADO / REQUIERE CORRECCIONES
+
+Correcciones necesarias:
+1. [issues de OpenSpec]
+2. [issues de tests]
+```
+
+### Paso 4: Siguiente paso
+
+- Si APROBADO: "Ejecuta `/refacil:review` para el review con checklist del equipo."
+- Si REQUIERE CORRECCIONES: "Corrige los issues listados y ejecuta `/refacil:verify` de nuevo."
+
+## Reglas
+
+- NO modificar codigo durante la verificacion
+- Ser estricto con los criterios de la spec
+- Si algo no esta en la spec pero parece necesario, mencionarlo como observacion, no como fallo

package/templates/claude-md.md

@@ -0,0 +1,23 @@
+# CLAUDE.md
+
+Las instrucciones completas del proyecto estan en [AGENTS.md](AGENTS.md).
+Si AGENTS.md no existe, ejecuta `/refacil:setup` para generarlo automaticamente.
+
+## Metodologia SDD-AI (Refacil)
+
+Este proyecto usa la metodologia SDD-AI. Skills disponibles:
+
+| Comando | Descripcion |
+|---------|-------------|
+| `/refacil:setup` | Instalar OpenSpec y generar AGENTS.md |
+| `/refacil:guide` | Guia interactiva — que comando usar |
+| `/refacil:explore` | Explorar el codebase sin cambios |
+| `/refacil:propose` | Crear propuesta de cambio |
+| `/refacil:apply` | Implementar tasks del cambio |
+| `/refacil:test` | Generar tests unitarios |
+| `/refacil:verify` | Validar implementacion vs specs |
+| `/refacil:review` | Review con checklist de calidad |
+| `/refacil:archive` | Archivar cambio completado |
+| `/refacil:bug` | Flujo guiado de bugfix |
+
+Flujo: `setup` → `propose` → `apply` → `test` → `verify` → `review` → `archive`

package/templates/cursorrules.md

@@ -0,0 +1,21 @@
+# Cursor Rules
+
+Las instrucciones completas del proyecto estan en AGENTS.md.
+Si AGENTS.md no existe, ejecuta /refacil:setup para generarlo automaticamente.
+
+## Metodologia SDD-AI (Refacil)
+
+Skills disponibles en .cursor/skills/refacil-*/:
+
+- /refacil:setup — Instalar OpenSpec y generar AGENTS.md
+- /refacil:guide — Guia interactiva
+- /refacil:explore — Explorar codebase
+- /refacil:propose — Crear propuesta de cambio
+- /refacil:apply — Implementar tasks
+- /refacil:test — Generar tests unitarios
+- /refacil:verify — Validar vs specs
+- /refacil:review — Review con checklist
+- /refacil:archive — Archivar cambio
+- /refacil:bug — Flujo guiado de bugfix
+
+Flujo: setup → propose → apply → test → verify → review → archive