koala73 / worldmonitor

GitHub

Code

How koala73/worldmonitor is laid out, and where to start for common changes.

Architecture grade

score 89/100

Import cycles

lower is better

400

Files mapped

973 imports between them

97%

Layering

of imports point one way

From the map of which files import which, built when the code was last read in full. It shows what depends on what, not a reading order.

Module map

Shade by

30 modules, 46 links. A link means one module imports another; thicker lines mean more imports. Links come from 400 of 3,111 source files, so the real counts are higher. Select a module to trace it: blue lines go to what it uses, orange lines come from what uses it.

Where to start reading

Repository root
Repository root
Likely public API
Likely public API
Likely start-up file
Likely start-up file
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

Add a new intelligence data source

Register the source in the data loader pipeline
Add classification rules if AI categorization is needed

Add a new geopolitical event type to tracking

Extend the activity tracker to capture this event
Create an event handler or command binding

Add multi-language support for new UI text

Add English strings to the base locale file

Change the public API

Trace runtime behavior

Add or update tests

Change build or automation

RepoPilot lists up to 500 files, so a file missing here may still exist.

Files marked “likely” are guessed from their names.
1 suggested change pattern has no matching file and is left out.
The file list is newer than the written guide, so descriptions and suggested changes may describe older code.

Code quality and hotspots

Largest source files

Branch points581 per file on average
Code issues1 error, 327 warnings
Largest file8,577 lines
Hotspot load10 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions52 workflows
Tests3,254 test filesJest/Vitest · 1.0 test files per source file (file count, not coverage)
Dependency updatesCodeQL
CI pass rate54%last 50 runs

Test folders: api · consumer-prices-core/src/adapters · cli/test

Hotspots

src/components/DeckGLMap.ts75 commits in 180 days · 1,789 branch points
src/app/data-loader.ts100 commits in 180 days · 1,191 branch points
src/app/panel-layout.ts100 commits in 180 days · 749 branch points
src/components/CountryDeepDivePanel.ts84 commits in 180 days · 1,041 branch points
src/App.ts100 commits in 180 days · 726 branch points
src/components/GlobeMap.ts28 commits in 180 days · 1,061 branch points
src/app/event-handlers.ts68 commits in 180 days · 505 branch points
src/config/feeds.ts48 commits in 180 days · 439 branch points

Files that change often and branch heavily, highest first. Branch points count if, loop, case, catch, ternary, && and || in the file.