# erkamyaman/rust-anything architecture

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

## Overview

rust-anything helps engineers migrate applications incrementally to Rust while preserving behavior: profile and inspect the original, scaffold a Rust bridge for a selected unit, record and replay cases, compare results, benchmark, and gate completion. Separate capabilities cover whole-app CLI replay, HTTP/library migration, agent setup, and MCP access. The README documents the workflow; source excerpts and the index expose selected analysis, bridge, language-plugin, and harness relationships, but not every runtime call.

Main entry points: [`src/main.rs`](https://github.com/erkamyaman/rust-anything/blob/main/src/main.rs) (CLI), [`src/lang`](https://github.com/erkamyaman/rust-anything/tree/main/src/lang) (Language plugins), [`src/bridge.rs`](https://github.com/erkamyaman/rust-anything/blob/main/src/bridge.rs) (Unit bridge), [`src/analyze.rs`](https://github.com/erkamyaman/rust-anything/blob/main/src/analyze.rs) (Migration analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Migration workflow"]
  node_cli["CLI<br/>[main.rs]"]
  node_profiler["Profiler<br/>[profile.rs]"]
  node_unit_bridge["Unit bridge<br/>[bridge.rs]"]
  node_codegen["Binding generators<br/>[codegen.rs]"]
  node_wire["Binary wire<br/>[wire.rs]"]
end

subgraph group_analysis["Source analysis"]
  node_language_plugins["Language plugins"]
  node_ts_discovery["TS discovery<br/>[discover.rs]"]
  node_ts_exports["Export analysis<br/>[exports.rs]"]
  node_ts_scan["Risk scanning<br/>[scan.rs]"]
  node_risk_catalog["Migration risks<br/>[risks.rs]"]
  node_analysis_engine["Migration analysis<br/>[analyze.rs]"]
end

subgraph group_verification["Behavior verification"]
  node_recorder["Case recording<br/>[recording.rs]"]
  node_harness["Replay harness<br/>[harness.rs]"]
  node_gate["Completion gate<br/>[gate.rs]"]
  node_benchmark["Benchmarking<br/>[harness.rs]"]
  node_app_replay["App replay<br/>[app.rs]"]
end

subgraph group_integration["Agent and app integrations"]
  node_agent_setup["Agent setup<br/>[setup.rs]"]
  node_mcp_server["MCP server<br/>[mcp.rs]"]
  node_front_door["HTTP and libraries<br/>[front_door.rs]"]
end

node_engineer(("Engineer"))

node_engineer -->|"runs commands"| node_cli
node_cli -->|"profiles code"| node_profiler
node_profiler -->|"uses analysis"| node_analysis_engine
node_analysis_engine -->|"analyzes languages"| node_language_plugins
node_language_plugins -->|"discovers projects"| node_ts_discovery
node_language_plugins -->|"reads exports"| node_ts_exports
node_language_plugins -->|"scans risks"| node_ts_scan
node_ts_scan -->|"reports risks"| node_risk_catalog
node_cli -->|"scaffolds unit"| node_unit_bridge
node_unit_bridge -->|"analyzes source"| node_analysis_engine
node_unit_bridge -->|"selects language"| node_language_plugins
node_unit_bridge -->|"generates bindings"| node_codegen
node_codegen -->|"uses binary wire"| node_wire
node_cli -->|"records cases"| node_recorder
node_cli -->|"replays cases"| node_harness
node_harness -->|"reads recordings"| node_recorder
node_cli -->|"checks completion"| node_gate
node_cli -->|"benchmarks port"| node_benchmark
node_cli -->|"records app"| node_app_replay
node_cli -->|"configures agents"| node_agent_setup
node_engineer -->|"connects agent"| node_mcp_server
node_engineer -->|"migrates app"| node_front_door

click node_cli "https://github.com/erkamyaman/rust-anything/blob/main/src/main.rs"
click node_profiler "https://github.com/erkamyaman/rust-anything/blob/main/src/profile.rs"
click node_unit_bridge "https://github.com/erkamyaman/rust-anything/blob/main/src/bridge.rs"
click node_codegen "https://github.com/erkamyaman/rust-anything/blob/main/src/codegen.rs"
click node_wire "https://github.com/erkamyaman/rust-anything/blob/main/src/wire.rs"
click node_language_plugins "https://github.com/erkamyaman/rust-anything/tree/main/src/lang"
click node_ts_discovery "https://github.com/erkamyaman/rust-anything/blob/main/src/ts/discover.rs"
click node_ts_exports "https://github.com/erkamyaman/rust-anything/blob/main/src/ts/exports.rs"
click node_ts_scan "https://github.com/erkamyaman/rust-anything/blob/main/src/ts/scan.rs"
click node_risk_catalog "https://github.com/erkamyaman/rust-anything/blob/main/src/risks.rs"
click node_analysis_engine "https://github.com/erkamyaman/rust-anything/blob/main/src/analyze.rs"
click node_recorder "https://github.com/erkamyaman/rust-anything/blob/main/src/recording.rs"
click node_harness "https://github.com/erkamyaman/rust-anything/blob/main/src/harness.rs"
click node_gate "https://github.com/erkamyaman/rust-anything/blob/main/src/gate.rs"
click node_benchmark "https://github.com/erkamyaman/rust-anything/blob/main/src/harness.rs"
click node_app_replay "https://github.com/erkamyaman/rust-anything/blob/main/src/app.rs"
click node_agent_setup "https://github.com/erkamyaman/rust-anything/blob/main/src/setup.rs"
click node_mcp_server "https://github.com/erkamyaman/rust-anything/blob/main/src/mcp.rs"
click node_front_door "https://github.com/erkamyaman/rust-anything/blob/main/src/front_door.rs"

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_cli,node_profiler,node_unit_bridge,node_codegen,node_wire toneBlue
class node_language_plugins,node_ts_discovery,node_ts_exports,node_ts_scan,node_risk_catalog,node_analysis_engine toneAmber
class node_recorder,node_harness,node_gate,node_benchmark,node_app_replay toneMint
class node_agent_setup,node_mcp_server,node_front_door toneRose
class node_engineer toneIndigo
```

## Components

### Migration workflow

- [CLI](https://github.com/erkamyaman/rust-anything/blob/main/src/main.rs): `src/main.rs`
- [Profiler](https://github.com/erkamyaman/rust-anything/blob/main/src/profile.rs): `src/profile.rs`
- [Unit bridge](https://github.com/erkamyaman/rust-anything/blob/main/src/bridge.rs): `src/bridge.rs`
- [Binding generators](https://github.com/erkamyaman/rust-anything/blob/main/src/codegen.rs): `src/codegen.rs`
- [Binary wire](https://github.com/erkamyaman/rust-anything/blob/main/src/wire.rs): `src/wire.rs`

### Source analysis

- [Language plugins](https://github.com/erkamyaman/rust-anything/tree/main/src/lang): `src/lang`
- [TS discovery](https://github.com/erkamyaman/rust-anything/blob/main/src/ts/discover.rs): `src/ts/discover.rs`
- [Export analysis](https://github.com/erkamyaman/rust-anything/blob/main/src/ts/exports.rs): `src/ts/exports.rs`
- [Risk scanning](https://github.com/erkamyaman/rust-anything/blob/main/src/ts/scan.rs): `src/ts/scan.rs`
- [Migration risks](https://github.com/erkamyaman/rust-anything/blob/main/src/risks.rs): `src/risks.rs`
- [Migration analysis](https://github.com/erkamyaman/rust-anything/blob/main/src/analyze.rs): `src/analyze.rs`

### Behavior verification

- [Case recording](https://github.com/erkamyaman/rust-anything/blob/main/src/recording.rs): `src/recording.rs`
- [Replay harness](https://github.com/erkamyaman/rust-anything/blob/main/src/harness.rs): `src/harness.rs`
- [Completion gate](https://github.com/erkamyaman/rust-anything/blob/main/src/gate.rs): `src/gate.rs`
- [Benchmarking](https://github.com/erkamyaman/rust-anything/blob/main/src/harness.rs): `src/harness.rs`
- [App replay](https://github.com/erkamyaman/rust-anything/blob/main/src/app.rs): `src/app.rs`

### Agent and app integrations

- [Agent setup](https://github.com/erkamyaman/rust-anything/blob/main/src/setup.rs): `src/setup.rs`
- [MCP server](https://github.com/erkamyaman/rust-anything/blob/main/src/mcp.rs): `src/mcp.rs`
- [HTTP and libraries](https://github.com/erkamyaman/rust-anything/blob/main/src/front_door.rs): `src/front_door.rs`

### Other components

- **Engineer**

## Connections

- Engineer → CLI: runs commands
- CLI → Profiler: profiles code
- Profiler → Migration analysis: uses analysis (evidence: `src/profile.rs`)
- Migration analysis → Language plugins: analyzes languages (evidence: `src/lib.rs`)
- Language plugins → TS discovery: discovers projects (evidence: `src/lang/mod.rs`)
- Language plugins → Export analysis: reads exports (evidence: `src/lang/mod.rs`)
- Language plugins → Risk scanning: scans risks (evidence: `src/lang/mod.rs`)
- Risk scanning → Migration risks: reports risks (evidence: `src/ts/scan.rs`)
- CLI → Unit bridge: scaffolds unit
- Unit bridge → Migration analysis: analyzes source (evidence: `src/bridge.rs`)
- Unit bridge → Language plugins: selects language (evidence: `src/bridge.rs`)
- Unit bridge → Binding generators: generates bindings (evidence: `src/bridge.rs`)
- Binding generators → Binary wire: uses binary wire
- CLI → Case recording: records cases
- CLI → Replay harness: replays cases
- Replay harness → Case recording: reads recordings (evidence: `src/harness.rs`)
- CLI → Completion gate: checks completion
- CLI → Benchmarking: benchmarks port
- CLI → App replay: records app
- CLI → Agent setup: configures agents
- Engineer → MCP server: connects agent
- Engineer → HTTP and libraries: migrates app
