@carllee1983/dbcli 0.5.0-beta → 0.5.2-beta

package/CHANGELOG.md

@@ -5,6 +5,34 @@ 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).
 
+## [0.5.2-beta] - 2026-03-27
+
+### Fixed
+
+- **`init --use-env-refs` permission bug**: Interactive env-ref mode now correctly offers all 4 permission levels (was missing `data-admin`)
+- **`init` i18n completeness**: All 10 hardcoded English messages replaced with i18n keys (supports en/zh-TW)
+- **`init` duplicate code**: Extracted shared `.dbcli exists` overwrite check into `checkOverwrite()` helper
+- **`--use-env-refs` help text**: Improved option description to clarify CI/CD and multi-env use case
+- **Documentation**: Added `--use-env-refs` to README (en/zh-TW), CHANGELOG, and SKILL.md with AI agent guidance
+
+---
+
+## [0.5.1-beta] - 2026-03-27
+
+### Added
+
+- **Database version check**: Warns on stderr when connected database version is below minimum supported (PostgreSQL 12+, MySQL 8.0+, MariaDB 10.5+). Non-blocking — connection proceeds normally.
+- **`dbcli doctor` DB version check**: New "Database version" item in Connection & Data group.
+- **`dbcli init --use-env-refs`**: Store environment variable references (`{"$env": "DB_HOST"}`) in config instead of actual values. Supports interactive and non-interactive modes with `--env-host`, `--env-port`, `--env-user`, `--env-password`, `--env-database` options. Suitable for CI/CD and multi-environment deployments.
+
+### Fixed
+
+- **`init` permission bug**: Interactive env-ref mode now correctly offers all 4 permission levels (was missing `data-admin`)
+- **`init` i18n**: All hardcoded English messages in init command replaced with i18n keys (10 messages)
+- **`init` duplicate code**: Extracted shared `.dbcli exists` overwrite check into `checkOverwrite()` helper
+
+---
+
 ## [0.5.0-beta] - 2026-03-27
 
 ### UX & Developer Experience — Colors, Logging, Diagnostics, and Tooling

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carl Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -96,9 +96,27 @@ Initialize a new dbcli project with database connection configuration.
 
 **Usage:**
 ```bash
-dbcli init
+dbcli init [OPTIONS]
 ```
 
+**Options:**
+- `--system <type>` — Database system: `postgresql`, `mysql`, `mariadb`
+- `--host <host>` — Database host
+- `--port <port>` — Database port
+- `--user <user>` — Database user
+- `--password <pass>` — Database password
+- `--name <db>` — Database name
+- `--permission <level>` — Permission level: `query-only`, `read-write`, `data-admin`, `admin`
+- `--use-env-refs` — Store environment variable references instead of actual values in config
+- `--env-host <var>` — Env var name for host (with `--use-env-refs`)
+- `--env-port <var>` — Env var name for port (with `--use-env-refs`)
+- `--env-user <var>` — Env var name for user (with `--use-env-refs`)
+- `--env-password <var>` — Env var name for password (with `--use-env-refs`)
+- `--env-database <var>` — Env var name for database (with `--use-env-refs`)
+- `--skip-test` — Skip connection test
+- `--no-interactive` — Non-interactive mode (requires all options)
+- `--force` — Overwrite existing config without confirmation
+
 **Behavior:**
 - Reads `.env` file if present (auto-fills DATABASE_URL, DB_* variables)
 - Prompts for missing values (host, port, user, password, database name, permission level)
@@ -116,8 +134,20 @@ dbcli init
 
 # Specify permission level
 echo "PERMISSION_LEVEL=admin" >> .env && dbcli init
