docs: sync from coderbuzz/codex@1d1cd61

Author: github-actions[bot]

AI_KNOWLEDGE.md

@@ -1,4 +1,4 @@
-<!-- docs: sync from coderbuzz/codex@a1ca665 -->
+<!-- docs: sync from coderbuzz/codex@1d1cd61 -->
 
 # @coderbuzz/sql: AI Expert Knowledge Reference
 
@@ -1761,6 +1761,8 @@ Peer deps (all optional): pg, mysql2, mssql, better-sqlite3
 Runtime dep: @coderbuzz/veta (internal, schema coercion)
 ```
 
+The peers are optional through `peerDependenciesMeta`. Published versions up to 0.9.2 lacked that field (the build's `post-build.ts` dropped it), so npm 7+ installed all four drivers with `npm install @coderbuzz/sql` (99 packages, a native `better-sqlite3` build included). From the next patch release only `@coderbuzz/sql` and `@coderbuzz/veta` are installed; add the driver you use yourself (`npm install pg`), and it is still checked against the range (`pg@7` is refused). `bun run validate` fails if `dist/package.json` loses the field again.
+
 **Export map summary:**
 
 | Import path                       | Contents                            |

README.md

@@ -1,4 +1,4 @@
-<!-- docs: sync from coderbuzz/codex@a1ca665 -->
+<!-- docs: sync from coderbuzz/codex@1d1cd61 -->
 
 # @coderbuzz/sql
 
@@ -104,6 +104,8 @@ bun add mssql                # SQL Server
 bun add better-sqlite3       # SQLite (Node.js)
 ```
 
+The drivers are optional peer dependencies: install only the one you use. (Up to 0.9.2 the published package marked them required, so npm 7+ installed all four.)
+
 SQLite on Bun uses `bun:sqlite` (built-in, no driver needed).
 SQLite on Deno uses `@db/sqlite`.
 PostgreSQL and MySQL on Bun can skip `pg` and `mysql2` entirely: import