Add Gradle wrapper, CI verification step, and docs

[hypermezo4-create]

Motivation

• Ensure CI can run a reproducible Gradle build by including the project Gradle wrapper and documenting required files.
• Fail early in GitHub Actions if wrapper files are missing to avoid confusing build failures later.
• Provide contributor guidance about the wrapper JAR being manually managed for CI builds.

Description

• Add Gradle wrapper scripts (gradlew, gradlew.bat) and gradle/wrapper/gradle-wrapper.properties to the repository and a gradle/wrapper/README.md explaining the wrapper JAR requirement.
• Update .github/workflows/android-debug.yml to include a Verify Gradle wrapper files step that runs test -f ./gradlew, test -f ./gradle/wrapper/gradle-wrapper.properties, and test -f ./gradle/wrapper/gradle-wrapper.jar before running ./gradlew assembleDebug.
• Update README.md with a Gradle wrapper + CI notes section listing required wrapper files and the expected CI commands such as chmod +x ./gradlew and ./gradlew assembleDebug.

Testing

• No unit or integration tests were added or modified in this change.
• The CI build-debug workflow now verifies wrapper presence and will run ./gradlew assembleDebug and upload the debug APK when triggered by pushes or PRs against main.
• No automated tests were executed as part of this PR rollout; the updated workflow will run automatically in GitHub Actions on the next push/PR.

---

Codex Task

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
cavo	Ready	Preview, Comment	Apr 21, 2026 9:01pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 15f558c25e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Commit wrapper JAR before requiring it in CI

This workflow now hard-fails on test -f ./gradle/wrapper/gradle-wrapper.jar, but this commit does not add gradle/wrapper/gradle-wrapper.jar (only README.md and gradle-wrapper.properties are added under gradle/wrapper), so every push/PR run will fail before assembleDebug executes. In practice this blocks the new build-debug pipeline for this commit until the JAR is actually tracked in the repository or this check is relaxed.

Useful? React with 👍 / 👎.