Documentation menu

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