@payconductor/houndsman 0.3.0 → 0.5.0

package/src/skill/hunt.md

@@ -21,7 +21,7 @@ mudanças antes de push.
 | 0. Contexto | `houndsman context` | subagente | `context.json` + `context-brief.md` → `context-summary.json` |
 | 1. Preparar | `houndsman` | skill | `classification.json` + `candidates.json` + `briefs/` + `manifest.json` |
 | 2. Revisar | *(subagentes)* | skill (via `runSubagent`) | `findings/<watchdog>.json` (um por watchdog) |
-| 3. Finalizar | `houndsman --finalize` | skill | `review.md` + `state.json` + `run.json` |
+| 3. Finalizar | `houndsman --finalize` | skill | `review.md` + triagem/status no storage |
 
 > Por que comandos separados? Entre o passo 1 e o 3 acontece trabalho de LLM (os subagentes).
 > Depois do passo 3, a correção dos achados é a capability **`fix`** — ver `fix.md`.
@@ -70,14 +70,19 @@ leia o `context-brief.md` indicado na saída; siga as instruções e grave
 houndsman --base main
 ```
 
-Gera em `.houndsman/.runs/<branch-slug>/`:
+Grava os artefatos no **storage global** (SQLite em `<HOUNDSMAN_HOME>/houndsman.db`) e o
+staging dos subagentes em `<HOUNDSMAN_HOME>/work/<reviewId>/`:
 
 | Artefato | Conteúdo |
 |---|---|
-| `classification.json` | Watchdogs ativados por arquivo + status (A/M/D/R) + churn |
-| `candidates.json` | Indícios da pré-análise Jev (regra + arquivo + confiança) |
-| `briefs/<watchdog>.md` | Instruções prontas para cada subagente (arquivos por risco) |
-| `manifest.json` | Resumo: watchdogs, arquivos, deletados, status, contexto, Jev, orçamento |
+| `classification.json` | Watchdogs ativados por arquivo + status (A/M/D/R) + churn (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) |
+
+> 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`.
 
 **Excluídos automaticamente:** lock files, `dist/`, `build/`, `.env*`, imagens, source
 maps (padrões do projeto em `.houndsman/exclusions.ts`).
@@ -111,17 +116,20 @@ as regras atômicas dos watchdogs. Respostas acima do limiar viram **candidatos*
 
 ### Review incremental (da 2ª revisão em diante)
 
