@payconductor/houndsman 0.4.0 → 0.5.0

package/src/server/index.ts

@@ -315,7 +315,7 @@ code, pre, .mono { font-family:var(--font-mono); tab-size:4; }
 .btn:disabled { opacity:.55; cursor:not-allowed; }
 .icon.spin { animation:spin .8s linear infinite; }
 .content { width:100%; max-width:1180px; margin:0 auto; padding:22px 24px 64px; }
-.page-header { display:flex; align-items:flex-start; justify-content:space-between; gap:18px; }
+.page-header { display:flex; align-items:flex-start; justify-content:space-between; gap:18px; margin-bottom:16px; }
 .page-header-text { min-width:0; }
 .page-header-actions { display:flex; align-items:center; gap:10px; flex:none; }
 .btn.submit-review { color:#1b1305; background:linear-gradient(180deg, var(--accent-strong), var(--accent)); border-color:transparent; box-shadow:0 4px 14px rgba(240,165,44,.22); }
@@ -412,12 +412,25 @@ code, pre, .mono { font-family:var(--font-mono); tab-size:4; }
 .action-text p:last-child { margin-bottom:0; }
 .md-list { margin:0 0 6px; padding-left:20px; font-size:13px; line-height:1.65; color:#f0ece6; }
 .md-list li { margin:0 0 2px; }
-.md-quote { margin:0 0 6px; padding:2px 0 2px 10px; border-left:2px solid var(--accent-line); color:var(--muted); font-size:13px; line-height:1.65; }
+.md-quote { margin:0 0 6px; padding:2px 0 2px 10px; border-left:2px solid var(--accent-line); color:var(--muted); font-size:13px; line-height:1.65; white-space:pre-wrap; }
 .action-text code, .md-code { font-family:var(--font-mono); font-size:11.5px; padding:1px 5px; color:#f0ece6; background:rgba(255,255,255,.06); border:1px solid var(--border); border-radius:5px; }
-.action-text a { color:var(--accent-strong); text-decoration:underline; text-underline-offset:2px; }
-.action-text strong { color:#fff; font-weight:600; }
-.action-text em { color:#e9e4dc; }
+code.md-path { color:#8fc7ff; background:rgba(90,164,240,.1); border-color:rgba(90,164,240,.24); }
+.action-text a, .md-p a, .md-list a, .md-quote a, .md-table a, .md-h a { color:var(--accent-strong); text-decoration:underline; text-underline-offset:2px; }
+.action-text strong, .md-p strong, .md-list strong, .md-quote strong, .md-table strong, .md-h strong { color:#fff; font-weight:600; }
+.action-text em, .md-p em, .md-list em, .md-quote em, .md-table em, .md-h em { color:#e9e4dc; }
 .md-code-block { margin:6px 0; padding:10px 12px; max-height:320px; overflow:auto; white-space:pre; font-size:11.5px; line-height:1.6; color:#cdc7bf; background:#0b0b0e; border-radius:10px; }
+.md-h { margin:16px 0 8px; font-size:14px; font-weight:700; line-height:1.35; letter-spacing:-.01em; color:#eee9e2; }
+.md-h:first-child { margin-top:0; }
+.md-h1 { font-size:19px; }
+.md-h2 { font-size:16px; }
+.md-h3 { font-size:14px; }
+.md-h4, .md-h5, .md-h6 { font-size:13px; color:#e4dfd7; font-weight:600; }
+.md-hr { margin:14px 0; border:0; border-top:1px solid var(--border); }
+.md-table-wrap { margin:8px 0 12px; padding:4px; overflow-x:auto; border:1px solid rgba(255,255,255,.07); border-radius:10px; background:rgba(255,255,255,.012); }
+.md-table { width:100%; border-collapse:separate; border-spacing:3px; font-size:12px; line-height:1.5; }
+.md-table th, .md-table td { padding:6px 9px; text-align:left; vertical-align:top; border:1px solid rgba(255,255,255,.035); border-radius:6px; }
+.md-table th { color:var(--muted); font-weight:600; background:rgba(255,255,255,.03); }
+.md-table td { color:#d8d3cc; }
 .decision-tags-block { display:flex; align-items:center; gap:8px; }
 .evidence { margin:0; padding: 16px; white-space:break-spaces; font-size:12px; line-height:1.6; color:#cdc7bf;
   background:#0b0b0e; border:1px solid var(--border); border-radius:var(--radius); }
@@ -476,6 +489,10 @@ code, pre, .mono { font-family:var(--font-mono); tab-size:4; }
   border:1px solid var(--accent-line); border-radius:999px; }
 .artifact-view { margin:0; padding:14px 16px; max-height:70vh; overflow:auto; font-size:12px; line-height:1.6; color:#cdc7bf;
   background:#0b0b0e; border:1px solid var(--border); border-radius:var(--radius); }
+.artifact-markdown { white-space:normal; }
+.artifact-markdown .md-p, .artifact-markdown .md-list, .artifact-markdown .md-quote { font-size:12.5px; }
+.artifact-markdown .md-p, .artifact-markdown .md-list { color:#d8d3cc; }
+.artifact-markdown .md-code-block { border:1px solid var(--border); }
 .json-view { white-space:pre; }
 .json-key { color:var(--accent-strong); }
 .json-string { color:#9ddc8a; }
@@ -486,6 +503,47 @@ code, pre, .mono { font-family:var(--font-mono); tab-size:4; }
 .sent-tag { display:inline-flex; align-items:center; gap:5px; padding:2px 8px; font-size:10px; font-weight:700; letter-spacing:.06em; text-transform:uppercase;
   color:var(--success); background:rgba(69,192,122,.12); border:1px solid rgba(69,192,122,.32); border-radius:999px; text-decoration:none; }
 .sent-tag:hover { color:#fff; }
+.sent-tag.gh { color:#b9c7d6; background:rgba(139,164,191,.12); border-color:rgba(139,164,191,.35); }
+.sent-tag.gh:hover { color:#fff; background:rgba(139,164,191,.2); }
+.resume { display:flex; flex-direction:column; }
+.resume-hero { display:flex; align-items:flex-start; justify-content:space-between; gap:16px; padding:18px 20px;
+  background:linear-gradient(135deg, rgba(240,165,44,.08), rgba(255,255,255,.015) 55%);
+  border:1px solid var(--border); border-radius:var(--radius-lg); }
+.resume-kicker { display:block; font-size:10px; font-weight:700; letter-spacing:.14em; text-transform:uppercase; color:var(--accent); }
+.resume-title { margin:5px 0 7px; font-size:22px; font-weight:700; letter-spacing:-.02em; word-break:break-word; }
+.resume-meta { display:flex; flex-wrap:wrap; align-items:center; gap:12px; margin:0; font-size:12px; color:var(--muted); }
+.resume-pr { display:inline-flex; align-items:center; gap:5px; color:var(--accent-strong); text-decoration:none; }
+.resume-pr:hover { text-decoration:underline; }
+.resume-hero-side { display:flex; flex:none; flex-direction:column; align-items:flex-end; gap:10px; }
+.resume-status { display:inline-flex; align-items:center; padding:5px 12px; font-size:11px; font-weight:700; letter-spacing:.04em; border-radius:999px; }
+.resume-status.blocking { color:var(--blocking); background:rgba(242,89,94,.12); border:1px solid rgba(242,89,94,.35); }
+.resume-status.attention { color:var(--attention); background:rgba(237,161,58,.12); border:1px solid rgba(237,161,58,.35); }
+.resume-status.clean { color:var(--success); background:rgba(69,192,122,.12); border:1px solid rgba(69,192,122,.35); }
+.resume-kpis { margin:14px 0 18px; }
+.resume-kpis .kpi-value { font-size:24px; }
+.churn-add { color:var(--success); }
+.churn-del { color:var(--blocking); }
+.churn-sep { margin:0 3px; color:var(--muted-2); font-weight:400; }
+.kpi-blocking .kpi-value { color:var(--blocking); }
+.kpi-attention .kpi-value { color:var(--attention); }
+.kpi-total .kpi-value { color:var(--fg); }
+.resume-grid { display:grid; grid-template-columns:minmax(0,1.35fr) minmax(0,1fr); gap:16px; align-items:start; }
+.resume-card { min-width:0; padding:16px 18px; background:var(--card); border:1px solid var(--border); border-radius:var(--radius-lg); }
+.resume-card-head { display:flex; align-items:center; justify-content:space-between; gap:10px; }
+.resume-card-title { margin:0 0 10px; font-size:12px; font-weight:700; letter-spacing:.1em; text-transform:uppercase; color:var(--muted); }
+.resume-card-count { display:inline-flex; align-items:center; justify-content:center; min-width:22px; height:22px; margin-bottom:10px; padding:0 7px;
+  font-family:var(--font-mono); font-size:11px; color:var(--accent); background:var(--accent-soft); border:1px solid var(--accent-line); border-radius:999px; }
+.resume-narrative .md-p:last-child { margin-bottom:0; }
+.resume-domains { display:flex; flex-direction:column; gap:8px; margin:0; padding:0; list-style:none; }
+.resume-domain { display:flex; flex-direction:column; gap:7px; padding:10px 12px; background:var(--surface-2);
+  border:1px solid var(--border); border-radius:10px; }
+.resume-domain-head { display:flex; align-items:baseline; justify-content:space-between; gap:10px; }
+.resume-domain-name { font-size:12.5px; font-weight:600; color:var(--fg); }
+.resume-domain-files { flex:none; font-family:var(--font-mono); font-size:10.5px; color:var(--muted-2); }
+.resume-domain-sev { display:flex; flex-wrap:wrap; gap:6px; }
+.resume-domain-sev .sev-badge { padding:2px 7px; font-size:9.5px; }
+.resume-domain-ok { font-size:11.5px; color:var(--success); }
+@media (max-width:900px) { .resume-grid { grid-template-columns:1fr; } .resume-hero { flex-direction:column; } .resume-hero-side { flex-direction:row; align-items:flex-start; } }
 .modal-layer { position:fixed; inset:0; z-index:50; display:grid; place-items:center; padding:24px; }
 .modal-backdrop { position:absolute; inset:0; width:100%; padding:0; background:rgba(5,5,7,.66); border:0; cursor:default; backdrop-filter:blur(5px); -webkit-backdrop-filter:blur(5px); }
 .modal { position:relative; width:min(640px, 100%); max-height:min(78vh, 780px); display:flex; flex-direction:column; overflow:hidden;

package/src/server/run-repository.ts

@@ -30,6 +30,7 @@ import {
 	resolvePrTarget,
 	type SubmitSelection,
 	submitFindings,
+	syncResolvedThreads,
 } from "../core/github-review";
 import { pingFindingsStatus } from "../core/run-status";
 import { systemClock } from "../core/services/clock";
@@ -42,6 +43,8 @@ export type RunListItem = {
 	slug: string;
 	branch: string;
 	updatedAt?: string;
+	startedAt?: string;
+	heartbeatAt?: string;
 	status: ReviewRecord["status"];
 	summary: FindingsSummary;
 };
@@ -94,6 +97,8 @@ export class RunRepository {
 				slug: review.slug,
 				branch: review.branch,
 				updatedAt: review.updatedAt,
+				startedAt: review.startedAt,
+				heartbeatAt: review.heartbeatAt,
 				status: review.status,
 				summary: summarize(state ?? emptyState(review.branch)),
 			};
@@ -211,6 +216,10 @@ export class RunRepository {
 		if (resolution.status !== "found") return null;
 		const finding = state.findings[resolution.id];
 		applyFindingUpdate(finding, body);
+		// "Done" na UI é resolução local: resolve a conversa no PR (fail-open).
+		if (body.execState === "done") {
+			syncResolvedThreads({ state, ids: [finding.id] });
+		}
 		reorder(state);
 		state.updatedAt = systemClock();
 		this.storage.writeFindings(review.id, state);

package/src/skill/example-review.md

@@ -14,6 +14,28 @@
 - Novo endpoint interno para reprocessar eventos manualmente.
 - Registro de tentativas no handler de envio.
 
+## Relatórios por domínio
+
+| Watchdog | Achados | Revisados | Relatório |
+|---|---|---|---|
+| Arquitetura Backend | 2 | 3/3 | [`review.backend-architecture.md`](review.backend-architecture.md) |
+| Pagamentos & Integrações | 1 | 4/4 | [`review.payments-integrations.md`](review.payments-integrations.md) |
+| Acquirer Integrations | 2 | 3/4 | [`review.acquirer-integrations.md`](review.acquirer-integrations.md) |
+
+## Cobertura
+
+| Watchdog | Arquivos revisados | Findings |
+|---|---|---|
+| API & Contratos | 2 | 0 |
+| Arquitetura Backend | 3 | 2 |
+| Pagamentos & Integrações | 4 | 1 |
+| Acquirer Integrations | 3/4 (faltam 1) | 2 |
+
+## Conclusão
+
+**Status:** ❌ Mudanças Necessárias
+**Resumo:** 2 violações bloqueantes, 1 ponto de atenção, 1 sugestão e 1 nit.
+
 ## ❌ blocking
 
 - **Webhook handler sem verifySignature** — `server/src/services/integrations/acquirer/webhook/handle-charge-event.ts:15` · _Acquirer Integrations, Pagamentos & Integrações_
@@ -42,17 +64,3 @@
 - **Ordem de membros** — `server/src/services/webhook/webhook-retry-service.ts:12` · _Arquitetura Backend_
   Campo privado declarado antes do construtor público.
   **Ação:** Reordenar membros (públicos primeiro).
-
-## Cobertura
-
-| Watchdog | Arquivos revisados | Findings |
-|---|---|---|
-| API & Contratos | 2 | 0 |
-| Arquitetura Backend | 3 | 1 |
-| Pagamentos & Integrações | 4 | 2 |
-| Acquirer Integrations | 3/4 (faltam 1) | 2 |
-
-## Conclusão
-
-**Status:** ❌ Mudanças Necessárias
-**Resumo:** 2 violações bloqueantes, 1 ponto de atenção, 1 sugestão.

package/src/skill/hunt.md

@@ -122,11 +122,14 @@ arquivos alterados desde a última revisão — e **carrega** os findings dos ar
 (carry-over), sem re-revisá-los. O `manifest.json` traz o bloco `incremental` (`from`,
 `changedFiles`, `carried`) e o `review.md` abre com um aviso.
 
-- Sem mudanças desde a última revisão → **no-op** (nada a revisar; o estado é preservado).
+- Sem mudanças desde a última revisão → **no-op**: o prepare não gera briefs nem reescreve
+  artefatos (classification, manifest, review.md), e o `--finalize` também vira no-op — pare o
+  fluxo aí (nenhum subagente é despachado).
 - Rebase/force-push (histórico reescrito) → cai automaticamente no **review completo**.
 - Forçar completo: `houndsman --full` (ou `--clean`, que também descarta a triagem anterior).
 
 > Custo: o LLM só é gasto nos arquivos que mudaram desde a última revisão — não na PR inteira.
+> Re-rodar `/houndsman` no mesmo commit **não** re-revisa a PR; use `--full` para isso.
 
 ---
 
@@ -135,6 +138,10 @@ arquivos alterados desde a última revisão — e **carrega** os findings dos ar
 Um subagente por brief. Despache em **ondas** (ex.: até 8 subagentes por bloco de tool
 calls) — evita estourar limites de taxa quando há muitos watchdogs. O prompt é o próprio brief:
 
+> **Heartbeat:** antes de despachar cada onda, rode `houndsman status ping`. A UI usa esse
+> sinal (e não `updatedAt`) para saber que a execução está viva; sem ping por 10 min ela
+> mostra "Timeout na revisão".
+
 ```
 Leia e execute o brief: <caminho absoluto impresso pelo prepare>/briefs/<watchdog-id>.md
 Você é o watchdog <watchdog-id> do {{projectName}}.
@@ -158,15 +165,18 @@ houndsman --finalize
 Falha com mensagem clara se faltar algum `findings/<watchdog>.json` no staging. Quando todos existem:
 1. Valida o schema de cada JSON
 2. Deduplica achados por `(file, line, rule)` mesclando watchdogs sobrepostos
-3. Agrupa por severidade: ❌ blocking > ⚠️ attention > 💡 suggestion > 🔎 nit
-4. Grava o artefato `review.md` no storage + tabela de cobertura
-5. Anexa os candidatos Jev não confirmados em `🔎 Candidatos não verificados` (não bloqueiam)
-6. Agrupa os achados **por arquivo** dentro de cada severidade (navegabilidade em PRs grandes)
-7. Grava um `review.<watchdog>.md` por watchdog com achados e indexa no `review.md`
+3. Grava um `review.<watchdog>.md` por watchdog com achados e indexa no `review.md`
    (**Relatórios por domínio**) — mantém o relatório consolidado enxuto
-8. Persiste a **triagem** no storage — um `id` curto e um `fingerprint` de conteúdo por
-   finding, preservados entre execuções
-
+4. Grava o `review.md` abrindo pelo **sumário**: contexto, relatórios por domínio, cobertura e
+   conclusão — antes dos achados
+5. Agrupa os achados por severidade (❌ blocking > ⚠️ attention > 💡 suggestion > 🔎 nit) e
+   **por arquivo** dentro de cada severidade (navegabilidade em PRs grandes)
+6. Anexa os candidatos Jev não confirmados em `🔎 Candidatos não verificados` ao final
+   (não bloqueiam)
+7. Persiste a **triagem** no storage — um `id` curto e um `fingerprint` de conteúdo por
+   finding, preservados entre execuções9. Marca como **`done`** os findings que sumiram do relatório (corrigidos manualmente entre
+   revisões) e **resolve as conversas correspondentes no GitHub** — só as ainda abertas, e
+   falha-aberto (sem `gh`/PR o relatório segue igual)
 Após finalizar, corrija os achados com a capability **`fix`** (`fix.md`): a UI ou os
 comandos `findings` levam do achado à correção.
 
@@ -188,14 +198,6 @@ comandos `findings` levam do achado à correção.
 **Resumo das alterações:**
 - ...
 
-## ❌ blocking
-### `src/routes/order-route.ts`
-- **<regra>** — `src/routes/order-route.ts:5` · _<watchdogs>_
-  <mensagem>
-  **Ação:** <ação>
-
-## 🔎 Candidatos não verificados (Jev)   ← se houver
-
 ## Relatórios por domínio
 | Watchdog | Achados | Revisados | Relatório |
 |---|---|---|---|
@@ -206,8 +208,19 @@ comandos `findings` levam do achado à correção.
 
 ## Conclusão
 **Status:** ✅ Aprovado / ⚠️ Aprovado com Ressalvas / ❌ Mudanças Necessárias
+
+## ❌ blocking
+### `src/routes/order-route.ts`
+- **<regra>** — `src/routes/order-route.ts:5` · _<watchdogs>_
+  <mensagem>
+  **Ação:** <ação>
+
+## 🔎 Candidatos não verificados (Jev)   ← se houver, sempre ao final
 ```
 
+> O **sumário** (relatórios por domínio, cobertura e conclusão) vem **antes** dos achados;
+> os pontos específicos ficam no fim.
+
 ---
 
 ## Fluxo Completo
@@ -246,6 +259,7 @@ Se a branch não for informada, detecta com `git branch --show-current`. Base do
 |---|---|
 | `houndsman context` | Passo 0 — contexto da PR via `gh` |
 | `houndsman` | Passo 1 — preparar (briefs + manifesto; incremental quando possível) |
+| `houndsman status ping` | Passo 2 — heartbeat da execução (antes de cada onda) |
 | `houndsman --finalize` | Passo 3 — gerar o relatório |
 | `houndsman watchdog <id>` | Contexto de um watchdog (`--json`, `--rules`) |
 

package/src/skill/verify.md

@@ -43,7 +43,8 @@ bun run houndsman findings verify --apply    # marca os resolvidos como done (pi
 
 - Sem `--apply`: **só relatório** (grava o artefato `verify.md` no storage). Nada muda na triagem.
 - Com `--apply`: os findings com status **`resolved`** viram `execState: done` (histórico
-  `by: "verify"`). `persisting` e `uncertain` **não** são tocados.
+  `by: "verify"`) e a **thread correspondente é resolvida no GitHub** (quando há comentário e a
+  conversa ainda está aberta; fail-open). `persisting` e `uncertain` **não** são tocados.
 
 Filtros (como no `findings list`): `--severity`, `--watchdog`, `--file`, `--decision`. `--all`
 inclui ausentes. `--no-jev` desliga o tier LLM. `--fail-on-persisting` sai com código 1 se algum

package/src/tests/__snapshots__/baseline.test.ts.snap

@@ -88,23 +88,6 @@ exports[`baseline — relatório renderReport consolidado 1`] = `
 - Faz A
 - Remove B
 
-## ❌ blocking
-
-### \`src/alpha/a.ts\`
-
-- **Nunca usar \`any\`.** — \`src/alpha/a.ts:1\` · _Alpha_ · \`id-alpha\`
-  any detectado
-  **Ação:** tipar
-  **Evidência:** \`export const a: any = 1;\`
-
-## ⚠️ attention
-
-### \`src/alpha/b.ts\`
-
-- **Promover: validar a entrada.** — \`src/alpha/b.ts:2\` · _Alpha, Beta_ · \`id-beta\`
-  sem validação
-  **Ação:** adicionar schema
-
 ## Relatórios por domínio
 
 | Watchdog | Achados | Revisados | Relatório |
@@ -121,7 +104,25 @@ exports[`baseline — relatório renderReport consolidado 1`] = `
 ## Conclusão
 
 **Status:** ❌ Mudanças Necessárias
-**Resumo:** 1 violações bloqueantes, 1 pontos de atenção, 0 sugestões e 0 nits."
+**Resumo:** 1 violações bloqueantes, 1 pontos de atenção, 0 sugestões e 0 nits.
+
+## ❌ blocking
+
+### \`src/alpha/a.ts\`
+
+- **Nunca usar \`any\`.** — \`src/alpha/a.ts:1\` · _Alpha_ · \`id-alpha\`
+  any detectado
+  **Ação:** tipar
+  **Evidência:** \`export const a: any = 1;\`
+
+## ⚠️ attention
+
+### \`src/alpha/b.ts\`
+
+- **Promover: validar a entrada.** — \`src/alpha/b.ts:2\` · _Alpha, Beta_ · \`id-beta\`
+  sem validação
+  **Ação:** adicionar schema
+"
 `;
 
 exports[`baseline — relatório renderDomainReport isolado 1`] = `
@@ -528,7 +529,7 @@ exports[`baseline — camada gerada setup gera os mesmos arquivos e conteúdos 3
   },
   {
     "file": ".houndsman/core/skill/example-review.md",
-    "sha256": "a2627e99ac5caead",
+    "sha256": "d9e75054cc9811dc",
   },
   {
     "file": ".houndsman/core/skill/fix.md",
@@ -536,7 +537,7 @@ exports[`baseline — camada gerada setup gera os mesmos arquivos e conteúdos 3
   },
   {
     "file": ".houndsman/core/skill/hunt.md",
-    "sha256": "c47a24c6c36c1c03",
+    "sha256": "c978287603f4e088",
   },
   {
     "file": ".houndsman/core/skill/train.md",
@@ -544,7 +545,7 @@ exports[`baseline — camada gerada setup gera os mesmos arquivos e conteúdos 3
   },
   {
     "file": ".houndsman/core/skill/verify.md",
-    "sha256": "7ae6e1ca8bf0a868",
+    "sha256": "29bfdeb7def2298e",
   },
 ]
 `;
@@ -713,15 +714,6 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
 **Watchdogs ativos:** alpha
 **Achados:** 1 bloqueantes · 0 atenção · 0 sugestões · 0 nits
 
-## ❌ blocking
-
-### \`src/alpha/a.ts\`
-
-- **Nunca usar \`any\`.** — \`src/alpha/a.ts:1\` · _Alpha_ · \`<id>\`
-  any detectado
-  **Ação:** tipar
-  **Evidência:** \`export const a: any = 1;\`
-
 ## Relatórios por domínio
 
 | Watchdog | Achados | Revisados | Relatório |
@@ -738,6 +730,16 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
 
 **Status:** ❌ Mudanças Necessárias
 **Resumo:** 1 violações bloqueantes, 0 pontos de atenção, 0 sugestões e 0 nits.
+
+## ❌ blocking
+
+### \`src/alpha/a.ts\`
+
+- **Nunca usar \`any\`.** — \`src/alpha/a.ts:1\` · _Alpha_ · \`<id>\`
+  any detectado
+  **Ação:** tipar
+  **Evidência:** \`export const a: any = 1;\`
+
 "
 `;
 

package/src/tests/baseline.test.ts

@@ -432,6 +432,9 @@ describe("baseline — artefatos de prepare/finalize", () => {
 				const artifact = storage.readArtifact(review.id, name);
 				expect(normalize(artifact?.content ?? "")).toMatchSnapshot(name);
 			}
+			const resume = storage.readArtifact(review.id, "review-resume.md");
+			expect(resume?.kind).toBe("resume");
+			expect((resume?.content ?? "").length).toBeLessThanOrEqual(2500);
 			expect(
 				normalize(JSON.stringify(storage.readFindings(review.id), null, 2)),
 			).toMatchSnapshot("state.json");

package/src/tests/code-highlight.test.ts

@@ -10,7 +10,7 @@ import {
 	highlightCode,
 	languageFromFile,
 	languageFromName,
-} from "../server/client/code-highlight";
+} from "../server/client/utils/code-highlight";
 
 /** O texto concatenado dos tokens deve ser idêntico ao input. */
 function joined(tokens: { text: string }[]): string {

package/src/tests/findings-state.test.ts

@@ -112,7 +112,7 @@ describe("buildStateFromFindings", () => {
 		}
 	});
 
-	test("finding que sumiu fica ausente e vira done se era 'execute'", () => {
+	test("finding que sumiu vira done (corrigido entre revisões)", () => {
 		const project = makeProject({ "src/f.ts": DUPLICATED });
 		try {
 			const reader = fileReader(project.cwd);
@@ -121,7 +121,7 @@ describe("buildStateFromFindings", () => {
 				{ branch: "main", readFile: reader },
 			);
 			const id = Object.keys(first.findings)[0];
-			applyFindingUpdate(first.findings[id], { decision: "execute" });
+			expect(first.findings[id].decision).toBe("pending");
 
 			const second = buildStateFromFindings([], {
 				branch: "main",
@@ -135,6 +135,54 @@ describe("buildStateFromFindings", () => {
 		}
 	});
 
+	test("finding ausente e marcado como 'ignore' preserva o estado", () => {
+		const project = makeProject({ "src/f.ts": DUPLICATED });
+		try {
+			const reader = fileReader(project.cwd);
+			const first = buildStateFromFindings(
+				[merged({ file: "src/f.ts", rule: "r", line: 2 })],
+				{ branch: "main", readFile: reader },
+			);
+			const id = Object.keys(first.findings)[0];
+			applyFindingUpdate(first.findings[id], { decision: "ignore" });
+
+			const second = buildStateFromFindings([], {
+				branch: "main",
+				readFile: reader,
+				previous: first,
+			});
+			expect(second.findings[id].present).toBe(false);
+			expect(second.findings[id].execState).toBe("pending");
+			expect(second.findings[id].decision).toBe("ignore");
+		} finally {
+			project.cleanup();
+		}
+	});
+
+	test("arquivo fora da revisão (orçamento/skipped) não vira done", () => {
+		const project = makeProject({ "src/f.ts": DUPLICATED });
+		try {
+			const reader = fileReader(project.cwd);
+			const first = buildStateFromFindings(
+				[merged({ file: "src/f.ts", rule: "r", line: 2 })],
+				{ branch: "main", readFile: reader },
+			);
+			const id = Object.keys(first.findings)[0];
+
+			const second = buildStateFromFindings([], {
+				branch: "main",
+				readFile: reader,
+				previous: first,
+				// Nenhum arquivo foi revisado neste ciclo: ausência não prova resolução.
+				reviewedPaths: new Set(["src/outro.ts"]),
+			});
+			expect(second.findings[id].present).toBe(false);
+			expect(second.findings[id].execState).toBe("pending");
+		} finally {
+			project.cleanup();
+		}
+	});
+
 	test("ocorrências idênticas (mesmo contexto) viram um grupo com count", () => {
 		const content = [
 			"const a = 1;",