feat(emergency-room): harden pulse with self-healing and diagnostics

Author: hyperpolymath

emergency-room/MIGRATION.adoc

@@ -56,6 +56,7 @@ cargo test  -p emergency-room
 # Memory pressure / oomd observer (read-only, no process killing)
 ./target/debug/emergency-room pulse --once
 ./target/debug/emergency-room pulse --poll-seconds 20
+./target/debug/emergency-room pulse --doctor
 
 # Install as user service
 ./emergency-room/systemd/install-pulse.sh

emergency-room/rust/src/main.rs

@@ -92,6 +92,9 @@ struct PulseArgs {
     /// Run one iteration and exit
     #[arg(long)]
     once: bool,
+    /// Run self-diagnostics and print a health report as JSON
+    #[arg(long)]
+    doctor: bool,
     #[arg(short = 'n', long)]
     dry_run: bool,
 }
@@ -210,6 +213,14 @@ fn run_pulse(args: PulseArgs) {
         dry_run: args.dry_run,
     };
 
+    if args.doctor {
+        if let Err(e) = pulse::doctor(&cfg) {
+            eprintln!("\x1b[31m[ERROR]\x1b[0m pulse doctor failed: {e}");
+            std::process::exit(1);
+        }
+        return;
+    }
+
     if let Err(e) = pulse::run(cfg) {
         eprintln!("\x1b[31m[ERROR]\x1b[0m pulse failed: {e}");
         std::process::exit(1);