{
  "project_path": "/absolute/path/to/project",
  "python_version": "3.11",
  "indexed_at": "2026-01-10T10:30:00Z",
  "build_duration_ms": 1234,
  "stats": {
"total_functions": 456,
"total_call_edges": 1203,
"total_modules": 89,
"total_files": 67,
"taint_summaries": 234
  }
}

Your project at /Users/you/backend has:
• 456 functions across 67 files
• 89 modules with 1203 call relationships
• Indexed 5 minutes ago in 1.2 seconds
• Python 3.11 detected

{
  "symbols": [
{
  "name": "validate_user",
  "fully_qualified_name": "app.auth.validate_user",
  "type": "function",
  "file_path": "/project/app/auth.py",
  "line_number": 45,
  "metadata": {
    "return_type": "bool",
    "parameters": ["username", "password"],
    "decorators": ["@require_auth"],
    "is_async": false
  }
}
  ],
  "next_cursor": "abc123",
  "total_matches": 5
}

Find all functions named validate_user

Find symbols matching process_*

Locate the User class definition

Found 3 matches for "validate_*":

1. validate_user (function)
   Location: app/auth.py:45
   FQN: app.auth.validate_user
   Parameters: username, password
   Returns: bool

2. validate_email (function)
   Location: app/utils.py:123
   FQN: app.utils.validate_email

3. validate_token (function)
   Location: app/auth.py:89
   FQN: app.auth.validate_token

{
  "target_function": "app.auth.validate_user",
  "callers": [
{
  "caller_fqn": "app.api.login_endpoint",
  "caller_file": "/project/app/api.py",
  "caller_line": 78,
  "call_sites": [
    {
      "file": "/project/app/api.py",
      "line": 82,
      "column": 12
    }
  ]
}
  ],
  "next_cursor": "xyz789",
  "total_callers": 12
}

What functions call validate_user?

Show me all callers of process_payment

Who uses the deprecated authenticate function?

Found 12 functions that call app.auth.validate_user:

1. app.api.login_endpoint (app/api.py:82)
2. app.api.register_endpoint (app/api.py:145)
3. app.middleware.auth_middleware (app/middleware.py:34)
4. app.cli.login_command (app/cli.py:67)

... and 8 more (use pagination to see all)

{
  "source_function": "app.api.login_endpoint",
  "callees": [
{
  "callee_fqn": "app.auth.validate_user",
  "callee_file": "/project/app/auth.py",
  "callee_line": 45,
  "resolution_status": "resolved",
  "call_site": {
    "file": "/project/app/api.py",
    "line": 82,
    "column": 12
  },
  "type_inference": {
    "confidence": "high",
    "method": "static_analysis"
  }
}
  ],
  "unresolved_calls": [
{
  "name": "external_api_call",
  "reason": "Dynamic import or external library"
}
  ],
  "next_cursor": "def456",
  "total_callees": 8
}

What functions does login_endpoint call?

Show dependencies of process_payment

What does the authenticate function depend on?

app.api.login_endpoint calls 8 functions:

Resolved (6):
1. app.auth.validate_user (app/auth.py:45)
2. app.db.get_user_by_email (app/db.py:123)
3. app.auth.generate_token (app/auth.py:89)
4. app.utils.log_event (app/utils.py:34)
5. app.db.update_last_login (app/db.py:156)
6. app.api.send_response (app/api.py:23)

Unresolved (2):
- redis.set (external library)
- some_dynamic_function (dynamic resolution)

{
  "caller": "app.api.login_endpoint",
  "callee": "app.auth.validate_user",
  "call_details": {
"file": "/project/app/api.py",
"line": 82,
"column": 12,
"arguments": [
  { "name": "username", "value": "request.form['username']" },
  { "name": "password", "value": "request.form['password']" }
],
"resolution": {
  "status": "resolved",
  "confidence": "high",
  "method": "static_type_inference"
},
"context": {
  "in_try_block": true,
  "in_loop": false,
  "is_conditional": false
}
  }
}

Show me details of the call from login_endpoint to validate_user

Get call site information between process_payment and charge_card

Call from app.api.login_endpoint to app.auth.validate_user:

Location: app/api.py:82:12
Arguments:
  - username: request.form['username']
  - password: request.form['password']

Resolution: High confidence (static type inference)
Context: Inside try-except block

{
  "import_path": "app.auth",
  "matches": [
{
  "file_path": "/project/app/auth.py",
  "module_fqn": "app.auth",
  "match_type": "exact"
}
  ],
  "match_status": "exact" | "partial" | "ambiguous" | "not_found",
  "suggestions": [
"app.authentication",
"app.auth_utils"
  ]
}

Where is the import "app.auth" located?

Resolve the import path for utils.validators

Find the file for django.contrib.auth import

Import "app.auth" resolves to:
  File: /project/app/auth.py
  Module: app.auth
  Match: Exact

No ambiguity found.

Find the auth module

Where is the models.user module?

Found 2 modules matching "auth":

1. myapp.auth
   File: /project/myapp/auth.py
   Functions: 12

2. myapp.api.auth
   File: /project/myapp/api/auth.py
   Functions: 8

List all modules in the project

Show me the project structure

Find all Dockerfiles with unpinned base images

Show me all EXPOSE instructions on port 8080

Which Dockerfiles use the python base image?

Found 3 unpinned FROM instructions:

1. Dockerfile:1 — FROM python:3.11-slim (no digest)
2. services/api/Dockerfile:1 — FROM node:18-alpine (no digest)
3. services/worker/Dockerfile:1 — FROM golang:1.21 (no digest)

Find all privileged containers in docker-compose

Which services mount the Docker socket?

Show services exposing port 443

Found 1 privileged service:

1. web (docker-compose.yml:5)
   Image: nginx:latest
   Privileged: true
   Network mode: host
   Volumes: /var/run/docker.sock:/var/run/docker.sock
   Capabilities: SYS_ADMIN, NET_ADMIN

Show me the full breakdown of the API Dockerfile

Analyze the multi-stage build in services/app/Dockerfile

Dockerfile: services/api/Dockerfile
Total instructions: 15
Multi-stage: Yes (2 stages: builder, runtime)

Summary:
  ✓ Has USER instruction (appuser)
  ✗ Missing HEALTHCHECK
  ⚠ 1 unpinned base image

Stages:
  1. builder (golang:1.21-alpine)
  2. runtime (alpine:3.19)

Show me all dependencies for the web service

What depends on the database service?

Show the build dependency chain for the Dockerfile builder stage

Service: web (docker-compose.yml:12)
Direction: both

Upstream (web depends on):
  → api (docker-compose.yml:5)
  → redis (docker-compose.yml:20)

Downstream (depends on web):
  → nginx (docker-compose.yml:30)

Chain: redis → api → web → nginx

{
  "limit": 20,
  "cursor": "next_page_token_here"
}

Get callers of validate_user (next page with cursor abc123)

{
  "error": {
"code": "SYMBOL_NOT_FOUND",
"message": "Symbol 'invalid_function' not found in index",
"details": {
  "searched_name": "invalid_function",
  "suggestions": ["validate_function", "valid_function"]
}
  }
}