-Cada `--finalize` grava o **commit revisado** (`reviewed.headSha` no `state.json`). No prepare
+Cada `--finalize` grava o **commit revisado** (`reviewedSha` da review no storage). No prepare
 seguinte, se o `HEAD` descende desse commit (sem rebase), o motor revisa **só o delta** — os
 arquivos alterados desde a última revisão — e **carrega** os findings dos arquivos inalterados
 (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.
 
 ---
 
@@ -130,12 +138,16 @@ 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: .houndsman/.runs/<branch-slug>/briefs/<watchdog-id>.md
+Leia e execute o brief: <caminho absoluto impresso pelo prepare>/briefs/<watchdog-id>.md
 Você é o watchdog <watchdog-id> do {{projectName}}.
 ```
 
-Cada subagente grava `findings/<watchdog-id>.json` (schema `.houndsman/core/skill/OUTPUT-FORMAT.md`).
+Cada subagente grava o `outputPath` indicado no brief (schema `.houndsman/core/skill/OUTPUT-FORMAT.md`).
 Sem achados → `"findings": []` (arquivo obrigatório). Arquivos na seção **Fora do orçamento**
 não são lidos: registre-os em `skipped`.
 
@@ -150,18 +162,21 @@ não são lidos: registre-os em `skipped`.
 houndsman --finalize
 ```
 
-Falha com mensagem clara se faltar algum `findings/<watchdog>.json`. Quando todos existem:
+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 `.houndsman/.runs/<branch-slug>/review.md` + 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. Grava `.houndsman/.runs/<branch-slug>/state.json` — a **triagem**: 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.
 
@@ -183,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 |
 |---|---|---|---|
@@ -201,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
@@ -212,15 +230,15 @@ houndsman context (gh)         ──►  context.json ──► subagente ─
         ↓
 git diff --name-status (base...head)
         ↓
-[1] houndsman                  ──►  classification.json + candidates.json + briefs/ + manifest.json
+[1] houndsman                  ──►  storage (classification/candidates/manifest) + briefs/ no staging
         ↓
-[2] N subagentes em paralelo   ──►  findings/<watchdog>.json
+[2] N subagentes em paralelo   ──►  findings/<watchdog>.json no staging
         ↓
-[3] houndsman --finalize       ──►  review.md + state.json + run.json (review_done)
+[3] houndsman --finalize       ──►  review.md + triagem no storage (review_done)
         ↓
 [4] server (UI)                ──►  validar a revisão + marcar decision: execute
         ↓
-[5] fix                        ──►  correções + state.json/run.json (fix_done)
+[5] fix                        ──►  correções + triagem/status no storage (fix_done)
 ```
 
 ---
@@ -241,12 +259,17 @@ 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` · `--dir` · `--clean` · `--full` (força
+Flags do review: `--base` · `--head` · `--branch` · `--clean` · `--full` (força
 completo) · `--no-jev` · `--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
+> depois do `--finalize`.
+
 ---
 
 ## Anti-padrões

package/src/skill/train.md

@@ -118,7 +118,7 @@ Cada informação tem o seu campo — não espelhe a regra em vários lugares:
 |---|---|
 | `.houndsman/watchdogs/<id>.ts` | **Fonte de verdade**: `defineWatchdog` com `rules` (severidade + texto), `scope`, `description`, `reviewFocus`, `exclude`, `breakingChange`, `contextFiles`, `classify` |
 | `.houndsman/watchdogs/index.ts` | `WATCHDOG_DEFINITIONS` — as **chaves definem os ids** (`WatchdogId`); `watchdogIds` é derivado |
-| `houndsman.config.ts` | `houndsmanConfig` do projeto — `projectName`, `artifactDir`, `watchdogs`, `exclusions`, `docMappings` (descoberto em runtime) |
+| `houndsman.config.ts` | `houndsmanConfig` do projeto — `projectName`, `storage`, `watchdogs`, `exclusions`, `docMappings` (descoberto em runtime) |
 | `.houndsman/exclusions.ts` | `EXCLUSION_PATTERNS` + `isExcluded` |
 | `.houndsman/doc-mappings.ts` | `DOC_MAPPINGS` (path → docs) |
 | `.houndsman/core/types.ts` | Snapshot gerado dos tipos + helpers (autocontido) |

package/src/skill/verify.md

@@ -4,15 +4,15 @@
 > (`.agents/skills/houndsman/SKILL.md` e `.claude/skills/houndsman/SKILL.md`).
 
 Confere se os findings de uma revisão **já finalizada** foram resolvidos — **sem re-revisar a
-PR**. Invocação: `/houndsman verify`. Consome o `state.json` do `hunt`; não revisa nem altera
-regras.
+PR**. Invocação: `/houndsman verify`. Consome a triagem persistida pelo `hunt`; não revisa nem
+altera regras.
 
 **Quando usar:**
 
 - Depois de corrigir achados (`fix`), para confirmar que as violações sumiram.
 - As violações foram resolvidas? · confere se ainda está lá · valida o fix.
 
-> **Pré-requisito:** existe `.houndsman/.runs/<branch-slug>/state.json` (gerado no `--finalize`).
+> **Pré-requisito:** existe uma review com findings persistidos (gerada no `--finalize`).
 
 ---
 
@@ -38,12 +38,13 @@ completa.
 ```bash
 bun run houndsman findings verify            # relatório (não altera o estado)
 bun run houndsman findings verify --json     # saída estruturada
-bun run houndsman findings verify --apply    # marca os resolvidos como done (ping no run.json)
+bun run houndsman findings verify --apply    # marca os resolvidos como done (ping no status)
 ```
 
-- Sem `--apply`: **só relatório** (grava `verify.md` na pasta da run). Nada muda no `state.json`.
+- 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

@@ -4,7 +4,7 @@ exports[`baseline — brief defaultRenderBrief (contexto, churn, overflow, candi
 "# Brief — Alpha (\`alpha\`)
 
 **Branch:** feature/x
-**Output obrigatório:** \`.houndsman/.runs/feature-x/findings/alpha.json\`
+**Output obrigatório:** \`/workspace/work/review-x/findings/alpha.json\`
 **Schema do output:** \`.houndsman/core/skill/OUTPUT-FORMAT.md\`
 
 ## Objetivo
@@ -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`] = `
@@ -382,10 +383,16 @@ export type HoundsmanConcurrency = {
 	jev?: number;
 };
 
+/** Backend de persistência (reviews, findings e artefatos). */
+export type HoundsmanStorage = {
+	provider?: "sqlite" | "file";
+	path?: string;
+};
+
 /** Contrato de configuração do motor. */
 export type HoundsmanConfig<TId extends string = string> = {
 	projectName: string;
-	artifactDir?: string;
+	storage?: HoundsmanStorage;
 	watchdogIds?: readonly TId[];
 	watchdogs: Record<TId, WatchdogDefinition>;
 	exclusions: readonly RegExp[];
@@ -412,10 +419,9 @@ export function defineHoundsmanConfig<TId extends string>(
 "/**
  * Mapeamento de padrões nos paths → documentação relevante.
  * Consumido pelo motor via \`HoundsmanConfig.docMappings\`.
- */
-export const DOC_MAPPINGS: readonly (readonly [RegExp, readonly string[]])[] = [
-	[/^src\\//, ["AGENTS.md"]],
-];
+ */\`core/\` é regenerado por \`houndsman update\`.
+# Runs, findings e artefatos vivem no storage global (fora do projeto).
+core
 "
 ,
   ".houndsman/exclusions.ts": 
@@ -486,9 +492,9 @@ import type { HoundsmanConfig } from "./.houndsman/core/types";
 /**
  * Configuração do houndsman para acme.
  *
- * Caminhos são resolvidos pela camada: artefatos em .houndsman/.runs e schema de
- * output em .houndsman/core/skill/OUTPUT-FORMAT.md. Ajuste watchdogs, exclusões e mapeamentos de
- * docs conforme o projeto.
+ * Runs, findings e artefatos vivem no storage global (SQLite por default) —
+ * fora do projeto. O schema de output fica em .houndsman/core/skill/OUTPUT-FORMAT.md. Ajuste
+ * watchdogs, exclusões e mapeamentos de docs conforme o projeto.
  */
 export const houndsmanConfig = {
 	projectName: "acme",
@@ -511,47 +517,47 @@ exports[`baseline — camada gerada setup gera os mesmos arquivos e conteúdos 3
   },
   {
     "file": ".houndsman/core/skill/OUTPUT-FORMAT.md",
-    "sha256": "3c6f261de0ca6d31",
+    "sha256": "06aedccd5688aaa8",
   },
   {
     "file": ".houndsman/core/skill/README.md",
-    "sha256": "7cc26ec5e1917a62",
+    "sha256": "0c1514669d044033",
   },
   {
     "file": ".houndsman/core/skill/SETUP.md",
-    "sha256": "5d6a4b56b1033970",
+    "sha256": "7ce23b97d9609ac2",
   },
   {
     "file": ".houndsman/core/skill/example-review.md",
-    "sha256": "a2627e99ac5caead",
+    "sha256": "d9e75054cc9811dc",
   },
   {
     "file": ".houndsman/core/skill/fix.md",
-    "sha256": "f16c0383ad1767fb",
+    "sha256": "9f10b2d846dc7db5",
   },
   {
     "file": ".houndsman/core/skill/hunt.md",
-    "sha256": "7e7d7e5535381b9b",
+    "sha256": "c978287603f4e088",
   },
   {
     "file": ".houndsman/core/skill/train.md",
-    "sha256": "564a1fd38d8e4836",
+    "sha256": "d774215c68d15159",
   },
   {
     "file": ".houndsman/core/skill/verify.md",
-    "sha256": "f8fcf8e12b142482",
+    "sha256": "29bfdeb7def2298e",
   },
 ]
 `;
 
 exports[`baseline — artefatos de prepare/finalize gera classification, brief, manifest, review e state 1`] = `
 "Discovery: 1 watchdog(s) ativado(s), 3 arquivo(s), 1 deletado(s).
