ferro-orm 0.12.2__tar.gz → 0.13.0__tar.gz

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/.github/workflows/ci.yml

@@ -3,9 +3,8 @@ name: CI
 on:
   workflow_call:
   pull_request:
-    branches: [main, feat/ir-first]
   push:
-    branches: [main, feat/ir-first]
+    branches: [main]
   workflow_dispatch:
 
 concurrency:

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/AGENTS.md

@@ -91,7 +91,7 @@ If you add a new schema feature (e.g. partial indexes, exclusion constraints):
 2. Implement it in **both** the Alembic and Rust paths in the same PR.
 3. Add a parity test that asserts the names match.
 4. Do not edit `CHANGELOG.md` manually — release tooling records entries at
-   release time (see I-11).
+   release time (see I-10).
 
 ---
 
@@ -151,17 +151,7 @@ See `docs/solutions/README.md` for the frontmatter conventions.
 
 ---
 
-## I-6: No AI attribution in commits or PRs
-
-Never sign commits or pull requests with AI/agent attribution. No
-`Co-Authored-By: Claude ...` trailers, no "Generated with Claude Code"
-footers, no robot emoji bylines — in commit messages, PR titles, or PR
-bodies. This applies even when an agent's default behavior is to add them:
-this rule overrides those defaults for this repository.
-
----
-
-## I-7: No stop-gap solutions
+## I-6: No stop-gap solutions
 
 Every feature, bug fix, and improvement must be designed as the best,
 well-thought-out solution for the project with the library's future in
@@ -194,7 +184,7 @@ agent default that biases toward minimal or expedient changes.
 
 ---
 
-## I-8: Docs examples show both field-declaration styles
+## I-7: Docs examples show both field-declaration styles
 
 Ferro supports two equivalent ways to declare model fields: assignment
 (`name: str = Field(unique=True)`) and `Annotated` metadata
@@ -232,18 +222,20 @@ preferred declaration style.
 
 ---
 
-## I-9: Lambda predicates are the official query style
+## I-8: Lambda predicates are the official query style
 
 Documentation and examples use the lambda predicate style for all queries:
 
 ```python
-adults = await User.where(lambda t: t.age >= 18).all()
+adults = await User.where(lambda user: user.age >= 18).all()
 ```
 
 Rules:
 
 - **Every query example** in docs, docstring `Examples:` sections, and
   `docs/examples/` scripts uses lambda predicates.
+- Name the lambda parameter after the model in **lowercase singular**
+  (`user` for `User`, `post` for `Post`) so filters read naturally.
 - When the predicate styles themselves are documented, present them in
   order **lambda > `col()` > operator**, with lambda labeled the officially
   recommended style.
@@ -262,7 +254,7 @@ else uses lambda without restating the trade-offs.
 
 ---
 
-## I-10: PRs must close scoped issues explicitly
+## I-9: PRs must close scoped issues explicitly
 
 Issue closure is part of feature completion, not optional cleanup.
 
@@ -280,7 +272,7 @@ Rules:
 
 ---
 
-## I-11: Do not edit CHANGELOG.md manually
+## I-10: Do not edit CHANGELOG.md manually
 
 `CHANGELOG.md` is updated automatically by the release workflow (semantic
 release / release tooling). Agents and contributors must **not** add,
@@ -295,3 +287,29 @@ What to do instead:
 If release tooling fails to capture a change, fix the release configuration or
 commit message conventions — do not patch `CHANGELOG.md` by hand in ordinary
 PRs.
