Section 7.4Source:
server/src/routes/REST API & Integration Schema
Complete HTTP specification for repository ingestion, full graph serialization, and algorithmic analytics queries.
Source:
server/src/routes/Repository Endpoints (`/api/repositories`)
| Method & Route | Description | Auth Required |
|---|---|---|
| POST /api/repositories | Ingest repository URL and start background analysis pipeline. | Yes |
| GET /api/repositories | List all ingested repositories for the authenticated user. | Yes |
| GET /api/repositories/:id | Retrieve metadata and analysis status for a repository. | Yes |
| GET /api/repositories/:id/graph | Retrieve the complete serialized PersistedGraph { nodes, edges }. | Yes |
| GET /api/repositories/:id/overview | Retrieve high-level statistics and the 6 Health Index metrics. | Yes |
Analytics Endpoints (`/api/analytics`)
| Method & Route | Query Parameters | Algorithm / Response |
|---|---|---|
| GET /api/analytics/:id/analysis/impact | sourceNodeId (string), maxDepth (opt) | ImpactAnalysisResult { impactedNodeIds, depthByNode } |
| GET /api/analytics/:id/analysis/dependencies | sourceNodeId (string), maxDepth (opt) | DependencyAnalysisResult { dependencyNodeIds, depthByNode } |
| GET /api/analytics/:id/analysis/cycles | types (opt) | CycleAnalysisResult { cycles: Cycle[] } |
| GET /api/analytics/:id/analysis/ordering | sourceNodeId (string) | DependencyOrderingResult { orderedNodeIds, isOrderable } |
| GET /api/analytics/:id/analysis/paths | sourceNodeId, targetNodeId | CallPathResult { path: string[] | null } |