666ghj / mirofish

GitHub

Code

How 666ghj/mirofish is laid out, and where to start for common changes.

Architecture grade

score 99/100

Import cycles

lower is better

Files mapped

138 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

4 modules, 1 links. A link means one module imports another; thicker lines mean more imports. 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
Suggested starting pointAI
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

Add a New Simulation API Endpoint

Define the request/response models in backend/app/models/ (e.g., SimulationRequest)
Implement the endpoint handler function in backend/app/api/simulation.py
Register the route in backend/app/api/__init__.py blueprint
Create corresponding frontend API client function in frontend/src/api/simulation.js

Add a New Service/Agent to the Simulation

Create new service class in backend/app/services/ inheriting core simulation patterns
Implement service initialization and run loop following simulation_manager.py conventions
Register service in simulation_config_generator.py to configure it during setup
Update Step3Simulation.vue to expose service parameters in UI

Add Support for a New LLM Provider

Extend backend/app/utils/llm_client.py with new provider class implementing the same interface
Add provider configuration option to backend/app/config.py
Update backend/app/utils/openai_chat_compat.py with provider-specific request/response adapters
Add provider selection UI to frontend/src/components/Step2EnvSetup.vue

Add a New Localization Language

Create new JSON file in locales/ directory following locales/en.json structure
Register the language in locales/languages.json
Update frontend/src/i18n/index.js to import and register new locale messages
Language becomes available in frontend/src/components/LanguageSwitcher.vue automatically

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.

Code quality and hotspots

Largest source files

Branch points45 per file on average
Code issues0 errors, 6 warnings
Largest file2,879 lines
Hotspot load0 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions2 workflows
Tests21 test filesPytest · 0.42 test files per source file (file count, not coverage)
Dependency updatesNo config detected

Test folders: backend/tests · tests · backend/scripts

Hotspots

backend/app/services/oasis_profile_generator.py5 commits in 180 days · 35 branch points
backend/app/services/graph_builder.py5 commits in 180 days · 35 branch points
backend/app/services/ontology_generator.py6 commits in 180 days · 24 branch points
backend/app/api/simulation.py3 commits in 180 days · 86 branch points
backend/app/api/graph.py3 commits in 180 days · 30 branch points
backend/app/services/report_agent.py2 commits in 180 days · 54 branch points
backend/app/services/simulation_runner.py2 commits in 180 days · 61 branch points
backend/app/services/zep_graph_memory_updater.py2 commits in 180 days · 32 branch points

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