@carllee1983/dbcli 1.43.0 → 1.44.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "1.43.0",
+  "version": "1.44.1",
   "description": "Database CLI skill and command reference for AI agents.",
   "author": {
     "name": "Carl Lee",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "1.43.0",
+  "version": "1.44.1",
   "description": "Database CLI skill and command reference for AI agents",
   "author": {
     "name": "Carl Lee",

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "dbcli-agent",
   "displayName": "dbcli Agent",
   "description": "Database CLI skill and command reference for AI agents.",
-  "version": "1.43.0",
+  "version": "1.44.1",
   "author": {
     "name": "Carl Lee",
     "url": "https://github.com/CarlLee1983"

package/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.44.1] - 2026-08-02 - `agent-core` 的 `loadEnvFile` 改用 node:fs，可在 Node 執行
+
+### Fixed
+
+- **`loadEnvFile` 不再依賴 `Bun.file`。** `./agent-core` 存在的理由是給下游 agent CLI 共用，而那些工具不一定跑在 Bun 上；`loadEnvFile` 內部呼叫 `Bun.file()`，在 Node 下直接 `ReferenceError: Bun is not defined`，使整個匯出對第一個 Node 消費者（logq）不可用。改以 `node:fs/promises` 讀檔，解析與「不覆寫既有 `process.env`」的行為完全不變；檔案不存在仍拋 `ConfigError`。其餘五個匯出本來就沒有 runtime 相依，不受影響。
+
+### Added
+
+- **Node runtime 契約測試。** 本 repo 的測試全部跑在 Bun 上，所以 agent-core 裡的 Bun-only 呼叫對它們是隱形的 —— 這正是這個 bug 得以發布的原因。新增的契約測試會 spawn 真正的 `node` 行程去 import 建置後的 `dist/agent-core.mjs`，逐一呼叫每個匯出。還原修正後此測試會失敗（已驗證），因此這個失敗模式不會再次出貨。
+
+### Changed
+
+- **同步跨平台發版 metadata。** npm package、Codex／Claude／Cursor plugin、packaged Codex plugin 與 Gemini extension 統一為 `1.44.1`。
+
+## [1.44.0] - 2026-08-02 - agent-core 補上錯誤型別與 env reference 型別
+
+### Added
+
+- **`./agent-core` 匯出 `ConfigError` 與 `EnvReference`。** 下游工具原本無法用 `instanceof` 判別 env reference 解析失敗，只能比對錯誤訊息字串；也無法引用 `{ $env: string }` 的型別名稱，只能各自重複定義一個結構相同的介面。兩者都是既有模組早已匯出、只是沒有出現在 `public.ts` 的疏漏。runtime interface 因此從五項變六項，型別從三項變四項，皆為加法變更。
+
 ## [1.43.0] - 2026-08-02 - Agent Core、查詢完整性與跨平台修復
 
 ### Added

package/dist/agent-core.d.ts

@@ -1,6 +1,12 @@
 // Generated by dts-bundle-generator v9.5.1
 
-/** Load a file into process.env without overwriting existing values. */
+/**
+ * Load a file into process.env without overwriting existing values.
+ *
+ * Uses `node:fs` rather than `Bun.file` on purpose: `agent-core` is the public
+ * surface downstream tools consume, and those tools do not necessarily run on
+ * Bun. A Bun-only builtin here makes the whole export unusable for them.
+ */
 export declare function loadEnvFile(filePath: string): Promise<void>;
 export interface AppliedLimitMetadata {
 	/** True only when the caller fetched and removed an additional row. */
@@ -23,10 +29,14 @@ export interface ConnectionSelectorInputs {
 export declare function resolveConnectionSelector(inputs: ConnectionSelectorInputs): string | undefined;
 /** Parse a comma-separated selector into ordered, unique names. */
 export declare function parseConnectionNames(selector: string): string[];
-interface EnvReference {
+export interface EnvReference {
 	$env: string;
 }
 /** Resolve a literal or environment reference with a field-specific error. */
 export declare function resolveEnvRef(value: string | EnvReference, fieldName: string, env?: Record<string, string | undefined>): string;
+/** Configuration error shared by agent-facing command-line tools. */
+export declare class ConfigError extends Error {
+	constructor(message: string);
+}
 
 export {};

package/dist/agent-core.mjs

@@ -1,4 +1,7 @@
 // @bun
+// src/agent-core/env-loader.ts
+import { readFile } from "fs/promises";
+
 // src/agent-core/errors.ts
 class ConfigError extends Error {
   constructor(message) {
@@ -30,10 +33,17 @@ function parseEnvContent(content) {
   return entries;
 }
 async function loadEnvFile(filePath) {
-  const file = Bun.file(filePath);
-  if (!await file.exists())
-    throw new ConfigError(`\u627E\u4E0D\u5230 env \u6A94\u6848\uFF1A${filePath}`);
-  for (const [key, value] of parseEnvContent(await file.text())) {
+  let content;
+  try {
+    content = await readFile(filePath, "utf8");
+  } catch (cause) {
+    const code = cause.code;
+    if (code === "ENOENT" || code === "EISDIR") {
+      throw new ConfigError(`\u627E\u4E0D\u5230 env \u6A94\u6848\uFF1A${filePath}`);
+    }
+    throw cause;
+  }
+  for (const [key, value] of parseEnvContent(content)) {
     if (process.env[key] === undefined)
       process.env[key] = value;
   }
@@ -88,5 +98,6 @@ export {
   resolveEnvRef,
   resolveConnectionSelector,
   parseConnectionNames,
-  loadEnvFile
+  loadEnvFile,
+  ConfigError
 };

package/dist/cli.mjs

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@carllee1983/dbcli",
-    version: "1.43.0",
+    version: "1.44.1",
     description: "Database CLI for AI agents",
     type: "module",
     publishConfig: {
@@ -7284,6 +7284,7 @@ var init_errors3 = __esm(() => {
 });
 
 // src/agent-core/env-loader.ts
+import { readFile } from "fs/promises";
 function parseEnvContent(content) {
   const entries = [];
   for (const line of content.split(`
@@ -7304,10 +7305,17 @@ function parseEnvContent(content) {
   return entries;
 }
 async function loadEnvFile(filePath) {
-  const file = Bun.file(filePath);
-  if (!await file.exists())
-    throw new ConfigError(`\u627E\u4E0D\u5230 env \u6A94\u6848\uFF1A${filePath}`);
-  for (const [key, value] of parseEnvContent(await file.text())) {
+  let content;
+  try {
+    content = await readFile(filePath, "utf8");
+  } catch (cause) {
+    const code = cause.code;
+    if (code === "ENOENT" || code === "EISDIR") {
+      throw new ConfigError(`\u627E\u4E0D\u5230 env \u6A94\u6848\uFF1A${filePath}`);
+    }
+    throw cause;
+  }
+  for (const [key, value] of parseEnvContent(content)) {
     if (process.env[key] === undefined)
       process.env[key] = value;
   }
@@ -7517,6 +7525,7 @@ var init_env_ref = __esm(() => {
 var init_public = __esm(() => {
   init_env_loader();
   init_env_ref();
+  init_errors2();
 });
 
 // node_modules/lru-cache/dist/esm/node/index.min.js
@@ -18703,7 +18712,7 @@ var init_assert_artifact = __esm(() => {
 });
 
 // src/core/verification/reader.ts
-import { lstat, readdir as readdir2, readFile } from "fs/promises";
+import { lstat, readdir as readdir2, readFile as readFile2 } from "fs/promises";
 import { join as join15, isAbsolute, resolve as resolve3, sep as sep2 } from "path";
 function isArtifactFilename(name2) {
   return /^verification-.*\.json$/.test(name2);
@@ -18807,7 +18816,7 @@ async function readVerificationArtifacts(storageRoot) {
       if (!stats.isFile()) {
         throw new Error("artifact path is not a regular file");
       }
-      const raw = await readFile(path4, "utf8");
+      const raw = await readFile2(path4, "utf8");
       const parsed = JSON.parse(raw);
       const artifact = validateVerificationArtifact(parsed);
       artifacts.push({ path: path4, filename, artifact });
@@ -19393,7 +19402,7 @@ var init_rotation = __esm(() => {
 });
 
 // src/core/audit/logger.ts
-import { appendFile, mkdir as mkdir7, readFile as readFile2, stat } from "fs/promises";
+import { appendFile, mkdir as mkdir7, readFile as readFile3, stat } from "fs/promises";
 import { join as join16 } from "path";
 import { randomUUID } from "crypto";
 
@@ -19521,7 +19530,7 @@ class AuditLogger {
     try {
       const s = await stat(this.auditFilePath);
       this.currentSizeBytes = s.size;
-      const raw = await readFile2(this.auditFilePath, "utf8");
+      const raw = await readFile3(this.auditFilePath, "utf8");
       this.currentEntryCount = raw.split(`
 `).filter(Boolean).length;
     } catch {
@@ -19547,7 +19556,7 @@ var init_logger2 = __esm(() => {
 });
 
 // src/core/audit/session-id.ts
-import { mkdir as mkdir8, readFile as readFile3, rename as rename3, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir8, readFile as readFile4, rename as rename3, stat as stat2, writeFile as writeFile2 } from "fs/promises";
 import { randomBytes as randomBytes2 } from "crypto";
 import { dirname as dirname4, join as join17 } from "path";
 function generateSessionId(pid, nowMs) {
@@ -19562,7 +19571,7 @@ async function readSessionIdFile(storagePath) {
     return null;
   }
   try {
-    const raw = await readFile3(target, "utf8");
+    const raw = await readFile4(target, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed.sessionId === "string" && typeof parsed.pid === "number" && typeof parsed.createdAt === "string") {
       return {
@@ -21347,7 +21356,7 @@ var init_render_markdown = __esm(() => {
 });
 
 // src/core/recovery/last-envelope.ts
-import { writeFile as writeFile3, readFile as readFile4, rename as rename4, mkdir as mkdir9, stat as stat3 } from "fs/promises";
+import { writeFile as writeFile3, readFile as readFile5, rename as rename4, mkdir as mkdir9, stat as stat3 } from "fs/promises";
 import { dirname as dirname5, join as join18 } from "path";
 import { randomUUID as randomUUID2 } from "crypto";
 function sanitizeCommandSummary(argv) {
@@ -21379,7 +21388,7 @@ async function readLastEnvelope(cwd) {
     return null;
   }
   try {
-    const raw = await readFile4(target, "utf8");
+    const raw = await readFile5(target, "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -21394,7 +21403,7 @@ async function readLastEnvelopeRaw(cwd) {
   }
   let raw;
   try {
-    raw = await readFile4(target, "utf8");
+    raw = await readFile5(target, "utf8");
   } catch {
     return null;
   }
@@ -81720,11 +81729,11 @@ var init_suggest_commands = __esm(() => {
 });
 
 // src/core/audit/reader.ts
-import { readFile as readFile5, readdir as readdir4 } from "fs/promises";
+import { readFile as readFile6, readdir as readdir4 } from "fs/promises";
 async function readSingle(path4) {
   let raw;
   try {
-    raw = await readFile5(path4, "utf8");
+    raw = await readFile6(path4, "utf8");
   } catch (err) {
     if (err.code === "ENOENT")
       return [];
@@ -83948,7 +83957,7 @@ var init_guide_missing_index = __esm(() => {
 });
 
 // src/core/explain/bulk-runner.ts
-import { readFile as readFile6 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 import path4 from "path";
 import { existsSync } from "fs";
 async function resolveBulkInputs(inputs, deps) {
@@ -83991,7 +84000,7 @@ async function resolveBulkInputs(inputs, deps) {
     if (!existsSync(ref)) {
       throw new Error(`No such file or saved query: '${ref}'`);
     }
-    appendFileInputs(out, ref, await readFile6(ref, "utf-8"));
+    appendFileInputs(out, ref, await readFile7(ref, "utf-8"));
   }
   return out;
 }
@@ -92872,7 +92881,7 @@ var init_sql_metadata = __esm(() => {
 });
 
 // src/proxy/events.ts
-import { appendFile as appendFile2, mkdir as mkdir15, readFile as readFile7, stat as stat8 } from "fs/promises";
+import { appendFile as appendFile2, mkdir as mkdir15, readFile as readFile8, stat as stat8 } from "fs/promises";
 import { dirname as dirname11 } from "path";
 function hasSql(e) {
   return e.type === "query_observed" || e.type === "query_completed" || e.type === "query_errored";
@@ -92936,7 +92945,7 @@ class EventWriter {
     try {
       const s = await stat8(this.path);
       this.currentSizeBytes = s.size;
-      const raw = await readFile7(this.path, "utf8");
+      const raw = await readFile8(this.path, "utf8");
       this.currentEntryCount = raw.split(`
 `).filter(Boolean).length;
     } catch {
@@ -93533,7 +93542,7 @@ var init_server = __esm(() => {
 });
 
 // src/proxy/event-reader.ts
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 async function readEvents(path5, opts) {
   const candidates = opts.includeRotated ? [path5, `${path5}.1`] : [path5];
   const files = [];
@@ -93542,7 +93551,7 @@ async function readEvents(path5, opts) {
   for (const file of candidates) {
     let raw;
     try {
-      raw = await readFile8(file, "utf8");
+      raw = await readFile9(file, "utf8");
     } catch (err) {
       if (err.code !== "ENOENT")
         throw err;

package/dist/core.mjs

@@ -21714,6 +21714,7 @@ class ConfigError extends Error {
   }
 }
 // src/agent-core/env-loader.ts
+import { readFile as readFile3 } from "fs/promises";
 function parseEnvContent(content) {
   const entries = [];
   for (const line of content.split(`
@@ -21734,10 +21735,17 @@ function parseEnvContent(content) {
   return entries;
 }
 async function loadEnvFile(filePath) {
-  const file = Bun.file(filePath);
-  if (!await file.exists())
-    throw new ConfigError(`\u627E\u4E0D\u5230 env \u6A94\u6848\uFF1A${filePath}`);
-  for (const [key, value] of parseEnvContent(await file.text())) {
+  let content;
+  try {
+    content = await readFile3(filePath, "utf8");
+  } catch (cause) {
+    const code = cause.code;
+    if (code === "ENOENT" || code === "EISDIR") {
+      throw new ConfigError(`\u627E\u4E0D\u5230 env \u6A94\u6848\uFF1A${filePath}`);
+    }
+    throw cause;
+  }
+  for (const [key, value] of parseEnvContent(content)) {
     if (process.env[key] === undefined)
       process.env[key] = value;
   }

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "1.43.0",
+  "version": "1.44.1",
   "description": "Database CLI skill and command reference for AI agents.",
   "contextFileName": "AGENTS.md"
 }

package/package.json

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

package/plugins/dbcli-agent/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dbcli-agent",
-  "version": "1.43.0",
+  "version": "1.44.1",
   "description": "Database CLI skill and command reference for AI agents",
   "author": {
     "name": "Carl Lee",