Fix part of #6106: Implement GenerateChangelogs script with Vertex AI integration by Sandesh282 · Pull Request #6313 · oppia/oppia-android

Sandesh282 · 2026-07-12T20:02:19Z

Fixes part of #6106

Explanation

Adds the GenerateChangelogs.kt script that automates changelog generation between release branches. The script collects commits and linked GitHub issues between two release branches, sends them to Vertex AI (Gemini) to generate a human-readable changelog, writes the output to config/changelogs/, and opens a GitHub PR with the result. Includes LLM fallback logic for when the API is unavailable.

Files modified

scripts/BUILD.bazel
scripts/src/java/org/oppia/android/scripts/release/BUILD.bazel

Files created

scripts/src/java/org/oppia/android/scripts/release/FakeVertexAiClient-kt
scripts/src/java/org/oppia/android/scripts/release/GenerateChangelogs.kt 
scripts/src/java/org/oppia/android/scripts/release/GoogleVertexAiClient.kt 
scripts/src/java/org/oppia/android/scripts/release/VertexAiClient.kt

Essential Checklist

The PR title starts with "Fix #bugnum: " (If this PR fixes part of an issue, prefix the title with "Fix part of #bugnum: ...".)
The explanation section above starts with "Fixes #bugnum: " (If this PR fixes part of an issue, use instead: "Fixes part of #bugnum: ...".)
Any changes to scripts/assets files have their rationale included in the PR explanation.
The PR follows the style guide.
The PR does not contain any unnecessary code changes from Android Studio (reference).
The PR is made from a branch that's not called "develop" and is up-to-date with "develop".
The PR is assigned to the appropriate reviewers (reference).

…eration Introduces a narrow VertexAiClient interface abstracting Vertex AI text generation calls, and a FakeVertexAiClient for unit testing. The fake records all received prompts, supports a configurable shouldFail flag (auto-resets after each throw), and exposes a reset() helper — matching the same pattern as FakePlayConsoleClient and FakeCloudSigner. Part of fix #6106 (M2 PR 2.1 — GenerateChangelogs script).

Implements VertexAiClient using OkHttp + Moshi to call the Vertex AI generateContent REST endpoint. Auth is via a GCP Bearer token obtained through Workload Identity Federation in CI. Key details: - Sends synchronous HTTP POST to the generateContent endpoint - Parses candidates[0].content.parts[0].text from the JSON response - Fails with a descriptive message on non-2xx status or empty response - apiBaseUrl is a companion object var, overridable in tests to point at a local MockWebServer without subclassing Part of fix #6106 (M2 PR 2.1 — GenerateChangelogs script).

…og PRs Implements the GenerateChangelogs.kt script that: 1. Reads MAJOR/MINOR_VERSION from version.bzl to derive the previous version whose changelog needs to be generated (e.g. bump 0.17→0.18 generates 0.17) 2. Finds the commit range between the two most recent release branch merge-bases 3. Collects merged PRs (via 'git log --oneline') and parses Fixes/Closes #NNNN issue references from commit subjects 4. Invokes Vertex AI (Gemini) with a structured prompt to produce a 2-3 sentence user-facing summary of the release 5. Falls back to a raw commit list with a  marker if the Vertex AI call throws, so the PR is still created for human review 6. Creates/updates a PR on 'automated/changelog-<version>' branch via 'gh pr create' with links to all reference material in the PR body Also adds Bazel library and binary targets for all new source files, following the same visibility pattern as the existing release automation targets. Part of fix #6106 (M2 PR 2.1 — GenerateChangelogs script).

coderabbitai · 2026-07-12T20:02:25Z

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: de006571-858e-4062-a7fb-b4706bfc258d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch pr2.1/generate-changelogs-script

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

Sandesh282 · 2026-07-12T20:03:32Z

Will be adding unit test suite soon!

github-actions · 2026-07-12T20:24:24Z

Coverage Report

Results

Number of files assessed: 4
Overall Coverage: 0.00%
Coverage Analysis: FAIL ❌

Failure Cases

