Use Maven Wrapper (./mvnw) in Java workshop docs

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: brunoborges

finished/java/accessibility-report/src/main/java/workshop/AccessibilityReport.java

@@ -123,7 +123,7 @@ private static RunOptions parseRunOptions(String[] args) throws URISyntaxExcepti
     }
 
     private static String usage() {
-        return "Usage: mvn compile exec:java -Dexec.args=\"["
+        return "Usage: ./mvnw compile exec:java -Dexec.args=\"["
                 + LOCAL_DEMO_MCP_FLAG + "] <http-or-https-url>\"";
     }
 

finished/java/museum-exhibit-studio/README.md

@@ -7,15 +7,15 @@ This Maven CLI sample uses the GitHub Copilot SDK as a focused museum-curation a
 From this directory:
 
 ```bash
-mvn compile exec:java
+./mvnw compile exec:java
 ```
 
 Set `COPILOT_MODEL` to select a model; otherwise the Copilot runtime chooses its default. The sample requires an authenticated GitHub Copilot CLI.
 
 Compile without contacting a model:
 
 ```bash
-mvn compile
+./mvnw compile
 ```
 
 ## What it demonstrates
@@ -41,7 +41,7 @@ When prompted, answer yes to generate `exhibit.html`. The default Java permissio
 Current Java SDK releases may not surface those write-request fields (see <https://github.com/github/copilot-sdk/issues/2273>). For the controlled local workshop only, run with:
 
 ```bash
-mvn compile exec:java -Dexec.args="--allow-local-demo-write"
+./mvnw compile exec:java -Dexec.args="--allow-local-demo-write"
 ```
 
 That fallback is limited by the app to the `write` permission kind while only `builtin:apply_patch` is available, but it cannot enforce the output path. Do not use the fallback for production, shared, or untrusted worktrees.

finished/java/museum-exhibit-studio/src/main/java/workshop/MuseumExhibitStudio.java

@@ -303,7 +303,7 @@ private static RunOptions parseRunOptions(String[] args) {
     }
 
     private static String usage() {
-        return "Usage: mvn compile exec:java -Dexec.args=\"[" + LOCAL_DEMO_WRITE_FLAG + "]\"";
+        return "Usage: ./mvnw compile exec:java -Dexec.args=\"[" + LOCAL_DEMO_WRITE_FLAG + "]\"";
     }
 
     private static boolean isTimeout(Throwable error) {

scripts/validate_workshop.py

@@ -98,7 +98,7 @@
     ),
     "java": (
         "src/main/java/",
-        "mvn compile",
+        "./mvnw compile",
         "```java",
         "finished/java/",
     ),
@@ -109,7 +109,7 @@
     "python": ("workshop.py", '@define_tool(', "python main.py"),
     "go": ("main.go", "copilot.DefineTool(", "go run ."),
     "rust": ("src/main.rs", 'Tool::new("accessibility_rule_lookup")', "cargo run"),
-    "java": ("AccessibilityReport.java", "ToolDefinition.from(", "mvn compile exec:java"),
+    "java": ("AccessibilityReport.java", "ToolDefinition.from(", "./mvnw compile exec:java"),
 }
 # Every command runs from inside the starter directory the learner already sits in.
 # No lesson may reintroduce a copied sibling project.
@@ -119,15 +119,15 @@
     "python": "python main.py",
     "go": "go run .",
     "rust": "cargo run",
