@payconductor/houndsman 0.12.0 → 0.14.0

package/src/core/storage/sqlite/mappers.ts

@@ -22,6 +22,7 @@ export type ReviewRow = {
 	repo_root: string;
 	repo_remote: string | null;
 	branch: string;
+	variant: string;
 	slug: string;
 	base: string | null;
 	head: string | null;
@@ -50,6 +51,10 @@ export type FindingRow = {
 	message: string;
 	action: string;
 	evidence: string | null;
+	scenario: string | null;
+	impact: string | null;
+	confidence: number | null;
+	basis: string | null;
 	anchor: string | null;
 	found_at_sha: string | null;
 	count: number;
@@ -91,6 +96,7 @@ export function reviewFromRow(row: ReviewRow): ReviewRecord {
 		repoRoot: row.repo_root,
 		repoRemote: row.repo_remote ?? undefined,
 		branch: row.branch,
+		variant: row.variant || undefined,
 		slug: row.slug,
 		base: row.base ?? undefined,
 		head: row.head ?? undefined,
@@ -129,6 +135,10 @@ export function findingFromRow(row: FindingRow, history: HistoryRow[]): FindingS
 		message: row.message,
 		action: row.action,
 		evidence: row.evidence ?? undefined,
+		scenario: row.scenario ?? undefined,
+		impact: row.impact ?? undefined,
+		confidence: row.confidence === null ? undefined : Number(row.confidence),
+		basis: (row.basis as FindingState["basis"]) ?? undefined,
 		anchor: parseJson<FindingAnchor>(row.anchor) ?? null,
 		foundAtSha: row.found_at_sha ?? undefined,
 		count: Number(row.count),

package/src/core/storage/sqlite/schema.ts

@@ -7,7 +7,7 @@
 
 import type { Database } from "bun:sqlite";
 
-export const SCHEMA_VERSION = 3;
+export const SCHEMA_VERSION = 5;
 
 const DDL = `
 CREATE TABLE IF NOT EXISTS reviews (
@@ -16,6 +16,7 @@ CREATE TABLE IF NOT EXISTS reviews (
 	repo_root TEXT NOT NULL,
 	repo_remote TEXT,
 	branch TEXT NOT NULL,
+	variant TEXT NOT NULL DEFAULT '',
 	slug TEXT NOT NULL,
 	base TEXT,
 	head TEXT,
@@ -29,7 +30,7 @@ CREATE TABLE IF NOT EXISTS reviews (
 	pr_number INTEGER,
 	created_at TEXT NOT NULL,
 	updated_at TEXT NOT NULL,
-	UNIQUE(repo_key, branch)
+	UNIQUE(repo_key, branch, variant)
 );
 
 CREATE INDEX IF NOT EXISTS idx_reviews_repo_updated
@@ -48,6 +49,10 @@ CREATE TABLE IF NOT EXISTS findings (
 	message TEXT NOT NULL,
 	action TEXT NOT NULL,
 	evidence TEXT,
+	scenario TEXT,
+	impact TEXT,
+	confidence REAL,
+	basis TEXT,
 	anchor TEXT,
 	found_at_sha TEXT,
 	count INTEGER NOT NULL DEFAULT 1,
@@ -93,7 +98,6 @@ CREATE INDEX IF NOT EXISTS idx_artifacts_review ON artifacts(review_id);
 
 /** Aplica pragmas e cria o schema quando necessário. */
 export function migrate(db: Database, path: string): void {
-	db.exec("PRAGMA foreign_keys = ON;");
 	db.exec("PRAGMA busy_timeout = 5000;");
 	db.exec("PRAGMA synchronous = NORMAL;");
 	if (path !== ":memory:") db.exec("PRAGMA journal_mode = WAL;");
@@ -102,25 +106,102 @@ export function migrate(db: Database, path: string): void {
 		user_version?: number;
 	} | null;
 	const version = Number(row?.user_version ?? 0);
-	if (version >= SCHEMA_VERSION) return;
+	if (version >= SCHEMA_VERSION) {
+		db.exec("PRAGMA foreign_keys = ON;");
+		return;
+	}
 
-	db.transaction(() => {
-		db.exec(DDL);
-		// v2: heartbeat explícito da execução (bancos v1 não tinham a coluna).
-		// v3: worktree/pr da revisão (revisões paralelas).
-		const columns = db.query("PRAGMA table_info(reviews)").all() as {
-			name: string;
-		}[];
-		const missing: [string, string][] = [
-			["heartbeat_at", "TEXT"],
-			["worktree_path", "TEXT"],
-			["pr_number", "INTEGER"],
-		];
-		for (const [name, type] of missing) {
-			if (!columns.some((column) => column.name === name)) {
-				db.exec(`ALTER TABLE reviews ADD COLUMN ${name} ${type}`);
-			}
-		}
-		db.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
-	})();
+	// O rebuild de `reviews` (v5) troca a chave única e precisa de FKs desligadas:
+	// com elas ligadas, `DROP TABLE reviews` cascatearia e apagaria os filhos.
+	db.exec("PRAGMA foreign_keys = OFF;");
+	try {
+		db.transaction(() => {
+			db.exec(DDL);
+			// v2: heartbeat explícito da execução; v3: worktree/pr da revisão;
+			// v4: cenário/impacto/confiança/origem do finding.
+			const addMissing = (table: string, columns: [string, string][]): void => {
+				const info = db.query(`PRAGMA table_info(${table})`).all() as {
+					name: string;
+				}[];
+				for (const [name, type] of columns) {
+					if (!info.some((column) => column.name === name)) {
+						db.exec(`ALTER TABLE ${table} ADD COLUMN ${name} ${type}`);
+					}
+				}
+			};
+			addMissing("reviews", [
+				["heartbeat_at", "TEXT"],
+				["worktree_path", "TEXT"],
+				["pr_number", "INTEGER"],
+			]);
+			addMissing("findings", [
+				["scenario", "TEXT"],
+				["impact", "TEXT"],
+				["confidence", "REAL"],
+				["basis", "TEXT"],
+			]);
+			// v5: variante A/B na identidade da review.
+			rebuildReviewsWithVariant(db);
+			db.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+		})();
+	} finally {
+		db.exec("PRAGMA foreign_keys = ON;");
+	}
+	const violations = db.query("PRAGMA foreign_key_check").all();
+	if (violations.length > 0) {
+		throw new Error(
+			`Migração do banco deixou ${violations.length} referência(s) inválida(s).`,
+		);
+	}
+}
+
+/**
+ * v5 — adiciona `variant` e troca `UNIQUE(repo_key, branch)` por
+ * `UNIQUE(repo_key, branch, variant)`.
+ *
+ * SQLite não remove constraint inline: recria a tabela preservando os ids (as
+ * FKs dos filhos continuam válidas) e recria o índice.
+ */
+function rebuildReviewsWithVariant(db: Database): void {
+	const columns = db.query("PRAGMA table_info(reviews)").all() as {
+		name: string;
+	}[];
+	if (columns.some((column) => column.name === "variant")) return;
+
+	db.exec(`
+CREATE TABLE reviews_v5 (
+	id TEXT PRIMARY KEY,
+	repo_key TEXT NOT NULL,
+	repo_root TEXT NOT NULL,
+	repo_remote TEXT,
+	branch TEXT NOT NULL,
+	variant TEXT NOT NULL DEFAULT '',
+	slug TEXT NOT NULL,
+	base TEXT,
+	head TEXT,
+	head_sha TEXT,
+	reviewed_sha TEXT,
+	reviewed_at TEXT,
+	status TEXT,
+	started_at TEXT,
+	heartbeat_at TEXT,
+	worktree_path TEXT,
+	pr_number INTEGER,
+	created_at TEXT NOT NULL,
+	updated_at TEXT NOT NULL,
+	UNIQUE(repo_key, branch, variant)
+);
+INSERT INTO reviews_v5
+	(id, repo_key, repo_root, repo_remote, branch, variant, slug, base, head,
+	 head_sha, reviewed_sha, reviewed_at, status, started_at, heartbeat_at,
+	 worktree_path, pr_number, created_at, updated_at)
+SELECT id, repo_key, repo_root, repo_remote, branch, '', slug, base, head,
+	 head_sha, reviewed_sha, reviewed_at, status, started_at, heartbeat_at,
+	 worktree_path, pr_number, created_at, updated_at
+FROM reviews;
+DROP TABLE reviews;
+ALTER TABLE reviews_v5 RENAME TO reviews;
+CREATE INDEX IF NOT EXISTS idx_reviews_repo_updated
+	ON reviews(repo_key, updated_at DESC);
+`);
 }

package/src/core/storage/sqlite/sqlite-storage.ts

@@ -69,7 +69,7 @@ export class SQLiteStorageProvider implements StorageProvider {
 	// -----------------------------------------------------------------------
 
 	getOrCreateReview(input: CreateReviewInput): ReviewRecord {
-		const existing = this.findReview(input.repo.key, input.branch);
+		const existing = this.findReview(input.repo.key, input.branch, input.variant);
 		if (existing) {
 			// O repo pode ter sido movido; a identidade continua a mesma.
 			const moved =
@@ -102,6 +102,7 @@ export class SQLiteStorageProvider implements StorageProvider {
 			repoRoot: input.repo.root,
 			repoRemote: input.repo.remote,
 			branch: input.branch,
+			variant: input.variant?.trim() || undefined,
 			slug: input.slug,
 			base: input.base,
 			head: input.head,
@@ -113,15 +114,16 @@ export class SQLiteStorageProvider implements StorageProvider {
 		};
 		this.db.run(
 			`INSERT INTO reviews
-				(id, repo_key, repo_root, repo_remote, branch, slug, base, head,
+				(id, repo_key, repo_root, repo_remote, branch, variant, slug, base, head,
 				 worktree_path, pr_number, created_at, updated_at)
-			 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+			 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
 			[
 				record.id,
 				record.repoKey,
 				record.repoRoot,
 				record.repoRemote ?? null,
 				record.branch,
+				record.variant ?? "",
 				record.slug,
 				record.base ?? null,
 				record.head ?? null,
@@ -134,10 +136,12 @@ export class SQLiteStorageProvider implements StorageProvider {
 		return record;
 	}
 
-	findReview(repoKey: string, branch: string): ReviewRecord | null {
+	findReview(repoKey: string, branch: string, variant?: string): ReviewRecord | null {
 		const row = this.db
-			.query("SELECT * FROM reviews WHERE repo_key = ? AND branch = ?")
-			.get(repoKey, branch) as ReviewRow | null;
+			.query(
+				"SELECT * FROM reviews WHERE repo_key = ? AND branch = ? AND variant = ?",
+			)
+			.get(repoKey, branch, variant?.trim() ?? "") as ReviewRow | null;
 		return row ? reviewFromRow(row) : null;
 	}
 
@@ -253,9 +257,10 @@ export class SQLiteStorageProvider implements StorageProvider {
 		const upsert = this.db.query(
 			`INSERT INTO findings
 				(id, review_id, short_id, fingerprint, watchdog_ids, rule, severity,
-				 file, line, message, action, evidence, anchor, found_at_sha, count,
-				 present, decision, comment, exec_state, github, created_at, updated_at)
-			 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+				 file, line, message, action, evidence, scenario, impact, confidence, basis,
+				 anchor, found_at_sha, count, present, decision, comment, exec_state, github,
+				 created_at, updated_at)
+			 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
 			 ON CONFLICT(id) DO UPDATE SET
 				short_id = excluded.short_id,
 				fingerprint = excluded.fingerprint,
@@ -267,6 +272,10 @@ export class SQLiteStorageProvider implements StorageProvider {
 				message = excluded.message,
 				action = excluded.action,
 				evidence = excluded.evidence,
+				scenario = excluded.scenario,
+				impact = excluded.impact,
+				confidence = excluded.confidence,
+				basis = excluded.basis,
 				anchor = excluded.anchor,
 				found_at_sha = excluded.found_at_sha,
 				count = excluded.count,
@@ -325,6 +334,10 @@ export class SQLiteStorageProvider implements StorageProvider {
 					finding.message,
 					finding.action,
 					finding.evidence ?? null,
+					finding.scenario ?? null,
+					finding.impact ?? null,
+					finding.confidence ?? null,
+					finding.basis ?? null,
 					finding.anchor ? JSON.stringify(finding.anchor) : null,
 					finding.foundAtSha ?? null,
 					finding.count,

package/src/core/storage/types.ts

@@ -28,6 +28,13 @@ export type ReviewRecord = {
 	repoRoot: string;
 	repoRemote?: string;
 	branch: string;
+	/**
+	 * Rótulo da variante A/B (ausente = run principal da branch).
+	 *
+	 * Faz parte da identidade junto com `(repoKey, branch)`: permite rodar a
+	 * mesma PR com dois experimentos sem apagar a revisão anterior.
+	 */
+	variant?: string;
 	slug: string;
 	base?: string;
 	head?: string;
@@ -81,6 +88,8 @@ export type CreateReviewInput = {
 	repo: RepoIdentity;
 	branch: string;
 	slug: string;
+	/** Variante A/B (ausente = run principal da branch). */
+	variant?: string;
 	base?: string;
 	head?: string;
 	/** Worktree onde a revisão roda (ausente = clone principal). */
@@ -99,17 +108,20 @@ export type ArtifactKind =
 	| "context"
 	| "context-brief"
 	| "context-summary"
+	| "business"
+	| "business-brief"
 	| "finding-report"
-	| "review"
 	| "resume"
 	| "technical"
-	| "domain-review"
 	| "verify"
 	| "ast"
 	| "ast-impact"
 	| "ai"
 	| "ai-usage"
 	| "ai-brief"
+	| "hunt"
+	| "prepare"
+	| "compare"
 	| "other";
 
 /** Artefato persistido de uma review. */
@@ -141,9 +153,10 @@ export type WriteArtifactInput = {
 export interface StorageProvider {
 	readonly kind: "sqlite" | "file";
 
-	/** Recupera ou cria a review de uma branch (identidade = repo + branch). */
+	/** Busca por identidade `(repo, branch, variante)`; variante ausente = principal. */
+	findReview(repoKey: string, branch: string, variant?: string): ReviewRecord | null;
+	/** Run da branch + variante (cria quando não existe). */
 	getOrCreateReview(input: CreateReviewInput): ReviewRecord;
-	findReview(repoKey: string, branch: string): ReviewRecord | null;
 	getReview(id: string): ReviewRecord | null;
 	/** Reviews do repositório (mais recentes primeiro); sem chave = todas. */
 	listReviews(repoKey?: string): ReviewRecord[];

package/src/core/storage/work-area.ts

@@ -9,7 +9,10 @@
 
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { type BusinessSummary, parseBusinessSummary } from "../business-summary";
 import {
+	BUSINESS_BRIEF_FILE,
+	BUSINESS_SUMMARY_FILE,
 	CONTEXT_BRIEF_FILE,
 	CONTEXT_FILE,
 	CONTEXT_SUMMARY_FILE,
@@ -97,7 +100,6 @@ export class ReviewWorkArea {
 			brief: this.file(CONTEXT_BRIEF_FILE),
 		};
 	}
-
 	/** Garante os diretórios; `clean` recria a área do zero. */
 	ensure(clean = false): void {
 		if (clean) this.clean();
@@ -143,6 +145,62 @@ export class ReviewWorkArea {
 		writeFileSync(this.contextPaths.summary, `${JSON.stringify(summary, null, 2)}\n`);
 	}
 
+	/** Caminhos do modelo de intenção (JSON + brief do passo). */
+	get businessPaths(): { summary: string; brief: string } {
+		return {
+			summary: this.file(BUSINESS_SUMMARY_FILE),
+			brief: this.file(BUSINESS_BRIEF_FILE),
+		};
+	}
+
+	/** Grava o modelo de intenção (determinístico, IA ou revisor). */
+	writeBusinessSummary(summary: unknown): void {
+		mkdirSync(this.root, { recursive: true });
+		writeFileSync(
+			this.businessPaths.summary,
+			`${JSON.stringify(summary, null, 2)}\n`,
+		);
+	}
+
+	/** Grava o brief do passo de intenção. */
+	writeBusinessBrief(content: string): void {
+		mkdirSync(this.root, { recursive: true });
+		writeFileSync(this.businessPaths.brief, `${content}\n`);
+	}
+
+	/** Modelo de intenção gravado (subagente/IA) — null se ausente/inválido. */
+	readBusinessSummary(): BusinessSummary | null {
+		const raw = this.readBusinessSummaryRaw();
+		if (raw === null) return null;
+		try {
+			return parseBusinessSummary(JSON.parse(raw), "reviewer");
+		} catch {
+			return null;
+		}
+	}
+
+	/** Conteúdo cru do modelo de intenção (para persistir como artefato). */
+	readBusinessSummaryRaw(): string | null {
+		const path = this.businessPaths.summary;
+		if (!existsSync(path)) return null;
+		try {
+			return readFileSync(path, "utf8");
+		} catch {
+			return null;
+		}
+	}
+
+	/** Conteúdo cru do brief de intenção (para persistir como artefato). */
+	readBusinessBriefRaw(): string | null {
+		const path = this.businessPaths.brief;
+		if (!existsSync(path)) return null;
+		try {
+			return readFileSync(path, "utf8");
+		} catch {
+			return null;
+		}
+	}
+
 	/** Finds brutos gravados pelos subagentes (um JSON por watchdog). */
 	readFindings(activeIds: string[]): FindingsIngest {
 		const reports: WatchdogReport[] = [];

package/src/core/types.ts

@@ -8,6 +8,7 @@
 
 import type { BriefPlan } from "./ai/schemas";
 import type { AstFileBrief } from "./ast/types";
+import type { BusinessSummary } from "./business-summary";
 import type { ChangedScope } from "./changed-scope";
 import type { JevRuleSpec } from "./jev/jev-types";
 
@@ -131,8 +132,38 @@ export type WatchdogRenderArgs = {
 	ast?: readonly AstFileBrief[];
 	/** Plano de revisão sugerido por IA (nunca substitui as regras). */
 	aiPlan?: BriefPlan;
+	/** Modelo de intenção da PR (negócio) — insumo do revisor `general`. */
+	business?: BusinessSummary;
+	/** Caminho do `business-summary.json` no staging (versão canônica). */
+	businessSummaryPath?: string;
+	/** Trechos alterados (`diff` por arquivo) — só para o revisor de fluxo. */
+	snippets?: readonly { file: string; snippet: string }[];
+	/** `true` no revisor de fluxo: exige devolver/gravar o modelo de intenção. */
+	flowReview?: boolean;
 	/** Escopo do diff por arquivo (símbolos alterados; hunks como fallback). */
 	changedScope?: ChangedScope;
+	/** Micro-alterações iguais em muitos arquivos (propagação mecânica). */
+	propagation?: PropagationCluster | null;
+	/** Contratos alterados cujos importadores não mudaram (possível lacuna). */
+	propagationGaps?: readonly PropagationGap[];
+};
+
+/** Cluster de propagação mecânica (ex.: novo parâmetro em 100 call sites). */
+export type PropagationCluster = {
+	/** Linhas adicionadas normalizadas (o padrão dominante). */
+	lines: string[];
+	/** Arquivos que seguem o padrão. */
+	files: string[];
+	/** Arquivos com micro-alteração que NÃO seguem o padrão. */
+	outliers: { file: string; lines: string[] }[];
+};
+
+/** Contrato que mudou e tem importadores fora do diff. */
+export type PropagationGap = {
+	/** Arquivo do contrato (o que mudou). */
+	file: string;
+	/** Importadores que não aparecem no diff. */
+	importers: string[];
 };
 
 /** Definição completa de um watchdog — 1 por arquivo em `project/watchdogs/`. */

package/src/core/watchdog-registry.ts

@@ -6,6 +6,7 @@
  * adaptadores para a API pública.
  */
 
+import { builtinWatchdog, GENERAL_WATCHDOG_ID, mergeGeneralWatchdog } from "./builtins";
 import type { HoundsmanConfig } from "./config";
 import { Watchdog, type WatchdogContext } from "./domain/watchdog";
 import type { WatchdogDefinition } from "./types";
@@ -23,17 +24,34 @@ export class WatchdogRegistry<TId extends string = string> {
 		return this.config.watchdogIds;
 	}
 
-	/** Definição de um watchdog (id string em runtime). */
+	/** Definição de um watchdog (config vence; senão, built-in). */
 	get(watchdogId: string): WatchdogDefinition {
-		return this.config.watchdogs[watchdogId as TId];
+		const definition = this.definitionOf(watchdogId);
+		if (!definition) {
+			throw new Error(`Watchdog '${watchdogId}' não encontrado.`);
+		}
+		return definition;
 	}
 
 	/** Busca null-safe por id. */
 	find(watchdogId: string): Watchdog | null {
-		const definition = this.config.watchdogs[watchdogId as TId];
+		const definition = this.definitionOf(watchdogId);
 		return definition ? new Watchdog(definition) : null;
 	}
 
+	/**
+	 * Resolve a definição: config primeiro, built-in depois. O `general` é
+	 * reservado e sempre inclui o piso de lógica do motor (mesmo se o consumidor
+	 * declarar um watchdog com esse id).
+	 */
+	private definitionOf(watchdogId: string): WatchdogDefinition | null {
+		const configured = this.config.watchdogs[watchdogId as TId];
+		if (watchdogId === GENERAL_WATCHDOG_ID) {
+			return mergeGeneralWatchdog(configured);
+		}
+		return configured ?? builtinWatchdog(watchdogId);
+	}
+
 	/** Nome legível (default: o próprio id). */
 	nameOf(watchdogId: string): string {
 		return this.find(watchdogId)?.name ?? watchdogId;

package/src/index.ts

@@ -50,6 +50,29 @@ export type {
 	AstSymbolKind,
 } from "./core/ast/types";
 export { defaultRenderBrief, PROCEDURE, renderBrief } from "./core/brief";
+export {
+	BUILTIN_WATCHDOGS,
+	builtinWatchdog,
+	GENERAL_WATCHDOG_ID,
+	generalWatchdog,
+	mergeGeneralWatchdog,
+} from "./core/builtins";
+export {
+	BUSINESS_SUMMARY_SCHEMA,
+	type BusinessBriefInput,
+	type BusinessContract,
+	type BusinessFlow,
+	type BusinessInput,
+	type BusinessState,
+	type BusinessSummary,
+	type BusinessSummarySource,
+	buildBusinessBrief,
+	buildBusinessPromptPayload,
+	buildBusinessSummary,
+	parseBusinessSummary,
+	renderBusinessLines,
+	summarizeBusiness,
+} from "./core/business-summary";
 export type {
 	BuildChangedScopeInput,
 	ChangedScope,
@@ -67,7 +90,10 @@ export {
 	mergeRanges,
 	summarizeScope,
 } from "./core/changed-scope";
-export type { FindingsCommandResult } from "./core/commands/findings";
+export type {
+	FindingsCommandResult,
+	FindingsContextOptions,
+} from "./core/commands/findings";
 export { runFindingsCommand, runVerifyCommand } from "./core/commands/findings";
 export { ProjectScaffolder } from "./core/commands/scaffold";
 export type {
@@ -80,13 +106,19 @@ export type {
 	HoundsmanConcurrency,
 	HoundsmanConfig,
 	HoundsmanConfigInput,
+	HoundsmanHunt,
+	HoundsmanPriority,
 	HoundsmanStorage,
 } from "./core/config";
 export {
 	DEFAULT_ALWAYS_INCLUDE_DOCS,
 	DEFAULT_AST_MAX_FILE_BYTES,
 	DEFAULT_AST_MAX_IMPACT_FILES,
+	DEFAULT_HUNT_CONCURRENCY,
+	DEFAULT_HUNT_RETRIES,
+	DEFAULT_HUNT_TIMEOUT_MS,
 	DEFAULT_JEV_CONCURRENCY,
+	DEFAULT_MAKI_VERSION,
 	DEFAULT_MAX_FILES_PER_BRIEF,
 	defineHoundsmanConfig,
 	resolveJevConcurrency,
@@ -181,6 +213,50 @@ export {
 	syncState,
 } from "./core/findings-state";
 export type { GitResult, GitRunner } from "./core/git-runner";
+export type {
+	HuntEvent,
+	HuntReport,
+	HuntRunnerOptions,
+	HuntTotals,
+	HuntWatchdogResult,
+	InstallMakiOptions,
+	InstallMakiResult,
+	MakiBinary,
+	MakiBinarySource,
+	MakiInstallManifest,
+	MakiModel,
+	MakiProcessRunner,
+	MakiRunMetrics,
+	MakiRunRequest,
+	MakiRunResult,
+	MakiUsage,
+} from "./core/hunt";
+export {
+	extractJsonObject,
+	HuntRunner,
+	houndsmanKeyEnvFor,
+	installMaki,
+	MAKI_API_KEY_ENV,
+	MAKI_DISALLOWED_TOOLS,
+	makiArgs,
+	makiCurrentFile,
+	makiInstallDir,
+	makiSourceLabel,
+	makiToolsRoot,
+	mapPool,
+	metricsFrom,
+	parseMakiOutput,
+	probeMakiVersion,
+	readMakiInstall,
+	renderHuntPrompt,
+	renderRetrySuffix,
+	requireMakiBinary,
+	requireMakiModel,
+	resolveMakiBinary,
+	resolveMakiModel,
+	SpawnMakiRunner,
+	uninstallMaki,
+} from "./core/hunt";
 export {
 	CORE_DIR,
 	CORE_SKILL_DIR,
@@ -193,9 +269,7 @@ export { ProjectConfig } from "./core/project-config";
 export { checkRegistry } from "./core/registry-check";
 export { BriefRenderer } from "./core/renderers/brief-renderer";
 export { ManifestWriter } from "./core/renderers/manifest-writer";
-export { ReportRenderer } from "./core/renderers/report-renderer";
-export type { DomainReport } from "./core/report-builder";
-export { renderDomainReport } from "./core/report-builder";
+export { RESUME_MAX_CHARS, renderReviewResume } from "./core/renderers/resume-renderer";
 export type { Clock } from "./core/services/clock";
 export { systemClock } from "./core/services/clock";
 export { FileClassifier } from "./core/services/file-classifier";

package/src/server/client/ArtifactsPanel.tsx

@@ -19,9 +19,11 @@ import {
 import { formatJson, highlightJson } from "./utils/json-highlight";
 import type { ArtifactMeta } from "./utils/types";
 
-/** Prefere o relatório consolidado; senão, o primeiro artefato disponível. */
+/** Prefere o resumo final; senão, o primeiro artefato disponível. */
 function pickDefault(items: ArtifactMeta[]): string {
-	return (items.find((item) => item.name === "review.md") ?? items[0])?.name ?? "";
+	return (
+		(items.find((item) => item.name === "review-resume.md") ?? items[0])?.name ?? ""
+	);
 }
 
 /** JSON com destaque de sintaxe (tokens em spans, sem lib externa). */