@payconductor/houndsman 0.13.0 → 0.14.0

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,11 +108,11 @@ export type ArtifactKind =
 	| "context"
 	| "context-brief"
 	| "context-summary"
+	| "business"
+	| "business-brief"
 	| "finding-report"
-	| "review"
 	| "resume"
 	| "technical"
-	| "domain-review"
 	| "verify"
 	| "ast"
 	| "ast-impact"
@@ -111,6 +120,8 @@ export type ArtifactKind =
 	| "ai-usage"
 	| "ai-brief"
 	| "hunt"
+	| "prepare"
+	| "compare"
 	| "other";
 
 /** Artefato persistido de uma review. */
@@ -142,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 {
@@ -81,6 +107,7 @@ export type {
 	HoundsmanConfig,
 	HoundsmanConfigInput,
 	HoundsmanHunt,
+	HoundsmanPriority,
 	HoundsmanStorage,
 } from "./core/config";
 export {
@@ -242,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). */

package/src/server/client/FindingCard.tsx

@@ -157,7 +157,7 @@ export function FindingCard({
 					</span>
 				)}
 				{!finding.present && (
-					<span class="tag" title="Não aparece no último relatório consolidado">
+					<span class="tag" title="Não aparece na última revisão">
 						ausente
 					</span>
 				)}
@@ -206,6 +206,26 @@ export function FindingCard({
 				<div class="card-body">
 					<div class="meta-row">{finding.rule}</div>
 
+					{finding.scenario && (
+						<div class="action-block">
+							<Sparkles size={16} class="action-icon" />
+							<div class="action-text">
+								<span class="action-label">Cenário:</span>
+								<MarkdownText text={finding.scenario} />
+							</div>
+						</div>
+					)}
+
+					{finding.impact && (
+						<div class="action-block">
+							<Sparkles size={16} class="action-icon" />
+							<div class="action-text">
+								<span class="action-label">Impacto:</span>
+								<MarkdownText text={finding.impact} />
+							</div>
+						</div>
+					)}
+
 					<div class="action-block">
 						<Sparkles size={16} class="action-icon" />
 						<div class="action-text">

package/src/server/client/RunsSection.tsx

@@ -30,6 +30,11 @@ function RunItem({
 			<span class="run-top">
 				<BranchIcon size={14} class="run-icon" />
 				<span class="run-branch">{run.branch}</span>
+				{run.variant ? (
+					<span class="run-variant" title="Variante A/B">
+						{run.variant}
+					</span>
+				) : null}
 			</span>
 			<span class="run-meta">
 				<span class="run-when">

package/src/server/client/utils/constants.ts

@@ -83,13 +83,13 @@ export function describeRunStatus(
 
 /** Ordem canônica dos tipos de artefato na lista da UI. */
 const KIND_ORDER: ArtifactKind[] = [
-	"review",
+	"compare",
 	"resume",
 	"technical",
-	"domain-review",
 	"verify",
 	"brief",
 	"manifest",
+	"prepare",
 	"classification",
 	"candidates",
 	"ast",
@@ -100,6 +100,8 @@ const KIND_ORDER: ArtifactKind[] = [
 	"context",
 	"context-brief",
 	"context-summary",
+	"business",
+	"business-brief",
 	"finding-report",
 	"other",
 ];
@@ -107,12 +109,12 @@ const KIND_ORDER: ArtifactKind[] = [
 /** Grupo visual de cada tipo (relatórios, briefs, núcleo, contexto…). */
 const GROUP_BY_KIND: Record<ArtifactKind, { key: string; label: string; order: number }> =
 	{
-		review: { key: "report", label: "Relatórios", order: 0 },
+		compare: { key: "report", label: "Relatórios", order: 0 },
 		resume: { key: "report", label: "Relatórios", order: 0 },
 		technical: { key: "core", label: "Núcleo da revisão", order: 3 },
-		"domain-review": { key: "report", label: "Relatórios", order: 0 },
 		verify: { key: "verify", label: "Verificação", order: 1 },
 		brief: { key: "brief", label: "Briefs (auditoria)", order: 2 },
+		prepare: { key: "core", label: "Núcleo da revisão", order: 3 },
 		manifest: { key: "core", label: "Núcleo da revisão", order: 3 },
 		classification: { key: "core", label: "Núcleo da revisão", order: 3 },
 		candidates: { key: "core", label: "Núcleo da revisão", order: 3 },
@@ -124,17 +126,19 @@ const GROUP_BY_KIND: Record<ArtifactKind, { key: string; label: string; order: n
 		context: { key: "context", label: "Contexto da PR", order: 5 },
 		"context-brief": { key: "context", label: "Contexto da PR", order: 5 },
 		"context-summary": { key: "context", label: "Contexto da PR", order: 5 },
+		business: { key: "business", label: "Intenção da PR", order: 5 },
+		"business-brief": { key: "business", label: "Intenção da PR", order: 5 },
 		"finding-report": { key: "other", label: "Outros", order: 6 },
 		other: { key: "other", label: "Outros", order: 6 },
 	};
 
 /** Rótulo curto do tipo (badge do item). */
 export const ARTIFACT_KIND_LABELS: Record<ArtifactKind, string> = {
-	review: "relatório",
+	compare: "comparação",
 	resume: "resumo",
 	technical: "pontos técnicos",
-	"domain-review": "domínio",
 	verify: "verify",
+	prepare: "prepare",
 	brief: "brief",
 	manifest: "manifesto",
 	classification: "classificação",
@@ -147,6 +151,8 @@ export const ARTIFACT_KIND_LABELS: Record<ArtifactKind, string> = {
 	context: "contexto",
 	"context-brief": "brief ctx",
 	"context-summary": "resumo ctx",
+	business: "intenção",
+	"business-brief": "brief intenção",
 	"finding-report": "findings",
 	other: "outro",
 };
@@ -161,16 +167,16 @@ export function displayArtifactName(meta: ArtifactMeta): string {
 /** Descrição curta do artefato (cabeçalho do painel). */
 export function describeArtifact(meta: ArtifactMeta): string {
 	switch (meta.kind) {
-		case "review":
-			return "Relatório consolidado da revisão — o entregável.";
+		case "compare":
+			return "Comparação A/B entre duas runs: achados novos/sumidos, cobertura, tempo e tokens.";
 		case "resume":
-			return "Resumo final da revisão: visão de negócio e estrutura técnica (leitura humana).";
+			return "Resumo final: negócio, pontos técnicos, cobertura por domínio e conclusão.";
 		case "technical":
 			return "Destaques estruturais da mudança (módulos, contratos, dependências) usados no resumo final.";
-		case "domain-review":
-			return "Relatório isolado do domínio: achados daquele watchdog.";
 		case "verify":
 			return "Resultado do `findings verify` (resolvidos, persistentes e incertos).";
+		case "prepare":
+			return "Duração por etapa do prepare e uso de IA (diagnóstico de performance).";
 		case "brief":
 			return "Instruções enviadas ao subagente (auditoria do prompt).";
 		case "manifest":
@@ -189,6 +195,10 @@ export function describeArtifact(meta: ArtifactMeta): string {
 			return "Brief do subagente que resume o contexto da PR.";
 		case "context-summary":
 			return "Resumo da PR (objetivo, motivação e alterações) gerado no Passo 0.";
+		case "business":
+			return "Modelo de intenção da PR: o que ela deve entregar (fluxos, invariantes, contratos e estados).";
+		case "business-brief":
+			return "Brief do passo de intenção (subagente na skill / pré-passe maki).";
 		default:
 			return meta.name;
 	}

package/src/server/client/utils/markdown.ts

@@ -240,7 +240,7 @@ export function sectionBlocks(text: string, title: string): MarkdownBlock[] {
 const FILE_EXTENSION =
 	/\.(?:[cm]?[jt]sx?|json|md|ya?ml|toml|css|scss|html?|py|go|rs|java|kt|cs|php|rb|sh|sql|txt|lock)$/i;
 
-/** Caminho/arquivo dentro de um texto corrido (`src/foo.ts`, `review.md`). */
+/** Caminho/arquivo dentro de um texto corrido (`src/foo.ts`, `manifest.json`). */
 const PATH_TOKEN =
 	/(?:[\w.-]+[\\/])*[\w-]+\.(?:[cm]?[jt]sx?|json|md|ya?ml|toml|css|scss|html?|py|go|rs|java|kt|cs|php|rb|sh|sql|txt|lock)\b/g;
 

package/src/server/client/utils/types.ts

@@ -32,6 +32,14 @@ export type Finding = {
 	message: string;
 	action: string;
 	evidence?: string;
+	/** Gatilho concreto do gap (fora de regra). */
+	scenario?: string;
+	/** Consequência observável do gap. */
+	impact?: string;
+	/** Confiança do revisor (0–1). */
+	confidence?: number;
+	/** Origem do achado: regra, lógica ou domínio. */
+	basis?: "rule" | "logic" | "domain";
 	count: number;
 	present: boolean;
 	decision: Decision;
@@ -59,17 +67,19 @@ 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"
+	| "prepare"
+	| "compare"
 	| "other";
 
 /** Metadados de artefato retornados pela API (sem conteúdo). */
@@ -83,6 +93,8 @@ export type ArtifactMeta = {
 export type RunSummary = {
 	slug: string;
 	branch: string;
+	/** Variante A/B (ausente = run principal da branch). */
+	variant?: string;
 	/** Worktree onde a run foi executada (ausente = clone principal). */
 	worktreePath?: string;
 	prNumber?: number;