CodeGraph/docs
Developer Documentationv0.1.0 Static Analysis Engine

CodeGraph Documentation

CodeGraph transforms TypeScript and JavaScript repositories into a deterministic, queryable entity-relationship graph. This documentation details the end-to-end pipeline, AST extraction internals, graph query layer, traversal analytics, and structural health scoring models.

Engineering System Documentation
This documentation is built directly from the source implementation in server/src/. It reflects the exact deterministic behavior of the AST parser, graph builder, analytics engine, and mathematical health scoring algorithms.

Documentation Sections

Section 1

Introduction

High-level overview, core architecture concepts, and getting started with CodeGraph.

Section 2

Architecture & Pipeline

The 5-stage transformation pipeline from raw source files to typed entities and relationships.

Section 3

Canonical Graph Model

The 5-map in-memory graph structure, invariants, graph query facade, and serialization.

Section 4

Analytics Suite

Graph analysis engine answering upstream impact, downstream dependencies, cycles, and connectivity.

Section 5

Algorithmic Foundations

Deep dive into the core DSA algorithms powering CodeGraph and their specific adaptations.

Section 6

Health Index & Structural Metrics

The 6 structural graph metrics, continuous normalization curves, RMS math, and weighted scoring.

Section 7

Technical Reference

Complete node kinds, relationship edges, supported syntax extensions, and REST API specification.