@payconductor/houndsman 0.6.0 → 0.8.0

package/src/server/client/Sidebar.tsx

@@ -0,0 +1,452 @@
+/**
+ * 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,
+	PrWorktreeResponse,
+	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,
+	worktreeBusy,
+	onConfirm,
+	onCancel,
+	onCheckout,
+	onCreateWorktree,
+	onSelectRun,
+}: {
+	pr: PrListItem;
+	currentBranch: string | null;
+	worktree: WorktreeState;
+	busy: boolean;
+	confirming: boolean;
+	worktreeBusy: boolean;
+	onConfirm: (number: number) => void;
+	onCancel: () => void;
+	onCheckout: (pr: PrListItem) => void;
+	onCreateWorktree: (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>}
+			{pr.worktreePath && (
+				<p class="pr-worktree" title={pr.worktreePath}>
+					Worktree: <code>{pr.worktreePath}</code>
+				</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.worktreePath && (
+					<button
+						type="button"
+						class="pr-btn"
+						disabled={busy || worktreeBusy}
+						title={`Criar um worktree dedicado para ${pr.headRefName} (revisão paralela)`}
+						onClick={() => onCreateWorktree(pr)}
+					>
+						{worktreeBusy ? (
+							<Spinner size={12} class="icon spin" />
+						) : (
+							"Worktree"
+						)}
+					</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 [worktreeBusy, setWorktreeBusy] = 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],
+	);
+	const createWorktree = useCallback(
+		async (pr: PrListItem) => {
+			setWorktreeBusy(pr.number);
+			setError("");
+			setNotice("");
+			try {
+				const result = await api<PrWorktreeResponse>("/api/prs/worktree", {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ number: pr.number }),
+				});
+				if (!result.ok) {
+					setError(result.detail);
+					return;
+				}
+				setNotice(
+					`Worktree de #${pr.number} em ${result.path}. ` +
+						`Rode \`houndsman --pr ${pr.number}\` para revisar em paralelo.`,
+				);
+				await loadPrs();
+			} catch (err) {
+				setError(String(err));
+			} finally {
+				setWorktreeBusy(null);
+			}
+		},
+		[loadPrs],
+	);
+	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}
+								worktreeBusy={worktreeBusy === pr.number}
+								onConfirm={setConfirming}
+								onCancel={() => setConfirming(null)}
+								onCheckout={checkout}
+								onCreateWorktree={createWorktree}
+								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

@@ -120,6 +120,16 @@ export const Alert = (p: IconProps) => (
 	</Svg>
 );
 
+/** Lixeira — excluir a run. */
+export const Trash = (p: IconProps) => (
+	<Svg {...p}>
+		<path d="M4 7h16" />
+		<path d="M9 7V4h6v3" />
+		<path d="m6.5 7 1 13h9l1-13" />
+		<path d="M10 11v6M14 11v6" />
+	</Svg>
+);
+
 export const ListIcon = (p: IconProps) => (
 	<Svg {...p}>
 		<path d="M9 6h12M9 12h12M9 18h12" />
@@ -158,3 +168,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

@@ -245,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";
+}