# trgiangv/revitdevtool architecture

> Architecture diagram of the GitHub repository trgiangv/revitdevtool, 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/trgiangv/revitdevtool
- Repository: https://github.com/trgiangv/revitdevtool

## Overview

RevitDevTool is an in-host development platform for Revit and AutoCAD. A user selects a script in the add-in, runs it against the live host, and reads output in the Trace panel; runtimes include Python, IronPython, C#, F#, and compiled .NET. Separate capabilities cover package installation, debugging, in-host testing, MCP access, logging, and Revit geometry preview. The graph combines README-described behavior with the sampled startup and MCP code; unverified runtime wiring is left dashed or omitted.

Main entry points: [`source/DevTools.Execution/Services/ExecutionOrchestrator.cs`](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Services/ExecutionOrchestrator.cs) (Execution Orchestrator), [`source/DevTools.Execution/Providers/Python/PythonInitializer.cs`](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonInitializer.cs) (Python Runtime), [`source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs`](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs) (MCP Tools), [`source/RevitDevTool/Application.cs`](https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Application.cs) (Revit Add-in)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host Add-ins"]
  node_revit_addin["Revit Add-in<br/>[Application.cs]"]
  node_acad_addin["AutoCAD Add-in<br/>[Application.cs]"]
  node_host_adapters["Host Bridges"]
end

subgraph group_execution["Code Execution"]
  node_script_panel["Script Panel<br/>[PanelController.cs]"]
  node_orchestrator["Execution Orchestrator"]
  node_python_runtime["Python Runtime"]
  node_ironpython_runtime["IronPython Runtime"]
  node_dotnet_runtime[".NET Runtimes"]
  node_python_packages["Python Packages"]
  node_debugging["Debugging<br/>[PythonDebugger.cs]"]
end

subgraph group_ai["AI Integration"]
  node_daemon["DevTools Daemon<br/>[Program.cs]"]
  node_mcp_engine["MCP Tools<br/>[McpEngine.cs]"]
  node_host_discovery["Host Discovery"]
  node_code_mode["Code Mode<br/>[CodeModeTool.cs]"]
end

subgraph group_testing["In-Host Testing"]
  node_test_runner["Test Execution"]
  node_test_host["Testing Host"]
end

subgraph group_experience["Output and Visualization"]
  node_trace["Trace Logs"]
  node_visualization["Geometry Preview"]
  node_geometry_storage["Geometry Buffer"]
end

node_user(("Developer"))
node_revit["Revit Host"]
node_acad["AutoCAD Host"]
node_mcp_client(("AI Assistant"))

node_user -->|"selects and runs"| node_script_panel
node_script_panel -.->|"starts execution"| node_orchestrator
node_orchestrator -.->|"dispatches Python"| node_python_runtime
node_orchestrator -.->|"dispatches IronPython"| node_ironpython_runtime
node_orchestrator -.->|"dispatches .NET"| node_dotnet_runtime
node_python_runtime -->|"installs dependencies"| node_python_packages
node_python_runtime -.->|"supports debugging"| node_debugging
node_orchestrator -.->|"runs in host"| node_host_adapters
node_revit_addin -->|"loads in"| node_revit
node_acad_addin -->|"loads in"| node_acad
node_user -->|"uses add-in"| node_revit_addin
node_user -->|"uses add-in"| node_acad_addin
node_mcp_client -->|"connects via MCP"| node_daemon
node_daemon -->|"hosts tools"| node_mcp_engine
node_mcp_engine -.->|"discovers hosts"| node_host_discovery
node_mcp_engine -->|"registers tool"| node_code_mode
node_code_mode -.->|"accesses host sessions"| node_host_discovery
node_user -->|"runs tests"| node_test_runner
node_test_runner -.->|"runs in host"| node_test_host
node_orchestrator -.->|"writes output"| node_trace
node_user -->|"reads output"| node_trace
node_user -->|"views geometry"| node_visualization
node_visualization -.->|"stores geometry"| node_geometry_storage

