teqo-backup/docs/changelog/2026-09-24-c218.md

3.6 KiB
Raw Blame History

C218 — Skill catalogo-falas-web: atualização incremental do catálogo (2026-09-24): a atualização do catálogo de falas vira operação repetível e manual: /catalogo-falas-web lê a data da última execução em data/falas-web/last-run.json (gitignored — o único estado novo da entrega: watermark lastRunAt, pending de retry e review de curadoria; sem ele, varredura inicial completa), dispara a descoberta por subagente (.opencode/agent/catalogo-falas-web.md), que pesquisa as plataformas do C215 na janela, escreve o artefato datado data/falas-web/discovery-<stamp>.json (generatedAt/window/queries/findings/review/notes) e devolve só o recibo curto. O orquestrador audita, cura (falso positivo vira review e não ingere até confirmação; revisar/aprovar/descartar no $ARGUMENTS, com aprovar congelando o watermark), monta o lote no contrato exato do C215 ({ generatedAt, findings }, pending primeiro), planeja com --dry-run (exige invalid/duplicates = 0 e dá o sourceKey por ordem do lote), ingere com pnpm falas-web:import --findings, lê o JSON do report e imprime o recibo literal (período, achados, revisar, novos, atualizados, ignorados, inválidos, duplicados, falhas com motivo, custo/tempo), gravando o estado por último com escrita atômica. Exit 0 (total/parcial) avança lastRunAt para o window.to da descoberta; exit 1/sem report não avança e devolve o lote a pending (a rodada seguinte recobre a mesma janela); lote vazio (sem achados e sem pendências) pula o CLI e ainda avança; --limit deixa a cauda no próprio lote com o recibo dizendo como terminá-la. Fronteira explícita: a skill não baixa, não transcreve, não classifica facetas, não espelha nem deduplica (donos do C215), não lê o banco e nunca exporta FALAS_WEB_IMPORT_CONFIRM; sem schema/migration/collection/access, sem UI. Entrega: .agents/skills/catalogo-falas-web/SKILL.md (fonte canônica), .opencode/commands/catalogo-falas-web.md (wrapper fino) e .opencode/agent/catalogo-falas-web.md (descoberta, mode: subagent sem pin de modelo), com os contratos pinados em tests/unit/catalogoFalasWebSkill.unit.spec.ts e o coupling comando↔skill em tests/unit/opencodeCommands.unit.spec.ts. Verificação: o tracer (--dry-run de um lote fake contra o banco local do worktree) validou envelope, CLI e leitura do report; o smoke de rede (janela 01–24/09, queries pelo nome, Instagram sem login e rádio sem mediaUrl declarados em notes) escreveu o artefato real com 18 findings/8 review e o dry-run do lote deu 18 considerados, 0 inválidos e 0 duplicados. A rodada real com download/ASR é do operador (P2). Desvios registrados no *-impl.md (cauda do --limit fica no lote em vez de pending; dry-run é passo obrigatório de planejamento; sourceKey opcional no estado e lastStateAt no carimbo). No /simplify (2 revisores em paralelo), 17 achados corrigidos na sessão — regras de preenchimento do recibo por modo, ciclo de pending/review, falha de planejamento sem avanço de watermark, pinos do envelope do lote e do watermark — e 0 débitos registrados (6 descartes de prosa/spec na triage do *-impl.md). O PR também destrava o main: o commit do plano S40 (2515e86b) sobrescreveu o asset aprovado do modelo do estadual (docs/plans/cards-estadual-dobradinha-ui-design-assets/…, sha 1f5dc821) sem copiar os bytes para public/cards/modelo-time-de-voce-com-estadual.jpeg (ainda 7fc8a50a), deixando vermelho o pino stateDeputyCatalog.unit.spec.ts; a cópia byte-a-byte da arte aprovada entra aqui (o restante do S40 — remoção da silhueta desenhada e pins de render/e2e — segue com a Issue #1316).