SAP Hybris to Salesforce Apex Migrator — VS Code Extension

An AI-powered VS Code extension that migrates complete SAP Hybris (Java/Spring) repositories into deployment-ready Salesforce Apex classes, test suites, and SObject metadata — with a single right-click.

Developed by Vikas.

Features

Core Migration Engine

One-Click Migration: Right-click any SAP Hybris folder → "H2A: Migrate to Apex"
Self-Contained Bundle: The entire Python compiler backend is packed inside the extension — no external downloads required
Zero-Configuration Auto-Setup: Automatically provisions a Python virtual environment and installs dependencies on first run
Cross-Platform: Works on Windows, macOS, and Linux

Intelligent Translation

Topological Domain Analysis: Automatically crawls project directories, identifies domain boundaries, and translates in dependency order
fflib Apex Enterprise Patterns: Generates Selectors, Services, and Domain classes following Salesforce best practices
Inter-Domain Signature Propagation: Captures upstream method signatures and injects them into downstream translations
Context-Aware Repair: Automatically detects and fixes Apex violations using LLM-powered repair loops
Spring Sanitization: Removes @Autowired, @Service, package statements; converts logging to System.debug()

Deployment-Ready Output

SFDX Workspace Structure: Generates sfdx-project.json, scratch org configs, and .cls-meta.xml descriptors
SObject Metadata Compiler: Translates items.xml entities and relations into Custom Object and Field metadata
Ready for sf project deploy start: Output can be deployed directly to a Salesforce org

Resilience & Performance

Multi-Model Fallback: Automatically rotates through 5 LLM models on rate-limit or server errors
Incremental Delta Tracking: Skips unchanged source files using MD5 checksum-based state tracking
File-Based Caching: Caches LLM responses to avoid redundant API calls

Interactive Dashboard

Glassmorphic Status Panel: Premium dark-themed WebView with gradient cards
Real-Time Metrics: Domains tracked, success rate, LLM API calls, tokens spent
Interactive Call Graph: Force-directed physics canvas showing class-to-method data flow paths
Dual View Toggle: Switch between SAP Hybris Call Flow and Salesforce fflib Flow naming
Topological Stepper: Visual step-by-step domain compilation progress tracker
Colorized Console Output: Terminal-style log viewer with syntax highlighting

Usage

Right-click on any legacy SAP Hybris folder in the VS Code explorer sidebar.
Select "H2A: Migrate to Apex".
If this is the first execution, wait while the extension sets up the Python environment.
View the migration results in the H2A Converter Dashboard WebView panel.
Find your deployment-ready Salesforce DX files in the new salesforce_<FolderName>/ directory.

Extension Settings

Setting	Type	Default	Description
`h2aMigrator.pipelinePath`	string	`""`	Absolute path to a custom h2a-mvp directory
`h2aMigrator.pythonPath`	string	`""`	Absolute path to a custom Python executable
`h2aMigrator.openrouterApiKey`	string	`""`	Your custom OpenRouter API key
`h2aMigrator.incrementalMode`	boolean	`true`	Enable delta (incremental) migrations
`h2aMigrator.customModel`	string	`""`	Override the default LLM model name

Output Structure

salesforce_<project>/
├── sfdx-project.json
├── config/project-scratch-def.json
├── force-app/main/default/
│   ├── classes/
│   │   ├── <ClassName>.cls
│   │   ├── <ClassName>.cls-meta.xml
│   │   ├── <ClassName>Test.cls
│   │   └── <ClassName>Test.cls-meta.xml
│   └── objects/
│       └── <ObjectName>__c/
│           ├── <ObjectName>__c.object-meta.xml
│           └── fields/<field>__c.field-meta.xml
├── .call_graph.json
├── MAPPING.md
└── FEASIBILITY_REPORT.md

Version History

Version	Key Changes
0.3.0	Method call graph extraction, fflib patterns, interactive canvas visualizer
0.2.1	Bugfix for SFDX output writer
0.2.0	Model fallback rotation, SFDX restructuring, glassmorphic dashboard
0.1.9	Delta tracking, context-aware repair, Spring sanitization
0.1.8	Model and API key configuration updates
0.1.5	Cross-platform Python environment auto-setup
0.1.3	Multi-domain topological translation, SObject metadata compiler
0.1.0	Initial release

Technical Documentation

For a comprehensive technical design document covering all functionalities, architecture, and workflows, see TDD.md.

SAP Hybris to Salesforce Apex Migrator

imavikaas