Code Simplicity Metrics: ahma

Overall Repository Simplicity: 76%

Generated on: 2026-06-02 05:13:58

Executive Summary

The repository has moderate technical debt. Consider refactoring the top complexity issues.

Rust Simplicity (Avg: 76%)

By Crate

1. ahma_test_support: 84%
2. ahma_llm_monitor: 81%
3. ahma_vault: 80%
4. ahma_worker: 78%
5. ahma_decompose: 78%
6. ahma_bin: 78%
7. ahma_common: 77%
8. ahma_mcp: 76%
9. ahma_cluster: 76%
10. ahma_http_bridge: 73%
11. ahma_tui: 72%
12. ahma_http_mcp_client: 70%

Top 20 Rust Code Complexity Issues (Lowest Simplicity)

1. ui.rs: Simplicity: 47% (Elevated Cognitive Complexity (distributed across many functions))** ahma_tui/src/ui.rs
   • Metrics: Cog: 143, PeakCog: 9, Cyc: 182, SLOC: 1352, MI: 44.6
   • Hotspots:
     • draw_ai_activity() lines 656-734: Cog=9, Cyc=9, SLOC=79
     • header_health_span() lines 599-615: Cog=8, Cyc=4, SLOC=17
     • draw_picker() lines 522-594: Cog=7, Cyc=6, SLOC=73
     • draw_log() lines 991-1056: Cog=7, Cyc=6, SLOC=66
     • push_assistant_chat_lines() lines 213-237: Cog=6, Cyc=5, SLOC=25
2. setup.rs: Simplicity: 53% (High Cognitive Complexity (concentrated))** ahma_mcp/src/setup.rs
   • Metrics: Cog: 96, PeakCog: 30, Cyc: 192, SLOC: 746, MI: 49.4
   • Hotspots:
     • parse_selection_string() lines 305-348: Cog=30, Cyc=16, SLOC=44
     • run() lines 170-224: Cog=15, Cyc=19, SLOC=55
     • setup_terminal_hooks() lines 570-603: Cog=7, Cyc=8, SLOC=34
     • merge_mcp_json() lines 467-498: Cog=6, Cyc=11, SLOC=32
     • merge_codex_toml() lines 534-568: Cog=6, Cyc=11, SLOC=35
3. cli.rs: Simplicity: 53% (Elevated Cognitive Complexity (distributed across many functions))** ahma_mcp/src/shell/cli.rs
   • Metrics: Cog: 114, PeakCog: 8, Cyc: 293, SLOC: 2790, MI: 52.6
   • Hotspots:
     • print_hints() lines 1906-1933: Cog=8, Cyc=9, SLOC=28
     • extract_tool_fields() lines 1634-1680: Cog=7, Cyc=6, SLOC=47
     • audit_bundle_command() lines 665-694: Cog=6, Cyc=9, SLOC=30
     • print_tool_info_entry() lines 1954-1976: Cog=5, Cyc=6, SLOC=23
     • resolve_sandbox_policy() lines 280-304: Cog=4, Cyc=3, SLOC=25
4. mcp_service/mod.rs: Simplicity: 54% (Elevated Cognitive Complexity (distributed across many functions))** ahma_mcp/src/mcp_service/mod.rs
   • Metrics: Cog: 109, PeakCog: 4, Cyc: 295, SLOC: 2470, MI: 50.5
   • Hotspots:
     • stage_paths_into_vault_trash() lines 464-487: Cog=4, Cyc=6, SLOC=24
     • maybe_stage_configured_delete() lines 489-521: Cog=4, Cyc=7, SLOC=33
     • on_cancelled() lines 1181-1244: Cog=4, Cyc=5, SLOC=64
     • list_tools() lines 1246-1325: Cog=4, Cyc=4, SLOC=80
     • dispatch_subcommand_tool() lines 1451-1542: Cog=4, Cyc=13, SLOC=92
