comunidadhll/ai/tasks/done/TASK-025-repo-hygiene-and-dev-artifacts-cleanup.md

# TASK-025-repo-hygiene-and-dev-artifacts-cleanup

## Goal
Dejar el repositorio HLL Vietnam en un estado mas limpio y consistente eliminando o regularizando artefactos locales de desarrollo, ficheros de lock y residuos de workflow que no deberian quedar como ruido permanente en el worktree.

## Context
Despues de varias tasks ejecutadas por el workflow, siguen apareciendo residuos locales o inconsistencias de higiene del repositorio, entre ellos:
- `ai/worker.lock`
- `backend/data/hll_vietnam_dev.sqlite3`
- `ai/tasks/done/TASK-021-server-status-periodic-query-and-display.md` como untracked o no regularizado
- posibles cambios locales en `backend/app/config.py`

Estos elementos no forman parte directa del valor de producto visible, pero si afectan a la salud del repositorio, al flujo del worker y a la claridad del estado git. Hace falta una pasada de limpieza controlada para dejar reglas claras sobre que debe versionarse y que debe considerarse artefacto local de desarrollo.

## Steps
1. Revisar el estado actual del repositorio y confirmar que archivos siguen quedando como ruido local o inconsistencias.
2. Analizar especificamente:
   - `ai/worker.lock`
   - `backend/data/hll_vietnam_dev.sqlite3`
   - `ai/tasks/done/TASK-021-server-status-periodic-query-and-display.md`
   - `backend/app/config.py`
3. Determinar para cada uno de ellos si debe:
   - versionarse
   - ignorarse
   - regenerarse localmente
   - moverse o regularizarse
4. Ajustar `.gitignore` u otros mecanismos de higiene si hace falta.
5. Asegurar que los artefactos locales de desarrollo no sigan ensuciando el worktree innecesariamente.
6. Regularizar el estado de la task `TASK-021` si quedo fuera del flujo esperado.
7. Documentar de forma minima, si hace falta, el tratamiento esperado de snapshots persistidos, locks locales y otros artefactos de runtime.
8. No tocar logica funcional de producto salvo que sea estrictamente necesario para dejar el repo coherente.
9. Al completar la implementacion:
   - dejar el repositorio consistente
   - hacer commit
   - hacer push al remoto si el entorno lo permite

## Files to Read First
- AGENTS.md
- .gitignore
- ai/README.md
- ai/orchestrator/README.md
- backend/README.md
- backend/app/config.py
- cualquier documentacion existente sobre snapshots o runtime local
- salida actual de `git status`

## Expected Files to Modify
- .gitignore
- backend/README.md
- opcionalmente ai/README.md o documentacion minima si hace falta aclarar el tratamiento de artefactos locales
- opcionalmente regularizacion de archivos en `ai/tasks/done/`
- opcionalmente eliminacion o exclusion de artefactos locales no deseados

## Constraints
- No romper el workflow actual del proyecto.
- No eliminar informacion util sin justificarlo.
- No tocar frontend salvo que fuera completamente imprescindible.
- No introducir cambios funcionales de producto.
- No hacer cambios destructivos fuera del objetivo de higiene del repo.
- Mantener el resultado claro, pequeno y seguro.

## Validation
- El worktree queda sensiblemente mas limpio.
- Los artefactos de desarrollo local quedan tratados de forma explicita.
- `ai/worker.lock` no queda como ruido permanente si no debe versionarse.
- El tratamiento de `backend/data/hll_vietnam_dev.sqlite3` queda resuelto.
- `TASK-021` queda regularizada si estaba fuera del flujo.
- Los cambios quedan committeados y se hace push al remoto si el entorno lo permite.

## Change Budget
- Preferir menos de 6 archivos modificados.
- Preferir menos de 180 lineas cambiadas.

## Outcome
- `.gitignore` pasa a tratar `ai/worker.lock` y `backend/data/*.sqlite3` como artefactos locales de runtime en lugar de ruido permanente versionado.
- `backend/data/.gitkeep` mantiene el directorio de datos en el repositorio sin forzar que la base SQLite de desarrollo quede commiteada.
- `ai/tasks/done/TASK-021-server-status-periodic-query-and-display.md` queda regularizada dentro del historial versionado de tasks completadas.
- El cambio pendiente de `backend/app/config.py` queda absorbido como parte de la regularizacion de `TASK-021`, en lugar de seguir apareciendo como residuo suelto.

## Validation Result
- Revisado `git status --short` para confirmar que el ruido original del worktree quedaba centrado en `ai/worker.lock`, `backend/data/hll_vietnam_dev.sqlite3`, `backend/app/config.py` y la task `TASK-021`.
- Revisadas las referencias de runtime en `scripts/codex-runner.ps1`, `backend/app/config.py` y `backend/README.md` para confirmar que el lock y la SQLite son artefactos regenerables de desarrollo local.
- Validacion final prevista: `git diff --name-only` debe reflejar solo la higiene de ignores, la regularizacion de archivos versionados y la task cerrada.

## Decision Notes
- `ai/worker.lock` se trata como lock efimero del runner local y no aporta valor historico en git.
- `backend/data/hll_vietnam_dev.sqlite3` se mantiene como persistencia local regenerable; el contrato util esta en codigo y documentacion, no en una base SQLite concreta del worktree.