Backlog Git Tracker

Flujo: Diff

1. Resolver referencias:
   • Sin flags → último vs penúltimo snapshot
   • --from YYYYMMDD → buscar snapshot con prefijo
   • Índice numérico (-1, -2) → contar desde el más reciente
2. Parsear ambos snapshots: extraer frontmatter + tabla → mapa ID→item
3. Calcular deltas:
   • Añadidos: IDs(to) - IDs(from)
   • Eliminados: IDs(from) - IDs(to)
   • Modificados: IDs(from) ∩ IDs(to) con campos diferentes
4. Para cada modificado, registrar: campo, valor anterior, valor nuevo
5. Calcular métricas: scope change %, re-estimación total Δh
6. Mostrar diff formateado con banner 📊

Flujo: Rollback (solo informe)

1. Cargar snapshot referenciado → parsear items
2. Obtener estado actual (último snapshot o query al PM tool)
3. Generar diff inverso: qué acciones serían necesarias
4. Listar acciones en formato checklist:
   • [ ] Restaurar item #{ID}: "{título}"
   • [ ] Revertir estado de #{ID}: {actual} → {original}
   • [ ] Revertir estimación de #{ID}: {actual}h → {original}h
5. NUNCA ejecutar — solo informar al PM
6. Guardar informe en output/ si se solicita

Flujo: Deviation Report

1. Listar todos los snapshots: ls backlog-snapshots/*.md | sort
2. Parsear serie temporal: para cada snapshot, extraer total, por estado, estimación
3. Calcular métricas acumuladas:
   • Scope creep: (items_final - items_inicial) / items_inicial × 100
   • Re-estimación: Σ deltas de estimación
   • Completion trend: closed/total por snapshot
   • Velocity: items cerrados entre snapshots consecutivos
4. Generar gráfico ASCII de evolución (items totales, cerrados, estimación)
5. Guardar en output/YYYYMMDD-deviation-{client}-{project}.md
6. Mostrar resumen con banner 📈

Snapshot manual

Cuando no hay PM tool conectado:

1. Pedir al PM lista de items (puede ser informal)
2. Estructurar en tabla con IDs secuenciales (M001, M002...)
3. Pedir confirmación antes de guardar
4. Mismo flujo de commit/push

Errores

Seguridad

• Snapshots son append-only: NUNCA modificar uno existente
• NUNCA ejecutar rollback automático — solo informar
• NUNCA incluir tokens o credentials en snapshots
• Confirmar con PM antes de push al remote