DEVX-136: feat: add fix_pr_title module and update_pr API method

tests/unit/test_release.py

@@ -952,22 +952,32 @@ class TestMain:
     verify specific git call sequences mock run_cmd with side_effect.
     """
 
+    @patch("devx.ci.release.has_user_facing_changes", return_value=False)
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.run_cmd")
-    def test_not_on_master_exits(self, mock_run_cmd: MagicMock) -> None:
+    def test_not_on_master_exits(
+        self, mock_run_cmd: MagicMock, mock_update_docs: MagicMock, mock_ufc: MagicMock
+    ) -> None:
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="feature-branch\n", stderr="")
         runner = CliRunner()
         result = runner.invoke(main, [])
         assert result.exit_code != 0
         assert "master" in result.output
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.get_latest_tag", return_value="v0.5.0")
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.has_user_facing_changes", return_value=False)
     @patch("devx.ci.release.run_cmd")
     def test_dry_run_on_non_master_warns(
-        self, mock_run_cmd: MagicMock, mock_uf: MagicMock, mock_vtc: MagicMock, mock_glt: MagicMock
+        self,
+        mock_run_cmd: MagicMock,
+        mock_uf: MagicMock,
+        mock_vtc: MagicMock,
+        mock_glt: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         """Dry-run mode should not fail on non-master branches."""
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="feature-branch\n", stderr="")
@@ -976,6 +986,7 @@ class TestMain:
         assert result.exit_code == 0
         assert "Dry-run mode" in result.output
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.get_head_commit", return_value="abc123")
     @patch("devx.ci.release.get_tag_commit", return_value="abc123")
@@ -991,6 +1002,7 @@ class TestMain:
         mock_vtc: MagicMock,
         mock_tc: MagicMock,
         mock_hc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         """If HEAD is a release commit and the tag exists, skip."""
         mock_run_cmd.side_effect = [
@@ -1004,6 +1016,7 @@ class TestMain:
         assert "already a release commit" in result.output
         assert "Skipping" in result.output
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.get_head_commit", return_value="def456")
     @patch("devx.ci.release.get_tag_commit", return_value="abc123")
@@ -1019,6 +1032,7 @@ class TestMain:
         mock_vtc: MagicMock,
         mock_tc: MagicMock,
         mock_hc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         """If HEAD is a release commit but tag points elsewhere, error."""
         mock_run_cmd.side_effect = [
@@ -1031,6 +1045,8 @@ class TestMain:
         assert result.exit_code != 0
         assert "misalignment" in result.output
 
+    @patch("devx.ci.release.has_user_facing_changes", return_value=False)
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
@@ -1044,6 +1060,8 @@ class TestMain:
         mock_changelog: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
+        mock_ufc: MagicMock,
     ) -> None:
         """If HEAD is a release commit but the tag is missing, create the tag."""
         mock_run_cmd.side_effect = [
@@ -1058,21 +1076,25 @@ class TestMain:
         assert "Recovering" in result.output
         mock_create_tag.assert_called_once_with("0.5.0", "## changelog", False)
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
     @patch("devx.ci.release.has_unreleased_changes", return_value=False)
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
+    @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.run_cmd")
     def test_no_unreleased_changes(
         self,
         mock_run_cmd: MagicMock,
+        mock_latest: MagicMock,
         mock_bumped: MagicMock,
         mock_has: MagicMock,
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")
         runner = CliRunner()
@@ -1080,6 +1102,7 @@ class TestMain:
         assert result.exit_code == 0
         assert "No unreleased changes" in result.output
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
@@ -1105,6 +1128,7 @@ class TestMain:
         mock_tag: MagicMock,
         mock_user: MagicMock,
         mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         """Empty changelog should fail, not warn."""
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")
@@ -1113,6 +1137,7 @@ class TestMain:
         assert result.exit_code != 0
         assert "empty changelog" in result.output.lower()
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
@@ -1138,6 +1163,7 @@ class TestMain:
         mock_tag: MagicMock,
         mock_user: MagicMock,
         mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")
         runner = CliRunner()
@@ -1149,6 +1175,7 @@ class TestMain:
         mock_commit.assert_not_called()
         mock_tag.assert_not_called()
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
@@ -1162,6 +1189,7 @@ class TestMain:
         mock_latest: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         """Release is skipped when only workflow/infrastructure files changed."""
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")
@@ -1171,11 +1199,11 @@ class TestMain:
         assert "No user-facing changes" in result.output
         assert "Skipping release" in result.output
 
+    @patch("devx.ci.release.run_tests")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
-    @patch("devx.ci.release.run_tests")
     @patch("devx.ci.release.create_and_push_tag", return_value=True)
     @patch("devx.ci.release.commit_release_changes", return_value=True)
     @patch("devx.ci.release.update_changelog")
@@ -1184,10 +1212,12 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.run_cmd")
     def test_full_flow(
         self,
         mock_run_cmd: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1196,10 +1226,10 @@ class TestMain:
         mock_update_changelog: MagicMock,
         mock_commit: MagicMock,
         mock_tag: MagicMock,
-        mock_run_tests: MagicMock,
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_run_tests: MagicMock,
     ) -> None:
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")
         runner = CliRunner()
@@ -1216,7 +1246,6 @@ class TestMain:
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
-    @patch("devx.ci.release.run_tests")
     @patch("devx.ci.release.create_and_push_tag", return_value=False)
     @patch("devx.ci.release.commit_release_changes", return_value=False)
     @patch("devx.ci.release.update_changelog")
@@ -1225,10 +1254,12 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.run_cmd")
     def test_full_flow_tag_exists(
         self,
         mock_run_cmd: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1237,7 +1268,6 @@ class TestMain:
         mock_update_changelog: MagicMock,
         mock_commit: MagicMock,
         mock_tag: MagicMock,
-        mock_run_tests: MagicMock,
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
@@ -1250,11 +1280,11 @@ class TestMain:
         assert "already existed" in result.output
         mock_tag.assert_called_once_with("0.2.0", "changelog", False)
 
+    @patch("devx.ci.release.run_tests")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
-    @patch("devx.ci.release.run_tests")
     @patch("devx.ci.release.create_and_push_tag", return_value=True)
     @patch("devx.ci.release.commit_release_changes", return_value=True)
     @patch("devx.ci.release.update_changelog")
@@ -1263,12 +1293,14 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.time.sleep")
     @patch("devx.ci.release.run_cmd")
     def test_push_retry_succeeds_after_rebase_failure(
         self,
         mock_run_cmd: MagicMock,
         mock_sleep: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1277,10 +1309,10 @@ class TestMain:
         mock_update_changelog: MagicMock,
         mock_commit: MagicMock,
         mock_tag: MagicMock,
-        mock_run_tests: MagicMock,
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_run_tests: MagicMock,
     ) -> None:
         """Push should retry after rebase failure and succeed on second attempt."""
         ok = MagicMock(returncode=0, stdout="master\n", stderr="")
@@ -1297,11 +1329,11 @@ class TestMain:
         assert "Rebase attempt 1/3 failed" in result.output
         assert "Pushed release commit to master" in result.output
 
+    @patch("devx.ci.release.run_tests")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
-    @patch("devx.ci.release.run_tests")
     @patch("devx.ci.release.create_and_push_tag", return_value=True)
     @patch("devx.ci.release.commit_release_changes", return_value=True)
     @patch("devx.ci.release.update_changelog")
@@ -1310,12 +1342,14 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.time.sleep")
     @patch("devx.ci.release.run_cmd")
     def test_push_fails_after_all_retries(
         self,
         mock_run_cmd: MagicMock,
         mock_sleep: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1324,10 +1358,10 @@ class TestMain:
         mock_update_changelog: MagicMock,
         mock_commit: MagicMock,
         mock_tag: MagicMock,
-        mock_run_tests: MagicMock,
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_run_tests: MagicMock,
     ) -> None:
         """Push should fail after 3 unsuccessful rebase attempts."""
         ok = MagicMock(returncode=0, stdout="master\n", stderr="")
@@ -1350,11 +1384,11 @@ class TestMain:
         assert result.exit_code != 0
         assert "Failed to push release commit after 3 attempts" in result.output
 
+    @patch("devx.ci.release.run_tests")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.has_user_facing_changes", return_value=True)
-    @patch("devx.ci.release.run_tests")
     @patch("devx.ci.release.create_and_push_tag", return_value=True)
     @patch("devx.ci.release.commit_release_changes", return_value=True)
     @patch("devx.ci.release.update_changelog")
@@ -1363,12 +1397,14 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.time.sleep")
     @patch("devx.ci.release.run_cmd")
     def test_push_retry_succeeds_after_push_failure(
         self,
         mock_run_cmd: MagicMock,
         mock_sleep: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1377,10 +1413,10 @@ class TestMain:
         mock_update_changelog: MagicMock,
         mock_commit: MagicMock,
         mock_tag: MagicMock,
-        mock_run_tests: MagicMock,
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_run_tests: MagicMock,
     ) -> None:
         """Push should retry after push rejection and succeed on second attempt."""
         ok = MagicMock(returncode=0, stdout="master\n", stderr="")
@@ -1397,6 +1433,7 @@ class TestMain:
         assert "Push attempt 1/3 failed" in result.output
         assert "Pushed release commit to master" in result.output
 
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=[])
     @patch("devx.ci.release.fetch_tags")
@@ -1414,6 +1451,7 @@ class TestMain:
         mock_user: MagicMock,
         mock_ft: MagicMock,
         mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
     ) -> None:
         """Release is skipped when git-cliff doesn't bump the version."""
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")
@@ -1435,10 +1473,12 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.run_cmd")
     def test_full_flow_skip_tests(
         self,
         mock_run_cmd: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1473,10 +1513,12 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.run_cmd")
     def test_tests_fail_aborts_before_tag(
         self,
         mock_run_cmd: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1517,10 +1559,12 @@ class TestMain:
     @patch("devx.ci.release.get_latest_tag", return_value="v0.1.0")
     @patch("devx.ci.release.get_bumped_version", return_value="0.2.0")
     @patch("devx.ci.release.has_unreleased_changes", return_value=True)
+    @patch("devx.ci.release.update_doc_versions")
     @patch("devx.ci.release.run_cmd")
     def test_lint_fail_aborts_before_tag(
         self,
         mock_run_cmd: MagicMock,
+        mock_update_docs: MagicMock,
         mock_has: MagicMock,
         mock_bumped: MagicMock,
         mock_latest: MagicMock,
@@ -1548,6 +1592,8 @@ class TestMain:
         mock_commit.assert_not_called()
         mock_tag.assert_not_called()
 
+    @patch("devx.ci.release.has_user_facing_changes", return_value=False)
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.get_changelog_versions", return_value=[])
     @patch("devx.ci.release.get_init_version", return_value="0.1.0")
@@ -1561,6 +1607,8 @@ class TestMain:
         mock_tags: MagicMock,
         mock_iv: MagicMock,
         mock_cv: MagicMock,
+        mock_update_docs: MagicMock,
+        mock_ufc: MagicMock,
     ) -> None:
         """--verify checks alignment and exits without releasing."""
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="", stderr="")
@@ -1569,12 +1617,19 @@ class TestMain:
         assert result.exit_code == 0
         assert "Release Alignment Verification" in result.output
 
+    @patch("devx.ci.release.has_user_facing_changes", return_value=False)
+    @patch("devx.ci.release.update_doc_versions")
     @patch.dict("os.environ", {})
     @patch("devx.ci.release.verify_tag_consistency", return_value=["  v0.1.0 → bad"])
     @patch("devx.ci.release.fetch_tags")
     @patch("devx.ci.release.run_cmd")
     def test_preflight_tag_consistency_fails(
-        self, mock_run_cmd: MagicMock, mock_ft: MagicMock, mock_vtc: MagicMock
+        self,
+        mock_run_cmd: MagicMock,
+        mock_ft: MagicMock,
+        mock_vtc: MagicMock,
+        mock_update_docs: MagicMock,
+        mock_ufc: MagicMock,
     ) -> None:
         """Pre-flight tag consistency check aborts if tags are misaligned."""
         mock_run_cmd.return_value = MagicMock(returncode=0, stdout="master\n", stderr="")