fix(extension-arktype-json, sql-runtime): correctness gaps from ADR 208 landing

[jkomyno]

Focused follow-up to #402. This PR fixes the arktype-json runtime path that ADR 208 exposed: Postgres writes need runtime cast metadata, Postgres reads need to tolerate driver-preparsed jsonb, codec errors need to preserve stable runtime envelopes, and the docs need to say what no-emit can actually type today.

Changes

• Arktype-json wire behavior: Widened the codec wire type from string to string | JsonValue and normalized both raw JSON text and driver-preparsed JSONB values on decode. The previous JSON.parse(wire) assumption was wrong because pg returns jsonb as JavaScript values by default. Decode and decodeJson are now the schema-validation boundary; encode intentionally stays JSON.stringify only, because schema-validating on encode would make the codec parameter-dependent while params still carry only codecId.
• Runtime codec metadata: Registered the arktype-json metadata shim on the runtime descriptor through types.codecTypes.codecInstances, and gave it meta.db.sql.postgres.nativeType = 'jsonb'. The old "emit-only" shape was incomplete: the Postgres renderer reads codec metadata at runtime to decide whether $N::jsonb casts are required, so the first arktype-json write or filter could fail before codec dispatch even ran.
• Parameterized encode fallback: Added CodecDescriptor.encodeIsParamsIndependent and taught the runtime codec registry to keep rejecting ambiguous multi-instance forCodecId(codecId) lookups unless the descriptor declares that encode output is equivalent across all resolved parameter sets. The old ambiguity guard was right for parameter-dependent encoders, but too coarse for arktype-json and pgvector; both now declare the invariant explicitly, while decode still uses forColumn for per-column schemas.
• Runtime error envelopes: Updated encode and decode runtime paths to pass through codec-thrown RUNTIME.JSON_SCHEMA_VALIDATION_FAILED and already-stamped RUNTIME.ENCODE_FAILED / RUNTIME.DECODE_FAILED envelopes. Wrapping every codec error was wrong because it hid stable schema-failure codes and double-wrapped errors whose details were already authored by the codec.
• Arktype compatibility guard: Changed expression mismatch from a warning to RUNTIME.TYPE_PARAMS_INVALID and pinned arktype to ~2.1.29. A warning was too late: if ark.schema(jsonIr).expression diverges from serialized typeParams.expression, contract.d.ts may already be stale relative to the runtime schema. Failing at codec materialization is the more honest behavior.
• Docs: Updated ADR 208, the no-emit subsystem doc, and the arktype-json README to mark parameterized no-emit output as partial. Today no-emit still resolves through the codec base output (vector(1536) becomes number[], arktypeJson(schema) becomes unknown); precise schema-shaped output comes from emitted contract.d.ts until TML-2357 lands.
• Tests: Added coverage for runtime metadata lookup, jsonb cast metadata, pre-parsed JSONB objects and string primitives, expression mismatch hard-fail, params-independent encode fallback, runtime error pass-through, and the Embedding.profile ORM round trip through Postgres.

Why

The previous implementation mixed up control-plane and runtime responsibilities. It carried enough metadata for emission, but not enough metadata for Postgres lowering; it documented the intended no-emit resolver, but the resolver still uses codec base outputs; and it assumed the driver returned JSONB as strings, even though the default pg behavior is the opposite.

This version keeps those boundaries explicit. Encode stays parameter-independent until ParamRef.refs can identify the target column. Decode validates the schema because stored JSON can come from this writer, another service, manual SQL, or an older schema. Runtime metadata lives where the renderer actually reads it. The docs now distinguish shipped behavior from the remaining TML-2357 work.

[coderabbitai]

📝 Walkthrough

Walkthrough

Preserve JSON-schema validation error codes on encode/decode paths; widen arktype-json codec to accept pre-parsed JsonValue, add a metadata-only emit codec instance to the runtime, enforce runtime type-params round-trip, mark some parameterized codecs as encode-params-independent, and document partial no-emit typing for parameterized columns.

Changes

Arktype JSON, runtime codec registry, and JSON-schema error pass-through

