# abhimanyu-1411/novuspipline architecture

> Architecture diagram of the GitHub repository abhimanyu-1411/novuspipline, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhimanyu-1411/novuspipline
- Repository: https://github.com/abhimanyu-1411/novuspipline

## Overview

NovusPipeline is a local MCP service for auditing and safely modernizing code, accompanied by a product website with an interactive architectural showcase. The documented workflow is: an assistant invokes the MCP server, which indexes the workspace, audits code against rules and optional analyzers, proposes behavior-preserving changes, runs the project’s tests in a sandbox, and commits changed files on a branch. Standards and retrieval-augmented guidelines shape audits and proposals; optional GNN and local-LLM capabilities extend analysis and rewriting. The website presents product capabilities and installation guidance. Some Python links are documented in the README or visible in the server excerpt; unsampled implementation details are not inferred.

Main entry points: [`src/novuspipeline/server.py`](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/server.py) (MCP tools), [`src/novuspipeline/codebase_context.py`](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/codebase_context.py) (Workspace index), [`website/src/App.jsx`](https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/App.jsx) (Website app), [`src/novuspipeline/sandbox.py`](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/sandbox.py) (Test sandbox)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP service"]
  node_server["MCP tools<br/>[server.py]"]
  node_sandbox["Test sandbox<br/>[sandbox.py]"]
end

subgraph group_analysis["Code intelligence"]
  node_context["Workspace index"]
  node_facts["Code facts<br/>[code_facts.py]"]
  node_graph["AST graph<br/>[code_graph.py]"]
  node_gnn["Structural GNN<br/>[gnn_model.py]"]
  node_history["History learner<br/>[history_learner.py]"]
end

subgraph group_modernize["Modernization controls"]
  node_modernizer["Smell rules and rewrites<br/>[modernizer.py]"]
  node_ruff["Ruff backend<br/>[ruff_backend.py]"]
  node_standards["Standards packs<br/>[standards.py]"]
  node_rag[("Guideline retrieval<br/>[ingest_rag.py]")]
  node_llm["Local LLM client<br/>[local_llm.py]"]
  node_worker["LLM worker<br/>[llm_worker.py]"]
end

subgraph group_web["Product website"]
  node_app["Website app<br/>[App.jsx]"]
  node_sections["Product sections"]
end

subgraph group_scene["Interactive showcase"]
  node_experience["3D experience<br/>[Experience.jsx]"]
  node_graphview["Graph rendering<br/>[CodeGraph.jsx]"]
  node_playground["Sandbox playground<br/>[Playground.jsx]"]
end

node_assistant(("Assistant / MCP client"))
node_workspace[("Project workspace")]
node_tests["Project tests"]
node_git["Git repository"]

node_assistant -->|"invokes tools"| node_server
node_server -->|"requests context"| node_context
node_context -->|"indexes files"| node_workspace
node_context -->|"uses analysis"| node_facts
node_context -->|"uses model"| node_gnn
node_context -->|"uses learner"| node_history
node_context -->|"uses backend"| node_ruff
node_server -->|"requests rewrites"| node_modernizer
node_server -->|"loads standards"| node_standards
node_server -->|"retrieves guidelines"| node_rag
node_server -->|"requests proposals"| node_llm
node_llm -->|"starts worker"| node_worker
node_modernizer -.->|"test-gated changes"| node_sandbox
node_sandbox -->|"runs tests"| node_tests
node_server -->|"commits changes"| node_git
node_app -->|"renders sections"| node_sections
node_app -->|"loads scene"| node_experience
node_experience -->|"renders graph"| node_graphview
node_sections -->|"includes playground"| node_playground

