BK-47 - Templates de Rollback por Run

Status

• status: concluido
• data: 2026-05-02
• responsavel: codex

Objetivo

Reduzir o risco operacional de jobs executados pelo tools/cli_orchestrator.sh criando, para cada run, artefatos de rollback junto dos backups versionados locais.

Arquivos afetados

• tools/cli_orchestrator.sh
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/LOCK.md
• docs/specs/BK-47-rollback-templates.md
• docs/changelog/2026/CL-2026-05-02-BK-47-rollback-templates.md

Contrato

Cada run do orquestrador passa a gerar:

• backups/: raiz de backups locais da run, ja existente.
• rollback-template.sh: script humano de restauracao, executado em dry-run por padrao.
• rollback-manifest.tsv: manifest com arquivos travados, backup dir e status inicial.

O rollback-template.sh:

• nunca restaura arquivos sem --apply;
• resolve targets repo-relativos contra o REPO_ROOT da run;
• procura o backup mais recente por basename no backup_dir;
• mostra MISSING_BACKUP quando um arquivo travado nao tem snapshot correspondente;
• antes de aplicar restauracao, cria um backup emergencial do estado atual com sufixo rollback_current_YYYYMMDDHHMMSS;
• falha com exit non-zero se --apply for usado e houver backup ausente.

Criterios de aceite

• bash -n tools/cli_orchestrator.sh passa.
• Uma run dry-run cria rollback-template.sh e rollback-manifest.tsv.
• bash -n <run>/rollback-template.sh passa.
• <run>/rollback-template.sh sem --apply apenas lista plano, sem alterar arquivos.

Limites

O script e uma ferramenta de apoio a rollback humano, nao uma autorizacao automatica de restauracao. Aplicacao real exige decisao humana explicita e revisao do diff antes e depois.