Layer / File(s)	Summary
Data Shape packages/3-extensions/arktype-json/src/core/arktype-json-codec.ts, packages/3-extensions/arktype-json/test/arktype-json-codec.test-d.ts	Codec wire/input type widened from string → `string
Core Codec Implementation packages/3-extensions/arktype-json/src/core/arktype-json-codec.ts	Decode accepts pre-parsed JsonValue and normalizes with parseWireValue; schema validation moved to decode/decodeJson; serializeToJsonSafe no longer validates post-roundtrip; factory throws RUNTIME.TYPE_PARAMS_INVALID on expression mismatch; arktypeJsonEmitCodec annotated with Postgres jsonb meta; descriptor sets encodeIsParamsIndependent.
Runtime Wiring / Registry packages/3-extensions/arktype-json/src/exports/runtime.ts, packages/1-framework/1-core/.../shared/codec-types.ts, packages/2-sql/5-runtime/src/sql-context.ts	Runtime descriptor exposes arktypeJsonEmitCodec in types.codecTypes.codecInstances; added encodeIsParamsIndependent?: boolean to CodecDescriptor; registry marks codec-id ambiguous only if descriptor lacks encodeIsParamsIndependent.
Encode/Decode Error Handling packages/2-sql/5-runtime/src/codecs/encoding.ts, packages/2-sql/5-runtime/src/codecs/decoding.ts	encodeParamValue and decodeField detect runtime errors and rethrow unchanged when code is RUNTIME.JSON_SCHEMA_VALIDATION_FAILED (and preserve pre-wrapped RUNTIME.ENCODE_FAILED/RUNTIME.DECODE_FAILED), avoiding double-wrapping.
Tests / E2E packages/2-sql/5-runtime/test/json-schema-validation.test.ts, packages/3-extensions/arktype-json/test/*, packages/2-sql/5-runtime/test/contract-codec-registry.test.ts, test/e2e/framework/test/arktype-json.test.ts	Added regression tests preserving JSON-schema validation error codes on encode/decode, updated arktype-json unit tests for pre-parsed jsonb handling and factory behavior, registry tests for encodeIsParamsIndependent, and an e2e codec round-trip test.
Packaging / Dependency packages/3-extensions/arktype-json/package.json	arktype dependency specifier narrowed from ^2.1.29 → ~2.1.29.
Documentation / ADRs docs/architecture/.../ADR 208 - Higher-order codecs for parameterized types.md, docs/architecture/subsystems/9. No-Emit Workflow.md, packages/3-extensions/arktype-json/README.md	Documented partial no-emit behavior: parameterized columns fall back to codec base output types in no-emit mode (tracked TML-2357), clarified encode/decode validation timing for arktype-json, and updated ADR/resolution notes to denote emit-path-only progress.

Sequence Diagram

sequenceDiagram
  participant Client as Client
  participant Runtime as Runtime
  participant Codec as Codec
  participant DB as PostgresDB

  Client->>Runtime: encodeParam(value)
  Runtime->>Codec: codec.encode(wireValue)
  alt codec throws RUNTIME.JSON_SCHEMA_VALIDATION_FAILED
    Codec-->>Runtime: throw { code: RUNTIME.JSON_SCHEMA_VALIDATION_FAILED }
    Runtime-->>Client: rethrow unchanged
  else codec throws pre-wrapped RUNTIME.ENCODE_FAILED
    Codec-->>Runtime: throw { code: RUNTIME.ENCODE_FAILED, details }
    Runtime-->>Client: rethrow unchanged
  else success
    Codec-->>Runtime: encodedParam
    Runtime->>DB: send param
    DB-->>Runtime: stored
    Runtime-->>Client: success
  end

  Client->>Runtime: decodeRow(row)
  Runtime->>Codec: codec.decode(wire)
  alt codec throws RUNTIME.JSON_SCHEMA_VALIDATION_FAILED
    Codec-->>Runtime: throw { code: RUNTIME.JSON_SCHEMA_VALIDATION_FAILED }
    Runtime-->>Client: rethrow unchanged
  else codec throws pre-wrapped RUNTIME.DECODE_FAILED
    Codec-->>Runtime: throw { code: RUNTIME.DECODE_FAILED, details }
    Runtime-->>Client: rethrow unchanged
  else success
    Codec-->>Runtime: decodedValue
    Runtime-->>Client: return value
  end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• TML-2229: unified CodecDescriptor + per-library JSON extensions (ADR 208) #402 — Overlaps ADR 208, emit-path wiring, and arktype-json/codec descriptor changes (TML-2229 relation).
• feat(codec): single-path async codec runtime #379 — Related changes to encode/decode error handling and JSON-schema validation propagation.
• TML-1808 6: pgvector Vector<N> typing #100 — Related parameterized codec/typeParams handling and pgvector descriptor updates.

Poem

🐰 I parse the strings and guard the gate,
Preserve the codes that validate,
A metadata seed where codecs meet,
Docs and tests make the path complete,
Hop on—emit to see the types elate.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 58.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main focus: fixing correctness gaps from ADR 208 landing, specifically for arktype-json and sql-runtime. It clearly identifies the primary change.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/arktype-json-runtime-correctness

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

@prisma-next/mongo-runtime

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-runtime@418

@prisma-next/family-mongo

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/family-mongo@418

@prisma-next/sql-runtime

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-runtime@418

@prisma-next/family-sql

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/family-sql@418

@prisma-next/extension-arktype-json

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/extension-arktype-json@418

@prisma-next/middleware-telemetry

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/middleware-telemetry@418

@prisma-next/mongo

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo@418

@prisma-next/extension-paradedb

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/extension-paradedb@418

@prisma-next/extension-pgvector

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/extension-pgvector@418

@prisma-next/postgres

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/postgres@418

@prisma-next/sql-orm-client

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-orm-client@418

@prisma-next/sqlite

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sqlite@418

@prisma-next/target-mongo

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/target-mongo@418

@prisma-next/adapter-mongo

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/adapter-mongo@418

@prisma-next/driver-mongo

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/driver-mongo@418

@prisma-next/contract

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/contract@418

@prisma-next/utils

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/utils@418

@prisma-next/config

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/config@418

@prisma-next/errors

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/errors@418

@prisma-next/framework-components

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/framework-components@418

@prisma-next/operations

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/operations@418

@prisma-next/ts-render

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/ts-render@418

@prisma-next/contract-authoring

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/contract-authoring@418

@prisma-next/ids

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/ids@418

@prisma-next/psl-parser

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/psl-parser@418

@prisma-next/psl-printer

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/psl-printer@418

@prisma-next/cli

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/cli@418

@prisma-next/emitter

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/emitter@418

@prisma-next/migration-tools

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/migration-tools@418

prisma-next

npm i https://pkg.pr.new/prisma/prisma-next@418

@prisma-next/vite-plugin-contract-emit

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/vite-plugin-contract-emit@418

@prisma-next/mongo-codec

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-codec@418

@prisma-next/mongo-contract

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-contract@418

@prisma-next/mongo-value

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-value@418

@prisma-next/mongo-contract-psl

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-contract-psl@418

@prisma-next/mongo-contract-ts

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-contract-ts@418

@prisma-next/mongo-emitter

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-emitter@418

@prisma-next/mongo-schema-ir

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-schema-ir@418

@prisma-next/mongo-query-ast

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-query-ast@418

@prisma-next/mongo-orm

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-orm@418

@prisma-next/mongo-query-builder

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-query-builder@418

@prisma-next/mongo-lowering

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-lowering@418

@prisma-next/mongo-wire

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/mongo-wire@418

@prisma-next/sql-contract

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-contract@418

@prisma-next/sql-errors

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-errors@418

@prisma-next/sql-operations

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-operations@418

@prisma-next/sql-schema-ir

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-schema-ir@418

@prisma-next/sql-contract-psl

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-contract-psl@418

@prisma-next/sql-contract-ts

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-contract-ts@418

@prisma-next/sql-contract-emitter

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-contract-emitter@418

@prisma-next/sql-lane-query-builder

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-lane-query-builder@418

@prisma-next/sql-relational-core

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-relational-core@418

@prisma-next/sql-builder

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/sql-builder@418

@prisma-next/target-postgres

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/target-postgres@418

@prisma-next/target-sqlite

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/target-sqlite@418

@prisma-next/adapter-postgres

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/adapter-postgres@418

@prisma-next/adapter-sqlite

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/adapter-sqlite@418

@prisma-next/driver-postgres

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/driver-postgres@418

@prisma-next/driver-sqlite

npm i https://pkg.pr.new/prisma/prisma-next/@prisma-next/driver-sqlite@418

commit: 89e3484

[coderabbitai]

🧹 Nitpick comments (1)

docs/architecture docs/adrs/ADR 208 - Higher-order codecs for parameterized types.md (1)

116-120: ⚡ Quick win

Trim the resolver mechanics from the ADR.

This section is drifting into implementation flow (typeRef traversal, CodecInstanceContext application, Js extraction). The ADR reads cleaner if it stays at the architectural contract level and leaves the step-by-step resolver behavior to the subsystem docs.
As per coding guidelines: ADRs in prisma/prisma-next should document architectural design decisions and the key constraints/assumptions only; avoid implementation algorithms and step-by-step derivation/migration rules.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@docs/architecture` docs/adrs/ADR 208 - Higher-order codecs for parameterized
types.md around lines 116 - 120, Remove the low-level resolver steps from the
ADR and keep it at the architectural-contract level: delete or reword the
paragraph that describes following typeRef through storage.types, synthetically
applying CodecInstanceContext, and extracting the Js parameter; instead state
that FieldOutputType<Definition, Model, Field> will be able to resolve
parameterized column types via the ColumnTypeDescriptor's authoring-only type
slot (type: (ctx: CodecInstanceContext) => Codec<…, Js>) and that for
non-parameterized columns it will fall back to CodecTypes[codecId]['output'],
while nullability is preserved—leave the step-by-step traversal and application
details to subsystem documentation.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/architecture` docs/adrs/ADR 208 - Higher-order codecs for parameterized
types.md:
- Around line 116-120: Remove the low-level resolver steps from the ADR and keep
it at the architectural-contract level: delete or reword the paragraph that
describes following typeRef through storage.types, synthetically applying
CodecInstanceContext, and extracting the Js parameter; instead state that
FieldOutputType<Definition, Model, Field> will be able to resolve parameterized
column types via the ColumnTypeDescriptor's authoring-only type slot (type:
(ctx: CodecInstanceContext) => Codec<…, Js>) and that for non-parameterized
columns it will fall back to CodecTypes[codecId]['output'], while nullability is
preserved—leave the step-by-step traversal and application details to subsystem
documentation.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 98367176-41fe-4e0e-9a95-53b519c6db44

📥 Commits

Reviewing files that changed from the base of the PR and between 1d8b709 and eecca73.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (11)

• docs/architecture docs/adrs/ADR 208 - Higher-order codecs for parameterized types.md
• docs/architecture docs/subsystems/9. No-Emit Workflow.md
• packages/2-sql/5-runtime/src/codecs/decoding.ts
• packages/2-sql/5-runtime/test/json-schema-validation.test.ts
• packages/3-extensions/arktype-json/README.md
• packages/3-extensions/arktype-json/package.json
• packages/3-extensions/arktype-json/src/core/arktype-json-codec.ts
• packages/3-extensions/arktype-json/src/exports/runtime.ts
• packages/3-extensions/arktype-json/test/arktype-json-codec.test-d.ts
• packages/3-extensions/arktype-json/test/arktype-json-codec.test.ts
• packages/3-extensions/arktype-json/test/extension-descriptors.test.ts

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@packages/2-sql/5-runtime/src/codecs/encoding.ts`:
- Around line 126-140: The catch block in codec.encode currently only preserves
RUNTIME.JSON_SCHEMA_VALIDATION_FAILED; update it to also pass-through existing
RUNTIME.ENCODE_FAILED envelopes so they are not re-wrapped. Concretely, in the
catch for codec.encode, check if isRuntimeError(error) and if error.code is
either 'RUNTIME.JSON_SCHEMA_VALIDATION_FAILED' or 'RUNTIME.ENCODE_FAILED' then
rethrow the error; otherwise call wrapEncodeFailure(error, metadata, paramIndex,
codec.id). This uses the existing symbols codec.encode, isRuntimeError, and
wrapEncodeFailure to locate and modify the logic.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 2514a56f-f827-4262-9205-60a0ad1599aa

