How rhaeg4r/ibm works
Cross-Repo Refactor Coordinator detects code patterns across organization repositories, applies matching transformations, validates changes, and coordinates pull requests. Users enter through either the CLI or VS Code extension. The documented workflow proceeds from repository scanning and semantic matching to refactoring and PR coordination; source excerpts additionally show internal calls among detection, workspace, and refactoring services. Several links between interfaces and the engine are documented rather than visible in sampled implementation, so those edges cite the README.
Main entry points: RefactoringEngine.ts Refactoring engine · commands CLI commands · src VS Code extension · PatternDetector.ts Pattern detector
Components 19
User interfaces
- CLI commands
packages/cli/src/commands - VS Code extension
packages/vscode-extension/src
Repository workspace
- Repository cloner
packages/repository/src/clone/RepositoryCloner.ts - Repository cache
packages/repository/src/cache/RepositoryCache.ts - Workspace manager
packages/repository/src/workspace/WorkspaceManager.ts
Pattern detection
- Pattern detector
packages/pattern-detection/src/detector/PatternDetector.ts - Parser base
packages/pattern-detection/src/parsers/BaseParser.ts - TypeScript parser
packages/pattern-detection/src/parsers/TypeScriptParser.ts - Embedding service
packages/pattern-detection/src/embeddings/EmbeddingService.ts
Refactoring and delivery
- Refactoring engine
packages/refactoring/src/engine/RefactoringEngine.ts - Code transformer
packages/refactoring/src/transformer/CodeTransformer.ts - Strategy registry
packages/refactoring/src/strategies/StrategyRegistry.ts - Validation service
packages/refactoring/src/validation/ValidationService.ts - Platform factory
packages/platform/src/factory.ts - GitHub provider
packages/platform/src/providers/github.ts - GitLab provider
packages/platform/src/providers/gitlab.ts
Other components
- Engineer
- Organization repositories
- Git hosting platforms
Connections 28
- Engineer → CLI commands: runs commands
- Engineer → VS Code extension: uses extension
- CLI commands → Repository cloner: scans repositories
- CLI commands → Pattern detector: requests detection
- CLI commands → Refactoring engine: requests refactoring
- CLI commands → Platform factory: proposes PRs
- VS Code extension → Repository cloner: scans repositories
- VS Code extension → Pattern detector: requests detection
- VS Code extension → Refactoring engine: applies refactoring
- VS Code extension → Platform factory: creates PRs
- Organization repositories → Repository cloner: provides repositories
- Repository cloner → Repository cache: checks cache
packages/repository/src/clone/RepositoryCloner.ts - Workspace manager → Repository cache: gets paths
packages/repository/src/workspace/WorkspaceManager.ts - Pattern detector → Parser base: uses parsers
packages/pattern-detection/src/detector/PatternDetector.ts - TypeScript parser → Parser base: extends parser
packages/pattern-detection/src/parsers/TypeScriptParser.ts - Pattern detector → Embedding service: generates embeddings
packages/pattern-detection/src/detector/PatternDetector.ts - Pattern detector → Workspace manager: reads repositories
packages/pattern-detection/src/detector/PatternDetector.ts - Refactoring engine → Code transformer: transforms matches
packages/refactoring/src/engine/RefactoringEngine.ts - Refactoring engine → Validation service: validates changes
packages/refactoring/src/engine/RefactoringEngine.ts - Code transformer → Strategy registry: uses strategies
packages/refactoring/src/transformer/CodeTransformer.ts - Refactoring engine → Workspace manager: uses workspace
packages/refactoring/src/engine/RefactoringEngine.ts - Validation service → Workspace manager: gets repository path
packages/refactoring/src/validation/ValidationService.ts - Platform factory → GitHub provider: creates provider
packages/platform/src/factory.ts - Platform factory → GitLab provider: creates provider
packages/platform/src/factory.ts - GitHub provider → Git hosting platforms: uses API
- GitLab provider → Git hosting platforms: uses API
- Refactoring engine → Organization repositories: updates matches
- Platform factory → Organization repositories: creates coordinated PRs