-Briefs: .houndsman/.runs/main/briefs/
+Briefs: <cwd>/.home/work/<uuid>/briefs/
 Deletado (breaking change): src/alpha/old.ts
 Jev: pulado (desativado (--no-jev)).
 Sem contexto da PR (rode \`bun run houndsman context\` antes, se houver PR).
 
-Próximo passo: despachar os sub-agentes (um por brief em .houndsman/.runs/main/briefs/).
+Próximo passo: despachar os sub-agentes (um por brief em <cwd>/.home/work/<uuid>/briefs/).
 Quando os findings estiverem gravados: bun run houndsman --finalize"
 `;
 
@@ -631,8 +637,8 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
         "src/alpha/b.ts"
       ],
       "overflow": 0,
-      "brief": ".houndsman/.runs/main/briefs/alpha.md",
-      "findings": ".houndsman/.runs/main/findings/alpha.json",
+      "brief": "<cwd>\\\\.home\\\\work\\\\<uuid>\\\\briefs\\\\alpha.md",
+      "findings": "<cwd>\\\\.home\\\\work\\\\<uuid>\\\\findings\\\\alpha.json",
       "status": "pending"
     }
   ],
@@ -657,7 +663,7 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
 "# Brief — Alpha (\`alpha\`)
 
 **Branch:** main
