@blogic-cz/agent-tools 0.15.12 → 0.15.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "0.15.12",
+  "version": "0.15.13",
   "description": "CLI tools for AI coding agent workflows — GitHub, database, Kubernetes, Azure DevOps, logs, sessions, and audit",
   "keywords": [
     "agent",

package/src/db-tool/psql.ts

@@ -0,0 +1,27 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+
+// Homebrew keeps libpq keg-only, so psql is routinely installed yet absent from PATH.
+const KEG_ONLY_PSQL_DIRECTORIES = ["/opt/homebrew/opt/libpq/bin", "/usr/local/opt/libpq/bin"];
+
+export const PSQL_MISSING_HINT =
+  "psql was not found on PATH. On macOS install it with `brew install libpq`; libpq is keg-only, so also add /opt/homebrew/opt/libpq/bin (Apple silicon) or /usr/local/opt/libpq/bin (Intel) to PATH.";
+
+export const resolvePsqlSearchPath = (
+  pathEnv: string | undefined,
+  fileExists: (candidate: string) => boolean = existsSync,
+): string | undefined => {
+  const directories = (pathEnv ?? "").split(":").filter((directory) => directory.length > 0);
+  if (directories.some((directory) => fileExists(join(directory, "psql")))) {
+    return pathEnv;
+  }
+
+  const kegOnly = KEG_ONLY_PSQL_DIRECTORIES.find((directory) =>
+    fileExists(join(directory, "psql")),
+  );
+  if (kegOnly === undefined) {
+    return pathEnv;
+  }
+
+  return directories.length > 0 ? [...directories, kegOnly].join(":") : kegOnly;
+};

package/src/db-tool/service.ts

@@ -10,6 +10,7 @@ import { resolveEnvironmentScopedPrerequisites } from "#shared/prerequisites/con
 import { runWithProfilePrerequisites } from "#shared/prerequisites/runtime";
 import { buildApiProbeArgs } from "#shared/k8s-probe";
 import { DbConfigService, TUNNEL_CHECK_INTERVAL_MS } from "./config-service";
+import { PSQL_MISSING_HINT, resolvePsqlSearchPath } from "./psql";
 import {
   DbConnectionError,
   DbMutationBlockedError,
@@ -235,7 +236,8 @@ export class DbService extends Context.Service<
                 new DbQueryError({
                   message: `Command execution failed: ${String(platformError)}`,
                   sql: "shell command",
-                  stderr: undefined,
+                  stderr: String(platformError),
+                  ...(String(platformError).includes("psql") ? { hint: PSQL_MISSING_HINT } : {}),
                 }),
             ),
           );
@@ -402,6 +404,7 @@ export class DbService extends Context.Service<
             stderr: "pipe",
             env: {
               ...process.env,
+              PATH: resolvePsqlSearchPath(process.env.PATH),
               ...(password ? { PGPASSWORD: password } : {}),
               ...(isFullyReadOnly(config)
                 ? { PGOPTIONS: "-c default_transaction_read_only=on" }

package/src/k8s-tool/service.ts

@@ -141,7 +141,7 @@ export class K8sService extends Context.Service<
                   message: `Command execution failed: ${String(platformError)}`,
                   command: commandStr,
                   exitCode: -1,
-                  stderr: undefined,
+                  stderr: String(platformError),
                 }),
             ),
           );
@@ -320,7 +320,7 @@ export class K8sService extends Context.Service<
                       message: `Command execution failed: ${String(platformError)}`,
                       command: fullCommand,
                       exitCode: -1,
-                      stderr: undefined,
+                      stderr: String(platformError),
                     }),
                 ),
               );