@carllee1983/dbcli 9.1.2 → 10.0.0

package/dist/cli-runtime.mjs

@@ -2132,7 +2132,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@carllee1983/dbcli",
-    version: "9.1.2",
+    version: "10.0.0",
     description: "Database CLI for AI agents",
     type: "module",
     publishConfig: {
@@ -2173,7 +2173,7 @@ var init_package = __esm(() => {
       "blacklist"
     ],
     engines: {
-      bun: ">=1.3.3"
+      bun: ">=1.4.0"
     },
     files: [
       "dist/",
@@ -6503,7 +6503,7 @@ var init_validation = __esm(() => {
   }, NamedConnectionUnion);
   DbcliConfigV2Schema = objectType({
     version: literalType(2),
-    default: stringType().min(1),
+    default: stringType().min(1).optional(),
     connections: recordType(NamedConnectionSchema).refine((conns) => Object.keys(conns).length > 0, {
       message: "At least one connection is required"
     }),
@@ -6513,7 +6513,7 @@ var init_validation = __esm(() => {
     blacklist: BlacklistConfigSchema,
     audit: AuditConfigSchema,
     redis: RedisConfigSchema
-  }).refine((config) => (config.default in config.connections), {
+  }).refine((config) => config.default === undefined || Object.hasOwn(config.connections, config.default), {
     message: "Default connection must exist in connections",
     path: ["default"]
   });
@@ -7053,14 +7053,20 @@ function findSimilarConnectionNames(requestedName, availableNames) {
   }).filter(({ isSimilar }) => isSimilar).sort((a, b) => a.distance - b.distance || a.name.localeCompare(b.name)).slice(0, 3).map(({ name }) => name);
 }
 function connectionNotFoundMessage(requestedName, availableNames) {
+  if (requestedName === undefined) {
+    return "\u5C1A\u672A\u8A2D\u5B9A\u9810\u8A2D\u9023\u7DDA\u3002\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION \u660E\u78BA\u6307\u5B9A\u9023\u7DDA\u3002" + ` \u53EF\u7528\u9023\u7DDA\uFF1A${availableNames.join(", ")}`;
+  }
   const suggestions = findSimilarConnectionNames(requestedName, availableNames);
   const suggestion = suggestions.length > 0 ? ` \u4F60\u662F\u5426\u8981\u4F7F\u7528\uFF1A${suggestions.join("\u3001")}\uFF1F` : "";
   return `\u9023\u7DDA '${requestedName}' \u4E0D\u5B58\u5728\u3002${suggestion} \u53EF\u7528\u9023\u7DDA\uFF1A${availableNames.join(", ")}`;
 }
 function resolveConnection(config, name) {
   const connectionName = name ?? config.default;
+  if (connectionName === undefined) {
+    throw new ConnectionSelectionRequiredError(Object.keys(config.connections));
+  }
   const conn = config.connections[connectionName];
-  if (!conn) {
+  if (!Object.hasOwn(config.connections, connectionName) || !conn) {
     throw new ConfigError(connectionNotFoundMessage(connectionName, Object.keys(config.connections)));
   }
   const { permission, envFile, environment, ...connectionFields } = conn;
@@ -7078,7 +7084,7 @@ async function loadConnectionEnv(resolved, basePath) {
     await loadEnvFile(envPath);
   }
 }
-async function readV2Config(path) {
+async function readV2ConfigDocument(path) {
   const storagePath = await resolveConfigStoragePath(path);
   const configPath = join3(storagePath, "config.json");
   const file = Bun.file(configPath);
@@ -7088,8 +7094,20 @@ async function readV2Config(path) {
   await assertAgentReadableFile(configPath);
   const content = await file.text();
   await assertConfigIntegrity(storagePath, content, { requireRecord: true });
-  const raw = JSON.parse(content);
-  return DbcliConfigV2Schema.parse(raw);
+  return JSON.parse(content);
+}
+async function readV2Config(path) {
+  return DbcliConfigV2Schema.parse(await readV2ConfigDocument(path));
+}
+async function clearDefaultConnection(path) {
+  assertConfigMutationApproved();
+  const raw = await readV2ConfigDocument(path);
+  const config = DbcliConfigV2Schema.parse(raw);
+  if (config.default === undefined)
+    return;
+  const updated = { ...raw };
+  delete updated.default;
+  await writeV2Config(path, updated);
 }
 async function writeV2Config(path, config) {
   assertConfigMutationApproved();
@@ -7114,6 +7132,7 @@ async function isV2Config(dbcliPath) {
     return false;
   }
 }
+var ConnectionSelectionRequiredError;
 var init_config_v2 = __esm(() => {
   init_validation();
   init_errors3();
@@ -7121,6 +7140,11 @@ var init_config_v2 = __esm(() => {
   init_config_integrity();
   init_env_loader2();
   init_config_binding();
+  ConnectionSelectionRequiredError = class ConnectionSelectionRequiredError extends ConfigError {
+    constructor(availableNames) {
+      super(connectionNotFoundMessage(undefined, availableNames));
+    }
+  };
 });
 
 // src/agent-core/applied-limit.ts
@@ -8686,6 +8710,8 @@ var init_messages = __esm(() => {
     init: {
       description: "Initialize dbcli configuration with .env parsing and interactive prompts",
       welcome: "Welcome to dbcli",
+      prompt_connection_name: "Connection name",
+      connection_name_required: "Connection name is required. Provide --conn-name <name> (this is separate from the database --name).",
       select_system: "Select database system:",
       prompt_host: "Database host: ",
       prompt_port: "Database port: ",
@@ -8710,7 +8736,7 @@ var init_messages = __esm(() => {
       config_exists_use_force: ".dbcli exists. Use --force option to overwrite.",
       connection_added: "Connection '{name}' added",
       connection_removed: "Connection '{name}' removed",
-      connection_removed_switched: "Connection '{name}' removed. Default connection switched to '{newDefault}'",
+      connection_removed_default_cleared: "Connection '{name}' removed. Default connection cleared. Specify --use <name> or DBCLI_CONNECTION for database commands.",
       connection_renamed: "Connection '{oldName}' renamed to '{newName}'",
       v1_migration_prompt: "Detected old config format. Create new format and import existing connection as 'default'?",
       config_saved_v2: "V2 configuration saved to .dbcli",
@@ -8748,6 +8774,9 @@ var init_messages = __esm(() => {
       description: "Switch or display the default database connection",
       switched: "Switched default connection to {name}",
       current: "Current default connection: {name}",
+      current_none: "No default connection. Specify --use <name> or DBCLI_CONNECTION.",
+      unset: "Default connection cleared. Specify --use <name> or DBCLI_CONNECTION for database commands.",
+      unset_conflict: "--unset cannot be combined with a connection name, --list, --confirm-production, or --format json",
       requires_v2: "This feature requires v2 config format. Use 'dbcli init --conn-name <name>' to create one",
       available: "Available connections"
     },
@@ -9022,6 +9051,8 @@ var init_messages2 = __esm(() => {
     init: {
       description: "\u521D\u59CB\u5316 dbcli \u914D\u7F6E\uFF0C\u89E3\u6790 .env \u4E26\u9032\u884C\u4E92\u52D5\u5F0F\u63D0\u793A",
       welcome: "\u6B61\u8FCE\u4F7F\u7528 dbcli",
+      prompt_connection_name: "\u9023\u7DDA\u540D\u7A31",
+      connection_name_required: "\u9023\u7DDA\u540D\u7A31\u4E0D\u53EF\u7A7A\u767D\uFF0C\u8ACB\u63D0\u4F9B --conn-name <name>\uFF08\u8207\u8CC7\u6599\u5EAB\u540D\u7A31 --name \u4E0D\u540C\uFF09\u3002",
       select_system: "\u9078\u64C7\u8CC7\u6599\u5EAB\u7CFB\u7D71\uFF1A",
       prompt_host: "\u8CC7\u6599\u5EAB\u4E3B\u6A5F\uFF1A",
       prompt_port: "\u8CC7\u6599\u5EAB\u57E0\u865F\uFF1A",
@@ -9046,7 +9077,7 @@ var init_messages2 = __esm(() => {
       config_exists_use_force: ".dbcli \u5DF2\u5B58\u5728\u3002\u4F7F\u7528 --force \u9078\u9805\u8986\u84CB\u3002",
       connection_added: "\u5DF2\u65B0\u589E\u9023\u7DDA '{name}'",
       connection_removed: "\u5DF2\u79FB\u9664\u9023\u7DDA '{name}'",
-      connection_removed_switched: "\u5DF2\u79FB\u9664\u9023\u7DDA '{name}'\uFF0C\u9810\u8A2D\u9023\u7DDA\u5DF2\u5207\u63DB\u70BA '{newDefault}'",
+      connection_removed_default_cleared: "\u5DF2\u79FB\u9664\u9023\u7DDA '{name}'\uFF0C\u9810\u8A2D\u9023\u7DDA\u5DF2\u6E05\u7A7A\u3002\u57F7\u884C\u8CC7\u6599\u5EAB\u6307\u4EE4\u6642\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION\u3002",
       connection_renamed: "\u5DF2\u5C07\u9023\u7DDA '{oldName}' \u91CD\u65B0\u547D\u540D\u70BA '{newName}'",
       v1_migration_prompt: "\u5075\u6E2C\u5230\u820A\u683C\u5F0F\u8A2D\u5B9A\uFF0C\u5C07\u5EFA\u7ACB\u65B0\u683C\u5F0F\u4E26\u5C07\u73FE\u6709\u9023\u7DDA\u532F\u5165\u70BA 'default'\uFF0C\u662F\u5426\u7E7C\u7E8C\uFF1F",
       config_saved_v2: "V2 \u8A2D\u5B9A\u5DF2\u5132\u5B58\u81F3 .dbcli",
@@ -9084,6 +9115,9 @@ var init_messages2 = __esm(() => {
       description: "\u5207\u63DB\u6216\u986F\u793A\u9810\u8A2D\u8CC7\u6599\u5EAB\u9023\u7DDA",
       switched: "\u5DF2\u5207\u63DB\u9810\u8A2D\u9023\u7DDA\u70BA {name}",
       current: "\u76EE\u524D\u7684\u9810\u8A2D\u9023\u7DDA\uFF1A{name}",
+      current_none: "\u76EE\u524D\u6C92\u6709\u9810\u8A2D\u9023\u7DDA\u3002\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION\u3002",
+      unset: "\u9810\u8A2D\u9023\u7DDA\u5DF2\u6E05\u7A7A\u3002\u57F7\u884C\u8CC7\u6599\u5EAB\u6307\u4EE4\u6642\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION\u3002",
+      unset_conflict: "--unset \u4E0D\u53EF\u8207\u9023\u7DDA\u540D\u7A31\u3001--list\u3001--confirm-production \u6216 --format json \u540C\u6642\u4F7F\u7528",
       requires_v2: "\u6B64\u529F\u80FD\u9700\u8981\u65B0\u683C\u5F0F\u8A2D\u5B9A\u3002\u8ACB\u4F7F\u7528 dbcli init --conn-name <\u540D\u7A31> \u5EFA\u7ACB\u591A\u9023\u7DDA\u8A2D\u5B9A",
       available: "\u53EF\u7528\u9023\u7DDA"
     },
@@ -9803,6 +9837,28 @@ var init_env_parser = __esm(() => {
   init_errors3();
 });
 
+// src/core/config-v2-mutations.ts
+function envVarNameFor(connName, field) {
+  const slug = connName.toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return `DBCLI_${slug}_${field.toUpperCase()}`;
+}
+function removeConnection(config, name) {
+  if (!Object.hasOwn(config.connections, name))
+    throw new Error(`\u9023\u7DDA '${name}' \u4E0D\u5B58\u5728`);
+  const rest = { ...config.connections };
+  delete rest[name];
+  const remaining = Object.keys(rest);
+  if (remaining.length === 0)
+    throw new Error("\u7121\u6CD5\u522A\u9664\u6700\u5F8C\u4E00\u689D\u9023\u7DDA");
+  const updated = { ...config, connections: rest };
+  if (config.default === name)
+    delete updated.default;
+  return updated;
+}
+var init_config_v2_mutations = __esm(() => {
+  init_validation();
+});
+
 // src/utils/prompts.ts
 async function loadInquirer() {
   try {
@@ -11139,7 +11195,7 @@ class PostgreSQLAdapter {
       const enumQuery = `
         SELECT
           c.column_name as name,
-          array_agg(e.enumlabel ORDER BY e.enumsortorder) as enum_values
+          array_agg(e.enumlabel::text ORDER BY e.enumsortorder) as enum_values
         FROM information_schema.columns c
         JOIN pg_catalog.pg_type AS enum_type
           ON enum_type.typname = c.udt_name
@@ -11160,10 +11216,10 @@ class PostgreSQLAdapter {
       const fkQuery = `
         SELECT
           constraint_info.conname as name,
-          array_agg(source_column.attname ORDER BY source_key.ordinality) as columns,
+          array_agg(source_column.attname::text ORDER BY source_key.ordinality) as columns,
           referenced_schema.nspname as ref_schema,
           referenced_table.relname as ref_table,
-          array_agg(referenced_column.attname ORDER BY source_key.ordinality) as ref_columns
+          array_agg(referenced_column.attname::text ORDER BY source_key.ordinality) as ref_columns
         FROM pg_catalog.pg_constraint AS constraint_info
         JOIN pg_catalog.pg_class AS source_table
           ON source_table.oid = constraint_info.conrelid
@@ -11205,7 +11261,7 @@ class PostgreSQLAdapter {
       const indexQuery = `
         SELECT
           i.relname as name,
-          array_agg(a.attname ORDER BY array_position(ix.indkey, a.attnum)) as columns,
+          array_agg(a.attname::text ORDER BY array_position(ix.indkey, a.attnum)) as columns,
           ix.indisunique as is_unique
         FROM pg_index ix
         JOIN pg_class t ON t.oid = ix.indrelid
@@ -11233,7 +11289,7 @@ class PostgreSQLAdapter {
       const estimateResults = estimateResult.rows;
       const pkQuery = `
         SELECT
-          array_agg(primary_key_column.attname ORDER BY primary_key.ordinality) as columns
+          array_agg(primary_key_column.attname::text ORDER BY primary_key.ordinality) as columns
         FROM pg_catalog.pg_index AS index_info
         JOIN pg_catalog.pg_class AS source_table
           ON source_table.oid = index_info.indrelid
@@ -14542,7 +14598,22 @@ async function checkOverwrite(configPath, shouldPrompt, force) {
   }
   throw new Error(t("init.config_exists_use_force"));
 }
+async function assertV2InitImportSupported(configPath) {
+  if (isGlobalConfigPath(configPath))
+    return;
+  const projectConfig = Bun.file(join10(configPath, "config.json"));
+  if (!await projectConfig.exists())
+    return;
+  const raw = JSON.parse(await projectConfig.text());
+  if (detectConfigVersion(raw) !== 2)
+    return;
+  const config = await readV2Config(configPath);
+  if (Object.values(config.connections).some((connection) => connection.envFile && connection.envFile !== ".env.local")) {
+    throw new Error("\u6B64\u820A\u7248\u5C08\u6848 V2 \u8A2D\u5B9A\u5305\u542B\u81EA\u8A02 envFile\u3002\u65B0\u589E\u9023\u7DDA\u6703\u642C\u79FB\u8A2D\u5B9A\uFF0C\u4F46\u76EE\u524D\u50C5\u652F\u63F4\u642C\u79FB .env.local\u3002" + "\u8ACB\u5148\u7531\u7BA1\u7406\u54E1\u5B8C\u6210\u8A2D\u5B9A\u8207\u81EA\u8A02 envFile \u7684 home storage \u9077\u79FB\uFF0C\u518D\u91CD\u8A66\u3002\u539F\u8A2D\u5B9A\u8207 env \u6A94\u6848\u672A\u8B8A\u66F4\u3002");
+  }
+}
 async function writeV2InitConfig(configPath, connectionName, connection, permission, envFile) {
+  await assertV2InitImportSupported(configPath);
   const globalConfig = isGlobalConfigPath(configPath);
   const storagePath = globalConfig ? configPath : getProjectStoragePath(configPath);
   const configJsonPath = join10(storagePath, "config.json");
@@ -14574,22 +14645,7 @@ async function writeV2InitConfig(configPath, connectionName, connection, permiss
   } else if (await projectConfigFile.exists()) {
     const raw = JSON.parse(await projectConfigFile.text());
     if (detectConfigVersion(raw) === 2) {
-      const v1Config = await configModule.read(configPath);
-      existingV2 = {
-        version: 2,
-        default: "default",
-        connections: {
-          default: {
-            ...v1Config.connection,
-            permission: v1Config.permission
-          }
-        },
-        schema: v1Config.schema || {},
-        schemas: { default: v1Config.schema || {} },
-        metadata: v1Config.metadata || { version: "1.0" },
-        blacklist: v1Config.blacklist || { tables: [], columns: {} },
-        audit: v1Config.audit
-      };
+      existingV2 = await readV2Config(configPath);
     } else {
       const v1Config = await configModule.read(configPath);
       existingV2 = {
@@ -14996,16 +15052,10 @@ async function handleRemove(configPath, name) {
   if (connectionCount <= 1) {
     throw new Error(t("init.cannot_remove_last"));
   }
-  const remaining = Object.fromEntries(Object.entries(config.connections).filter(([connectionName]) => connectionName !== name));
-  const newDefault = config.default === name ? Object.keys(remaining)[0] : config.default;
-  const updated = {
-    ...config,
-    default: newDefault,
-    connections: remaining
-  };
+  const updated = removeConnection(config, name);
   await writeV2Config(storagePath, updated);
   if (config.default === name) {
-    console.log(t_vars("init.connection_removed_switched", { name, newDefault }));
+    console.log(t_vars("init.connection_removed_default_cleared", { name }));
   } else {
     console.log(t_vars("init.connection_removed", { name }));
   }
@@ -15050,13 +15100,36 @@ async function initCommandHandler(options, command) {
     await handleRename(configPath, options.rename);
     return;
   }
-  const isGlobalConfig = isGlobalConfigPath(configPath);
-  const isV2Init = !!(options.connName || options.envFile || isGlobalConfig);
-  const connectionName = options.connName || "default";
-  const existingConfig = await configModule.read(configPath);
   const isUsingEnvRefs = options.useEnvRefs;
   const hasAllEnvOptions = isUsingEnvRefs && options.envHost && options.envPort && options.envUser && options.envPassword && options.envDatabase;
   const shouldPrompt = options.interactive !== false && !hasAllEnvOptions;
+  let connectionName;
+  if (typeof options.connName === "string") {
+    if (!options.connName.trim())
+      throw new Error(t("init.connection_name_required"));
+    connectionName = options.connName;
+  } else {
+    if (!shouldPrompt || !process.stdin.isTTY) {
+      throw new Error(t("init.connection_name_required"));
+    }
+    for (;; ) {
+      if (process.stdin.readableEnded || process.stdin.destroyed) {
+        throw new Error(t("init.connection_name_required"));
+      }
+      connectionName = (await promptUser.text(t("init.prompt_connection_name"))).trim();
+      if (connectionName)
+        break;
+      console.error(t("init.connection_name_required"));
+    }
+  }
+  const isGlobalConfig = isGlobalConfigPath(configPath);
+  const isV2Init = true;
+  await assertV2InitImportSupported(configPath);
+  const existingConfig = await configModule.read(configPath, undefined, { loadLayeredSchema: false }).catch((error) => {
+    if (error instanceof ConnectionSelectionRequiredError)
+      return;
+    throw error;
+  });
   let envConfig = null;
   try {
     envConfig = parseEnvDatabase(process.env);
@@ -15127,10 +15200,11 @@ async function initCommandHandler(options, command) {
     if (!VALID_PERMISSIONS3.includes(permission)) {
       throw new Error(t_vars("errors.invalid_permission", { permission }));
     }
-    const newConfig = configModule.merge(existingConfig, {
+    const updates = {
       connection: configForWrite,
       permission
-    });
+    };
+    const newConfig = existingConfig ? configModule.merge(existingConfig, updates) : configModule.validate(updates);
     const canProceed = await checkOverwrite(configPath, shouldPrompt, !!options.force);
     if (!canProceed)
       return;
@@ -15203,10 +15277,11 @@ async function initCommandHandler(options, command) {
       database: { $env: envDatabase }
     };
   }
-  const newConfig = configModule.merge(existingConfig, {
+  const updates = {
     connection: configForWrite,
     permission
-  });
+  };
+  const newConfig = existingConfig ? configModule.merge(existingConfig, updates) : configModule.validate(updates);
   const canProceed = await checkOverwrite(configPath, shouldPrompt, !!options.force);
   if (!canProceed)
     return;
@@ -15274,6 +15349,7 @@ var init_init = __esm(() => {
   init_env_parser();
   init_config();
   init_config_v2();
+  init_config_v2_mutations();
   init_prompts();
   init_redaction();
   init_adapters();
@@ -15285,7 +15361,7 @@ var init_init = __esm(() => {
   init_init_sqlite();
   INIT_SYSTEM_CHOICES = DATABASE_SYSTEMS;
   VALID_PERMISSIONS3 = ["query-only", "read-write", "data-admin", "admin"];
-  initCommand = new Command2("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, mongodb, redis, elasticsearch)").option("--file <path>", "SQLite database file path (the database must already exist)").option("--cloud-id <id>", "Elasticsearch Cloud ID").option("--api-key <key>", "Elasticsearch API Key").option("--uri <uri>", "MongoDB connection URI (mongodb://user:pass@host:27017/db?authSource=admin)").option("--auth-source <authSource>", "MongoDB auth database (default: admin when user/password are set)").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").option("--conn-name <name>", "Connection name (creates v2 multi-connection config)").option("--env-file <path>", "Path to env file for this connection").option("--remove <name>", "Remove a named connection").option("--rename <names>", "Rename a connection (format: old:new)").action(async (options) => {
+  initCommand = new Command2("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, mongodb, redis, elasticsearch)").option("--file <path>", "SQLite database file path (the database must already exist)").option("--cloud-id <id>", "Elasticsearch Cloud ID").option("--api-key <key>", "Elasticsearch API Key").option("--uri <uri>", "MongoDB connection URI (mongodb://user:pass@host:27017/db?authSource=admin)").option("--auth-source <authSource>", "MongoDB auth database (default: admin when user/password are set)").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").option("--conn-name <name>", "Connection name (required in non-interactive mode)").option("--env-file <path>", "Path to env file for this connection").option("--remove <name>", "Remove a named connection").option("--rename <names>", "Rename a connection (format: old:new)").action(async (options) => {
     try {
       await initCommandHandler(options, initCommand);
     } catch (error) {
@@ -31320,6 +31396,7 @@ async function updateCommand(table, options, command) {
         await adapter.disconnect();
       }
     }
+    enforcePermissionForType("UPDATE", config.permission);
     let whereConditions;
     try {
       whereConditions = parseWhereClause(options.where);
@@ -42349,7 +42426,14 @@ var init_doctor = __esm(() => {
         });
         return results;
       }
-      if (!config.connections[config.default]) {
+      if (config.default === undefined) {
+        results.push({
+          group: "Configuration",
+          label: "Default connection",
+          status: "pass",
+          message: "\u672A\u8A2D\u5B9A\u9810\u8A2D\u9023\u7DDA\uFF1B\u8ACB\u4F7F\u7528 --use <name> \u6216\u8A2D\u5B9A DBCLI_CONNECTION \u660E\u78BA\u6307\u5B9A\u9023\u7DDA"
+        });
+      } else if (!config.connections[config.default]) {
         results.push({
           group: "Configuration",
           label: "Default connection",
@@ -42412,7 +42496,7 @@ var init_doctor = __esm(() => {
     const configPath = resolveConfigPath(doctorCommand);
     const storagePath = await resolveConfigStoragePath(configPath);
     const bunVersion = process.versions.bun ?? "unknown";
-    const requiredBun = package_default.engines?.bun?.replace(">=", "") ?? "1.3.3";
+    const requiredBun = package_default.engines?.bun?.replace(">=", "") ?? "1.4.0";
     results.push(runDoctorChecks.checkRuntime(await collectRuntimeInfo(package_default.version)));
     results.push(runDoctorChecks.checkBunVersion(bunVersion, requiredBun));
     results.push(await runDoctorChecks.checkLatestVersion(package_default.version));
@@ -42508,12 +42592,28 @@ var init_doctor = __esm(() => {
           });
         }
       } catch (error) {
-        results.push({
-          group: "Configuration",
-          label: "Config valid",
-          status: "error",
-          message: `Config invalid: ${error.message}`
-        });
+        if (error instanceof ConnectionSelectionRequiredError) {
+          results.push({
+            group: "Configuration",
+            label: "Config valid",
+            status: "pass",
+            message: "Config valid"
+          });
+          results.push(...await runDoctorChecks.checkV2Config(configPath));
+          results.push({
+            group: "Configuration",
+            label: "Connection selection",
+            status: "error",
+            message: error.message
+          });
+        } else {
+          results.push({
+            group: "Configuration",
+            label: "Config valid",
+            status: "error",
+            message: `Config invalid: ${error.message}`
+          });
+        }
       }
     }
     const hasError = results.some((r) => r.status === "error");
@@ -51106,7 +51206,7 @@ var init_migrate = __esm(() => {
 import { join as join41 } from "path";
 async function switchDefault(configPath, name, config, options = {}) {
   const connection = config.connections[name];
-  if (!connection) {
+  if (!Object.hasOwn(config.connections, name) || !connection) {
     throw new ConfigError(connectionNotFoundMessage(name, Object.keys(config.connections)));
   }
   assertProductionDefaultConfirmation(name, connection.environment, options.confirmProduction);
@@ -51151,7 +51251,7 @@ function listConnectionIdentities(config) {
     };
   });
 }
-async function ensureV2Config(configPath) {
+async function ensureV2Config(configPath, allowV1 = true) {
   const storagePath = await resolveConfigStoragePath(configPath);
   const configFile = Bun.file(join41(storagePath, "config.json"));
   const legacyFile = Bun.file(configPath);
@@ -51165,6 +51265,8 @@ async function ensureV2Config(configPath) {
       return JSON.parse(await legacyFile.text());
     })();
     if (!raw.version || raw.version !== 2 || !raw.connections) {
+      if (!allowV1)
+        throw new ConfigError(t("use.requires_v2"));
       const v1Config = await configModule.read(configPath);
       return {
         version: 2,
@@ -51200,11 +51302,19 @@ var init_use = __esm(() => {
   init_config_binding();
   init_validation();
   ALLOWED_FORMATS20 = ["text", "json"];
-  useCommand = new Command2("use").description("Switch or display the default database connection (v2 config)").argument("[name]", "Connection name to switch to").option("--list", "List all connections").option("--format <format>", "Output format: text (default) or json", "text").option("--confirm-production <name>", "Confirm changing the persisted default to this production connection by repeating its name").action(async (name, options) => {
+  useCommand = new Command2("use").description("Set, unset, or display the default database connection (v2 config)").argument("[name]", "Connection name to switch to").option("--list", "List all connections").option("--unset", "Clear the default connection and require explicit selection (v2 only)").option("--format <format>", "Output format: text (default) or json", "text").option("--confirm-production <name>", "Confirm changing the persisted default to this production connection by repeating its name").action(async (name, options) => {
     try {
       validateFormat(String(options.format), ALLOWED_FORMATS20, "use");
+      if (options.unset && (name !== undefined || options.list || options.confirmProduction !== undefined || options.format === "json")) {
+        throw new ConfigError(t("use.unset_conflict"));
+      }
       const configPath = resolveConfigPath(useCommand);
-      const config = await ensureV2Config(configPath);
+      const config = await ensureV2Config(configPath, !options.unset);
+      if (options.unset) {
+        await clearDefaultConnection(configPath);
+        console.log(t("use.unset"));
+        return;
+      }
       if (name && !options.list && options.format === "json") {
         throw new ConfigError("--format json is only supported with --list");
       }
@@ -51214,7 +51324,7 @@ var init_use = __esm(() => {
           return;
         }
         if (!name) {
-          console.log(t_vars("use.current", { name: config.default }));
+          console.log(config.default === undefined ? t("use.current_none") : t_vars("use.current", { name: config.default }));
         }
         console.log("");
         for (const line of listConnectionsForDisplay(config)) {
@@ -51237,15 +51347,6 @@ var init_use = __esm(() => {
   });
 });
 
-// src/core/config-v2-mutations.ts
-function envVarNameFor(connName, field) {
-  const slug = connName.toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-  return `DBCLI_${slug}_${field.toUpperCase()}`;
-}
-var init_config_v2_mutations = __esm(() => {
-  init_validation();
-});
-
 // src/core/env-file-writer.ts
 import { chmod as chmod2, mkdir as mkdir19, readFile as readFile9, writeFile as writeFile9 } from "fs/promises";
 import { dirname as dirname16 } from "path";
@@ -51315,15 +51416,11 @@ async function resolvePasswordTarget(projectPath, connectionName) {
     };
   }
   const config = await readV2Config(projectPath);
-  const targetName = connectionName ?? config.default;
-  const connection = config.connections[targetName];
-  if (!connection) {
-    throw new ConfigError(connectionNotFoundMessage(targetName, Object.keys(config.connections)));
-  }
+  const { name: targetName, connection, envFile } = resolveConnection(config, connectionName);
   const referencedVar = envRefName(connection.password);
   return {
     connection: targetName,
-    envFile: connection.envFile ?? DEFAULT_ENV_FILE,
+    envFile: envFile ?? DEFAULT_ENV_FILE,
     varName: referencedVar ?? envVarNameFor(targetName, "password"),
     convertedToEnvRef: referencedVar === undefined
   };

package/dist/cli.mjs

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@carllee1983/dbcli",
-  version: "9.1.2",
+  version: "10.0.0",
   description: "Database CLI for AI agents",
   type: "module",
   publishConfig: {
@@ -44,7 +44,7 @@ var package_default = {
     "blacklist"
   ],
   engines: {
-    bun: ">=1.3.3"
+    bun: ">=1.4.0"
   },
   files: [
     "dist/",

package/dist/core.d.ts

@@ -1827,7 +1827,7 @@ declare const DbcliConfigSchema: z.ZodObject<{
 type DbcliConfig$1 = z.infer<typeof DbcliConfigSchema>;
 declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 	version: z.ZodLiteral<2>;
-	default: z.ZodString;
+	default: z.ZodOptional<z.ZodString>;
 	connections: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[
 		z.ZodObject<{
 			timeout: z.ZodOptional<z.ZodNumber>;
@@ -2898,7 +2898,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 	};
 	version: 2;
-	default: string;
 	metadata: {
 		version: string;
 		createdAt?: string | undefined;
@@ -3047,9 +3046,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			fields?: string[] | undefined;
 		}[];
 	} | undefined;
+	default?: string | undefined;
 }, {
 	version: 2;
-	default: string;
 	connections: Record<string, unknown>;
 	redis?: {
 		mask?: {
@@ -3070,6 +3069,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			max_entries?: number | undefined;
 		} | undefined;
 	} | undefined;
+	default?: string | undefined;
 	metadata?: {
 		version?: string | undefined;
 		createdAt?: string | undefined;
@@ -3092,7 +3092,6 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 		};
 	};
 	version: 2;
-	default: string;
 	metadata: {
 		version: string;
 		createdAt?: string | undefined;
@@ -3241,9 +3240,9 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			fields?: string[] | undefined;
 		}[];
 	} | undefined;
+	default?: string | undefined;
 }, {
 	version: 2;
-	default: string;
 	connections: Record<string, unknown>;
 	redis?: {
 		mask?: {
@@ -3264,6 +3263,7 @@ declare const DbcliConfigV2Schema: z.ZodEffects<z.ZodObject<{
 			max_entries?: number | undefined;
 		} | undefined;
 	} | undefined;
+	default?: string | undefined;
 	metadata?: {
 		version?: string | undefined;
 		createdAt?: string | undefined;
@@ -3630,9 +3630,7 @@ export declare function resolveConnection(config: DbcliConfigV2, name: string |
  * Load env file for a connection if specified
  */
 export declare function loadConnectionEnv(resolved: ResolvedConnection, basePath: string): Promise<void>;
-/**
- * Read and validate a v2 config from disk
- */
+/** Read and validate a v2 config from disk. */
 export declare function readV2Config(path: string): Promise<DbcliConfigV2>;
 /**
  * Write a v2 config and its integrity records as one recoverable publication.
@@ -3675,7 +3673,7 @@ export interface ConnectionInput {
 	user: string;
 	database: string;
 }
-/** 刪除連線(immutable)。刪預設則改派為剩餘第一條;刪最後一條則擋下(v2 需至少一條)。 */
+/** 刪除連線(immutable)。刪預設則清空預設;刪最後一條則擋下(v2 需至少一條)。 */
 export declare function removeConnection(config: DbcliConfigV2, name: string): DbcliConfigV2;
 /** 設定預設連線(immutable)。 */
 export declare function setDefaultConnection(config: DbcliConfigV2, name: string): DbcliConfigV2;