@payconductor/houndsman 0.8.0 → 0.10.0

package/src/server/client/sidebar-sections.tsx

@@ -0,0 +1,73 @@
+/**
+ * Registry das seções da sidebar — fonte única da navegação.
+ *
+ * Adicionar uma seção é incluir um item em `SIDEBAR_SECTIONS`: a rail e o
+ * painel passam a renderizá-la sem condicionais em `Sidebar.tsx`. O `Content`
+ * fica montado mesmo fora de foco, então deve buscar dados apenas quando
+ * `active` for `true` (preserva estado ao alternar, sem refetch).
+ */
+
+import type { ComponentType } from "preact";
+import { GitPullRequest, type IconProps, ListIcon } from "./icons";
+import { PrsSection } from "./PrsSection";
+import { RunsSection } from "./RunsSection";
+import type { RunSummary } from "./utils/types";
+
+/** Estado e ações compartilhados por todas as seções da sidebar. */
+export type SidebarSectionContext = {
+	runs: RunSummary[];
+	slug: string | null;
+	onSelect: (slug: string) => void;
+	onRefreshRuns: () => void;
+	/** Seção visível no momento — use para adiar fetch e polling. */
+	active: boolean;
+};
+
+export type SidebarSection = {
+	id: string;
+	/** Nome curto da tooltip da rail. */
+	label: string;
+	/** Título exibido no topo do painel. */
+	title: string;
+	/** Linha de apoio abaixo do título (contexto da seção). */
+	hint?: string;
+	icon: ComponentType<IconProps>;
+	/** Contador opcional da rail (ex.: quantidade de execuções). */
+	badge?: (ctx: SidebarSectionContext) => number | null;
+	Content: ComponentType<SidebarSectionContext>;
+};
+
+export const SIDEBAR_SECTIONS: SidebarSection[] = [
+	{
+		id: "runs",
+		label: "Execuções",
+		title: "Execuções",
+		hint: "Revisões executadas pelo Houndsman",
+		icon: ListIcon,
+		badge: ({ runs }) => (runs.length > 0 ? runs.length : null),
+		Content: RunsSection,
+	},
+	{
+		id: "prs",
+		label: "PRs",
+		title: "PRs",
+		hint: "Pull requests abertas no repositório",
+		icon: GitPullRequest,
+		Content: PrsSection,
+	},
+];
+
+/** Seção inicial quando não há preferência salva (ou ela é inválida). */
+export const DEFAULT_SIDEBAR_SECTION = SIDEBAR_SECTIONS[0].id;
+
+/** Resolve um id de seção salvo, caindo no default quando desconhecido. */
+export function resolveSidebarSectionId(id: string | null | undefined): string {
+	return id && SIDEBAR_SECTIONS.some((section) => section.id === id)
+		? id
+		: DEFAULT_SIDEBAR_SECTION;
+}
+
+/** Definição da seção (o id é sempre resolvido antes, via registry). */
+export function getSidebarSection(id: string): SidebarSection {
+	return SIDEBAR_SECTIONS.find((section) => section.id === id) ?? SIDEBAR_SECTIONS[0];
+}

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

