trackertast

Tracker local de tareas en archivos Markdown dentro del repositorio, pensado para que personas y agentes se pasen el trabajo sin bases de datos, servicios externos ni dependencias de runtime.

Cada tarea vive en su propia carpeta bajo tareas/, con un archivo central TAREA.md y cualquier adjunto local (capturas, notas, esquemas, volcados de evidencia). Git guarda la historia.

Instalación

Requiere Python 3.11 o posterior y no tiene dependencias de runtime:

uv tool install trackertast

O desde el repositorio:

uv tool install .
# o con pip en un entorno virtual:
pip install .

Comandos y ejemplos

El CLI se invoca como tasks. Los verbos canónicos son en inglés, con alias en español para mantener compatibilidad:

Para más detalles sobre el formato de TAREA.md, consultas TQL y contratos, consultá docs/tareas.md.

Relación con Oracle

trackertast es un programa independiente de Oracle: no requiere catálogos de medidas ni motor de evaluación para funcionar.

Sin embargo, sabe emitir evidencia relacional observable mediante el comando tasks facts (alias tasks hechos). Oracle puede consumir esta evidencia relacional y juzgarla contra políticas formales del catálogo:

# 1. Exportar los hechos del tracker
tasks facts --git > hechos.json

# 2. Juzgar la evidencia contra políticas de seguimiento en Oracle
oracle juzgar --proyecto ejemplo/seguimiento-tareas --con hechos.json

El proyecto de ejemplo en ejemplo/seguimiento-tareas define políticas de auditoría para verificar:

• Que las referencias locales a adjuntos existan físicamente (seguimiento.referencias_locales_presentes).
• Que los archivos del tracker estén confirmados en Git sin cambios pendientes (seguimiento.archivos_confirmados_sin_cambios).
• Que la lectura del tracker haya sido completa y sin omisiones (seguimiento.lectura_sin_omisiones).
• Que todo commit que nombra una tarea apunte a una tarea existente (seguimiento.ningun_commit_nombra_una_tarea_inexistente).
• Que toda tarea cerrada cuente con su commit de cierre (seguimiento.toda_tarea_cerrada_tiene_su_commit_de_cierre).
• Que ningún commit de cierre deje la tarea abierta (seguimiento.ningun_cierre_deja_la_tarea_abierta).