From 4d92eefed5e66ca465521c2d792a254b2c3f93cb Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Fri, 17 Oct 2025 16:17:25 +0530
Subject: [PATCH 1/2] docs: include mirror changelog info in developer docs

---
 DEVELOPER.md | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/DEVELOPER.md b/DEVELOPER.md
index 47e6831..986b7f6 100644
--- a/DEVELOPER.md
+++ b/DEVELOPER.md
@@ -97,7 +97,40 @@ The primary maintainers for this repository are defined in the
 
 ### Releasing
 
-The release process is automated using `release-please`.
+The release process is automated using `release-please`. It consists of an automated changelog preparation step followed by the manual merging of a Release PR.
+
+#### Automated Changelog Enrichment
+
+Before a Release PR is even created, a special workflow automatically mirrors relevant changelogs from the core `googleapis/genai-toolbox` dependency. This ensures that the release notes for this extension accurately reflect important upstream changes.
+
+The process is handled by the [`mirror-changelog.yml`](.github/workflows/mirror-changelog.yml) workflow:
+
+1. **Trigger:** The workflow runs automatically on pull requests created by
+   Renovate for `toolbox` version updates.
+2. **Parsing:** It reads the detailed release notes that Renovate includes in
+   the PR body.
+3. **Filtering:** A Node.js script located at
+   [`.github/scripts/mirror-changelog.js`](.github/scripts/mirror-changelog.js)
+   filters these release notes to include only changes relevant to this
+   extension. The relevance is determined by a keyword (e.g., `alloydb`), passed
+   as an environment variable in the workflow file.
+4. **Changelog Injection:** The script formats the filtered entries as
+   conventional commits and injects them into the PR body within a
+   `BEGIN_COMMIT_OVERRIDE` block.
+5. **Release Please:** When the main Release PR is created, `release-please`
+   reads this override block instead of the standard `chore(deps): ...` commit
+   message, effectively mirroring the filtered upstream changelog into this
+   project's release notes.
+
+> **Note for Maintainers:** The filtering script is an automation aid, but it
+> may occasionally produce "false positives" (e.g., an internal logging change
+> that happens to contain the keyword). Before merging a `toolbox` dependency
+> PR, maintainers must **review the generated `BEGIN_COMMIT_OVERRIDE` block**
+> and manually delete any lines that are not relevant to the end-users of this
+> extension. The curated override block is the final source of truth for the
+> release changelog.
+
+#### Release Process
 
 1.  **Release PR:** When commits with conventional commit headers (e.g., `feat:`,
     `fix:`) are merged into the `main` branch, `release-please` will

From eaca5dd9c90a7c96b715f24435830bd7fff332d7 Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Fri, 17 Oct 2025 16:21:31 +0530
Subject: [PATCH 2/2] Update DEVELOPER.md

---
 DEVELOPER.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/DEVELOPER.md b/DEVELOPER.md
index 986b7f6..eab2fd9 100644
--- a/DEVELOPER.md
+++ b/DEVELOPER.md
@@ -112,7 +112,7 @@ The process is handled by the [`mirror-changelog.yml`](.github/workflows/mirror-
 3. **Filtering:** A Node.js script located at
    [`.github/scripts/mirror-changelog.js`](.github/scripts/mirror-changelog.js)
    filters these release notes to include only changes relevant to this
-   extension. The relevance is determined by a keyword (e.g., `alloydb`), passed
+   extension. The relevance is determined by a keyword (e.g., `bigquery`), passed
    as an environment variable in the workflow file.
 4. **Changelog Injection:** The script formats the filtered entries as
    conventional commits and injects them into the PR body within a