@carllee1983/dbcli 1.5.0 → 1.5.2

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to dbcli are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.2] - 2026-04-22
+
+### Fixed
+
+- **Doctor diagnostics for MongoDB SRV**: `dbcli doctor` now reports whether the current execution environment can resolve `mongodb+srv://` connections directly or only through the DNS-over-HTTPS fallback used by the MongoDB adapter.
+- **Documentation**: Clarified the new MongoDB SRV environment diagnostic in README, README.zh-TW, and `assets/SKILL.md`.
+
+## [1.5.1] - 2026-04-22
+
+### Fixed
+
+- **MongoDB SRV Connections**: `mongodb+srv://` URIs are now expanded and connected through the MongoDB adapter, and MongoDB operations consistently use the configured database.
+- **MongoDB Documentation**: Clarified SRV URI support and configured-database behavior in README, README.zh-TW, and `assets/SKILL.md`.
+
 ## [1.5.0] - 2026-04-21
 
 ### Added

package/README.md

@@ -89,6 +89,23 @@ dbcli query "SELECT * FROM users"
 dbcli skill --install claude
 ```
 
+### MongoDB Atlas / SRV Connections
+
+MongoDB connections are supported via both standard `mongodb://` URIs and Atlas-style `mongodb+srv://` URIs.
+
+```bash
+# Atlas / SRV connection
+dbcli init --system mongodb --conn-name atlas --uri "mongodb+srv://user:pass@cluster.example.mongodb.net/mydb"
+
+# List collections in the configured MongoDB database
+dbcli list --use atlas
+
+# Query a collection with JSON filter or pipeline
+dbcli query '{"status":"active"}' --collection users --use atlas
+```
+
+For MongoDB, `list` and `query` operate on the database configured for the connection, and `query` requires `--collection <name>`.
+
 ---
 
 ## Multi-connection Support (v2)
@@ -637,6 +654,7 @@ dbcli doctor --format json      # JSON output for AI agents
 - **Environment:** Bun version compatibility, dbcli version (compares with npm registry)
 - **Configuration:** Config file exists/valid, permission level, blacklist completeness
 - **Connection & Data:** Database connectivity, schema cache freshness (> 7 days warning), large table warnings (> 1M rows)
+- **MongoDB SRV diagnostics:** For `mongodb+srv://` connections, `doctor` reports whether the current execution environment can resolve SRV records directly or only through the DNS-over-HTTPS fallback used by `dbcli`
 
 **Options:** `--format <text|json>`
 **Exit code:** 0 = all pass or warnings only, 1 = errors found

package/README.zh-TW.md

@@ -95,6 +95,23 @@ dbcli migrate create posts --column "id:int:pk" "title:varchar(100)"
 dbcli skill --install claude
 ```
 
+### MongoDB Atlas / SRV 連線
+
+MongoDB 連線同時支援標準 `mongodb://` URI 與 Atlas 常用的 `mongodb+srv://` URI。
+
+```bash
+# Atlas / SRV 連線
+dbcli init --system mongodb --conn-name atlas --uri "mongodb+srv://user:pass@cluster.example.mongodb.net/mydb"
+
+# 列出該 MongoDB 連線中的集合
+dbcli list --use atlas
+
+# 以 JSON filter 或 pipeline 查詢某個集合
+dbcli query '{"status":"active"}' --collection users --use atlas
+```
+
+對 MongoDB 而言，`list` 與 `query` 會使用該連線設定中的資料庫；`query` 也必須指定 `--collection <名稱>`。
+
 ---
 
 ## 多重連線支援 (v2)
@@ -647,6 +664,7 @@ dbcli doctor --format json      # JSON 輸出（供 AI 代理）
 - **環境：** Bun 版本相容性、dbcli 版本（與 npm registry 比對）
 - **設定：** 設定檔是否存在／有效、權限等級、黑名單完整性
 - **連線與資料：** 資料庫連線、schema 快取新鮮度（超過 7 天警告）、大表警告（超過 100 萬列）
