Repository navigation
Monorepo Workspaces and DAG Builds
Hakan Batuhan Kaba edited this page Nov 13, 2026
·
1 revision
Modern Ruby ecosystems (such as modular SDKs, plugin suites, and Rails Engine monorepos) frequently maintain multiple .gemspec packages in a single repository (gems/*, packages/*, plugins/*, apps/*).
Inspired by Turborepo, Nx, and Angular Workspaces, RubyToFaster::Workspace (rtf workspace) executes topological dependency graph builds across multi-gem repositories.
-
Discovery: Scans workspace globs (default:
gems/*,packages/*,plugins/*,apps/*) for directories containinggem.build.rbor*.gemspec. -
Graph Construction: Inspects each
Gem::Specification#dependencieslist to map internal edges between sibling workspace gems. -
Cycle Detection: Runs Kahn's algorithm—if
gem_adepends ongem_bandgem_bdepends ongem_a, aborts immediately with a descriptiveRubyToFaster::ConfigError. -
Parallel Wave Compilation: Groups gems with zero unmet dependencies into waves and builds every gem inside a wave concurrently across CPU threads, sharing
.rtf-cacheMerkle hits per package.
# Discover and build all workspace gems in topological waves
rtf workspace
# Specify custom directory globs
rtf workspace --patterns "core/*,integrations/*"
# Force cold rebuild across all workspace gems and output JSON telemetry
rtf workspace --no-cache --jsonrequire "rubytofaster"
ws = RubyToFaster.workspace(
root_dir: __dir__,
patterns: ["packages/*"],
parallel_jobs: 8,
incremental: true
)
puts "Built #{ws.results.size} gems across #{ws.waves.size} waves in #{ws.total_ms}ms (#{ws.cache_hits} cache hits)"RubyToFaster — Minimalist script-first Ruby gem build system by HNM Labs · MIT License · Security Policy