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

{matrx_orm-3.1.82 → matrx_orm-3.1.84}/.gitignore

@@ -285,3 +285,4 @@ db/evidence/
 # Pooler contamination evidence — machine-local forensic capture, not source
 db/evidence/
 db/mirror/.env.mirror
+supabase/.temp/

{matrx_orm-3.1.82 → matrx_orm-3.1.84}/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.84}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matrx-orm
-Version: 3.1.82
+Version: 3.1.84
 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.84}/matrx_orm/python_sql/db_objects.py

@@ -110,7 +110,7 @@ def get_full_db_objects(schema, database_project):
                     'full_type', pg_catalog.format_type(a.atttypid, a.atttypmod),
                     'base_type', t.typname,
                     'domain_type', CASE WHEN t.typtype = 'd' THEN t.typname ELSE NULL END,
-                    'enum_labels', CASE WHEN t.typtype = 'e' THEN (SELECT array_agg(enumlabel) FROM pg_enum WHERE enumtypid = t.oid) ELSE NULL END,
+                    'enum_labels', CASE WHEN t.typtype = 'e' THEN (SELECT array_agg(enumlabel ORDER BY enumsortorder) FROM pg_enum WHERE enumtypid = t.oid) ELSE NULL END,
                     'is_array', a.attndims > 0,
                     'nullable', NOT a.attnotnull,
                     'default', pg_get_expr(d.adbin, d.adrelid),

{matrx_orm-3.1.82 → matrx_orm-3.1.84}/matrx_orm/schema_builder/FEATURE.md

@@ -2,6 +2,13 @@
 
 The schema builder generates importable models and manager wrappers from live database metadata.
 
+## Deterministic database metadata
+
+- PostgreSQL enum labels are emitted in `pg_enum.enumsortorder`. Introspection
+  must never rely on catalog row order; otherwise identical generator runs
+  oscillate every generated model containing that enum.
+- Guard: `packages/matrx-orm/tests/schema/test_enum_ordering.py`.
+
 ## Manager method names
 
 - A generated manager must never contain duplicate method names; later definitions silently replace earlier behavior in Python.

{matrx_orm-3.1.82 → matrx_orm-3.1.84}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "matrx-orm"
-version = "3.1.82"
+version = "3.1.84"
 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.84/tests/schema/test_enum_ordering.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+
+
+def test_schema_introspection_orders_enum_labels_by_postgres_enum_order() -> None:
+    source = (Path(__file__).parents[2] / "matrx_orm" / "python_sql" / "db_objects.py").read_text()
+
+    assert "array_agg(enumlabel ORDER BY enumsortorder)" in source
+    assert "array_agg(enumlabel) FROM pg_enum" not in source