+- **MongoDB SRV 偵測：** 對 `mongodb+srv://` 連線，`doctor` 會回報目前執行環境能否直接解析 SRV 記錄，或只能依賴 dbcli 內建的 DNS-over-HTTPS fallback
 
 **選項：** `--format <text|json>`  
 **結束代碼：** 0 = 全部通過或僅警告，1 = 有錯誤

package/assets/SKILL.md

@@ -248,6 +248,8 @@ dbcli doctor --format json      # JSON output for AI agents
 - Configuration: config file exists/valid, permission level, blacklist completeness (detects unprotected sensitive columns)
 - Connection & Data: database connectivity, schema cache freshness (warns if > 7 days), large table warnings (> 1M rows)
 
+> **MongoDB SRV diagnostics:** When the active connection uses `mongodb+srv://`, `doctor` reports whether the current runtime can resolve SRV records directly or only through the DNS-over-HTTPS fallback used by dbcli. This helps spot execution-environment DNS restrictions even when Compass can connect.
+
 **Exit code:** 0 if all pass or warnings only, 1 if any error
 **Options:** `--format <text|json>`
 
@@ -351,6 +353,8 @@ dbcli migrate drop-enum status --execute --force
 
 MongoDB connections use a JSON-based query model instead of SQL.
 
+Atlas-style `mongodb+srv://` URIs are supported. `list` and `query` run against the database configured for the connection, and `query` always requires `--collection <name>`.
+
 **Supported commands:** `init`, `list`, `query`, `status`, `use`, `shell`, `doctor`, `upgrade`, `completion`
 
 **Not supported (exit with error):** `schema`, `insert`, `update`, `delete`, `export`, `diff`, `migrate`, `check`
