Add release automation, Docker support, Windows cross-compilation, and enhanced REPL experience

.dockerignore

@@ -0,0 +1,47 @@
+# Build artifacts
+*.o
+*.a
+*.so
+*.dylib
+*.uo
+*.ui
+camlrunm
+mosmlcmp
+mosmllnk
+mosmllex
+mosmlyac
+
+# Binaries (top-level names only)
+mosmldep
+cutdeps
+
+# Generated files
+src/compiler/Parser.sig
+src/compiler/Parser.sml
+src/compiler/Lexer.sml
+src/compiler/Opcodes.sml
+src/compiler/Predef.sml
+src/compiler/Prim_c.sml
+src/runtime/primitives
+src/config/m.h
+src/config/s.h
+
+# Build directories
+bin/
+lib/
+include/
+
+# OS files
+.DS_Store
+.git
+.github
+*.swp
+*~
+
+# Documentation and examples (not needed for build)
+doc/
+examples/
+
+# Staging and install directories
+staging/
+win-root/

.github/workflows/buildAndTest.yml

@@ -1,57 +1,254 @@
 name: Build & Test
 
 on:
-  pull_request:
+    push:
+        branches: ["main", "develop", "gnu-tty-stds-and-fixes"] # delete this branch name when merged
+        tags: ["v*.*.*"]
+    pull_request:
+        branches: ["main", "develop"]
+    release:
+        types: [created]
+    workflow_dispatch:
 
-  push:
-    branches:
-      - master
-      - devel
+jobs:
+    build-test:
+        name: Build & Test (${{ matrix.os }})
+        strategy:
+            fail-fast: false
+            matrix:
+                include:
+                    - os: ubuntu-latest
+                      platform: linux
+                      arch: x86_64
+                    - os: macos-latest
+                      platform: macos
+                      arch: x86_64
+                    - os: macos-14
+                      platform: macos
+                      arch: arm64
 
+        runs-on: ${{ matrix.os }}
 