@@ -85,6 +85,7 @@ export function describeRunStatus(
 const KIND_ORDER: ArtifactKind[] = [
 	"review",
 	"resume",
+	"technical",
 	"domain-review",
 	"verify",
 	"brief",
@@ -109,6 +110,7 @@ const GROUP_BY_KIND: Record<ArtifactKind, { key: string; label: string; order: n
 	{
 		review: { 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 },
@@ -132,6 +134,7 @@ const GROUP_BY_KIND: Record<ArtifactKind, { key: string; label: string; order: n
 export const ARTIFACT_KIND_LABELS: Record<ArtifactKind, string> = {
 	review: "relatório",
 	resume: "resumo",
+	technical: "pontos técnicos",
 	"domain-review": "domínio",
 	verify: "verify",
 	brief: "brief",
@@ -164,7 +167,9 @@ export function describeArtifact(meta: ArtifactMeta): string {
 		case "review":
 			return "Relatório consolidado da revisão — o entregável.";
 		case "resume":
-			return "Resumo final da revisão: visão de negócio e pontos técnicos diretos (leitura humana).";
+			return "Resumo final da revisão: visão de negócio e estrutura técnica (leitura humana).";
+		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":
@@ -240,7 +245,7 @@ export function groupArtifacts(
 
 /** Legenda única de cada aba (explica o que a aba é; mostrada quando selecionada). */
 export const TAB_CAPTIONS = {
-	resume: "Resumo principal da revisão: o que muda em termos de negócio, números diretos (arquivos, churn, domínios) e os pontos técnicos que exigem ação.",
+	resume: "Resumo principal da revisão: visão de negócio, números diretos (arquivos, churn, domínios) e os pontos técnicos estruturais da mudança.",
 	findings:
 		"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:

package/src/server/client/utils/sidebar-prefs.ts

@@ -0,0 +1,64 @@
+/**
+ * Preferências locais da sidebar (largura do painel, colapso e seção ativa).
+ *
+ * Persistidas em `localStorage` e lidas de forma falha-aberta: storage
+ * indisponível ou JSON inválido caem nos defaults, sem quebrar a UI.
+ */
+
+export const SIDEBAR_MIN_WIDTH = 320;
+export const SIDEBAR_MAX_WIDTH = 560;
+export const SIDEBAR_DEFAULT_WIDTH = 360;
+
+/** Chave única — o valor é um JSON com `width`, `collapsed` e `section`. */
+export const SIDEBAR_STORAGE_KEY = "houndsman.sidebar";
+
+export type SidebarPrefs = {
+	width: number;
+	collapsed: boolean;
+	section: string | null;
+};
+
+/** Preferências usadas quando não há nada salvo. */
+export function defaultSidebarPrefs(): SidebarPrefs {
+	return {
+		width: SIDEBAR_DEFAULT_WIDTH,
+		collapsed: false,
+		section: null,
+	};
+}
+
+/** Mantém a largura dentro de limites seguros (NaN/infinito viram o default). */
+export function clampSidebarWidth(value: number): number {
+	if (!Number.isFinite(value)) return SIDEBAR_DEFAULT_WIDTH;
+	return Math.min(SIDEBAR_MAX_WIDTH, Math.max(SIDEBAR_MIN_WIDTH, Math.round(value)));
+}
+
+/** Lê as preferências salvas; qualquer falha retorna os defaults. */
+export function readSidebarPrefs(): SidebarPrefs {
+	const fallback = defaultSidebarPrefs();
+	try {
+		if (typeof localStorage === "undefined") return fallback;
+		const raw = localStorage.getItem(SIDEBAR_STORAGE_KEY);
+		if (!raw) return fallback;
+		const parsed: unknown = JSON.parse(raw);
+		if (!parsed || typeof parsed !== "object") return fallback;
+		const value = parsed as Record<string, unknown>;
+		return {
+			width: clampSidebarWidth(Number(value.width)),
+			collapsed: value.collapsed === true,
+			section: typeof value.section === "string" ? value.section : null,
+		};
+	} catch {
+		return fallback;
+	}
+}
+
+/** Grava as preferências; falhas (modo privado, cota) são ignoradas. */
+export function saveSidebarPrefs(prefs: SidebarPrefs): void {
+	try {
+		if (typeof localStorage === "undefined") return;
+		localStorage.setItem(SIDEBAR_STORAGE_KEY, JSON.stringify(prefs));
+	} catch {
+		// fail-open: preferências são cosméticas.
+	}
+}

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

@@ -62,6 +62,7 @@ export type ArtifactKind =
 	| "finding-report"
 	| "review"
 	| "resume"
+	| "technical"
 	| "domain-review"
 	| "verify"
 	| "ast"