@payconductor/houndsman 0.5.0 → 0.7.0

package/src/index.ts

@@ -5,13 +5,53 @@
  * (`houndsman.config.ts`): watchdogs, tipos e helpers de autoria.
  */
 
+export type {
+	AiResult,
+	AiTool,
+	AiUsage,
+	ModelProvider,
+	ModelRequest,
+	ModelResponse,
+} from "./core/ai";
+export {
+	AiBriefEnricher,
+	AiClassifier,
+	AiClient,
+	AiContextSummarizer,
+	AiPreAnalyzer,
+	AiUsageBudget,
+	AiUsageRecorder,
+	AiVerifier,
+	ModelFactory,
+} 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 { buildImpact, resolveImport } from "./core/ast/impact";
+export { AstParser, languageForPath } from "./core/ast/parser";
+export { AstService } from "./core/ast/service";
+export type {
+	AstAnalysis,
+	AstDelta,
+	AstEntry,
+	AstExport,
+	AstFacts,
+	AstFileBrief,
+	AstImpact,
+	AstImport,
+	AstLanguage,
+	AstSymbol,
+	AstSymbolKind,
+} from "./core/ast/types";
 export { defaultRenderBrief, PROCEDURE, renderBrief } from "./core/brief";
 export type { FindingsCommandResult } from "./core/commands/findings";
 export { runFindingsCommand, runVerifyCommand } from "./core/commands/findings";
 export { ProjectScaffolder } from "./core/commands/scaffold";
 export type {
+	AiProviderKind,
+	HoundsmanAi,
+	HoundsmanAiFeatures,
+	HoundsmanAst,
 	HoundsmanBudgets,
 	HoundsmanConcurrency,
 	HoundsmanConfig,
@@ -20,6 +60,8 @@ export type {
 } from "./core/config";
 export {
 	DEFAULT_ALWAYS_INCLUDE_DOCS,
+	DEFAULT_AST_MAX_FILE_BYTES,
+	DEFAULT_AST_MAX_IMPACT_FILES,
 	DEFAULT_JEV_CONCURRENCY,
 	DEFAULT_MAX_FILES_PER_BRIEF,
 	defineHoundsmanConfig,
@@ -47,6 +89,8 @@ export { buildCarryover, mergeCarryover } from "./core/engine/carryover";
 export { HoundsmanEngine } from "./core/engine/houndsman-engine";
 export { ReviewScopeResolver } from "./core/engine/review-scope";
 export { ReviewSession } from "./core/engine/review-session";
+export type { HoundsmanEnv } from "./core/env";
+export { ENV_NAMES, env, readEnv } from "./core/env";
 export {
 	churnOf,
 	classifyEntries,
@@ -159,6 +203,7 @@ export type {
 	FileStatus,
 	FileStatusMap,
 	Rule,
+	RuleHints,
 	Severity,
 	WatchdogDefinition,
 	WatchdogMeta,
@@ -172,6 +217,7 @@ export {
 	SEVERITY_ORDER,
 	severityRank,
 } from "./core/types";
+export { applyConfidence, applyJev, summarizeVerify, verifyLocal } from "./core/verify";
 export {
 	findWatchdog,
 	getWatchdog,

package/src/server/client/App.tsx

@@ -7,18 +7,19 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "preact/hooks";
 import { ArtifactsPanel } from "./ArtifactsPanel";
 import { AutoRefresh } from "./AutoRefresh";
+import { CommentsPanel } from "./CommentsPanel";
 import { Filters, type FiltersState } from "./Filters";
 import { FindingsList } from "./FindingsList";
-import { FileText, Layers, ListIcon, Refresh, Send } from "./icons";
+import { FileText, Layers, ListIcon, MessageSquare, Refresh, Send } from "./icons";
 import { ResumePanel } from "./ResumePanel";
-import { RunList } from "./RunList";
+import { Sidebar } from "./Sidebar";
 import { SubmitModal } from "./SubmitModal";
 import { SummaryBar } from "./SummaryBar";
 import { api, computeSummary } from "./utils/api";
 import { AUTO_REFRESH_MS, TAB_CAPTIONS } from "./utils/constants";
-import type { Finding, FindingsResponse, RunSummary } from "./utils/types";
+import type { EditorContext, Finding, FindingsResponse, RunSummary } from "./utils/types";
 
-type Tab = "resume" | "findings" | "artifacts";
+type Tab = "resume" | "findings" | "artifacts" | "comments";
 
 const TABS: { id: Tab; label: string; hint: string }[] = [
 	{
@@ -36,8 +37,20 @@ const TABS: { id: Tab; label: string; hint: string }[] = [
 		label: "Artefatos",
 		hint: "Arquivos brutos gerados pela revisão (manifesto, classificação, relatório…)",
 	},
+	{
+		id: "comments",
+		label: "Comentários",
+		hint: "Comentários da PR: threads de revisão e comentários gerais (carregados ao abrir a aba)",
+	},
 ];
 
+function TabIcon({ id }: { id: Tab }) {
+	if (id === "resume") return <FileText size={15} />;
+	if (id === "findings") return <ListIcon size={15} />;
+	if (id === "artifacts") return <Layers size={15} />;
+	return <MessageSquare size={15} />;
+}
+
 export function App() {
 	const [runs, setRuns] = useState<RunSummary[]>([]);
 	const [slug, setSlug] = useState<string | null>(null);
@@ -54,6 +67,8 @@ export function App() {
 	const [refreshing, setRefreshing] = useState(false);
 	const [syncing, setSyncing] = useState(false);
 	const [submitOpen, setSubmitOpen] = useState(false);
+	/** Editor detectado pelo servidor — base dos links de código. */
+	const [editor, setEditor] = useState<EditorContext>({ kind: "vscode" });
 	/** Refs espelhando estado volátil — o polling não deve recriar o intervalo. */
 	const lastSyncRef = useRef(lastSync);
 	const slugRef = useRef<string | null>(null);
@@ -116,6 +131,14 @@ export function App() {
 		reloadRuns();
 	}, [reloadRuns]);
 
+	useEffect(() => {
+		api<EditorContext>("/api/editor")
+			.then(setEditor)
+			.catch(() => {
+				// fail-open: mantém o fallback VS Code.
+			});
+	}, []);
+
 	useEffect(() => {
 		if (slug) loadFindings(slug);
 	}, [slug, loadFindings]);
@@ -194,7 +217,12 @@ export function App() {
 
 	return (
 		<div class="app">
-			<RunList runs={runs} slug={slug} onSelect={setSlug} />
+			<Sidebar
+				runs={runs}
+				slug={slug}
+				onSelect={setSlug}
+				onRefreshRuns={() => void reloadRuns()}
+			/>
 			<main class="main">
 				<header class="topbar">
 					<div class="segmented">
@@ -206,13 +234,7 @@ export function App() {
 								class={`seg-btn${tab === item.id ? " active" : ""}`}
 								onClick={() => setTab(item.id)}
 							>
-								{item.id === "resume" ? (
-									<FileText size={15} />
-								) : item.id === "findings" ? (
-									<ListIcon size={15} />
-								) : (
-									<Layers size={15} />
-								)}
+								<TabIcon id={item.id} />
 								{item.label}
 							</button>
 						))}
@@ -278,11 +300,15 @@ export function App() {
 							<FindingsList
 								slug={slug}
 								findings={findings}
+								editor={editor}
 								onUpdated={onUpdated}
 							/>
 						</>
 					)}
 					{slug && tab === "artifacts" && <ArtifactsPanel slug={slug} />}
+					{slug && tab === "comments" && (
+						<CommentsPanel slug={slug} editor={editor} />
+					)}
 					{!slug && !error && <p class="empty">Nenhuma execução para triar.</p>}
 				</div>
 				{slug && (

package/src/server/client/CommentsPanel.tsx

@@ -0,0 +1,255 @@
+/**
+ * Aba "Comentários": threads de revisão e comentários gerais da PR da run.
+ *
+ * O componente só é montado quando a aba é acessada — o carregamento (e a
+ * chamada ao `gh`) acontece no mount, nunca no carregamento da página.
+ */
+
+import { useCallback, useEffect, useMemo, useState } from "preact/hooks";
+import { Clock, CodeIcon, ExternalLink, GitHub, MessageSquare, Refresh } from "./icons";
+import { MarkdownText } from "./MarkdownText";
+import { api } from "./utils/api";
+import { editorFileLink, editorLabel, formatRunTime } from "./utils/format";
+import type {
+	EditorContext,
+	PrCommentsResponse,
+	PrCommentThread,
+	PrCommentView,
+} from "./utils/types";
+
+function CommentCard({
+	comment,
+	editor,
+	reply,
+}: {
+	comment: PrCommentView;
+	editor: EditorContext;
+	reply: boolean;
+}) {
+	const location = comment.path
+		? comment.line
+			? `${comment.path}:${comment.line}`
+			: comment.path
+		: null;
+	const href = comment.absFile
+		? editorFileLink(comment.absFile, comment.line, editor)
+		: null;
+	return (
+		<article class={`pr-comment${reply ? " reply" : ""}`}>
+			<header class="pr-comment-head">
+				<span class="pr-comment-author">{comment.author}</span>
+				{comment.authorType === "Bot" && <span class="tag">bot</span>}
+				<span class="run-when">
+					<Clock size={12} />
+					{formatRunTime(comment.createdAt)}
+				</span>
+				<span class="spacer" />
+				{comment.url && (
+					<a
+						class="pr-comment-link"
+						href={comment.url}
+						target="_blank"
+						rel="noreferrer"
+						title="Abrir o comentário no GitHub"
+					>
+						<GitHub size={12} /> GitHub
+					</a>
+				)}
+			</header>
+			<div class="pr-comment-body">
+				<MarkdownText text={comment.body} />
+			</div>
+			{location &&
+				(href ? (
+					<a
+						class="loc"
+						href={href}
+						title={`Abrir ${location} no ${editorLabel(editor)}`}
+					>
+						<CodeIcon size={13} />
+						{location}
+						<ExternalLink size={12} class="ext" />
+					</a>
+				) : (
+					<code class="loc static">
+						<CodeIcon size={13} />
+						{location}
+					</code>
+				))}
+		</article>
+	);
+}
+
+function ThreadCard({
+	thread,
+	editor,
+}: {
+	thread: PrCommentThread;
+	editor: EditorContext;
+}) {
+	const location = thread.line
+		? `${thread.path}:${thread.line}`
+		: thread.path || "arquivo";
+	const href = thread.absFile
+		? editorFileLink(thread.absFile, thread.line, editor)
+		: null;
+	return (
+		<section class="comment-thread">
+			<header class="comment-thread-head">
+				<CodeIcon size={13} />
+				<span class="comment-file">{location}</span>
+				<span class="spacer" />
+				{href && (
+					<a
+						class="icon-btn"
+						href={href}
+						title={`Abrir ${location} no ${editorLabel(editor)}`}
+					>
+						<ExternalLink size={13} />
+					</a>
+				)}
+				<span class="count">{thread.comments.length}</span>
+			</header>
+			{thread.comments.map((comment, index) => (
+				<CommentCard
+					key={comment.id}
+					comment={comment}
+					editor={editor}
+					reply={index > 0}
+				/>
+			))}
+		</section>
+	);
+}
+
+export function CommentsPanel({ slug, editor }: { slug: string; editor: EditorContext }) {
+	const [data, setData] = useState<PrCommentsResponse | null>(null);
+	const [loading, setLoading] = useState(true);
+	const [error, setError] = useState("");
+
+	const load = useCallback(
+		async (refresh = false) => {
+			setLoading(true);
+			setError("");
+			try {
+				const result = await api<PrCommentsResponse>(
+					`/api/runs/${slug}/comments${refresh ? "?refresh=1" : ""}`,
+				);
+				setData(result);
+			} catch (err) {
+				setError(String(err));
+			} finally {
+				setLoading(false);
+			}
+		},
+		[slug],
+	);
+
+	useEffect(() => {
+		setData(null);
+		void load();
+	}, [load]);
+
+	const groups = useMemo(() => {
+		const map = new Map<string, PrCommentThread[]>();
+		for (const thread of data?.threads ?? []) {
+			const key = thread.path || "(sem arquivo)";
+			const list = map.get(key) ?? [];
+			list.push(thread);
+			map.set(key, list);
+		}
+		return [...map.entries()];
+	}, [data]);
+
+	const empty =
+		data?.available && data.threads.length === 0 && data.issueComments.length === 0;
+
+	return (
+		<div class="comments">
+			<div class="comments-toolbar">
+				<div class="comments-counts">
+					<MessageSquare size={14} />
+					{data?.available ? (
+						<>
+							<span>
+								<b>{data.counts.threads}</b> threads
+							</span>
+							<span>
+								<b>{data.counts.inline}</b> inline
+							</span>
+							<span>
+								<b>{data.counts.issue}</b> gerais
+							</span>
+						</>
+					) : (
+						<span>Comentários da PR</span>
+					)}
+					{data?.target?.url && (
+						<a
+							class="pr-comment-link"
+							href={data.target.url}
+							target="_blank"
+							rel="noreferrer"
+						>
+							<GitHub size={12} /> PR #{data.target.number}
+						</a>
+					)}
+				</div>
+				<button
+					type="button"
+					class="btn"
+					disabled={loading}
+					title="Recarrega os comentários ignorando o cache de 60s"
+					onClick={() => void load(true)}
+				>
+					<Refresh size={14} class={loading ? "icon spin" : undefined} />
+					Atualizar
+				</button>
+			</div>
+
+			{loading && !data && <p class="empty">Carregando comentários da PR…</p>}
+			{error && <p class="error">{error}</p>}
+			{data && !data.available && (
+				<p class="empty">
+					Comentários indisponíveis
+					{data.reason ? `: ${data.reason}` : "."}
+				</p>
+			)}
+			{empty && <p class="empty">Nenhum comentário nesta PR.</p>}
+
+			{data?.available && groups.length > 0 && (
+				<section class="comment-group">
+					<h2 class="comment-group-title">Comentários de revisão</h2>
+					{groups.map(([path, threads]) => (
+						<div class="comment-file-group" key={path}>
+							<p class="comment-group-label">
+								{path} <span class="count">{threads.length}</span>
+							</p>
+							{threads.map((thread) => (
+								<ThreadCard
+									key={thread.id}
+									thread={thread}
+									editor={editor}
+								/>
+							))}
+						</div>
+					))}
+				</section>
+			)}
+
+			{data?.available && data.issueComments.length > 0 && (
+				<section class="comment-group">
+					<h2 class="comment-group-title">Comentários gerais</h2>
+					{data.issueComments.map((comment) => (
+						<CommentCard
+							key={comment.id}
+							comment={comment}
+							editor={editor}
+							reply={false}
+						/>
+					))}
+				</section>
+			)}
+		</div>
+	);
+}

package/src/server/client/FindingCard.tsx

@@ -21,8 +21,8 @@ import { MarkdownText } from "./MarkdownText";
 import { api } from "./utils/api";
 import { highlightCode, languageFromFile } from "./utils/code-highlight";
 import { DECISION_LABELS, DECISIONS, SEVERITY_LABELS } from "./utils/constants";
-import { vscodeFileLink } from "./utils/format";
-import type { Finding } from "./utils/types";
+import { editorFileLink, editorLabel } from "./utils/format";
+import type { EditorContext, Finding } from "./utils/types";
 
 /** Debounce do auto-save do comentário (ms). */
 const AUTOSAVE_MS = 700;
@@ -32,10 +32,12 @@ const SAVED_VISIBLE_MS = 1800;
 export function FindingCard({
 	slug,
 	finding,
+	editor,
 	onUpdated,
 }: {
 	slug: string;
 	finding: Finding;
+	editor: EditorContext;
 	onUpdated: (finding: Finding) => void;
 }) {
 	const isDone = finding.execState === "done";
@@ -104,7 +106,9 @@ export function FindingCard({
 	}, [comment, patch]);
 
 	const location = finding.line ? `${finding.file}:${finding.line}` : finding.file;
-	const href = finding.absFile ? vscodeFileLink(finding.absFile, finding.line) : null;
+	const href = finding.absFile
+		? editorFileLink(finding.absFile, finding.line, editor)
+		: null;
 	const highlighted = useMemo(
 		() =>
 			finding.evidence
@@ -132,7 +136,11 @@ export function FindingCard({
 				</button>
 				<span class="sev-badge">{SEVERITY_LABELS[finding.severity]}</span>
 				{href ? (
-					<a class="loc" href={href} title={`Abrir ${location} no VS Code`}>
+					<a
+						class="loc"
+						href={href}
+						title={`Abrir ${location} no ${editorLabel(editor)}`}
+					>
 						<CodeIcon size={13} />
 						{location}
 						<ExternalLink size={12} class="ext" />

package/src/server/client/FindingsList.tsx

@@ -6,15 +6,17 @@ import { useMemo } from "preact/hooks";
 import { FindingCard } from "./FindingCard";
 import { Alert } from "./icons";
 import { SEVERITY_LABELS, SEVERITY_ORDER } from "./utils/constants";
-import type { Finding, Severity } from "./utils/types";
+import type { EditorContext, Finding, Severity } from "./utils/types";
 
 export function FindingsList({
 	slug,
 	findings,
+	editor,
 	onUpdated,
 }: {
 	slug: string;
 	findings: Finding[];
+	editor: EditorContext;
 	onUpdated: (finding: Finding) => void;
 }) {
 	const grouped = useMemo(() => {
@@ -45,6 +47,7 @@ export function FindingsList({
 								key={finding.id}
 								slug={slug}
 								finding={finding}
+								editor={editor}
 								onUpdated={onUpdated}
 							/>
 						))}