1.2.5 - IID-preferring Role Player Matching

- RelationManager prefers IID for role player matching (PR #91)
- Falls back to key attributes when IID not available
- Updated CHANGELOG.md and version numbers

Author: ds1sqe

CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to TypeBridge will be documented in this file.
 
+## [1.2.5] - 2026-01-31
+
+### New Features
+
+#### IID-preferring Role Player Matching (PR #91)
+- **RelationManager now prefers IID for role player matching**
+  - Uses IID for precise matching when available
+  - Falls back to key attribute matching when IID not set
+  - Raises clear `ValueError` when neither IID nor key attributes available
+  - Location: `type_bridge/crud/relation/manager.py`
+
+**Affected Methods:** `insert()`, `put()`, `update()`, `delete()` and `*_many` variants
+
+### Documentation
+
+- Updated role player matching docs in `docs/SKILL.md` and `docs/api/crud.md`
+
 ## [1.2.4] - 2026-01-30
 
 ### New Features

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "type-bridge"
-version = "1.2.4"
+version = "1.2.5"
 description = "A modern, Pythonic ORM for TypeDB with an Attribute-based API"
 readme = "README.md"
 requires-python = ">=3.13"

type_bridge/__init__.py

@@ -46,7 +46,7 @@
 from type_bridge.session import Connection, Database, TransactionContext
 from type_bridge.typedb_driver import Credentials, TransactionType, TypeDB
 
-__version__ = "1.2.3"
+__version__ = "1.2.5"
 
 __all__ = [
     # Database and session