@payconductor/houndsman 0.10.0 → 0.12.0

package/src/core/registry-check.ts

@@ -282,12 +282,7 @@ function checkAiConfig(
 	if (ai.enabled !== false && ai.model !== undefined && !ai.model.trim()) {
 		warnings.push("ai.model vazio — usando o default.");
 	}
-	for (const key of [
-		"concurrency",
-		"maxSteps",
-		"maxOutputTokens",
-		"timeoutMs",
-	] as const) {
+	for (const key of ["concurrency", "timeoutMs"] as const) {
 		const value = ai[key];
 		if (value !== undefined && value <= 0) {
 			warnings.push(`ai.${key} = ${value} — não-positivo; usando o default.`);
@@ -303,15 +298,10 @@ function checkAiConfig(
 			`ai.maxTokensPerReview = ${ai.maxTokensPerReview} — negativo; sem teto.`,
 		);
 	}
-	for (const [id, override] of Object.entries(ai.watchdogs ?? {})) {
+	for (const id of Object.keys(ai.watchdogs ?? {})) {
 		if (!config.watchdogIds.includes(id)) {
 			warnings.push(`ai.watchdogs['${id}'] não corresponde a nenhum watchdog.`);
 		}
-		if (override.maxSteps !== undefined && override.maxSteps <= 0) {
-			warnings.push(
-				`ai.watchdogs['${id}'].maxSteps não-positivo — usando o default.`,
-			);
-		}
 	}
 
 	const provider = ai.provider ?? "deepseek";

package/src/core/rule-text.ts

@@ -1,14 +1,10 @@
 /**
- * Texto de regra (biblioteca) — fonte única de polaridade e prefixos reservados.
+ * Texto de regra (biblioteca) — fonte única dos prefixos de polaridade.
  *
- * `RuleAnalyzer`, `registry-check` e o harness usam as mesmas listas: evita
- * divergência entre “Promover/Evitar” no analyzer e as validações anti-drift.
- * Também define o vocabulário de findings emergentes (lógica/domínio).
+ * `registry-check` usa a mesma lista para validar que a regra declara
+ * “Promover/Evitar” explicitamente.
  */
 
-/** Intenção de uma regra. */
-export type RuleIntent = "promote" | "avoid";
-
 /** Palavras que abrem uma regra de “deve acontecer”. */
 export const PROMOTE_PREFIXES = [
 	"promover",
@@ -29,12 +25,6 @@ export const AVOID_PREFIXES = [
 	"jamais",
 ] as const;
 
-/** Conjunto normalizado (usado para remover polaridade das keywords). */
-export const POLARITY_WORDS: ReadonlySet<string> = new Set([
-	...PROMOTE_PREFIXES,
-	...AVOID_PREFIXES,
-]);
-
 /** Escapa um literal para uso em regex. */
 function escapeWord(word: string): string {
 	return word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -48,50 +38,8 @@ function patternFor(words: readonly string[]): RegExp {
 const PROMOTE_PATTERN = patternFor(PROMOTE_PREFIXES);
 const AVOID_PATTERN = patternFor(AVOID_PREFIXES);
 
-/** Polaridade explícita; sem prefixo conhecido, assume `avoid`. */
-export function polarityOf(text: string): RuleIntent {
-	const normalized = text.trim().toLowerCase();
-	if (PROMOTE_PATTERN.test(normalized)) return "promote";
-	if (AVOID_PATTERN.test(normalized)) return "avoid";
-	return "avoid";
-}
-
 /** `true` quando a regra declara polaridade explícita. */
 export function hasExplicitPolarity(text: string): boolean {
 	const normalized = text.trim().toLowerCase();
 	return PROMOTE_PATTERN.test(normalized) || AVOID_PATTERN.test(normalized);
 }
-
-/** Prefixos reservados para findings emergentes (fora das regras explícitas). */
-export const EMERGENT_PREFIXES = {
-	logic: "Lógica:",
-	domain: "Domínio:",
-} as const;
-
-/** Espécie de finding emergente. */
-export type EmergentKind = keyof typeof EMERGENT_PREFIXES;
-
-/** Espécie de um finding emergente (`null` quando não é emergente). */
-export function emergentKind(rule: string): EmergentKind | null {
-	const normalized = rule.trim();
-	if (normalized.startsWith(EMERGENT_PREFIXES.logic)) return "logic";
-	if (normalized.startsWith(EMERGENT_PREFIXES.domain)) return "domain";
-	return null;
-}
-
-/** `true` quando a regra usa um prefixo emergente. */
-export function isEmergentRule(rule: string): boolean {
-	return emergentKind(rule) !== null;
-}
-
-/** Texto que sobra após o prefixo (vazio é inválido). */
-export function emergentText(rule: string): string {
-	const kind = emergentKind(rule);
-	if (!kind) return "";
-	return rule.trim().slice(EMERGENT_PREFIXES[kind].length).trim();
-}
-
-/** Monta o texto de um finding emergente. */
-export function emergentRule(kind: EmergentKind, text: string): string {
-	return `${EMERGENT_PREFIXES[kind]} ${text.trim()}`;
-}

package/src/core/services/git-repository.ts

@@ -138,6 +138,14 @@ export class GitRepository {
 		return parseNumstat(this.run(["diff", "--numstat", "-z", range]));
 	}
 
+	/**
+	 * Patch com contexto zero (`git diff -U0 range`), sem truncar por arquivo.
+	 * É compacto e exato nas linhas — base do escopo do diff e do delta AST.
+	 */
+	patchZeroContext(range: string): Map<string, string> {
+		return parseDiffIndex(this.run(["diff", "-U0", range]));
+	}
+
 	/** Patch por arquivo de um intervalo, opcionalmente restrito a `paths`. */
 	diffPatch(
 		range: string,

package/src/core/services/worktree-manager.ts

@@ -10,12 +10,17 @@
  * truncado porque o checkout de uma PR herda a profundidade dos arquivos do
  * projeto, e o Windows (MAX_PATH = 260) estoura "Filename too long" com
  * repo+branch longos. O hash mantém o nome determinístico e único.
+ *
+ * Cada worktree recebe o espelho da camada gerada (`.houndsman/core`) do clone
+ * principal — o checkout não traz arquivos ignorados e, sem ela, a config do
+ * projeto não importa (`../core/types`).
  */
 
 import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createGitRunner } from "../git-runner";
+import { CORE_DIR } from "../paths";
 import { sanitizeBranch } from "../report-builder";
 import { worktreesRoot } from "../storage/paths";
 import { GitRepository } from "./git-repository";
@@ -59,7 +64,7 @@ export type RemoveWorktreeResult = {
 /** Opções do gerenciador. */
 export type WorktreeManagerOptions = {
 	repoKey: string;
-	/** Raiz do clone principal. */
+	/** Raiz do clone principal (fonte da camada gerada espelhada). */
 	repoRoot: string;
 	/**
 	 * Raiz onde os diretórios por repositório são criados.
@@ -112,6 +117,54 @@ function isInside(root: string, path: string): boolean {
 	return rel === "" || (!rel.startsWith("..") && !rel.split(sep).includes(".."));
 }
 
+/** Raiz do clone principal a partir do diretório git comum (ou `null`). */
+function mainRootOf(git: GitRepository): string | null {
+	const common = git.gitCommonDir();
+	if (!common) return null;
+	const gitDir = resolve(common);
+	return basename(gitDir).toLowerCase() === ".git" ? dirname(gitDir) : null;
+}
+
+/**
+ * Espelha a camada gerada (`.houndsman/core`) do clone principal no worktree.
+ *
+ * O checkout de uma PR só traz arquivos versionados e `core/` é gerado (e
+ * ignorado pelo git). Sem ele, qualquer comando dentro do worktree falha ao
+ * importar `../core/types` a partir dos watchdogs. Fail-open: nunca bloqueia
+ * a revisão.
+ */
+export function syncProjectLayer(mainRoot: string, worktreeRoot: string): boolean {
+	const source = join(mainRoot, CORE_DIR);
+	const dest = join(worktreeRoot, CORE_DIR);
+	if (normalizePath(source) === normalizePath(dest)) return false;
+	if (!existsSync(source)) return false;
+	try {
+		mkdirSync(dirname(dest), { recursive: true });
+		cpSync(source, dest, { recursive: true, force: true });
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * Auto-reparo para comandos executados **dentro** de um worktree: repõe a
+ * camada gerada a partir do clone principal quando ela não existe ali. No
+ * clone principal (camada presente) é no-op. Fail-open.
+ */
+export function syncProjectLayerForRoot(root: string): boolean {
+	try {
+		const git = new GitRepository(createGitRunner(root));
+		const gitRoot = git.rootPath();
+		if (!gitRoot || existsSync(join(gitRoot, CORE_DIR))) return false;
+		const mainRoot = mainRootOf(git);
+		if (!mainRoot) return false;
+		return syncProjectLayer(mainRoot, gitRoot);
+	} catch {
+		return false;
+	}
+}
+
 /** Fatia a saída de `git worktree list --porcelain` em entradas. */
 export function parseWorktreeList(raw: string): WorktreeEntry[] {
 	const entries: WorktreeEntry[] = [];
@@ -150,11 +203,13 @@ export function parseWorktreeList(raw: string): WorktreeEntry[] {
 export class WorktreeManager {
 	private readonly git: GitRepository;
 	private readonly repoKey: string;
+	private readonly repoRoot: string;
 	private readonly rootDir: string;
 
 	constructor(git: GitRepository, options: WorktreeManagerOptions) {
 		this.git = git;
 		this.repoKey = options.repoKey;
+		this.repoRoot = options.repoRoot;
 		this.rootDir = join(
 			options.baseDir ?? worktreesRoot(),
 			repoSlug(options.repoKey),
@@ -214,6 +269,7 @@ export class WorktreeManager {
 
 		if (existing) {
 			if (existing.head === target) {
+				syncProjectLayer(this.repoRoot, path);
 				return { path, head: target, created: false, reused: true };
 			}
 			const checkout = new GitRepository(createGitRunner(path)).tryRun([
@@ -222,6 +278,7 @@ export class WorktreeManager {
 				target,
 			]);
 			if (checkout.ok) {
+				syncProjectLayer(this.repoRoot, path);
 				return { path, head: target, created: false, reused: true };
 			}
 			// Worktree quebrado/inacessível: remove e recria do zero.
@@ -251,6 +308,8 @@ export class WorktreeManager {
 				);
 			}
 		}
+		// A camada gerada é ignorada pelo git e não vem no checkout da PR.
+		syncProjectLayer(this.repoRoot, path);
 		return { path, head: target, created: true, reused: false };
 	}
 

package/src/core/storage/types.ts

@@ -110,7 +110,6 @@ export type ArtifactKind =
 	| "ai"
 	| "ai-usage"
 	| "ai-brief"
-	| "harness-transcript"
 	| "other";
 
 /** Artefato persistido de uma review. */

package/src/core/types.ts

@@ -8,6 +8,7 @@
 
 import type { BriefPlan } from "./ai/schemas";
 import type { AstFileBrief } from "./ast/types";
+import type { ChangedScope } from "./changed-scope";
 import type { JevRuleSpec } from "./jev/jev-types";
 
 /** Severidade de um achado. `blocking` bloqueia o merge. */
@@ -29,19 +30,6 @@ export const SEVERITY_EMOJI: Record<Severity, string> = {
 	nit: "🔎",
 };
 
-/**
- * Sinais opcionais de uma regra: ajudam o `RuleAnalyzer` a transformar texto
- * em checagens concretas (símbolos, imports, decorators, paths e tools).
- */
-export type RuleHints = {
-	symbols?: string[];
-	imports?: string[];
-	decorators?: string[];
-	paths?: string[];
-	/** Nomes de tools sugeridos (ex.: `symbol_context`). */
-	checks?: string[];
-};
-
 /**
  * Regra do watchdog: severidade + texto. O texto declara a polaridade de forma
  * explícita — `Promover:` (algo que DEVE acontecer) ou `Evitar:`/`Não`/`Nunca`
@@ -54,7 +42,6 @@ export type Rule = {
 	severity: Severity;
 	text: string;
 	jev?: JevRuleSpec;
-	hints?: RuleHints;
 };
 
 /**
@@ -144,6 +131,8 @@ export type WatchdogRenderArgs = {
 	ast?: readonly AstFileBrief[];
 	/** Plano de revisão sugerido por IA (nunca substitui as regras). */
 	aiPlan?: BriefPlan;
+	/** Escopo do diff por arquivo (símbolos alterados; hunks como fallback). */
+	changedScope?: ChangedScope;
 };
 
 /** Definição completa de um watchdog — 1 por arquivo em `project/watchdogs/`. */

package/src/index.ts

@@ -7,7 +7,6 @@
 
 export type {
 	AiResult,
-	AiTool,
 	AiUsage,
 	ModelProvider,
 	ModelRequest,
@@ -26,7 +25,14 @@ export {
 } from "./core/ai";
 export { ArgParser } from "./core/arg-parser";
 export { assetPath, OUTPUT_FORMAT_FILE } from "./core/assets";
-export { computeDelta, emptyDelta, parseHunks } from "./core/ast/diff";
+export {
+	changedAnchorLines,
+	changedAnchors,
+	changedNewLines,
+	computeDelta,
+	emptyDelta,
+	parseHunks,
+} from "./core/ast/diff";
 export { buildImpact, resolveImport } from "./core/ast/impact";
 export { AstParser, languageForPath } from "./core/ast/parser";
 export { AstService } from "./core/ast/service";
@@ -44,6 +50,23 @@ export type {
 	AstSymbolKind,
 } from "./core/ast/types";
 export { defaultRenderBrief, PROCEDURE, renderBrief } from "./core/brief";
+export type {
+	BuildChangedScopeInput,
+	ChangedScope,
+	ChangedScopeSource,
+	ChangedSymbol,
+	FileChangedScope,
+	LineRange,
+	ScopeEntry,
+} from "./core/changed-scope";
+export {
+	buildChangedScope,
+	formatRanges,
+	formatSymbols,
+	isLineInScope,
+	mergeRanges,
+	summarizeScope,
+} from "./core/changed-scope";
 export type { FindingsCommandResult } from "./core/commands/findings";
 export { runFindingsCommand, runVerifyCommand } from "./core/commands/findings";
 export { ProjectScaffolder } from "./core/commands/scaffold";
@@ -231,7 +254,6 @@ export type {
 	FileStatus,
 	FileStatusMap,
 	Rule,
-	RuleHints,
 	Severity,
 	WatchdogDefinition,
 	WatchdogMeta,

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

@@ -97,7 +97,6 @@ const KIND_ORDER: ArtifactKind[] = [
 	"ai",
 	"ai-usage",
 	"ai-brief",
-	"harness-transcript",
 	"context",
 	"context-brief",
 	"context-summary",
@@ -119,10 +118,9 @@ const GROUP_BY_KIND: Record<ArtifactKind, { key: string; label: string; order: n
 		candidates: { key: "core", label: "Núcleo da revisão", order: 3 },
 		ast: { key: "core", label: "Núcleo da revisão", order: 3 },
 		"ast-impact": { key: "core", label: "Núcleo da revisão", order: 3 },
-		ai: { key: "ai", label: "IA e harness", order: 4 },
-		"ai-usage": { key: "ai", label: "IA e harness", order: 4 },
-		"ai-brief": { key: "ai", label: "IA e harness", order: 4 },
-		"harness-transcript": { key: "ai", label: "IA e harness", order: 4 },
+		ai: { key: "ai", label: "IA", order: 4 },
+		"ai-usage": { key: "ai", label: "IA", order: 4 },
+		"ai-brief": { key: "ai", label: "IA", order: 4 },
 		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 },
@@ -146,7 +144,6 @@ export const ARTIFACT_KIND_LABELS: Record<ArtifactKind, string> = {
 	ai: "ia",
 	"ai-usage": "uso ia",
 	"ai-brief": "plano ia",
-	"harness-transcript": "transcript",
 	context: "contexto",
 	"context-brief": "brief ctx",
 	"context-summary": "resumo ctx",

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

@@ -70,7 +70,6 @@ export type ArtifactKind =
 	| "ai"
 	| "ai-usage"
 	| "ai-brief"
-	| "harness-transcript"
 	| "other";
 
 /** Metadados de artefato retornados pela API (sem conteúdo). */

package/src/skill/OUTPUT-FORMAT.md

@@ -69,6 +69,11 @@ staging global da review:
 - Sem achados → `"findings": []` (arquivo **obrigatório**).
 - Um achado por regra violada; não agrupar regras diferentes.
 - `file:line` sempre que possível; `evidence` quando o achado não é óbvio.
+- **Escopo do diff:** a `line` deve cair dentro das faixas listadas em
+  *Escopo do diff (símbolos alterados)* no brief. Código fora delas é contexto — não é
+  achado desta revisão. Se a alteração quebra código não alterado, ancore o finding na
+  linha alterada que causou o problema.
+- Achado **sem linha** só quando for inerente à alteração (vira comentário de arquivo).
 - Não inventar achados — se não houver violação, o array fica vazio.
 
 ## Findings emergentes (opt-in)

package/src/skill/README.md

@@ -18,7 +18,8 @@ Um único skill (`/houndsman`), quatro capabilities (detalhadas em `hunt.md`, `t
 
 - **houndsman** — o orquestrador/treinador (CLI + motor).
 - **watchdog** — cada agente especialista por domínio que audita o diff.
-- **brief** — instruções prontas para um watchdog (o prompt do subagente).
+- **brief** — instruções prontas para um watchdog (o prompt do subagente), incluindo o
+  **escopo do diff** (faixas/símbolos alterados que podem virar finding).
 - **findings** — os achados que o subagente grava em JSON (único output consumido).
 - **candidato (Jev)** — indício automático; **não** é achado (o watchdog confirma ou refuta).
 - **churn** — linhas adicionadas/removidas por arquivo; usado para priorizar a leitura.

package/src/skill/SETUP.md

@@ -9,7 +9,7 @@ no seu projeto é **autocontida** — não exige nenhuma dependência local do p
 - **git** — o diff usa `git diff <base>...<head> --name-status`.
 - **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_DEEP_SEEK_API_KEY`** (opcional) — features de IA (briefs, contexto, classificação, resumo técnico).
 - **`HOUNDSMAN_OPENAI_API_KEY`** / **`HOUNDSMAN_ANTHROPIC_API_KEY`** (opcional) — apenas se
   `ai.provider` for `openai`/`anthropic`.
 

package/src/skill/fix.md

@@ -132,7 +132,7 @@ Volte ao passo 1. A fila encolhe a cada volta; o `batch` traz o próximo grupo s
 
 ## Perguntas de decisão ao usuário
 
-Pergunte (ferramenta de perguntas do harness) **antes** de corrigir quando o achado for:
+Pergunte (ferramenta de perguntas do agente) **antes** de corrigir quando o achado for:
 
 - ambíguo ou com **múltiplas correções válidas**;
 - uma mudança de **produto/arquitetura** (não é "só código");

package/src/skill/hunt.md

@@ -25,12 +25,6 @@ Traduza o pedido do usuário para flags **antes** de começar:
 **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. Para uma
-> PR específica, `houndsman hunt --pr 456` roda no worktree automaticamente. Detalhes em
-> `docs/HARNESS.md`.
-
 ## Quem executa o quê
 
 - **Você** só invoca o skill: `/houndsman [hunt]`. Não precisa rodar nenhum script à mão.
@@ -62,6 +56,8 @@ mudanças antes de push.
 - **As regras refletem os padrões APLICADOS hoje** — não validar práticas que o projeto
   não adota. Regra sem aplicação real no código gera falso positivo.
 - Cada watchdog recebe apenas seus arquivos relevantes (brief pronto) — nunca o diff completo.
+- O brief traz o **escopo do diff** (símbolos alterados e faixas revisáveis); achado fora
+  dessas faixas é código pré-existente, não escopo desta revisão.
 - Saída estruturada (JSON) por watchdog → consolidada e deduplicada automaticamente.
 
 ---

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

@@ -11,7 +11,7 @@ exports[`baseline — brief defaultRenderBrief (contexto, churn, overflow, candi
 
 Watchdog baseline.
 
-## Escopo
+## Escopo do domínio
 
 src/alpha/**
 
@@ -63,10 +63,10 @@ src/alpha/**
 ## Procedimento
 
 1. **FILTER** — descarte o que não for do seu domínio (ver *Prioridade de leitura* e *Não carregar*).
-2. **READ HEAD** — leia os arquivos seletivamente (primeiras ~30 linhas). NUNCA o diff completo.
-3. **GREP** — use as regras críticas/anti-padrões como heurística para localizar violações.
-4. **DEEP-READ** — aprofunde apenas os arquivos com suspeita de violação.
-5. **CONCLUDE** — grave o JSON no caminho de output, com \`reviewedFiles\` preenchido. Sem achados → \`"findings": []\` (arquivo obrigatório). Não escreva markdown livre."
+2. **READ SCOPE** — carregue apenas as faixas alteradas em *Escopo do diff*; o restante do arquivo é só contexto.
+3. **GREP** — use as regras críticas/anti-padrões como heurística para localizar violações nas faixas alteradas.
+4. **DEEP-READ** — aprofunde apenas as faixas com suspeita de violação dentro do escopo.
+5. **CONCLUDE** — grave o JSON no caminho de output, com \`reviewedFiles\` preenchido e \`line\` dentro das faixas alteradas. Sem achados → \`"findings": []\` (arquivo obrigatório). Não escreva markdown livre."
 `;
 
 exports[`baseline — relatório renderReport consolidado 1`] = `
@@ -405,16 +405,6 @@ export type Rule = {
 	severity: Severity;
 	text: string;
 	jev?: JevRuleSpec;
-	hints?: RuleHints;
-};
-
-/** Sinais opcionais de uma regra (símbolos, imports, decorators, paths, checks). */
-export type RuleHints = {
-	symbols?: string[];
-	imports?: string[];
-	decorators?: string[];
-	paths?: string[];
-	checks?: string[];
 };
 
 /** Como o watchdog casa um arquivo alterado. \`value\` é sempre regex. */
@@ -509,20 +499,15 @@ export type HoundsmanAiFeatures = {
 /** Overrides de IA por watchdog. */
 export type HoundsmanAiWatchdog = {
 	model?: string;
-	maxSteps?: number;
-	maxOutputTokens?: number;
 };
 
-/** Configuração da camada de IA (briefs, contexto, classificação e hunt nativo). */
+/** Configuração da camada de IA (briefs, contexto, classificação, pré-análise, verify). */
 export type HoundsmanAi = {
 	enabled?: boolean;
 	provider?: AiProviderKind;
 	model?: string;
 	baseURL?: string;
 	concurrency?: number;
-	maxSteps?: number;
-	maxOutputTokens?: number;
-	temperature?: number;
 	providerOptions?: AiProviderOptions;
 	timeoutMs?: number;
 	maxCallsPerReview?: number;
@@ -665,15 +650,15 @@ exports[`baseline — camada gerada setup gera os mesmos arquivos e conteúdos 3
   },
   {
     "file": ".houndsman/core/skill/OUTPUT-FORMAT.md",
-    "sha256": "94ea2b8def871784",
+    "sha256": "a78ed16d4d211889",
   },
   {
     "file": ".houndsman/core/skill/README.md",
-    "sha256": "1738ef9c6d9ec919",
+    "sha256": "9aadf51b48c7f304",
   },
   {
     "file": ".houndsman/core/skill/SETUP.md",
-    "sha256": "b74af7e1979bf1b4",
+    "sha256": "5e5335870f493aba",
   },
   {
     "file": ".houndsman/core/skill/example-review.md",
@@ -681,11 +666,11 @@ exports[`baseline — camada gerada setup gera os mesmos arquivos e conteúdos 3
   },
   {
     "file": ".houndsman/core/skill/fix.md",
-    "sha256": "9f10b2d846dc7db5",
+    "sha256": "5782f4880af78d29",
   },
   {
     "file": ".houndsman/core/skill/hunt.md",
-    "sha256": "1cf68076325da4ab",
+    "sha256": "dfaec1a665d7ee65",
   },
   {
     "file": ".houndsman/core/skill/train.md",
@@ -702,6 +687,7 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
 "Discovery: 1 watchdog(s) ativado(s), 3 arquivo(s), 1 deletado(s).
 Briefs: <cwd>/.home/work/<uuid>/briefs/
 Deletado (breaking change): src/alpha/old.ts
+Escopo: 2 arquivo(s), 0 símbolo(s) em 2 faixa(s) alterada(s).
 Jev: pulado (desativado (--no-jev)).
 AST: desabilitado ou sem grammar compatível.
 Sem contexto da PR (rode \`bun run houndsman context\` antes, se houver PR).
@@ -753,7 +739,29 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
   },
   "excludedCount": 0,
   "headSha": "<sha>",
-  "mode": "full"
+  "mode": "full",
+  "changedScope": {
+    "src/alpha/a.ts": {
+      "ranges": [
+        {
+          "start": 1,
+          "end": 2
+        }
+      ],
+      "symbols": [],
+      "source": "hunks"
+    },
+    "src/alpha/b.ts": {
+      "ranges": [
+        {
+          "start": 1,
+          "end": 1
+        }
+      ],
+      "symbols": [],
+      "source": "hunks"
+    }
+  }
 }
 "
 `;
@@ -827,10 +835,20 @@ exports[`baseline — artefatos de prepare/finalize gera classification, brief,
 
 Watchdog baseline.
 
-## Escopo
+## Escopo do domínio
 
 src/alpha/**
 
+## Escopo do diff (símbolos alterados)
+
+> **Regra de escopo:** um finding só é válido quando a \`line\` está nas faixas
+> abaixo. Código fora delas é contexto — use para entender o impacto, nunca
+> como achado. Se a mudança quebra código não alterado, ancore o finding na
+> linha alterada que causou o problema.
+
+- \`src/alpha/a.ts\` — linhas 1-2 _(faixas do diff)_
+- \`src/alpha/b.ts\` — linhas 1 _(faixas do diff)_
+
 ## Regras (por severidade)
 
 - ❌ **blocking** — Nunca usar \`any\`.
@@ -852,10 +870,10 @@ src/alpha/**
 ## Procedimento
 
 1. **FILTER** — descarte o que não for do seu domínio (ver *Prioridade de leitura* e *Não carregar*).
-2. **READ HEAD** — leia os arquivos seletivamente (primeiras ~30 linhas). NUNCA o diff completo.
-3. **GREP** — use as regras críticas/anti-padrões como heurística para localizar violações.
-4. **DEEP-READ** — aprofunde apenas os arquivos com suspeita de violação.
-5. **CONCLUDE** — grave o JSON no caminho de output, com \`reviewedFiles\` preenchido. Sem achados → \`"findings": []\` (arquivo obrigatório). Não escreva markdown livre.
+2. **READ SCOPE** — carregue apenas as faixas alteradas em *Escopo do diff*; o restante do arquivo é só contexto.
+3. **GREP** — use as regras críticas/anti-padrões como heurística para localizar violações nas faixas alteradas.
+4. **DEEP-READ** — aprofunde apenas as faixas com suspeita de violação dentro do escopo.
+5. **CONCLUDE** — grave o JSON no caminho de output, com \`reviewedFiles\` preenchido e \`line\` dentro das faixas alteradas. Sem achados → \`"findings": []\` (arquivo obrigatório). Não escreva markdown livre.
 "
 `;
 

package/src/tests/ai-features.test.ts

@@ -11,6 +11,8 @@ import { AiPreAnalyzer } from "../core/ai/features/pre-analyzer";
 import { AiTechnicalSummarizer } from "../core/ai/features/technical-summarizer";
 import { AiVerifier } from "../core/ai/features/verifier";
 import { briefInstructions, briefPrompt } from "../core/ai/prompts/brief";
+import { contextInstructions } from "../core/ai/prompts/context";
+import { technicalInstructions } from "../core/ai/prompts/technical";
 import { renderBrief } from "../core/brief";
 import { ProjectConfig } from "../core/project-config";
 import { FakeModelProvider } from "./fixtures/fake-model-provider";
@@ -217,3 +219,12 @@ describe("AiPreAnalyzer", () => {
 		).toEqual([]);
 	});
 });
+
+describe("idioma dos resumos", () => {
+	test("prompts de contexto e pontos técnicos exigem pt-BR", () => {
+		for (const instructions of [contextInstructions(), technicalInstructions()]) {
+			expect(instructions).toContain("português do Brasil");
+			expect(instructions).toContain("pt-BR");
+		}
+	});
+});