2.3 KiB
C195 — Ingestão do pacote do reel na biblioteca privada (2026-09-18): a última milha dos Reels era manual — subir arquivo por arquivo no admin e torcer para não duplicar. Entregou-se o comando pnpm reels:ingest <diretório> (imagem de manutenção, Local API): (1) contrato do pacote no dono src/lib/reel.ts — metadata.json (título, feature contra REEL_FEATURES, shotListHash sha256, alt da capa; duração/data validadas quando presentes e não persistidas), obrigatórios reel.mp4/capa.png/narracao.srt, opcionais reel-audio.mp4/narracao.mp3/roteiro.md (→ transcript), com nomes/mimetypes/alts determinísticos; (2) idempotência por sourceHash — campo novo na collection reel (nullable, único, readOnly; migration aditiva 20260919_002605_add_reel_source_hash aplicada local) e re-ingest atualiza a MESMA entrada e os MESMOS reelMedia (nunca duplica), preservando o kill switch (nunca ressuscita unpublished); (3) writer src/utilities/reels/reelPackageIngest.ts sem user (precedente CLI, createdBy nulo), create/update dos artefatos e do reel na mesma transação, primeira ingestão publica, opcional ausente no pacote não apaga o existente, nome de objeto determinístico (reel-<hash8>-<kind>.<ext>) com overwriteExistingFiles para o re-run sobrescrever o mesmo key; (4) guard fail-closed scripts/lib/reel-ingest.mjs — TEQO_ENV=staging|production obrigatório fora de teste com o nome exato do banco como discriminador (teqo_staging/teqo_1313; o socat mascara o host), ALLOW_REMOTE_DB recusado, test só em teqo*_test, dry-run por padrão e --apply só com REELS_INGEST_CONFIRM=1, S3 completo exigido fora de teste; (5) testes — unit da matriz de guarda/parser/validador do pacote/nomes (17) e int do fluxo real com fixture (create publicado com todos os artefatos e transcript, re-ingest no mesmo reel/media, status preservado, opcional preservado, pacote incompleto sem escrita); (6) runbook no docs/ops/teqo-1313-deploy.md (staging primeiro, bind mount read-only do pacote, produção depois). Sem UI e sem e2e novo (diff de scripts/ não acorda e2e), scripts/lib/reel-ingest.mjs pinado no SCRIPTS_SPEC_PINNED; tensão registrada: o pacote do C196 sozinho (sem .srt) é recusado até o C197, por contrato.