Address review: fix commit message, remove --save-exact, fix WORKFLOWS.md links and add codegen-only note

Agent-Logs-Url: https://github.com/github/copilot-sdk-java/sessions/d68264a5-52bb-497f-bca0-5ef13a7efdec

Co-authored-by: edburns <75821+edburns@users.noreply.github.com>

Author: Copilot

.github/scripts/reference-impl-sync/merge-reference-impl-finish.sh

@@ -67,7 +67,7 @@ echo "▸ Syncing @github/copilot version in scripts/codegen/package.json…"
 "$ROOT_DIR/.github/scripts/reference-impl-sync/sync-codegen-version.sh" "$REFERENCE_IMPL_DIR"
 
 git add .lastmerge pom.xml scripts/codegen/package.json scripts/codegen/package-lock.json
-git commit -m "Update .lastmerge to $NEW_COMMIT and sync pom.xml CLI version"
+git commit -m "Update .lastmerge to $NEW_COMMIT, sync pom.xml CLI version, and update scripts/codegen @github/copilot version"
 
 # ── 3. Push branch ───────────────────────────────────────────
 echo "▸ Pushing branch $BRANCH_NAME to origin…"

.github/scripts/reference-impl-sync/sync-codegen-version.sh

@@ -63,7 +63,9 @@ if [[ ! -f "$CODEGEN_PKG" ]]; then
 fi
 
 # Update scripts/codegen/package.json with the new version and regenerate the lock file.
+# Intentionally omit --save-exact to preserve the version specifier used by the reference
+# implementation (e.g. a caret range like '^1.0.36-0' rather than an exact pin '1.0.36-0').
 echo "▸ Updating scripts/codegen/package.json: @github/copilot → ${CLI_VERSION}"
 cd "$CODEGEN_DIR"
-npm install "@github/copilot@${CLI_VERSION}" --save-exact
+npm install "@github/copilot@${CLI_VERSION}"
 echo "▸ Updated scripts/codegen to @github/copilot@${CLI_VERSION}"

docs/WORKFLOWS.md

@@ -6,11 +6,11 @@
 |----------|-------------|----------|----------|
 | [Build & Test](workflows/build-test.yml) | Builds, lints, and tests the Java SDK | `push` (main), `pull_request`, `merge_group`, `workflow_dispatch` | Sundays at 00:00 UTC |
 | [Codegen Check](workflows/codegen-check.yml) | Verifies that generated Java files are up-to-date with the JSON schemas | `push` (main), `pull_request`, `workflow_dispatch` | — |
-| [Update @github/copilot Dependency](workflows/update-copilot-dependency.yml) | Updates the `@github/copilot` npm package, re-runs code generation, and opens a PR | `workflow_dispatch` | — |
+| [Update @github/copilot Dependency](workflows/update-copilot-dependency.yml) | _(Codegen-only)_ Updates the `@github/copilot` npm package in `scripts/codegen`, re-runs code generation, and opens a PR. Does **not** update `pom.xml`; use the Reference Implementation Sync for full version alignment. | `workflow_dispatch` | — |
 | [Deploy Documentation](workflows/deploy-site.yml) | Generates and deploys versioned docs to GitHub Pages | `workflow_run` (after Build & Test), `release`, `workflow_dispatch` | — |
 | [Publish to Maven Central](workflows/publish-maven.yml) | Releases the SDK to Maven Central and creates a GitHub Release | `workflow_dispatch` | — |
 | [Reference Implementation Sync](workflows/reference-impl-sync.yml) | Checks for new reference implementation commits and creates an issue for Copilot to merge | `workflow_dispatch` | [See workflow](workflows/reference-impl-sync.yml) |
-| [Reference Implementation Sync (Agentic)](workflows/reference-impl-sync.lock.yml) | Compiled agentic workflow that executes the reference implementation sync via `gh-aw` | `workflow_dispatch` | [See workflow](workflows/reference-impl-sync.yml) |
+| [Reference Implementation Sync (Agentic)](workflows/reference-impl-sync.lock.yml) | Compiled agentic workflow that executes the reference implementation sync via `gh-aw` | `workflow_dispatch` | [See workflow](workflows/reference-impl-sync.lock.yml) |
 | [Copilot Setup Steps](workflows/copilot-setup-steps.yml) | Configures the environment for the GitHub Copilot coding agent | `push` (on self-change), `workflow_dispatch` | — |
 
 ---
@@ -113,6 +113,8 @@ If changes appear, commit the updated generated files.
 
 **File:** [`update-copilot-dependency.yml`](workflows/update-copilot-dependency.yml)
 
+> **Note:** This workflow is for codegen-only updates to `scripts/codegen`. It does **not** update `pom.xml`. For full version alignment (both CLI and codegen in lockstep), use the **Reference Implementation Sync** workflow instead.
+
 Manual workflow triggered when a new version of the `@github/copilot` npm package is published. Accepts a `version` input (e.g. `1.0.25`).
 
 Steps: