lablup Code Trace
Locate where a feature lives across layers. The codebase is split per entity, so once you know the entity name (user, session, deployment, …) every layer is a predictable path.
Layer map ({entity} = entity name)
| Layer | Path | What's there |
|---|---|---|
| REST v2 entry | manager/api/rest/v2/{entity}/registry.py |
RouteRegistry — method + path + middleware → handler method |
| REST v2 handler | manager/api/rest/v2/{entity}/handler.py |
V2{Entity}Handler — calls a Processor |
| GraphQL resolver | manager/api/gql/{entity}/resolver/{query,mutation}.py |
Strawberry query/mutation resolvers |
| GraphQL types | manager/api/gql/{entity}/types/ |
node, inputs, payloads, filters, enums, scopes |
| GraphQL root | manager/api/gql/schema.py |
assembles all resolvers into the schema |
| Service | manager/services/{entity}/ |
service.py, processors.py, actions/, types.py |
| Repository | manager/repositories/{entity}/ |
repository.py, creators.py/updaters.py/purgers.py, db_source/ |
| DB models | manager/models/ |
SQLAlchemy tables |
| Errors | {component}/errors/{domain}.py |
see manager/errors/AGENTS.md |
Flow: API handler → Processor → Service → Repository → DB. Handlers never call Services directly.
Trace a request end to end
- Find the entry:
grep -rn "reg.add" manager/api/rest/v2/{entity}/registry.py(REST) or opengql/{entity}/resolver/. - Follow the handler/resolver to its Processor, then to the Service method, then to the Repository.
- The Action (frozen dataclass) passed into the Service is in
services/{entity}/actions/.
supergraph.graphql (21k lines) — never Read it whole
It is a generated single file. Extract only the block you need:
# find the line number of a type/input/query
grep -n "^type User\b\|^input .*User\|^type Query\|^type Mutation" supergraph.graphql
Then Read with offset/limit around that line. For the actual resolver logic, jump to the source under gql/{entity}/ instead — the schema only shows the contract.
Related
/api-guide— implement REST/GraphQL endpoints/repository-guide,/service-guide— layer patternsmanager/errors/AGENTS.md— find/define exceptions