@payconductor/houndsman 0.5.0 → 0.7.0

package/src/server/client/Sidebar.tsx

@@ -0,0 +1,397 @@
+/**
+ * Sidebar: logo do houndsman + abas `Execuções` e `PR's`.
+ *
+ * A aba de execuções mantém a lista de runs (status, data e findings). A aba de
+ * PRs lista as PRs abertas via `gh`, permite abrir a run correspondente e faz
+ * checkout somente quando a árvore de trabalho está limpa.
+ */
+
+import { useCallback, useEffect, useRef, useState } from "preact/hooks";
+import {
+	BranchIcon,
+	Clock,
+	GitHub,
+	GitPullRequest,
+	ListIcon,
+	Refresh,
+	Sparkles,
+	Spinner,
+} from "./icons";
+import { api } from "./utils/api";
+import { describeRunStatus } from "./utils/constants";
+import { formatRunTime } from "./utils/format";
+import type {
+	CheckoutResponse,
+	PrListItem,
+	PrListResponse,
+	RunSummary,
+	WorktreeState,
+} from "./utils/types";
+
+type SidebarView = "runs" | "prs";
+
+const REVIEW_LABELS: Record<string, string> = {
+	APPROVED: "aprovada",
+	CHANGES_REQUESTED: "mudanças",
+	REVIEW_REQUIRED: "revisão pendente",
+};
+
+function RunItem({
+	run,
+	active,
+	onSelect,
+}: {
+	run: RunSummary;
+	active: boolean;
+	onSelect: (slug: string) => void;
+}) {
+	const status = describeRunStatus(run);
+	const fixReady = status?.kind === "fix_done";
+	return (
+		<button
+			type="button"
+			title={`Abrir a run da branch ${run.branch}`}
+			class={`run${active ? " active" : ""}`}
+			onClick={() => onSelect(run.slug)}
+		>
+			<span class="run-top">
+				<BranchIcon size={14} class="run-icon" />
+				<span class="run-branch">{run.branch}</span>
+			</span>
+			<span class="run-meta">
+				<span class="run-when">
+					<Clock size={12} />
+					{formatRunTime(run.updatedAt) || "sem data"}
+				</span>
+				<span
+					class="run-count"
+					title={`${run.summary.present} de ${run.summary.total} findings presentes`}
+				>
+					{run.summary.present}/{run.summary.total}
+				</span>
+			</span>
+			{fixReady ? (
+				<span class="run-badge">
+					<Sparkles size={12} /> Correção pronta
+				</span>
+			) : (
+				status && (
+					<span class={`run-status status-${status.kind}`}>{status.label}</span>
+				)
+			)}
+		</button>
+	);
+}
+
+function PrItem({
+	pr,
+	currentBranch,
+	worktree,
+	busy,
+	confirming,
+	onConfirm,
+	onCancel,
+	onCheckout,
+	onSelectRun,
+}: {
+	pr: PrListItem;
+	currentBranch: string | null;
+	worktree: WorktreeState;
+	busy: boolean;
+	confirming: boolean;
+	onConfirm: (number: number) => void;
+	onCancel: () => void;
+	onCheckout: (pr: PrListItem) => void;
+	onSelectRun: (slug: string) => void;
+}) {
+	const isCurrent = currentBranch === pr.headRefName;
+	const runSlug = pr.runSlug;
+	const review = pr.reviewDecision ? REVIEW_LABELS[pr.reviewDecision] : undefined;
+	return (
+		<article class={`pr${isCurrent ? " current" : ""}`}>
+			<div class="pr-head">
+				<GitPullRequest size={14} class="pr-icon" />
+				<span class="pr-number">#{pr.number}</span>
+				{pr.isDraft && <span class="tag">draft</span>}
+				{isCurrent && <span class="pr-current">atual</span>}
+				<span class="spacer" />
+				{pr.updatedAt && (
+					<span class="run-when">
+						<Clock size={12} />
+						{formatRunTime(pr.updatedAt)}
+					</span>
+				)}
+			</div>
+			<p class="pr-title">{pr.title}</p>
+			<p class="pr-meta">
+				<span class="pr-branch">{pr.headRefName}</span>
+				<span class="pr-arrow">→</span>
+				<span>{pr.baseRefName || "—"}</span>
+				<span>· {pr.author}</span>
+			</p>
+			{review && <p class={`pr-review pr-review-${pr.reviewDecision}`}>{review}</p>}
+			<div class="pr-actions">
+				{runSlug && (
+					<button
+						type="button"
+						class="pr-btn"
+						title="Abrir a run local desta branch"
+						onClick={() => onSelectRun(runSlug)}
+					>
+						Abrir run
+					</button>
+				)}
+				{pr.url && (
+					<a
+						class="pr-btn"
+						href={pr.url}
+						target="_blank"
+						rel="noreferrer"
+						title="Abrir a PR no GitHub"
+					>
+						<GitHub size={12} /> GitHub
+					</a>
+				)}
+				{confirming ? (
+					<>
+						<button
+							type="button"
+							class="pr-btn danger"
+							disabled={busy}
+							title="Confirmar checkout da PR"
+							onClick={() => onCheckout(pr)}
+						>
+							{busy ? <Spinner size={12} class="icon spin" /> : "Confirmar"}
+						</button>
+						<button
+							type="button"
+							class="pr-btn"
+							disabled={busy}
+							onClick={onCancel}
+						>
+							Cancelar
+						</button>
+					</>
+				) : (
+					<button
+						type="button"
+						class="pr-btn"
+						disabled={!worktree.clean || busy}
+						title={
+							worktree.clean
+								? `Fazer checkout da branch ${pr.headRefName}`
+								: "Há alterações não commitadas — faça commit ou stash antes"
+						}
+						onClick={() => onConfirm(pr.number)}
+					>
+						Checkout
+					</button>
+				)}
+			</div>
+		</article>
+	);
+}
+
+export function Sidebar({
+	runs,
+	slug,
+	onSelect,
+	onRefreshRuns,
+}: {
+	runs: RunSummary[];
+	slug: string | null;
+	onSelect: (slug: string) => void;
+	onRefreshRuns: () => void;
+}) {
+	const [view, setView] = useState<SidebarView>("runs");
+	const [data, setData] = useState<PrListResponse | null>(null);
+	const [loading, setLoading] = useState(false);
+	const [error, setError] = useState("");
+	const [notice, setNotice] = useState("");
+	const [busy, setBusy] = useState<number | null>(null);
+	const [confirming, setConfirming] = useState<number | null>(null);
+	const requested = useRef(false);
+
+	const loadPrs = useCallback(async () => {
+		setLoading(true);
+		setError("");
+		try {
+			setData(await api<PrListResponse>("/api/prs"));
+		} catch (err) {
+			setError(String(err));
+		} finally {
+			setLoading(false);
+		}
+	}, []);
+
+	useEffect(() => {
+		if (view !== "prs" || requested.current) return;
+		requested.current = true;
+		void loadPrs();
+	}, [view, loadPrs]);
+
+	const checkout = useCallback(
+		async (pr: PrListItem) => {
+			setBusy(pr.number);
+			setError("");
+			setNotice("");
+			try {
+				const result = await api<CheckoutResponse>("/api/prs/checkout", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ number: pr.number }),
+				});
+				if (!result.ok) {
+					if (result.reason === "dirty") {
+						setData((current) =>
+							current
+								? {
+										...current,
+										worktree: {
+											...current.worktree,
+											clean: false,
+											changes:
+												result.changes?.length ??
+												current.worktree.changes,
+											sample:
+												result.changes ?? current.worktree.sample,
+										},
+									}
+								: current,
+						);
+					}
+					setError(
+						result.reason === "dirty"
+							? `Checkout bloqueado: ${result.detail}`
+							: result.detail,
+					);
+					return;
+				}
+				setConfirming(null);
+				setNotice(
+					`Checkout de #${pr.number} concluído${
+						result.branch ? ` — ${result.branch}` : ""
+					}.`,
+				);
+				await loadPrs();
+				onRefreshRuns();
+				if (pr.runSlug) onSelect(pr.runSlug);
+			} catch (err) {
+				setError(String(err));
+			} finally {
+				setBusy(null);
+			}
+		},
+		[loadPrs, onRefreshRuns, onSelect],
+	);
+
+	return (
+		<aside class="sidebar">
+			<div class="brand">
+				<img class="logo" src="/assets/logo.png" alt="" />
+				<div>
+					<h1>Houndsman</h1>
+					<p class="sub">Revisões e triagem</p>
+				</div>
+			</div>
+
+			<div class="side-tabs" role="tablist" aria-label="Navegação lateral">
+				<button
+					type="button"
+					role="tab"
+					aria-selected={view === "runs"}
+					class={`side-tab${view === "runs" ? " active" : ""}`}
+					onClick={() => setView("runs")}
+				>
+					<ListIcon size={13} /> Execuções
+					<span class="side-count">{runs.length}</span>
+				</button>
+				<button
+					type="button"
+					role="tab"
+					aria-selected={view === "prs"}
+					class={`side-tab${view === "prs" ? " active" : ""}`}
+					onClick={() => setView("prs")}
+				>
+					<GitPullRequest size={13} /> PR's
+				</button>
+			</div>
+
+			{view === "runs" ? (
+				<nav class="runs" aria-label="Execuções">
+					{runs.length === 0 && <p class="empty">Nenhuma run encontrada.</p>}
+					{runs.map((run) => (
+						<RunItem
+							key={run.slug}
+							run={run}
+							active={run.slug === slug}
+							onSelect={onSelect}
+						/>
+					))}
+				</nav>
+			) : (
+				<>
+					<div class="pr-toolbar">
+						<p class="section-label">PRs abertas</p>
+						<button
+							type="button"
+							class="icon-btn"
+							title="Atualizar lista de PRs"
+							disabled={loading}
+							onClick={() => void loadPrs()}
+						>
+							<Refresh
+								size={13}
+								class={loading ? "icon spin" : undefined}
+							/>
+						</button>
+					</div>
+
+					{error && <p class="error">{error}</p>}
+					{notice && <p class="pr-notice">{notice}</p>}
+					{data && !data.available && (
+						<p class="empty">
+							GitHub indisponível
+							{data.reason ? `: ${data.reason}` : "."}
+						</p>
+					)}
+					{data && !data.worktree.available && (
+						<p class="empty">Não foi possível ler o estado do git.</p>
+					)}
+					{data?.worktree.available && !data.worktree.clean && (
+						<p class="pr-warning">
+							{data.worktree.changes} alteração(ões) não commitada(s) —
+							checkout bloqueado até limpar a árvore.
+						</p>
+					)}
+					{data?.currentBranch && (
+						<p class="pr-current-branch">
+							Branch atual: <code>{data.currentBranch}</code>
+						</p>
+					)}
+
+					<nav class="prs" aria-label="Pull requests abertas">
+						{loading && !data && <p class="empty">Carregando PRs…</p>}
+						{data?.available && data.prs.length === 0 && (
+							<p class="empty">Nenhuma PR aberta.</p>
+						)}
+						{data?.prs.map((pr) => (
+							<PrItem
+								key={pr.number}
+								pr={pr}
+								currentBranch={data.currentBranch}
+								worktree={data.worktree}
+								busy={busy !== null}
+								confirming={confirming === pr.number}
+								onConfirm={setConfirming}
+								onCancel={() => setConfirming(null)}
+								onCheckout={checkout}
+								onSelectRun={onSelect}
+							/>
+						))}
+					</nav>
+				</>
+			)}
+		</aside>
+	);
+}

