Codebase Memory Quality

Code Quality Analysis via Knowledge Graph

Use graph degree filtering to find dead code, high-complexity functions, and refactor candidates — all in single tool calls.

Workflow

Dead Code Detection

Find functions with zero inbound CALLS edges, excluding entry points:

search_graph(
  label="Function",
  relationship="CALLS",
  direction="inbound",
  max_degree=0,
  exclude_entry_points=true
)

exclude_entry_points=true removes route handlers, main(), and framework-registered functions that have zero callers by design.

Verify Dead Code Candidates

Before deleting, verify each candidate truly has no callers:

trace_call_path(function_name="SuspectFunction", direction="inbound", depth=1)

Also check for read references (callbacks, stored in variables):

query_graph(query="MATCH (a)-[r:USAGE]->(b) WHERE b.name = 'SuspectFunction' RETURN a.name, a.file_path LIMIT 10")

High Fan-Out Functions (calling 10+ others)

These are often doing too much and are refactor candidates:

search_graph(
  label="Function",
  relationship="CALLS",
  direction="outbound",
  min_degree=10
)

High Fan-In Functions (called by 10+ others)

These are critical functions — changes have wide impact:

search_graph(
  label="Function",
  relationship="CALLS",
  direction="inbound",
  min_degree=10
)

Files That Change Together (Hidden Coupling)

Find files with high git change coupling:

query_graph(query="MATCH (a)-[r:FILE_CHANGES_WITH]->(b) WHERE r.coupling_score >= 0.5 RETURN a.name, b.name, r.coupling_score, r.co_change_count ORDER BY r.coupling_score DESC LIMIT 20")

High coupling between unrelated files suggests hidden dependencies.

Unused Imports

search_graph(
  relationship="IMPORTS",
  direction="outbound",
  max_degree=0,
  label="Module"
)

Key Tips

• search_graph with degree filters has no row cap (unlike query_graph which caps at 200).
• Use file_pattern to scope analysis to specific directories: file_pattern="**/services/**".
• Dead code detection works best after a full index — run index_repository if the project was recently set up.
• Paginate results with limit and offset — check has_more in the response.