📥 Commits

Reviewing files that changed from the base of the PR and between eecca73 and e551a6c.

📒 Files selected for processing (5)

• packages/2-sql/5-runtime/src/codecs/encoding.ts
• packages/2-sql/5-runtime/test/json-schema-validation.test.ts
• packages/3-extensions/arktype-json/README.md
• packages/3-extensions/arktype-json/src/core/arktype-json-codec.ts
• test/e2e/framework/test/arktype-json.test.ts

🚧 Files skipped from review as they are similar to previous changes (1)

• packages/3-extensions/arktype-json/README.md

[coderabbitai]

🧹 Nitpick comments (1)

test/e2e/framework/test/arktype-json.test.ts (1)

2-2: ⚡ Quick win

Prefer pathe over node:path for path manipulation.

dirname and resolve should be imported from pathe (drop-in replacement with identical API) rather than node:path. Note: node:url on line 3 stays — fileURLToPath has no pathe equivalent.

♻️ Proposed change

 import { readFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
+import { dirname, resolve } from 'pathe';
 import { fileURLToPath } from 'node:url';

As per coding guidelines: "**/*.{ts,tsx,mts,cts}: Use pathe instead of node:path for path manipulation in TypeScript files... especially when code reads files/fixtures from disk."

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@test/e2e/framework/test/arktype-json.test.ts` at line 2, Replace imports of
dirname and resolve from 'node:path' with imports from 'pathe': update the
import statement that currently pulls dirname and resolve from 'node:path' so it
instead imports those symbols from 'pathe' (leave fileURLToPath from 'node:url'
unchanged); ensure any usages of dirname and resolve remain the same since pathe
is a drop-in replacement.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@test/e2e/framework/test/arktype-json.test.ts`:
- Line 2: Replace imports of dirname and resolve from 'node:path' with imports
from 'pathe': update the import statement that currently pulls dirname and
resolve from 'node:path' so it instead imports those symbols from 'pathe' (leave
fileURLToPath from 'node:url' unchanged); ensure any usages of dirname and
resolve remain the same since pathe is a drop-in replacement.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 6cbb9930-0b82-4bda-95c7-86a13d6d26fe

📥 Commits

Reviewing files that changed from the base of the PR and between e5ba9f5 and 6a2e33b.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (18)

• docs/architecture docs/adrs/ADR 208 - Higher-order codecs for parameterized types.md
• docs/architecture docs/subsystems/9. No-Emit Workflow.md
• packages/1-framework/1-core/framework-components/src/shared/codec-types.ts
• packages/2-sql/5-runtime/src/codecs/decoding.ts
• packages/2-sql/5-runtime/src/codecs/encoding.ts
• packages/2-sql/5-runtime/src/sql-context.ts
• packages/2-sql/5-runtime/test/contract-codec-registry.test.ts
• packages/2-sql/5-runtime/test/json-schema-validation.test.ts
• packages/3-extensions/arktype-json/README.md
• packages/3-extensions/arktype-json/package.json
• packages/3-extensions/arktype-json/src/core/arktype-json-codec.ts
• packages/3-extensions/arktype-json/src/exports/runtime.ts
• packages/3-extensions/arktype-json/test/arktype-json-codec.test-d.ts
• packages/3-extensions/arktype-json/test/arktype-json-codec.test.ts
• packages/3-extensions/arktype-json/test/extension-descriptors.test.ts
• packages/3-extensions/pgvector/src/exports/runtime.ts
• packages/3-extensions/pgvector/test/manifest.test.ts
• test/e2e/framework/test/arktype-json.test.ts

✅ Files skipped from review due to trivial changes (7)

• packages/3-extensions/pgvector/src/exports/runtime.ts
• packages/3-extensions/pgvector/test/manifest.test.ts
• packages/3-extensions/arktype-json/package.json
• packages/1-framework/1-core/framework-components/src/shared/codec-types.ts
• packages/3-extensions/arktype-json/README.md
• packages/3-extensions/arktype-json/test/arktype-json-codec.test.ts
• docs/architecture docs/subsystems/9. No-Emit Workflow.md

🚧 Files skipped from review as they are similar to previous changes (6)

• packages/2-sql/5-runtime/test/contract-codec-registry.test.ts
• packages/3-extensions/arktype-json/test/arktype-json-codec.test-d.ts
• packages/3-extensions/arktype-json/test/extension-descriptors.test.ts
• packages/3-extensions/arktype-json/src/core/arktype-json-codec.ts
• packages/2-sql/5-runtime/src/sql-context.ts
• packages/2-sql/5-runtime/src/codecs/encoding.ts

[wmadden]

I want to hold off merging this until TML-2357 / PR #417 is merged. This PR adds an extra conditional flag to codec descriptors, encodeIsParamsIndependent, which is made redundant by #417