quinotospec-refresh-discovery

Workflow: Refresh Discovery

Este workflow detecta qué ha cambiado en el proyecto desde el último discovery y actualiza únicamente los archivos de .quinoto-spec/discovery/ afectados.

Parámetro Opcional:

• SERVICE_PATH: Ruta relativa al sub-proyecto a refrescar (ej. ./services/auth-service). Si no se especifica, opera sobre el directorio raíz del proyecto. Este parámetro es utilizado por quinotospec.stack-discovery cuando detecta discoveries desactualizados en servicios individuales.

Precondición: El discovery completo (quinotospec.discovery) debe haberse ejecutado al menos una vez en el directorio objetivo. Si no existe {{SERVICE_PATH}}/.quinoto-spec/discovery/ (o .quinoto-spec/discovery/ en la raíz), redirigir al usuario a ejecutar quinotospec.discovery primero.

---

Paso 1 — Verificar fecha del último discovery

1. Lee .quinoto-spec/discovery/01-stack-profile.md y extrae el campo **Discovery Date:**.
2. Calcula cuántos días han pasado desde esa fecha.
3. Reporta: "Último discovery: [fecha] ([N] días atrás)".

---

Paso 2 — Detectar archivos modificados desde el último discovery

Busca archivos modificados desde la **Discovery Date:** extraída:

git diff --name-only HEAD@{<discovery-date>} HEAD

Si git no está disponible, listar archivos con fecha de modificación posterior al discovery date.

Clasifica los cambios por área de impacto:

Archivo modificado	Discovery afectado
package.json, requirements.txt, go.mod, etc.	01-stack-profile.md
Archivos de rutas/controllers/views	04-endpoints-and-openapi.md
Archivos de modelos/migrations/schemas	05-data-and-services.md
.github/workflows/, Dockerfile, .env.example	06-devops-ci-security.md
Cualquier archivo con bugs/refactors significativos	07-findings-and-recommendations.md

---

Paso 3 — Regenerar solo los archivos afectados

Para cada archivo de discovery identificado como impactado:

1. Leer el archivo actual de discovery.
2. Analizar los cambios en el código fuente relacionados.
3. Actualizar solo las secciones afectadas del archivo discovery, manteniendo el resto intacto.
4. Actualizar el campo **Discovery Date:** al día de hoy en 01-stack-profile.md.