Add global rb.toml file support and gem.toml/rbproject.toml run scripts support. (#1)

* Add global rb.toml file support.

* Add rbproject.toml basic support.

* Add 'rb run' command for project script execution

Introduces the 'rb run' (and alias 'rb r') command to execute project scripts defined in rbproject.toml, with support for listing available scripts, script descriptions, and error handling. Updates documentation and integration tests to cover new functionality, and refactors CLI command registration and environment presentation for project script management.

* Update Project.Integration.Tests.ps1

* Add rb init command, add more shell tests.

* Add changelog entry.

* Delegate run to exec command.

This way it can share more advanced flows like automatically resolving bundle...

* Add gem.toml support.

Author: simi

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- Configuration file support via `rb.toml` for global settings
+- Project script management with `rbproject.toml` and `rb run` command
+- Project bootstrap script with `rb init`
+
 ## [0.1.0] - 2025-09-26
 
 ### Added
@@ -24,4 +29,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-*Distinguished releases crafted with appropriate ceremony by RubyElders.com*
+*Distinguished releases crafted with appropriate ceremony by RubyElders.com*

Cargo.lock

@@ -3,7 +3,7 @@ resolver = "2"
 members = ["crates/*"]
 
 [workspace.package]
-version = "0.1.0"
+version = "0.2.0"
 edition = "2024"
 authors = ["RubyElders.com"]
 description = "A sophisticated Ruby environment manager that orchestrates installations and gem collections with distinguished precision"

Cargo.toml

@@ -89,6 +89,12 @@ Ruby Butler expects Ruby installations in `~/.rubies/` (the standard location fo
 - `rb exec` / `rb x` - Execute commands within meticulously prepared environments
 - `rb environment` / `rb env` - Display current environment composition
 - `rb sync` - Manually synchronize bundler environments (auto-triggered when needed)
+- `rb run` / `rb r` - Execute project scripts defined in `gem.toml` or `rbproject.toml`
+
+## Configuration
+
+- **`rb.toml`** - Global configuration file (in `%APPDATA%/rb/` or `~/.rb.toml`)
+- **`gem.toml`** or **`rbproject.toml`** - Project-level script definitions and metadata
 
 ## Development
 

README.md

@@ -27,6 +27,8 @@ log = "0.4"
 env_logger = "0.11"
 semver = "1.0.26"
 which = "6.0"
+toml = "0.8"
+serde = { version = "1.0", features = ["derive"] }
 
 [dev-dependencies]
 rb-tests = { path = "../rb-tests" }

crates/rb-cli/Cargo.toml

@@ -1,7 +1,7 @@
 use clap::Parser;
 use rb_cli::{
-    Cli, Commands, environment_command, exec_command, init_logger, resolve_search_dir,
-    runtime_command, sync_command,
+    Cli, Commands, environment_command, exec_command, init_command, init_logger,
+    resolve_search_dir, run_command, runtime_command, sync_command,
 };
 use rb_core::butler::{ButlerError, ButlerRuntime};
 
@@ -53,15 +53,35 @@ fn main() {
 
     let cli = Cli::parse();
 
-    // Initialize logger with the effective log level (considering -v/-vv flags)
+    // Initialize logger early with the effective log level (considering -v/-vv flags)
+    // This allows us to see config file loading and merging logs
     init_logger(cli.effective_log_level());
 
+    // Merge config file defaults with CLI arguments
+    let cli = match cli.with_config_defaults() {
+        Ok(cli) => cli,
+        Err(e) => {
+            eprintln!("Configuration error: {}", e);
+            std::process::exit(1);
+        }
+    };
+
+    // Handle init command early - doesn't require Ruby environment
+    if let Commands::Init = cli.command {
+        let current_dir = std::env::current_dir().unwrap_or_else(|_| std::path::PathBuf::from("."));
+        if let Err(e) = init_command(&current_dir) {
+            eprintln!("{}", e);
+            std::process::exit(1);
+        }
+        return;
+    }
+
     // Handle sync command differently since it doesn't use ButlerRuntime in the same way
     if let Commands::Sync = cli.command {
         if let Err(e) = sync_command(
-            cli.rubies_dir.clone(),
-            cli.ruby_version.clone(),
-            cli.gem_home.clone(),
+            cli.config.rubies_dir.clone(),
+            cli.config.ruby_version.clone(),
+            cli.config.gem_home.clone(),
         ) {
             eprintln!("Sync failed: {}", e);
             std::process::exit(1);
@@ -70,13 +90,13 @@ fn main() {
     }
 
     // Resolve search directory for Ruby installations
-    let rubies_dir = resolve_search_dir(cli.rubies_dir);
+    let rubies_dir = resolve_search_dir(cli.config.rubies_dir);
 
     // Perform comprehensive environment discovery once
     let butler_runtime = match ButlerRuntime::discover_and_compose_with_gem_base(
         rubies_dir,
-        cli.ruby_version,
-        cli.gem_home,
+        cli.config.ruby_version,
+        cli.config.gem_home,
     ) {
         Ok(runtime) => runtime,
         Err(e) => match e {
@@ -109,11 +129,18 @@ fn main() {
             runtime_command(&butler_runtime);
         }
         Commands::Environment => {
-            environment_command(&butler_runtime);
+            environment_command(&butler_runtime, cli.project_file);
         }
         Commands::Exec { args } => {
             exec_command(butler_runtime, args);
         }
+        Commands::Run { script, args } => {
+            run_command(butler_runtime, script, args, cli.project_file);
+        }
+        Commands::Init => {
+            // Already handled above
+            unreachable!()
+        }
         Commands::Sync => {
             // Already handled above
             unreachable!()