|
3 | 3 | <!-- distilled-through: none --> |
4 | 4 |
|
5 | 5 | ## Configuration and authentication |
6 | | - |
7 | 6 | - L-0001 (3×, #457): Trace option support through DBSQLClient, auth adapters and each transport. Type declarations and class comments do not establish forwarding; shared preparation can precede backend-specific filtering. |
8 | 7 | - L-0002 (2×, #501 #505): New auth branches must preserve ambiguity, credential-exclusion and persistence guards, including checks bypassed by early returns. |
9 | 8 | - L-0003 (2×, #501 #505): Normalize native-bound strings with isBlankOrReserved so blank, placeholder and whitespace values do not select unintended auth modes. |
|
26 | 25 | - L-0020 (1×, #589): Reject missing required napi arguments in TypeScript with matching Thrift message/SQLSTATE before opaque native conversion errors. |
27 | 26 | - L-0021 (1×, #583): Activating formerly ignored configuration changes existing users' behavior. Document consequences and invalidate persisted caches whose inputs no longer match, including OAuth scopes. |
28 | 27 | - L-0022 (1×, #588): Match host/URL normalization across backends for slashes, embedded ports and IPv6; compare edge cases on both before changing either. |
29 | | -## Native packages and public compatibility |
30 | 28 |
|
| 29 | +## Native packages and public compatibility |
31 | 30 | - L-0023 (4×, #505 #513 #514): New native fields need published binding support. Land router capability/version checks and all platform optionalDependency pins together; source-only KERNEL_REV bumps or accepted TypeScript fields do not ship support. |
32 | 31 | - L-0024 (2×, #514 #506 #528): Regenerate native index.d.ts from the pinned build and review its contract changes. Mocked JS tests cannot verify ABI behavior or live-server compatibility. |
33 | 32 | - L-0025 (1×, #514): Changelog entries for source-only native features must state the required follow-up published package bump and reference the kernel change. |
|
37 | 36 | - L-0029 (2×, #535 #594): Published-library overrides and lockfiles do not constrain downstream runtime dependencies. Fix declared ranges and test those ranges instead of claiming local overrides protect consumers. |
38 | 37 | - L-0030 (1×, #535): Security pins must not downgrade an already patched resolution; verify the advisory applies to the exact package. |
39 | 38 | - L-0031 (1×, #568): Put backend-shared code in neutral utilities. Preserve deep-import compatibility with deprecated re-export shims and smoke tests when moving modules. |
40 | | -## Errors, logging and telemetry |
41 | 39 |
|
| 40 | +## Errors, logging and telemetry |
42 | 41 | - L-0032 (1×, #514): Negative tests must assert the intended error shape or message so unrelated warehouse/auth failures cannot satisfy them. |
43 | 42 | - L-0033 (2×, #523 #592 #587): StatusError structurally implements Error without extending it. Preserve its instance and custom fields; inspect message/sqlState structurally rather than requiring instanceof Error. |
44 | 43 | - L-0034 (1×, #553): Synthetic Thrift error results must cover initial, directResults and polled status paths, allocate per-operation schemas, and close only real server handles. |
|
50 | 49 | - L-0040 (1×, #596): Error telemetry may carry class, SQLSTATE and terminal/retryable status only; exclude messages, stacks, URLs and other free-form error text. |
51 | 50 | - L-0041 (1×, #608): Decode every napi error, including status/hasMore calls. Any call that may fetch must share fetchChunk's best-effort failure cleanup, with rejecting-fake tests per call site. |
52 | 51 | - L-0042 (1×, #619): Detect user close/cancel with dedicated persistent intent flags read before cleanup, not lifecycle.isClosed. Fetch-failure cleanup must still close cancelled operations. |
53 | | -## Resources, networking and performance |
54 | 52 |
|
| 53 | +## Resources, networking and performance |
55 | 54 | - L-0043 (1×, #497): Portable Bash with nounset must guard empty-array expansion on older shells and distinguish unset-only defaults from unset-or-empty defaults. |
56 | 55 | - L-0044 (1×, #513): Skipped before hooks still allow after hooks; gate destructive teardown on completed setup/backup. |
57 | 56 | - L-0045 (2×, #523): Memoize backend resources per connection and close them explicitly. Close must await pending initialization so late-created resources cannot be orphaned. |
|
60 | 59 | - L-0048 (1×, #529): Configuration tests must assert observable downstream effects, not merely absence of an exception. |
61 | 60 | - L-0049 (1×, #554): Sanitize CI values entering unquoted SQL identifiers to letters, digits and underscores. |
62 | 61 | - L-0050 (1×, #569): Type parity fixes must cover both metadata type_name and Arrow fallback mappings; test both through the native-free StatementStub harness. |
63 | | -- L-0051 (1×, #500): Local HTTP download tests must avoid using a connection's HTTPS agent so they exercise the intended response failure. |
| 62 | +- L-0051 (1×, log:2026-11-07): Local HTTP download tests must avoid using a connection's HTTPS agent so they exercise the intended response failure. |
64 | 63 | - L-0052 (1×, #568): Client-side pre-RPC validation needs direct rejection assertions and a unit check that no RPC occurred, rather than an E2E hang harness. |
65 | | -- L-0053 (1×, #500): Thrift complex strings may contain bare date/timestamp literals and invalid JSON. Investigate swallowed parse failures with Arrow disabled when containers become empty. |
| 64 | +- L-0053 (1×, log:2026-11-11): Thrift complex strings may contain bare date/timestamp literals and invalid JSON. Investigate swallowed parse failures with Arrow disabled when containers become empty. |
66 | 65 | - L-0054 (2×, #600): Clamp Node timers to 2**31-1 ms. End-to-end cancellation must stop attempts and backoff sleeps, clearing timers and listeners. |
67 | 66 | - L-0055 (1×, #598): Retry non-idempotent execution only for proven pre-connection errors; connected-socket resets, broken pipes and timeouts may follow server delivery. |
68 | 67 | - L-0056 (1×, #590): Filter framing, auth and user-agent headers from caller overrides and keep managed-header lists identical across transports. |
69 | 68 | - L-0057 (1×, #595): ProxyAgent needs TLS options at its top level. Verify proxy TLS/mTLS with a real CONNECT proxy and generated test certificate. |
70 | 69 | - L-0058 (1×, #577): Merge Arrow result rows with indexed concatChunks copies. Preserve provider batches and track owned leftover slices with offsets. |
71 | 70 | - L-0059 (1×, #611): Every auxiliary HTTP request, including OAuth, exchange and CloudFetch, must use the connection provider's getAgent to honor proxy/TLS settings. |
72 | | -## Bot workflow and CI |
73 | 71 |
|
| 72 | +## Bot workflow and CI |
74 | 73 | - L-0060 (2×, #499): Use explicit bracket notation for hyphenated dispatch input names and string-typed numeric knobs in workflows also triggered by schedule. |
75 | 74 | - L-0061 (2×, #499): Omit unused prompt-file keys to use engine defaults; MODEL_ENDPOINT must name concrete serving-endpoints/model/invocations, not anthropic/invocations. |
76 | 75 | - L-0062 (2×, #499): Respect author-tool restrictions on workflow edits and route blocked fixes to a human. Verify actual remote branch HEAD before reporting a change as pushed. |
|
0 commit comments