diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 2eedcdd86e..848b7b3e54 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.170.0"
+  ".": "0.171.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c6860f711a..e20b259d60 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.171.0](https://github.com/chio-labs/sqlbuild/compare/v0.170.0...v0.171.0) (2026-10-23)
+
+
+### ⚠ BREAKING CHANGES
+
+* Python macros now live in macros/python/ (and the python/ folder of scoped macro roots) and are called as @py.name(...). A macro file directly under a macros/ folder fails with D013, and a bare @name(...) call fails with P014; move files into macros/python/ and replace @name( with @py.name( in project SQL.
+
+### Features
+
+* add typed SQL macros and require [@py](https://github.com/py)./[@sql](https://github.com/sql). macro calls ([#1224](https://github.com/chio-labs/sqlbuild/issues/1224)) ([21a802b](https://github.com/chio-labs/sqlbuild/commit/21a802bfbb22b6cb23eab6be932da2de48beb45f))
+
 ## [0.170.0](https://github.com/chio-labs/sqlbuild/compare/v0.169.0...v0.170.0) (2026-10-23)
 
 
diff --git a/Cargo.lock b/Cargo.lock
index fa9a7c522f..0b69f2be14 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -1189,7 +1189,7 @@ checksum = "5b3dc8af474f516a851ff4bd12db780f948b9250ad37211e4eec0bccea54e01b"
 
 [[package]]
 name = "sqlbuild-analysis"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "memchr",
  "polyglot-sql",
@@ -1212,7 +1212,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-attachments"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "sqlbuild-core",
  "sqlbuild-sqltext",
@@ -1220,7 +1220,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-build-features"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "arrayvec",
  "bstr",
@@ -1235,7 +1235,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-cache"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "blake3",
  "rayon",
@@ -1248,7 +1248,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-cli"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "blake3",
  "ctrlc",
@@ -1266,7 +1266,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-config"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "saphyr-parser",
  "sqlbuild-core",
@@ -1277,7 +1277,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-core"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "regex",
  "sha2",
@@ -1285,14 +1285,14 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-cursor"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "sqlbuild-core",
 ]
 
 [[package]]
 name = "sqlbuild-discovery"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "junction",
  "rayon",
@@ -1306,14 +1306,14 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-host"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "sqlbuild-core",
 ]
 
 [[package]]
 name = "sqlbuild-model-config"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "regex",
  "sqlbuild-core",
@@ -1321,7 +1321,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-project"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "sqlbuild-analysis",
  "sqlbuild-core",
@@ -1330,7 +1330,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-pysource"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "ruff_python_ast",
  "ruff_python_parser",
@@ -1341,7 +1341,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-python"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "fensu-policy",
  "mimalloc",
@@ -1374,7 +1374,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-recall"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "blake3",
  "rusqlite",
@@ -1388,7 +1388,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-refactor"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "serde",
  "serde_json",
@@ -1403,7 +1403,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-render"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "serde_json",
  "sqlbuild-cache",
@@ -1413,7 +1413,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-rules"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "blake3",
  "fensu-policy",
@@ -1438,7 +1438,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-scopes"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "serde_json",
  "sha2",
@@ -1451,7 +1451,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-sqltext"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "rayon",
  "serde",
@@ -1460,7 +1460,7 @@ dependencies = [
 
 [[package]]
 name = "sqlbuild-state"
-version = "0.170.0"
+version = "0.171.0"
 dependencies = [
  "serde_json",
  "sha2",
diff --git a/Cargo.toml b/Cargo.toml
index fe5564e62c..cd55938882 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -55,7 +55,7 @@ python-boundary = "sqlbuild-python"
 polyglot-floor = "sqlbuild-analysis"
 
 [workspace.package]
-version = "0.170.0"
+version = "0.171.0"
 edition = "2024"
 license = "Apache-2.0"
 publish = false
diff --git a/pyproject.toml b/pyproject.toml
index 6b320d7db7..232570aee6 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -7,7 +7,7 @@ build-backend = "maturin"
 
 [project]
 name = "sqlbuild"
-version = "0.170.0"
+version = "0.171.0"
 description = "Typed, test-first SQL pipelines with local E2E testing"
 readme = "README.md"
 requires-python = ">=3.12,<3.15"
@@ -18,7 +18,7 @@ dependencies = [
   "polyglot-sql-chio==0.13.9",
   "pydantic-settings>=2,<3",
   "PyYAML>=6.0.2",
-  "sqlbuild-cli==0.170.0",  # x-release-please-version
+  "sqlbuild-cli==0.171.0",  # x-release-please-version
 ]
 
 [project.optional-dependencies]
diff --git a/uv.lock b/uv.lock
index b39213a4d0..77f73f3b2b 100644
--- a/uv.lock
+++ b/uv.lock
@@ -4249,7 +4249,7 @@ wheels = [
 
 [[package]]
 name = "sqlbuild"
-version = "0.170.0"
+version = "0.171.0"
 source = { editable = "." }
 dependencies = [
     { name = "duckdb" },