fix(toolchain): support build-from-source tier-3 toolchains (#2572)

* fix(toolchain): support build-from-source tier-3 toolchains

Two gaps blocked build-from-source toolchains (e.g. ruby_tool, which compiles
via ruby-build) from installing:

1. supports_tier_3() only recognized download_prebuilt/native_install, so moon
   never scheduled a SetupToolchain action for source-only tools. Add
   build_instructions to the check (proto's build-from-source install path).
2. setup_toolchain() called proto's Manager::install with a default
   InstallOptions, so strategy defaulted to prebuilt and errored
   (prebuilt_unsupported). Pass the tool's declared default_install_strategy.

* bump starbase_console for new `with_reporter` api

Author: lamalex

Cargo.lock

@@ -70,10 +70,10 @@ starbase_archive = { version = "0.13.2", default-features = false, features = [
   "zip-all",
 ] }
 starbase_args = { version = "0.1.11" }
-starbase_console = { version = "0.6.29", features = ["miette"] }
+starbase_console = { version = "0.6.31", features = ["miette"] }
 starbase_id = { version = "0.3.3", features = ["miette", "schematic"] }
 starbase_sandbox = "0.11.1"
-starbase_shell = "0.12.5"
+starbase_shell = "0.12.6"
 starbase_styles = { version = "0.6.1", features = ["relative-path"] }
 starbase_utils = { version = "0.13.8", default-features = false, features = [
   "editor-config",

Cargo.toml

@@ -9,6 +9,7 @@ use moon_env_var::GlobalEnvBag;
 use moon_hash::fingerprint;
 use moon_pdk_api::SetupToolchainInput;
 use moon_toolchain::is_using_global_toolchain;
+use proto_core::reporter::{ProtoReporter, ReporterFormat};
 use std::sync::Arc;
 use tracing::{debug, instrument};
 
@@ -90,6 +91,9 @@ pub async fn setup_toolchain(
     );
 
     let setup_op = Operation::setup_operation(action.get_prefix())?;
+    let proto_console = app_context
+        .console
+        .with_reporter(ProtoReporter::new(ReporterFormat::Text));
     let output = toolchain
         .setup_toolchain(
             SetupToolchainInput {
@@ -98,6 +102,7 @@ pub async fn setup_toolchain(
                 toolchain_config: app_context.toolchain_registry.create_config(&toolchain.id),
                 version: None,
             },
+            Some(proto_console),
             || {
                 app_context.console.print_checkpoint(
                     Checkpoint::Setup,

crates/actions/src/actions/setup_toolchain.rs

@@ -26,6 +26,7 @@ futures = { workspace = true }
 indexmap = { workspace = true }
 miette = { workspace = true }
 proto_core = { workspace = true }
+proto_pdk_api = { workspace = true }
 rustc-hash = { workspace = true }
 scc = { workspace = true }
 starbase_utils = { workspace = true, features = ["glob", "json"] }

crates/toolchain-plugin/Cargo.toml

@@ -9,10 +9,13 @@ use proto_core::flow::install::InstallOptions;
 use proto_core::flow::locate::Locator;
 use proto_core::flow::manage::Manager;
 use proto_core::flow::resolve::Resolver;
+use proto_core::reporter::ProtoConsole;
+use proto_core::utils::log::LogWriter;
 use proto_core::{
     PluginLocator, PluginType as ProtoPluginType, Tool, ToolContext, ToolSpec,
     UnresolvedVersionSpec, locate_plugin,
 };
+use proto_pdk_api::InstallStrategy;
 use scc::hash_map::Entry;
 use starbase_utils::glob::{self, GlobSet};
 use std::fmt;
@@ -150,7 +153,8 @@ impl ToolchainPlugin {
         self.has_func("setup_toolchain").await
             || self.tool.is_some()
                 && (self.has_func("download_prebuilt").await
-                    || self.has_func("native_install").await)
+                    || self.has_func("native_install").await
+                    || self.has_func("build_instructions").await)
     }
 
     #[instrument(skip(self))]
@@ -511,6 +515,7 @@ impl ToolchainPlugin {
     pub async fn setup_toolchain(
         &self,
         mut input: SetupToolchainInput,
+        console: Option<ProtoConsole>,
         on_setup: impl FnOnce() -> miette::Result<()>,
     ) -> miette::Result<SetupToolchainOutput> {
         let mut output = SetupToolchainOutput::default();
@@ -529,6 +534,16 @@ impl ToolchainPlugin {
                 if !tool.is_installed(&spec) {
                     on_setup()?;
 
+                    // Honor the tool's declared install strategy (e.g. Ruby
+                    // builds from source); otherwise proto defaults to a
+                    // prebuilt download and errors for source-only tools.
+                    let strategy = tool.metadata.default_install_strategy;
+
+                    // Only the build-from-source path routes through proto's
+                    // Builder, which requires a console + log writer. Prebuilt
+                    // installs don't, so leave them `None` to avoid the
+                    // allocation and any change to prebuilt logging behavior.
+                    let building = matches!(strategy, InstallStrategy::BuildFromSource);
                     let mut manager = Manager::new(&mut tool);
 
                     output.installed = manager
@@ -537,6 +552,9 @@ impl ToolchainPlugin {
                             InstallOptions {
                                 skip_prompts: true,
                                 skip_ui: true,
+                                strategy,
+                                console: building.then_some(console).flatten(),
+                                log_writer: building.then(LogWriter::default),
                                 ..Default::default()
                             },
                         )

crates/toolchain-plugin/src/toolchain_plugin.rs

@@ -377,7 +377,7 @@ impl ToolchainRegistry {
             "setup_toolchain",
             self.get_plugin_ids(),
             input_factory,
-            |toolchain, input| async move { toolchain.setup_toolchain(input, || Ok(())).await },
+            |toolchain, input| async move { toolchain.setup_toolchain(input, None, || Ok(())).await },
             true,
         )
         .await