5. app.rs: Simplicity: 55% (Elevated Cognitive Complexity (distributed across many functions))** ahma_tui/src/app.rs
   • Metrics: Cog: 112, PeakCog: 5, Cyc: 334, SLOC: 1427, MI: 51.0
   • Hotspots:
     • parse_llm_selection() lines 1168-1185: Cog=5, Cyc=5, SLOC=18
     • submit_provider_picker() lines 251-275: Cog=4, Cyc=3, SLOC=25
     • open_model_picker() lines 1054-1075: Cog=4, Cyc=5, SLOC=22
     • parse_run_command() lines 1135-1166: Cog=4, Cyc=7, SLOC=32
     • handle_providers_discovered() lines 1238-1257: Cog=4, Cyc=5, SLOC=20
6. stress_test.rs: Simplicity: 58% (Elevated Cognitive Complexity (distributed across many functions))** ahma_http_mcp_client/examples/stress_test.rs
   • Metrics: Cog: 86, PeakCog: 8, Cyc: 208, SLOC: 1225, MI: 49.7
   • Hotspots:
     • main() lines 1085-1194: Cog=8, Cyc=14, SLOC=110
     • spawn_stderr_monitor() lines 832-861: Cog=5, Cyc=4, SLOC=30
     • store_error_context() lines 886-915: Cog=5, Cyc=4, SLOC=30
     • run_monitoring_loop() lines 1012-1050: Cog=5, Cyc=7, SLOC=39
     • track_completion() lines 141-150: Cog=4, Cyc=3, SLOC=10
7. bridge.rs: Simplicity: 59% (Elevated Cognitive Complexity (distributed across many functions))** ahma_http_bridge/src/bridge.rs
   • Metrics: Cog: 58, PeakCog: 8, Cyc: 139, SLOC: 1773, MI: 43.1
   • Hotspots:
     • start_bridge_tcp() lines 529-628: Cog=8, Cyc=14, SLOC=100
     • encode_file_uri() lines 1079-1115: Cog=7, Cyc=7, SLOC=37
     • maybe_install_sighup_handler() lines 394-424: Cog=6, Cyc=7, SLOC=31
     • handle_sse_stream() lines 887-998: Cog=6, Cyc=15, SLOC=112
     • build_cors_layer() lines 217-256: Cog=4, Cyc=5, SLOC=40
8. hooks/mod.rs: Simplicity: 59% (Elevated Cognitive Complexity (distributed across many functions))** ahma_mcp/src/hooks/mod.rs
   • Metrics: Cog: 91, PeakCog: 5, Cyc: 304, SLOC: 1483, MI: 54.4
   • Hotspots:
     • config_relative_path() lines 153-167: Cog=5, Cyc=10, SLOC=15
     • remove_managed_hook_entries() lines 727-754: Cog=5, Cyc=2, SLOC=28
     • uninstall_copilot_hook() lines 872-897: Cog=5, Cyc=2, SLOC=26
     • write_hook_document() lines 1075-1108: Cog=5, Cyc=11, SLOC=34
     • any_managed_hooks_installed_in_env() lines 284-292: Cog=4, Cyc=5, SLOC=9
9. request_handler.rs: Simplicity: 60% (Elevated Cognitive Complexity (distributed across many functions))** ahma_http_bridge/src/request_handler.rs
   • Metrics: Cog: 71, PeakCog: 9, Cyc: 135, SLOC: 918, MI: 47.3
   • Hotspots:
     • handle_session_isolated_request_sse() lines 673-760: Cog=9, Cyc=13, SLOC=88
     • forward_request_sse() lines 830-918: Cog=7, Cyc=9, SLOC=89
     • handle_existing_session_request() lines 202-254: Cog=6, Cyc=9, SLOC=53
     • handle_initialize_sse() lines 763-796: Cog=6, Cyc=7, SLOC=34
     • forward_notification_sse() lines 799-826: Cog=4, Cyc=4, SLOC=28
10. report.rs: Simplicity: 60% (High Cognitive Complexity (concentrated))** ahma_mcp/src/simplify/report.rs
    • Metrics: Cog: 65, PeakCog: 11, Cyc: 115, SLOC: 1124, MI: 48.0
    • Hotspots:
      • build_hotspot_section() lines 410-441: Cog=11, Cyc=8, SLOC=32
      • write_package_simplicity() lines 195-218: Cog=10, Cyc=5, SLOC=24
      • identify_culprit() lines 377-406: Cog=7, Cyc=9, SLOC=30
      • language_group_label() lines 36-49: Cog=4, Cyc=6, SLOC=14
      • from_files() lines 64-106: Cog=4, Cyc=9, SLOC=43