-    "java": "mvn compile exec:java",
+    "java": "./mvnw compile exec:java",
 }
 STEP_9_RUN_COMMAND_MARKERS = {
     "dotnet": "dotnet run",
     "nodejs": "npm start",
     "python": "python main.py",
     "go": "go run .",
     "rust": "cargo run --",
-    "java": "mvn compile exec:java",
+    "java": "./mvnw compile exec:java",
 }
 MUSEUM_COMMAND_MARKERS = {
     "dotnet": (
@@ -146,7 +146,7 @@
         "cargo run",
     ),
     "java": (
-        "mvn compile exec:java",
+        "./mvnw compile exec:java",
     ),
 }
 MUSEUM_ENTRYPOINTS = {
@@ -166,6 +166,7 @@
     "go mod init",
     "npm init ",
     "mvn archetype:generate",
+    "./mvnw archetype:generate",
 )
 IN_PLACE_FORBIDDEN_MARKERS = (
     "workshop-app",
@@ -178,6 +179,7 @@
     "go test",
     "cargo test",
     "mvn test",
+    "./mvnw test",
     "python -m unittest",
     "unittest",
     "mock-wikipedia",

start-accessibility/README.md

@@ -15,7 +15,7 @@ local tool, MCP server, or report until the corresponding step.
 | Python | [Python 3.11+](https://www.python.org/downloads/) | `cd start-accessibility/python && python -m pip install -r requirements.txt && python -m py_compile *.py` |
 | Go | [Go 1.24+](https://go.dev/dl/) | `cd start-accessibility/go && go build -mod=readonly ./...` |
 | Rust | [Rust 1.94+](https://rustup.rs/) | `cd start-accessibility/rust && cargo check --locked` |
-| Java | [Java 17+](https://adoptium.net/) and [Maven](https://maven.apache.org/install.html) | `cd start-accessibility/java && mvn compile` |
+| Java | [Java 17+](https://adoptium.net/) (Maven Wrapper included) | `cd start-accessibility/java && ./mvnw compile` |
 
 Because you edit these files in place, your work shows up in `git status`. That is expected. Run
 `git checkout -- .` from the repository root to restore a clean starter. Go, Rust, and Java tracks

start-museum/README.md

@@ -23,7 +23,7 @@ step's code goes. Start at [`workshop/museum-00-preflight.md`](../workshop/museu
 | Python | `curator.py` | `cd start-museum/python && python -m venv .venv && .venv/bin/python -m pip install -r requirements.txt && .venv/bin/python main.py` |
 | Go | `curator.go` | `cd start-museum/go && go build -mod=readonly ./... && go run .` |
 | Rust | `src/lib.rs` | `cd start-museum/rust && cargo check --locked && cargo run --locked` |
-| Java | `src/main/java/workshop/Curator*.java` | `cd start-museum/java && mvn compile && mvn exec:java` |
+| Java | `src/main/java/workshop/Curator*.java` | `cd start-museum/java && ./mvnw compile && ./mvnw exec:java` |
 
 Running the starter prints its identity and does not start Copilot or require authentication.
 Because you edit these files in place, your work shows up in `git status`. That is expected. Run

workshop/00-preflight.md

@@ -145,7 +145,6 @@ See the official
 | Requirement | Why the workshop needs it | Verify |
 |---|---|---|
 | [Java 17 or newer](https://adoptium.net/) (JDK) | Compiles and runs the Maven workshop app | `java -version` |
-| [Apache Maven 3.9+](https://maven.apache.org/install.html) | Builds the project and launches `exec:java` | `mvn -version` |
 | [Node.js 22 or newer](https://nodejs.org/) | Runs the Playwright MCP server | `node --version` |
 | [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli) | Required on `PATH` for the Java SDK runtime | `copilot --version` |
 | [GitHub Copilot access](https://github.com/features/copilot) | Authorizes Copilot requests | `copilot login` |
@@ -156,15 +155,15 @@ Your commands should return output in this shape:
 ```text
 $ java -version
 openjdk version "17.x.x" ...
-$ mvn -version
-Apache Maven 3.9.x
 $ node --version
 v22.x.x
 $ copilot --version
 GitHub Copilot CLI ...
 ```
 
-Use Maven for this track. Do not substitute JBang or Gradle. See the official
+No separate Maven install is needed: each Java project includes the Maven Wrapper (`./mvnw`),
+which downloads the right Maven version on first use. On Windows, run `mvnw.cmd` instead of
+`./mvnw`. Use Maven for this track. Do not substitute JBang or Gradle. See the official
 [Java SDK installation guide](https://github.com/github/copilot-sdk/tree/main/java).
 :::
 
@@ -535,7 +534,7 @@ Change into the Java starter and compile with Maven. Stay in this directory for
 
 ```bash
 cd start-accessibility/java
-mvn compile
+./mvnw compile
 ```
 
 A successful compile ends with:
@@ -561,9 +560,10 @@ Open the controlled target page once to make sure you can reach it:
 
 | Symptom | Fix |
 |---|---|
-| `java` or `mvn` is not recognized | Install JDK 17+ and Maven, then restart the terminal. |
+| `java` is not recognized | Install JDK 17+, then restart the terminal. |
+| `./mvnw: Permission denied` | Run `chmod +x mvnw`, or use `sh mvnw` instead. On Windows, use `mvnw.cmd`. |
 | Compiler release errors | Confirm `java -version` reports 17 or newer; the POM sets `maven.compiler.release` to 17. |
-| Dependency download fails | Check Maven Central / proxy settings, then rerun `mvn compile`. |
+| Dependency download fails | Check Maven Central / proxy settings, then rerun `./mvnw compile`. |
 | Tempted to switch tools | Do not replace Maven with JBang or Gradle for this workshop. |
 | `copilot` is not recognized | Install the CLI, restart the terminal, and verify `copilot --version`. |
 | Copilot asks you to authenticate | Run `copilot login`, finish the browser flow, then retry. |
@@ -572,7 +572,7 @@ Open the controlled target page once to make sure you can reach it:
 
 </details>
 
-> **Start Step 1 when:** `mvn compile` prints `BUILD SUCCESS`, `copilot login` is complete, and the
+> **Start Step 1 when:** `./mvnw compile` prints `BUILD SUCCESS`, `copilot login` is complete, and the
 > target page opens.
 
 Compare with

workshop/01-first-session.md

@@ -390,7 +390,7 @@ cargo run
 :::
 :::language java
 ```bash
-mvn compile exec:java
+./mvnw compile exec:java
 ```
 :::
 

workshop/02-streaming.md

@@ -878,7 +878,7 @@ finishes.
 ## Run it
 
 ```bash
-mvn compile exec:java
+./mvnw compile exec:java
 ```
 
 The completed response should print before the process exits:
@@ -896,7 +896,7 @@ The completed response should print before the process exits:
 |---|---|
 | No response is printed | Confirm `setStreaming(true)` is on `SessionConfig` and you call `sendAndWait`. |
 | The process fails with a null response | Keep the `response == null` guard and throw when the turn completes without a message. |
-| Maven cannot find the main class | Run from the starter directory with `mvn compile exec:java`. |
+| Maven cannot find the main class | Run from the starter directory with `./mvnw compile exec:java`. |
 
 </details>
 

workshop/03-local-tool.md

@@ -894,7 +894,7 @@ completed response when the turn finishes.
 ## Run it
 
 ```bash
-mvn compile exec:java
+./mvnw compile exec:java
 ```
 
 The response should use the lookup result for WCAG 4.1.2: