matrx-orm 3.1.43__tar.gz → 3.1.45__tar.gz

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/.gitignore

@@ -269,3 +269,4 @@ packages/matrx-utils/matrx_utils/data_in_code/data_history.json
 !.env.example
 !.env.sample
 !.env.template
+tests_trials/rag_tests/kg_export_output/

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/BASE_CLASS_METHODS.md

@@ -67,6 +67,9 @@ The following methods are available directly from all manager classes:
 `Model.claim_batch(set_fields=..., filters=..., order_by=..., limit=...,
 returning=...)` atomically selects and updates a bounded queue batch with
 `FOR UPDATE SKIP LOCKED`, so concurrent workers neither block nor double-claim.
+Successful claims invalidate that model's identity cache before returning, so a
+worker's immediate read observes the claimed state instead of a cached
+pre-claim row.
 `filters` accepts either an equality dict or a compound `Q` tree with
 `eq`/`ne`/`gt`/`gte`/`lt`/`lte`/`in`/`isnull` lookups. Database expressions
 such as `Now()` are valid in both filters and `set_fields`.

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrx-orm
-Version: 3.1.43
+Version: 3.1.45
 Summary: Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching
 Project-URL: Homepage, https://github.com/AI-Matrix-Engine/aidream-current
 Project-URL: Repository, https://github.com/AI-Matrix-Engine/aidream-current

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/matrx_orm/operations/queue_claim.py

@@ -235,13 +235,23 @@ async def claim_batch(
 
     if connection is not None:
         rows = await connection.fetch(sql, *params)
-        return [dict(r) for r in rows]
+        claimed = [dict(r) for r in rows]
+        if claimed:
+            from matrx_orm.state import StateManager
+
+            StateManager.clear_model(model_cls)
+        return claimed
 
     from matrx_orm.core.async_db_manager import AsyncDatabaseManager
 
     config = model_cls.get_database_name()
     rows = await AsyncDatabaseManager.execute_write(config, sql, *params)
-    return [dict(r) for r in rows]
+    claimed = [dict(r) for r in rows]
+    if claimed:
+        from matrx_orm.state import StateManager
+
+        StateManager.clear_model(model_cls)
+    return claimed
 
 
 __all__ = ["claim_batch"]

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/matrx_orm/query/builder.py

@@ -312,6 +312,13 @@ class QueryBuilder(Generic[ModelT]):
         bad_fields: list[str] = []
         bad_ops: list[tuple[str, str, str]] = []  # (full_key, field, suspect_op)
         for key in kwargs:
+            if "." in key:
+                # Qualified joined-table reference ("rag.kg_chunks.source_kind"
+                # or alias "c.source_kind") — a supported filter form the
+                # executor passes through untouched (_map_field_name). It is
+                # not a field of this model, so the typo check cannot apply;
+                # Postgres validates the real column.
+                continue
             if "__" in key:
                 if key.count("__") != 1:
                     bad_fields.append(key)

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.43"
+version = "3.1.45"
 description = "Async-first PostgreSQL ORM with bidirectional migrations, schema introspection, many-to-many relationships, and built-in state caching"
 readme = "README.md"
 license = { text = "MIT" }

{matrx_orm-3.1.43 → matrx_orm-3.1.45}/tests/level1/test_queue_claim.py

@@ -20,6 +20,7 @@ import pytest
 from matrx_orm import ColumnComparison, Compare, Exists, F, Now, OuterRef, Q
 from matrx_orm.operations.queue_claim import claim_batch
 from matrx_orm.query.builder import QueryBuilder
+from matrx_orm.state import StateManager
 
 
 class _Meta:
@@ -83,6 +84,33 @@ async def test_claim_batch_plain_single_column_order_by() -> None:
     assert params == ("pending", 5, "claimed")
 
 
+@pytest.mark.asyncio
+async def test_claim_batch_invalidates_identity_cache(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    model = _make_model("workflow.job")
+    conn = _CaptureConn(rows=[{"id": "job-1"}])
+    cleared: list[type] = []
+    monkeypatch.setattr(
+        StateManager,
+        "clear_model",
+        classmethod(lambda cls, model_class: cleared.append(model_class) or 1),
+    )
+
+    rows = await claim_batch(
+        model,
+        set_fields={"status": "processing"},
+        filters={"status": "pending"},
+        order_by="created_at",
+        limit=1,
+        returning=["id"],
+        connection=conn,
+    )
+
+    assert rows == [{"id": "job-1"}]
+    assert cleared == [model]
+
+
 @pytest.mark.asyncio
 async def test_claim_batch_none_filter_renders_is_null_not_bound_equality() -> None:
     """The WHERE-NULL trap: `col = $N` with a NULL param matches NOTHING in