Merge pull request #874 from atlanhq/bump-to-release-9.3.1

Bump to release `9.3.1`

Author: Aryamanz29

.claude/skills/release/SKILL.md

@@ -34,18 +34,33 @@ Confirm the new version with the user before proceeding.
 
 ### 2. Gather changes since last release
 
-Run:
+**Always gather from `origin/main`** — that's where PRs are merged. The current working branch is irrelevant here.
+
+Step 1 — find the last release commit on main and list everything since it:
+```bash
+git fetch origin main --quiet
+git log --oneline $(git log --oneline origin/main | grep "\[release\]" | head -1 | awk '{print $1}')..origin/main
+```
+
+Step 2 — extract PR numbers from merge commits and fetch details for each:
 ```bash
-git log --oneline $(git log --oneline | grep "\[release\]" | head -1 | awk '{print $1}')..HEAD
+git log --oneline $(git log --oneline origin/main | grep "\[release\]" | head -1 | awk '{print $1}')..origin/main | grep "Merge pull request" | grep -oE '#[0-9]+' | tr -d '#'
 ```
 
-This finds commits since the last `[release]` commit. If none exist, use all commits on the current branch.
+Then for each PR number, run:
+```bash
+gh pr view <number> --json title,labels,body,mergedAt
+```
 
-Also check merged PRs for additional context:
+If `gh` is not authenticated, fall back to the commit subjects alone — do NOT skip this step or silently use an empty list. Note any PRs you couldn't fetch so the user knows the notes may be incomplete.
+
+Step 3 — also run this to catch non-merge commits (direct pushes, fixups, etc.):
 ```bash
-gh pr list --state merged --base main --limit 30 --json title,labels,number,mergedAt
+git log --oneline --no-merges $(git log --oneline origin/main | grep "\[release\]" | head -1 | awk '{print $1}')..origin/main
 ```
 
+Use all of this — PR titles, PR bodies, labels, and direct commit messages — to write the release notes.
+
 ---
 
 ### 3. Draft release notes

HISTORY.md

