Rukuzu: Portierung einer 200.000 Zeilen umfassenden C++-Graphdatenbank zu Rust mit systematischem Testen

Portierungsstrategie für große C++-Codebasen zu Rust

Das Rukuzu-Projekt behandelt eine häufige Herausforderung in der Systemsoftware: die Portierung einer ausgereiften 200.000-Zeilen-C++-Codebasis (kuzu, eine eingebettete Graphdatenbank) zu einer reinen Rust-Implementierung. Die Motivation war nicht, dass der C++-Code problematisch war, sondern vielmehr Umgebungsbeschränkungen: mobile Geräte, Edge-Bereitstellungen, bei denen C++-Toolchains nicht verfügbar sind, FFI-Grenzen Debugging-Schwierigkeiten verursachen und wo eine einzelne statisch verlinkte Binärdatei wertvoll ist.

Systematischer Portierungs-Workflow

Das Team entwickelte einen Workflow, der als Claude Code Custom Command kodiert ist und ermöglicht:

• Die C++-Version funktionsfähig zu halten, während die Rust-Version aufgebaut wird
• Beide Implementierungen gegeneinander zu testen
• Bei jedem Schritt zu überprüfen, dass die Rust-Portierung identische Ergebnisse wie das ursprüngliche C++ liefert

Implementierungsdetails

Der Workflow entstand aus praktischer Erfahrung mit:

• 15 portierten Crates
• Über 2.700 Tests
• Erkenntnissen darüber, was sich mechanisch übersetzen lässt versus was menschliches Urteilsvermögen erfordert

Das DEALER-Projekt (ein Fuzzy-OWLv2-EL++-Description-Logic-Reasoner) nutzt beide Backends über eine pluggable Architektur und bietet so eine produktionsreife Testumgebung für Korrektheits- und Leistungsvergleiche.