Jules PR (#6)

* feat: Implement Automated Android Build Pipeline

Implements a complete, two-stage GitHub Actions pipeline to automatically build an Android APK from the repository.

- **Configuration Bot**: A workflow (`config-bot.yml`) runs on every push to ensure the repository has a valid Android project structure. It executes a script (`align_android_config.sh`) to generate any missing Gradle files, source files, or the official Gradle Wrapper, and auto-commits the changes.
- **Build Bot**: A second workflow (`android-build.yml`) triggers after the configuration bot succeeds. It sets up a Java/Android environment, installs frontend dependencies for the web terminal (`npm install`), and builds a debug APK using Gradle.
- **Self-Contained APK**: The resulting Android application packages the web terminal and embeds a `nodejs-mobile-android` runtime. This allows the terminal's `server.js` backend to run directly on the device, making the application fully self-contained and functional. The `server.js` and Android runtime logic have been aligned to work together correctly.
- The final APK is uploaded as a downloadable artifact from the GitHub Actions run.

* feat: Implement Standalone Android App with Flexible Backend

This commit introduces a complete system for building and running the web-based terminal as a standalone Android application. The solution is designed to be flexible and independent of any specific build environment.

Key features include:
- **Full Android Project Structure**: Adds all necessary files for a complete Gradle-based Android project, including a full, official Gradle Wrapper for reproducible builds.
- **Standalone Build Script**: A new `build_standalone.sh` script provides a one-step command to build the APK locally, independent of GitHub Actions.
- **Embedded Node.js Server**: The Android app packages and runs the `server.js` backend directly on the device using the `nodejs-mobile-android` library, making the app fully self-contained.
- **Flexible Backend Connectivity**: The app UI includes an input field and a "Connect" button, allowing the user to connect the terminal to either the local embedded server (`ws://localhost:3000/terminal`) or any remote WebSocket backend.
- **JavaScript Bridge**: The web terminal's frontend has been modified to expose a JavaScript function that the native Android code calls to initiate the connection, enabling the flexible backend logic.

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>

Author: google-labs-jules[bot]

.github/workflows/android-build.yml

@@ -0,0 +1,45 @@
+name: Build Android APK
+
+on:
+  workflow_run:
+    workflows: ["Align Android Config Bot"]
+    types:
+      - completed
+
+jobs:
+  build:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Install Frontend Dependencies
+        run: |
+          cd web-terminal
+          npm install
+
+      - name: Validate Gradle wrapper
+        uses: gradle/wrapper-validation-action@v2
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v3
+
+      - name: Make gradlew executable
+        run: chmod +x ./gradlew
+
+      - name: Build with Gradle
+        run: ./gradlew build
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: debug-apk
+          path: app/build/outputs/apk/debug/app-debug.apk

.github/workflows/config-bot.yml

@@ -0,0 +1,35 @@
+name: Align Android Config Bot
+
+on:
+  push:
+    branches:
+      - main # Or your primary branch
+
+jobs:
+  align:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Run Alignment Script
+        run: ./align_android_config.sh
+
+      - name: Download and Extract Gradle Wrapper JAR
+        run: |
+          mkdir -p gradle/wrapper
+          curl -L -o gradle-dist.zip https://services.gradle.org/distributions/gradle-8.2-bin.zip
+          unzip -p gradle-dist.zip gradle-8.2/lib/gradle-wrapper-8.2.jar > gradle/wrapper/gradle-wrapper.jar
+          rm gradle-dist.zip
+
+      - name: Auto-commit changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore: Align Android configuration"
+          branch: ${{ github.ref_name }}
+          commit_options: '--no-verify'
+          file_pattern: 'build.gradle settings.gradle app/build.gradle gradlew gradlew.bat gradle/wrapper/gradle-wrapper.properties src/**'
+          repository: .
+          commit_user_name: Config Bot
+          commit_user_email: bot@superlab.com
+          commit_author: Config Bot <bot@superlab.com>