package/src/server/client/SubmitModal.tsx

@@ -2,8 +2,9 @@
  * Modal "Enviar revisão": publica os findings selecionados como comentários na
  * Pull Request (`POST /submit`, via `gh`).
  *
- * Filtra por severidade e estado de execução, mostra uma prévia curta do que
- * será disparado e o resultado (com o link do comentário geral, quando houver).
+ * Filtra por severidade, decisão (a executar) e estado de execução, mostra uma
+ * prévia curta do que será disparado e o resultado (com o link do comentário
+ * geral, quando houver).
  * Fail-open: sem `gh`/PR o servidor devolve `available:false` e o modal só
  * informa — nada é postado.
  */
@@ -11,8 +12,14 @@
 import { useCallback, useEffect, useMemo, useState } from "preact/hooks";
 import { GitHub, Send, Spinner } from "./icons";
 import { api } from "./utils/api";
-import { EXEC_STATES, SEVERITY_LABELS, SEVERITY_ORDER } from "./utils/constants";
+import {
+	DECISION_LABELS,
+	EXEC_STATES,
+	SEVERITY_LABELS,
+	SEVERITY_ORDER,
+} from "./utils/constants";
 import type {
+	Decision,
 	ExecState,
 	Severity,
 	SubmitOutcome,
@@ -27,6 +34,9 @@ const EXEC_LABELS: Record<ExecState, string> = {
 	stale: "Stale",
 };
 
+/** Decisões elegíveis ao envio: `ignore` fica de fora por definição. */
+const SUBMIT_DECISIONS: Decision[] = ["execute", "pending"];
+
 export function SubmitModal({
 	slug,
 	branch,
@@ -42,6 +52,7 @@ export function SubmitModal({
 }) {
 	const [preview, setPreview] = useState<SubmitPreview | null>(null);
 	const [severities, setSeverities] = useState<Severity[]>([]);
+	const [decisions, setDecisions] = useState<Decision[]>([]);
 	const [execStates, setExecStates] = useState<ExecState[]>([]);
 	const [includeSent, setIncludeSent] = useState(false);
 	const [loading, setLoading] = useState(false);
@@ -86,6 +97,7 @@ export function SubmitModal({
 		if (open) return;
 		setPreview(null);
 		setSeverities([]);
+		setDecisions([]);
 		setExecStates([]);
 		setIncludeSent(false);
 		setLoading(false);
@@ -106,6 +118,12 @@ export function SubmitModal({
 				? current.filter((item) => item !== value)
 				: [...current, value],
 		);
+	const toggleDecision = (value: Decision) =>
+		setDecisions((current) =>
+			current.includes(value)
+				? current.filter((item) => item !== value)
+				: [...current, value],
+		);
 
 	const selected = useMemo(
 		() =>
@@ -113,9 +131,14 @@ export function SubmitModal({
 				(candidate) =>
 					(severities.length === 0 ||
 						severities.includes(candidate.severity)) &&
+					// Servidor antigo ainda em memória pode não mandar `decision`:
+					// nesse caso não escondemos o candidato do filtro.
+					(decisions.length === 0 ||
+						!candidate.decision ||
+						decisions.includes(candidate.decision)) &&
 					(execStates.length === 0 || execStates.includes(candidate.execState)),
 			),
-		[preview, severities, execStates],
+		[preview, severities, decisions, execStates],
 	);
 
 	const toSend = useMemo(
@@ -140,6 +163,7 @@ export function SubmitModal({
 				headers: { "content-type": "application/json" },
 				body: JSON.stringify({
 					severities: severities.length > 0 ? severities : undefined,
+					decisions: decisions.length > 0 ? decisions : undefined,
 					execStates: execStates.length > 0 ? execStates : undefined,
 					includeSent,
 				}),
@@ -155,7 +179,7 @@ export function SubmitModal({
 		} finally {
 			setPosting(false);
 		}
-	}, [slug, severities, execStates, includeSent, onSubmitted]);
+	}, [slug, severities, decisions, execStates, includeSent, onSubmitted]);
 
 	if (!open) return null;
 
@@ -239,6 +263,38 @@ export function SubmitModal({
 									</div>
 								</div>
 
+								<div class="submit-field">
+									<span class="submit-label">Decisão</span>
+									<div class="chips">
+										<button
+											type="button"
+											class={`chip${decisions.length === 0 ? " active" : ""}`}
+											onClick={() => setDecisions([])}
+										>
+											Todas
+										</button>
+										{SUBMIT_DECISIONS.map((decision) => (
+											<button
+												type="button"
+												key={decision}
+												title={
+													decision === "execute"
+														? "Findings marcados como Executar (a executar)"
+														: "Findings ainda não triados"
+												}
+												class={`chip dec-${decision}${
+													decisions.includes(decision)
+														? " active"
+														: ""
+												}`}
+												onClick={() => toggleDecision(decision)}
+											>
+												{DECISION_LABELS[decision]}
+											</button>
+										))}
+									</div>
+								</div>
+
 								<div class="submit-field">
 									<span class="submit-label">Execução</span>
 									<div class="chips">

package/src/server/client/icons.tsx

@@ -158,3 +158,22 @@ export const Send = (p: IconProps) => (
 		<path d="M22 2 15 22l-4-9-9-4z" />
 	</Svg>
 );
+
+/** Pull request — aba de PRs da sidebar. */
+export const GitPullRequest = (p: IconProps) => (
+	<Svg {...p}>
+		<circle cx="6" cy="6" r="2.4" />
+		<circle cx="6" cy="18" r="2.4" />
+		<circle cx="18" cy="18" r="2.4" />
+		<path d="M6 8.4v7.2" />
+		<path d="M18 15.6V12a4 4 0 0 0-4-4h-2.5" />
+		<path d="m13.5 5.5-2.5 2.5 2.5 2.5" />
+	</Svg>
+);
+
+/** Balão de conversa — aba de comentários. */
+export const MessageSquare = (p: IconProps) => (
+	<Svg {...p}>
+		<path d="M21 15a3 3 0 0 1-3 3H8l-5 3V6a3 3 0 0 1 3-3h12a3 3 0 0 1 3 3z" />
+	</Svg>
+);

package/src/server/client/index.tsx

@@ -2,7 +2,7 @@
  * Entry do cliente (Preact): monta o `<App />` no `#app`.
  *
  * Bundle gerado em memória por `Bun.build` (`client-build.ts`). Os componentes
- * vivem em arquivos irmãos nesta pasta (`App.tsx`, `RunList.tsx`, ...).
+ * vivem em arquivos irmãos nesta pasta (`App.tsx`, `Sidebar.tsx`, ...).
  */
 
 import { render } from "preact";

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

@@ -91,6 +91,12 @@ const KIND_ORDER: ArtifactKind[] = [
 	"manifest",
 	"classification",
 	"candidates",
+	"ast",
+	"ast-impact",
+	"ai",
+	"ai-usage",
+	"ai-brief",
+	"harness-transcript",
 	"context",
 	"context-brief",
 	"context-summary",
@@ -109,11 +115,17 @@ const GROUP_BY_KIND: Record<ArtifactKind, { key: string; label: string; order: n
 		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 },
-		context: { key: "context", label: "Contexto da PR", order: 4 },
-		"context-brief": { key: "context", label: "Contexto da PR", order: 4 },
-		"context-summary": { key: "context", label: "Contexto da PR", order: 4 },
-		"finding-report": { key: "other", label: "Outros", order: 5 },
-		other: { key: "other", label: "Outros", order: 5 },
+		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 },
+		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 },
+		"finding-report": { key: "other", label: "Outros", order: 6 },
+		other: { key: "other", label: "Outros", order: 6 },
 	};
 
 /** Rótulo curto do tipo (badge do item). */
@@ -126,6 +138,12 @@ export const ARTIFACT_KIND_LABELS: Record<ArtifactKind, string> = {
 	manifest: "manifesto",
 	classification: "classificação",
 	candidates: "jev",
+	ast: "ast",
+	"ast-impact": "impacto",
+	ai: "ia",
+	"ai-usage": "uso ia",
+	"ai-brief": "plano ia",
+	"harness-transcript": "transcript",
 	context: "contexto",
 	"context-brief": "brief ctx",
 	"context-summary": "resumo ctx",
@@ -159,6 +177,10 @@ export function describeArtifact(meta: ArtifactMeta): string {
 			return "Classificação do diff: watchdogs ativados por arquivo, status (A/M/D/R) e churn.";
 		case "candidates":
 			return "Indícios da pré-análise Jev (regra + arquivo + confiança) — não são achados.";
+		case "ast":
+			return "Fatos estruturais e delta por arquivo (símbolos, imports, exports e assinaturas).";
+		case "ast-impact":
+			return "Impacto reverso: arquivos que importam os alterados e exports públicos modificados.";
 		case "context":
 			return "Payload bruto da PR coletado via `gh` (ou marcador de indisponível).";
 		case "context-brief":
@@ -223,4 +245,6 @@ export const TAB_CAPTIONS = {
 		"Triagem dos achados da revisão: decida Executar, Ignorar ou deixe Pendente — o comentário orienta o auto-fix. Agente: houndsman findings list --decision pending --json · findings done <id>.",
 	artifacts:
 		"Artefatos persistidos da run: relatórios, briefs de auditoria, manifesto, classificação, Jev, contexto da PR e verificação. JSON com destaque de sintaxe; markdown renderizado com highlight de código.",
+	comments:
+		"Comentários da PR vinculada à branch: threads de revisão agrupadas por arquivo e comentários gerais. Carregados sob demanda ao abrir esta aba.",
 } as const;

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

@@ -1,8 +1,10 @@
 /**
- * Helpers de apresentação: data/hora das runs e link para abrir o arquivo no
- * VS Code (`vscode://file/...`).
+ * Helpers de apresentação: data/hora das runs e links para abrir o arquivo no
+ * editor detectado pelo servidor (`vscode://` ou `jetbrains://`).
  */
 
+import type { EditorContext } from "./types";
+
 /** Data/hora curta em pt-BR — ex.: `14 de out., 17:48`. */
 export function formatRunTime(iso?: string): string {
 	if (!iso) return "";
@@ -38,3 +40,46 @@ export function vscodeFileLink(file: string, line?: number | null): string | nul
 	);
 	return `vscode://file/${encodeURI(normalized)}${line ? `:${line}` : ""}`;
 }
+
+/**
+ * Link `jetbrains://<produto>/navigate/reference?project=<nome>&path=<arquivo>`.
+ * O IDE espera o caminho absoluto com a linha no fim (`arquivo:linha`).
+ */
+export function jetbrainsFileLink(
+	file: string,
+	line: number | null | undefined,
+	project: string,
+	product: string,
+): string | null {
+	const path = file.replace(/\\/g, "/");
+	if (!/^([a-zA-Z]:\/|\/)/.test(path)) return null;
+	const target = `${path}${line ? `:${line}` : ""}`;
+	return `jetbrains://${product}/navigate/reference?project=${encodeURIComponent(
+		project,
+	)}&path=${encodeURIComponent(target)}`;
+}
+
+/** Monta o link de código conforme o editor detectado (null = sem link). */
+export function editorFileLink(
+	file: string,
+	line: number | null | undefined,
+	editor: EditorContext,
+): string | null {
+	if (editor.kind === "vscode") return vscodeFileLink(file, line);
+	if (editor.kind === "jetbrains") {
+		return jetbrainsFileLink(
+			file,
+			line,
+			editor.project ?? "",
+			editor.product ?? "idea",
+		);
+	}
+	return null;
+}
+
+/** Rótulo do editor para tooltips. */
+export function editorLabel(editor: EditorContext): string {
+	if (editor.kind === "jetbrains") return "JetBrains";
+	if (editor.kind === "vscode") return "VS Code";
+	return "editor";
+}