click node_server "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/server.py"
click node_context "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/codebase_context.py"
click node_facts "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/code_facts.py"
click node_graph "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/code_graph.py"
click node_gnn "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/gnn_model.py"
click node_history "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/history_learner.py"
click node_modernizer "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/modernizer.py"
click node_ruff "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/ruff_backend.py"
click node_standards "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/standards.py"
click node_rag "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/ingest_rag.py"
click node_llm "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/local_llm.py"
click node_worker "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/llm_worker.py"
click node_sandbox "https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/sandbox.py"
click node_app "https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/App.jsx"
click node_sections "https://github.com/abhimanyu-1411/novuspipline/tree/main/website/src/sections"
click node_experience "https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/scene/Experience.jsx"
click node_graphview "https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/scene/CodeGraph.jsx"
click node_playground "https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/playground/Playground.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_sandbox,node_assistant toneBlue
class node_context,node_facts,node_graph,node_gnn,node_history,node_workspace toneAmber
class node_modernizer,node_ruff,node_standards,node_rag,node_llm,node_worker toneMint
class node_app,node_sections toneRose
class node_experience,node_graphview,node_playground,node_tests,node_git toneIndigo
```

## Components

### MCP service

- [MCP tools](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/server.py): `src/novuspipeline/server.py`
- [Test sandbox](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/sandbox.py): `src/novuspipeline/sandbox.py`

### Code intelligence

- [Workspace index](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/codebase_context.py): `src/novuspipeline/codebase_context.py`
- [Code facts](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/code_facts.py): `src/novuspipeline/code_facts.py`
- [AST graph](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/code_graph.py): `src/novuspipeline/code_graph.py`
- [Structural GNN](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/gnn_model.py): `src/novuspipeline/gnn_model.py`
- [History learner](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/history_learner.py): `src/novuspipeline/history_learner.py`

### Modernization controls

- [Smell rules and rewrites](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/modernizer.py): `src/novuspipeline/modernizer.py`
- [Ruff backend](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/ruff_backend.py): `src/novuspipeline/ruff_backend.py`
- [Standards packs](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/standards.py): `src/novuspipeline/standards.py`
- [Guideline retrieval](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/ingest_rag.py): `src/novuspipeline/ingest_rag.py`
- [Local LLM client](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/local_llm.py): `src/novuspipeline/local_llm.py`
- [LLM worker](https://github.com/abhimanyu-1411/novuspipline/blob/main/src/novuspipeline/llm_worker.py): `src/novuspipeline/llm_worker.py`

### Product website

- [Website app](https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/App.jsx): `website/src/App.jsx`
- [Product sections](https://github.com/abhimanyu-1411/novuspipline/tree/main/website/src/sections): `website/src/sections`

### Interactive showcase

- [3D experience](https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/scene/Experience.jsx): `website/src/scene/Experience.jsx`
- [Graph rendering](https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/scene/CodeGraph.jsx): `website/src/scene/CodeGraph.jsx`
- [Sandbox playground](https://github.com/abhimanyu-1411/novuspipline/blob/main/website/src/playground/Playground.jsx): `website/src/playground/Playground.jsx`

### Other components

- **Assistant / MCP client**
- **Project workspace**
- **Project tests**
- **Git repository**

## Connections

- Assistant / MCP client → MCP tools: invokes tools (evidence: `README.md`)
- MCP tools → Workspace index: requests context (evidence: `src/novuspipeline/server.py`)
- Workspace index → Project workspace: indexes files (evidence: `README.md`)
- Workspace index → Code facts: uses analysis (evidence: `src/novuspipeline/codebase_context.py`)
- Workspace index → Structural GNN: uses model (evidence: `src/novuspipeline/codebase_context.py`)
- Workspace index → History learner: uses learner (evidence: `src/novuspipeline/codebase_context.py`)
- Workspace index → Ruff backend: uses backend (evidence: `src/novuspipeline/codebase_context.py`)
- MCP tools → Smell rules and rewrites: requests rewrites (evidence: `src/novuspipeline/server.py`)
- MCP tools → Standards packs: loads standards (evidence: `src/novuspipeline/server.py`)
- MCP tools → Guideline retrieval: retrieves guidelines (evidence: `src/novuspipeline/server.py`)
- MCP tools → Local LLM client: requests proposals (evidence: `src/novuspipeline/server.py`)
- Local LLM client → LLM worker: starts worker (evidence: `src/novuspipeline/local_llm.py`)
- Smell rules and rewrites → Test sandbox: test-gated changes (evidence: `README.md`)
- Test sandbox → Project tests: runs tests (evidence: `README.md`)
- MCP tools → Git repository: commits changes (evidence: `README.md`)
- Website app → Product sections: renders sections (evidence: `website/src/App.jsx`)
- Website app → 3D experience: loads scene (evidence: `website/src/App.jsx`)
- 3D experience → Graph rendering: renders graph (evidence: `website/src/scene/Experience.jsx`)
- Product sections → Sandbox playground: includes playground (evidence: `website/src/sections/Standards.jsx`)