@@ -1,3 +1,13 @@
+## 9.3.1 (March 23, 2026)
+
+### Experimental: `pyatlan_v9`
+
+- **`typedef` typing corrections and serialization fixes**: Corrected field types in `RelationshipDef` and removed hardcoded defaults (PR #867). Optional typedef fields now use `msgspec.UNSET` so they are omitted from serialization rather than emitted as `null` (PR #870). `AttributeDef.default_value` and `index_type_es_fields` relaxed to `Any` to accommodate varied server responses (PR #872). `is_rich_text` and `custom_metadata_version` now default to `UNSET` via `__post_init__` and the `category` field is no longer silently dropped by `omit_defaults` (PR #870).
+
+### QOL Improvements
+
+- **Trivy action updated to `0.35.0`**: Keeps the security scanning workflow on a stable release (PR #871).
+
 ## 9.3.0 (March 16, 2026)
 
 ### New Features

pyatlan/version.txt

@@ -1 +1 @@
-9.3.0
+9.3.1

pyatlan_v9/model/assets/_overlays/asset.py

@@ -128,12 +128,47 @@ def validate_required(self) -> None:
 
     def flush_custom_metadata(self, client=None) -> None:
         """
-        Flush (clear) all custom metadata on this asset.
+        Flush custom metadata to business_attributes.
+
+        In v9, set_custom_metadata already writes to business_attributes directly,
+        so this is a no-op for compatibility with the legacy API.
+
+        Args:
+            client: AtlanClient instance (for compatibility with legacy API)
+        """
+        pass
+
+    def get_custom_metadata(self, client, name: str):
+        """Get custom metadata by name.
+
+        Args:
+            client: AtlanClient instance
+            name: human-readable name of the custom metadata set
+
+        Returns:
+            CustomMetadataDict for the requested set
+        """
+        from pyatlan_v9.model.custom_metadata import CustomMetadataProxy
+
+        proxy = CustomMetadataProxy(
+            business_attributes=self.business_attributes, client=client
+        )
+        return proxy.get_custom_metadata(name=name)
+
+    def set_custom_metadata(self, custom_metadata, client=None) -> None:
+        """Set custom metadata on this asset.
 
         Args:
+            custom_metadata: CustomMetadataDict to set
             client: AtlanClient instance (for compatibility with legacy API)
         """
-        self.business_attributes = {}
+        from pyatlan_v9.model.custom_metadata import CustomMetadataProxy
+
+        proxy = CustomMetadataProxy(
+            business_attributes=self.business_attributes, client=client or custom_metadata._client
+        )
+        proxy.set_custom_metadata(custom_metadata=custom_metadata)
+        self.business_attributes = proxy.business_attributes
 
     async def get_custom_metadata_async(self, client, name: str):
         """Async: get custom metadata by name."""

pyatlan_v9/model/assets/asset.py

@@ -1178,12 +1178,47 @@ def validate_required(self) -> None:
 
     def flush_custom_metadata(self, client=None) -> None:
         """
-        Flush (clear) all custom metadata on this asset.
+        Flush custom metadata to business_attributes.
+
+        In v9, set_custom_metadata already writes to business_attributes directly,
+        so this is a no-op for compatibility with the legacy API.
+
+        Args:
+            client: AtlanClient instance (for compatibility with legacy API)
+        """
+        pass
+
+    def get_custom_metadata(self, client, name: str):
+        """Get custom metadata by name.
+
+        Args:
+            client: AtlanClient instance
+            name: human-readable name of the custom metadata set
+
+        Returns:
+            CustomMetadataDict for the requested set
+        """
+        from pyatlan_v9.model.custom_metadata import CustomMetadataProxy
+
+        proxy = CustomMetadataProxy(
+            business_attributes=self.business_attributes, client=client
+        )
+        return proxy.get_custom_metadata(name=name)
+
+    def set_custom_metadata(self, custom_metadata, client=None) -> None:
+        """Set custom metadata on this asset.
 
         Args:
+            custom_metadata: CustomMetadataDict to set
             client: AtlanClient instance (for compatibility with legacy API)
         """
-        self.business_attributes = {}
+        from pyatlan_v9.model.custom_metadata import CustomMetadataProxy
+
+        proxy = CustomMetadataProxy(
+            business_attributes=self.business_attributes, client=client or custom_metadata._client
+        )
+        proxy.set_custom_metadata(custom_metadata=custom_metadata)
+        self.business_attributes = proxy.business_attributes
 
     async def get_custom_metadata_async(self, client, name: str):
         """Async: get custom metadata by name."""

pyatlan_v9/model/custom_metadata.py

@@ -119,7 +119,10 @@ def __init__(
         self._metadata: Union[dict[str, CustomMetadataDict], None] = None
         self._business_attributes = business_attributes
         self._modified = False
-        if self._business_attributes is None:
+        if self._business_attributes is None or not isinstance(
+            self._business_attributes, dict
+        ):
+            self._business_attributes = None
             return
         self._metadata = {}
         for cm_id, cm_attributes in self._business_attributes.items():

tests_v9/integration/custom_metadata_test.py

@@ -849,7 +849,7 @@ def test_search_by_any_accountable(
         assert isinstance(t, AtlasGlossaryTerm)
         assert t.guid == term.guid
         assert t.qualified_name == term.qualified_name
-        anchor = t.attributes.anchor
+        anchor = t.anchor
         assert anchor
         assert anchor.name == glossary.name
         _validate_raci_attributes_replacement(
@@ -890,7 +890,7 @@ def test_search_by_specific_accountable(
         assert isinstance(t, AtlasGlossaryTerm)
         assert t.guid == term.guid
         assert t.qualified_name == term.qualified_name
-        anchor = t.attributes.anchor
+        anchor = t.anchor
         assert anchor
         assert anchor.name == glossary.name