google / adk-python
Code health
Hotspots average 4.8, the place fixes pay off most.
Explore this codebase
- Code health map237hotspots across 2,369 files
- Ownership1,168sole-owned files: one author, no second reader
- Architecture5modules, 59 entry points
- Decisions14recorded, of which 0 in force and 14 background
- Refactoring298open opportunities, one per file
- TestsNo coverage report yet. Run your tests with coverage on, then add the report:
AlsoDocsChatFilesKnowledge graphChange couplingCommitsStatsCosts
Do next · 3
46 things worth doing in the week to Aug 11, the last indexed commit, 43 of them now.
Worth planning
Flatten the nesting in _run_node_async
src/google/adk/runners.py:574
_run_node_async nests deeply; easier to read and change once split, which also removes a duplicate; function changed in 8 commits; its file is imported by 99 files, changed 14 times in 90 days.
- gain
- up to under +0.1 health on this file(inferred)
- finding
- Nested complexity
- size
- CCN 29, 125 lines, nests 5 deep
- severity
- high
Medium effort, worth a checkStart breaking up to_agent_engine (CCN 60, 332 lines): first lift lines 1208-1282
src/google/adk/cli/cli_deploy.py:1208
to_agent_engine nests deeply; easier to read and change once split, which also removes a duplicate; function changed in 3 commits; its file is imported by 6 files, changed 8 times in 90 days.
- gain
- up to under +0.1 health on this file(inferred)
- finding
- Nested complexity
- size
- CCN 60, 332 lines, nests 5 deep
- severity
- high
Medium effort, worth a checkStart breaking up receive (CCN 57, 303 lines): first lift lines 402-500
src/google/adk/models/gemini_llm_connection.py:402
receive nests deeply; easier to read and change once split, which also removes a duplicate; function changed in 5 commits; its file is imported by 3 files, changed 6 times in 90 days.
- gain
- up to +0.7 health on this file(inferred)
- finding
- Nested complexity
- size
- CCN 57, 303 lines, nests 5 deep
- severity
- high
Medium effort, worth a check
Improve what Repowise can see
Add a test coverage report
Without one, Repowise cannot tell tested code from untested code, so every test-related action says “unknown”.
- line coverage
- Unknown, no report
Small effort
Everything we found
5 areas
Every detector's open count by area. The actions above are the part worth doing.
- Code health6,303 open findingsCriticalUntested hotspot · src/google/adk/flows/llm_flows/functions.py36 findings · 10.0 deducted
- Refactoring298 open opportunitiesMediumbuild_graph+1.5 health, S effort · src/google/adk/cli/agent_graph.py
- Decisions0 drifting from the codeMediumtests/unittests/plugins/test_bigquery_agent_analytics_plugin.pyHigh-churn file with no governing decision
- Ownership1,168 sole-owned filesMediumsrc/google/adk/cli/cli_tools_click.pyOne author, no second reader
- Dead code139LowOEUnreachable function (0 lines)