File	Failure Reason	Status
GoogleVertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/GoogleVertexAiClient.kt	No appropriate test file found for scripts/src/java/org/oppia/android/scripts/release/GoogleVertexAiClient.kt.	❌
GenerateChangelogs.kt scripts/src/java/org/oppia/android/scripts/release/GenerateChangelogs.kt	No appropriate test file found for scripts/src/java/org/oppia/android/scripts/release/GenerateChangelogs.kt.	❌
VertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/VertexAiClient.kt	No appropriate test file found for scripts/src/java/org/oppia/android/scripts/release/VertexAiClient.kt.	❌
FakeVertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/FakeVertexAiClient.kt	No appropriate test file found for scripts/src/java/org/oppia/android/scripts/release/FakeVertexAiClient.kt.	❌

To learn more, visit the Oppia Android Code Coverage wiki page

oppiabot · 2026-07-19T20:35:55Z

Hi @Sandesh282, I'm going to mark this PR as stale because it hasn't had any updates for 7 days. If no further activity occurs within 7 days, it will be automatically closed so that others can take up the issue.
If you are still working on this PR, please make a follow-up commit within 3 days (and submit it for review, if applicable). Please also let us know if you are stuck so we can help you! If you're unsure how to reassign this PR to a reviewer, please make sure to review the wiki page that details the Guidance on submitting PRs.

github-actions · 2026-07-21T11:23:36Z

Coverage Report

Results

Number of files assessed: 11
Overall Coverage: 94.11%
Coverage Analysis: PASS ✅

Passing coverage

Files with passing code coverage

File	Coverage	Lines Hit	Status	Min Required
UploadBinaryToPlayConsole.kt scripts/src/java/org/oppia/android/scripts/release/UploadBinaryToPlayConsole.kt	99.00%	99 / 100	✅	70%
CloudKmsSigner.kt scripts/src/java/org/oppia/android/scripts/release/CloudKmsSigner.kt	96.25%	77 / 80	✅	70%
FakePlayConsoleClient.kt scripts/src/java/org/oppia/android/scripts/release/FakePlayConsoleClient.kt	100.00%	53 / 53	✅	70%
PlayConsoleService.kt scripts/src/java/org/oppia/android/scripts/release/remote/PlayConsoleService.kt	100.00%	2 / 2	✅	70%
VersionInversionChecker.kt scripts/src/java/org/oppia/android/scripts/release/VersionInversionChecker.kt	100.00%	39 / 39	✅	70%
GooglePlayConsoleClient.kt scripts/src/java/org/oppia/android/scripts/release/GooglePlayConsoleClient.kt	96.55%	84 / 87	✅	70%
GenerateChangelogs.kt scripts/src/java/org/oppia/android/scripts/release/GenerateChangelogs.kt	88.26%	203 / 230	✅	70%
GoogleVertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/GoogleVertexAiClient.kt	92.59%	50 / 54	✅	70%

Exempted coverage

Files exempted from coverage

File	Exemption Reason
FakeVertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/FakeVertexAiClient.kt	This file is exempted from having a test file; skipping coverage check.
VertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/VertexAiClient.kt	This file is exempted from having a test file; skipping coverage check.
PlayConsoleClient.kt scripts/src/java/org/oppia/android/scripts/release/PlayConsoleClient.kt	This file is exempted from having a test file; skipping coverage check.

Refer test_file_exemptions.textproto for the comprehensive list of file exemptions and their required coverage percentages.

To learn more, visit the Oppia Android Code Coverage wiki page

…face

github-actions · 2026-07-21T18:42:08Z

Coverage Report

Results

Number of files assessed: 11
Overall Coverage: 94.22%
Coverage Analysis: PASS ✅

Passing coverage

Files with passing code coverage

File	Coverage	Lines Hit	Status	Min Required
FakeVertexAiClient.kt scripts/src/javatests/org/oppia/android/scripts/release/FakeVertexAiClient.kt	100.00%	13 / 13	✅	70%
UploadBinaryToPlayConsole.kt scripts/src/java/org/oppia/android/scripts/release/UploadBinaryToPlayConsole.kt	99.00%	99 / 100	✅	70%
CloudKmsSigner.kt scripts/src/java/org/oppia/android/scripts/release/CloudKmsSigner.kt	96.25%	77 / 80	✅	70%
FakePlayConsoleClient.kt scripts/src/java/org/oppia/android/scripts/release/FakePlayConsoleClient.kt	100.00%	53 / 53	✅	70%
PlayConsoleService.kt scripts/src/java/org/oppia/android/scripts/release/remote/PlayConsoleService.kt	100.00%	2 / 2	✅	70%
VersionInversionChecker.kt scripts/src/java/org/oppia/android/scripts/release/VersionInversionChecker.kt	100.00%	39 / 39	✅	70%
GooglePlayConsoleClient.kt scripts/src/java/org/oppia/android/scripts/release/GooglePlayConsoleClient.kt	96.55%	84 / 87	✅	70%
GenerateChangelogs.kt scripts/src/java/org/oppia/android/scripts/release/GenerateChangelogs.kt	88.26%	203 / 230	✅	70%
GoogleVertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/GoogleVertexAiClient.kt	92.59%	50 / 54	✅	70%

