cleanup opportunities

Cleanup opportunities

The scan found no TODO, FIXME, or HACK comments in tracked source. The main cleanup candidates are complexity hotspots where files or tests have grown large enough to deserve careful future decomposition.

Complexity hotspots

Area	File	Why it is a candidate
Comparison regression suite	tests/comparison_engine_integration.rs	2,331 lines. It is valuable coverage, but future additions could split by exact keys, flexible keys, duplicates, normalization, and nullish handling.
Linux package metadata tests	tests/linux_package_metadata_integration.rs	1,294 lines. It covers many package checks and could be grouped around Debian, RPM, and AppStream cases.
Results styling	frontend/src/features/results/resultsSurface.css	1,258 lines. It contains dense visual styling for the results surface.
Backend workflow tests	tests/backend_workflow_integration.rs	1,123 lines. It could split by load, compare, persistence, and stale-write behavior if it grows further.
Response contracts	tests/response_contracts.rs	1,004 lines. It is central contract coverage and should stay easy to navigate.
Comparison engine	src/comparison/engine.rs	836 lines. It mixes planning, flexible matching execution, result generation, and summary logic.

Churn hotspots

Recent product churn was highest in frontend/src/features/results/htmlExport.ts, src/comparison/engine.rs, tests/comparison_engine_integration.rs, src/api/handlers.rs, frontend/src/components/ResultsTable.tsx, and frontend/src/hooks/useComparisonWorkflow.ts. Future refactors should preserve tests around those paths before moving code.

Dependency freshness

No unmaintained dependency was identified during the wiki scan. Major active dependencies are listed in dependencies. Release metadata validators in scripts/check_release_metadata.py help keep package versions synchronized.

Key source files

File	Purpose
src/comparison/engine.rs	Core comparison hotspot.
frontend/src/components/ResultsTable.tsx	UI rendering hotspot.
frontend/src/features/results/resultsSurface.css	Styling hotspot.
tests/comparison_engine_integration.rs	Largest test file.
tests/linux_package_metadata_integration.rs	Packaging test hotspot.

For current architecture boundaries, see architecture.