fix(operations): make update() methods return updated objects consistently

headline.update() and goal.update() returned None while todo.update() and
issue.update() returned the updated entity. Now all update() methods re-fetch
and return the updated object after the PUT call.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: franccesco

src/bloomy/operations/async_/goals.py

@@ -91,13 +91,31 @@ async def delete(self, goal_id: int) -> None:
         response = await self._client.delete(f"rocks/{goal_id}")
         response.raise_for_status()
 
+    async def details(self, goal_id: int) -> GoalInfo:
+        """Get details for a specific goal.
+
+        Args:
+            goal_id: The ID of the goal
+
+        Returns:
+            A GoalInfo model instance containing the goal details
+
+        """
+        response = await self._client.get(
+            f"rocks/{goal_id}", params={"include_origin": True}
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        return self._transform_goal_details(data)
+
     async def update(
         self,
         goal_id: int,
         title: str | None = None,
         accountable_user: int | None = None,
         status: GoalStatus | str | None = None,
-    ) -> None:
+    ) -> GoalInfo:
         """Update a goal.
 
         Args:
@@ -110,12 +128,17 @@ async def update(
                 GoalStatus.AT_RISK, or GoalStatus.COMPLETE for type safety.
                 Invalid values will raise ValueError via the update payload builder.
 
+        Returns:
+            A GoalInfo model instance containing the updated goal details
+
         """
         payload = self._build_goal_update_payload(accountable_user, title, status)
 
         response = await self._client.put(f"rocks/{goal_id}", json=payload)
         response.raise_for_status()
 
+        return await self.details(goal_id)
+
     async def archive(self, goal_id: int) -> None:
         """Archive a rock with the specified goal ID.
 

src/bloomy/operations/async_/headlines.py

@@ -59,18 +59,23 @@ async def create(
             notes_url=data.get("DetailsUrl") or "",
         )
 
-    async def update(self, headline_id: int, title: str) -> None:
+    async def update(self, headline_id: int, title: str) -> HeadlineDetails:
         """Update a headline.
 
         Args:
             headline_id: The ID of the headline to update
             title: The new title of the headline
 
+        Returns:
+            A HeadlineDetails model instance containing the updated headline
+
         """
         payload = {"title": title}
         response = await self._client.put(f"headline/{headline_id}", json=payload)
         response.raise_for_status()
 
+        return await self.details(headline_id)
+
     async def details(self, headline_id: int) -> HeadlineDetails:
         """Get headline details.
 

src/bloomy/operations/goals.py

@@ -124,13 +124,35 @@ def delete(self, goal_id: int) -> None:
         response = self._client.delete(f"rocks/{goal_id}")
         response.raise_for_status()
 
+    def details(self, goal_id: int) -> GoalInfo:
+        """Get details for a specific goal.
+
+        Args:
+            goal_id: The ID of the goal
+
+        Returns:
+            A GoalInfo model instance containing the goal details
+
+        Example:
+            ```python
+            client.goal.details(1)
+            # Returns: GoalInfo(id=1, title='Complete project', ...)
+            ```
+
+        """
+        response = self._client.get(f"rocks/{goal_id}", params={"include_origin": True})
+        response.raise_for_status()
+        data = response.json()
+
+        return self._transform_goal_details(data)
+
     def update(
         self,
         goal_id: int,
         title: str | None = None,
         accountable_user: int | None = None,
         status: GoalStatus | str | None = None,
-    ) -> None:
+    ) -> GoalInfo:
         """Update a goal.
 
         Args:
@@ -143,6 +165,9 @@ def update(
                 GoalStatus.AT_RISK, or GoalStatus.COMPLETE for type safety.
                 Invalid values will raise ValueError via the update payload builder.
 
+        Returns:
+            A GoalInfo model instance containing the updated goal details
+
         Example:
             ```python
             from bloomy import GoalStatus
@@ -160,6 +185,8 @@ def update(
         response = self._client.put(f"rocks/{goal_id}", json=payload)
         response.raise_for_status()
 
+        return self.details(goal_id)
+
     def archive(self, goal_id: int) -> None:
         """Archive a rock with the specified goal ID.
 

src/bloomy/operations/headlines.py

@@ -55,18 +55,23 @@ def create(
             notes_url=data.get("DetailsUrl") or "",
         )
 
-    def update(self, headline_id: int, title: str) -> None:
+    def update(self, headline_id: int, title: str) -> HeadlineDetails:
         """Update a headline.
 
         Args:
             headline_id: The ID of the headline to update
             title: The new title of the headline
 
+        Returns:
+            A HeadlineDetails model instance containing the updated headline
+
         """
         payload = {"title": title}
         response = self._client.put(f"headline/{headline_id}", json=payload)
         response.raise_for_status()
 
+        return self.details(headline_id)
+
     def details(self, headline_id: int) -> HeadlineDetails:
         """Get headline details.
 

src/bloomy/operations/mixins/goals_transform.py

@@ -51,6 +51,36 @@ def _transform_goal_list(self, data: Sequence[dict[str, Any]]) -> list[GoalInfo]
             for goal in data
         ]
 
+    def _transform_goal_details(self, data: dict[str, Any]) -> GoalInfo:
+        """Transform a single goal API response to a GoalInfo model.
+
+        Args:
+            data: The raw API response data for a single goal.
+
+        Returns:
+            A GoalInfo model.
+
+        """
+        return GoalInfo(
+            id=data["Id"],
+            user_id=data["Owner"]["Id"],
+            user_name=data["Owner"]["Name"],
+            title=data["Name"],
+            created_at=data["CreateTime"],
+            due_date=data["DueDate"],
+            status="Completed" if data.get("Complete") else "Incomplete",
+            meeting_id=(
+                data["Origins"][0]["Id"]
+                if data.get("Origins") and data["Origins"][0]
+                else None
+            ),
+            meeting_title=(
+                data["Origins"][0]["Name"]
+                if data.get("Origins") and data["Origins"][0]
+                else None
+            ),
+        )
+
     def _transform_archived_goals(
         self, data: Sequence[dict[str, Any]]
     ) -> list[ArchivedGoalInfo]: