@clickhouse/client 1.22.0 → 1.23.0-head.287977a.1

package/dist/result_set.js

@@ -34,8 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResultSet = void 0;
-const client_common_1 = require("@clickhouse/client-common");
-const client_common_2 = require("@clickhouse/client-common");
+const index_1 = require("./common/index");
+const index_2 = require("./common/index");
 const buffer_1 = require("buffer");
 const stream_1 = __importStar(require("stream"));
 const utils_1 = require("./utils");
@@ -71,14 +71,14 @@ class ResultSet {
         this.query_id = query_id;
         this.span = span;
         this.jsonHandling = {
-            ...client_common_1.defaultJSONHandling,
+            ...index_1.defaultJSONHandling,
             ...jsonHandling,
         };
         // eslint-disable-next-line no-console
         this.log_error = log_error ?? ((err) => console.error(err));
         if (_response_headers !== undefined) {
             this.response_headers = Object.freeze(_response_headers);
-            this.exceptionTag = _response_headers[client_common_1.EXCEPTION_TAG_HEADER_NAME];
+            this.exceptionTag = _response_headers[index_1.EXCEPTION_TAG_HEADER_NAME];
         }
     }
     consume() {
@@ -110,7 +110,7 @@ class ResultSet {
         }
         this.span.setAttributes(attributes);
         if (err) {
-            (0, client_common_1.recordSpanError)(this.span, err);
+            (0, index_1.recordSpanError)(this.span, err);
         }
         this.span.end();
     }
