mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-22 22:23:07 +00:00
1 line
3.6 KiB
Markdown
1 line
3.6 KiB
Markdown
**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).
|