@carllee1983/dbcli 1.10.1 → 1.11.0

package/dist/cli.mjs

@@ -31536,7 +31536,7 @@ var require_umd = __commonJS((exports, module) => {
   });
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/lib/bom-handling.js
+// node_modules/iconv-lite/lib/bom-handling.js
 var require_bom_handling2 = __commonJS((exports) => {
   var BOMChar = "\uFEFF";
   exports.PrependBOM = PrependBOMWrapper;
@@ -31579,7 +31579,7 @@ var require_bom_handling2 = __commonJS((exports) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/lib/helpers/merge-exports.js
+// node_modules/iconv-lite/lib/helpers/merge-exports.js
 var require_merge_exports = __commonJS((exports, module) => {
   var hasOwn = typeof Object.hasOwn === "undefined" ? Function.call.bind(Object.prototype.hasOwnProperty) : Object.hasOwn;
   function mergeModules(target, module2) {
@@ -31592,7 +31592,7 @@ var require_merge_exports = __commonJS((exports, module) => {
   module.exports = mergeModules;
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/internal.js
+// node_modules/iconv-lite/encodings/internal.js
 var require_internal2 = __commonJS((exports, module) => {
   var Buffer2 = require_safer().Buffer;
   module.exports = {
@@ -31765,7 +31765,7 @@ var require_internal2 = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/utf32.js
+// node_modules/iconv-lite/encodings/utf32.js
 var require_utf32 = __commonJS((exports) => {
   var Buffer2 = require_safer().Buffer;
   exports._utf32 = Utf32Codec;
@@ -31999,7 +31999,7 @@ var require_utf32 = __commonJS((exports) => {
   }
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/utf16.js
+// node_modules/iconv-lite/encodings/utf16.js
 var require_utf162 = __commonJS((exports) => {
   var Buffer2 = require_safer().Buffer;
   exports.utf16be = Utf16BECodec;
@@ -32142,7 +32142,7 @@ var require_utf162 = __commonJS((exports) => {
   }
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/utf7.js
+// node_modules/iconv-lite/encodings/utf7.js
 var require_utf72 = __commonJS((exports) => {
   var Buffer2 = require_safer().Buffer;
   exports.utf7 = Utf7Codec;
@@ -32356,7 +32356,7 @@ var require_utf72 = __commonJS((exports) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/sbcs-codec.js
+// node_modules/iconv-lite/encodings/sbcs-codec.js
 var require_sbcs_codec2 = __commonJS((exports) => {
   var Buffer2 = require_safer().Buffer;
   exports._sbcs = SBCSCodec;
@@ -32413,7 +32413,7 @@ var require_sbcs_codec2 = __commonJS((exports) => {
   SBCSDecoder.prototype.end = function() {};
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/sbcs-data.js
+// node_modules/iconv-lite/encodings/sbcs-data.js
 var require_sbcs_data2 = __commonJS((exports, module) => {
   module.exports = {
     10029: "maccenteuro",
@@ -32561,7 +32561,7 @@ var require_sbcs_data2 = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/sbcs-data-generated.js
+// node_modules/iconv-lite/encodings/sbcs-data-generated.js
 var require_sbcs_data_generated2 = __commonJS((exports, module) => {
   module.exports = {
     "437": "cp437",
@@ -33018,7 +33018,7 @@ var require_sbcs_data_generated2 = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/dbcs-codec.js
+// node_modules/iconv-lite/encodings/dbcs-codec.js
 var require_dbcs_codec2 = __commonJS((exports) => {
   var Buffer2 = require_safer().Buffer;
   exports._dbcs = DBCSCodec;
@@ -33476,7 +33476,7 @@ var require_dbcs_codec2 = __commonJS((exports) => {
   }
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/shiftjis.json
+// node_modules/iconv-lite/encodings/tables/shiftjis.json
 var require_shiftjis2 = __commonJS((exports, module) => {
   module.exports = [
     ["0", "\x00", 128],
@@ -33605,7 +33605,7 @@ var require_shiftjis2 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/eucjp.json
+// node_modules/iconv-lite/encodings/tables/eucjp.json
 var require_eucjp2 = __commonJS((exports, module) => {
   module.exports = [
     ["0", "\x00", 127],
@@ -33791,7 +33791,7 @@ var require_eucjp2 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/cp936.json
+// node_modules/iconv-lite/encodings/tables/cp936.json
 var require_cp9362 = __commonJS((exports, module) => {
   module.exports = [
     ["0", "\x00", 127, "\u20AC"],
@@ -34059,7 +34059,7 @@ var require_cp9362 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/gbk-added.json
+// node_modules/iconv-lite/encodings/tables/gbk-added.json
 var require_gbk_added2 = __commonJS((exports, module) => {
   module.exports = [
     ["a140", "\uE4C6", 62],
@@ -34119,12 +34119,12 @@ var require_gbk_added2 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/gb18030-ranges.json
+// node_modules/iconv-lite/encodings/tables/gb18030-ranges.json
 var require_gb18030_ranges2 = __commonJS((exports, module) => {
   module.exports = { uChars: [128, 165, 169, 178, 184, 216, 226, 235, 238, 244, 248, 251, 253, 258, 276, 284, 300, 325, 329, 334, 364, 463, 465, 467, 469, 471, 473, 475, 477, 506, 594, 610, 712, 716, 730, 930, 938, 962, 970, 1026, 1104, 1106, 8209, 8215, 8218, 8222, 8231, 8241, 8244, 8246, 8252, 8365, 8452, 8454, 8458, 8471, 8482, 8556, 8570, 8596, 8602, 8713, 8720, 8722, 8726, 8731, 8737, 8740, 8742, 8748, 8751, 8760, 8766, 8777, 8781, 8787, 8802, 8808, 8816, 8854, 8858, 8870, 8896, 8979, 9322, 9372, 9548, 9588, 9616, 9622, 9634, 9652, 9662, 9672, 9676, 9680, 9702, 9735, 9738, 9793, 9795, 11906, 11909, 11913, 11917, 11928, 11944, 11947, 11951, 11956, 11960, 11964, 11979, 12284, 12292, 12312, 12319, 12330, 12351, 12436, 12447, 12535, 12543, 12586, 12842, 12850, 12964, 13200, 13215, 13218, 13253, 13263, 13267, 13270, 13384, 13428, 13727, 13839, 13851, 14617, 14703, 14801, 14816, 14964, 15183, 15471, 15585, 16471, 16736, 17208, 17325, 17330, 17374, 17623, 17997, 18018, 18212, 18218, 18301, 18318, 18760, 18811, 18814, 18820, 18823, 18844, 18848, 18872, 19576, 19620, 19738, 19887, 40870, 59244, 59336, 59367, 59413, 59417, 59423, 59431, 59437, 59443, 59452, 59460, 59478, 59493, 63789, 63866, 63894, 63976, 63986, 64016, 64018, 64021, 64025, 64034, 64037, 64042, 65074, 65093, 65107, 65112, 65127, 65132, 65375, 65510, 65536], gbChars: [0, 36, 38, 45, 50, 81, 89, 95, 96, 100, 103, 104, 105, 109, 126, 133, 148, 172, 175, 179, 208, 306, 307, 308, 309, 310, 311, 312, 313, 341, 428, 443, 544, 545, 558, 741, 742, 749, 750, 805, 819, 820, 7922, 7924, 7925, 7927, 7934, 7943, 7944, 7945, 7950, 8062, 8148, 8149, 8152, 8164, 8174, 8236, 8240, 8262, 8264, 8374, 8380, 8381, 8384, 8388, 8390, 8392, 8393, 8394, 8396, 8401, 8406, 8416, 8419, 8424, 8437, 8439, 8445, 8482, 8485, 8496, 8521, 8603, 8936, 8946, 9046, 9050, 9063, 9066, 9076, 9092, 9100, 9108, 9111, 9113, 9131, 9162, 9164, 9218, 9219, 11329, 11331, 11334, 11336, 11346, 11361, 11363, 11366, 11370, 11372, 11375, 11389, 11682, 11686, 11687, 11692, 11694, 11714, 11716, 11723, 11725, 11730, 11736, 11982, 11989, 12102, 12336, 12348, 12350, 12384, 12393, 12395, 12397, 12510, 12553, 12851, 12962, 12973, 13738, 13823, 13919, 13933, 14080, 14298, 14585, 14698, 15583, 15847, 16318, 16434, 16438, 16481, 16729, 17102, 17122, 17315, 17320, 17402, 17418, 17859, 17909, 17911, 17915, 17916, 17936, 17939, 17961, 18664, 18703, 18814, 18962, 19043, 33469, 33470, 33471, 33484, 33485, 33490, 33497, 33501, 33505, 33513, 33520, 33536, 33550, 37845, 37921, 37948, 38029, 38038, 38064, 38065, 38066, 38069, 38075, 38076, 38078, 39108, 39109, 39113, 39114, 39115, 39116, 39265, 39394, 189000] };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/cp949.json
+// node_modules/iconv-lite/encodings/tables/cp949.json
 var require_cp9492 = __commonJS((exports, module) => {
   module.exports = [
     ["0", "\x00", 127],
@@ -34401,7 +34401,7 @@ var require_cp9492 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/cp950.json
+// node_modules/iconv-lite/encodings/tables/cp950.json
 var require_cp9502 = __commonJS((exports, module) => {
   module.exports = [
     ["0", "\x00", 127],
@@ -34582,7 +34582,7 @@ var require_cp9502 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/tables/big5-added.json
+// node_modules/iconv-lite/encodings/tables/big5-added.json
 var require_big5_added2 = __commonJS((exports, module) => {
   module.exports = [
     ["8740", "\u43F0\u4C32\u4603\u45A6\u4578\uD85C\uDE67\u4D77\u45B3\uD85F\uDCB1\u4CE2\uD85F\uDCC5\u3B95\u4736\u4744\u4C47\u4C40\uD850\uDEBF\uD84D\uDE17\uD85C\uDF52\uD85B\uDE8B\uD85C\uDCD2\u4C57\uD868\uDF51\u474F\u45DA\u4C85\uD85F\uDC6C\u4D07\u4AA4\u46A1\uD85A\uDF23\u7225\uD856\uDE54\uD846\uDE63\uD84F\uDE06\uD84F\uDF61\u664D\u56FB"],
@@ -34708,7 +34708,7 @@ var require_big5_added2 = __commonJS((exports, module) => {
   ];
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/dbcs-data.js
+// node_modules/iconv-lite/encodings/dbcs-data.js
 var require_dbcs_data2 = __commonJS((exports, module) => {
   module.exports = {
     shiftjis: {
@@ -34879,7 +34879,7 @@ var require_dbcs_data2 = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/encodings/index.js
+// node_modules/iconv-lite/encodings/index.js
 var require_encodings2 = __commonJS((exports, module) => {
   var mergeModules = require_merge_exports();
   var modules = [
@@ -34901,7 +34901,7 @@ var require_encodings2 = __commonJS((exports, module) => {
   var i;
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/lib/streams.js
+// node_modules/iconv-lite/lib/streams.js
 var require_streams2 = __commonJS((exports, module) => {
   var Buffer2 = require_safer().Buffer;
   module.exports = function(streamModule) {
@@ -34999,7 +34999,7 @@ var require_streams2 = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/mysql2/node_modules/iconv-lite/lib/index.js
+// node_modules/iconv-lite/lib/index.js
 var require_lib7 = __commonJS((exports, module) => {
   var Buffer2 = require_safer().Buffer;
   var bomHandling = require_bom_handling2();
@@ -35334,20 +35334,16 @@ var require_packet = __commonJS((exports, module) => {
     readInt64() {
       const word0 = this.readInt32();
       const word1 = this.readInt32();
-      let res = new Long(word0, word1, true);
+      const res = new Long(word0, word1, true);
       const resNumber = res.toNumber();
-      const resString = res.toString();
-      res = resNumber.toString() === resString ? resNumber : resString;
-      return res;
+      return Number.isSafeInteger(resNumber) ? resNumber : res.toString();
     }
     readSInt64() {
       const word0 = this.readInt32();
       const word1 = this.readInt32();
-      let res = new Long(word0, word1, false);
+      const res = new Long(word0, word1, false);
       const resNumber = res.toNumber();
-      const resString = res.toString();
-      res = resNumber.toString() === resString ? resNumber : resString;
-      return res;
+      return Number.isSafeInteger(resNumber) ? resNumber : res.toString();
     }
     isEOF() {
       return this.buffer[this.offset] === 254 && this.length() < 13;
@@ -35392,8 +35388,10 @@ var require_packet = __commonJS((exports, module) => {
         res = new Long(word0, word1, !signed);
         const resNumber = res.toNumber();
         const resString = res.toString();
-        res = resNumber.toString() === resString ? resNumber : resString;
-        return bigNumberStrings ? resString : res;
+        if (bigNumberStrings || !Number.isSafeInteger(resNumber)) {
+          return resString;
+        }
+        return resNumber;
       }
       console.trace();
       throw new Error(`Should not reach here: ${tag}`);
@@ -35450,6 +35448,9 @@ var require_packet = __commonJS((exports, module) => {
         return new Date(y, m - 1, d, H, M, S, ms);
       }
       let str = this.readDateTimeString(6, "T", null);
+      if (!str) {
+        return INVALID_DATE;
+      }
       if (str.length === 10) {
         str += "T00:00:00";
       }
@@ -35587,7 +35588,7 @@ var require_packet = __commonJS((exports, module) => {
         if (numDigits >= 15) {
           str = this.readString(end - this.offset, "binary");
           result = parseInt(str, 10);
-          if (result.toString() === str) {
+          if (Number.isSafeInteger(sign * result)) {
             return sign * result;
           }
           return sign === -1 ? `-${str}` : str;
@@ -35609,11 +35610,10 @@ var require_packet = __commonJS((exports, module) => {
       if (!supportBigNumbers) {
         return num;
       }
-      str = this.buffer.toString("ascii", start, end);
-      if (num.toString() === str) {
+      if (Number.isSafeInteger(num)) {
         return num;
       }
-      return str;
+      return this.buffer.toString("ascii", start, end);
     }
     parseIntNoBigCheck(len) {
       if (len === null) {
@@ -36400,6 +36400,7 @@ var require_commands = __commonJS((exports, module) => {
     STMT_FETCH: 28,
     DAEMON: 29,
     BINLOG_DUMP_GTID: 30,
+    RESET_CONNECTION: 31,
     UNKNOWN: 255
   };
 });
@@ -36458,6 +36459,7 @@ var require_client3 = __commonJS((exports) => {
   exports.PLUGIN_AUTH_LENENC_CLIENT_DATA = 2097152;
   exports.CAN_HANDLE_EXPIRED_PASSWORDS = 4194304;
   exports.SESSION_TRACK = 8388608;
+  exports.CLIENT_QUERY_ATTRIBUTES = 134217728;
   exports.SSL_VERIFY_SERVER_CERT = 1073741824;
   exports.REMEMBER_OPTIONS = 2147483648;
   exports.MULTI_FACTOR_AUTHENTICATION = 268435456;
@@ -37173,17 +37175,15 @@ var require_cursor = __commonJS((exports, module) => {
     NO_CURSOR: 0,
     READ_ONLY: 1,
     FOR_UPDATE: 2,
-    SCROLLABLE: 3
+    SCROLLABLE: 3,
+    PARAMETER_COUNT_AVAILABLE: 8
   };
 });
 
-// node_modules/mysql2/lib/packets/execute.js
-var require_execute = __commonJS((exports, module) => {
-  var CursorType = require_cursor();
-  var CommandCodes = require_commands();
+// node_modules/mysql2/lib/packets/encode_parameter.js
+var require_encode_parameter = __commonJS((exports, module) => {
   var Types = require_types();
   var Packet = require_packet();
-  var CharsetToEncoding = require_charset_encodings();
   function isJSON(value) {
     return Array.isArray(value) || value.constructor === Object || typeof value.toJSON === "function" && !Buffer.isBuffer(value);
   }
@@ -37235,13 +37235,27 @@ var require_execute = __commonJS((exports, module) => {
     }
     return { value, type, length, writer };
   }
+  module.exports = { toParameter, isJSON };
+});
+
+// node_modules/mysql2/lib/packets/execute.js
+var require_execute = __commonJS((exports, module) => {
+  var CursorType = require_cursor();
+  var CommandCodes = require_commands();
+  var ClientConstants = require_client3();
+  var Types = require_types();
+  var Packet = require_packet();
+  var CharsetToEncoding = require_charset_encodings();
+  var { toParameter } = require_encode_parameter();
 
   class Execute {
-    constructor(id, parameters, charsetNumber, timezone) {
+    constructor(id, parameters, charsetNumber, timezone, attributes, clientFlags) {
       this.id = id;
       this.parameters = parameters;
       this.encoding = CharsetToEncoding[charsetNumber];
       this.timezone = timezone;
+      this.attributes = attributes;
+      this.clientFlags = clientFlags || 0;
     }
     static fromPacket(packet, encoding) {
       const stmtId = packet.readInt32();
@@ -37283,27 +37297,32 @@ var require_execute = __commonJS((exports, module) => {
       }
       return { stmtId, flags, iterationCount, values };
     }
-    toPacket() {
-      let length = 14;
-      let parameters;
-      if (this.parameters && this.parameters.length > 0) {
-        length += Math.floor((this.parameters.length + 7) / 8);
-        length += 1;
-        length += 2 * this.parameters.length;
-        parameters = this.parameters.map((value) => toParameter(value, this.encoding, this.timezone));
-        length += parameters.reduce((accumulator, parameter) => accumulator + parameter.length, 0);
-      }
-      const buffer = Buffer.allocUnsafe(length);
-      const packet = new Packet(0, buffer, 0, length);
+    _serializeToBuffer(buffer) {
+      const useQueryAttributes = this.clientFlags & ClientConstants.CLIENT_QUERY_ATTRIBUTES;
+      const attrNames = useQueryAttributes && this.attributes ? Object.keys(this.attributes) : [];
+      const numParams = this.parameters ? this.parameters.length : 0;
+      const numAttrs = attrNames.length;
+      const totalParams = numParams + numAttrs;
+      const packet = new Packet(0, buffer, 0, buffer.length);
       packet.offset = 4;
       packet.writeInt8(CommandCodes.STMT_EXECUTE);
       packet.writeInt32(this.id);
-      packet.writeInt8(CursorType.NO_CURSOR);
+      let cursorFlags = CursorType.NO_CURSOR;
+      if (useQueryAttributes) {
+        cursorFlags |= CursorType.PARAMETER_COUNT_AVAILABLE;
+      }
+      packet.writeInt8(cursorFlags);
       packet.writeInt32(1);
-      if (parameters) {
+      if (useQueryAttributes) {
+        packet.writeLengthCodedNumber(totalParams);
+      }
+      if (totalParams > 0) {
+        const bindParams = numParams > 0 ? this.parameters.map((v) => toParameter(v, this.encoding, this.timezone)) : [];
+        const attrParams = attrNames.map((name) => toParameter(this.attributes[name], this.encoding, this.timezone));
+        const allParams = bindParams.concat(attrParams);
         let bitmap = 0;
         let bitValue = 1;
-        parameters.forEach((parameter) => {
+        allParams.forEach((parameter) => {
           if (parameter.type === Types.NULL) {
             bitmap += bitValue;
           }
@@ -37318,11 +37337,15 @@ var require_execute = __commonJS((exports, module) => {
           packet.writeInt8(bitmap);
         }
         packet.writeInt8(1);
-        parameters.forEach((parameter) => {
-          packet.writeInt8(parameter.type);
+        for (let i = 0;i < allParams.length; i++) {
+          packet.writeInt8(allParams[i].type);
           packet.writeInt8(0);
-        });
-        parameters.forEach((parameter) => {
+          if (useQueryAttributes) {
+            const name = i < numParams ? "" : attrNames[i - numParams];
+            packet.writeLengthCodedString(name, this.encoding);
+          }
+        }
+        allParams.forEach((parameter) => {
           if (parameter.type !== Types.NULL) {
             parameter.writer.call(packet, parameter.value);
           }
@@ -37330,6 +37353,10 @@ var require_execute = __commonJS((exports, module) => {
       }
       return packet;
     }
+    toPacket() {
+      const p = this._serializeToBuffer(Packet.MockBuffer());
+      return this._serializeToBuffer(Buffer.allocUnsafe(p.offset));
+    }
   }
   module.exports = Execute;
 });
@@ -37527,11 +37554,11 @@ var require_handshake_response = __commonJS((exports, module) => {
       const p = this.serializeResponse(Packet.MockBuffer());
       return this.serializeResponse(Buffer.alloc(p.offset));
     }
-    static fromPacket(packet) {
+    static fromPacket(packet, serverFlags = 4294967295) {
       const args = {};
       args.clientFlags = packet.readInt32();
       function isSet(flag) {
-        return args.clientFlags & ClientConstants[flag];
+        return args.clientFlags & serverFlags & ClientConstants[flag];
       }
       args.maxPacketSize = packet.readInt32();
       args.charsetNumber = packet.readInt8();
@@ -37618,23 +37645,79 @@ var require_query3 = __commonJS((exports, module) => {
   var CommandCode = require_commands();
   var StringParser = require_string();
   var CharsetToEncoding = require_charset_encodings();
+  var ClientConstants = require_client3();
+  var Types = require_types();
+  var { toParameter } = require_encode_parameter();
 
   class Query2 {
-    constructor(sql, charsetNumber) {
+    constructor(sql, charsetNumber, attributes, clientFlags) {
       this.query = sql;
       this.charsetNumber = charsetNumber;
       this.encoding = CharsetToEncoding[charsetNumber];
+      this.attributes = attributes;
+      this.clientFlags = clientFlags || 0;
     }
-    toPacket() {
-      const buf = StringParser.encode(this.query, this.encoding);
-      const length = 5 + buf.length;
-      const buffer = Buffer.allocUnsafe(length);
-      const packet = new Packet(0, buffer, 0, length);
+    serializeToBuffer(buffer) {
+      const useQueryAttributes = this.clientFlags & ClientConstants.CLIENT_QUERY_ATTRIBUTES;
+      const sqlBuf = StringParser.encode(this.query, this.encoding);
+      const packet = new Packet(0, buffer, 0, buffer.length);
       packet.offset = 4;
       packet.writeInt8(CommandCode.QUERY);
-      packet.writeBuffer(buf);
+      if (useQueryAttributes) {
+        const attrs = this.attributes;
+        const names = attrs ? Object.keys(attrs) : [];
+        const paramCount = names.length;
+        packet.writeLengthCodedNumber(paramCount);
+        packet.writeLengthCodedNumber(1);
+        if (paramCount > 0) {
+          const parameters = names.map((name) => toParameter(attrs[name], this.encoding, "local"));
+          let bitmap = 0;
+          let bitValue = 1;
+          parameters.forEach((parameter) => {
+            if (parameter.type === Types.NULL) {
+              bitmap += bitValue;
+            }
+            bitValue *= 2;
+            if (bitValue === 256) {
+              packet.writeInt8(bitmap);
+              bitmap = 0;
+              bitValue = 1;
+            }
+          });
+          if (bitValue !== 1) {
+            packet.writeInt8(bitmap);
+          }
+          packet.writeInt8(1);
+          for (let i = 0;i < paramCount; i++) {
+            packet.writeInt8(parameters[i].type);
+            packet.writeInt8(0);
+            packet.writeLengthCodedString(names[i], this.encoding);
+          }
+          parameters.forEach((parameter) => {
+            if (parameter.type !== Types.NULL) {
+              parameter.writer.call(packet, parameter.value);
+            }
+          });
+        }
+      }
+      packet.writeBuffer(sqlBuf);
       return packet;
     }
+    toPacket() {
+      const useQueryAttributes = this.clientFlags & ClientConstants.CLIENT_QUERY_ATTRIBUTES;
+      if (!useQueryAttributes) {
+        const buf = StringParser.encode(this.query, this.encoding);
+        const length = 5 + buf.length;
+        const buffer = Buffer.allocUnsafe(length);
+        const packet = new Packet(0, buffer, 0, length);
+        packet.offset = 4;
+        packet.writeInt8(CommandCode.QUERY);
+        packet.writeBuffer(buf);
+        return packet;
+      }
+      const p = this.serializeToBuffer(Packet.MockBuffer());
+      return this.serializeToBuffer(Buffer.allocUnsafe(p.offset));
+    }
   }
   module.exports = Query2;
 });
@@ -37676,6 +37759,23 @@ var require_register_slave = __commonJS((exports, module) => {
   module.exports = RegisterSlave;
 });
 
+// node_modules/mysql2/lib/packets/reset_connection.js
+var require_reset_connection = __commonJS((exports, module) => {
+  var Packet = require_packet();
+  var CommandCodes = require_commands();
+
+  class ResetConnection {
+    constructor() {}
+    toPacket() {
+      const packet = new Packet(0, Buffer.alloc(5), 0, 5);
+      packet.offset = 4;
+      packet.writeInt8(CommandCodes.RESET_CONNECTION);
+      return packet;
+    }
+  }
+  module.exports = ResetConnection;
+});
+
 // node_modules/mysql2/lib/constants/server_status.js
 var require_server_status = __commonJS((exports) => {
   exports.SERVER_STATUS_IN_TRANS = 1;
@@ -37791,7 +37891,7 @@ var require_resultset_header = __commonJS((exports, module) => {
       let stateChanges = null;
       if (isSet("SESSION_TRACK") && packet.offset < packet.end) {
         this.info = packet.readLengthCodedString(encoding);
-        if (this.serverStatus && ServerSatusFlags.SERVER_SESSION_STATE_CHANGED) {
+        if (this.serverStatus & ServerSatusFlags.SERVER_SESSION_STATE_CHANGED) {
           let len = packet.offset < packet.end ? packet.readLengthCodedNumber() : 0;
           const end = packet.offset + len;
           let type, key2, stateEnd;
@@ -37950,6 +38050,7 @@ var require_packets = __commonJS((exports, module) => {
   var PreparedStatementHeader = require_prepared_statement_header();
   var Query2 = require_query3();
   var RegisterSlave = require_register_slave();
+  var ResetConnection = require_reset_connection();
   var ResultSetHeader = require_resultset_header();
   var SSLRequest = require_ssl_request();
   var TextRow = require_text_row();
@@ -37970,6 +38071,7 @@ var require_packets = __commonJS((exports, module) => {
     PreparedStatementHeader,
     Query: Query2,
     RegisterSlave,
+    ResetConnection,
     ResultSetHeader,
     SSLRequest,
     TextRow
@@ -38320,6 +38422,15 @@ var require_auth_switch = __commonJS((exports, module) => {
       });
       return;
     }
+    if (pluginName === "mysql_clear_password") {
+      const hasCustomPlugin = connection.config.authPlugins && Object.prototype.hasOwnProperty.call(connection.config.authPlugins, "mysql_clear_password");
+      if (!hasCustomPlugin && !connection.config.enableCleartextPlugin) {
+        const err = new Error("Server requested authentication using mysql_clear_password, " + "which sends the password in plaintext over the network and is " + "disabled by default. To enable it, set the `enableCleartextPlugin` " + "option to `true` in your connection configuration, or provide a " + "custom `mysql_clear_password` auth plugin via the `authPlugins` " + "option. Only use this over a secure connection (TLS/SSL).");
+        err.code = "MYSQL_CLEAR_PASSWORD_NOT_ENABLED";
+        err.fatal = true;
+        throw err;
+      }
+    }
     const authPlugin = getAuthPlugin(pluginName, connection);
     if (!authPlugin) {
       throw new Error(`Server requests authentication using unknown plugin ${pluginName}. See ${"TODO: add plugins doco here"} on how to configure or author authentication plugins.`);
@@ -38539,7 +38650,7 @@ var require_client_handshake = __commonJS((exports, module) => {
       ]).slice(0, 20) : Buffer.alloc(20);
       const hasCustomAuthPlugin = connection.config.authPlugins && Object.prototype.hasOwnProperty.call(connection.config.authPlugins, serverAuthMethod);
       const hasLegacyAuthSwitchHandler = typeof connection.config.authSwitchHandler === "function";
-      const canUseDirectAuth = !hasCustomAuthPlugin && !hasLegacyAuthSwitchHandler && this.canUseAuthMethodDirectly(serverAuthMethod, isSecureConnection);
+      const canUseDirectAuth = !hasCustomAuthPlugin && !hasLegacyAuthSwitchHandler && this.canUseAuthMethodDirectly(serverAuthMethod, isSecureConnection) && (serverAuthMethod !== "mysql_clear_password" || connection.config.enableCleartextPlugin);
       const clientAuthMethod = canUseDirectAuth ? serverAuthMethod : "mysql_native_password";
       const authToken = this.calculateAuthToken(clientAuthMethod, this.password, authPluginData);
       if (connection.config.debug) {
@@ -38682,7 +38793,9 @@ var require_client_handshake = __commonJS((exports, module) => {
           }
           return ClientHandshake.prototype.handshakeResult;
         } catch (err) {
-          err.code = "AUTH_SWITCH_PLUGIN_ERROR";
+          if (!err.code) {
+            err.code = "AUTH_SWITCH_PLUGIN_ERROR";
+          }
           err.fatal = true;
           if (this.onResult) {
             this.onResult(err);
@@ -38744,7 +38857,7 @@ var require_server_handshake = __commonJS((exports, module) => {
       return ServerHandshake.prototype.readClientReply;
     }
     readClientReply(packet, connection) {
-      const clientHelloReply = Packets.HandshakeResponse.fromPacket(packet);
+      const clientHelloReply = Packets.HandshakeResponse.fromPacket(packet, this.args.capabilityFlags);
       connection.clientHelloReply = clientHelloReply;
       if (this.args.authCallback) {
         this.args.authCallback({
@@ -39748,7 +39861,8 @@ var require_query4 = __commonJS((exports, module) => {
       this._connection = connection;
       this.options = Object.assign({}, connection.config, this._queryOptions);
       this._setTimeout();
-      const cmdPacket = new Packets.Query(this.sql, connection.config.charsetNumber);
+      const clientFlags = connection.config.clientFlags & (connection.serverCapabilityFlags || 0);
+      const cmdPacket = new Packets.Query(this.sql, connection.config.charsetNumber, this._queryOptions.attributes, clientFlags);
       connection.writePacket(cmdPacket.toPacket(1));
       return Query2.prototype.resultsetHeader;
     }
@@ -40377,7 +40491,8 @@ var require_execute2 = __commonJS((exports, module) => {
       this._connection = connection;
       this.options = Object.assign({}, connection.config, this._executeOptions);
       this._setTimeout();
-      const executePacket = new Packets.Execute(this.statement.id, this.parameters, connection.config.charsetNumber, connection.config.timezone);
+      const clientFlags = connection.config.clientFlags & (connection.serverCapabilityFlags || 0);
+      const executePacket = new Packets.Execute(this.statement.id, this.parameters, connection.config.charsetNumber, connection.config.timezone, this._executeOptions.attributes, clientFlags);
       try {
         connection.writePacket(executePacket.toPacket(1));
       } catch (error) {
@@ -40838,6 +40953,34 @@ var require_change_user2 = __commonJS((exports, module) => {
   module.exports = ChangeUser;
 });
 
+// node_modules/mysql2/lib/commands/reset_connection.js
+var require_reset_connection2 = __commonJS((exports, module) => {
+  var Command2 = require_command2();
+  var Packets = require_packets();
+
+  class ResetConnection extends Command2 {
+    constructor(callback) {
+      super();
+      this.onResult = callback;
+    }
+    start(packet, connection) {
+      const req = new Packets.ResetConnection;
+      connection.writePacket(req.toPacket());
+      return ResetConnection.prototype.resetConnectionResponse;
+    }
+    resetConnectionResponse(packet, connection) {
+      if (connection._statements) {
+        connection._statements.clear();
+      }
+      if (this.onResult) {
+        process.nextTick(this.onResult.bind(this, null));
+      }
+      return null;
+    }
+  }
+  module.exports = ResetConnection;
+});
+
 // node_modules/mysql2/lib/commands/quit.js
 var require_quit = __commonJS((exports, module) => {
   var Command2 = require_command2();
@@ -40874,6 +41017,7 @@ var require_commands2 = __commonJS((exports, module) => {
   var RegisterSlave = require_register_slave2();
   var BinlogDump = require_binlog_dump2();
   var ChangeUser = require_change_user2();
+  var ResetConnection = require_reset_connection2();
   var Quit = require_quit();
   module.exports = {
     ClientHandshake,
@@ -40886,6 +41030,7 @@ var require_commands2 = __commonJS((exports, module) => {
     RegisterSlave,
     BinlogDump,
     ChangeUser,
+    ResetConnection,
     Quit
   };
 });
@@ -40894,7 +41039,7 @@ var require_commands2 = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "mysql2",
-    version: "3.20.0",
+    version: "3.22.3",
     description: "fast mysql driver. Implements core protocol, prepared statements, ssl and compression in native JS",
     main: "index.js",
     typings: "typings/mysql/index",
@@ -40962,7 +41107,7 @@ var require_package = __commonJS((exports, module) => {
     devDependencies: {
       "@eslint/eslintrc": "^3.3.3",
       "@eslint/js": "^9.39.2",
-      "@eslint/markdown": "^7.5.1",
+      "@eslint/markdown": "^8.0.1",
       "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
       "@pokujs/multi-suite": "^1.0.0",
       "@rollup/plugin-commonjs": "^29.0.2",
@@ -44177,11 +44322,13 @@ var require_connection_config = __commonJS((exports, module) => {
     uri: 1,
     user: 1,
     disableEval: 1,
+    enableCleartextPlugin: 1,
     connectionLimit: 1,
     maxIdle: 1,
     idleTimeout: 1,
     Promise: 1,
     queueLimit: 1,
+    resetOnRelease: 1,
     waitForConnections: 1,
     jsonStrings: 1,
     gracefulEnd: 1
@@ -44247,6 +44394,7 @@ var require_connection_config = __commonJS((exports, module) => {
       this.nestTables = options.nestTables === undefined ? undefined : options.nestTables;
       this.typeCast = options.typeCast === undefined ? true : options.typeCast;
       this.disableEval = Boolean(options.disableEval);
+      this.enableCleartextPlugin = Boolean(options.enableCleartextPlugin);
       if (this.timezone[0] === " ") {
         this.timezone = `+${this.timezone.slice(1)}`;
       }
@@ -44313,7 +44461,8 @@ var require_connection_config = __commonJS((exports, module) => {
         "MULTI_RESULTS",
         "TRANSACTIONS",
         "SESSION_TRACK",
-        "CONNECT_ATTRS"
+        "CONNECT_ATTRS",
+        "CLIENT_QUERY_ATTRIBUTES"
       ];
       if (options && options.multipleStatements) {
         defaultFlags.push("MULTI_STATEMENTS");
@@ -45247,6 +45396,9 @@ var require_connection2 = __commonJS((exports, module) => {
     ping(cb) {
       return this.addCommand(new Commands.Ping(cb));
     }
+    reset(cb) {
+      return this.addCommand(new Commands.ResetConnection(cb));
+    }
     _registerSlave(opts, cb) {
       return this.addCommand(new Commands.RegisterSlave(opts, cb));
     }
@@ -45407,18 +45559,34 @@ var require_connection2 = __commonJS((exports, module) => {
   module.exports = BaseConnection;
 });
 
+// node_modules/mysql2/lib/promise/capture_local_err.js
+var require_capture_local_err = __commonJS((exports, module) => {
+  function captureStackHolder(constructorOpt) {
+    const holder = {};
+    Error.captureStackTrace(holder, constructorOpt);
+    return holder;
+  }
+  function applyCapturedStack(err, holder) {
+    const stack = holder && holder.stack;
+    if (typeof stack !== "string" || !stack)
+      return;
+    const lines2 = stack.split(`
+`);
+    lines2[0] = `${err.name}: ${err.message}`;
+    err.stack = lines2.join(`
+`);
+  }
+  module.exports = { captureStackHolder, applyCapturedStack };
+});
+
 // node_modules/mysql2/lib/promise/make_done_cb.js
 var require_make_done_cb = __commonJS((exports, module) => {
-  function makeDoneCb(resolve2, reject, localErr) {
+  var { applyCapturedStack } = require_capture_local_err();
+  function makeDoneCb(resolve2, reject, stackHolder) {
     return function(err, rows, fields) {
       if (err) {
-        localErr.message = err.message;
-        localErr.code = err.code;
-        localErr.errno = err.errno;
-        localErr.sql = err.sql;
-        localErr.sqlState = err.sqlState;
-        localErr.sqlMessage = err.sqlMessage;
-        reject(localErr);
+        applyCapturedStack(err, stackHolder);
+        reject(err);
       } else {
         resolve2([rows, fields]);
       }
@@ -45429,6 +45597,7 @@ var require_make_done_cb = __commonJS((exports, module) => {
 
 // node_modules/mysql2/lib/promise/prepared_statement_info.js
 var require_prepared_statement_info = __commonJS((exports, module) => {
+  var { captureStackHolder } = require_capture_local_err();
   var makeDoneCb = require_make_done_cb();
 
   class PromisePreparedStatementInfo {
@@ -45438,9 +45607,9 @@ var require_prepared_statement_info = __commonJS((exports, module) => {
     }
     execute(parameters) {
       const s = this.statement;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePreparedStatementInfo.prototype.execute);
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         if (parameters) {
           s.execute(parameters, done);
         } else {
@@ -45484,6 +45653,10 @@ var require_inherit_events = __commonJS((exports, module) => {
 var require_connection3 = __commonJS((exports, module) => {
   var EventEmitter = __require("events").EventEmitter;
   var PromisePreparedStatementInfo = require_prepared_statement_info();
+  var {
+    captureStackHolder,
+    applyCapturedStack
+  } = require_capture_local_err();
   var makeDoneCb = require_make_done_cb();
   var inheritEvents = require_inherit_events();
   var BaseConnection = require_connection2();
@@ -45506,12 +45679,12 @@ var require_connection3 = __commonJS((exports, module) => {
     }
     query(query, params) {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.query);
       if (typeof params === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         if (params !== undefined) {
           c.query(query, params, done);
         } else {
@@ -45521,12 +45694,12 @@ var require_connection3 = __commonJS((exports, module) => {
     }
     execute(query, params) {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.execute);
       if (typeof params === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         if (params !== undefined) {
           c.execute(query, params, done);
         } else {
@@ -45546,58 +45719,64 @@ var require_connection3 = __commonJS((exports, module) => {
     }
     beginTransaction() {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.beginTransaction);
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         c.beginTransaction(done);
       });
     }
     commit() {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.commit);
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         c.commit(done);
       });
     }
     rollback() {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.rollback);
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         c.rollback(done);
       });
     }
     ping() {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.ping);
       return new this.Promise((resolve2, reject) => {
         c.ping((err) => {
           if (err) {
-            localErr.message = err.message;
-            localErr.code = err.code;
-            localErr.errno = err.errno;
-            localErr.sqlState = err.sqlState;
-            localErr.sqlMessage = err.sqlMessage;
-            reject(localErr);
+            applyCapturedStack(err, stackHolder);
+            reject(err);
           } else {
             resolve2(true);
           }
         });
       });
     }
+    reset() {
+      const c = this.connection;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.reset);
+      return new this.Promise((resolve2, reject) => {
+        c.reset((err) => {
+          if (err) {
+            applyCapturedStack(err, stackHolder);
+            reject(err);
+          } else {
+            resolve2();
+          }
+        });
+      });
+    }
     connect() {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.connect);
       return new this.Promise((resolve2, reject) => {
         c.connect((err, param) => {
           if (err) {
-            localErr.message = err.message;
-            localErr.code = err.code;
-            localErr.errno = err.errno;
-            localErr.sqlState = err.sqlState;
-            localErr.sqlMessage = err.sqlMessage;
-            reject(localErr);
+            applyCapturedStack(err, stackHolder);
+            reject(err);
           } else {
             resolve2(param);
           }
@@ -45607,16 +45786,12 @@ var require_connection3 = __commonJS((exports, module) => {
     prepare(options) {
       const c = this.connection;
       const promiseImpl = this.Promise;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.prepare);
       return new this.Promise((resolve2, reject) => {
         c.prepare(options, (err, statement) => {
           if (err) {
-            localErr.message = err.message;
-            localErr.code = err.code;
-            localErr.errno = err.errno;
-            localErr.sqlState = err.sqlState;
-            localErr.sqlMessage = err.sqlMessage;
-            reject(localErr);
+            applyCapturedStack(err, stackHolder);
+            reject(err);
           } else {
             const wrappedStatement = new PromisePreparedStatementInfo(statement, promiseImpl);
             resolve2(wrappedStatement);
@@ -45626,16 +45801,12 @@ var require_connection3 = __commonJS((exports, module) => {
     }
     changeUser(options) {
       const c = this.connection;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromiseConnection.prototype.changeUser);
       return new this.Promise((resolve2, reject) => {
         c.changeUser(options, (err) => {
           if (err) {
-            localErr.message = err.message;
-            localErr.code = err.code;
-            localErr.errno = err.errno;
-            localErr.sqlState = err.sqlState;
-            localErr.sqlMessage = err.sqlMessage;
-            reject(localErr);
+            applyCapturedStack(err, stackHolder);
+            reject(err);
           } else {
             resolve2();
           }
@@ -45873,7 +46044,29 @@ var require_pool = __commonJS((exports, module) => {
           cb = this._connectionQueue.shift();
           process4.nextTick(this.getConnection.bind(this, cb));
         }
-      } else if (this._connectionQueue.length) {
+        return;
+      }
+      if (this.config.resetOnRelease && connection.reset) {
+        connection.reset((err) => {
+          if (err) {
+            connection._pool = null;
+            spliceConnection(this._allConnections, connection);
+            connection.destroy();
+            if (this._connectionQueue.length) {
+              cb = this._connectionQueue.shift();
+              process4.nextTick(this.getConnection.bind(this, cb));
+            }
+            return;
+          }
+          this._handleSuccessfulRelease(connection);
+        });
+      } else {
+        this._handleSuccessfulRelease(connection);
+      }
+    }
+    _handleSuccessfulRelease(connection) {
+      let cb;
+      if (this._connectionQueue.length) {
         cb = this._connectionQueue.shift();
         process4.nextTick(() => {
           connection._released = false;
@@ -46025,6 +46218,10 @@ var require_pool = __commonJS((exports, module) => {
 // node_modules/mysql2/lib/promise/pool.js
 var require_pool2 = __commonJS((exports, module) => {
   var EventEmitter = __require("events").EventEmitter;
+  var {
+    captureStackHolder,
+    applyCapturedStack
+  } = require_capture_local_err();
   var makeDoneCb = require_make_done_cb();
   var PromisePoolConnection = require_pool_connection();
   var inheritEvents = require_inherit_events();
@@ -46055,12 +46252,12 @@ var require_pool2 = __commonJS((exports, module) => {
     }
     query(sql, args) {
       const corePool = this.pool;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePool.prototype.query);
       if (typeof args === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         if (args !== undefined) {
           corePool.query(sql, args, done);
         } else {
@@ -46070,12 +46267,12 @@ var require_pool2 = __commonJS((exports, module) => {
     }
     execute(sql, args) {
       const corePool = this.pool;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePool.prototype.execute);
       if (typeof args === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         if (args) {
           corePool.execute(sql, args, done);
         } else {
@@ -46085,16 +46282,12 @@ var require_pool2 = __commonJS((exports, module) => {
     }
     end() {
       const corePool = this.pool;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePool.prototype.end);
       return new this.Promise((resolve2, reject) => {
         corePool.end((err) => {
           if (err) {
-            localErr.message = err.message;
-            localErr.code = err.code;
-            localErr.errno = err.errno;
-            localErr.sqlState = err.sqlState;
-            localErr.sqlMessage = err.sqlMessage;
-            reject(localErr);
+            applyCapturedStack(err, stackHolder);
+            reject(err);
           } else {
             resolve2();
           }
@@ -46154,6 +46347,7 @@ var require_pool_config = __commonJS((exports, module) => {
       this.maxIdle = isNaN(options.maxIdle) ? this.connectionLimit : Number(options.maxIdle);
       this.idleTimeout = isNaN(options.idleTimeout) ? 60000 : Number(options.idleTimeout);
       this.queueLimit = isNaN(options.queueLimit) ? 0 : Number(options.queueLimit);
+      this.resetOnRelease = options.resetOnRelease === undefined ? false : Boolean(options.resetOnRelease);
     }
   }
   module.exports = PoolConfig;
@@ -46484,6 +46678,7 @@ var require_create_pool_cluster = __commonJS((exports, module) => {
 
 // node_modules/mysql2/lib/promise/pool_cluster.js
 var require_pool_cluster2 = __commonJS((exports, module) => {
+  var { captureStackHolder } = require_capture_local_err();
   var PromisePoolConnection = require_pool_connection();
   var makeDoneCb = require_make_done_cb();
 
@@ -46506,23 +46701,23 @@ var require_pool_cluster2 = __commonJS((exports, module) => {
     }
     query(sql, values) {
       const corePoolNamespace = this.poolNamespace;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePoolNamespace.prototype.query);
       if (typeof values === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         corePoolNamespace.query(sql, values, done);
       });
     }
     execute(sql, values) {
       const corePoolNamespace = this.poolNamespace;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePoolNamespace.prototype.execute);
       if (typeof values === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         corePoolNamespace.execute(sql, values, done);
       });
     }
@@ -46541,13 +46736,17 @@ var require_promise = __commonJS((exports) => {
   var createPoolCluster = require_create_pool_cluster();
   var PromiseConnection = require_connection3();
   var PromisePool = require_pool2();
+  var {
+    captureStackHolder,
+    applyCapturedStack
+  } = require_capture_local_err();
   var makeDoneCb = require_make_done_cb();
   var PromisePoolConnection = require_pool_connection();
   var inheritEvents = require_inherit_events();
   var PromisePoolNamespace = require_pool_cluster2();
   function createConnectionPromise(opts) {
     const coreConnection = createConnection(opts);
-    const createConnectionErr = new Error;
+    const stackHolder = captureStackHolder(createConnectionPromise);
     const thePromise = opts.Promise || Promise;
     if (!thePromise) {
       throw new Error("no Promise implementation available." + "Use promise-enabled node version or pass userland Promise" + " implementation as parameter, for example: { Promise: require('bluebird') }");
@@ -46557,11 +46756,8 @@ var require_promise = __commonJS((exports) => {
         resolve2(new PromiseConnection(coreConnection, thePromise));
       });
       coreConnection.once("error", (err) => {
-        createConnectionErr.message = err.message;
-        createConnectionErr.code = err.code;
-        createConnectionErr.errno = err.errno;
-        createConnectionErr.sqlState = err.sqlState;
-        reject(createConnectionErr);
+        applyCapturedStack(err, stackHolder);
+        reject(err);
       });
     });
   }
@@ -46595,23 +46791,23 @@ var require_promise = __commonJS((exports) => {
     }
     query(sql, args) {
       const corePoolCluster = this.poolCluster;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePoolCluster.prototype.query);
       if (typeof args === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         corePoolCluster.query(sql, args, done);
       });
     }
     execute(sql, args) {
       const corePoolCluster = this.poolCluster;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePoolCluster.prototype.execute);
       if (typeof args === "function") {
         throw new Error("Callback function is not available with promise clients.");
       }
       return new this.Promise((resolve2, reject) => {
-        const done = makeDoneCb(resolve2, reject, localErr);
+        const done = makeDoneCb(resolve2, reject, stackHolder);
         corePoolCluster.execute(sql, args, done);
       });
     }
@@ -46620,16 +46816,12 @@ var require_promise = __commonJS((exports) => {
     }
     end() {
       const corePoolCluster = this.poolCluster;
-      const localErr = new Error;
+      const stackHolder = captureStackHolder(PromisePoolCluster.prototype.end);
       return new this.Promise((resolve2, reject) => {
         corePoolCluster.end((err) => {
           if (err) {
-            localErr.message = err.message;
-            localErr.code = err.code;
-            localErr.errno = err.errno;
-            localErr.sqlState = err.sqlState;
-            localErr.sqlMessage = err.sqlMessage;
-            reject(localErr);
+            applyCapturedStack(err, stackHolder);
+            reject(err);
           } else {
             resolve2();
           }
@@ -78148,7 +78340,11 @@ var init_redis = __esm(() => {
     "SCAN",
     "HSCAN",
     "SSCAN",
-    "ZSCAN"
+    "ZSCAN",
+    "CLIENT",
+    "INFO",
+    "CLUSTER",
+    "SLOWLOG"
   ]);
   REDIS_HARD_REJECT = new Set([
     "FLUSHDB",
@@ -78424,6 +78620,7 @@ function parseFrontmatter(yaml, input) {
   const params = normaliseParams(raw.params, input);
   const tags = Array.isArray(raw.tags) ? raw.tags.map(String) : [];
   const index = typeof raw.index === "string" ? raw.index : undefined;
+  const intent = normaliseIntent(raw.intent, input);
   return {
     meta: {
       name: typeof raw.name === "string" ? raw.name : "",
@@ -78432,11 +78629,20 @@ function parseFrontmatter(yaml, input) {
       engine,
       index,
       params,
-      tags
+      tags,
+      intent
     },
     warnings
   };
 }
+function normaliseIntent(value, input) {
+  if (value === undefined || value === null)
+    return;
+  if (typeof value !== "string" || value.length === 0 || !INTENT_RE.test(value)) {
+    throw new SavedQueryError(`Snippet '${input.key}' has invalid intent: '${String(value)}' (must match ${INTENT_RE.source})`, "INVALID_INTENT", input.file);
+  }
+  return value;
+}
 function normaliseEngine(value, warnings, input) {
   if (value === undefined || value === null || value === "") {
     warnings.push("Snippet has no engine declaration; assuming any engine");
@@ -78573,13 +78779,14 @@ function stripCommentsAndStrings2(sql) {
   }
   return out;
 }
-var MAX_BYTES, VALID_TYPES, VALID_ENGINES;
+var MAX_BYTES, VALID_TYPES, VALID_ENGINES, INTENT_RE;
 var init_parser = __esm(() => {
   init_strategies();
   init_types2();
   MAX_BYTES = 64 * 1024;
   VALID_TYPES = ["int", "string", "float", "bool", "date", "datetime"];
   VALID_ENGINES = ["postgres", "mysql", "elasticsearch", "redis"];
+  INTENT_RE = /^[a-z][a-z0-9.-]*$/;
 });
 
 // src/core/saved-queries/loader.ts
@@ -78855,7 +79062,7 @@ var exports_queries_rename = {};
 __export(exports_queries_rename, {
   queriesRename: () => queriesRename
 });
-import { rename, mkdir } from "fs/promises";
+import { rename, mkdir as mkdir2 } from "fs/promises";
 import { dirname as dirname2 } from "path";
 async function queriesRename(oldName, newName, options = {}) {
   if (!oldName.startsWith("@") || !newName.startsWith("@")) {
@@ -78877,7 +79084,7 @@ async function queriesRename(oldName, newName, options = {}) {
   for (const v of local) {
     const dst = snippetKeyToFile(cwd, newName, "local");
     const dstWithSuffix = preserveEngineSuffix(v.query.file, dst);
-    await mkdir(dirname2(dstWithSuffix), { recursive: true });
+    await mkdir2(dirname2(dstWithSuffix), { recursive: true });
     await rename(v.query.file, dstWithSuffix);
     await rewriteFrontmatterName(dstWithSuffix, newName.slice(1));
     console.log(`renamed ${v.query.file} \u2192 ${dstWithSuffix}`);
@@ -78903,7 +79110,7 @@ var exports_queries_copy = {};
 __export(exports_queries_copy, {
   queriesCopy: () => queriesCopy
 });
-import { mkdir as mkdir2, copyFile } from "fs/promises";
+import { mkdir as mkdir3, copyFile } from "fs/promises";
 import { dirname as dirname3, basename as basename2 } from "path";
 async function queriesCopy(src, dst, options = {}) {
   if (!src.startsWith("@") || !dst.startsWith("@")) {
@@ -78922,7 +79129,7 @@ async function queriesCopy(src, dst, options = {}) {
   }
   for (const v of variants) {
     const dstFile = mapEngineSuffix(v.query.file, snippetKeyToFile(cwd, dst, "local"));
-    await mkdir2(dirname3(dstFile), { recursive: true });
+    await mkdir3(dirname3(dstFile), { recursive: true });
     await copyFile(v.query.file, dstFile);
     console.log(`copied ${v.query.file} \u2192 ${dstFile}`);
   }
@@ -78940,7 +79147,7 @@ var exports_queries_import = {};
 __export(exports_queries_import, {
   queriesImport: () => queriesImport
 });
-import { stat, mkdir as mkdir3, copyFile as copyFile2 } from "fs/promises";
+import { stat, mkdir as mkdir4, copyFile as copyFile2 } from "fs/promises";
 import { basename as basename3, join as join13, extname } from "path";
 async function queriesImport(filePath, options = {}) {
   const cwd = options.cwd ?? process.cwd();
@@ -78953,7 +79160,7 @@ async function queriesImport(filePath, options = {}) {
   const key2 = "@" + baseName;
   parseSavedQuery({ key: key2, file: filePath, source: "local", text: text2 });
   const targetDir = join13(cwd, ".dbcli/queries");
-  await mkdir3(targetDir, { recursive: true });
+  await mkdir4(targetDir, { recursive: true });
   const target = join13(targetDir, basename3(filePath));
   if (await Bun.file(target).exists()) {
     if (!options.force) {
@@ -79024,7 +79231,7 @@ var {
 // package.json
 var package_default = {
   name: "@carllee1983/dbcli",
-  version: "1.10.1",
+  version: "1.11.0",
   description: "Database CLI for AI agents",
   type: "module",
   publishConfig: {
@@ -79080,26 +79287,24 @@ var package_default = {
     format: 'prettier --write "src/**/*.ts" "tests/**/*.ts"'
   },
   dependencies: {
-    "cli-table3": "^0.6.3",
+    "cli-table3": "^0.6.5",
     commander: "13.0.0",
     mongodb: "^7.2.0",
-    mysql2: "^3.20.0",
+    mysql2: "^3.22.3",
     pg: "^8.20.0",
     picocolors: "^1.1.1",
-    zod: "^3.22.4"
+    zod: "^3.25.76"
   },
   devDependencies: {
-    "@eslint/js": "^9.0.0",
-    "@inquirer/prompts": "^5.0.0",
+    "@eslint/js": "^9.39.4",
+    "@inquirer/prompts": "^5.5.0",
     "@types/bun": "latest",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    eslint: "^9.0.0",
-    "happy-dom": "^12.0.0",
-    jsdom: "^23.0.0",
-    prettier: "^3.0.0",
-    typescript: "^5.3.3",
-    "typescript-eslint": "^8.57.2"
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    eslint: "^9.39.4",
+    prettier: "^3.8.3",
+    typescript: "^5.9.3",
+    "typescript-eslint": "^8.59.2"
   }
 };
 // resources/lang/en/messages.json
@@ -79192,7 +79397,15 @@ var messages_default = {
     first_run_hint: "Tip: commit .dbcli-shared/ to share snippets with your team.",
     no_snippets: "No snippets found. Create one with: dbcli queries new @<name>",
     check_ok: "\u2713 {count} snippets parsed successfully",
-    check_failed: "\u2717 {count} snippet(s) have errors"
+    check_failed: "\u2717 {count} snippet(s) have errors",
+    search_description: "Search snippets by keywords (fuzzy ranking)",
+    suggest_description: "Suggest snippets by intent prefix",
+    search_no_keywords: "Provide at least one keyword, or try 'queries list' / 'queries suggest'.",
+    search_no_results: "No snippets matched. Try 'queries list' or 'queries suggest <intent>'.",
+    suggest_missing_intent: "Provide an intent (or prefix). Available: {available}",
+    suggest_invalid_intent: "Invalid intent '{value}'. Must match ^[a-z][a-z0-9.-]*$",
+    suggest_no_results: "No snippets with intent prefix '{intent}'. Available: {available}",
+    no_active_connection_hint: "No active connection; showing snippets across all engines."
   },
   errors: {
     message: "Error: {message}",
@@ -79409,7 +79622,15 @@ var messages_default2 = {
     first_run_hint: "\u63D0\u793A\uFF1A\u5C07 .dbcli-shared/ commit \u9032\u7248\u63A7\u53EF\u8207\u5718\u968A\u5171\u4EAB\u7247\u6BB5\u3002",
     no_snippets: "\u5C1A\u7121\u4EFB\u4F55\u7247\u6BB5\u3002\u57F7\u884C dbcli queries new @<name> \u5EFA\u7ACB\u3002",
     check_ok: "\u2713 \u6210\u529F\u89E3\u6790 {count} \u500B\u7247\u6BB5",
-    check_failed: "\u2717 \u6709 {count} \u500B\u7247\u6BB5\u89E3\u6790\u5931\u6557"
+    check_failed: "\u2717 \u6709 {count} \u500B\u7247\u6BB5\u89E3\u6790\u5931\u6557",
+    search_description: "\u4F9D\u95DC\u9375\u5B57\u641C\u5C0B snippet\uFF08fuzzy \u6392\u5E8F\uFF09",
+    suggest_description: "\u4F9D intent prefix \u63A8\u85A6 snippet",
+    search_no_keywords: "\u81F3\u5C11\u63D0\u4F9B\u4E00\u500B\u95DC\u9375\u5B57\uFF0C\u6216\u8A66\u8A66 'queries list' / 'queries suggest'\u3002",
+    search_no_results: "\u6C92\u6709\u547D\u4E2D\u7684 snippet\u3002\u8A66\u8A66 'queries list' \u6216 'queries suggest <intent>'\u3002",
+    suggest_missing_intent: "\u8ACB\u63D0\u4F9B intent\uFF08\u6216 prefix\uFF09\u3002\u53EF\u7528\uFF1A{available}",
+    suggest_invalid_intent: "Intent '{value}' \u683C\u5F0F\u932F\u8AA4\uFF0C\u5FC5\u9808\u7B26\u5408 ^[a-z][a-z0-9.-]*$",
+    suggest_no_results: "\u6C92\u6709 intent prefix \u70BA '{intent}' \u7684 snippet\u3002\u53EF\u7528\uFF1A{available}",
+    no_active_connection_hint: "\u5C1A\u672A\u8A2D\u5B9A connection\uFF1B\u5217\u51FA\u6240\u6709\u5F15\u64CE\u7684 snippet\u3002"
   },
   errors: {
     message: "\u932F\u8AA4\uFF1A{message}",
@@ -79856,6 +80077,7 @@ async function loadEnvFile(filePath) {
 
 // src/core/config-binding.ts
 import { createHash } from "crypto";
+import { mkdir, unlink } from "fs/promises";
 import { homedir } from "os";
 import { basename, join, resolve } from "path";
 var BINDING_FILE_NAME = "config.json";
@@ -79911,11 +80133,11 @@ async function migrateLegacyProjectEnvLocal(projectPath, storagePath = getProjec
   if (!await projectEnvFile.exists())
     return;
   const storageEnvPath = join(storagePath, ".env.local");
-  await Bun.$`mkdir -p ${storagePath}`;
+  await mkdir(storagePath, { recursive: true });
   if (!await Bun.file(storageEnvPath).exists()) {
     await Bun.file(storageEnvPath).write(await projectEnvFile.text());
   }
-  await Bun.$`rm -f ${projectEnvPath}`;
+  await unlink(projectEnvPath);
 }
 
 // src/core/config-v2.ts
@@ -84877,10 +85099,168 @@ function handleQError(error) {
 }
 
 // src/commands/queries.ts
-import { mkdir as mkdir4, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir5, writeFile as writeFile2 } from "fs/promises";
 import { dirname as dirname4 } from "path";
 import { spawn } from "child_process";
 init_saved_queries();
+
+// src/core/saved-queries/fold.ts
+var SOURCE_RANK2 = { builtin: 0, shared: 1, local: 2 };
+function foldVariants(key2, variants) {
+  const sources = unique(variants.map((v) => v.query.source)).sort();
+  const engines = unique(variants.flatMap((v) => v.query.meta.engine ?? [])).sort();
+  const tags = unique(variants.flatMap((v) => v.query.meta.tags ?? []));
+  const top = variants.slice().sort((a, b) => SOURCE_RANK2[b.query.source] - SOURCE_RANK2[a.query.source])[0];
+  return {
+    name: key2,
+    sources,
+    engines,
+    params: top.query.meta.params.map((p) => p.name),
+    description: top.query.meta.description ?? "",
+    tags,
+    intent: top.query.meta.intent,
+    hasLocalOverride: variants.some((v) => v.hasLocalOverride)
+  };
+}
+function unique(xs) {
+  return [...new Set(xs)];
+}
+
+// src/core/saved-queries/search.ts
+var WEIGHT_NAME = 3;
+var WEIGHT_INTENT = 2;
+var WEIGHT_TAGS = 2;
+var WEIGHT_DESCRIPTION = 1;
+var SOURCE_RANK3 = { local: 0, shared: 1, builtin: 2 };
+function searchSnippets(folded, input) {
+  const tokens = input.query.trim().toLowerCase().split(/\s+/).filter((t2) => t2.length > 0);
+  if (tokens.length === 0)
+    return [];
+  const scored = [];
+  for (const r of folded) {
+    if (input.engineFilter && r.engines.length > 0 && !r.engines.includes(input.engineFilter)) {
+      continue;
+    }
+    if (input.source && input.source !== "all" && !r.sources.includes(input.source)) {
+      continue;
+    }
+    const name = r.name.toLowerCase();
+    const description = r.description.toLowerCase();
+    const intent = (r.intent ?? "").toLowerCase();
+    const tagsJoined = r.tags.join(" ").toLowerCase();
+    const matched = [];
+    let totalWeight = 0;
+    let allHit = true;
+    for (const tok of tokens) {
+      let bestForToken = 0;
+      if (name.includes(tok))
+        bestForToken = Math.max(bestForToken, WEIGHT_NAME);
+      if (intent && intent.includes(tok))
+        bestForToken = Math.max(bestForToken, WEIGHT_INTENT);
+      if (tagsJoined.includes(tok))
+        bestForToken = Math.max(bestForToken, WEIGHT_TAGS);
+      if (description.includes(tok))
+        bestForToken = Math.max(bestForToken, WEIGHT_DESCRIPTION);
+      if (bestForToken === 0) {
+        allHit = false;
+        break;
+      }
+      matched.push(tok);
+      totalWeight += bestForToken;
+    }
+    if (!allHit)
+      continue;
+    const score = totalWeight / (WEIGHT_NAME * tokens.length);
+    const source = pickTopSource(r.sources);
+    scored.push({
+      name: r.name,
+      engine: r.engines[0] ?? null,
+      source,
+      score,
+      matched,
+      description: r.description,
+      intent: r.intent,
+      tags: r.tags
+    });
+  }
+  scored.sort((a, b) => {
+    if (a.score !== b.score)
+      return b.score - a.score;
+    const sa = SOURCE_RANK3[a.source];
+    const sb = SOURCE_RANK3[b.source];
+    if (sa !== sb)
+      return sa - sb;
+    return a.name.localeCompare(b.name);
+  });
+  const limit = input.limit ?? 10;
+  return scored.slice(0, limit);
+}
+function pickTopSource(sources) {
+  let best = "builtin";
+  let bestRank = SOURCE_RANK3.builtin;
+  for (const s of sources) {
+    if (SOURCE_RANK3[s] < bestRank) {
+      bestRank = SOURCE_RANK3[s];
+      best = s;
+    }
+  }
+  return best;
+}
+
+// src/core/saved-queries/suggest.ts
+var SOURCE_RANK4 = { local: 0, shared: 1, builtin: 2 };
+function suggestSnippets(folded, input) {
+  const target = input.intent;
+  const out = [];
+  for (const r of folded) {
+    if (!r.intent)
+      continue;
+    if (!matchesIntentPrefix(r.intent, target))
+      continue;
+    if (input.engineFilter && r.engines.length > 0 && !r.engines.includes(input.engineFilter)) {
+      continue;
+    }
+    if (input.source && input.source !== "all" && !r.sources.includes(input.source)) {
+      continue;
+    }
+    out.push({
+      name: r.name,
+      engine: r.engines[0] ?? null,
+      source: pickTopSource2(r.sources),
+      intent: r.intent,
+      description: r.description,
+      tags: r.tags
+    });
+  }
+  out.sort((a, b) => {
+    if (a.intent !== b.intent)
+      return a.intent.localeCompare(b.intent);
+    const ea = a.engine ?? "";
+    const eb = b.engine ?? "";
+    if (ea !== eb)
+      return ea.localeCompare(eb);
+    return a.name.localeCompare(b.name);
+  });
+  return out;
+}
+function matchesIntentPrefix(intent, target) {
+  if (intent === target)
+    return true;
+  return intent.startsWith(target + ".");
+}
+function pickTopSource2(sources) {
+  let best = "builtin";
+  let bestRank = SOURCE_RANK4.builtin;
+  for (const s of sources) {
+    if (SOURCE_RANK4[s] < bestRank) {
+      bestRank = SOURCE_RANK4[s];
+      best = s;
+    }
+  }
+  return best;
+}
+
+// src/commands/queries.ts
 async function deriveEngine() {
   try {
     const cfg = await configModule.read(resolveConfigPath(undefined, {}));
@@ -84917,25 +85297,6 @@ async function queriesList(options) {
   for (const c of cells)
     console.log(fmt(c));
 }
-var FOLD_SOURCE_RANK = { builtin: 0, shared: 1, local: 2 };
-function foldVariants(key2, variants) {
-  const sources = unique(variants.map((v) => v.query.source)).sort();
-  const engines = unique(variants.flatMap((v) => v.query.meta.engine ?? [])).sort();
-  const tags = unique(variants.flatMap((v) => v.query.meta.tags ?? []));
-  const top = variants.slice().sort((a, b) => FOLD_SOURCE_RANK[b.query.source] - FOLD_SOURCE_RANK[a.query.source])[0];
-  return {
-    name: key2,
-    sources,
-    engines,
-    params: top.query.meta.params.map((p) => p.name),
-    description: top.query.meta.description ?? "",
-    tags,
-    hasLocalOverride: variants.some((v) => v.hasLocalOverride)
-  };
-}
-function unique(xs) {
-  return [...new Set(xs)];
-}
 function snippetToJson(s) {
   return {
     name: s.query.meta.key,
@@ -85008,7 +85369,7 @@ async function queriesNew(name, options) {
     process.exit(1);
     return;
   }
-  await mkdir4(dirname4(file), { recursive: true });
+  await mkdir5(dirname4(file), { recursive: true });
   await writeFile2(file, scaffold(name), "utf8");
   console.log(`Created ${file}`);
   if (source === "shared")
@@ -85070,6 +85431,170 @@ async function queriesCheck(options) {
     console.log(`\u2713 ${total} snippets parsed successfully`);
   }
 }
+async function queriesSearch(keywords, options) {
+  const query = keywords.join(" ").trim();
+  if (!query) {
+    console.error(t("queries.search_no_keywords"));
+    process.exit(2);
+    return;
+  }
+  const allowed = ["postgres", "mysql", "redis", "elasticsearch", "all"];
+  if (options.engine && !allowed.includes(options.engine)) {
+    console.error(`Unknown engine '${options.engine}'. Allowed: ${allowed.join(", ")}.`);
+    process.exit(2);
+    return;
+  }
+  const limit = options.limit !== undefined ? Number(options.limit) : 10;
+  if (!Number.isInteger(limit) || limit <= 0) {
+    console.error(`--limit must be a positive integer (got '${options.limit}')`);
+    process.exit(2);
+    return;
+  }
+  const map = await loadSnippets(resolveSnippetDirs(process.cwd()));
+  const folded = [...map.entries()].map(([key2, variants]) => foldVariants(key2, variants));
+  let engineFilter;
+  if (options.engine && options.engine !== "all") {
+    engineFilter = options.engine;
+  } else if (!options.engine) {
+    const inferred = await deriveEngineOrNull();
+    if (inferred)
+      engineFilter = inferred;
+    else
+      console.error(t("queries.no_active_connection_hint"));
+  }
+  const input = {
+    query,
+    engineFilter,
+    source: options.source,
+    limit
+  };
+  const hits = searchSnippets(folded, input);
+  if (options.format === "json") {
+    console.log(JSON.stringify(hits.map(toSearchJson), null, 2));
+    return;
+  }
+  if (hits.length === 0) {
+    console.log(t("queries.search_no_results"));
+    return;
+  }
+  renderSearchTable(hits, options.includeInternal === true);
+}
+async function deriveEngineOrNull() {
+  try {
+    const cfg = await configModule.read(resolveConfigPath(undefined, {}));
+    if (cfg.connection) {
+      const e = mapSystemToEngine(cfg.connection.system);
+      if (e !== "mongodb")
+        return e;
+    }
+  } catch {}
+  return null;
+}
+function toSearchJson(h) {
+  return {
+    name: h.name,
+    engine: h.engine,
+    source: h.source,
+    intent: h.intent ?? null,
+    description: h.description,
+    tags: h.tags,
+    score: h.score
+  };
+}
+function renderSearchTable(hits, includeScore) {
+  const header = includeScore ? ["NAME", "ENGINE", "SOURCE", "INTENT", "SCORE", "DESCRIPTION"] : ["NAME", "ENGINE", "SOURCE", "INTENT", "DESCRIPTION"];
+  const rows = hits.map((h) => {
+    const base = [h.name, h.engine ?? "-", h.source, h.intent ?? "-"];
+    if (includeScore)
+      base.push(h.score.toFixed(3));
+    base.push(h.description);
+    return base;
+  });
+  const widths = header.map((c, i) => Math.max(c.length, ...rows.map((r) => (r[i] ?? "").length)));
+  const fmt = (line) => line.map((c, i) => (c ?? "").padEnd(widths[i] ?? 0)).join("  ");
+  console.log(fmt(header));
+  for (const r of rows)
+    console.log(fmt(r));
+}
+var INTENT_RE_CLI = /^[a-z][a-z0-9.-]*$/;
+async function queriesSuggest(intent, options) {
+  const map = await loadSnippets(resolveSnippetDirs(process.cwd()));
+  const folded = [...map.entries()].map(([key2, variants]) => foldVariants(key2, variants));
+  const availableIntents = collectIntentPrefixes(folded);
+  if (!intent) {
+    console.error(t_vars("queries.suggest_missing_intent", {
+      available: availableIntents.slice(0, 10).join(", ")
+    }));
+    process.exit(2);
+    return;
+  }
+  if (!INTENT_RE_CLI.test(intent)) {
+    console.error(t_vars("queries.suggest_invalid_intent", { value: intent }));
+    process.exit(2);
+    return;
+  }
+  const allowed = ["postgres", "mysql", "redis", "elasticsearch", "all"];
+  if (options.engine && !allowed.includes(options.engine)) {
+    console.error(`Unknown engine '${options.engine}'. Allowed: ${allowed.join(", ")}.`);
+    process.exit(2);
+    return;
+  }
+  let engineFilter;
+  if (options.engine && options.engine !== "all") {
+    engineFilter = options.engine;
+  } else if (!options.engine) {
+    const inferred = await deriveEngineOrNull();
+    if (inferred)
+      engineFilter = inferred;
+    else
+      console.error(t("queries.no_active_connection_hint"));
+  }
+  const input = { intent, engineFilter, source: options.source };
+  const hits = suggestSnippets(folded, input);
+  if (options.format === "json") {
+    console.log(JSON.stringify(hits.map(toSuggestJson), null, 2));
+    return;
+  }
+  if (hits.length === 0) {
+    console.log(t_vars("queries.suggest_no_results", {
+      intent,
+      available: availableIntents.slice(0, 5).join(", ")
+    }));
+    return;
+  }
+  renderSuggestTable(hits);
+}
+function collectIntentPrefixes(folded) {
+  const seen = new Set;
+  for (const r of folded) {
+    if (!r.intent)
+      continue;
+    seen.add(r.intent);
+    const dot = r.intent.indexOf(".");
+    if (dot > 0)
+      seen.add(r.intent.slice(0, dot));
+  }
+  return [...seen].sort();
+}
+function toSuggestJson(h) {
+  return {
+    name: h.name,
+    engine: h.engine,
+    source: h.source,
+    intent: h.intent,
+    description: h.description,
+    tags: h.tags
+  };
+}
+function renderSuggestTable(hits) {
+  const header = ["INTENT", "NAME", "ENGINE", "SOURCE", "DESCRIPTION"];
+  const rows = hits.map((h) => [h.intent, h.name, h.engine ?? "-", h.source, h.description]);
+  const widths = header.map((c, i) => Math.max(c.length, ...rows.map((r) => (r[i] ?? "").length)));
+  const fmt = (line) => line.map((c, i) => (c ?? "").padEnd(widths[i] ?? 0)).join("  ");
+  console.log(fmt(header));
+  for (const r of rows)
+    console.log(fmt(r));
+}
 function scaffold(name) {
   return [
     "-- ---",
@@ -85153,6 +85678,12 @@ queriesCommand.command("export <name>").description(t("queries.export_descriptio
     process.exit(1);
   }
 });
+queriesCommand.command("search [keywords...]").description(t("queries.search_description")).option("--format <type>", "Output format: table, json", "table").option("--engine <engine>", "Filter: postgres | mysql | redis | elasticsearch | all").option("--source <source>", "Filter: local | shared | builtin | all").option("--limit <n>", "Max results (default 10)").option("--include-internal", "Show ranking score").action(async (keywords, options) => {
+  await queriesSearch(keywords, options);
+});
+queriesCommand.command("suggest [intent]").description(t("queries.suggest_description")).option("--format <type>", "Output format: table, json", "table").option("--engine <engine>", "Filter: postgres | mysql | redis | elasticsearch | all").option("--source <source>", "Filter: local | shared | builtin | all").action(async (intent, options) => {
+  await queriesSuggest(intent, options);
+});
 
 // src/core/data-executor.ts
 init_permission_guard();
@@ -86398,8 +86929,8 @@ async function ensureDir(dirPath) {
     await $`mkdir -p ${dirPath}`.quiet();
   } catch {
     try {
-      const { mkdir: mkdir5 } = await import("fs/promises");
-      await mkdir5(dirPath, { recursive: true });
+      const { mkdir: mkdir6 } = await import("fs/promises");
+      await mkdir6(dirPath, { recursive: true });
     } catch {
       throw new Error(`Cannot create directory: ${dirPath}`);
     }