Auto-commit after successful build (2026-04-21 21:22:08)

README.md

@@ -0,0 +1,78 @@
+# GitHug Android
+
+Native Android adaptation of the GitHug learning game, built with **Kotlin + Jetpack Compose** and designed for **mobile-first usability** while preserving a **CLI-first play style**.
+
+## Current MVP scope
+
+This repository contains a starter Android app with:
+
+- Kotlin + Jetpack Compose project scaffolding
+- CLI-first gameplay shell
+- Optional hideable visualization panel
+- In-memory Git sandbox engine for early commands
+- First playable GitHug-inspired levels: `init`, `add`, and `commit`
+
+## Product direction
+
+The app supports three modes:
+
+- **CLI ONLY**: hide all visualization and play with terminal-style input only
+- **HYBRID**: command line with optional repo panels
+- **VISUAL**: repo panels visible by default, still backed by the same command engine
+
+## Building
+
+You will need a local Android SDK installation and either Android Studio or SDK command line tools.
+
+Typical next step once the SDK is installed:
+
+```bash
+./gradlew assembleDebug
+```
+
+## Automated environment setup
+
+This repo includes a root-level setup script:
+
+```bash
+bash ./SetupBuildEnvironment.sh
+```
+
+It is designed to be idempotent and uses project-relative paths to:
+
+- install a project-local JDK into `./jdk`
+- install Android command-line tools into `./android-sdk`
+- restore `gradle/wrapper/gradle-wrapper.jar` if missing
+- install required Android SDK packages
+- write `local.properties`
+
+To also build the debug APK without leaving Gradle running in the background:
+
+```bash
+bash ./SetupBuildEnvironment.sh --build
+```
+
+The script and project are configured to prefer non-daemon Gradle usage.
+
+It also avoids depending on the system Java version by provisioning a project-local **JDK 17**, which is required by current Android SDK command-line tools.
+
+To avoid repeated expensive SDK verification, the script writes a small state file named:
+
+`./.setup-build-environment.state`
+
+If all required components were verified successfully, the script will skip SDK verification/reinstallation for the next **24 hours** unless required directories are missing.
+
+When you run:
+
+```bash
+bash ./SetupBuildEnvironment.sh --build
+```
+
+the script will also attempt to create a **git commit after a successful build** if there are source changes to commit.
+
+## Next steps toward full GitHug parity
+
+- Expand the Git sandbox to cover merge, rebase, stash, tags, remotes, reset, revert, cherry-pick, bisect, and more
+- Port all original levels and hints into structured content files
+- Add richer validation rules and per-level explanations
+- Add onboarding, accessibility polish, icons, tests, and Play Store assets