Tool reference

Returns projectPath, filesScanned, filesParsed, filesRemoved, nodes, edges, resolvedCalls, unresolvedCalls, dynamicDispatchEdges, adviceEdges, aspects, decorators, languages, durationMs.

crawl_project({ path: "C:/work/shop-service" })

No arguments. Returns nodes, edges, files, lastCrawl, projectPath.

index_status({})

No arguments. Use it when an assistant needs to reason about which edge kind expresses a relationship before querying.

get_schema({})

No arguments. Returns { ok: true, cleared: true }.

clear_index({})

Returns query, count, and results[] with id, qualifiedName, name, kind, filePath.

search_symbols({ query: "OrderService", kind: "class" })

Returns id, kind, qualifiedName, filePath, and properties (signature, modifiers, annotations, startLine, endLine, ...).

get_node({ qualified_name: "com.acme.OrderService#place" })

Returns target and callers[] with caller, depth, callSiteLine, edgeKind.

get_callers({
  symbol: "com.acme.OrderRepository#create",
  transitive: true,
  include_dynamic: true
})

Returns source and callees[] with callee, depth, callSiteLine, edgeKind.

get_callees({ symbol: "com.acme.Checkout#checkout", max_depth: 4 })

Returns pathCount and paths[], each with length, a symbol-id path array, and edges[] carrying kind and callSiteLine.

trace_path({
  source: "com.acme.Main#main",
  target: "com.acme.Gateway#authorize",
  include_dynamic: true,
  max_depth: 12
})

Returns center, nodeCount, nodes[], edges[].

get_subgraph({
  symbol: "com.acme.Payment",
  radius: 2,
  edge_kinds: ["CALLS", "DYNAMIC_DISPATCH", "ADVISES"]
})

Returns root, stepCount, and steps[] with symbol, depth, via (CALLS, DYNAMIC_DISPATCH, ADVISES, or INTERCEPT), and callSiteLine.

trace_execution({
  symbol: "com.acme.Checkout#checkout",
  include_advice: true,
  max_depth: 6
})

Returns target, implementationCount, and implementations[] with type, depth, via (IMPLEMENTS or EXTENDS).

find_implementations({ symbol: "com.acme.Payment" })

Returns aspectCount and aspects[], each with aspect and advice[] carrying method, adviceKind, pointcut, and advised[].

find_aspects({ limit: 20 })

Returns symbol, decorators[] (name, fqn, decorator, line, arguments), and members[] when requested.

get_decorators({
  symbol: "com.acme.DecoratedService",
  include_members: true
})

Returns annotation, count, and results[] with symbol, annotation, line, arguments.

find_annotated({ annotation: "Cacheable", kind: "method" })

Returns count and entryPoints[] with symbol, kind, detail, framework, and line. Recognised: Spring MVC mappings, @Scheduled/@EventListener, tests, main, FastAPI/Flask decorators, if __name__ == "__main__", NestJS controllers, Express handlers, and Jest/pytest tests.

find_entry_points({ kind: "route", limit: 50 })

Each route carries httpMethod, path, handler, framework, and a ROUTES edge. Inline Express handlers get a synthetic node (module:src.routes#<anonymous@7>) so their body is still traceable.

find_routes({ method: "POST", framework: "nestjs" })

Detected from @Autowired members, NestJS constructor parameters, FastAPI Depends(...), @injectable constructor parameters, and project-class constructor parameters. Primitive and structural parameter types are counted but produce no edge, so @Body() body: { id: string } does not pollute the graph.

find_injections({ framework: "nestjs" })

Returns count and reflections[] with source, target, mechanism, resolved, and line. When the target is statically determinable — a literal, or a literal prefix plus a variable — the edge points at the real symbol; otherwise it points at a __reflect__: marker holding the expression.

find_reflections({ resolved_only: true })

Returns count and dependencies[] with package, references, and files. Packages are normalised to the import root — ext:fastapi, @nestjs/common, express. Project-internal namespaces are never reported as external.

find_external_dependencies({ limit: 100 })

Returns count and hotspots[] with symbol, fanIn, fanOut, adviceCount.

find_hotspots({ min_fan_in: 3, limit: 25 })

Returns count and unused[] with symbol and reason. main is excluded as an entry point.

find_dead_code({ limit: 100, include_constructors: false })