Oracle Task

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.

Web y documentación: https://segtem.github.io/trackertast/

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.

Cambio de nombre

Oracle Task continúa Trackertast. El paquete nuevo es oracle-task, su módulo Python es oracle_task y conserva tasks como alias. Los archivos tareas/, TAREA.md, ids, consultas y hechos no cambian. El repositorio y la URL de la web siguen siendo Segtem/trackertast para conservar los enlaces existentes.

trackertast==0.1.0 permanece disponible para los consumidores publicados, incluido Oracle Factory 0.1.0a1. No se reemplaza ni se borra esa versión. Las importaciones Python nuevas usan oracle_task; el paquete nuevo no instala módulos trackertast, evitando sobrescribir el código del anterior.

Instalación

Requiere Python 3.11 o posterior y no tiene dependencias de runtime. Este corte está preparado en el release de GitHub; el mantenedor hará la publicación PyPI. Después de publicarlo:

uv tool install oracle-task==0.2.0

O desde el repositorio:

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

Migración de una instalación con uv

Después de publicar en PyPI, si tenés Trackertast instalado como herramienta, reemplazá su instalación para evitar que ambos reclamen el ejecutable tasks:

uv tool uninstall trackertast
uv tool install oracle-task==0.2.0
oracle-task --version
tasks --version

Esto cambia la herramienta instalada, no borra los directorios de tareas de tus proyectos. Evitá instalar ambos paquetes en el mismo entorno pip: aunque los módulos son distintos, comparten el ejecutable tasks. Los consumidores que fijan Trackertast deben actualizar su dependencia en su propia próxima versión.

Para probar antes de PyPI, podés instalar el wheel del release v0.2.0.

Comandos y ejemplos

El comando principal es oracle-task; tasks se conserva como alias con los mismos verbos y formatos. 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

oracle-task 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).