@@ -131,7 +131,7 @@ class ResultSet {
     /** See {@link BaseResultSet.json}. */
     async json() {
         // JSONEachRow, etc.
-        if ((0, client_common_2.isStreamableJSONFamily)(this.format)) {
+        if ((0, index_2.isStreamableJSONFamily)(this.format)) {
             const result = [];
             // Using the stream() instead of _stream directly to leverage the existing logic
             // for handling incomplete chunks and exception tags.
@@ -146,7 +146,7 @@ class ResultSet {
             return result;
         }
         // JSON, JSONObjectEachRow, etc.
-        if ((0, client_common_2.isNotStreamableJSONFamily)(this.format)) {
+        if ((0, index_2.isNotStreamableJSONFamily)(this.format)) {
             const stream = this.consume();
             try {
                 const text = await (0, utils_1.getAsText)(stream);
@@ -164,7 +164,7 @@ class ResultSet {
     }
     /** See {@link BaseResultSet.stream}. */
     stream() {
-        (0, client_common_2.validateStreamFormat)(this.format);
+        (0, index_2.validateStreamFormat)(this.format);
         const incompleteChunks = [];
         const logError = this.log_error;
         const exceptionTag = this.exceptionTag;
@@ -193,8 +193,8 @@ class ResultSet {
                         // Check for exception in the chunk (only after 25.11)
                         if (exceptionTag !== undefined &&
                             idx >= 1 &&
-                            chunk[idx - 1] === client_common_1.CARET_RETURN) {
-                            return callback((0, client_common_1.extractErrorAtTheEndOfChunk)(chunk, exceptionTag));
+                            chunk[idx - 1] === index_1.CARET_RETURN) {
+                            return callback((0, index_1.extractErrorAtTheEndOfChunk)(chunk, exceptionTag));
                         }
                         if (incompleteChunks.length > 0) {
                             incompleteChunks.push(chunk.subarray(lastIdx, idx));

package/dist/result_set.js.map

@@ -1 +1 @@
-{"version":3,"file":"result_set.js","sourceRoot":"","sources":["../src/result_set.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"result_set.js","sourceRoot":"","sources":["../src/result_set.ts"],"names":[],"mappings":"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"}

package/dist/utils/encoder.d.ts

@@ -1,4 +1,4 @@
-import type { DataFormat, InsertValues, JSONHandling, ValuesEncoder } from "@clickhouse/client-common";
+import type { DataFormat, InsertValues, JSONHandling, ValuesEncoder } from "../common/index";
 import Stream from "stream";
 export declare class NodeValuesEncoder implements ValuesEncoder<Stream.Readable> {
     private readonly json;

package/dist/utils/encoder.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeValuesEncoder = void 0;
-const client_common_1 = require("@clickhouse/client-common");
+const index_1 = require("../common/index");
 const stream_1 = __importDefault(require("stream"));
 const stream_2 = require("./stream");
 class NodeValuesEncoder {
@@ -19,17 +19,17 @@ class NodeValuesEncoder {
                 return values;
             }
             // JSON* formats streams
-            return stream_1.default.pipeline(values, (0, stream_2.mapStream)((value) => (0, client_common_1.encodeJSON)(value, format, this.json.stringify)), pipelineCb);
+            return stream_1.default.pipeline(values, (0, stream_2.mapStream)((value) => (0, index_1.encodeJSON)(value, format, this.json.stringify)), pipelineCb);
         }
         // JSON* arrays
         if (Array.isArray(values)) {
             return values
-                .map((value) => (0, client_common_1.encodeJSON)(value, format, this.json.stringify))
+                .map((value) => (0, index_1.encodeJSON)(value, format, this.json.stringify))
                 .join("");
         }
         // JSON & JSONObjectEachRow format input
         if (typeof values === "object") {
-            return (0, client_common_1.encodeJSON)(values, format, this.json.stringify);
+            return (0, index_1.encodeJSON)(values, format, this.json.stringify);
         }
         throw new Error(`Cannot encode values of type ${typeof values} with ${format} format`);
     }
@@ -41,7 +41,7 @@ class NodeValuesEncoder {
                 `got: ${typeof values}`);
         }
         if ((0, stream_2.isStream)(values)) {
-            if ((0, client_common_1.isSupportedRawFormat)(format)) {
+            if ((0, index_1.isSupportedRawFormat)(format)) {
                 if (values.readableObjectMode) {
                     throw new Error(`Insert for ${format} expected Readable Stream with disabled object mode.`);
                 }

package/dist/utils/encoder.js.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/utils/encoder.ts"],"names":[],"mappings":";;;;;;AAMA,6DAA6E;AAC7E,oDAA4B;AAC5B,qCAA+C;AAE/C,MAAa,iBAAiB;IACX,IAAI,CAAe;IAEpC,YAAY,gBAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,YAAY,CACV,MAAwC,EACxC,MAAkB;QAElB,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,yEAAyE;YACzE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,wBAAwB;YACxB,OAAO,gBAAM,CAAC,QAAQ,CACpB,MAAM,EACN,IAAA,kBAAS,EAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EACpE,UAAU,CACX,CAAC;QACJ,CAAC;QACD,eAAe;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM;iBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;QACD,wCAAwC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAA,0BAAU,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gCAAgC,OAAO,MAAM,SAAS,MAAM,SAAS,CACtE,CAAC;IACJ,CAAC;IAED,oBAAoB,CAClB,MAAwC,EACxC,MAAkB;QAElB,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,CAAC,IAAA,iBAAQ,EAAC,MAAM,CAAC;YACjB,OAAO,MAAM,KAAK,QAAQ,EAC1B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,gFAAgF;gBAC9E,QAAQ,OAAO,MAAM,EAAE,CAC1B,CAAC;QACJ,CAAC;QAED,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,IAAI,IAAA,oCAAoB,EAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,sDAAsD,CAC3E,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,qDAAqD,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnED,8CAmEC;AAED,SAAS,UAAU,CAAC,GAAiC;IACnD,IAAI,GAAG,EAAE,CAAC;QACR,4BAA4B;QAC5B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../../src/utils/encoder.ts"],"names":[],"mappings":";;;;;;AAMA,2CAAmE;AACnE,oDAA4B;AAC5B,qCAA+C;AAE/C,MAAa,iBAAiB;IACX,IAAI,CAAe;IAEpC,YAAY,gBAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,YAAY,CACV,MAAwC,EACxC,MAAkB;QAElB,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,yEAAyE;YACzE,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,wBAAwB;YACxB,OAAO,gBAAM,CAAC,QAAQ,CACpB,MAAM,EACN,IAAA,kBAAS,EAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,kBAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EACpE,UAAU,CACX,CAAC;QACJ,CAAC;QACD,eAAe;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM;iBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,kBAAU,EAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;QACD,wCAAwC;QACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAA,kBAAU,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gCAAgC,OAAO,MAAM,SAAS,MAAM,SAAS,CACtE,CAAC;IACJ,CAAC;IAED,oBAAoB,CAClB,MAAwC,EACxC,MAAkB;QAElB,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,CAAC,IAAA,iBAAQ,EAAC,MAAM,CAAC;YACjB,OAAO,MAAM,KAAK,QAAQ,EAC1B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,gFAAgF;gBAC9E,QAAQ,OAAO,MAAM,EAAE,CAC1B,CAAC;QACJ,CAAC;QAED,IAAI,IAAA,iBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC;YACrB,IAAI,IAAA,4BAAoB,EAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,sDAAsD,CAC3E,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,cAAc,MAAM,qDAAqD,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnED,8CAmEC;AAED,SAAS,UAAU,CAAC,GAAiC;IACnD,IAAI,GAAG,EAAE,CAAC;QACR,4BAA4B;QAC5B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "1.22.0";
+declare const _default: "1.23.0-head.287977a.1";
 export default _default;

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = "1.22.0";
+exports.default = "1.23.0-head.287977a.1";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;AAAA,kBAAe,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":";;AAAA,kBAAe,uBAAuB,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@clickhouse/client",
   "description": "Official JS client for ClickHouse DB - Node.js implementation",
   "homepage": "https://clickhouse.com",
-  "version": "1.22.0",
+  "version": "1.23.0-head.287977a.1",
   "license": "Apache-2.0",
   "keywords": [
     "clickhouse",
@@ -32,20 +32,22 @@
       {
         "name": "clickhouse-js-node-troubleshooting",
         "path": "./skills/clickhouse-js-node-troubleshooting"
+      },
+      {
+        "name": "clickhouse-js-node-rowbinary-parser",
+        "path": "./skills/clickhouse-js-node-rowbinary-parser"
       }
     ]
   },
   "scripts": {
     "pack": "npm pack",
-    "prepack": "rm -rf skills && cp ../../README.md ../../LICENSE . && cp -r ../../skills .",
+    "prepack": "rm -rf skills && cp ../../README.md ../../LICENSE . && cp -r ../../skills . && RBP=skills/clickhouse-js-node-rowbinary-parser && rm -rf $RBP/tests $RBP/node_modules $RBP/dist $RBP/package.json $RBP/package-lock.json $RBP/tsconfig.json $RBP/tsconfig.build.json $RBP/vitest.config.ts $RBP/.gitignore $RBP/LICENSE $RBP/eval_result*.md",
     "typecheck": "tsc --noEmit",
     "lint": "eslint --max-warnings=0 .",
     "lint:fix": "eslint . --fix",
     "build": "rm -rf dist; tsc"
   },
-  "dependencies": {
-    "@clickhouse/client-common": "1.22.0"
-  },
+  "dependencies": {},
   "devDependencies": {
     "simdjson": "^0.9.2"
   }

package/skills/clickhouse-js-node-rowbinary-parser/EXAMPLES.md

@@ -0,0 +1,48 @@
+# RowBinary reader examples
+
+Six end-to-end examples. Each `src/examples/*.ts` exports TWO readers for the
+same row — `readXRow` (built from the generic combinator API; easiest to read)
+and `readXRowFast` (the optimized, monomorphized form: leaf reads inlined,
+combinators flattened to straight-line loops, `advance()` coalesced over
+fixed-width runs — still streaming-safe). The matching `tests/X.example.test.ts`
+runs the full create → populate → read-back round trip against a live ClickHouse
+server (verified, not illustrative), and `tests/X.bench.ts` decodes a large
+`numbers()`-generated buffer with both readers (equivalence-checked before
+timing) to measure the speedup.
+
+To use one: find the example whose column types match your result, open its
+reader, and adapt it. `readRows(readXRow)` drives a row reader over a whole
+result; `streamRowBatches(chunks, readXRow)` drives it over a chunked HTTP stream.
+
+| Example           | SQL schema (the trigger)                                                                                                                                                                                                      | Speedup             | Reader · Test                                                                                                                                   |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| **orders**        | `id UInt8, uid UUID, price Decimal64(2), status Enum8(...)`                                                                                                                                                                   | **~3.4x**           | [`src/examples/orders.ts`](src/examples/orders.ts) · [`tests/orders.example.test.ts`](tests/orders.example.test.ts)                             |
+| **carts**         | `cart_id UInt32, items Array(Tuple(sku String, qty UInt16)), discounts Array(Nullable(Int32))`                                                                                                                                | **~2.0x**           | [`src/examples/carts.ts`](src/examples/carts.ts) · [`tests/carts.example.test.ts`](tests/carts.example.test.ts)                                 |
+| **telemetry**     | `host String, tags Map(String,String), cpu Array(Float64), region Nullable(String), window Tuple(start UInt32, count UInt16)`                                                                                                 | **~1.4x**           | [`src/examples/telemetry.ts`](src/examples/telemetry.ts) · [`tests/telemetry.example.test.ts`](tests/telemetry.example.test.ts)                 |
+| **observability** | `id UInt64, ts DateTime64(3), level Enum8, trace_id UUID, payload Variant(String,Int64,Float64), tags Map(LowCardinality(String),String), metrics Array(Tuple(LowCardinality(String),Float64)), attrs Array(Nullable(Int64))` | **~1.4x**           | [`src/examples/observability.ts`](src/examples/observability.ts) · [`tests/observability.example.test.ts`](tests/observability.example.test.ts) |
+| **profiles**      | `id UInt32, tags Array(String), score Nullable(Int32)`                                                                                                                                                                        | **~1.3x**           | [`src/examples/profiles.ts`](src/examples/profiles.ts) · [`tests/profiles.example.test.ts`](tests/profiles.example.test.ts)                     |
+| **events**        | `id UInt64, name String, ts DateTime('UTC')`                                                                                                                                                                                  | **~1.05x — on par** | [`src/examples/events.ts`](src/examples/events.ts) · [`tests/events.example.test.ts`](tests/events.example.test.ts)                             |
+
+Speedups: Node 24 / V8, decoding a 20k-row buffer — read the ratio, not the
+absolute hz, and run `npm run bench` for your own numbers. Two independent levers
+drive them: **composite monomorphization** (removes per-row combinator closures —
+`carts` / `telemetry` / `observability`) and **per-row formatting** (`orders` is
+all-scalar yet the biggest win, almost entirely from the `formatUUIDTable` swap).
+A flat scalar row with no hot formatter (`events`) is within noise, so prefer the
+clearer API reader there. When in doubt, benchmark — the `*.bench.ts` files are
+the template.
+
+The readers live under `src/examples/` and are excluded from the published build
+(`tsconfig.build.json`): reference material and test fixtures, type-checked by the
+base `tsconfig.json` and run by the suite, not part of the package's public API.
+
+## Columnar decode (struct-of-arrays) — the ~4x numeric path
+
+The examples above produce one object per row (array-of-structs). For a
+**numeric, fixed-width result the consumer reads column-wise** (aggregate / scan
+/ filter / plot, or hand off to a Worker / WASM kernel), decode the same
+row-major bytes directly into **one typed array per column** in the same single
+pass — no per-row object, no `Date`, no number boxing. That removes the
+allocation that dominates a numeric decode for a **measured ~4.2x**.
+
+See example: [`decodeIotColumnar`](src/examples/iot.ts).

package/skills/clickhouse-js-node-rowbinary-parser/README.md

@@ -0,0 +1,255 @@
+# ClickHouse Node.js RowBinary Parser Generator
+
+**If JS had a -O3 compiler flag, this skill would be it.** (for RowBinary parsing)
+
+A skill and a library that lets a coding agent generate bespoke RowBinary parsers on the first pass from the column type definitions of a ClickHouse response. The [spirit](#the-spirit) behind the approach.
+
+**Reader only** for now. Today this covers reading (decoding) RowBinary streams. A matching RowBinary writer (encoding) is planned.
+
+## Status
+
+- ✅ Sonnet 4.6: 60% -> 94.0% pass rate
+- ✅ Opus 4.8: 71% -> 94.7% pass rate
+- ✅ Haiku 4.5: 52% -> 86.0% pass rate
+- ✅ Composer 2.5 Fast: 3x parser performance
+- ✅ 469/469 tests
+- ✅ type-checked
+- ✅ benchmarked
+
+## Example
+
+Take a small orders result:
+
+```sql
+SELECT id, uid, price, status FROM orders
+--  id     UInt8
+--  uid    UUID
+--  price  Decimal64(2)
+--  status Enum8('new' = 1, 'shipped' = 2, 'done' = 3)
+```
+
+**The API-only reader** — what you write by composing the library's combinators. Correct, clear, and a fine default:
+
+```ts
+const readOrderRow: Reader<OrderRow> = (s) => ({
+  id: readUInt8(s),
+  uid: formatUUID(readUUID(s)),
+  price: readDecimal64(2)(s),
+  status: readEnum8(s),
+});
+```
+
+**The optimized reader the skill generates** — same row, monomorphized to
+straight-line code. The whole row is fixed-width (1 + 16 + 8 + 1 = 26 bytes), so
+the four separate bounds checks coalesce into one `advance(s, 26)` and every leaf
+read happens at a constant offset; the per-field combinators are gone:
+
+```ts
+const readOrderRowFast: Reader<OrderRow> = (s) => {
+  const { buf, view } = s;
+  const o = advance(s, 26); // one bounds check for the whole 26-byte row
+  const id = buf[o]!;
+  const uid = formatUUIDTable(buf.subarray(o + 1, o + 17));
+  const price: DecimalValue = [view.getBigInt64(o + 17, true), 2];
+  const status = view.getInt8(o + 25);
+  return { id, uid, price, status };
+};
+```
+
+Same values, same streaming-safety — **~3.4x** faster.
+
+## How to use
+
+As a library (comes with the skill):
+
+```bash
+npm install @clickhouse/rowbinary
+npx skills-npm setup
+```
+
+As a skill only:
+
+```bash
+npx skills add ClickHouse/clickhouse-js/skills/clickhouse-js-node-rowbinary-parser
+```
+
+```console
+> Hey, Claude, tell me what the rowbinary parser skill can do for me.
+> A lot! It generates custom, high-performance RowBinary parsers…
+> Super, generate a parser for the queries in app/src/model.ts.
+< Reading skill clickhouse-js-node-rowbinary-parser…
+```
+
+## Why it's worth it
+
+Four pillars — speed, correctness, judgment, and lifting smaller models:
+
+- **~2–3x faster code than the straightforward decoder.** The skill emits
+  monomorphized, flattened, straight-line code — inlined reads, bounds checks
+  coalesced across adjacent fixed-width columns, the right array layout — measured
+  at ~1.3–3.4x over the _same logic written with the plain combinator API_
+  (`npm run bench`). This is why
+  - inlined JIT friendly code
+  - benchmarked hot paths
+  - minimal allocations
+  - v8 and Node.js specific optimizations
+- **Correct on the gotchas that otherwise quietly break.** UUID byte
+  order, `Variant`'s sort-by-type-name discriminant, `DateTime64` sub-second
+  precision, signed-high-word wide integers, faithful decimals, `Dynamic`/`JSON`
+  self-description, transparent wrappers, opaque `AggregateFunction` — each
+  encoded with a live, server-verified test ([details below](#correctness-on-the-gotcha-heavy-types)).
+- **Judgment, not just code.** The skill carries the working knowledge to make
+  the right call _before_ writing a line, so the agent neither over- nor
+  under-engineers:
+  - **Is RowBinary even right?** For string-heavy results read as text, a `JSON*`
+    format + V8's native `JSON.parse` (plus `gzip`/`zstd`) can beat a JS RowBinary
+    decoder — reach for RowBinary when the data is numeric / wide-integer /
+    binary-blob heavy.
+  - **Whole buffer or stream?** Drop the `advance()` bounds checks for a complete
+    in-memory buffer (faster); keep them for a chunked HTTP response that must
+    survive rows straddling chunk boundaries.
+  - **Drop the portability scaffolding.** RowBinary is little-endian and the
+    target is x86/ARM, so the skill steers away from big-endian / byte-swap
+    "portability" code a cautious one-shot pass tends to add.
+- **Improves smaller models' performance.** Because the skill hands over the
+  hard-won answers up front, it lifts a weaker model the most. In a 24-eval
+  with-skill vs no-skill benchmark, the skill [raised](eval_result_sonnet.md) **Sonnet 4.6** from 60.4% to
+  **94.0%** (+34pp) — bringing it level with skill-equipped **Opus 4.8** (94.7%),
+  which itself [gained](eval_result.md) +23pp (71.5% → 94.7%). Composer 2.5 Fast
+  [got](eval_result_composer.md) a 3x parser performance boost, Haiku 4.5
+  [raised](eval_result_haiku.md) from 52% to 86% — the skill closes
+  most of the model-capability gap on this task.
+
+## What it does
+
+Given the columns of a query result — their names and ClickHouse type
+definitions (as returned by `RowBinaryWithNamesAndTypes`, or supplied by the
+user) — the skill generates parser code tailored to exactly those types. Rather
+than shipping a generic, runtime-driven decoder, it emits straight-line code
+that reads each column in order, so the parser only contains the logic the
+specific result shape needs.
+
+**Schema only known at runtime?** `compileRowBinaryWithNamesAndTypes(cursor)`
+reads the `RowBinaryWithNamesAndTypes` header and folds each column type into a
+reader on the fly (type strings parsed by `@clickhouse/datatype-parser`),
+returning a `readRows` driver for the rest of the stream — a generic, no-codegen
+path for dynamic schemas. The specialized codegen above stays the fast path when
+the types are fixed.
+
+## Correctness on the gotcha-heavy types
+
+For a plain `UInt64, String, DateTime` result a strong model already writes fast,
+correct code on its own. The skill earns its keep on the **long tail of RowBinary
+traps** — the encodings where a from-scratch decoder is quietly wrong — each one
+captured here with a live, server-verified test:
+
+- **UUID** — two little-endian `UInt64` halves, each byte-reversed vs. the text
+  form (not 16 bytes in order).
+- **`Variant(...)`** — the 1-byte discriminant indexes the alternatives sorted by
+  **type name** (ClickHouse globally sorts them), NOT declaration order; `0xFF`
+  is NULL.
+- **`DateTime64(P)`** — returned as `[Date, nanoseconds]` so the sub-second part
+  isn't lost to a `Date`'s millisecond resolution; `Time`/`Time64` are durations,
+  not instants.
+- **Wide integers** — `Int128`/`Int256` compose from 64-bit words with the **high
+  word read signed**; 64-bit values stay `bigint`, never a lossy `number`.
+- **Decimals** — kept as the exact `[unscaled, scale]` pair, not a lossy float.
+- **`Dynamic` / `JSON`** — self-describing: a per-value binary type encoding, then
+  the value; declared typed `JSON` paths are written without a tag (need the
+  schema). Wrappers are erased (`Nullable`/`Variant` → concrete type).
+- **Transparent wrappers** — `LowCardinality(T)` / `SimpleAggregateFunction(f, T)`
+  decode as the inner `T` (no dictionary layer in RowBinary); `Nested(...)` is
+  `Array(Tuple(...))` with no wire of its own.
+- **`AggregateFunction(...)`** — opaque, unframed state: not decodable or even
+  skippable; finalize server-side instead.
+- **`FixedString`** preserves trailing NUL padding; **`Enum`** decodes to the
+  underlying int (the name map is metadata); **`BFloat16`** is the top 16 bits of
+  a `Float32`.
+
+This is also where a raw model is most likely to go wrong. In a clean-room test
+on a `Variant` / `UUID` / `DateTime64` / `LowCardinality` schema, a no-skill
+Sonnet produced a **silently wrong UUID** (treated the bytes as plain, missing
+the two-reversed-halves layout), and a no-skill Opus got it right only after
+**three web searches**. The skill hands over these answers up front — correct by
+construction, no lookups. See `baseline/README.md` for the full control.
+
+And the failure isn't a one-off — it's a coin-flip. Running the same no-skill
+Sonnet on the `orders` schema (`UInt8, UUID, Decimal64(2), Enum8`) **5 times in
+isolation**, only **3 of 5** runs decoded correctly; both failures were the same
+UUID byte-order scramble. Even the passing runs varied ~1.9x in generated-code
+throughput. With the skill, every run is correct. So a single A/B undersells the
+gap: from scratch the model is right roughly 60% of the time and silently wrong
+the rest, while the skill makes correctness deterministic.
+
+## Examples
+
+Six end-to-end examples live in [EXAMPLES.md](EXAMPLES.md). Each ships both an API-combinator
+reader and an optimized, monomorphized one, with a runnable round-trip test and
+a benchmark — so the speedups below are measured, not claimed (Node 24 / V8;
+`npm run bench` for your own numbers):
+
+| Example           | Columns                                              | Optimized speedup   |
+| ----------------- | ---------------------------------------------------- | ------------------- |
+| **orders**        | `UUID`, `Decimal64`, `Enum8`                         | **~3.4x**           |
+| **carts**         | nested `Array(Tuple(...))`, `Array(Nullable(...))`   | **~2.0x**           |
+| **telemetry**     | `Map`, `Array(Float64)`, `Nullable`, named `Tuple`   | **~1.4x**           |
+| **observability** | `Variant`, `DateTime64(3)`, `LowCardinality`, nested | **~1.4x**           |
+| **profiles**      | `Array(String)`, `Nullable(Int32)`                   | **~1.3x**           |
+| **events**        | `UInt64`, `String`, `DateTime` scalars               | **~1.05x — on par** |
+
+Two axes drive the win. **Composite structure** is one: monomorphization pays in
+proportion to how many per-row combinator closures it removes (`carts` /
+`telemetry` / `observability`). **Per-row formatting** is the other, independent
+of composites: `orders` is all-scalar yet the biggest win (~3.4x), almost
+entirely from swapping the BigInt UUID formatter for the lookup-table
+`formatUUIDTable`. The genuinely flat case — a scalar row with no hot formatter
+(`events`) — is on par, so the simpler API reader is the right call there.
+Measure, don't assume.
+
+## Scope
+
+- **In scope:** `RowBinary`, `RowBinaryWithNames`, and
+  `RowBinaryWithNamesAndTypes` decoding for Node.js — full-buffer and streaming
+  (chunked) via `advance()`/`NeedMoreData`, `readRows()`, and the async
+  `streamRowBatches()` (with a built-in small-chunk warning and the optional
+  `coalesceChunks()` debounce filter).
+- **Planned:** RowBinary **writing / encoding** (the inverse of everything above)
+- **Out of scope (for now):** browsers and Edge runtimes, non-RowBinary formats
+  (JSON / CSV / TSV / Parquet), and big-endian hosts.
+
+## The spirit
+
+A RowBinary parser generator is a narrow thing. But it's built as an instance of
+a broader bet about what libraries become once a capable LLM is part of the
+toolchain. Three shifts, each already visible in this repo:
+
+- **Self-modifiable software.** The library deliberately ships _several_
+  equivalent decoders for the same type — `readUUID` / `readUUIDBigInt` /
+  `readUUIDHiLo`, `formatUUID` / `formatUUIDTable`, `new Array(n)` vs `[]`+push,
+  streaming vs whole-buffer — because the fastest one depends on the workload,
+  not the type. Today the agent picks at generation time from measured
+  benchmarks. The next step is to pair the skill with a tracing layer that runs
+  variant A against variant B _on the live workload_ and keeps whichever wins for
+  this data shape and access pattern — a parser that re-tunes itself as the
+  traffic drifts, instead of freezing one author's guess into a release.
+
+- **Custom software.** The value here isn't a fixed high-level API; it's the
+  benchmarked building blocks plus the judgment to combine them. So the end user
+  doesn't bend their code to the authors' generic surface — they have the agent
+  assemble the high-level API _they_ actually want, shaped to their queries, row
+  shapes, and latency/memory budget. Two teams with different workloads grow two
+  different libraries from the same primitives, and neither inherits a design
+  decision that was only ever right for the original authors' use case.
+
+- **Read-write libraries.** For either of the above to be safe, the source has to
+  be legible to an LLM, not merely runnable. So this repo is written _read-write_:
+  every tradeoff is commented where it's made — the per-column ClickHouse type
+  annotations, the `SAFE TO TOGGLE` markers on the fast variants, each reader's
+  doc comment carrying its exact monomorphized form. An LLM can
+  read _why_ a decision was made and change it in depth with confidence — not
+  just call the public functions, but safely rework the internals.
+
+The through-line: the last mile is glue the LLM writes over stable, benchmarked
+blocks, so the authors' job shrinks to exporting good primitives and documenting
+their tradeoffs honestly — rather than trying to bake the right performance
+constants for every possible workload into the library ahead of time.