matrx-orm 3.1.82__tar.gz → 3.1.83__tar.gz

{matrx_orm-3.1.82 → matrx_orm-3.1.83}/BASE_CLASS_METHODS.md

@@ -615,6 +615,35 @@ result = await SystemWriteFailure.update_where(
 
 Tests: `packages/matrx-orm/tests/level1/test_subquery_in_filter.py`.
 
+### The INNER queryset of a `Subquery`/`Exists` is a real query too
+
+A subquery's own filters are rendered by the same rules as a top-level query:
+a **nested** `Subquery`/`Exists`/`Func` value, and a **compound or negated
+`Q`** tree, all render as SQL inside the sub-select.
+
+```python
+sessions = CodingSession.filter(created_by=uid, provider="claude_code").select("conversation_id")
+summaries = (
+    ConversationSummary.filter(user_id=uid)
+    .filter(Q(origin_class="unknown") | Q(origin_class__isnull=True))   # compound Q
+    .filter(id__in=Subquery(sessions))                                  # nested Subquery
+    .select("id")
+)
+rows = await Message.filter(conversation_id__in=Subquery(summaries)).all()
+```
+
+Before this, the inner renderer only understood flat keyword filters: a nested
+`Subquery` fell through to the scalar condition builder and emitted
+`field = ANY($n)` **with the `Subquery` object itself bound as a parameter**
+(asyncpg then raised `invalid input for query argument $n` at execute time),
+and a compound/negated `Q` raised `NotImplementedError`. Grown from the live
+failure of aidream's `conversations` tool — "search my Claude Code
+conversations" combined both shapes, so search+provider died while
+search-alone and list+provider worked. Placeholder numbering across the
+nesting is contiguous with the outer query's params.
+
+Tests: `packages/matrx-orm/tests/level1/test_subquery_nested_expressions.py`.
+
 ### `introspect_rls_policies` — pg_catalog RLS-coverage introspection
 
 `introspect_rls_policies(database, schemas, relnames)` (in

{matrx_orm-3.1.82 → matrx_orm-3.1.83}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matrx-orm
-Version: 3.1.82
+Version: 3.1.83
 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.82 → matrx_orm-3.1.83}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.82"
+version = "3.1.83"
 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" }