11. daemon_hub.rs: Simplicity: 61% (Elevated Cognitive Complexity (distributed across many functions))** ahma_common/src/daemon_hub.rs
    • Metrics: Cog: 51, PeakCog: 9, Cyc: 135, SLOC: 1167, MI: 43.8
    • Hotspots:
      • handle_connection() lines 625-754: Cog=9, Cyc=15, SLOC=130
      • ensure_daemon_running() lines 234-278: Cog=5, Cyc=7, SLOC=45
      • daemon_subscribe_register_event_unregister_flow() lines 972-1088: Cog=5, Cyc=7, SLOC=117
      • default_socket_path() lines 159-186: Cog=3, Cyc=4, SLOC=28
      • run_daemon_at() lines 351-388: Cog=3, Cyc=6, SLOC=38
12. session.rs: Simplicity: 61% (Elevated Cognitive Complexity (distributed across many functions))** ahma_http_bridge/src/session.rs
    • Metrics: Cog: 55, PeakCog: 8, Cyc: 158, SLOC: 1167, MI: 45.7
    • Hotspots:
      • handle_session_io() lines 1016-1166: Cog=8, Cyc=20, SLOC=151
      • handle_sandbox_notification() lines 558-602: Cog=7, Cyc=11, SLOC=45
      • dispatch_subprocess_line() lines 608-659: Cog=7, Cyc=10, SLOC=52
      • create_session() lines 686-775: Cog=4, Cyc=5, SLOC=90
      • resolve_sandbox_scopes() lines 783-825: Cog=4, Cyc=6, SLOC=43
13. daemon_reporter.rs: Simplicity: 61% (High Cognitive Complexity (concentrated))** ahma_mcp/src/daemon_reporter.rs
    • Metrics: Cog: 32, PeakCog: 25, Cyc: 46, SLOC: 305, MI: 28.1
    • Hotspots:
      • run_reporter_loop() lines 68-259: Cog=25, Cyc=26, SLOC=192
      • result_summary_from() lines 274-295: Cog=6, Cyc=10, SLOC=22
      • status_label() lines 263-272: Cog=1, Cyc=6, SLOC=10
14. adapter/mod.rs: Simplicity: 62% (Elevated Cognitive Complexity (distributed across many functions))** ahma_mcp/src/adapter/mod.rs
    • Metrics: Cog: 47, PeakCog: 6, Cyc: 120, SLOC: 1320, MI: 45.7
    • Hotspots:
      • run_async_operation() lines 562-660: Cog=6, Cyc=10, SLOC=99
      • drain_task_handle() lines 695-715: Cog=4, Cyc=7, SLOC=21
      • handle_stream_line() lines 1148-1166: Cog=4, Cyc=5, SLOC=19
      • push() lines 86-100: Cog=3, Cyc=3, SLOC=15
      • send_final_result_progress() lines 770-784: Cog=3, Cyc=2, SLOC=15
15. models.rs: Simplicity: 63% (Elevated Cognitive Complexity (distributed across many functions))** ahma_mcp/src/simplify/models.rs
    • Metrics: Cog: 58, PeakCog: 9, Cyc: 153, SLOC: 1068, MI: 51.1
    • Hotspots:
      • apply_external() lines 496-543: Cog=9, Cyc=11, SLOC=48
      • from_external_issues() lines 160-201: Cog=8, Cyc=10, SLOC=42
      • from_external() lines 419-484: Cog=8, Cyc=9, SLOC=66
      • weighted_function_mi() lines 629-644: Cog=5, Cyc=5, SLOC=16
      • resolve_extensions() lines 291-303: Cog=4, Cyc=4, SLOC=13
16. config_watcher.rs: Simplicity: 63% (High Cognitive Complexity (concentrated))** ahma_mcp/src/mcp_service/config_watcher.rs
    • Metrics: Cog: 46, PeakCog: 14, Cyc: 71, SLOC: 423, MI: 38.5
    • Hotspots:
      • start_config_watcher() lines 102-212: Cog=14, Cyc=20, SLOC=111
      • configure_sandbox_from_roots() lines 338-422: Cog=7, Cyc=11, SLOC=85
      • snapshot_json_files() lines 60-73: Cog=6, Cyc=6, SLOC=14
      • update_tools() lines 77-99: Cog=5, Cyc=3, SLOC=23
      • maybe_load_per_client_tools() lines 272-336: Cog=5, Cyc=11, SLOC=65
