mk3008 · mk3008 · Feb 6, 2026 · Feb 6, 2026
diff --git a/.changeset/add-sql-contract-validator-scalar.md b/.changeset/add-sql-contract-validator-scalar.md
diff --git a/.changeset/catalog-runtime-timestamp-normalization.md b/.changeset/catalog-runtime-timestamp-normalization.md
diff --git a/.changeset/catalog-test-fix.md b/.changeset/catalog-test-fix.md
diff --git a/.changeset/composite-key-internals.md b/.changeset/composite-key-internals.md
diff --git a/.changeset/fix-ztd-cli-optional-adapter-resolution.md b/.changeset/fix-ztd-cli-optional-adapter-resolution.md
diff --git a/.changeset/new-reader-scalar-helper.md b/.changeset/new-reader-scalar-helper.md
diff --git a/.changeset/readme-demos.md b/.changeset/readme-demos.md
diff --git a/.changeset/snappy-alpaca.md b/.changeset/snappy-alpaca.md
diff --git a/.changeset/sql-first-binder.md b/.changeset/sql-first-binder.md
diff --git a/.changeset/ztd-cli-init-minimal-scaffold.md b/.changeset/ztd-cli-init-minimal-scaffold.md
diff --git a/.changeset/ztd-cli-scaffold-structure.md b/.changeset/ztd-cli-scaffold-structure.md
diff --git a/packages/adapters/adapter-node-pg/CHANGELOG.md b/packages/adapters/adapter-node-pg/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @rawsql-ts/adapter-node-pg
 
