@payconductor/houndsman 0.4.0 → 0.6.0

package/src/server/index.ts

@@ -14,6 +14,7 @@ import {
 	type GhRunner,
 	type SubmitSelection,
 } from "../core/github-review";
+import { logger } from "../core/logging";
 import { createStorage } from "../core/storage/factory";
 import { resolveRepoIdentity } from "../core/storage/repo-identity";
 import type { RepoIdentity, StorageProvider } from "../core/storage/types";
@@ -190,8 +191,8 @@ export class HoundsmanServer {
 		try {
 			this.runs.maintain();
 		} catch (error) {
-			console.warn(
-				`[houndsman] VACUUM falhou (seguindo sem compactar): ${
+			logger.warn(
+				`VACUUM falhou (seguindo sem compactar): ${
 					error instanceof Error ? error.message : String(error)
 				}`,
 			);
@@ -315,7 +316,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 +413,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 +490,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 +504,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/OUTPUT-FORMAT.md

@@ -70,3 +70,15 @@ staging global da review:
 - Um achado por regra violada; não agrupar regras diferentes.
 - `file:line` sempre que possível; `evidence` quando o achado não é óbvio.
 - Não inventar achados — se não houver violação, o array fica vazio.
+
+## Findings emergentes (opt-in)
+
+Quando o watchdog declara `allowEmergentFindings: true`, você pode reportar falhas de
+**lógica** ou **domínio** que não correspondem a uma regra explícita usando os prefixos
+reservados:
+
+- `Lógica: <descrição>` — nome/contrato vs comportamento, fluxos, estados, bordas.
+- `Domínio: <descrição>` — transições, idempotência, invariantes, arredondamento, timezone.
+
+Esses findings continuam exigindo `evidence` e têm severidade máxima `attention`. Sem o
+opt-in, todo finding precisa citar uma regra existente.

package/src/skill/SETUP.md

@@ -7,8 +7,11 @@ no seu projeto é **autocontida** — não exige nenhuma dependência local do p
 
 - **Bun** — o CLI e o motor usam a runtime Bun (execução de TS, `Bun.spawnSync`).
 - **git** — o diff usa `git diff <base>...<head> --name-status`.
-- Opcional: **`gh`** (contexto da PR) e **`TYPESAFE_API_KEY`** (pré-análise Jev). O pipeline
-  segue normalmente sem eles.
+- **gh** (Opcional) — Obtém contexto da PR e dispara comentários para o GitHub
+- **`HOUNDSMAN_TYPE_SAFE_API_KEY`** (opcional) — pré-análise Jev.
+- **`HOUNDSMAN_DEEP_SEEK_API_KEY`** (opcional) — IA própria do `hunt` nativo e das features de IA.
+- **`HOUNDSMAN_OPENAI_API_KEY`** / **`HOUNDSMAN_ANTHROPIC_API_KEY`** (opcional) — apenas se
+  `ai.provider` for `openai`/`anthropic`.
 
 ## Instalação (global)
 
@@ -87,6 +90,7 @@ Definido em `src/core/config.ts` (pacote) e espelhado em `.houndsman/core/types.
 | `alwaysIncludeDocs` | Docs sempre presentes nos briefs (default `["AGENTS.md"]`). |
 | `budgets` | **Opcional** — teto de arquivos por brief (`maxFilesPerBrief`, default `40`); o excedente vira "fora do orçamento" (registrar em `skipped`). |
 | `concurrency` | **Opcional** — chamadas Jev simultâneas (`jev`, default `5`). |
+| `ast` | **Opcional** — AST determinístico para TS/JS (`enabled`, `maxFileBytes`, `maxImpactFiles`, `languages`, `aliases`). Default: ligado; falhas são fail-open. |
 
 > O motor **não contém** ids, paths ou regras do projeto — tudo chega por `HoundsmanConfig`,
 > carregado em runtime a partir de `houndsman.config.ts` (ou `--config <path>`).

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

@@ -10,6 +10,11 @@ as regras do projeto ficam em `houndsman.config.ts` + `.houndsman/`.
 **Quando usar:** revisar PR antes de merge · code review de feature branch · validar
 mudanças antes de push.
 
+> **Harness nativo (opcional):** além deste skill, o CLI tem `houndsman hunt` — o mesmo
+> fluxo executado pelo próprio houndsman, com tools read-only, investigação por evidência
+> e `VERIFY` obrigatório. Use `houndsman hunt --dry-run` para inspecionar sem IA. Detalhes
+> em `docs/HARNESS.md`.
+
 ## Quem executa o quê
 
 - **Você** só invoca o skill: `/houndsman [hunt]`. Não precisa rodar nenhum script à mão.
@@ -76,6 +81,8 @@ staging dos subagentes em `<HOUNDSMAN_HOME>/work/<reviewId>/`:
 | Artefato | Conteúdo |
 |---|---|
 | `classification.json` | Watchdogs ativados por arquivo + status (A/M/D/R) + churn (storage) |
+| `ast-summary.json` | Fatos estruturais + delta por arquivo (AST TS/JS) (storage) |
+| `ast-impact.json` | Importadores reversos e exports públicos alterados (storage) |
 | `candidates.json` | Indícios da pré-análise Jev (regra + arquivo + confiança) (storage) |
 | `briefs/<watchdog>.md` | Instruções prontas para cada subagente (staging + storage, para auditoria) |
 | `manifest.json` | Resumo: watchdogs, arquivos, deletados, status, contexto, Jev, orçamento (storage) |
@@ -83,6 +90,11 @@ staging dos subagentes em `<HOUNDSMAN_HOME>/work/<reviewId>/`:
 > O prepare imprime o caminho absoluto do diretório de briefs e cada brief traz o
 > `outputPath` do JSON que o subagente deve gravar. Briefs e contexto também ficam
 > persistidos no storage para auditoria; o staging é limpo após o `--finalize`.
+>
+> **AST (TS/JS, ligado por padrão):** cada brief ganha a seção `Estrutura (AST)` com
+> símbolos adicionados/removidos/alterados, assinaturas e imports; o impacto reverso
+> (quem importa os arquivos alterados) aparece como mapa de leitura. É fail-open:
+> sem grammar/ABI, a revisão segue só com regex. Desative com `--no-ast`.
 
 **Excluídos automaticamente:** lock files, `dist/`, `build/`, `.env*`, imagens, source
 maps (padrões do projeto em `.houndsman/exclusions.ts`).
@@ -106,7 +118,7 @@ arquivos da PR. Cada brief recebe no máximo `budgets.maxFilesPerBrief` arquivos
 
 ### Pré-análise Jev (Passo 1.5, opcional)
 
-Se `TYPESAFE_API_KEY` estiver definida, cada arquivo é avaliado pelo modelo **Jev** contra
+Se `HOUNDSMAN_TYPE_SAFE_API_KEY` estiver definida, cada arquivo é avaliado pelo modelo **Jev** contra
 as regras atômicas dos watchdogs. Respostas acima do limiar viram **candidatos** em
 `candidates.json` e entram no brief como *warm start* — o subagente **confirma ou refuta**.
 
@@ -122,11 +134,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 +150,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 +177,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 +210,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 +220,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,11 +271,12 @@ 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`) |
 
 Flags do review: `--base` · `--head` · `--branch` · `--clean` · `--full` (força
-completo) · `--no-jev` · `--fail-on-blocking` (com `--finalize`).
+completo) · `--no-jev` · `--no-ast` · `--fail-on-blocking` (com `--finalize`).
 
 > Persistência: SQLite global em `<HOUNDSMAN_HOME>/houndsman.db`. O staging dos subagentes
 > (`briefs/`, `findings/`, contexto) vive em `<HOUNDSMAN_HOME>/work/<reviewId>/` e é limpo

package/src/skill/verify.md

@@ -24,7 +24,7 @@ altera regras.
    - **âncora sumida** (`stale`) → provável **resolvido** — mas o trecho pode ter sido reescrito;
    - **arquivo ausente** → fora da verificação (deletado/movido).
 
-2. **Tier Jev (opcional, só nos ambíguos).** Com `TYPESAFE_API_KEY`, os casos `stale` / sem
+2. **Tier Jev (opcional, só nos ambíguos).** Com `HOUNDSMAN_TYPE_SAFE_API_KEY`, os casos `stale` / sem
    âncora são confirmados pelo LLM sobre um **diff focado** do arquivo (`foundAtSha..HEAD`), uma
    pergunta `noul` por finding. Falha-aberto: sem chave/erro → vale o resultado local.
 
@@ -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