17. sandbox_roots_handshake_test.rs: Simplicity: 63% (Elevated Cognitive Complexity (distributed across many functions))** ahma_http_bridge/tests/sandbox_roots_handshake_test.rs
    • Metrics: Cog: 43, PeakCog: 6, Cyc: 123, SLOC: 1164, MI: 44.8
    • Hotspots:
      • start_deferred_sandbox_server() lines 127-166: Cog=6, Cyc=5, SLOC=40
      • wait_for_bound_port() lines 90-110: Cog=5, Cyc=5, SLOC=21
      • drain_sse_buffer() lines 431-452: Cog=4, Cyc=3, SLOC=22
      • test_malformed_uri_parsing() lines 590-630: Cog=4, Cyc=5, SLOC=41
      • poll_until_healthy() lines 112-124: Cog=3, Cyc=4, SLOC=13
18. request_handler_coverage_test.rs: Simplicity: 63% (High Cognitive Complexity (concentrated))** ahma_http_bridge/tests/request_handler_coverage_test.rs
    • Metrics: Cog: 26, PeakCog: 13, Cyc: 49, SLOC: 634, MI: 37.0
    • Hotspots:
      • test_client_response_invalid_roots() lines 224-336: Cog=13, Cyc=12, SLOC=113
      • run_task_vault_inheritance_and_staged_delete() lines 399-551: Cog=11, Cyc=12, SLOC=153
19. http_bridge_integration_test.rs: Simplicity: 63% (High Cognitive Complexity (concentrated))** ahma_http_bridge/tests/http_bridge_integration_test.rs
    • Metrics: Cog: 41, PeakCog: 16, Cyc: 88, SLOC: 625, MI: 44.6
    • Hotspots:
      • process_sse_roots_handshake() lines 284-368: Cog=16, Cyc=15, SLOC=85
      • send_tool_call_with_retry() lines 179-224: Cog=8, Cyc=9, SLOC=46
      • send_mcp_request() lines 40-100: Cog=6, Cyc=11, SLOC=61
      • first_sse_event_boundary() lines 162-176: Cog=4, Cyc=7, SLOC=15
      • drain_sse_events() lines 241-251: Cog=3, Cyc=3, SLOC=11
20. multiline_argument_handling_test.rs: Simplicity: 63% (Elevated Cyclomatic Complexity (distributed across many functions))** ahma_mcp/tests/multiline_argument_handling_test.rs
    • Metrics: Cog: 13, PeakCog: 7, Cyc: 23, SLOC: 705, MI: 31.1
    • Hotspots:
      • test_multiline_git_commit_message() lines 382-575: Cog=7, Cyc=6, SLOC=194
      • test_multiline_git_commit_with_real_tool() lines 209-379: Cog=4, Cyc=6, SLOC=171

Metrics Glossary

Score Formula

Scores are calibrated for AI-assisted maintenance: decomposed, focused functions reduce the context an AI agent must hold to make safe changes.

The composite simplicity score is computed as:

Score = 0.4 × MI + 0.3 × Cognitive Density + 0.2 × Peak Cognitive + 0.1 × Length Score

Cognitive Complexity

• Description: Measures how hard it is to understand the control flow of the code. See
• How to Improve: Extract complex conditions into well-named functions and reduce nesting levels.

Cyclomatic Complexity

• Description: Measures the number of linearly independent paths through the source code (info only — not directly scored). See
• How to Improve: Use polymorphic abstractions instead of complex switch/if-else chains, and break down large functions into smaller components.

Source Lines of Code (SLOC)

• Description: A measure of the size of the computer program by counting the number of lines in the text of the source code. See
• How to Improve: Remove dead code and refactor repetitive logic into reusable helper functions or macros.

Maintainability Index (MI)

• Description: A composite metric representing the relative ease of maintaining the code; higher is better. See
• How to Improve: Simultaneously reduce complexity (both cognitive and cyclomatic) and file size to boost the index.