mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-22 04:53:09 +00:00
style(C218): plano de implementação e spec no formato do prettier
This commit is contained in:
parent
9c0b44a2c0
commit
cdd188755c
2 changed files with 49 additions and 26 deletions
|
|
@ -62,20 +62,28 @@ Formato (pinado pelo spec):
|
||||||
"pending": [
|
"pending": [
|
||||||
{
|
{
|
||||||
"sourceKey": "web:youtube:abc123",
|
"sourceKey": "web:youtube:abc123",
|
||||||
"finding": { "platform": "youtube", "url": "https://www.youtube.com/watch?v=abc123", "publishedAt": "2026-09-12" },
|
"finding": {
|
||||||
|
"platform": "youtube",
|
||||||
|
"url": "https://www.youtube.com/watch?v=abc123",
|
||||||
|
"publishedAt": "2026-09-12",
|
||||||
|
},
|
||||||
"reason": "download: HTTP 403",
|
"reason": "download: HTTP 403",
|
||||||
"attempts": 1,
|
"attempts": 1,
|
||||||
"addedAt": "2026-09-24T18:07:12.000Z"
|
"addedAt": "2026-09-24T18:07:12.000Z",
|
||||||
}
|
},
|
||||||
],
|
],
|
||||||
"review": [
|
"review": [
|
||||||
{
|
{
|
||||||
"sourceKey": "web:instagram:xyz",
|
"sourceKey": "web:instagram:xyz",
|
||||||
"finding": { "platform": "instagram", "url": "https://www.instagram.com/reel/xyz/", "publishedAt": "2026-09-10" },
|
"finding": {
|
||||||
|
"platform": "instagram",
|
||||||
|
"url": "https://www.instagram.com/reel/xyz/",
|
||||||
|
"publishedAt": "2026-09-10",
|
||||||
|
},
|
||||||
"reason": "não confirmado como fala do titular (compilado de terceiro)",
|
"reason": "não confirmado como fala do titular (compilado de terceiro)",
|
||||||
"flaggedAt": "2026-09-24T18:07:12.000Z"
|
"flaggedAt": "2026-09-24T18:07:12.000Z",
|
||||||
}
|
},
|
||||||
]
|
],
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -93,15 +101,35 @@ Contrato do artefato `data/falas-web/discovery-<stamp>.json` (stamp no mesmo sha
|
||||||
```jsonc
|
```jsonc
|
||||||
{
|
{
|
||||||
"generatedAt": "2026-09-24T18:00:00.000Z",
|
"generatedAt": "2026-09-24T18:00:00.000Z",
|
||||||
"window": { "from": "2026-09-01T00:00:00.000Z", "to": "2026-09-24T18:00:00.000Z", "initial": false },
|
"window": {
|
||||||
|
"from": "2026-09-01T00:00:00.000Z",
|
||||||
|
"to": "2026-09-24T18:00:00.000Z",
|
||||||
|
"initial": false,
|
||||||
|
},
|
||||||
"queries": ["\"Jorge Solla\" after:2026-09-01", "site:youtube.com \"Jorge Solla\"", "..."],
|
"queries": ["\"Jorge Solla\" after:2026-09-01", "site:youtube.com \"Jorge Solla\"", "..."],
|
||||||
"findings": [
|
"findings": [
|
||||||
{ "platform": "youtube", "url": "https://www.youtube.com/watch?v=abc123", "externalId": "abc123", "publishedAt": "2026-09-12", "title": "…", "channel": "…" }
|
{
|
||||||
|
"platform": "youtube",
|
||||||
|
"url": "https://www.youtube.com/watch?v=abc123",
|
||||||
|
"externalId": "abc123",
|
||||||
|
"publishedAt": "2026-09-12",
|
||||||
|
"title": "…",
|
||||||
|
"channel": "…",
|
||||||
|
},
|
||||||
],
|
],
|
||||||
"review": [
|
"review": [
|
||||||
{ "finding": { "platform": "instagram", "url": "https://www.instagram.com/p/xyz/", "publishedAt": "2026-09-10" }, "reason": "…" }
|
{
|
||||||
|
"finding": {
|
||||||
|
"platform": "instagram",
|
||||||
|
"url": "https://www.instagram.com/p/xyz/",
|
||||||
|
"publishedAt": "2026-09-10",
|
||||||
|
},
|
||||||
|
"reason": "…",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
"notes": [
|
||||||
|
"limites declarados: rádio sem arquivo direto não virou finding; Instagram fora da janela descartado",
|
||||||
],
|
],
|
||||||
"notes": ["limites declarados: rádio sem arquivo direto não virou finding; Instagram fora da janela descartado"]
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -255,14 +283,13 @@ Perde 0,5 porque duas pontas são declaradamente probabilísticas/externas em ve
|
||||||
|
|
||||||
Dois revisores em paralelo (estrutural + qualidade). **17 achados corrigidos na sessão** (não reabrir): `invalid`/`duplicates` não podem virar `review` (o C215 só reporta duplicata; a skill para, não avança o watermark e relata os ofensores), fronteira de escrita da curadoria (dúvida vai para `review` do estado; o artefato segue com um escritor só), ler o artefato do disco sem pedir o corpo ao subagente, ciclo explícito de `pending` (`sourceKey` opcional vindo do `plannedEntries`; cauda de `--limit` não vira pending), `--limit` igual no dry-run e no import, exceção do lote vazio no recibo, regras de preenchimento do recibo por modo (`aprovar`/`descartar`/exit 1), recuperação da cauda órfã no Troubleshooting, numeração de `aprovar`/`descartar`, `descartar` com o motivo do item, `to = agora` no despacho da descoberta, `lastStateAt` no lugar de `lastSuccessfulAt`, pinos do envelope do lote (`{ generatedAt, findings }`/`batch-<stamp>.json`), do watermark (`lastRunAt` = `window.to`), do dry-run obrigatório e da **negação** de `FALAS_WEB_IMPORT_CONFIRM`.
|
Dois revisores em paralelo (estrutural + qualidade). **17 achados corrigidos na sessão** (não reabrir): `invalid`/`duplicates` não podem virar `review` (o C215 só reporta duplicata; a skill para, não avança o watermark e relata os ofensores), fronteira de escrita da curadoria (dúvida vai para `review` do estado; o artefato segue com um escritor só), ler o artefato do disco sem pedir o corpo ao subagente, ciclo explícito de `pending` (`sourceKey` opcional vindo do `plannedEntries`; cauda de `--limit` não vira pending), `--limit` igual no dry-run e no import, exceção do lote vazio no recibo, regras de preenchimento do recibo por modo (`aprovar`/`descartar`/exit 1), recuperação da cauda órfã no Troubleshooting, numeração de `aprovar`/`descartar`, `descartar` com o motivo do item, `to = agora` no despacho da descoberta, `lastStateAt` no lugar de `lastSuccessfulAt`, pinos do envelope do lote (`{ generatedAt, findings }`/`batch-<stamp>.json`), do watermark (`lastRunAt` = `window.to`), do dry-run obrigatório e da **negação** de `FALAS_WEB_IMPORT_CONFIRM`.
|
||||||
|
|
||||||
| ID | Resumo | Origem | Score | Tipo | Destino |
|
| ID | Resumo | Origem | Score | Tipo | Destino |
|
||||||
| --- | ----------------------------------------------------------------- | ----------------- | ----- | ------------ | -------------------------------------------------------------- |
|
| --- | ------------------------------------------------------ | ------------------- | ----- | ------------ | ------------------------------------------------------------------ |
|
||||||
| S1 | Pinso fracos de prosa (`gitignored`, `Exit 0/1`) | simplify estrutural | 1 | cheap_polish | descartar (contratos reais têm regex próprio) |
|
| S1 | Pinso fracos de prosa (`gitignored`, `Exit 0/1`) | simplify estrutural | 1 | cheap_polish | descartar (contratos reais têm regex próprio) |
|
||||||
| S2 | `mediaUrl` de rádio/áudio repetido em 3 camadas | simplify estrutural | 1 | cheap_polish | descartar (redundância intencional de prompt; spec pina no agente) |
|
| S2 | `mediaUrl` de rádio/áudio repetido em 3 camadas | simplify estrutural | 1 | cheap_polish | descartar (redundância intencional de prompt; spec pina no agente) |
|
||||||
| S3 | Spec re-pina coupling comando↔skill | simplify estrutural | 1 | cheap_polish | descartar (precedente dos specs por skill) |
|
| S3 | Spec re-pina coupling comando↔skill | simplify estrutural | 1 | cheap_polish | descartar (precedente dos specs por skill) |
|
||||||
| Q1 | Pinos literais de markdown sensíveis a edição de prosa | simplify qualidade | 1 | cheap_polish | descartar (deliberado, como nos precedentes) |
|
| Q1 | Pinos literais de markdown sensíveis a edição de prosa | simplify qualidade | 1 | cheap_polish | descartar (deliberado, como nos precedentes) |
|
||||||
| Q2 | "revisar" (modo) vs `review` (bucket) | simplify qualidade | 1 | cheap_polish | descartar (argumento pt-BR, chave JSON em inglês) |
|
| Q2 | "revisar" (modo) vs `review` (bucket) | simplify qualidade | 1 | cheap_polish | descartar (argumento pt-BR, chave JSON em inglês) |
|
||||||
| Q3 | Título do agente em minúscula | simplify qualidade | 1 | cheap_polish | corrigido na sessão |
|
| Q3 | Título do agente em minúscula | simplify qualidade | 1 | cheap_polish | corrigido na sessão |
|
||||||
|
|
||||||
Veredito do modo autônomo (`--auto`): **0 Issues registradas** — nenhum resto alcança o piso (score ≥3 / expensive_lock ≥4); os descartes são polimento de prosa/spec deliberado. Fechamento: 23 achados → 17 corrigidos na sessão, 6 descartados.
|
Veredito do modo autônomo (`--auto`): **0 Issues registradas** — nenhum resto alcança o piso (score ≥3 / expensive_lock ≥4); os descartes são polimento de prosa/spec deliberado. Fechamento: 23 achados → 17 corrigidos na sessão, 6 descartados.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -80,17 +80,13 @@ describe('curation, watermark and retry', () => {
|
||||||
/não é ingerido até confirmação/,
|
/não é ingerido até confirmação/,
|
||||||
)
|
)
|
||||||
expect(skill, 'curation demotes to the state review list').toMatch(/não inclua\s+no lote/)
|
expect(skill, 'curation demotes to the state review list').toMatch(/não inclua\s+no lote/)
|
||||||
expect(skill, 'approval does not move the watermark').toMatch(
|
expect(skill, 'approval does not move the watermark').toMatch(/`lastRunAt` \*\*não\*\* muda/)
|
||||||
/`lastRunAt` \*\*não\*\* muda/,
|
|
||||||
)
|
|
||||||
})
|
})
|
||||||
|
|
||||||
it('pins the watermark semantics and the pending retry', () => {
|
it('pins the watermark semantics and the pending retry', () => {
|
||||||
expect(skill).toContain('Exit 0')
|
expect(skill).toContain('Exit 0')
|
||||||
expect(skill).toContain('Exit 1')
|
expect(skill).toContain('Exit 1')
|
||||||
expect(skill, 'exit 1 must not advance the window').toMatch(
|
expect(skill, 'exit 1 must not advance the window').toMatch(/`lastRunAt` \*\*não\*\* avança/)
|
||||||
/`lastRunAt` \*\*não\*\* avança/,
|
|
||||||
)
|
|
||||||
expect(skill, 'retries carry the attempt count').toContain('attempts')
|
expect(skill, 'retries carry the attempt count').toContain('attempts')
|
||||||
expect(skill, 'pending is retried first').toMatch(/vão primeiro no próximo lote/)
|
expect(skill, 'pending is retried first').toMatch(/vão primeiro no próximo lote/)
|
||||||
expect(skill, 'the --limit tail stays in the batch').toMatch(/restam M−N achados no lote/)
|
expect(skill, 'the --limit tail stays in the batch').toMatch(/restam M−N achados no lote/)
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue