import { type FormEvent, lazy, Suspense, useCallback, useEffect, useMemo, useRef, useState } from 'react' import { api, type AppMeta, type RepositorySummary, type ScanComparison, type ScanJob, type ScanReport, type ScanSummary, type TrendPoint } from './api' import { filterRepositories, orderSwitcherRepositories, paginateRepositories, readinessLabel, repositoryReadiness, sortRepositories, stateLabel, type CatalogFilters, type CatalogSort, type CatalogSortKey, type Readiness } from './catalog' import { BrandLockup, BrandMark } from './components/Brand' import { Icon, type IconName } from './components/Icon' import { HealthRing } from './components/HealthRing' import { RepoAvatar } from './components/RepoAvatar' import { DashboardView } from './components/DashboardView' import { DependenciesView } from './components/DependenciesView' import { FindingsView } from './components/FindingsView' import { HistoryView } from './components/HistoryView' import { HotspotsView } from './components/HotspotsView' import { OverviewView } from './components/OverviewView' import { RepositoryVisual } from './components/RepositoryVisual' import { ScanRunsView } from './components/ScanRunsView' import { DETAIL_VIEWS, parseRoute, routePath, type DetailView, type Route } from './navigation' // React Flow is only needed on the Architecture tab; keep it out of the initial bundle. const ArchitectureView = lazy(() => import('./components/ArchitectureView').then((module) => ({ default: module.ArchitectureView }))) const ACTIVE_JOB_STATES: ScanJob['status'][] = ['queued', 'acquiring_source', 'scanning', 'analyzing', 'persisting'] const PINNED_STORAGE_KEY = 'repopulse:pinned-repositories' const RECENT_STORAGE_KEY = 'repopulse:recent-repositories' const CATALOG_VIEW_STORAGE_KEY = 'repopulse:catalog-view' const DEFAULT_FILTERS: CatalogFilters = { query: '', state: 'all', readiness: 'all', owner: 'all', branch: 'all', visibility: 'all', archived: 'active' } function readIdList(key: string) { try { const parsed = JSON.parse(window.localStorage.getItem(key) ?? '[]') return Array.isArray(parsed) ? parsed.filter((value): value is string => typeof value === 'string') : [] } catch { return [] } } function readCatalogView(): 'table' | 'grid' { try { return window.localStorage.getItem(CATALOG_VIEW_STORAGE_KEY) === 'grid' ? 'grid' : 'table' } catch { return 'table' } } function writeIdList(key: string, ids: string[]) { try { window.localStorage.setItem(key, JSON.stringify(ids)) } catch { /* preferences are best effort */ } } function shortRevision(revision: string | null) { return revision ? revision.slice(0, 10) : 'not acquired' } function statusClass(value: string) { return value.replace(/_/g, '-') } function formatDate(value: string | null) { if (!value) return 'Never'; const date = new Date(value); return Number.isNaN(date.getTime()) ? 'Unknown' : date.toLocaleString([], { dateStyle: 'medium', timeStyle: 'short' }) } function formatRelativeDate(value: string | null) { if (!value) return 'Never scanned'; const difference = Date.now() - new Date(value).getTime(); if (Number.isNaN(difference)) return 'Unknown'; if (difference < 3_600_000) return `${Math.max(1, Math.floor(difference / 60_000))}m ago`; if (difference < 86_400_000) return `${Math.floor(difference / 3_600_000)}h ago`; return `${Math.floor(difference / 86_400_000)}d ago` } function downloadText(filename: string, content: string, mime: string) { const url = URL.createObjectURL(new Blob([content], { type: mime })); const anchor = document.createElement('a'); anchor.href = url; anchor.download = filename; anchor.style.display = 'none'; document.body.appendChild(anchor); anchor.click(); window.setTimeout(() => { anchor.remove(); URL.revokeObjectURL(url) }, 0) } function reportFilename(repositoryName: string, format: 'html' | 'json') { const safeName = repositoryName.replace(/[\u0000-\u001f\u007f<>:"/\\|?*]/g, '_').replace(/[ .]+$/g, '').slice(0, 100).replace(/[ .]+$/g, '') || 'repository'; return `repopulse-${safeName}.${format}` } function detailViewLabel(view: DetailView, report: ScanReport | null) { if (view === 'overview') return 'Overview'; if (view === 'findings') return report ? `Findings (${report.findings.filter((finding) => !finding.suppressed).length})` : 'Findings'; if (view === 'architecture') return report ? `Architecture (${report.architecture.nodes.length})` : 'Architecture'; if (view === 'hotspots') return report ? `Hotspots (${report.hotspots.length})` : 'Hotspots'; if (view === 'dependencies') return 'Dependencies'; if (view === 'history') return 'History'; return 'Scan runs' } export default function App() { const [route, setRoute] = useState(() => parseRoute(window.location.pathname)) const [repositories, setRepositories] = useState([]) const [catalogLoading, setCatalogLoading] = useState(true) const [selectedDetailsLoading, setSelectedDetailsLoading] = useState(false) const [scanSummaries, setScanSummaries] = useState([]) const [report, setReport] = useState(null) const [comparison, setComparison] = useState(null) const [trend, setTrend] = useState([]) const [path, setPath] = useState('') const [job, setJob] = useState(null) const [meta, setMeta] = useState(null) const [standaloneReport, setStandaloneReport] = useState(null) const [pinnedIds, setPinnedIds] = useState(() => readIdList(PINNED_STORAGE_KEY)) const [recentIds, setRecentIds] = useState(() => readIdList(RECENT_STORAGE_KEY)) const [catalogFilters, setCatalogFilters] = useState(DEFAULT_FILTERS) const [catalogSort, setCatalogSort] = useState({ key: 'name', direction: 'asc' }) const [catalogPage, setCatalogPage] = useState(1) const [catalogPageSize, setCatalogPageSize] = useState(24) const [catalogView, setCatalogView] = useState<'table' | 'grid'>(readCatalogView) const [busy, setBusy] = useState(false) const [catalogBusy, setCatalogBusy] = useState(false) const [error, setError] = useState(null) const [notice, setNotice] = useState(null) const [switcherOpen, setSwitcherOpen] = useState(false) const [switcherQuery, setSwitcherQuery] = useState('') const [switcherIndex, setSwitcherIndex] = useState(0) const [advancedOpen, setAdvancedOpen] = useState(false) const switcherInputRef = useRef(null) const selectedId = route.repositoryId ?? null const selectedRepository = useMemo(() => repositories.find((repository) => repository.id === selectedId) ?? null, [repositories, selectedId]) const activeJob = job && job.repository_id === selectedId && ACTIVE_JOB_STATES.includes(job.status) ? job : null const navigate = useCallback((next: Route, replace = false) => { const href = routePath(next); if (window.location.pathname !== href) window.history[replace ? 'replaceState' : 'pushState']({}, '', href); setRoute(next); setAdvancedOpen(false); window.scrollTo?.({ top: 0, behavior: 'auto' }) }, []) const handleNavigation = useCallback((event: React.MouseEvent, next: Route) => { if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return; event.preventDefault(); navigate(next) }, [navigate]) const refreshCatalog = useCallback(async () => { const next = await api.repositories(); setRepositories(next); return next }, []) const refreshMeta = useCallback(async () => { try { setMeta(await api.meta()) } catch { /* catalog navigation must remain usable */ } }, []) useEffect(() => { const onPopState = () => setRoute(parseRoute(window.location.pathname)) window.addEventListener('popstate', onPopState) void (async () => { setCatalogLoading(true); try { await refreshCatalog() } catch { try { const legacy = await api.recent(); setStandaloneReport(legacy[0] ?? null); setPath(legacy[0]?.repository_path ?? ''); setError(legacy.length ? 'Repository catalog is unavailable; showing the last local report in Settings.' : 'Could not load the repository catalog.') } catch (err) { setError(err instanceof Error ? err.message : 'Could not load the repository catalog.') } } finally { setCatalogLoading(false) } })() void refreshMeta() return () => window.removeEventListener('popstate', onPopState) }, [refreshCatalog, refreshMeta]) useEffect(() => { document.title = route.page === 'dashboard' ? 'RepoPulse — Portfolio intelligence' : 'RepoPulse — Repository intelligence' }, [route.page]) useEffect(() => { if (!selectedId) { setReport(null); setScanSummaries([]); setTrend([]); setComparison(null); setSelectedDetailsLoading(false); return } let live = true setSelectedDetailsLoading(true); setReport(null); setComparison(null); setTrend([]) void Promise.all([api.repository(selectedId), api.repositoryScans(selectedId), api.repositoryTrend(selectedId)]).then(([detail, summaries, nextTrend]) => { if (!live) return; setScanSummaries(summaries); setTrend(nextTrend); setReport(detail.latest_scan); setError(null); if (detail.latest_scan?.repository_path) setPath(detail.latest_scan.repository_path) }).catch((err) => { if (live) setError(err instanceof Error ? err.message : 'Could not load repository details.') }).finally(() => { if (live) setSelectedDetailsLoading(false) }) return () => { live = false } }, [selectedId]) useEffect(() => { if (!report) { setComparison(null); return }; let live = true; void api.comparison(report.id).then((next) => { if (live) setComparison(next) }).catch(() => { if (live) setComparison(null) }); return () => { live = false } }, [report]) useEffect(() => { if (!selectedRepository?.active_job_id || job?.id === selectedRepository.active_job_id) return; let live = true; void api.scanJob(selectedRepository.active_job_id).then((next) => { if (live) setJob(next) }).catch(() => undefined); return () => { live = false } }, [job?.id, selectedRepository]) useEffect(() => { const jobId = activeJob?.id if (!jobId || !selectedId) return let live = true let failures = 0 let timer: number | undefined const poll = async () => { try { const next = await api.scanJob(jobId) if (!live) return failures = 0 if (next.status === 'completed' && next.scan_id) { const nextReport = await api.repositoryScan(next.repository_id, next.scan_id) if (!live) return const [summaries, nextTrend] = await Promise.all([api.repositoryScans(next.repository_id), api.repositoryTrend(next.repository_id)]) if (!live) return await refreshCatalog() if (!live) return setJob(next) setReport(nextReport) setScanSummaries(summaries) setTrend(nextTrend) setNotice(next.deduplicated ? 'The selected revision was already analyzed; showing the existing report.' : 'Repository analysis completed.') return } setJob(next) if (next.status === 'failed') { setError(next.error_detail || 'Repository analysis failed.'); return } } catch (err) { failures += 1 if (!live) return if (failures >= 5) { setError(err instanceof Error ? `${err.message} Progress polling paused after five failed attempts.` : 'Progress polling paused after five failed attempts.'); return } } if (live) timer = window.setTimeout(() => void poll(), 1500) } void poll() return () => { live = false; if (timer) window.clearTimeout(timer) } }, [activeJob?.id, refreshCatalog, selectedId]) useEffect(() => { if (selectedId) setRecentIds((current) => [selectedId, ...current.filter((id) => id !== selectedId)].slice(0, 8)) }, [selectedId]) useEffect(() => writeIdList(PINNED_STORAGE_KEY, pinnedIds), [pinnedIds]) useEffect(() => writeIdList(RECENT_STORAGE_KEY, recentIds), [recentIds]) useEffect(() => { try { window.localStorage.setItem(CATALOG_VIEW_STORAGE_KEY, catalogView) } catch { /* preference only */ } }, [catalogView]) const filteredRepositories = useMemo(() => filterRepositories(repositories, catalogFilters), [catalogFilters, repositories]) const sortedRepositories = useMemo(() => sortRepositories(filteredRepositories, catalogSort), [catalogSort, filteredRepositories]) const catalogWindow = useMemo(() => paginateRepositories(sortedRepositories, catalogPage, catalogPageSize), [catalogPage, catalogPageSize, sortedRepositories]) const ownerOptions = useMemo(() => [...new Set(repositories.map((repository) => repository.owner))].sort(), [repositories]) const branchOptions = useMemo(() => [...new Set(repositories.map((repository) => repository.default_branch))].sort(), [repositories]) const switcherRepositories = useMemo(() => orderSwitcherRepositories(repositories, pinnedIds, recentIds, switcherQuery), [pinnedIds, recentIds, repositories, switcherQuery]) const currentView = route.view ?? 'overview' useEffect(() => { if (catalogPage !== catalogWindow.page) setCatalogPage(catalogWindow.page) }, [catalogPage, catalogWindow.page]) useEffect(() => { if (switcherOpen) { setSwitcherIndex(0); window.requestAnimationFrame(() => switcherInputRef.current?.focus()) } }, [switcherOpen]) useEffect(() => { const onKeyDown = (event: KeyboardEvent) => { if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === 'k') { event.preventDefault(); setSwitcherOpen(true); return }; if (!switcherOpen) return; if (event.key === 'Escape') { event.preventDefault(); setSwitcherOpen(false) } else if (event.key === 'ArrowDown') { event.preventDefault(); setSwitcherIndex((index) => Math.min(index + 1, Math.max(0, switcherRepositories.length - 1))) } else if (event.key === 'ArrowUp') { event.preventDefault(); setSwitcherIndex((index) => Math.max(0, index - 1)) } else if (event.key === 'Enter' && switcherRepositories[switcherIndex]) { event.preventDefault(); selectRepository(switcherRepositories[switcherIndex]); setSwitcherOpen(false) } }; window.addEventListener('keydown', onKeyDown); return () => window.removeEventListener('keydown', onKeyDown) }, [switcherIndex, switcherOpen, switcherRepositories]) const selectRepository = (repository: RepositorySummary) => { setError(null); setNotice(null); navigate({ page: 'repositories', repositoryId: repository.id, view: 'overview' }) } const togglePinned = (repositoryId: string) => setPinnedIds((current) => current.includes(repositoryId) ? current.filter((id) => id !== repositoryId) : [repositoryId, ...current]) const exploreReadiness = (readiness: Readiness) => { setCatalogFilters({ ...DEFAULT_FILTERS, readiness }); setCatalogPage(1); navigate({ page: 'repositories' }) } const updateCatalogFilter = (key: K, value: CatalogFilters[K]) => { setCatalogFilters((current) => ({ ...current, [key]: value })); setCatalogPage(1) } const setCatalogSortKey = (key: CatalogSortKey) => { setCatalogSort((current) => current.key === key ? { key, direction: current.direction === 'asc' ? 'desc' : 'asc' } : { key, direction: key === 'name' || key === 'state' ? 'asc' : 'desc' }); setCatalogPage(1) } const analyzeRepository = async (repository: RepositorySummary, force = false) => { try { setBusy(true); setError(null); setNotice(null); const next = await api.enqueueRepositoryScan(repository.id, force); setJob(next); setNotice(next.deduplicated ? 'This revision is already in the analysis history.' : 'Analysis queued. Progress will update here.'); if (next.status === 'completed' && next.scan_id) setReport(await api.repositoryScan(repository.id, next.scan_id)) } catch (err) { setError(err instanceof Error ? err.message : 'Could not queue repository analysis.') } finally { setBusy(false) } } const syncCatalog = async () => { try { setCatalogBusy(true); setError(null); const result = await api.syncRepositories(); await Promise.all([refreshCatalog(), refreshMeta()]); setNotice(result.partial ? `Gitea catalog partially synchronized: ${result.discovered} resolved, ${result.branch_failures ?? 0} branch lookup failure(s). Existing repository evidence was preserved.` : `Gitea catalog synchronized: ${result.discovered} repositories discovered.`) } catch (err) { setError(err instanceof Error ? err.message : 'Gitea catalog synchronization failed.') } finally { setCatalogBusy(false) } } const scanLocal = async (event: FormEvent) => { event.preventDefault(); try { setBusy(true); setError(null); setNotice(null); const next = await api.scan(path); setStandaloneReport(next); setPath(next.repository_path); await refreshCatalog(); setNotice(`Local analysis completed in ${next.duration_ms} ms. The result is available in Settings.`); navigate({ page: 'settings' }) } catch (err) { setError(err instanceof Error ? err.message : 'Local repository analysis failed.') } finally { setBusy(false) } } const selectScan = async (summary: ScanSummary) => { try { setBusy(true); setError(null); setReport(await api.repositoryScan(summary.repository_id, summary.id)); navigate({ page: 'repositories', repositoryId: summary.repository_id, view: 'overview' }) } catch (err) { setError(err instanceof Error ? err.message : 'Could not load the selected scan.') } finally { setBusy(false) } } const exportReport = async (format: 'html' | 'json') => { if (!report) return; try { downloadText(reportFilename(report.repository_name, format), await api.exportReport(report.id, format), format === 'html' ? 'text/html' : 'application/json') } catch (err) { setError(err instanceof Error ? err.message : 'Report export failed.') } } const navItems: { page: Route['page']; label: string; href: string; icon: IconName; count?: number }[] = [ { page: 'dashboard', label: 'Dashboard', href: '/', icon: 'dashboard' }, { page: 'repositories', label: 'Repositories', href: '/repositories', icon: 'repositories', count: repositories.length }, { page: 'activity', label: 'Activity', href: '/activity', icon: 'activity' }, { page: 'queue', label: 'Scan queue', href: '/queue', icon: 'queue', count: repositories.filter((repository) => repository.active_job_id || repository.state === 'queued' || repository.state === 'scanning').length || undefined }, { page: 'settings', label: 'Settings', href: '/settings', icon: 'settings' }, ] const lastSync = meta?.gitea.last_sync && typeof meta.gitea.last_sync === 'object' && 'synced_at' in meta.gitea.last_sync ? String(meta.gitea.last_sync.synced_at) : null const renderGlobalNav = () => const renderSidebar = () => const renderTopbar = () =>
handleNavigation(event, { page: 'dashboard' })} aria-label="RepoPulse home">
const renderCatalogPage = () =>

Repositories {repositories.length}

Every repository RepoPulse discovered in Gitea, with its latest retained scan.

updateCatalogFilter('query', event.target.value)} placeholder="Search name, owner or full name" />
{filteredRepositories.length} matching {repositories.length} repositories
{catalogLoading ?
: catalogWindow.items.length ? <>{catalogView === 'table' ?
{catalogWindow.items.map((repository) => { const readiness = repositoryReadiness(repository); const pinned = pinnedIds.includes(repository.id); return selectRepository(repository)} onKeyDown={(event) => { if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); selectRepository(repository) } }}> })}
ReadinessBranch
{repository.full_name}{repository.private ? 'Private' : 'Public'} · {repository.provider} · {repository.archived ? 'Archived' : 'Active'}
{repository.default_branch}{formatRelativeDate(repository.last_scan_at)}{formatDate(repository.last_scan_at)}{repository.last_scan_health ?? '—'}
:
{catalogWindow.items.map((repository) => { const pinned = pinnedIds.includes(repository.id); const readiness = repositoryReadiness(repository); return