fix(ci): Remove CI/CD check differences between PR and push events

[konard]

Summary

This PR applies best practices from js-ai-driven-development-pipeline-template#18 to fix the issue where CI/CD checks behave differently for pull request events vs push/merge events.

Root Cause

When documentation-only PRs are merged without changesets:

1. The changeset-check job fails with "No changeset found"
2. Documentation-only changes shouldn't require changesets
3. After merge, the push to main triggers lint, which could fail on unformatted files

Changes

New Script:

• Created scripts/detect-code-changes.mjs - a cross-platform Node.js script for detecting file changes in CI/CD
• Adapted from the JavaScript template for Java-specific file types (.java, pom.xml)
• Replaces need for inline bash scripts for better maintainability and cross-platform support

Workflow Changes:

• Add detect-changes job that runs the new script and outputs what types of files changed
• Make lint job independent of changeset-check - it's a fast check that should always run
• Make changeset-check skip for docs-only PRs by adding condition: needs.detect-changes.outputs.any-code-changed == 'true'
• Add || needs.changeset-check.result == 'skipped' to test job to handle the new skipped state
• Update any-code-changed detection to exclude:
  • .changeset/ folder (changeset metadata)
  • docs/ folder (documentation)
  • experiments/ folder (experimental scripts)
  • examples/ folder (example scripts)
  • All markdown files (*.md) in any folder
• Simplify Java version matrix - test only on latest Java version (21) instead of multiple versions (17, 21)

Benefits

After this fix:

1. Lint runs on ALL PRs regardless of changeset status
2. Docs-only PRs don't require changesets (reducing friction for documentation updates)
3. No differences between PR checks and push/merge checks (preventing future surprises)
4. Changeset validation only runs when code changes (more sensible behavior)
5. Cross-platform compatible - the detection script is written in Node.js/Bun (.mjs)
6. Simplified CI - tests run only on latest Java version (21), reducing CI time

Testing

CI checks:

• ✅ All lint and format checks pass
• ✅ All tests pass on all platforms (Ubuntu, macOS, Windows) with Java 21
• ✅ Changeset check passes
• ✅ Build succeeds

Files Changed

• .github/workflows/release.yml - Workflow structure updates + use new script + Java 21 only
• scripts/detect-code-changes.mjs - NEW Cross-platform change detection script
• .changeset/fix-ci-workflow-dependencies.md - Changeset for release
• CHANGELOG.md - Minor formatting fix (removed extra blank lines)

Fixes #3

---

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $3.958534 USD
• Calculated by Anthropic: $2.768571 USD
• Difference: $-1.189962 (-30.06%)
  📎 Log file uploaded as GitHub Gist (679KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.

[konard]

In template we need to have tests only for single latest version of Java.

[konard]

🤖 AI Work Session Started

Starting automated work session at 2025-12-29T14:35:39.104Z

The PR has been converted to draft mode while work is in progress.

This comment marks the beginning of an AI work session. Please wait working session to finish, and provide your feedback.

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $1.105282 USD
• Calculated by Anthropic: $0.728567 USD
• Difference: $-0.376715 (-34.08%)
  📎 Log file uploaded as GitHub Gist (260KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.