Add headless server and setup script

README.md

@@ -132,14 +132,43 @@ java -jar j3270.jar -d mainframe.example.com
 
 ## 🛠️ Building from Source
 
-### Standalone Build (No Gradle Required)
-The project provides self-contained, portable build scripts requiring only a JDK:
+### Quick Setup & Build for End Users
+
+Self-contained setup scripts automatically locate an installed Java 11+ JDK (searching `JAVA_HOME`, system `PATH`, macOS `java_home`, Homebrew, Linux JVM paths, Windows Registry, standard installation directories, and package managers), compile `lib3270j` and `j3270`, and package the standalone executable JAR (`build/j3270.jar`):
+
+**Linux / macOS (POSIX Shell):**
+```bash
+# Setup and build standalone executable JAR:
+./setup.sh
+
+# Build and immediately launch:
+./setup.sh --run
+
+# Clean build and connect to host:
+./setup.sh --clean --run -- mainframe.example.com 23 4
+```
+
+**Windows (PowerShell):**
+```powershell
+# Setup and build standalone executable JAR:
+.\setup.ps1
+
+# Build and immediately launch:
+.\setup.ps1 -Run
+
+# Clean build and connect to host:
+.\setup.ps1 -Clean -Run -- mainframe.example.com 23 4
+```
+*(Also available as `.\setup.ps`)*
+
+### Standalone Build (Advanced / CI)
+The project also provides low-level scripts and optional Gradle support:
 
 ```bash
-# Build standalone executable JAR (build/j3270.jar):
+# Direct compile and package without diagnostics:
 sh ./build_all.sh
 
-# Run all 539 automated unit tests across 88 test containers (~7s):
+# Run all 539+ automated unit tests (~7s):
 sh ./test_all.sh
 ```