-jobs:
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v5
+
+            - name: Install dependencies (Ubuntu)
+              if: matrix.platform == 'linux'
+              run: |
+                  sudo apt-get update -qq
+                  sudo apt-get install -y binutils build-essential perl libgmp-dev rlwrap
+
+            - name: Install dependencies (macOS)
+              if: matrix.platform == 'macos'
+              run: |
+                  brew update
+                  brew install rlwrap
+
+            - name: Build
+              run: |
+                  cd src && make world
+
+            - name: Install
+              run: |
+                  cd src
+                  sudo make install
+
+            - name: Test compiler and runtime system
+              run: |
+                  cd src/test
+                  make current cleaned
+                  diff cleaned-result cleaned-result.ok
+
+            - name: Test mosmllib
+              run: |
+                  cd src/mosmllib/test
+                  make current cleaned
+                  diff cleaned-result cleaned-result.ok
+
+            - name: Create staging directory for artifact
+              run: |
+                  cd src
+                  make DESTDIR=${{ github.workspace }}/staging PREFIX=/usr/local install
+
+            - name: Create artifact archive
+              run: |
+                  cd staging
+                  tar -czf ../mosml-${{ matrix.platform }}-${{ matrix.arch }}.tar.gz usr/local
+
+            - name: Set up Docker Buildx (on Linux)
+              if: matrix.platform == 'linux'
+              uses: docker/setup-buildx-action@v3
+
+            - name: Build Windows binaries using Docker (on Linux)
+              if: matrix.platform == 'linux'
+              run: |
+                  mkdir -p out
+                  docker build --platform=linux/386 -t mosml-win-builder -f Dockerfile.w32 .
+                  docker run --rm -v "$(pwd)/out:/out" mosml-win-builder
+
+            - name: Upload build artifacts
+              uses: actions/upload-artifact@v4
+              with:
+                  name: mosml-${{ matrix.platform }}-${{ matrix.arch }}
+                  path: mosml-${{ matrix.platform }}-${{ matrix.arch }}.tar.gz
+                  retention-days: 30
+
+            - name: Upload Windows build artifact
+              if: matrix.platform == 'linux'
+              uses: actions/upload-artifact@v4
+              with:
+                  name: mosml-windows-x86_64-zip
+                  path: out/mosml-windows-x86_64.zip
+                  retention-days: 30
+
+    build-windows-installer:
+        name: Build Windows Installer
+        needs: [build-test]
+        runs-on: windows-latest
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v5
+
+            - name: Download Windows zip artifact
+              uses: actions/download-artifact@v4
+              with:
+                  name: mosml-windows-x86_64-zip
+                  path: .
+
+            - name: Extract Windows binaries
+              run: |
+                  Expand-Archive -Path mosml-windows-x86_64.zip -DestinationPath . -Force
+              shell: pwsh
+
+            - name: Prepare Inno Setup directory
+              run: |
+                  New-Item -ItemType Directory -Path inno-setup-build -Force
+                  Copy-Item -Path mosml -Destination inno-setup-build/ -Recurse
+                  Copy-Item -Path src/tools/installer/mosml.iss -Destination inno-setup-build/
+              shell: pwsh
+
+            - name: Build Windows Installer with Inno Setup
+              uses: Minionguyjpro/Inno-Setup-Action@v1.2.7
+              with:
+                  path: inno-setup-build/mosml.iss
+                  options: /O+
+
+            - name: Rename installer
+              run: |
+                  $installerPath = Get-ChildItem -Path inno-setup-build/Output -Filter "mosml-setup-*.exe" | Select-Object -First 1
+                  if ($installerPath) {
+                      Move-Item -Path $installerPath.FullName -Destination mosml-setup-windows-x86_64.exe
+                      Write-Host "Installer created: mosml-setup-windows-x86_64.exe"
+                  } else {
+                      Write-Host "No installer found in Output directory"
+                      Get-ChildItem -Path inno-setup-build/Output -Recurse
+                  }
+              shell: pwsh
+
+            - name: Upload Windows Installer artifact
+              uses: actions/upload-artifact@v4
+              with:
+                  name: mosml-windows-installer
+                  path: mosml-setup-windows-x86_64.exe
+                  retention-days: 30
+
+    create-release:
+        name: Create Release
+        needs: [build-test, build-windows-installer]
+        if: startsWith(github.ref, 'refs/tags/v')
+        runs-on: ubuntu-latest
+        permissions:
+            contents: write
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v5
+
+            - name: Download all artifacts
+              uses: actions/download-artifact@v4
+              with:
+                  path: artifacts
+
+            - name: Display structure of downloaded files
+              run: ls -R artifacts
+
+            - name: Extract version from tag
+              id: version
+              run: echo "version=${GITHUB_REF#refs/tags/v}" >> "$GITHUB_OUTPUT"
+
+            - name: Create release notes
+              run: |
+                  cat > release_notes.md << 'EOF'
+                  # Moscow ML ${{ steps.version.outputs.version }}
+
+                  This release includes builds for multiple platforms and architectures:
+
+                  ## Platform Support
+                  - **Linux (x86_64)**: Full support with rlwrap integration
+                  - **macOS (x86_64)**: Intel-based Macs with rlwrap integration
+                  - **macOS (arm64)**: Apple Silicon (M1/M2/M3) with rlwrap integration
+                  - **Windows (x86_64)**: Native Windows build
+
+                  ## Features
+                  - Standard ML (SML'97) implementation
+                  - Bytecode compiler and runtime
+                  - Separate compilation support
+                  - Dynamic linking (on supported platforms)
+                  - Interactive REPL with **rlwrap** support for command history and line editing
+                  - Full Standard ML Basis Library
+
+                  ## Installation
+
+                  ### Windows
+                  Download and run the installer: `mosml-setup-windows-x86_64.exe`
+
+                  The installer will:
+                  - Install Moscow ML to `C:\Program Files\mosml` (or custom location)
+                  - Add Moscow ML to your system PATH
+                  - Create Start Menu shortcuts
+                  - Optionally create desktop shortcuts
+
+                  Alternatively, extract the portable ZIP archive: `mosml-windows-x86_64.zip`
+
+                  ### Linux / macOS
+                  ```bash
+                  # Extract the archive
+                  tar -xzf mosml-<platform>-<arch>.tar.gz
+
+                  # Copy to system (requires root)
+                  sudo cp -r usr/local/* /usr/local/
+
+                  # Or install to custom location
+                  tar -xzf mosml-<platform>-<arch>.tar.gz -C $HOME/.local --strip-components=2
+                  export PATH="$HOME/.local/bin:$PATH"
+                  ```
+
+                  ## rlwrap Integration
+                  The `mosml` interactive REPL now automatically uses `rlwrap` when available, providing:
+                  - Command history (saved to $XDG_DATA_HOME/mosml/history or $HOME/.local/share/mosml/history, if XDG_DATA_HOME is not set)
+                  - Line editing with arrow keys
+                  - Tab completion support
+
+                  To disable rlwrap, set the `DISABLE_RLWRAP=1` environment variable before running mosml.
+
+                  ## Documentation
+                  See the [project repository](https://github.com/${{ github.repository }}) for full documentation.
+                  EOF
 
-  build-test:
-
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest]
-
-    runs-on: ${{ matrix.os }}
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-
-      - name: Install dependencies (Ubuntu)
-        if: matrix.os == 'ubuntu-latest'
-        run: |
-          sudo apt-get update -qq
-          sudo apt-get install -y binutils build-essential perl libgmp-dev
-
-      - name: Install dependencies (macOS)
-        if: matrix.os == 'macos-latest'
-        run: |
-          brew update
-          brew install gmp
-
-      - name: Build
-        run: |
-          cd src && make world
-
-      - name: Install
-        run: |
-          cd src
-          sudo make install
-
-      - name: Test compiler and runtime system
-        run: |
-          cd src/test
-          make current cleaned
-          diff cleaned-result cleaned-result.ok
-
-      - name: Test mosmllib
-        run: |
-          cd src/mosmllib/test
-          make current cleaned
-          diff cleaned-result cleaned-result.ok
+            - name: Create GitHub Release
+              uses: softprops/action-gh-release@v2
+              with:
+                  name: Moscow ML ${{ steps.version.outputs.version }}
+                  body_path: release_notes.md
+                  draft: false
+                  prerelease: false
+                  files: |
+                      artifacts/mosml-linux-x86_64/mosml-linux-x86_64.tar.gz
+                      artifacts/mosml-macos-x86_64/mosml-macos-x86_64.tar.gz
+                      artifacts/mosml-macos-arm64/mosml-macos-arm64.tar.gz
+                      artifacts/mosml-windows-installer/mosml-setup-windows-x86_64.exe
+                      artifacts/mosml-windows-x86_64-zip/mosml-windows-x86_64.zip
+              env:
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}