Core concepts
Node types
Reference for all 42 node types in the Software Graph, organized by category with their ID prefixes.
Structure nodes
Top-level organizational concepts that represent the shape of a project or workspace.
- Workspace (workspace) — monorepo root or project workspace
- Application (app) — a deployable application
- Package (pkg) — an npm package or workspace package
- Module (mod) — a TypeScript/JavaScript module (file)
- Namespace (ns) — a TypeScript/JavaScript namespace
Code nodes
Language-level constructs extracted from TypeScript source. These form the core of the call graph and type hierarchy.
- Function (fn) — standalone function declarations and expressions
- Method (method) — class or object method
- Class (class) — class declaration
- Interface (iface) — interface declaration
- TypeAlias (type) — type alias declaration
- Enum (enum) — enum declaration
- Decorator (decorator) — decorator applied to a class, method, or parameter
Dependency nodes
Nodes that represent module boundaries, external dependencies, and build scripts.
- Dependency (dep) — external npm dependency
- Import (import) — import statement
- Export (export) — export statement
- Script (script) — package.json script
Infrastructure nodes
Build, CI/CD, and framework-level concepts detected by the compiler.
- Task (task) — a build or automation task
- Pipeline (pipeline) — CI/CD pipeline definition
- BuildTarget (target) — a build target or output
- Configuration (config) — configuration file or section
- Container (container) — Docker or container definition
- Workflow (workflow) — GitHub Actions or CI workflow
- Job (job) — a job within a workflow
- Step (step) — a step within a job
- Framework (framework) — detected framework (Next.js, Express, etc.)
Architecture nodes
Higher-level architectural concepts that represent application structure, routing, and dependency injection patterns.
- Route (route) — HTTP route or API endpoint
- Resource (resource) — REST resource
- Operation (op) — API operation
- Model (model) — data model or schema
- Field (field) — model field or property
- Middleware (middleware) — request middleware
- Provider (provider) — dependency injection provider
- Factory (factory) — factory function or class
- Service (service) — service class or module
- Repository (repo) — data access repository
- Controller (controller) — request controller
- Guard (guard) — authorization or route guard
Runtime nodes
Nodes that represent runtime concerns — databases, environment, events, security, and errors.
- DatabaseTable (table) — database table reference
- EnvironmentVariable (env) — environment variable usage
- Event (event) — event emission or subscription
- Permission (permission) — authorization permission
- Exception (exception) — custom error or exception class