@@ -359,7 +363,7 @@ MongoDB connections use a JSON-based query model instead of SQL.
 
 ```bash
 # 1. Initialize (URI or individual params)
-dbcli init --system mongodb --uri "mongodb://localhost:27017/mydb"
+dbcli init --system mongodb --uri "mongodb+srv://user:pass@cluster.example.mongodb.net/mydb"
 
 # 2. List collections
 dbcli list --format json

package/dist/cli.mjs

@@ -63644,7 +63644,7 @@ var require_URLSearchParams = __commonJS((exports) => {
     }
     const ctorRegistry = utils.initCtorRegistry(globalObject);
 
-    class URLSearchParams {
+    class URLSearchParams2 {
       constructor() {
         const args = [];
         {
@@ -63923,7 +63923,7 @@ var require_URLSearchParams = __commonJS((exports) => {
         return esValue[implSymbol]["size"];
       }
     }
-    Object.defineProperties(URLSearchParams.prototype, {
+    Object.defineProperties(URLSearchParams2.prototype, {
       append: { enumerable: true },
       delete: { enumerable: true },
       get: { enumerable: true },
@@ -63938,9 +63938,9 @@ var require_URLSearchParams = __commonJS((exports) => {
       forEach: { enumerable: true },
       size: { enumerable: true },
       [Symbol.toStringTag]: { value: "URLSearchParams", configurable: true },
-      [Symbol.iterator]: { value: URLSearchParams.prototype.entries, configurable: true, writable: true }
+      [Symbol.iterator]: { value: URLSearchParams2.prototype.entries, configurable: true, writable: true }
     });
-    ctorRegistry[interfaceName] = URLSearchParams;
+    ctorRegistry[interfaceName] = URLSearchParams2;
     ctorRegistry["URLSearchParams Iterator"] = Object.create(ctorRegistry["%IteratorPrototype%"], {
       [Symbol.toStringTag]: {
         configurable: true,
@@ -63967,7 +63967,7 @@ var require_URLSearchParams = __commonJS((exports) => {
     Object.defineProperty(globalObject, interfaceName, {
       configurable: true,
       writable: true,
-      value: URLSearchParams
+      value: URLSearchParams2
     });
   };
   var Impl = require_URLSearchParams_impl();
@@ -63977,7 +63977,7 @@ var require_URLSearchParams = __commonJS((exports) => {
 var require_URL_impl = __commonJS((exports) => {
   var usm = require_url_state_machine();
   var urlencoded = require_urlencoded();
-  var URLSearchParams = require_URLSearchParams();
+  var URLSearchParams2 = require_URLSearchParams();
   exports.implementation = class URLImpl {
     constructor(globalObject, [url, base]) {
       let parsedBase = null;
@@ -63993,7 +63993,7 @@ var require_URL_impl = __commonJS((exports) => {
       }
       const query = parsedURL.query !== null ? parsedURL.query : "";
       this._url = parsedURL;
-      this._query = URLSearchParams.createImpl(globalObject, [query], { doNotStripQMark: true });
+      this._query = URLSearchParams2.createImpl(globalObject, [query], { doNotStripQMark: true });
       this._query._url = this;
     }
     static parse(globalObject, input, base) {
@@ -64551,19 +64551,19 @@ var require_URL = __commonJS((exports) => {
 // node_modules/whatwg-url/webidl2js-wrapper.js
 var require_webidl2js_wrapper = __commonJS((exports) => {
   var URL2 = require_URL();
-  var URLSearchParams = require_URLSearchParams();
+  var URLSearchParams2 = require_URLSearchParams();
   exports.URL = URL2;
-  exports.URLSearchParams = URLSearchParams;
+  exports.URLSearchParams = URLSearchParams2;
 });
 
 // node_modules/whatwg-url/index.js
 var require_whatwg_url = __commonJS((exports) => {
-  var { URL: URL2, URLSearchParams } = require_webidl2js_wrapper();
+  var { URL: URL2, URLSearchParams: URLSearchParams2 } = require_webidl2js_wrapper();
   var urlStateMachine = require_url_state_machine();
   var percentEncoding = require_percent_encoding();
   var sharedGlobalObject = { Array, Object, Promise, String, TypeError };
   URL2.install(sharedGlobalObject, ["Window"]);
-  URLSearchParams.install(sharedGlobalObject, ["Window"]);
+  URLSearchParams2.install(sharedGlobalObject, ["Window"]);
   exports.URL = sharedGlobalObject.URL;
   exports.URLSearchParams = sharedGlobalObject.URLSearchParams;
   exports.parseURL = urlStateMachine.parseURL;
@@ -77140,7 +77140,7 @@ var {
 // package.json
 var package_default = {
   name: "@carllee1983/dbcli",
-  version: "1.5.0",
+  version: "1.5.2",
   description: "Database CLI for AI agents",
   type: "module",
   publishConfig: {
@@ -78976,6 +78976,7 @@ class MySQLAdapter {
 }
 
 // src/adapters/mongodb-adapter.ts
+import { resolveSrv, resolveTxt } from "dns/promises";
 class MongoDBAdapter {
   options;
   ClientClass;
@@ -79000,9 +79001,101 @@ class MongoDBAdapter {
     }
     return `mongodb://${host}:${port}/${database}`;
   }
