# Gotchas

## God Nodes (high connectivity)

These files have the most connections. Changes here have high blast radius.

- `readmenator/_models.py` (score: 206.30, imported by 101 files)
- `readmenator/_config.py` (score: 200.10, imported by 100 files)
- `readmenator/_pipeline.py` (score: 93.30, imported by 1 files)
- `readmenator/_app.py` (score: 92.70, imported by 16 files)
- `readmenator/parsers/__init__.py` (score: 48.20, imported by 3 files)
- `readmenator/parsers/_base.py` (score: 44.60, imported by 20 files)
- `readmenator/_forcegraph.py` (score: 44.30, imported by 10 files)
- `readmenator/_diagrams.py` (score: 39.70, imported by 9 files)

## Blast Radius (change impact)

Editing these files can break the listed number of dependents. Run their tests after any change.

- `readmenator/_category.py` -- 9 direct, 105 total dependents
- `readmenator/_models.py` -- 50 direct, 101 total dependents
- `readmenator/_config.py` -- 50 direct, 100 total dependents
- `readmenator/parsers/_base.py` -- 20 direct, 45 total dependents
- `readmenator/_purpose.py` -- 7 direct, 38 total dependents
- `readmenator/_rank.py` -- 11 direct, 38 total dependents
- `readmenator/_resolver.py` -- 7 direct, 36 total dependents
- `readmenator/_project_config.py` -- 9 direct, 34 total dependents
- `readmenator/_htmlpack.py` -- 8 direct, 33 total dependents
- `readmenator/_viewer_ui.py` -- 5 direct, 33 total dependents

## Hotspots (complexity + centrality)

- `readmenator/_vendor/force-graph.min.js` -- complexity: 0.4, centrality: 1.0, combined: 0.7
- `readmenator/_diagrams.py` -- complexity: 1.0, centrality: 0.0, combined: 0.4
- `readmenator/_app.py` -- complexity: 0.9, centrality: 0.1, combined: 0.4
- `readmenator/_video.py` -- complexity: 0.9, centrality: 0.0, combined: 0.4
- `readmenator/_mcp_server.py` -- complexity: 0.7, centrality: 0.0, combined: 0.3
- `readmenator/_pipeline.py` -- complexity: 0.5, centrality: 0.1, combined: 0.2
- `readmenator/_flowcharts.py` -- complexity: 0.6, centrality: 0.0, combined: 0.2
- `readmenator/_graphrag.py` -- complexity: 0.5, centrality: 0.0, combined: 0.2
- `readmenator/_apidocs.py` -- complexity: 0.5, centrality: 0.0, combined: 0.2
- `readmenator/_apidocs_render.py` -- complexity: 0.5, centrality: 0.0, combined: 0.2

## Layer Violations

- `tests/test_apidocs.py` (testing) -> `readmenator/_apidocs_page.py` (presentation): testing must not import presentation
- `tests/test_apidocs.py` (testing) -> `readmenator/_apidocs_render.py` (presentation): testing must not import presentation
- `tests/test_components.py` (testing) -> `readmenator/_components.py` (presentation): testing must not import presentation
- `tests/test_flowcharts.py` (testing) -> `readmenator/_apidocs_page.py` (presentation): testing must not import presentation
- `tests/test_folder_readme.py` (testing) -> `readmenator/_components.py` (presentation): testing must not import presentation
- `tests/test_layout_quality.py` (testing) -> `readmenator/_forcegraph_page.py` (presentation): testing must not import presentation
- `tests/test_project_config.py` (testing) -> `readmenator/_viewer_ui.py` (presentation): testing must not import presentation
- `tests/test_project_config.py` (testing) -> `readmenator/_viewer_ui.py` (presentation): testing must not import presentation
- `tests/test_project_config.py` (testing) -> `readmenator/_viewer_ui.py` (presentation): testing must not import presentation
- `tests/test_project_config.py` (testing) -> `readmenator/_forcegraph_page.py` (presentation): testing must not import presentation