click node_revit_addin "https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Application.cs"
click node_acad_addin "https://github.com/trgiangv/revitdevtool/blob/develop/source/AcadDevTool/Application.cs"
click node_host_adapters "https://github.com/trgiangv/revitdevtool/tree/develop/source/AcadDevTool/Adapters"
click node_script_panel "https://github.com/trgiangv/revitdevtool/blob/develop/source/AcadDevTool/Controllers/PanelController.cs"
click node_orchestrator "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Services/ExecutionOrchestrator.cs"
click node_python_runtime "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonInitializer.cs"
click node_ironpython_runtime "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/IronPython/IronPythonInitializer.cs"
click node_dotnet_runtime "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/CSharp/CSharpExecutionStrategy.cs"
click node_python_packages "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonDepsManager.cs"
click node_debugging "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonDebugger.cs"
click node_daemon "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Program.cs"
click node_mcp_engine "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs"
click node_host_discovery "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Processes/DiscoveryHostedService.cs"
click node_code_mode "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Tools/CodeModeTool.cs"
click node_test_runner "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/External/Testing/PytestExecutionService.cs"
click node_test_host "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Testing.Host/TestingRequestHandler.cs"
click node_trace "https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Logging/Targets/FileLogProcessor.cs"
click node_visualization "https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Controllers/VisualizationController.cs"
click node_geometry_storage "https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Visualization/Render/RenderingBufferStorage.cs"

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_revit_addin,node_acad_addin,node_host_adapters toneBlue
class node_script_panel,node_orchestrator,node_python_runtime,node_ironpython_runtime,node_dotnet_runtime,node_python_packages,node_debugging toneAmber
class node_daemon,node_mcp_engine,node_host_discovery,node_code_mode toneMint
class node_test_runner,node_test_host toneRose
class node_trace,node_visualization,node_geometry_storage,node_user,node_revit,node_acad,node_mcp_client toneIndigo
```

## Components

### Host Add-ins

- [Revit Add-in](https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Application.cs): `source/RevitDevTool/Application.cs`
- [AutoCAD Add-in](https://github.com/trgiangv/revitdevtool/blob/develop/source/AcadDevTool/Application.cs): `source/AcadDevTool/Application.cs`
- [Host Bridges](https://github.com/trgiangv/revitdevtool/tree/develop/source/AcadDevTool/Adapters): `source/AcadDevTool/Adapters`

### Code Execution

- [Script Panel](https://github.com/trgiangv/revitdevtool/blob/develop/source/AcadDevTool/Controllers/PanelController.cs): `source/AcadDevTool/Controllers/PanelController.cs`
- [Execution Orchestrator](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Services/ExecutionOrchestrator.cs): `source/DevTools.Execution/Services/ExecutionOrchestrator.cs`
- [Python Runtime](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonInitializer.cs): `source/DevTools.Execution/Providers/Python/PythonInitializer.cs`
- [IronPython Runtime](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/IronPython/IronPythonInitializer.cs): `source/DevTools.Execution/Providers/IronPython/IronPythonInitializer.cs`
- [.NET Runtimes](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/CSharp/CSharpExecutionStrategy.cs): `source/DevTools.Execution/Providers/CSharp/CSharpExecutionStrategy.cs`
- [Python Packages](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonDepsManager.cs): `source/DevTools.Execution/Providers/Python/PythonDepsManager.cs`
- [Debugging](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/Providers/Python/PythonDebugger.cs): `source/DevTools.Execution/Providers/Python/PythonDebugger.cs`

### AI Integration

- [DevTools Daemon](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Program.cs): `source/DevTools.Daemon/Program.cs`
- [MCP Tools](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs): `source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs`
- [Host Discovery](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Processes/DiscoveryHostedService.cs): `source/DevTools.Daemon/Mcp/Processes/DiscoveryHostedService.cs`
- [Code Mode](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Daemon/Mcp/Tools/CodeModeTool.cs): `source/DevTools.Daemon/Mcp/Tools/CodeModeTool.cs`

### In-Host Testing

- [Test Execution](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Execution/External/Testing/PytestExecutionService.cs): `source/DevTools.Execution/External/Testing/PytestExecutionService.cs`
- [Testing Host](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Testing.Host/TestingRequestHandler.cs): `source/DevTools.Testing.Host/TestingRequestHandler.cs`

### Output and Visualization

- [Trace Logs](https://github.com/trgiangv/revitdevtool/blob/develop/source/DevTools.Logging/Targets/FileLogProcessor.cs): `source/DevTools.Logging/Targets/FileLogProcessor.cs`
- [Geometry Preview](https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Controllers/VisualizationController.cs): `source/RevitDevTool/Controllers/VisualizationController.cs`
- [Geometry Buffer](https://github.com/trgiangv/revitdevtool/blob/develop/source/RevitDevTool/Visualization/Render/RenderingBufferStorage.cs): `source/RevitDevTool/Visualization/Render/RenderingBufferStorage.cs`

### Other components

- **Developer**
- **Revit Host**
- **AutoCAD Host**
- **AI Assistant**

## Connections

- Developer → Script Panel: selects and runs (evidence: `README.md`)
- Script Panel → Execution Orchestrator: starts execution
- Execution Orchestrator → Python Runtime: dispatches Python
- Execution Orchestrator → IronPython Runtime: dispatches IronPython
- Execution Orchestrator → .NET Runtimes: dispatches .NET
- Python Runtime → Python Packages: installs dependencies (evidence: `source/DevTools.Execution/Providers/Python/PythonDepsManager.cs`)
- Python Runtime → Debugging: supports debugging (evidence: `source/DevTools.Execution/Providers/Python/PythonInitializer.cs`)
- Execution Orchestrator → Host Bridges: runs in host
- Revit Add-in → Revit Host: loads in (evidence: `README.md`)
- AutoCAD Add-in → AutoCAD Host: loads in (evidence: `source/AcadDevTool/Application.cs`)
- Developer → Revit Add-in: uses add-in (evidence: `README.md`)
- Developer → AutoCAD Add-in: uses add-in (evidence: `README.md`)
- AI Assistant → DevTools Daemon: connects via MCP (evidence: `README.md`)
- DevTools Daemon → MCP Tools: hosts tools (evidence: `source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs`)
- MCP Tools → Host Discovery: discovers hosts
- MCP Tools → Code Mode: registers tool (evidence: `source/DevTools.Daemon/Mcp/Hosting/McpEngine.cs`)
- Code Mode → Host Discovery: accesses host sessions
- Developer → Test Execution: runs tests (evidence: `README.md`)
- Test Execution → Testing Host: runs in host
- Execution Orchestrator → Trace Logs: writes output
- Developer → Trace Logs: reads output (evidence: `README.md`)
- Developer → Geometry Preview: views geometry (evidence: `README.md`)
- Geometry Preview → Geometry Buffer: stores geometry
