chore(regen): automate ClientOptions patch reapply

Author: GregHolmes

.claude/scripts/fix_clientoptions.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+
+import json
+import re
+import sys
+from pathlib import Path
+
+
+CLIENT_OPTIONS_PATH = Path("src/main/java/com/deepgram/core/ClientOptions.java")
+CLIENT_OPTIONS_BAK_PATH = Path("src/main/java/com/deepgram/core/ClientOptions.java.bak")
+BUILD_GRADLE_PATH = Path("build.gradle")
+METADATA_PATH = Path(".fern/metadata.json")
+SDK_NAME = "com.deepgram:deepgram-java-sdk"
+
+
+def load_sdk_version(text: str) -> str:
+    if CLIENT_OPTIONS_BAK_PATH.exists():
+        bak_text = CLIENT_OPTIONS_BAK_PATH.read_text()
+        match = re.search(r'put\("X-Fern-SDK-Version",\s*"([^"]+)"\)', bak_text)
+        if match:
+            return match.group(1)
+
+        match = re.search(r'put\("User-Agent",\s*"[^"]*/([^"]+)"\)', bak_text)
+        if match:
+            return match.group(1)
+
+    if BUILD_GRADLE_PATH.exists():
+        build_gradle = BUILD_GRADLE_PATH.read_text()
+        match = re.search(r"^version\s*=\s*'([^']+)'", build_gradle, re.MULTILINE)
+        if match:
+            return match.group(1)
+
+    match = re.search(r'put\("X-Fern-SDK-Version",\s*"([^"]+)"\)', text)
+    if match:
+        return match.group(1)
+
+    match = re.search(r'put\("User-Agent",\s*"[^"]*/([^"]+)"\)', text)
+    if match:
+        return match.group(1)
+
+    if METADATA_PATH.exists():
+        metadata = json.loads(METADATA_PATH.read_text())
+        sdk_version = metadata.get("sdkVersion")
+        if sdk_version:
+            return sdk_version
+
+    raise RuntimeError("Unable to determine SDK version for ClientOptions.java")
+
+
+def replace_header_line(
+    text: str, key: str, value: str, add_release_please: bool
+) -> str:
+    pattern = re.compile(
+        rf'^(?P<indent>\s*)put\("{re.escape(key)}",\s*"[^"]*"\);(?:\s*// x-release-please-version)?\s*$',
+        re.MULTILINE,
+    )
+
+    def repl(match: re.Match[str]) -> str:
+        suffix = " // x-release-please-version" if add_release_please else ""
+        return f'{match.group("indent")}put("{key}", "{value}");{suffix}'
+
+    updated_text, count = pattern.subn(repl, text, count=1)
+    if count != 1:
+        raise RuntimeError(f"Unable to locate header line for {key}")
+    return updated_text
+
+
+def main() -> int:
+    if not CLIENT_OPTIONS_PATH.exists():
+        raise RuntimeError(f"File not found: {CLIENT_OPTIONS_PATH}")
+
+    original_text = CLIENT_OPTIONS_PATH.read_text()
+    sdk_version = load_sdk_version(original_text)
+
+    updated_text = original_text
+    updated_text = replace_header_line(
+        updated_text,
+        "User-Agent",
+        f"{SDK_NAME}/{sdk_version}",
+        add_release_please=True,
+    )
+    updated_text = replace_header_line(
+        updated_text,
+        "X-Fern-SDK-Name",
+        SDK_NAME,
+        add_release_please=False,
+    )
+    updated_text = replace_header_line(
+        updated_text,
+        "X-Fern-SDK-Version",
+        sdk_version,
+        add_release_please=True,
+    )
+
+    if updated_text != original_text:
+        CLIENT_OPTIONS_PATH.write_text(updated_text)
+        print(f"Updated {CLIENT_OPTIONS_PATH} to {SDK_NAME}/{sdk_version}")
+    else:
+        print(
+            f"{CLIENT_OPTIONS_PATH} already has the expected Deepgram header constants"
+        )
+
+    return 0
+
+
+if __name__ == "__main__":
+    try:
+        raise SystemExit(main())
+    except Exception as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        raise SystemExit(1)

.claude/skills/review-regen.md

@@ -14,7 +14,7 @@ Read AGENTS.md for full context on the regeneration workflow and freeze classifi
     - Patches still needed (must be re-applied)
     - New changes from the generator worth noting
 5. Wait for user direction on which patches to re-apply.
-6. Re-apply confirmed patches to the generated files.
+6. Re-apply confirmed patches to the generated files. If `src/main/java/com/deepgram/core/ClientOptions.java` was regenerated, run `python3 .claude/scripts/fix_clientoptions.py` to restore the Deepgram SDK header constants and `// x-release-please-version` markers.
 7. In `.fernignore`, replace each `.bak` path back to the original path for files that still need patches.
 8. Remove `.fernignore` entries entirely for files where patches are no longer needed.
 9. Delete all `.bak` files.

AGENTS.md

@@ -47,7 +47,7 @@ How to identify:
 
 Current temporarily frozen files:
 
-- `src/main/java/com/deepgram/core/ClientOptions.java` - preserves release-please version markers and correct SDK header constants that Fern currently overwrites
+- `src/main/java/com/deepgram/core/ClientOptions.java` - preserves release-please version markers and correct SDK header constants that Fern currently overwrites; re-apply with `python3 .claude/scripts/fix_clientoptions.py` during review regen
 
 ### Prepare repo for regeneration
 
@@ -66,7 +66,7 @@ Current temporarily frozen files:
 The `.bak` files are our manually patched versions protected by `.fernignore`. The original paths now contain the freshly generated versions. By comparing the two, we can see what the generator now produces versus what we had patched.
 
 1. Diff each `.bak` file against the new generated version to understand what changed and whether our patches are still needed.
-2. Re-apply any patches that are still necessary to the newly generated files.
+2. Re-apply any patches that are still necessary to the newly generated files. For `src/main/java/com/deepgram/core/ClientOptions.java`, run `python3 .claude/scripts/fix_clientoptions.py` to restore the Deepgram SDK header constants and `// x-release-please-version` markers.
 3. In `.fernignore`, replace each `.bak` path back to the original path for files that still need patches.
 4. Remove `.fernignore` entries entirely for any files where the generator now produces correct output.
 5. Delete all `.bak` files once review is complete.