Exempted coverage

Files exempted from coverage

File	Exemption Reason
VertexAiClient.kt scripts/src/java/org/oppia/android/scripts/release/VertexAiClient.kt	This file is exempted from having a test file; skipping coverage check.
PlayConsoleClient.kt scripts/src/java/org/oppia/android/scripts/release/PlayConsoleClient.kt	This file is exempted from having a test file; skipping coverage check.

Refer test_file_exemptions.textproto for the comprehensive list of file exemptions and their required coverage percentages.

To learn more, visit the Oppia Android Code Coverage wiki page

Sandesh282 added 4 commits July 6, 2026 19:15

Fix: remove unused kt_jvm_binary from release/BUILD.bazel load statement

0bf63b8

Sandesh282 requested review from BenHenning and adhiamboperes July 12, 2026 20:02

Sandesh282 assigned BenHenning and adhiamboperes Jul 12, 2026

Sandesh282 requested review from a team as code owners July 12, 2026 20:02

minor fix

9814e60

oppiabot Bot added the stale Corresponds to items that haven't seen a recent update and may be automatically closed. label Jul 19, 2026

Add unit tests for GenerateChangelogs script

a07aac8

oppiabot Bot removed the stale Corresponds to items that haven't seen a recent update and may be automatically closed. label Jul 20, 2026

Sandesh282 added 4 commits July 21, 2026 00:30

Fix mutable companion apiBaseUrl; add GoogleVertexAiClientTest

368ffc3

Add gh pr create arg assertions to GenerateChangelogsTest

c6af637

Fix ktlint blank line violations in GenerateChangelogsTest

510cb3e

Exempt VertexAiClient and FakeVertexAiClient from test file check

3161be3

Sandesh282 added 2 commits July 21, 2026 19:38

Move FakeVertexAiClient to src/javatests; exempt VertexAiClient inter…

e6bac62

…face

Fix buildifier blank lines in release BUILD.bazel

6ee5859

Sandesh282 assigned Sandesh282 and unassigned BenHenning and adhiamboperes Jul 21, 2026

Add FakeVertexAiClientTest to satisfy test file presence check

f583f28

Sandesh282 assigned adhiamboperes Jul 21, 2026

Sandesh282 removed their assignment Jul 21, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Fix part of #6106: Implement GenerateChangelogs script with Vertex AI integration#6313

Fix part of #6106: Implement GenerateChangelogs script with Vertex AI integration#6313
Sandesh282 wants to merge 13 commits into
developfrom
pr2.1/generate-changelogs-script

Sandesh282 commented Jul 12, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 12, 2026 •

edited

Loading

Review skipped

Uh oh!

Sandesh282 commented Jul 12, 2026

Uh oh!

github-actions Bot commented Jul 12, 2026

Uh oh!

oppiabot Bot commented Jul 19, 2026

Uh oh!

github-actions Bot commented Jul 21, 2026

Uh oh!

github-actions Bot commented Jul 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Sandesh282 commented Jul 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Explanation

Files modified

Files created

Essential Checklist

Uh oh!

coderabbitai Bot commented Jul 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

Sandesh282 commented Jul 12, 2026

Uh oh!

github-actions Bot commented Jul 12, 2026

Coverage Report

Results

Failure Cases

Uh oh!

oppiabot Bot commented Jul 19, 2026

Uh oh!

github-actions Bot commented Jul 21, 2026

Coverage Report

Results

Passing coverage

Exempted coverage

Uh oh!

github-actions Bot commented Jul 21, 2026

Coverage Report

Results

Passing coverage

Exempted coverage

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Sandesh282 commented Jul 12, 2026 •

edited

Loading

coderabbitai Bot commented Jul 12, 2026 •

edited

Loading