Adiciona a CLI pnpm archive:integrity: varredura read-only de todas as archivePhoto (download + decode pelo mesmo caminho da rota pública e do índice facial; sai 1 enquanto houver mídia quebrada approved) e --apply que re-ingere do Flickr pelo flickrId, substitui o objeto na mesma chave via payload.update filePath (sem tocar curadoria/status) e rebaixa a draft as irrecuperáveis (removed intocado). Dono da leitura ganha inspectPrivateMediaObject e isPrivateMediaMissingError (S3 NoSuchKey/404 + ENOENT local; checksum nunca é missing); archivePhotoIngest ganha repairArchivePhotoObject e withdrawArchivePhotoFromPublic; decisão do reparo em scripts/lib/archiveIntegrityRepair.mjs com deps injetadas e puro de CLI/recibo em scripts/lib/archiveIntegrityPlan.mjs. Sem migration, sem UI. Guardas: ARCHIVE_INTEGRITY_CONFIRM + TEQO_ENV exato + 4 S3_* (em qualquer modo no alvo não-local) + FLICKR_API_KEY. Runbook C246, changelog e unit/int/e2e afetado.
2.7 KiB
C246 — Integridade do acervo no Garage: varredura e recuperação das fotos quebradas (2026-10-02): o acervo do C231/C242 ganha o comando pnpm archive:integrity — varredura read-only de TODAS as archivePhoto que baixa cada objeto pelo MESMO caminho da rota pública e do índice facial (o SDK S3 valida o checksum na resposta) e força o decode com sharp: objeto ausente é missing, falha de leitura (checksum) ou arquivo que não decodifica é corrupt com stage/motivo, e a varredura sai 1 enquanto houver mídia quebrada não-removida (critério de convergência) gravando recibo JSON em data/archive/reports/. Com --apply, cada foto acusada é recuperada do Flickr pelo flickrId (mesmo fallback getSizes da ingestão), o original baixado é decodificado como prova, o objeto é substituído na mesma chave pelo caminho de escrita da collection (repairArchivePhotoObject → payload.update + filePath, sem tocar curadoria/metadados/publicationStatus; a foto approved volta a servir sozinha) e o resultado é verificado por uma segunda passada; fonte sumida ou que não decodifica sai do público (approved → draft via withdrawArchivePhotoFromPublic, com purge dos descritores faciais e revalidação pelos hooks; removed nunca é tocado — takedown continua takedown). O dono da leitura privada ganha inspectPrivateMediaObject e o classificador puro isPrivateMediaMissingError (src/lib/privateMedia.ts, S3 NoSuchKey/404 + ENOENT local; checksum nunca é missing); a decisão do reparo é um módulo com deps injetadas (scripts/lib/archiveIntegrityRepair.mjs) e o puro de CLI/recibo em scripts/lib/archiveIntegrityPlan.mjs (--only/--limit/--concurrency 3/--out, map com concorrência limitada, recibos honestos de varredura e reparo). Guardas: --apply exige ARCHIVE_INTEGRITY_CONFIRM=1 + TEQO_ENV casando o nome exato do banco + as 4 S3_* + FLICKR_API_KEY; alvo não-local exige S3 em QUALQUER modo (sem S3 a varredura mediria o storage errado); ALLOW_REMOTE_DB recusado. Sem migration e sem UI (Impeccable A); runbook com canário 80/83, varredura completa, reparo, convergência, cache-bust da tag archivePhotos e lembrete do pnpm faces:index em docs/ops/teqo-1313-deploy.md (C246). Testes: unit do parser/recibo/map com concorrência, das guardas da CLI por spawn, do classificador e das nove decisões do reparo com fakes; int sobre teqo_test do probe ok/missing/corrupt, do reparo preservando filename/curadoria/status/filesize na mesma chave, do downgrade com purge de descritores sem canal e do removed intocado; e2e afetado frontendFotos/frontendFotosSelfie verde. Impl plan: docs/plans/acervo-integridade-garage-impl.md.