-**Output obrigatório:** \`.houndsman/.runs/main/findings/alpha.json\`
+**Output obrigatório:** \`<cwd>\\.home\\work\\<uuid>\\findings\\alpha.json\`
 **Schema do output:** \`.houndsman/core/skill/OUTPUT-FORMAT.md\`
 
 ## Objetivo
@@ -697,8 +703,8 @@ src/alpha/**
 `;
 
 exports[`baseline — artefatos de prepare/finalize gera classification, brief, manifest, review e state 2`] = `
-"Triagem: .houndsman/.runs/main/state.json — 1 finding(s).
-Relatório: .houndsman/.runs/main/review.md — 1 bloqueante(s), 0 atenção."
+"Triagem: sqlite:<cwd>\\houndsman.db#<uuid> — 1 finding(s).
+Relatório: sqlite:<cwd>\\houndsman.db#<uuid> — 1 bloqueante(s), 0 atenção."
 `;
 
 exports[`baseline — artefatos de prepare/finalize gera classification, brief, manifest, review e state: review.md 1`] = `
@@ -708,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 |
@@ -733,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;\`
+
 "
 `;
 
@@ -764,10 +771,6 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
   "order": [
     "<id>"
   ],
-  "reviewed": {
-    "headSha": "<sha>",
-    "at": "<timestamp>"
-  },
   "findings": {
     "<id>": {
       "id": "<id>",
@@ -796,19 +799,29 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
       "updatedAt": "<timestamp>",
       "history": []
     }
+  },
+  "reviewed": {
+    "headSha": "<sha>",
+    "at": "<timestamp>"
   }
-}
-"
+}"
 `;
 
 exports[`baseline — artefatos de prepare/finalize gera classification, brief, manifest, review e state: run.json 1`] = `
 "{
-  "version": 1,
-  "slug": "main",
+  "id": "<uuid>",
+  "repoKey": "path:<cwd>",
+  "repoRoot": "<cwd>",
   "branch": "main",
+  "slug": "main",
+  "base": "<sha>",
+  "head": "HEAD",
+  "headSha": "<sha>",
+  "reviewedSha": "<sha>",
+  "reviewedAt": "<timestamp>",
   "status": "review_done",
   "startedAt": "<timestamp>",
+  "createdAt": "<timestamp>",
   "updatedAt": "<timestamp>"
-}
-"
+}"
 `;