+
+# Store env var references instead of values (interactive)
+dbcli init --use-env-refs
+
+# Store env var references (non-interactive)
+dbcli init --use-env-refs --system mysql \
+  --env-host DB_HOST --env-port DB_PORT \
+  --env-user DB_USER --env-password DB_PASSWORD \
+  --env-database DB_DATABASE \
+  --no-interactive
 ```
 
+> **`--use-env-refs`:** When enabled, the config stores environment variable names (e.g., `{"$env": "DB_HOST"}`) instead of actual values. This avoids writing sensitive credentials into the config file, making it suitable for multi-environment deployments and CI/CD pipelines. At connection time, dbcli automatically reads the actual values from the referenced environment variables.
+
 ---
 
 #### `dbcli list`

package/README.zh-TW.md

@@ -238,8 +238,19 @@ dbcli init
 
 dbcli init --host db.example.com --port 5432 --user admin --password secret --name prod_db --system postgresql
 # 非交互式初始化
+
+dbcli init --use-env-refs
+# 交互式：提示輸入環境變數名稱，config 中儲存 {"$env": "DB_HOST"} 而非實際值
+
+dbcli init --use-env-refs --system mysql \
+  --env-host DB_HOST --env-port DB_PORT \
+  --env-user DB_USER --env-password DB_PASSWORD \
+  --env-database DB_DATABASE --no-interactive
+# 非交互式環境變數參照模式，適合 CI/CD
 ```
 