+  parseTxtRecords(records) {
+    const combined = records.flat().map((record) => record.replace(/^"|"$/g, "")).join("&");
+    if (!combined)
+      return {};
+    const params = new URLSearchParams(combined);
+    return Object.fromEntries(params.entries());
+  }
+  async resolveSrvHosts(hostname) {
+    const srvName = `_mongodb._tcp.${hostname}`;
+    try {
+      const records = await resolveSrv(srvName);
+      if (!records.length) {
+        throw new Error(`No SRV records found for ${srvName}`);
+      }
+      return records.map((record) => {
+        const target = String(record.name || record.target || "").replace(/\.$/, "");
+        return `${target}:${record.port}`;
+      });
+    } catch (error) {
+      const code = error?.code;
+      if (code !== "ECONNREFUSED") {
+        throw error;
+      }
+    }
+    const response = await fetch(`https://dns.google/resolve?name=${encodeURIComponent(srvName)}&type=SRV`);
+    if (!response.ok) {
+      throw new Error(`SRV lookup failed with HTTP ${response.status}`);
+    }
+    const payload = await response.json();
+    if (payload.Status !== 0 || !payload.Answer?.length) {
+      throw new Error(payload.Comment || `No SRV records found for ${srvName}`);
+    }
+    return payload.Answer.map((answer) => {
+      const parts = answer.data.trim().split(/\s+/);
+      const port = parts[2];
+      const target = parts.slice(3).join(" ").replace(/\.$/, "");
+      return `${target}:${port}`;
+    });
+  }
+  async resolveTxtOptions(hostname) {
+    try {
+      const records = await resolveTxt(hostname);
+      return this.parseTxtRecords(records);
+    } catch (error) {
+      const code = error?.code;
+      if (code !== "ECONNREFUSED") {
+        throw error;
+      }
+    }
+    const response = await fetch(`https://dns.google/resolve?name=${encodeURIComponent(hostname)}&type=TXT`);
+    if (!response.ok) {
+      throw new Error(`TXT lookup failed with HTTP ${response.status}`);
+    }
+    const payload = await response.json();
+    if (payload.Status !== 0 || !payload.Answer?.length) {
+      return {};
+    }
+    return this.parseTxtRecords(payload.Answer.map((answer) => [answer.data]));
+  }
+  async buildResolvedUri() {
+    if (!this.options.uri) {
+      return this.buildUri();
+    }
+    if (!this.options.uri.startsWith("mongodb+srv://")) {
+      return this.options.uri;
+    }
+    const url = new URL(this.options.uri);
+    const hosts = await this.resolveSrvHosts(url.hostname);
+    const txtOptions = await this.resolveTxtOptions(url.hostname);
+    const query = new URLSearchParams(url.searchParams);
+    for (const [key2, value] of Object.entries(txtOptions)) {
+      if (!query.has(key2)) {
+        query.set(key2, value);
+      }
+    }
+    if (!query.has("tls") && !query.has("ssl")) {
+      query.set("tls", "true");
+    }
+    if ((url.username || url.password) && !query.has("authSource")) {
+      query.set("authSource", "admin");
+    }
+    const userInfo = url.username || url.password ? `${encodeURIComponent(decodeURIComponent(url.username))}${url.password ? `:${encodeURIComponent(decodeURIComponent(url.password))}` : ""}@` : "";
+    const path = url.pathname && url.pathname !== "/" ? url.pathname : `/${this.options.database || "test"}`;
+    const search = query.toString();
+    return `mongodb://${userInfo}${hosts.join(",")}${path}${search ? `?${search}` : ""}`;
+  }
+  getDatabase() {
+    if (!this.client) {
+      throw new ConnectionError("UNKNOWN", "\u5C1A\u672A\u9023\u7DDA\uFF0C\u8ACB\u5148\u547C\u53EB connect()", []);
+    }
+    return this.client.db(this.options.database || undefined);
+  }
   async connect() {
     const ClientClass = await this.resolveClientClass();
-    const uri = this.buildUri();
+    const uri = await this.buildResolvedUri();
     try {
       this.client = new ClientClass(uri, { serverSelectionTimeoutMS: this.options.timeout ?? 5000 });
       await this.client.connect();
@@ -79022,11 +79115,8 @@ class MongoDBAdapter {
     }
   }
   async execute(query, params) {
-    if (!this.client) {
-      throw new ConnectionError("UNKNOWN", "\u5C1A\u672A\u9023\u7DDA\uFF0C\u8ACB\u5148\u547C\u53EB connect()", []);
-    }
+    const db = this.getDatabase();
     const collectionName = params?.[0];
-    const db = this.client.db();
     const collection = db.collection(collectionName);
     let parsed;
     try {
@@ -79043,10 +79133,7 @@ class MongoDBAdapter {
     return { rows: docs, affectedRows: docs.length };
   }
   async listCollections() {
-    if (!this.client) {
-      throw new ConnectionError("UNKNOWN", "\u5C1A\u672A\u9023\u7DDA\uFF0C\u8ACB\u5148\u547C\u53EB connect()", []);
-    }
-    const db = this.client.db();
+    const db = this.getDatabase();
     const colls = await db.listCollections().toArray();
     const results = await Promise.all(colls.map(async (col) => {
       try {
@@ -79061,14 +79148,11 @@ class MongoDBAdapter {
   async testConnection() {
     if (!this.client)
       return false;
-    await this.client.db().command({ ping: 1 });
+    await this.getDatabase().command({ ping: 1 });
     return true;
   }
   async getServerVersion() {
-    if (!this.client) {
-      throw new ConnectionError("UNKNOWN", "\u5C1A\u672A\u9023\u7DDA\uFF0C\u8ACB\u5148\u547C\u53EB connect()", []);
-    }
-    const info = await this.client.db().admin().serverInfo();
+    const info = await this.getDatabase().admin().serverInfo();
     return info.version ?? "unknown";
   }
 }
@@ -82687,6 +82771,7 @@ var statusCommand = new Command("status").description("Show current configuratio
 init_validation();
 init_schema_path();
 import { join as join10 } from "path";
+import { resolveSrv as resolveSrv2 } from "dns/promises";
 var ALLOWED_FORMATS7 = ["text", "json"];
 var SENSITIVE_PATTERNS = [
   "password",
@@ -82831,6 +82916,68 @@ var runDoctorChecks = {
       message: versionResult.supported ? t_vars("version.doctor_pass", vars) : t_vars("version.doctor_warn", vars)
     };
   },
+  async checkMongoSrvConnectivity(uri, deps = {}) {
+    if (!uri || !uri.startsWith("mongodb+srv://")) {
+      return null;
+    }
+    const url = new URL(uri);
+    const srvName = `_mongodb._tcp.${url.hostname}`;
+    const resolveSrvFn = deps.resolveSrvFn ?? resolveSrv2;
+    const fetchFn = deps.fetchFn ?? fetch;
+    try {
+      const records = await resolveSrvFn(srvName);
+      if (!records.length) {
+        return {
+          group: "Environment",
+          label: "MongoDB SRV lookup",
+          status: "error",
+          message: `No SRV records found for ${url.hostname}`
+        };
+      }
+      return {
+        group: "Environment",
+        label: "MongoDB SRV lookup",
+        status: "pass",
+        message: `MongoDB SRV lookup reachable for ${url.hostname} (${records.length} record(s))`
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const code = error?.code;
+      const isExecutionEnvIssue = code === "ECONNREFUSED" || code === "ETIMEDOUT" || message.includes("Unable to connect. Is the computer able to access the url?") || message.includes("ConnectionRefused");
+      if (!isExecutionEnvIssue) {
+        return {
+          group: "Environment",
+          label: "MongoDB SRV lookup",
+          status: "error",
+          message: `MongoDB SRV lookup failed for ${url.hostname}: ${message}`
+        };
+      }
+      try {
+        const response = await fetchFn(`https://dns.google/resolve?name=${encodeURIComponent(srvName)}&type=SRV`, { signal: AbortSignal.timeout(5000) });
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
+        const payload = await response.json();
+        if (payload.Status !== 0 || !payload.Answer?.length) {
+          throw new Error(payload.Comment || `No SRV records found for ${url.hostname}`);
+        }
+        return {
+          group: "Environment",
+          label: "MongoDB SRV lookup",
+          status: "warn",
+          message: `Direct SRV DNS lookup failed in this shell, but DNS-over-HTTPS fallback resolved ` + `${url.hostname}. dbcli can still connect here, but this runtime environment cannot perform direct SRV lookups.`
+        };
+      } catch (fallbackError) {
+        const fallbackMessage = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
+        return {
+          group: "Environment",
+          label: "MongoDB SRV lookup",
+          status: "error",
+          message: `MongoDB SRV lookup failed in this environment (${code || "unknown"}); ` + `DNS-over-HTTPS fallback also failed: ${fallbackMessage}`
+        };
+      }
+    }
+  },
   checkLargeTables(tables) {
     const large = tables.filter((t7) => (t7.estimatedRowCount ?? 0) > 1e6);
     if (large.length === 0) {
@@ -82927,6 +83074,13 @@ var runDoctorChecks = {
 };
 async function collectMongoDoctorResults(config) {
   const results = [];
+  const srvCheck = await runDoctorChecks.checkMongoSrvConnectivity(config.connection?.uri);
+  if (srvCheck) {
+    results.push(srvCheck);
+    if (srvCheck.status === "error") {
+      return results;
+    }
+  }
   const adapter = AdapterFactory.createMongoDBAdapter(config.connection);
   await adapter.connect();
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carllee1983/dbcli",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Database CLI for AI agents",
   "type": "module",
   "publishConfig": {