docs/ci: selfhost bootstrap/exe-first workflows; add ny-llvmc scaffolding + JSON v0 schema validation; plan: unify to Nyash ABI v2 (no backwards compat)

src/runner/modes/common.rs

@@ -11,8 +11,6 @@ use std::thread::sleep;
 use crate::runner::pipeline::{suggest_in_base, resolve_using_target};
 use crate::runner::trace::cli_verbose;
 use crate::cli_v;
-use crate::runner::trace::cli_verbose;
-use crate::cli_v;
 
 // (moved) suggest_in_base is now in runner/pipeline.rs
 
@@ -131,97 +129,13 @@ impl NyashRunner {
 
     /// Helper: run PyVM harness over a MIR module, returning the exit code
     fn run_pyvm_harness(&self, module: &nyash_rust::mir::MirModule, tag: &str) -> Result<i32, String> {
-        let py3 = which::which("python3").map_err(|e| format!("python3 not found: {}", e))?;
-        let runner = std::path::Path::new("tools/pyvm_runner.py");
-        if !runner.exists() { return Err(format!("PyVM runner not found: {}", runner.display())); }
-        let tmp_dir = std::path::Path::new("tmp");
-        let _ = std::fs::create_dir_all(tmp_dir);
-        let mir_json_path = tmp_dir.join("nyash_pyvm_mir.json");
-        crate::runner::mir_json_emit::emit_mir_json_for_harness_bin(module, &mir_json_path)
-            .map_err(|e| format!("PyVM MIR JSON emit error: {}", e))?;
-        cli_v!("[ny-compiler] using PyVM ({} ) → {}", tag, mir_json_path.display());
-        // Determine entry function hint (prefer Main.main if present)
-        let entry = if module.functions.contains_key("Main.main") { "Main.main" }
-                    else if module.functions.contains_key("main") { "main" } else { "Main.main" };
-        let status = std::process::Command::new(py3)
-            .args([
-                runner.to_string_lossy().as_ref(),
-                "--in",
-                &mir_json_path.display().to_string(),
-                "--entry",
-                entry,
-            ])
-            .status()
-            .map_err(|e| format!("spawn pyvm: {}", e))?;
-        let code = status.code().unwrap_or(1);
-        if !status.success() { cli_v!("❌ PyVM ({}) failed (status={})", tag, code); }
-        Ok(code)
+        super::common_util::pyvm::run_pyvm_harness(module, tag)
     }
 
     /// Helper: try external selfhost compiler EXE to parse Ny -> JSON v0 and return MIR module
     /// Returns Some(module) on success, None on failure (timeout/invalid output/missing exe)
     fn exe_try_parse_json_v0(&self, filename: &str, timeout_ms: u64) -> Option<nyash_rust::mir::MirModule> {
-        // Resolve parser EXE path
-        let exe_path = if let Ok(p) = std::env::var("NYASH_NY_COMPILER_EXE_PATH") {
-            std::path::PathBuf::from(p)
-        } else {
-            let mut p = std::path::PathBuf::from("dist/nyash_compiler");
-            #[cfg(windows)]
-            { p.push("nyash_compiler.exe"); }
-            #[cfg(not(windows))]
-            { p.push("nyash_compiler"); }
-            if !p.exists() {
-                if let Ok(w) = which::which("nyash_compiler") { w } else { p }
-            } else { p }
-        };
-        if !exe_path.exists() { cli_v!("[ny-compiler] exe not found at {}", exe_path.display()); return None; }
-
-        // Build command
-        let mut cmd = std::process::Command::new(&exe_path);
-        cmd.arg(filename);
-        if crate::config::env::ny_compiler_min_json() { cmd.arg("--min-json"); }
-        if crate::config::env::selfhost_read_tmp() { cmd.arg("--read-tmp"); }
-        if let Some(raw) = crate::config::env::ny_compiler_child_args() { for tok in raw.split_whitespace() { cmd.arg(tok); } }
-        let mut cmd = cmd.stdout(Stdio::piped()).stderr(Stdio::piped());
-        let mut child = match cmd.spawn() { Ok(c) => c, Err(e) => { eprintln!("[ny-compiler] exe spawn failed: {}", e); return None; } };
-        let mut ch_stdout = child.stdout.take();
-        let mut ch_stderr = child.stderr.take();
-        let start = Instant::now();
-        let mut timed_out = false;
-        loop {
-            match child.try_wait() {
-                Ok(Some(_)) => break,
-                Ok(None) => {
-                    if start.elapsed() >= Duration::from_millis(timeout_ms) { let _ = child.kill(); let _ = child.wait(); timed_out = true; break; }
-                    sleep(Duration::from_millis(10));
-                }
-                Err(e) => { eprintln!("[ny-compiler] exe wait error: {}", e); return None; }
-            }
-        }
-        let mut out_buf = Vec::new();
-        let mut err_buf = Vec::new();
-        if let Some(mut s) = ch_stdout { let _ = s.read_to_end(&mut out_buf); }
-        if let Some(mut s) = ch_stderr { let _ = s.read_to_end(&mut err_buf); }
-        if timed_out {
-            let head = String::from_utf8_lossy(&out_buf).chars().take(200).collect::<String>();
-            eprintln!("[ny-compiler] exe timeout after {} ms; stdout(head)='{}'", timeout_ms, head.replace('\n', "\\n"));
-            return None;
-        }
-        let stdout = match String::from_utf8(out_buf) { Ok(s) => s, Err(_) => String::new() };
-        let mut json_line = String::new();
-        for line in stdout.lines() { let t = line.trim(); if t.starts_with('{') && t.contains("\"version\"") && t.contains("\"kind\"") { json_line = t.to_string(); break; } }
-        if json_line.is_empty() {
-            if cli_verbose() {
-                let head: String = stdout.chars().take(200).collect();
-                let errh: String = String::from_utf8_lossy(&err_buf).chars().take(200).collect();
-                cli_v!("[ny-compiler] exe produced no JSON; stdout(head)='{}' stderr(head)='{}'", head.replace('\n', "\\n"), errh.replace('\n', "\\n"));
-            }
-            return None;
-        }
-        match json_v0_bridge::parse_json_v0_to_module(&json_line) {
-            Ok(module) => Some(module),
-            Err(e) => { eprintln!("[ny-compiler] JSON parse failed (exe): {}", e); None }
-        }
+        super::common_util::selfhost_exe::exe_try_parse_json_v0(filename, timeout_ms)
     }
 
     /// Phase-15.3: Attempt Ny compiler pipeline (Ny -> JSON v0 via Ny program), then execute MIR
@@ -324,38 +238,22 @@ impl NyashRunner {
                 if crate::config::env::selfhost_read_tmp() { cmd.arg("--read-tmp"); }
                 if let Some(raw) = crate::config::env::ny_compiler_child_args() { for tok in raw.split_whitespace() { cmd.arg(tok); } }
                 let timeout_ms: u64 = crate::config::env::ny_compiler_timeout_ms();
-                let mut cmd = cmd.stdout(Stdio::piped()).stderr(Stdio::piped());
-                let mut child = match cmd.spawn() { Ok(c) => c, Err(e) => { eprintln!("[ny-compiler] exe spawn failed: {}", e); return false; } };
-                let mut ch_stdout = child.stdout.take();
-                let mut ch_stderr = child.stderr.take();
-                let start = Instant::now();
-                let mut timed_out = false;
-                loop {
-                    match child.try_wait() {
-                        Ok(Some(_status)) => { break; }
-                        Ok(None) => {
-                            if start.elapsed() >= Duration::from_millis(timeout_ms) { let _ = child.kill(); let _ = child.wait(); timed_out = true; break; }
-                            sleep(Duration::from_millis(10));
-                        }
-                        Err(e) => { eprintln!("[ny-compiler] exe wait error: {}", e); return false; }
-                    }
-                }
-                let mut out_buf = Vec::new();
-                let mut err_buf = Vec::new();
-                if let Some(mut s) = ch_stdout { let _ = s.read_to_end(&mut out_buf); }
-                if let Some(mut s) = ch_stderr { let _ = s.read_to_end(&mut err_buf); }
-                if timed_out {
-                    let head = String::from_utf8_lossy(&out_buf).chars().take(200).collect::<String>();
+                let out = match super::common_util::io::spawn_with_timeout(cmd, timeout_ms) {
+                    Ok(o) => o,
+                    Err(e) => { eprintln!("[ny-compiler] exe spawn failed: {}", e); return false; }
+                };
+                if out.timed_out {
+                    let head = String::from_utf8_lossy(&out.stdout).chars().take(200).collect::<String>();
                     eprintln!("[ny-compiler] exe timeout after {} ms; stdout(head)='{}'", timeout_ms, head.replace('\n', "\\n"));
                     return false;
                 }
-                let stdout = match String::from_utf8(out_buf) { Ok(s) => s, Err(_) => String::new() };
+                let stdout = match String::from_utf8(out.stdout) { Ok(s) => s, Err(_) => String::new() };
                 let mut json_line = String::new();
                 for line in stdout.lines() { let t = line.trim(); if t.starts_with('{') && t.contains("\"version\"") && t.contains("\"kind\"") { json_line = t.to_string(); break; } }
                 if json_line.is_empty() {
                     if crate::config::env::cli_verbose() {
                         let head: String = stdout.chars().take(200).collect();
-                        let errh: String = String::from_utf8_lossy(&err_buf).chars().take(200).collect();
+                        let errh: String = String::from_utf8_lossy(&out.stderr).chars().take(200).collect();
                         eprintln!("[ny-compiler] exe produced no JSON; stdout(head)='{}' stderr(head)='{}'", head.replace('\n', "\\n"), errh.replace('\n', "\\n"));
                     }
                     return false;
@@ -450,40 +348,15 @@ impl NyashRunner {
             .ok()
             .and_then(|s| s.parse::<u64>().ok())
             .unwrap_or(2000);
-        let mut cmd = cmd.stdout(Stdio::piped()).stderr(Stdio::piped());
-        let mut child = match cmd.spawn() {
-            Ok(c) => c,
+        let out = match super::common_util::io::spawn_with_timeout(cmd, timeout_ms) {
+            Ok(o) => o,
             Err(e) => { eprintln!("[ny-compiler] spawn failed: {}", e); return false; }
         };
-        let mut ch_stdout = child.stdout.take();
-        let mut ch_stderr = child.stderr.take();
-        let start = Instant::now();
-        let mut timed_out = false;
-        loop {
-            match child.try_wait() {
-                Ok(Some(_status)) => { break; }
-                Ok(None) => {
-                    if start.elapsed() >= Duration::from_millis(timeout_ms) {
-                        let _ = child.kill();
-                        let _ = child.wait();
-                        timed_out = true;
-                        break;
-                    }
-                    sleep(Duration::from_millis(10));
-                }
-                Err(e) => { eprintln!("[ny-compiler] wait error: {}", e); return false; }
-            }
-        }
-        // Collect any available output
-        let mut out_buf = Vec::new();
-        let mut err_buf = Vec::new();
-        if let Some(mut s) = ch_stdout { let _ = s.read_to_end(&mut out_buf); }
-        if let Some(mut s) = ch_stderr { let _ = s.read_to_end(&mut err_buf); }
-        if timed_out {
-            let head = String::from_utf8_lossy(&out_buf).chars().take(200).collect::<String>();
+        if out.timed_out {
+            let head = String::from_utf8_lossy(&out.stdout).chars().take(200).collect::<String>();
             eprintln!("[ny-compiler] child timeout after {} ms; stdout(head)='{}'", timeout_ms, head.replace('\n', "\\n"));
         }
-        let stdout = match String::from_utf8(out_buf) { Ok(s) => s, Err(_) => String::new() };
+        let stdout = match String::from_utf8(out.stdout.clone()) { Ok(s) => s, Err(_) => String::new() };
         if timed_out {
             // Fall back path will be taken below when json_line remains empty
         } else if let Ok(s) = String::from_utf8(err_buf.clone()) {