+> **`--use-env-refs` 說明：** 使用此選項時，config 中儲存的是環境變數名稱（如 `{"$env": "DB_HOST"}`）而非實際值。這樣可以避免將敏感資訊寫入 config 檔案，適合多環境部署或 CI/CD 場景。連線時 dbcli 會自動從環境變數讀取實際值。
+
 ### 列出表
 
 ```bash

package/assets/SKILL.md

@@ -30,6 +30,8 @@ dbcli init --no-interactive --force # Non-interactive, skip overwrite confirmati
 
 **Key options:** `--system <postgresql|mysql|mariadb>`, `--permission <query-only|read-write|data-admin|admin>`, `--use-env-refs`, `--skip-test`, `--no-interactive`, `--force`
 
+> **AI agent note on `--use-env-refs`:** If an existing `.dbcli` config contains `{"$env": "DB_HOST"}` style references, the connection values are read from environment variables at runtime. Do NOT re-run `init` to replace these references with actual values — the env-ref format is intentional for CI/CD and multi-environment setups.
+
 ### list
 
 List all tables.

package/dist/cli.mjs

@@ -42828,7 +42828,7 @@ var {
 // package.json
 var package_default = {
   name: "@carllee1983/dbcli",
-  version: "0.5.0-beta",
+  version: "0.5.2-beta",
   description: "Database CLI for AI agents",
   type: "module",
   publishConfig: {
@@ -42837,6 +42837,27 @@ var package_default = {
   bin: {
     dbcli: "./dist/cli.mjs"
   },
+  license: "MIT",
+  author: "Carl Lee",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/CarlLee1983/dbcli.git"
+  },
+  homepage: "https://github.com/CarlLee1983/dbcli#readme",
+  bugs: {
+    url: "https://github.com/CarlLee1983/dbcli/issues"
+  },
+  keywords: [
+    "database",
+    "cli",
+    "ai",
+    "agent",
+    "postgresql",
+    "mysql",
+    "mariadb",
+    "permissions",
+    "blacklist"
+  ],
   engines: {
     node: ">=18.0.0",
     bun: ">=1.3.3"
@@ -42902,7 +42923,11 @@ var messages_default = {
     connection_failed: "\u2717 Database connection failed",
     config_saved: "Configuration saved to .dbcli",
     config_exists_overwrite: "Configuration file .dbcli already exists. Overwrite? (y/n): ",
-    cancelled: "Cancelled. Configuration not changed."
+    cancelled: "Cancelled. Configuration not changed.",
+    skip_test_env_ref: "Skipping connection test in env-ref mode",
+    skip_test: "Skipping connection test (--skip-test)",
+    connection_hints: "Hints:",
+    config_exists_use_force: ".dbcli exists. Use --force option to overwrite."
   },
   schema: {
     description: "Retrieve table structure or list all tables",
@@ -42941,7 +42966,18 @@ var messages_default = {
     column_already_blacklisted: "Error: Column '{table}.{column}' is already blacklisted",
     column_not_in_blacklist: "Error: Column '{table}.{column}' is not in the blacklist",
     invalid_table_name: "Error: Invalid table name: {table}",
-    invalid_column_format: "Error: Invalid column format. Use 'table.column'"
+    invalid_column_format: "Error: Invalid column format. Use 'table.column'",
+    invalid_system: "Invalid database system: {system}",
+    invalid_permission: "Invalid permission level: {permission}",
+    invalid_port: "Invalid port: {port}",
+    require_user: "Non-interactive mode requires --user option",
+    require_name: "Non-interactive mode requires --name option",
+    env_refs_missing_options: `When using --use-env-refs, environment variable names must be specified.
+Provide options: --env-host, --env-port, --env-user, --env-password, --env-database
+Or use interactive mode: run "dbcli init --use-env-refs" without --no-interactive`,
+    env_var_not_defined: `Cannot test connection: environment variable {envKey} is not defined.
+Set {envKey} in .env or environment variables.
+Hint: run 'export {envKey}=<value>' and retry`
   },
   success: {
     inserted: "Successfully inserted {count} row(s)",
@@ -42991,6 +43027,11 @@ var messages_default = {
   },
   warnings: {
     blacklist_override_used: "Warning: Blacklist override enabled (DBCLI_OVERRIDE_BLACKLIST=true). Executing {operation} on blacklisted table '{table}'"
+  },
+  version: {
+    unsupported_warning: "{system} {version} is below minimum supported version {minVersion}. Some features may not work correctly.",
+    doctor_pass: "{system} {version} (meets >= {minVersion})",
+    doctor_warn: "{system} {version} is below supported >= {minVersion}"
   }
 };
 // resources/lang/zh-TW/messages.json
@@ -43011,7 +43052,11 @@ var messages_default2 = {
     connection_failed: "\u2717 \u8CC7\u6599\u5EAB\u9023\u63A5\u5931\u6557",
     config_saved: "\u914D\u7F6E\u5DF2\u4FDD\u5B58\u81F3 .dbcli",
     config_exists_overwrite: "\u914D\u7F6E\u6A94\u6848 .dbcli \u5DF2\u5B58\u5728\u3002\u662F\u5426\u8986\u84CB\uFF1F (y/n)\uFF1A",
-    cancelled: "\u5DF2\u53D6\u6D88\u3002\u914D\u7F6E\u672A\u66F4\u6539\u3002"
+    cancelled: "\u5DF2\u53D6\u6D88\u3002\u914D\u7F6E\u672A\u66F4\u6539\u3002",
+    skip_test_env_ref: "\u8DF3\u904E\u9023\u7DDA\u6E2C\u8A66\uFF08\u74B0\u5883\u8B8A\u6578\u53C3\u7167\u6A21\u5F0F\uFF09",
+    skip_test: "\u8DF3\u904E\u9023\u7DDA\u6E2C\u8A66\uFF08--skip-test\uFF09",
+    connection_hints: "\u63D0\u793A\uFF1A",
+    config_exists_use_force: ".dbcli \u5DF2\u5B58\u5728\u3002\u4F7F\u7528 --force \u9078\u9805\u8986\u84CB\u3002"
   },
   schema: {
     description: "\u6AA2\u7D22\u8868\u683C\u7D50\u69CB\u6216\u5217\u51FA\u6240\u6709\u8868\u683C",
@@ -43050,7 +43095,18 @@ var messages_default2 = {
     column_already_blacklisted: "\u932F\u8AA4: \u6B04\u4F4D '{table}.{column}' \u5DF2\u5728\u9ED1\u540D\u55AE\u4E2D",
     column_not_in_blacklist: "\u932F\u8AA4: \u6B04\u4F4D '{table}.{column}' \u4E0D\u5728\u9ED1\u540D\u55AE\u4E2D",
     invalid_table_name: "\u932F\u8AA4: \u7121\u6548\u7684\u8868\u683C\u540D\u7A31: {table}",
-    invalid_column_format: "\u932F\u8AA4: \u7121\u6548\u7684\u6B04\u4F4D\u683C\u5F0F\u3002\u4F7F\u7528 'table.column'"
+    invalid_column_format: "\u932F\u8AA4: \u7121\u6548\u7684\u6B04\u4F4D\u683C\u5F0F\u3002\u4F7F\u7528 'table.column'",
+    invalid_system: "\u7121\u6548\u7684\u8CC7\u6599\u5EAB\u7CFB\u7D71\uFF1A{system}",
+    invalid_permission: "\u7121\u6548\u7684\u6B0A\u9650\u7B49\u7D1A\uFF1A{permission}",
+    invalid_port: "\u7121\u6548\u7684\u57E0\u865F\uFF1A{port}",
+    require_user: "\u975E\u4E92\u52D5\u6A21\u5F0F\u9700\u8981 --user \u9078\u9805",
+    require_name: "\u975E\u4E92\u52D5\u6A21\u5F0F\u9700\u8981 --name \u9078\u9805",
+    env_refs_missing_options: `\u4F7F\u7528 --use-env-refs \u6642\uFF0C\u5FC5\u9808\u6307\u5B9A\u74B0\u5883\u8B8A\u6578\u540D\u7A31\u3002
+\u8ACB\u63D0\u4F9B\u9078\u9805\uFF1A--env-host\u3001--env-port\u3001--env-user\u3001--env-password\u3001--env-database
+\u6216\u4F7F\u7528\u4E92\u52D5\u6A21\u5F0F\uFF1A\u57F7\u884C "dbcli init --use-env-refs"\uFF08\u4E0D\u52A0 --no-interactive\uFF09`,
+    env_var_not_defined: `\u7121\u6CD5\u6E2C\u8A66\u9023\u7DDA\uFF1A\u74B0\u5883\u8B8A\u6578 {envKey} \u672A\u5B9A\u7FA9\u3002
+\u8ACB\u5728 .env \u6216\u74B0\u5883\u8B8A\u6578\u4E2D\u8A2D\u5B9A {envKey}\u3002
+\u63D0\u793A\uFF1A\u57F7\u884C 'export {envKey}=<value>' \u5F8C\u91CD\u8A66`
   },
   success: {
     inserted: "\u6210\u529F\u63D2\u5165 {count} \u5217",
@@ -43100,6 +43156,11 @@ var messages_default2 = {
   },
   warnings: {
     blacklist_override_used: "\u8B66\u544A: \u5DF2\u555F\u7528\u9ED1\u540D\u55AE\u8986\u84CB (DBCLI_OVERRIDE_BLACKLIST=true)\u3002\u57F7\u884C {operation} \u5728\u5DF2\u9ED1\u540D\u55AE\u7684\u8868\u683C '{table}' \u4E0A"
+  },
+  version: {
+    unsupported_warning: "{system} {version} \u4F4E\u65BC\u6700\u4F4E\u652F\u63F4\u7248\u672C {minVersion}\u3002\u90E8\u5206\u529F\u80FD\u53EF\u80FD\u7121\u6CD5\u6B63\u5E38\u904B\u4F5C\u3002",
+    doctor_pass: "{system} {version}\uFF08\u7B26\u5408 >= {minVersion}\uFF09",
+    doctor_warn: "{system} {version} \u4F4E\u65BC\u652F\u63F4\u7248\u672C >= {minVersion}"
   }
 };
 
@@ -47658,6 +47719,61 @@ var Result = import_lib.default.Result;
 var TypeOverrides = import_lib.default.TypeOverrides;
 var defaults = import_lib.default.defaults;
 
+// src/utils/db-version-check.ts
+var MIN_SUPPORTED_VERSIONS = {
+  postgresql: "12.0",
+  mysql: "8.0",
+  mariadb: "10.5"
+};
+function parseVersionSegments(version) {
+  const match = version.match(/^(\d+(?:\.\d+)*)/);
+  if (!match)
+    return [];
+  return match[1].split(".").map(Number);
+}
+function isMariaDBVersion(versionString) {
+  return /mariadb/i.test(versionString);
+}
+function extractMariaDBVersion(versionString) {
+  const match = versionString.match(/(\d+\.\d+\.\d+)-MariaDB/i);
+  if (match)
+    return match[1];
+  const prefixMatch = versionString.match(/^5\.5\.5-(\d+\.\d+\.\d+)/);
+  if (prefixMatch)
+    return prefixMatch[1];
+  return versionString;
+}
+function compareVersions(a, b) {
+  const segA = parseVersionSegments(a);
+  const segB = parseVersionSegments(b);
+  const len = Math.max(segA.length, segB.length);
+  for (let i = 0;i < len; i++) {
+    const diff = (segA[i] ?? 0) - (segB[i] ?? 0);
+    if (diff !== 0)
+      return diff;
+  }
+  return 0;
+}
+function checkDbVersion(rawVersion, declaredSystem) {
+  const isMariaDB = isMariaDBVersion(rawVersion);
+  const system = isMariaDB ? "mariadb" : declaredSystem;
+  const serverVersion = isMariaDB ? extractMariaDBVersion(rawVersion) : rawVersion;
+  const minVersion = MIN_SUPPORTED_VERSIONS[system];
+  const supported = compareVersions(serverVersion, minVersion) >= 0;
+  return { serverVersion, system, supported, minVersion };
+}
+function warnIfUnsupported(result) {
+  if (result.supported)
+    return;
+  const message = t_vars("version.unsupported_warning", {
+    system: result.system,
+    version: result.serverVersion,
+    minVersion: result.minVersion
+  });
+  process.stderr.write(colors.warn(`\u26A0 ${message}`) + `
+`);
+}
+
 // src/adapters/postgresql-adapter.ts
 class PostgreSQLAdapter {
   pool = null;
@@ -47681,6 +47797,11 @@ class PostgreSQLAdapter {
         statement_timeout: this.options.timeout || 5000
       });
       await this.testConnection();
+      try {
+        const rawVersion = await this.getServerVersion();
+        const result = checkDbVersion(rawVersion, "postgresql");
+        warnIfUnsupported(result);
+      } catch {}
     } catch (error) {
       throw mapError(error, "postgresql", this.options);
     }
@@ -47719,6 +47840,10 @@ class PostgreSQLAdapter {
       throw mapError(error, "postgresql", this.options);
     }
   }
+  async getServerVersion() {
+    const rows = await this.execute("SHOW server_version");
+    return rows[0]?.server_version ?? "unknown";
+  }
   async listTables() {
     if (!this.pool) {
       throw new ConnectionError("UNKNOWN", "Database connection not established", ["Call connect() to establish a connection"]);
@@ -47929,6 +48054,11 @@ class MySQLAdapter {
         database: this.options.database
       });
       await this.testConnection();
+      try {
+        const rawVersion = await this.getServerVersion();
+        const result = checkDbVersion(rawVersion, this.system);
+        warnIfUnsupported(result);
+      } catch {}
     } catch (error) {
       throw mapError(error, this.system, this.options);
     }
@@ -47963,6 +48093,10 @@ class MySQLAdapter {
       throw mapError(error, this.system, this.options);
     }
   }
+  async getServerVersion() {
+    const rows = await this.execute("SELECT VERSION() as version");
+    return rows[0]?.version ?? "unknown";
+  }
   async listTables() {
     if (!this.db) {
       throw new ConnectionError("UNKNOWN", "Database connection not established", ["Call connect() to establish a connection"]);
@@ -48114,7 +48248,23 @@ class AdapterFactory {
   }
 }
 // src/commands/init.ts
-var initCommand = new Command("init").description("Initialize dbcli configuration with .env parsing and interactive prompts").option("--host <host>", "Database host").option("--port <port>", "Database port").option("--user <user>", "Database user").option("--password <password>", "Database password").option("--name <name>", "Database name").option("--system <system>", "Database system (postgresql, mysql, mariadb)").option("--permission <permission>", "Permission level (query-only, read-write, data-admin, admin)", "query-only").option("--use-env-refs", "Generate config with environment variable references (for .env)", false).option("--env-host <var>", "Environment variable name for database host (when using --use-env-refs)").option("--env-port <var>", "Environment variable name for database port (when using --use-env-refs)").option("--env-user <var>", "Environment variable name for database user (when using --use-env-refs)").option("--env-password <var>", "Environment variable name for database password (when using --use-env-refs)").option("--env-database <var>", "Environment variable name for database name (when using --use-env-refs)").option("--skip-test", "Skip database connection test").option("--no-interactive", "Non-interactive mode (requires all values via flags)").option("--force", "Skip overwrite confirmation if .dbcli exists").action(async (options) => {
+var VALID_PERMISSIONS = ["query-only", "read-write", "data-admin", "admin"];
+async function checkOverwrite(shouldPrompt, force) {
+  const configFile = Bun.file(".dbcli");
+  const fileExists = await configFile.exists();
+  if (!fileExists || force)
+    return true;
+  if (shouldPrompt) {
+    const overwrite = await promptUser.confirm(t("init.config_exists_overwrite"));
+    if (!overwrite) {
+      console.log(t("init.cancelled"));
+      return false;
+    }
+    return true;
+  }
+  throw new Error(t("init.config_exists_use_force"));
+}
+var initCommand = new Command("init").description("Initialize dbcli configuration with .env parsing and interactive prompts").option("--host <host>", "Database host").option("--port <port>", "Database port").option("--user <user>", "Database user").option("--password <password>", "Database password").option("--name <name>", "Database name").option("--system <system>", "Database system (postgresql, mysql, mariadb)").option("--permission <permission>", "Permission level (query-only, read-write, data-admin, admin)", "query-only").option("--use-env-refs", "Store env var references in config instead of actual values (for CI/CD or multi-env)", false).option("--env-host <var>", "Env var name for host (with --use-env-refs)").option("--env-port <var>", "Env var name for port (with --use-env-refs)").option("--env-user <var>", "Env var name for user (with --use-env-refs)").option("--env-password <var>", "Env var name for password (with --use-env-refs)").option("--env-database <var>", "Env var name for database (with --use-env-refs)").option("--skip-test", "Skip database connection test").option("--no-interactive", "Non-interactive mode (requires all values via flags)").option("--force", "Skip overwrite confirmation if .dbcli exists").action(async (options) => {
   try {
     await initCommandHandler(options);
   } catch (error) {
@@ -48148,7 +48298,7 @@ async function initCommandHandler(options) {
     ]);
   }
   if (!["postgresql", "mysql", "mariadb"].includes(system)) {
-    throw new Error(`Invalid database system: ${system}`);
+    throw new Error(t_vars("errors.invalid_system", { system }));
   }
   const defaults2 = getDefaultsForSystem(system);
   const connection = {
@@ -48170,34 +48320,25 @@ async function initCommandHandler(options) {
       database: { $env: envDatabase }
     };
     let permission2 = options.permission || "query-only";
-    if (shouldPrompt && !options.permission) {
+    if (!options.permission) {
       permission2 = await promptUser.select(t("init.prompt_permission"), [
         "query-only",
         "read-write",
+        "data-admin",
         "admin"
       ]);
     }
-    if (!["query-only", "read-write", "data-admin", "admin"].includes(permission2)) {
-      throw new Error(`Invalid permission level: ${permission2}`);
+    if (!VALID_PERMISSIONS.includes(permission2)) {
+      throw new Error(t_vars("errors.invalid_permission", { permission: permission2 }));
     }
     const newConfig2 = configModule.merge(existingConfig, {
       connection: configForWrite,
       permission: permission2
     });
-    const configFile2 = Bun.file(".dbcli");
-    const fileExists2 = await configFile2.exists();
-    if (fileExists2 && !options.force) {
-      if (shouldPrompt) {
-        const overwrite = await promptUser.confirm(t("init.config_exists_overwrite"));
-        if (!overwrite) {
-          console.log(t("init.cancelled"));
-          return;
-        }
-      } else {
-        throw new Error(".dbcli exists. Use --force option to overwrite.");
-      }
-    }
-    console.log("\u23ED\uFE0F  Skipping connection test in env-ref mode");
+    const canProceed2 = await checkOverwrite(shouldPrompt, !!options.force);
+    if (!canProceed2)
+      return;
+    console.log(`\u23ED\uFE0F  ${t("init.skip_test_env_ref")}`);
     await configModule.write(".dbcli", newConfig2);
     console.log(t("init.config_saved"));
     return;
@@ -48206,17 +48347,17 @@ async function initCommandHandler(options) {
   const portStr = options.port || (envConfig?.port ? String(envConfig.port) : null) || (shouldPrompt ? await promptUser.text(t("init.prompt_port"), String(defaults2.port || 5432)) : String(defaults2.port || 5432));
   const port = parseInt(portStr, 10);
   if (isNaN(port) || port < 1 || port > 65535) {
-    throw new Error(`Invalid port: ${portStr}`);
+    throw new Error(t_vars("errors.invalid_port", { port: portStr }));
   }
   connection.port = port;
   connection.user = options.user || envConfig?.user || (shouldPrompt ? await promptUser.text(t("init.prompt_user")) : "");
   if (!connection.user && !shouldPrompt && !options.useEnvRefs) {
-    throw new Error("Non-interactive mode requires --user option");
+    throw new Error(t("errors.require_user"));
   }
   connection.password = options.password || envConfig?.password || (shouldPrompt ? await promptUser.text(t("init.prompt_password")) : "");
   connection.database = options.name || envConfig?.database || (shouldPrompt ? await promptUser.text(t("init.prompt_name")) : "");
   if (!connection.database && !shouldPrompt && !options.useEnvRefs) {
-    throw new Error("Non-interactive mode requires --name option");
+    throw new Error(t("errors.require_name"));
   }
   let permission = options.permission || "query-only";
   if (shouldPrompt && !options.permission) {
@@ -48227,8 +48368,8 @@ async function initCommandHandler(options) {
       "admin"
     ]);
   }
-  if (!["query-only", "read-write", "data-admin", "admin"].includes(permission)) {
-    throw new Error(`Invalid permission level: ${permission}`);
+  if (!VALID_PERMISSIONS.includes(permission)) {
+    throw new Error(t_vars("errors.invalid_permission", { permission }));
   }
   configForWrite = connection;
   if (options.useEnvRefs) {
@@ -48238,9 +48379,7 @@ async function initCommandHandler(options) {
     const envPassword = options.envPassword;
     const envDatabase = options.envDatabase;
     if (!envHost || !envPort || !envUser || !envPassword || !envDatabase) {
-      throw new Error(`When using --use-env-refs, environment variable names must be specified.
-` + `Provide options: --env-host, --env-port, --env-user, --env-password, --env-database
-` + 'Or use interactive mode: run "bun dev init --use-env-refs" without --no-interactive');
+      throw new Error(t("errors.env_refs_missing_options"));
     }
     configForWrite = {
       system: connection.system,
@@ -48255,29 +48394,17 @@ async function initCommandHandler(options) {
     connection: configForWrite,
     permission
   });
-  const configFile = Bun.file(".dbcli");
-  const fileExists = await configFile.exists();
-  if (fileExists && !options.force) {
-    if (shouldPrompt) {
-      const overwrite = await promptUser.confirm(t("init.config_exists_overwrite"));
-      if (!overwrite) {
-        console.log(t("init.cancelled"));
-        return;
-      }
-    } else {
-      throw new Error(".dbcli exists. Use --force option to overwrite.");
-    }
-  }
+  const canProceed = await checkOverwrite(shouldPrompt, !!options.force);
+  if (!canProceed)
+    return;
   if (!options.skipTest && !options.useEnvRefs) {
     console.log(t("init.connection_testing"));
-    const resolveValue = (value, fieldName) => {
+    const resolveValue = (value, _fieldName) => {
       if (typeof value === "object" && value !== null && "$env" in value) {
         const envKey = value.$env;
         const envValue = process.env[envKey];
         if (!envValue) {
-          throw new Error(`Cannot test connection: environment variable ${envKey} is not defined
-` + `Set ${envKey} in .env or environment variables.
-` + `Hint: Check .env file or run 'export ${envKey}=<value>' and retry`);
+          throw new Error(t_vars("errors.env_var_not_defined", { envKey }));
         }
         return envValue;
       }
@@ -48301,7 +48428,7 @@ async function initCommandHandler(options) {
     } catch (error) {
       if (error instanceof ConnectionError) {
         console.error(t_vars("errors.connection_failed", { message: error.message }));
-        console.error("Hints:");
+        console.error(t("init.connection_hints"));
         error.hints.forEach((hint) => console.error(`  \u2022 ${hint}`));
         process.exit(1);
       }
@@ -48310,7 +48437,8 @@ async function initCommandHandler(options) {
       await adapter.disconnect();
     }
   } else {
-    console.log("\u23ED\uFE0F  Skipping connection test (--skip-test)");
+    const msgKey = options.useEnvRefs ? "init.skip_test_env_ref" : "init.skip_test";
+    console.log(`\u23ED\uFE0F  ${t(msgKey)}`);
   }
   await configModule.write(".dbcli", newConfig);
   console.log(t("init.config_saved"));
@@ -51059,6 +51187,19 @@ var runDoctorChecks = {
       message: `Schema cache is ${ageDays} day(s) old`
     };
   },
+  checkDatabaseVersion(versionResult) {
+    const vars = {
+      system: versionResult.system,
+      version: versionResult.serverVersion,
+      minVersion: versionResult.minVersion
+    };
+    return {
+      group: "Connection & Data",
+      label: "Database version",
+      status: versionResult.supported ? "pass" : "warn",
+      message: versionResult.supported ? t_vars("version.doctor_pass", vars) : t_vars("version.doctor_warn", vars)
+    };
+  },
   checkLargeTables(tables) {
     const large = tables.filter((t7) => (t7.estimatedRowCount ?? 0) > 1e6);
     if (large.length === 0) {
@@ -51139,6 +51280,13 @@ var doctorCommand = new Command("doctor").description("Run diagnostic checks on
           status: "pass",
           message: `Connected to ${config.connection.system} ${config.connection.database}@${config.connection.host}:${config.connection.port}`
         });
+        try {
+          const rawVersion = await adapter.getServerVersion();
+          const versionResult = checkDbVersion(rawVersion, config.connection.system);
+          results.push(runDoctorChecks.checkDatabaseVersion(versionResult));
+        } catch {
+          logger.debug("Could not retrieve database version");
+        }
         try {
           const tables = await adapter.listTables();
           const tableColumns = new Map;
@@ -51388,7 +51536,7 @@ var completionCommand = new Command("completion").description("Generate shell co
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@carllee1983/dbcli/latest";
 var STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000;
 var FETCH_TIMEOUT_MS = 3000;
-function compareVersions(a, b) {
+function compareVersions2(a, b) {
   const stripSuffix = (v) => v.replace(/-.*$/, "");
   const pa = stripSuffix(a).split(".").map(Number);
   const pb = stripSuffix(b).split(".").map(Number);
@@ -51440,7 +51588,7 @@ async function checkForUpdate(currentVersion, cachePath, existingCache) {
   }
   if (cache && !isStale(cache.checkedAt)) {
     return {
-      hasUpdate: compareVersions(cache.latestVersion, currentVersion) > 0,
+      hasUpdate: compareVersions2(cache.latestVersion, currentVersion) > 0,
       latestVersion: cache.latestVersion
     };
   }
@@ -51457,7 +51605,7 @@ async function checkForUpdate(currentVersion, cachePath, existingCache) {
     } catch {}
   }
   return {
-    hasUpdate: compareVersions(latestVersion, currentVersion) > 0,
+    hasUpdate: compareVersions2(latestVersion, currentVersion) > 0,
     latestVersion
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carllee1983/dbcli",
-  "version": "0.5.0-beta",
+  "version": "0.5.2-beta",
   "description": "Database CLI for AI agents",
   "type": "module",
   "publishConfig": {
@@ -9,6 +9,27 @@
   "bin": {
     "dbcli": "./dist/cli.mjs"
   },
+  "license": "MIT",
+  "author": "Carl Lee",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CarlLee1983/dbcli.git"
+  },
+  "homepage": "https://github.com/CarlLee1983/dbcli#readme",
+  "bugs": {
+    "url": "https://github.com/CarlLee1983/dbcli/issues"
+  },
+  "keywords": [
+    "database",
+    "cli",
+    "ai",
+    "agent",
+    "postgresql",
+    "mysql",
+    "mariadb",
+    "permissions",
+    "blacklist"
+  ],
   "engines": {
     "node": ">=18.0.0",
     "bun": ">=1.3.3"