+## 0.15.2
+
+### Patch Changes
+
+- [#433](https://github.com/mk3008/rawsql-ts/pull/433) [`36fd789`](https://github.com/mk3008/rawsql-ts/commit/36fd7898926abf318873350ec3aeb5a28a60e021) Thanks [@mk3008](https://github.com/mk3008)! - Adopt SQL-first scaffolding with named-parameter SQL layout in the ZTD template, and compile named parameters to indexed placeholders in the pg adapter.
+
 ## 0.15.1
 
 ### Patch Changes

diff --git a/packages/adapters/adapter-node-pg/package.json b/packages/adapters/adapter-node-pg/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@rawsql-ts/adapter-node-pg",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "Node pg adapter that connects PostgreSQL fixtures to @rawsql-ts/testkit-postgres.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

diff --git a/packages/sql-contract-zod/CHANGELOG.md b/packages/sql-contract-zod/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @rawsql-ts/sql-contract-zod
 
+## 0.1.1
+
+### Patch Changes
+
+- [#425](https://github.com/mk3008/rawsql-ts/pull/425) [`3e6e493`](https://github.com/mk3008/rawsql-ts/commit/3e6e493f03d85b10d5b9c9033d51e7ece7384d85) Thanks [@mk3008](https://github.com/mk3008)! - - add `reader.scalar` so single-column queries can be validated with Zod without DTO mapping and document the helper
+
+- [#426](https://github.com/mk3008/rawsql-ts/pull/426) [`c0486d6`](https://github.com/mk3008/rawsql-ts/commit/c0486d68a5c517efa5a511a2ea49cdc3b21986d4) Thanks [@mk3008](https://github.com/mk3008)! - - split the Postgres validator demo into five short README-ready test files that share a pg-test helper and keep the API story tidy.
+  - document that the SQL Contract package now exposes `decimalStringToNumberUnsafe` for the Zod demo without importing `sql-contract-zod`, preserving a dependency-free core surface.
+- Updated dependencies [[`47f9e41`](https://github.com/mk3008/rawsql-ts/commit/47f9e41201f88f7b378301b474e8cbc0a1b050c8), [`06ec7ea`](https://github.com/mk3008/rawsql-ts/commit/06ec7ea2c54b9561ff74cbbd6c13d8cc7ef6f9dc), [`eadb311`](https://github.com/mk3008/rawsql-ts/commit/eadb311dcc8c748fcdd30f2b743648783aafc2f6), [`0b34920`](https://github.com/mk3008/rawsql-ts/commit/0b34920094c3451dd1263a25b44acf729fe1afae), [`c0486d6`](https://github.com/mk3008/rawsql-ts/commit/c0486d68a5c517efa5a511a2ea49cdc3b21986d4), [`5e01f8e`](https://github.com/mk3008/rawsql-ts/commit/5e01f8eb64894b4aea3b47aa96ccfd8a3b8ccdc3)]:
+  - @rawsql-ts/sql-contract@0.2.0
+
 ## 0.1.0
 
 ### Minor Changes

diff --git a/packages/sql-contract-zod/package.json b/packages/sql-contract-zod/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@rawsql-ts/sql-contract-zod",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Runtime DTO validation on top of sql-contract's explicit mapper using Zod schemas.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

diff --git a/packages/sql-contract/CHANGELOG.md b/packages/sql-contract/CHANGELOG.md
@@ -1,5 +1,26 @@
 # @rawsql-ts/sql-contract
 
+## 0.2.0
+
+### Minor Changes
+
+- [#426](https://github.com/mk3008/rawsql-ts/pull/426) [`47f9e41`](https://github.com/mk3008/rawsql-ts/commit/47f9e41201f88f7b378301b474e8cbc0a1b050c8) Thanks [@mk3008](https://github.com/mk3008)! - Add reader validation hooks and scalar query helpers to support runtime DTO validation and single-value results.
+
+- [#433](https://github.com/mk3008/rawsql-ts/pull/433) [`06ec7ea`](https://github.com/mk3008/rawsql-ts/commit/06ec7ea2c54b9561ff74cbbd6c13d8cc7ef6f9dc) Thanks [@mk3008](https://github.com/mk3008)! - Add a new public `timestampFromDriver(value, fieldName?)` helper in `@rawsql-ts/sql-contract` for fail-fast `Date | string` normalization of driver-returned timestamps.
+
+  Update `@rawsql-ts/ztd-cli` templates to normalize runtime timestamp fields through the shared sql-contract helper (via runtime coercion wiring), add strict guardrails against local timestamp re-implementation, and expand scaffold smoke validation tests for valid and invalid timestamp strings.
+
+### Patch Changes
+
+- [#431](https://github.com/mk3008/rawsql-ts/pull/431) [`eadb311`](https://github.com/mk3008/rawsql-ts/commit/eadb311dcc8c748fcdd30f2b743648783aafc2f6) Thanks [@mk3008](https://github.com/mk3008)! - Corrected the catalog executor test expectations so the cached SQL loader matches the returned rows and keeps the rewrite/binder pipeline aligned.
+
+- [#430](https://github.com/mk3008/rawsql-ts/pull/430) [`0b34920`](https://github.com/mk3008/rawsql-ts/commit/0b34920094c3451dd1263a25b44acf729fe1afae) Thanks [@mk3008](https://github.com/mk3008)! - Describe how composite and derived key normalization now exposes deterministic internals and tests can assert separator/tag/order invariants.
+
+- [#426](https://github.com/mk3008/rawsql-ts/pull/426) [`c0486d6`](https://github.com/mk3008/rawsql-ts/commit/c0486d68a5c517efa5a511a2ea49cdc3b21986d4) Thanks [@mk3008](https://github.com/mk3008)! - - split the Postgres validator demo into five short README-ready test files that share a pg-test helper and keep the API story tidy.
+  - document that the SQL Contract package now exposes `decimalStringToNumberUnsafe` for the Zod demo without importing `sql-contract-zod`, preserving a dependency-free core surface.
+
+- [#432](https://github.com/mk3008/rawsql-ts/pull/432) [`5e01f8e`](https://github.com/mk3008/rawsql-ts/commit/5e01f8eb64894b4aea3b47aa96ccfd8a3b8ccdc3) Thanks [@mk3008](https://github.com/mk3008)! - - tighten catalog executor contracts, add `ContractViolationError`, and improve observability/error classification.
+
 ## 0.1.0
 
 ### Minor Changes

diff --git a/packages/sql-contract/package.json b/packages/sql-contract/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@rawsql-ts/sql-contract",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Lightweight mapper and writer helpers that keep client SQL authoritative while exposing an explicit contract for data hydration and CUD emitters.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

diff --git a/packages/ztd-cli/CHANGELOG.md b/packages/ztd-cli/CHANGELOG.md
@@ -1,5 +1,26 @@
 # @rawsql-ts/ztd-cli
 
+## 0.17.0
+
+### Minor Changes
+
+- [#433](https://github.com/mk3008/rawsql-ts/pull/433) [`36fd789`](https://github.com/mk3008/rawsql-ts/commit/36fd7898926abf318873350ec3aeb5a28a60e021) Thanks [@mk3008](https://github.com/mk3008)! - Adopt SQL-first scaffolding with named-parameter SQL layout in the ZTD template, and compile named parameters to indexed placeholders in the pg adapter.
+
+- [#433](https://github.com/mk3008/rawsql-ts/pull/433) [`83e870a`](https://github.com/mk3008/rawsql-ts/commit/83e870aa945b75cdf894c8a620309e6d54dba178) Thanks [@mk3008](https://github.com/mk3008)! - Redesign `ztd init` to produce a deterministic minimal scaffold with per-folder AGENTS.md guidance and option-specific DDL seeding only (pg_dump, empty, or demo DDL).
+
+- [#433](https://github.com/mk3008/rawsql-ts/pull/433) [`bf588fd`](https://github.com/mk3008/rawsql-ts/commit/bf588fd73e4fd728b193dd795e449729e6b554b5) Thanks [@mk3008](https://github.com/mk3008)! - Add the new default ZTD scaffold layout with view SQL under "src/sql/views", job SQL under "src/sql/jobs", and repositories split between "src/repositories/views" and "src/repositories/tables". The init command now supports "--yes" to overwrite existing scaffold files without prompts for non-interactive runs.
+
+### Patch Changes
+
+- [#433](https://github.com/mk3008/rawsql-ts/pull/433) [`06ec7ea`](https://github.com/mk3008/rawsql-ts/commit/06ec7ea2c54b9561ff74cbbd6c13d8cc7ef6f9dc) Thanks [@mk3008](https://github.com/mk3008)! - Add a new public `timestampFromDriver(value, fieldName?)` helper in `@rawsql-ts/sql-contract` for fail-fast `Date | string` normalization of driver-returned timestamps.
+
+  Update `@rawsql-ts/ztd-cli` templates to normalize runtime timestamp fields through the shared sql-contract helper (via runtime coercion wiring), add strict guardrails against local timestamp re-implementation, and expand scaffold smoke validation tests for valid and invalid timestamp strings.
+
+- [#435](https://github.com/mk3008/rawsql-ts/pull/435) [`345a4a1`](https://github.com/mk3008/rawsql-ts/commit/345a4a1ad0354e975f47200f0f222696fa67a326) Thanks [@mk3008](https://github.com/mk3008)! - Fix optional adapter resolution during SQL lint execution so workspace and test environments no longer require prebuilt dist artifacts.
+
+- Updated dependencies [[`36fd789`](https://github.com/mk3008/rawsql-ts/commit/36fd7898926abf318873350ec3aeb5a28a60e021)]:
+  - @rawsql-ts/adapter-node-pg@0.15.2
+
 ## 0.16.0
 
 ### Minor Changes

diff --git a/packages/ztd-cli/package.json b/packages/ztd-cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@rawsql-ts/ztd-cli",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "DB-agnostic scaffolding and DDL helpers for Zero Table Dependency projects",
   "main": "dist/index.js",
   "bin": {