Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
"use client";
/**
* Per-type chat artifact renderers. Dispatched by `ArtifactPanel` based on
* `artifact.type`. Variant shapes are declared in
* `@repowise-dev/types/chat`. Each renderer is intentionally small and
* presentation-only — heavier visualisations (full graph canvases, tables,
* etc.) belong in their own subpackages and are linked to from here.
*/
import {
Activity,
AlertTriangle,
ArrowRight,
Box,
CheckCircle2,
FileCode,
GitBranch,
Layers,
Search,
ShieldAlert,
Sparkles,
} from "lucide-react";
import type {
ChangeFindingRow,
ContextArtifactData,
DeadCodeArtifactData,
DeadCodeArtifactFinding,
DecisionsArtifactData,
DiagramArtifactData,
GraphPathArtifactData,
OverviewArtifactData,
RiskReportArtifactData,
SearchResultsArtifactData,
} from "@repowise-dev/types/chat";
import { SeverityMark } from "../health/severity-mark";
import type { Severity } from "../health/tokens";
import { Markdown } from "../shared/markdown";
import { MermaidDiagram } from "../wiki/mermaid-diagram";
import { getPageTypeLabel } from "../lib/page-types";
// ---------------------------------------------------------------------------
// Shared atoms
// ---------------------------------------------------------------------------
function StatRow({ label, value }: { label: string; value: React.ReactNode }) {
return (
<div className="flex items-baseline justify-between gap-3 text-xs">
<span className="text-[var(--color-text-tertiary)]">{label}</span>
<span className="font-mono tabular-nums text-[var(--color-text-secondary)]">
{value}
</span>
</div>
);
}
function SectionTitle({
icon: Icon,
children,
}: {
icon: React.ComponentType<{ className?: string }>;
children: React.ReactNode;
}) {
return (
<div className="flex items-center gap-1.5 font-mono text-[10px] font-medium uppercase tracking-[0.12em] text-[var(--color-text-tertiary)] mb-2">
<Icon className="h-3 w-3" />
<span>{children}</span>
</div>
);
}
function FilePathChip({ path }: { path: string }) {
return (
<span className="inline-flex items-center gap-1 rounded-md border border-[var(--color-border-default)] bg-[var(--color-bg-elevated)] px-1.5 py-0.5 text-xs font-mono text-[var(--color-text-secondary)]">
<FileCode className="h-2.5 w-2.5 opacity-60" />
<span className="truncate max-w-[200px]" title={path}>
{path}
</span>
</span>
);
}
// ---------------------------------------------------------------------------
// Overview
// ---------------------------------------------------------------------------
export function OverviewRenderer({ data }: { data: OverviewArtifactData }) {
const langs = Object.entries(data.languages ?? {})
.sort((a, b) => (b[1] as number) - (a[1] as number))
.slice(0, 6);
return (
<div className="space-y-4">
<div className="grid grid-cols-2 gap-2">
<StatRow label="Files" value={data.total_files.toLocaleString()} />
<StatRow label="Symbols" value={data.total_symbols.toLocaleString()} />
<StatRow label="Hotspots" value={data.hotspot_count.toLocaleString()} />
<StatRow label="Monorepo" value={data.is_monorepo ? "yes" : "no"} />
</div>
{langs.length > 0 && (
<div>
<SectionTitle icon={Layers}>Languages</SectionTitle>
<div className="space-y-1">
{langs.map(([lang, count]) => (
<StatRow
key={lang}
label={lang}
value={(count as number).toLocaleString()}
/>
))}
</div>
</div>
)}
{data.modules.length > 0 && (
<div>
<SectionTitle icon={Box}>Modules</SectionTitle>
<div className="flex flex-wrap gap-1">
{data.modules.slice(0, 12).map((m) => (
<span
key={m}
className="rounded-md border border-[var(--color-border-default)] bg-[var(--color-bg-elevated)] px-1.5 py-0.5 text-xs font-mono text-[var(--color-text-secondary)]"
>
{m}
</span>
))}
</div>
</div>
)}
{data.entry_points.length > 0 && (
<div>
<SectionTitle icon={ArrowRight}>Entry points</SectionTitle>
<div className="space-y-1">
{data.entry_points.slice(0, 5).map((ep) => (
<FilePathChip key={ep} path={ep} />
))}
</div>
</div>
)}
</div>
);
}
// ---------------------------------------------------------------------------
// Context
// ---------------------------------------------------------------------------
export function ContextRenderer({ data }: { data: ContextArtifactData }) {
const targets = Object.entries(data.targets ?? {});
if (targets.length === 0) {
return (
<p className="text-xs text-[var(--color-text-tertiary)]">No context loaded.</p>
);
}
return (
<div className="space-y-5">
{targets.map(([target, info]) => {
const md = info.docs?.content_md ?? "";
return (
<div key={target}>
<h3 className="text-xs font-mono text-[var(--color-text-secondary)] mb-2 break-all">
{target}
</h3>
{md ? (
<Markdown content={md} />
) : (
<p className="text-xs text-[var(--color-text-tertiary)]">
No documentation available.
</p>
)}
</div>
);
})}
</div>
);
}
// ---------------------------------------------------------------------------
// Risk report
// ---------------------------------------------------------------------------
type NormalizedRiskTarget = {
file_path: string;
/** 0–1 fraction from MCP `hotspot_score` / `churn_percentile`. */
score: number | null;
is_hotspot: boolean;
risk_type?: string;
trend?: string;
risk_summary?: string;
};
function formatHotspotPct(score: number): string {
return `${Math.round(score * 100)}th`;
}
function normalizeRiskTargets(data: RiskReportArtifactData): NormalizedRiskTarget[] {
const raw = data.targets;
if (!raw) return [];
const rows: Array<{
file_path: string;
hotspot_score?: number;
churn_percentile?: number;
is_hotspot?: boolean;
risk_type?: string;
trend?: string;
risk_summary?: string;
}> = Array.isArray(raw)
? raw.map((t) => ({
...t,
file_path: t.file_path ?? t.target ?? "",
}))
: Object.entries(raw).map(([key, value]) => ({
...value,
file_path: value.file_path ?? value.target ?? key,
}));
return rows
.filter((t) => t.file_path.length > 0)
.map((t) => {
const score =
typeof t.hotspot_score === "number"
? t.hotspot_score
: typeof t.churn_percentile === "number"
? t.churn_percentile
: null;
const out: NormalizedRiskTarget = {
file_path: t.file_path,
score,
// The backend now emits `is_hotspot` (which already applies the
// absolute activity floors); trust it instead of re-deriving from the
// score, which can't reproduce the floors and misbadges quiet repos.
is_hotspot: Boolean(t.is_hotspot),
};
if (typeof t.risk_type === "string") out.risk_type = t.risk_type;
if (typeof t.trend === "string") out.trend = t.trend;
if (typeof t.risk_summary === "string") out.risk_summary = t.risk_summary;
return out;
});
}
function normalizeGlobalHotspots(data: RiskReportArtifactData): Array<{
path: string;
score: number;
}> {
return (data.global_hotspots ?? [])
.map((h) => {
const path = h.file_path ?? h.path ?? "";
const score =
typeof h.hotspot_score === "number"
? h.hotspot_score
: typeof h.churn_percentile === "number"
? h.churn_percentile
: null;
if (!path || score === null) return null;
return { path, score };
})
.filter((h): h is { path: string; score: number } => h !== null);
}
const DIRECTIVE_TONE: Record<string, { label: string; className: string }> = {
review_required: {
label: "Review required",
className: "text-[var(--color-error)]",
},
review_recommended: {
label: "Review recommended",
className: "text-[var(--color-warning)]",
},
clear_in_analyzed_scope: {
label: "Clear in analyzed scope",
className: "text-[var(--color-success)]",
},
unknown: {
label: "Not established",
className: "text-[var(--color-text-secondary)]",
},
};
function ContextItem({ label, value }: { label: string; value: React.ReactNode }) {
return (
<div className="flex items-baseline gap-1">
<dt className="text-[var(--color-text-tertiary)]">{label}</dt>
<dd className="font-mono tabular-nums text-[var(--color-text-secondary)]">
{value}
</dd>
</div>
);
}
function ChangeFindingCard({ finding }: { finding: ChangeFindingRow }) {
const lines = finding.lines ? `:${finding.lines[0]}` : "";
return (
<li className="rounded-lg border border-[var(--color-border-default)] p-2.5">
<div className="flex flex-wrap items-center gap-x-2 gap-y-1">
<SeverityMark severity={finding.severity as Severity} />
<span className="font-mono text-[10px] uppercase tracking-[0.12em] text-[var(--color-text-tertiary)]">
{finding.change} · {finding.dimension}
</span>
</div>
<p className="mt-1 text-xs text-[var(--color-text-primary)]">
{finding.reason}
</p>
<p className="mt-0.5 truncate font-mono text-xs text-[var(--color-text-secondary)]">
{finding.symbol ? `${finding.symbol} — ` : ""}
<span title={finding.path}>
{finding.path}
{lines}
</span>
</p>
<p className="mt-1 text-xs text-[var(--color-text-secondary)]">
<span className="text-[var(--color-text-tertiary)]">Why this change: </span>
{finding.attribution.why}{" "}
<span className="uppercase tracking-wider">
({finding.attribution.confidence} confidence)
</span>
</p>
{finding.inspect && (
<p
className="mt-1 truncate font-mono text-xs text-[var(--color-text-secondary)]"
title={finding.inspect}
>
{finding.inspect}
</p>
)}
</li>
);
}
function ChangeRiskCard({ data }: { data: RiskReportArtifactData }) {
const directive = data.directive;
const delta = data.health_delta;
const tone: { label: string; className: string } =
DIRECTIVE_TONE[directive?.status ?? "unknown"] ?? {
label: "Not established",
className: "text-[var(--color-text-secondary)]",
};
const pct =
typeof data.risk_percentile === "number"
? Math.round(data.risk_percentile)
: null;
const findings = delta?.top_findings ?? [];
const tests = data.impacted_tests?.tests_to_run ?? [];
// No subset can be vouched for: the list is only what to run first.
const runAll =
data.impacted_tests?.run_all === true
? (data.impacted_tests.reasons?.[0] ?? data.impacted_tests.summary ?? "")
: null;
const fragile = data.fix_history?.files ?? [];
const partial = delta ? delta.status !== "available" : false;
return (
<div className="space-y-3">
{data.error && (
<p role="alert" className="text-xs text-[var(--color-error)]">
{String(data.error)}
</p>
)}
{/* One verdict, named in words as well as colour. */}
{directive && (
<div>
<p
className={`font-mono text-[10px] font-medium uppercase tracking-[0.12em] ${tone.className}`}
>
{tone.label}
</p>
<p className="mt-0.5 text-xs text-[var(--color-text-primary)]">
{directive.headline}
</p>
</div>
)}
{partial && delta && (
<p role="status" className="text-xs text-[var(--color-warning)]">
{delta.explanation}
</p>
)}
{findings.length > 0 && (
<div>
<SectionTitle icon={ShieldAlert}>
What this change made worse
</SectionTitle>
<ul className="space-y-1.5">
{findings.slice(0, 3).map((finding) => (
<ChangeFindingCard key={finding.id} finding={finding} />
))}
</ul>
</div>
)}
{/* One compact context row, not a second dashboard. */}
<dl className="flex flex-wrap gap-x-4 gap-y-1 border-t border-[var(--color-border-default)] pt-2 text-xs">
{data.ref && <ContextItem label="Change" value={String(data.ref)} />}
{pct !== null && <ContextItem label="Diff shape" value={`p${pct}`} />}
{data.review_priority && (
<ContextItem label="Diff size" value={String(data.review_priority)} />
)}
{delta?.scope && (
<ContextItem
label="Compared"
value={`${delta.scope.analyzed}/${delta.scope.changed} files`}
/>
)}
{fragile.length > 0 && (
<ContextItem label="Fragile" value={`${fragile.length} files`} />
)}
{runAll !== null ? (
<ContextItem label="Tests" value="Run every test" />
) : (
tests.length > 0 && (
<ContextItem label="Tests" value={`${tests.length} to run`} />
)
)}
</dl>
{(directive?.next_actions?.length ||
delta ||
tests.length > 0 ||
runAll !== null ||
fragile.length > 0 ||
data.classification) && (
<details>
<summary className="cursor-pointer text-xs text-[var(--color-text-tertiary)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-focus-ring)]">
More detail
</summary>
<div className="mt-2 space-y-2">
{directive?.next_actions?.length ? (
<div>
<SectionTitle icon={ArrowRight}>Next actions</SectionTitle>
<ul className="space-y-0.5 text-xs text-[var(--color-text-secondary)]">
{directive.next_actions.map((action) => (
<li key={action}>{action}</li>
))}
</ul>
</div>
) : null}
{runAll !== null && (
<p
role="status"
className="text-xs text-[var(--color-warning)]"
>
Run every test{runAll ? `: ${runAll}` : ""}
</p>
)}
{tests.length > 0 && (
<div>
<SectionTitle icon={CheckCircle2}>
{runAll !== null ? "Run these first" : "Tests to run"}
</SectionTitle>
<ul className="space-y-0.5 font-mono text-xs text-[var(--color-text-secondary)]">
{tests.slice(0, 10).map((test) => (
<li key={test} className="truncate" title={test}>
{test}
</li>
))}
</ul>
</div>
)}
{fragile.length > 0 && (
<div>
<SectionTitle icon={GitBranch}>
Historically fragile files
</SectionTitle>
<ul className="space-y-0.5 text-xs text-[var(--color-text-secondary)]">
{fragile.slice(0, 5).map((file) => (
<li key={file.path} className="flex justify-between gap-2">
<span className="truncate font-mono" title={file.path}>
{file.path}
</span>
<span className="shrink-0 tabular-nums text-[var(--color-text-tertiary)]">
{file.churn} changes
</span>
</li>
))}
</ul>
</div>
)}
{delta && (
<div className="space-y-1">
<StatRow
label="Introduced / worsened / resolved"
value={`${delta.introduced} / ${delta.worsened} / ${delta.resolved}`}
/>
{delta.findings_total > delta.findings_emitted && (
<StatRow
label="Findings shown"
value={`${delta.findings_emitted} of ${delta.findings_total}`}
/>
)}
{delta.skipped && (
<StatRow
label="Files not analysed"
value={delta.skipped.total}
/>
)}
</div>
)}
{data.diff_shape && (
<p className="text-xs text-[var(--color-text-tertiary)]">
{String(data.diff_shape)}
</p>
)}
{data.classification && (
<p className="text-xs text-[var(--color-text-tertiary)]">
{String(data.classification)}
</p>
)}
{data.warning && (
<p className="text-xs text-[var(--color-text-tertiary)]">
{String(data.warning)}
</p>
)}
</div>
</details>
)}
</div>
);
}
export function RiskReportRenderer({ data }: { data: RiskReportArtifactData }) {
// get_change_risk returns a live-git review card, not per-file targets.
if (
data.error ||
data.directive ||
data.ref ||
data.review_priority ||
data.risk_percentile != null
) {
return <ChangeRiskCard data={data} />;
}
const targets = normalizeRiskTargets(data);
const hotspots = normalizeGlobalHotspots(data);
if (targets.length === 0 && hotspots.length === 0) {
return (
<p className="text-xs text-[var(--color-text-tertiary)]">No risk data.</p>
);
}
return (
<div className="space-y-4">
{targets.length > 0 && (
<div>
<SectionTitle icon={ShieldAlert}>Targets</SectionTitle>
<div className="space-y-1.5">
{targets.map((t, i) => (
<div
key={`${t.file_path}:${i}`}
className="rounded-lg border border-[var(--color-border-default)] p-2.5"
>
<div className="flex items-center justify-between gap-2">
<span className="font-mono text-xs text-[var(--color-text-primary)] truncate">
{t.file_path}
</span>
{t.is_hotspot && (
<span className="inline-flex items-center gap-1 text-xs font-medium text-[var(--color-warning)]">
<AlertTriangle className="h-3 w-3" /> Hotspot
</span>
)}
</div>
{typeof t.score === "number" && (
<div className="text-xs text-[var(--color-text-tertiary)] mt-0.5 tabular-nums">
Hotspot {formatHotspotPct(t.score)} pct
{t.risk_type ? ` · ${t.risk_type}` : ""}
{t.trend ? ` · ${t.trend}` : ""}
</div>
)}
{t.risk_summary && (
<p className="text-xs text-[var(--color-text-secondary)] mt-1 line-clamp-2">
{t.risk_summary}
</p>
)}
</div>
))}
</div>
</div>
)}
{hotspots.length > 0 && (
<div>
<SectionTitle icon={Activity}>Top global hotspots</SectionTitle>
<div className="space-y-1">
{hotspots.slice(0, 5).map((h, i) => (
<div
key={`${h.path}:${i}`}
className="flex items-center justify-between gap-2 text-xs"
>
<span className="font-mono text-[var(--color-text-secondary)] truncate">
{h.path}
</span>
<span className="text-xs tabular-nums text-[var(--color-text-tertiary)]">
{formatHotspotPct(h.score)}
</span>
</div>
))}
</div>
</div>
)}
</div>
);
}
// ---------------------------------------------------------------------------
// Search results
// ---------------------------------------------------------------------------
export function SearchResultsRenderer({
data,
}: {
data: SearchResultsArtifactData;
}) {
if (!data.results || data.results.length === 0) {
return (
<div className="space-y-2">
<SectionTitle icon={Search}>Query</SectionTitle>
<p className="text-xs text-[var(--color-text-secondary)] font-mono">
{data.query}
</p>
<p className="text-xs text-[var(--color-text-tertiary)]">
No results found.
</p>
</div>
);
}
return (
<div className="space-y-2">
<SectionTitle icon={Search}>{data.query}</SectionTitle>
{data.results.map((r, i) => (
<div
key={`${r.page_id ?? r.symbol_id ?? r.path ?? r.title}:${i}`}
className="rounded-lg border border-[var(--color-border-default)] p-3"
>
<div className="text-xs font-medium text-[var(--color-text-primary)]">
{r.title ?? r.symbol_id ?? r.path}
</div>
<div className="text-xs text-[var(--color-text-tertiary)] mt-0.5">
{getPageTypeLabel(r.page_type)}
{typeof r.relevance_score === "number" && (
<> · score {(r.relevance_score as number).toFixed(2)}</>
)}
</div>
{r.snippet && (
<p className="text-xs text-[var(--color-text-secondary)] mt-1 line-clamp-3">
{r.snippet}
</p>
)}
</div>
))}
</div>
);
}
// ---------------------------------------------------------------------------
// Graph (dependency path)
// ---------------------------------------------------------------------------
export function GraphPathRenderer({ data }: { data: GraphPathArtifactData }) {
return (
<div className="space-y-3">
<p className="text-xs text-[var(--color-text-secondary)]">
{data.explanation}
</p>
{data.path.length > 0 ? (
<div>
<SectionTitle icon={GitBranch}>Path</SectionTitle>
<ol className="space-y-1">
{data.path.map((node, i) => (
<li
key={`${node}:${i}`}
className="flex items-center gap-2 text-xs"
>
<span className="flex h-4 w-4 shrink-0 items-center justify-center rounded-full bg-[var(--color-bg-elevated)] border border-[var(--color-border-default)] text-[10px] font-mono tabular-nums text-[var(--color-text-tertiary)]">
{i + 1}
</span>
<span className="font-mono text-[var(--color-text-secondary)] truncate">
{node}
</span>
{i < data.path.length - 1 && (
<ArrowRight className="h-3 w-3 text-[var(--color-text-tertiary)] ml-auto shrink-0" />
)}
</li>
))}
</ol>
</div>
) : (
<p className="text-xs text-[var(--color-text-tertiary)]">
No path found.
</p>
)}
</div>
);
}
// ---------------------------------------------------------------------------
// Decisions
// ---------------------------------------------------------------------------
function decisionRows(
data: DecisionsArtifactData,
): Array<{
title: string;
status?: string;
decision?: string;
rationale?: string;
affected_files?: string[];
}> {
// MCP search/path emit `decisions`; older chat fixtures used `results`.
return (data.decisions ?? data.results ?? []) as Array<{
title: string;
status?: string;
decision?: string;
rationale?: string;
affected_files?: string[];
}>;
}
function DecisionCards({
rows,
}: {
rows: Array<{
title: string;
status?: string;
decision?: string;
rationale?: string;
affected_files?: string[];
}>;
}) {
return (
<div className="space-y-3">
{rows.map((r, i) => (
<div
key={`${r.title}:${i}`}
className="rounded-lg border border-[var(--color-border-default)] p-3 space-y-1.5"
>
<h3 className="text-xs font-medium text-[var(--color-text-primary)]">
{r.title}
{r.status && (
<span className="ml-1.5 text-xs font-normal text-[var(--color-text-tertiary)]">
({r.status})
</span>
)}
</h3>
{r.decision && (
<p className="text-xs text-[var(--color-text-secondary)] leading-relaxed">
{r.decision}
</p>
)}
{r.rationale && (
<p className="text-xs text-[var(--color-text-tertiary)] leading-relaxed">
{r.rationale}
</p>
)}
{r.affected_files && r.affected_files.length > 0 && (
<div className="flex flex-wrap gap-1 pt-1">
{r.affected_files.slice(0, 6).map((f) => (
<FilePathChip key={f} path={f} />
))}
</div>
)}
</div>
))}
</div>
);
}
export function DecisionsRenderer({ data }: { data: DecisionsArtifactData }) {
if (data.mode === "health") {
const counts = data.counts ?? {};
const active =
counts.active ??
counts.total ??
data.total_decisions ??
0;
const stale = data.stale_decisions ?? [];
const proposed = data.proposed_awaiting_review ?? [];
const hotspots = data.ungoverned_hotspots ?? [];
const legacyRecent = data.decisions ?? [];
return (
<div className="space-y-4">
{data.summary && (
<p className="text-xs text-[var(--color-text-secondary)]">{data.summary}</p>
)}
<div className="grid grid-cols-2 gap-2">
<StatRow label="Active" value={Number(active).toLocaleString()} />
<StatRow
label="Stale"
value={Number(counts.stale ?? stale.length).toLocaleString()}
/>
<StatRow
label="Proposed"
value={Number(counts.proposed ?? proposed.length).toLocaleString()}
/>
<StatRow
label="Ungoverned"
value={hotspots.length.toLocaleString()}
/>
</div>
{data.by_source && Object.keys(data.by_source).length > 0 && (
<div>
<SectionTitle icon={Layers}>By source</SectionTitle>
<div className="space-y-1">
{Object.entries(data.by_source).map(([source, count]) => (
<StatRow
key={source}
label={source}
value={(count as number).toLocaleString()}
/>
))}
</div>
</div>
)}
{stale.length > 0 && (
<div>
<SectionTitle icon={AlertTriangle}>Stale decisions</SectionTitle>
<ul className="space-y-1">
{stale.slice(0, 8).map((d, i) => (
<li key={i} className="text-xs text-[var(--color-text-secondary)]">
<span className="truncate">{d.title}</span>
</li>
))}
</ul>
</div>
)}
{proposed.length > 0 && (
<div>
<SectionTitle icon={Sparkles}>Proposed</SectionTitle>
<ul className="space-y-1">
{proposed.slice(0, 8).map((d, i) => (
<li key={i} className="text-xs text-[var(--color-text-secondary)]">
<span className="truncate">{d.title}</span>
{d.source && (
<span className="ml-1.5 text-xs text-[var(--color-text-tertiary)]">
({d.source})
</span>
)}
</li>
))}
</ul>
</div>
)}
{legacyRecent.length > 0 && stale.length === 0 && proposed.length === 0 && (
<div>
<SectionTitle icon={Sparkles}>Recent</SectionTitle>
<ul className="space-y-1">
{legacyRecent.map((d, i) => (
<li key={i} className="text-xs text-[var(--color-text-secondary)]">
<span className="truncate">{d.title}</span>
{d.status && (
<span className="ml-1.5 text-xs text-[var(--color-text-tertiary)]">
({d.status})
</span>
)}
</li>
))}
</ul>
</div>
)}
</div>
);
}
const rows = decisionRows(data);
const heading =
data.mode === "path"
? data.path ?? data.query
: data.query;
if (rows.length === 0) {
return (
<p className="text-xs text-[var(--color-text-tertiary)]">
No matching decisions
{heading ? ` for "${heading}"` : " for this query"}.
</p>
);
}
return (
<div className="space-y-3">
{heading && (
<p className="text-xs text-[var(--color-text-tertiary)]">
{data.mode === "path" ? "Governing" : "Matches for"}{" "}
<span className="font-mono text-[var(--color-text-secondary)]">
"{heading}"
</span>
</p>
)}
{data.alignment?.summary && (
<p className="text-xs text-[var(--color-text-secondary)]">
{data.alignment.summary}
</p>
)}
<DecisionCards rows={rows} />
{data.origin_story?.primary_author && (
<p className="text-xs text-[var(--color-text-tertiary)]">
Primary author: {String(data.origin_story.primary_author)}
</p>
)}
</div>
);
}
// ---------------------------------------------------------------------------
// Dead code
// ---------------------------------------------------------------------------
const DEAD_CODE_TIERS = [
{ key: "high", label: "High confidence", icon: CheckCircle2 },
{ key: "medium", label: "Medium confidence", icon: AlertTriangle },
{ key: "low", label: "Low confidence", icon: AlertTriangle },
] as const;
export function DeadCodeRenderer({ data }: { data: DeadCodeArtifactData }) {
if (data.mode === "finding") {
return data.finding ? (
<DeadCodeRow finding={data.finding} showLines />
) : (
<p className="text-xs text-[var(--color-text-tertiary)]">
No open dead-code finding matches{" "}
<span className="break-all font-mono">{data.finding_id}</span>.
</p>
);
}
return (
<div className="space-y-4">
<div className="grid grid-cols-2 gap-2">
<StatRow
label="Findings"
value={data.summary.total_findings.toLocaleString()}
/>
<StatRow
label="Candidate lines"
value={data.summary.deletable_lines.toLocaleString()}
/>
</div>
{DEAD_CODE_TIERS.map(({ key, label, icon }) => {
const tier = data.tiers?.[key];
if (!tier || tier.findings.length === 0) return null;
return (
<div key={key}>
<SectionTitle icon={icon}>{label}</SectionTitle>
<div className="space-y-1.5">
{tier.findings.map((f, i) => (
<DeadCodeRow key={`${f.file_path}:${i}`} finding={f} showLines={key === "high"} />
))}
</div>
{tier.truncated && (
<p className="mt-1.5 text-xs text-[var(--color-text-tertiary)]">
{tier.findings.length} of {tier.count.toLocaleString()} shown
</p>
)}
</div>
);
})}
</div>
);
}
function DeadCodeRow({
finding,
showLines = false,
}: {
finding: DeadCodeArtifactFinding;
showLines?: boolean;
}) {
return (
<div className="rounded-md border border-[var(--color-border-default)] p-2 text-xs">
<div className="flex items-center justify-between gap-2">
<span className="font-mono text-[var(--color-text-primary)] truncate">
{finding.symbol_name ? `${finding.file_path}::${finding.symbol_name}` : finding.file_path}
</span>
<span className="text-xs tabular-nums text-[var(--color-text-tertiary)] shrink-0">
{(finding.confidence * 100).toFixed(0)}%
</span>
</div>
<div className="text-xs text-[var(--color-text-tertiary)] mt-0.5">
{finding.kind}
{showLines && typeof finding.lines === "number" && (
<> · {finding.lines} lines</>
)}
{finding.safe_to_delete && <> · cleanup-ready</>}
</div>
<p className="text-xs text-[var(--color-text-secondary)] mt-1 line-clamp-2">
{finding.reason}
</p>
</div>
);
}
// ---------------------------------------------------------------------------
// Diagram (Mermaid)
// ---------------------------------------------------------------------------
export function DiagramRenderer({ data }: { data: DiagramArtifactData }) {
if (!data.mermaid_syntax) {
return (
<p className="text-xs text-[var(--color-text-tertiary)]">
No diagram available.
</p>
);
}
return (
<div className="space-y-3">
{data.description && (
<p className="text-xs text-[var(--color-text-tertiary)]">
{data.description}
</p>
)}
<MermaidDiagram chart={data.mermaid_syntax} />
</div>
);
}
// ---------------------------------------------------------------------------
// Source, health, and selective path views
// ---------------------------------------------------------------------------
export function SourceRenderer({ data }: { data: Record<string, unknown> }) {
const source = typeof data.source === "string" ? data.source : typeof data.content === "string" ? data.content : "";
const path = typeof data.file === "string" ? data.file : typeof data.path === "string" ? data.path : typeof data.file_path === "string" ? data.file_path : typeof data.target === "string" ? data.target : "Source";
const fallback = Array.isArray(data.fallback_lines) ? data.fallback_lines : [];
if (!source && fallback.length === 0) return <p className="text-xs text-[var(--color-text-tertiary)]">No source content was returned.</p>;
return (
<div className="space-y-3">
<p className="truncate font-mono text-xs text-[var(--color-text-secondary)]" title={path}>{path}</p>
<pre className="max-h-[60vh] overflow-auto border-l border-[var(--color-border-default)] pl-3 font-mono text-xs leading-relaxed text-[var(--color-text-secondary)] whitespace-pre-wrap break-words">{source || fallback.map((line) => typeof line === "string" ? line : JSON.stringify(line)).join("\n")}</pre>
</div>
);
}
export function HealthRenderer({ data }: { data: Record<string, unknown> }) {
const findings = Array.isArray(data.findings) ? data.findings : Array.isArray(data.top_findings) ? data.top_findings : [];
const files = Array.isArray(data.ranked_files) ? data.ranked_files : Array.isArray(data.worst_files) ? data.worst_files : [];
const kpis = data.kpis && typeof data.kpis === "object" ? data.kpis as Record<string, unknown> : {};
const scores = data.scores && typeof data.scores === "object" ? data.scores as Record<string, unknown> : {};
const dimensions = ["defect", "maintainability", "performance"]
.map((key) => [key, data[key] ?? scores[key]] as const)
.filter((entry) => entry[1] !== undefined);
const headlineKpis = [
["average health", kpis.average_health ?? data.average_health],
["hotspot health", kpis.hotspot_health ?? data.hotspot_health],
["maintainability", kpis.maintainability_average ?? data.maintainability_average],
["performance", kpis.performance_average ?? data.performance_average],
["structure deduction", kpis.structure_average ?? data.structure_average],
["history deduction", kpis.history_average ?? data.history_average],
["worst performer", kpis.worst_performer_score ?? data.worst_performer_score],
].filter((entry): entry is [string, unknown] => entry[1] !== undefined && entry[1] !== null);
const rows = findings.length > 0 ? findings : files;
if (rows.length === 0 && dimensions.length === 0 && headlineKpis.length === 0) return <p className="text-xs text-[var(--color-text-tertiary)]">No health findings were returned for these targets.</p>;
return (
<div className="space-y-4">
{(headlineKpis.length > 0 || dimensions.length > 0) && <div className="space-y-1">{[...headlineKpis, ...dimensions].map(([label, value]) => <StatRow key={label} label={label} value={typeof value === "object" ? JSON.stringify(value) : String(value)} />)}</div>}
{rows.length > 0 && <div><SectionTitle icon={Activity}>{findings.length > 0 ? "Findings" : "Worst files"}</SectionTitle><ol className="border-t border-[var(--color-border-default)]">{rows.slice(0, 50).map((finding, index) => { const row = finding as Record<string, unknown>; const title = String(row.title ?? row.file_path ?? row.path ?? row.kind ?? `Finding ${index + 1}`); return <li key={`${title}:${index}`} className="border-b border-[var(--color-border-default)] py-2"><p className="font-mono text-xs text-[var(--color-text-primary)] break-all">{title}</p>{row.reason || row.summary || row.message ? <p className="mt-1 text-xs text-[var(--color-text-secondary)]">{String(row.reason ?? row.summary ?? row.message)}</p> : null}</li>; })}</ol></div>}
</div>
);
}
function extractPath(data: Record<string, unknown>): Array<{ node: string; relationship?: string }> {
if (Array.isArray(data.path)) return data.path.map((item) => typeof item === "string" ? { node: item } : { node: String((item as Record<string, unknown>).node ?? (item as Record<string, unknown>).name ?? (item as Record<string, unknown>).id ?? "Unknown node"), ...(typeof (item as Record<string, unknown>).relationship === "string" ? { relationship: String((item as Record<string, unknown>).relationship) } : {}) });
if (Array.isArray(data.nodes)) return data.nodes.map((item) => typeof item === "string" ? { node: item } : { node: String((item as Record<string, unknown>).node ?? (item as Record<string, unknown>).name ?? (item as Record<string, unknown>).id ?? "Unknown node") });
const paths = Array.isArray(data.paths) ? data.paths : [];
const first = paths[0];
return Array.isArray(first) ? first.map((item) => ({ node: String(item) })) : [];
}
export function DependencyPathRenderer({ data }: { data: Record<string, unknown> }) {
const path = extractPath(data);
if (path.length === 0) return <p className="text-xs text-[var(--color-text-tertiary)]">No dependency path was found. This does not prove that no runtime relationship exists.</p>;
return <div><SectionTitle icon={GitBranch}>Selected dependency path</SectionTitle><ol className="space-y-1">{path.slice(0, 100).map((item, index) => <li key={`${item.node}:${index}`} className="flex items-center gap-2 font-mono text-xs text-[var(--color-text-secondary)]"><span className="w-5 shrink-0 tabular-nums text-[var(--color-text-tertiary)]">{index + 1}</span><span className="break-all">{item.node}</span>{item.relationship && <span className="text-xs text-[var(--color-text-tertiary)]">{item.relationship}</span>}</li>)}</ol></div>;
}
export function CallPathRenderer({ data }: { data: Record<string, unknown> }) {
const flows = Array.isArray(data.flows) ? data.flows : Array.isArray(data.execution_flows) ? data.execution_flows : [];
const path = extractPath(data);
if (flows.length === 0 && path.length === 0) return <p className="text-xs text-[var(--color-text-tertiary)]">No indexed call path was returned. Dynamic calls may be outside structural coverage.</p>;
if (path.length > 0) return <DependencyPathRenderer data={{ path }} />;
return <div><SectionTitle icon={ArrowRight}>Selected execution flows</SectionTitle><ol className="border-t border-[var(--color-border-default)]">{flows.slice(0, 25).map((flow, index) => { const row = flow as Record<string, unknown>; const trace = Array.isArray(row.trace) ? row.trace.map(String) : []; return <li key={index} className="border-b border-[var(--color-border-default)] py-2 text-xs text-[var(--color-text-secondary)]"><span className="font-mono break-all">{String(row.entry_point_name ?? row.name ?? row.title ?? row.entry_point ?? `Flow ${index + 1}`)}</span>{trace.length > 0 && <ol className="mt-2 space-y-1 border-l border-[var(--color-border-default)] pl-3">{trace.slice(0, 50).map((node, traceIndex) => <li key={`${node}:${traceIndex}`} className="font-mono text-xs break-all">{node}</li>)}</ol>}{typeof row.termination === "string" && row.termination.length > 0 && <p className="mt-2 text-xs text-[var(--color-text-tertiary)]">Stopped: {row.termination}</p>}</li>; })}</ol></div>;
}
// ---------------------------------------------------------------------------
// Generic JSON fallback
// ---------------------------------------------------------------------------
export function GenericJsonRenderer({
data,
}: {
data: Record<string, unknown>;
}) {
return (
<pre className="text-xs font-mono text-[var(--color-text-secondary)] overflow-auto max-h-[70vh] whitespace-pre-wrap break-words">
{JSON.stringify(data, null, 2)}
</pre>
);
}