+
+---
+
+## I-11: Explain technical concepts in plain language, example-first
+
+When explaining a concept, design, trade-off, or change to the maintainer, lead
+with plain language and a concrete, user-facing example — not internal function
+names and call graphs.
+
+Rules:
+
+- **Anchor on what the user sees.** Show a real model definition and the SQL (or
+  behavior) it produces, then explain the internal mechanics against that
+  anchor. "A `datetime` field becomes `timestamptz` — here's the `CREATE TABLE`"
+  beats "`canonical_from_parts` maps the logical type."
+- **Introduce jargon only after the plain version.** Function and type names are
+  precise back-references once the idea is clear — not the primary explanation.
+- **Use analogies for architecture.** "Two translation dictionaries that must
+  agree by hand" communicates a duplication smell faster than a module diagram.
+- **Show, don't just tell.** Prefer before/after diffs, rendered SQL, and
+  concrete values over abstract prose (complements the show-don't-tell habit
+  used in issue/PR explanations).
+
+This applies to brainstorming, design discussions, PR descriptions, issue
+comments, and any explanation directed at the maintainer. It governs how work is
+communicated, not what gets built.

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/CHANGELOG.md

@@ -1,6 +1,106 @@
 # CHANGELOG
 
 
+## v0.13.0 (2026-07-02)
+
+### Bug Fixes
+
+- **ir-p8.6**: Datetime/timestamptz coarseness — stop silent Postgres column reinterpretation (#154)
+  ([#167](https://github.com/syn54x/ferro-orm/pull/167),
+  [`7182a57`](https://github.com/syn54x/ferro-orm/commit/7182a5744900abe7ed50915edbca7d5184b2c535))
+
+- **ir-p8.6**: Stop false-positive BLOB drift warning on SQLite (#165)
+  ([#168](https://github.com/syn54x/ferro-orm/pull/168),
+  [`d554ac4`](https://github.com/syn54x/ferro-orm/commit/d554ac4558286106bcb0908baec9fa3d49a2781d))
+
+- **ir-p8.6**: Surface real PEP 649 deferred-annotation error (#155)
+  ([#163](https://github.com/syn54x/ferro-orm/pull/163),
+  [`00976e7`](https://github.com/syn54x/ferro-orm/commit/00976e748d86246b8be47230229d19516d8bb3c0))
+
+### Documentation
+
+- Use model-named lambda predicates in examples
+  ([#132](https://github.com/syn54x/ferro-orm/pull/132),
+  [`420ca6e`](https://github.com/syn54x/ferro-orm/commit/420ca6e1cb4a90d1acc556a83373c9da99b22bb3))
+
+- **agents**: Add I-11 — explain concepts plainly, example-first
+  ([`efc7ef5`](https://github.com/syn54x/ferro-orm/commit/efc7ef5678e2f6efacaa3a6e84c0575b0cdef51c))
+
+- **ir-first**: Add Phase 8.6 post-8.5 cleanup backlog (epic #145)
+  ([#147](https://github.com/syn54x/ferro-orm/pull/147),
+  [`e57b74b`](https://github.com/syn54x/ferro-orm/commit/e57b74b397bd51ebc4809f25d57536896540b9de))
+
+- **ir-first**: Expand #144 scope — auto-migrate index/unique reconciliation
+  ([#150](https://github.com/syn54x/ferro-orm/pull/150),
+  [`fdbac40`](https://github.com/syn54x/ferro-orm/commit/fdbac4003e9bd25fdc3f3cb0012c5dd9d562ee68))
+
+- **ir-first**: Lowering-consolidation audit + Phase 8.5
+  ([#138](https://github.com/syn54x/ferro-orm/pull/138),
+  [`c6ce53c`](https://github.com/syn54x/ferro-orm/commit/c6ce53c2409a1fd20a40c1de58d42e1e3d2e1344))
+
+- **ir-p8.6**: Add #153 create-path IR unification spec
+  ([`be4bb99`](https://github.com/syn54x/ferro-orm/commit/be4bb99b90e6d02a6e01bfc5807a7cb178055862))
+
+- **ir-p8.6**: Add #153 create-path unification implementation plan
+  ([`de3c427`](https://github.com/syn54x/ferro-orm/commit/de3c42794de821d8e47eb5ca94b582f8199992df))
+
+- **ir-p8.6**: Sync roadmap — #153 merged, file #158 (db_check check-renderer)
+  ([`62c80fa`](https://github.com/syn54x/ferro-orm/commit/62c80fa3fe7ac456169d280f3ee8795feac32a8c))
+
+- **ir-p8.6**: Sync roadmap — #154 merged (datetime/timestamptz warn-and-skip); #145 now 6/7
+  ([`31dbbb6`](https://github.com/syn54x/ferro-orm/commit/31dbbb6c0f1d3afa0ed452ed9ae34441df69c501))
+
+- **ir-p8.6**: Sync roadmap — #162 merged (typed save/update bind), file #165
+  ([`5ca76a1`](https://github.com/syn54x/ferro-orm/commit/5ca76a1e177f4847ded4fb19402841a9988b62d1))
+
+- **ir-p8.6**: Sync roadmap — #165 merged (BLOB introspection); #145 complete 7/7, Phase 8.6 wrapped
+  ([`1dbb278`](https://github.com/syn54x/ferro-orm/commit/1dbb27864881d77a68d5026ab5a9bb07f142c3c5))
+
+- **rust**: Add detailed docstrings for all public APIs
+  ([#130](https://github.com/syn54x/ferro-orm/pull/130),
+  [`8d5a951`](https://github.com/syn54x/ferro-orm/commit/8d5a95162568eef215ba03524a31b657df87e8c6))
+
+### Features
+
+- Ir cutover ([#137](https://github.com/syn54x/ferro-orm/pull/137),
+  [`0509c2a`](https://github.com/syn54x/ferro-orm/commit/0509c2a35b0f0200492143a52563146359550129))
+
+- **ir-p8.6**: Route save/update/bulk value bind through the typed codec path (#162)
+  ([#166](https://github.com/syn54x/ferro-orm/pull/166),
+  [`486e68c`](https://github.com/syn54x/ferro-orm/commit/486e68c110c03356fa579051849b44e8f4eae751))
+
+### Refactoring
+
+- Lowering consolidation & single-source-of-truth closeout (#139)
+  ([#156](https://github.com/syn54x/ferro-orm/pull/156),
+  [`f76bec9`](https://github.com/syn54x/ferro-orm/commit/f76bec93651bc9741bea85171da927ddb8864a1a))
+
+- Unify the CREATE TABLE path onto the Python SchemaIR (#153)
+  ([#157](https://github.com/syn54x/ferro-orm/pull/157),
+  [`c9ce7b0`](https://github.com/syn54x/ferro-orm/commit/c9ce7b093fde350da8a1653cf7c42f522e0523b2))
+
+- Unify the three dialect enums into one shared Dialect (#146)
+  ([#159](https://github.com/syn54x/ferro-orm/pull/159),
+  [`4b0dfe6`](https://github.com/syn54x/ferro-orm/commit/4b0dfe6b9eca1a2a63631a54504c629f42f7c5e1))
+
+- **ir-p8.6**: Single check-renderer for db_check (#158)
+  ([#161](https://github.com/syn54x/ferro-orm/pull/161),
+  [`c04df1c`](https://github.com/syn54x/ferro-orm/commit/c04df1ce5aa4505f737864944855ff4170a4d350))
+
+
+## v0.12.3 (2026-06-24)
+
+### Bug Fixes
+
+- **session**: Reject close while transactions are active
+  ([#128](https://github.com/syn54x/ferro-orm/pull/128),
+  [`e46f183`](https://github.com/syn54x/ferro-orm/commit/e46f183fba7a3bcbc635f7e66502a77aeb56861d))
+
+- **session**: Serialize concurrent close teardown
+  ([#129](https://github.com/syn54x/ferro-orm/pull/129),
+  [`7afa616`](https://github.com/syn54x/ferro-orm/commit/7afa6168abd2eb19b564fc1c2ab9956e03a20fe9))
+
+
 ## v0.12.2 (2026-06-23)
 
 ### Bug Fixes

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/Cargo.lock

@@ -288,9 +288,10 @@ dependencies = [
 
 [[package]]
 name = "ferro"
-version = "0.12.2"
+version = "0.13.0"
 dependencies = [
  "dashmap",
+ "ferro-ddl-lowering",
  "ferro-migrate",
  "ferro-schema-ir",
  "once_cell",
@@ -304,11 +305,23 @@ dependencies = [
  "uuid",
 ]
 
+[[package]]
+name = "ferro-ddl-lowering"
+version = "0.1.0"
+dependencies = [
+ "ferro-schema-ir",
+ "sea-query",
+ "serde_json",
+]
+
 [[package]]
 name = "ferro-migrate"
 version = "0.1.0"
 dependencies = [
+ "ferro-ddl-lowering",
  "ferro-schema-ir",
+ "sea-query",
+ "serde_json",
 ]
 
 [[package]]
@@ -712,9 +725,9 @@ checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
 
 [[package]]
 name = "js-sys"
-version = "0.3.102"
+version = "0.3.103"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "03d04c30968dffe80775bd4d7fb676131cd04a1fb46d2686dbffbaec2d9dfd31"
+checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
 dependencies = [
  "cfg-if",
  "futures-util",
@@ -744,14 +757,14 @@ checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
 
 [[package]]
 name = "libredox"
-version = "0.1.17"
+version = "0.1.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f02ab6bace2054fb888a3c16f990117b579d14a3088e472d63c6011fa185c9d3"
+checksum = "c943259e342f1e06ff2da7a83eabdfe7f92ce10262688dbf1895ff0b3e6e4652"
 dependencies = [
  "bitflags",
  "libc",
  "plain",
- "redox_syscall 0.8.1",
+ "redox_syscall 0.9.0",
 ]
 
 [[package]]
@@ -1120,9 +1133,9 @@ dependencies = [
 
 [[package]]
 name = "redox_syscall"
-version = "0.8.1"
+version = "0.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b44b894f2a6e36457d665d1e08c3866add6ed5e70050c1b4ba8a8ddedb02ce7"
+checksum = "c5102a6aaa05aa011a238e178e6bca86d2cb56fc9f586d37cb80f5bca6e07759"
 dependencies = [
  "bitflags",
 ]
@@ -1177,9 +1190,9 @@ dependencies = [
 
 [[package]]
 name = "rustls-pki-types"
-version = "1.14.1"
+version = "1.15.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "30a7197ae7eb376e574fe940d068c30fe0462554a3ddbe4eca7838e049c937a9"
+checksum = "764899a24af3980067ee14bc143654f297b22eaebfe3c7b6b211920a5a59b046"
 dependencies = [
  "zeroize",
 ]
@@ -1811,9 +1824,9 @@ checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
 
 [[package]]
 name = "uuid"
-version = "1.23.3"
+version = "1.23.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "144d6b123cef80b301b8f72a9e2ca4370ddec21950d0a103dd22c437006d2db7"
+checksum = "bf80a72845275afea99e7f2b434723d3bc7e38470fcd1c7ed39a599c73319a53"
 dependencies = [
  "getrandom 0.4.3",
  "js-sys",
@@ -1846,9 +1859,9 @@ checksum = "b8dad83b4f25e74f184f64c43b150b91efe7647395b42289f38e50566d82855b"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.125"
+version = "0.2.126"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ddb3f79143bced6de84270411622a2699cee572fc0875aeaf1e7867cf9fca1a"
+checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
 dependencies = [
  "cfg-if",
  "once_cell",
@@ -1859,9 +1872,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.125"
+version = "0.2.126"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4e21a184b13fb19e157296e2c46056aec9092264fab83e4ba59e68c61b323c3d"
+checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -1869,9 +1882,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.125"
+version = "0.2.126"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fecefd9c35bd935a20fc3fc344b5f29138961e4f47fb03297d88f2587afb5ebd"
+checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
 dependencies = [
  "bumpalo",
  "proc-macro2",
@@ -1882,9 +1895,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.125"
+version = "0.2.126"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "23939e44bb9a5d7576fa2b563dc2e136628f1224e88a8deed09e04858b77871f"
+checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
 dependencies = [
  "unicode-ident",
 ]

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/Cargo.toml

@@ -1,9 +1,9 @@
 [workspace]
-members = ["crates/ferro-schema-ir", "crates/ferro-migrate"]
+members = ["crates/ferro-schema-ir", "crates/ferro-ddl-lowering", "crates/ferro-migrate"]
 
 [package]
 name = "ferro"
-version = "0.12.2"
+version = "0.13.0"
 edition = "2024"
 readme = "README.md"
 
@@ -36,4 +36,5 @@ tokio = { version = "1.49", features = ["full"] }
 pyo3-async-runtimes = { version = "0.27", features = ["tokio-runtime"] }
 uuid = { version = "1.11", features = ["v4"] }
 ferro-schema-ir = { path = "crates/ferro-schema-ir" }
+ferro-ddl-lowering = { path = "crates/ferro-ddl-lowering" }
 ferro-migrate = { path = "crates/ferro-migrate" }

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ferro-orm
-Version: 0.12.2
+Version: 0.13.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: alembic>=1.18.1 ; extra == 'alembic'
 Requires-Dist: sqlalchemy>=2.0.46 ; extra == 'alembic'
@@ -54,7 +54,7 @@ pip install ferro-orm
 pip install "ferro-orm[alembic]"
 ```
 
-Ferro currently supports SQLite and PostgreSQL as runtime backends. Named multi-database routing and custom connection-pool kwargs are planned, but not part of the current public API.
+Ferro currently supports SQLite and PostgreSQL. Register multiple named connections with `connect(..., name="...")` when a process needs more than one database — see the [connections guide](https://syn54x.github.io/ferro-orm/guide/connections/).
 
 ## Quick Start
 
@@ -73,8 +73,8 @@ async def main():
     # Create
     alice = await User.create(username="alice")
 
-    # Query
-    active_users = await User.where(User.is_active == True).all()
+    # Query (lambda predicates — name the parameter after the model, e.g. user for User)
+    active_users = await User.where(lambda user: user.is_active == True).all()
     print(f"Found {len(active_users)} active users.")
 
 if __name__ == "__main__":

{ferro_orm-0.12.2 → ferro_orm-0.13.0}/README.md

@@ -41,7 +41,7 @@ pip install ferro-orm
 pip install "ferro-orm[alembic]"
 ```
 
-Ferro currently supports SQLite and PostgreSQL as runtime backends. Named multi-database routing and custom connection-pool kwargs are planned, but not part of the current public API.
+Ferro currently supports SQLite and PostgreSQL. Register multiple named connections with `connect(..., name="...")` when a process needs more than one database — see the [connections guide](https://syn54x.github.io/ferro-orm/guide/connections/).
 
 ## Quick Start
 
@@ -60,8 +60,8 @@ async def main():
     # Create
     alice = await User.create(username="alice")
 
-    # Query
-    active_users = await User.where(User.is_active == True).all()
+    # Query (lambda predicates — name the parameter after the model, e.g. user for User)
+    active_users = await User.where(lambda user: user.is_active == True).all()
     print(f"Found {len(active_users)} active users.")
 
 if __name__ == "__main__":

{ferro_orm-0.12.2/crates/ferro-migrate → ferro_orm-0.13.0/crates/ferro-ddl-lowering}/Cargo.toml

@@ -1,7 +1,9 @@
 [package]
-name = "ferro-migrate"
+name = "ferro-ddl-lowering"
 version = "0.1.0"
 edition = "2024"
 
 [dependencies]
 ferro-schema-ir = { path = "../ferro-schema-ir" }
+sea-query = { version = "0.32", features = ["with-uuid"] }
+serde_json = "1.0"