@blogic-cz/agent-tools 0.2.5 → 0.2.7

package/README.md

@@ -24,7 +24,7 @@ These tools wrap each CLI with:
 ### Manual installation
 
 ```bash
-bun add @blogic-cz/agent-tools
+bun add -d @blogic-cz/agent-tools
 ```
 
 **Requirements:** [Bun](https://bun.sh/) >=1.0.0
@@ -75,6 +75,22 @@ bunx agent-tools-gh pr review-triage   # interactive summary of PR feedback
 bunx agent-tools-k8s pods --env test   # list pods (structured command)
 ```
 
+Optionally, add script aliases to your `package.json` for shorter invocation:
+
+```json
+{
+  "scripts": {
+    "gh-tool": "agent-tools-gh",
+    "k8s-tool": "agent-tools-k8s",
+    "db-tool": "agent-tools-db",
+    "logs-tool": "agent-tools-logs",
+    "session-tool": "agent-tools-session"
+  }
+}
+```
+
+Then run via `bun run k8s-tool -- pods --env test` instead of `bunx agent-tools-k8s pods --env test`.
+
 4. Hook up the credential guard in your agent config (Claude Code, OpenCode, etc.):
 
 ```typescript

package/package.json

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

package/src/credential-guard/index.ts

@@ -389,8 +389,8 @@ export function createCredentialGuard(config?: CredentialGuardConfig): Credentia
         throw new Error(
           `\u{1F6AB} Direct ${blockedTool.name} usage blocked.\n\n` +
             `AI agents must use wrapper tools for security and audit.\n\n` +
-            `Use instead: ${blockedTool.wrapper}\n\n` +
-            `Run with --help for documentation.\n\n` +
+            `Use instead: bun ${blockedTool.wrapper}\n\n` +
+            `Example: bun ${blockedTool.wrapper} --help\n\n` +
             `Think this tool should be allowed? See https://github.com/blogic-cz/agent-tools — fork, extend the whitelist, and submit a PR.`,
         );
       }

package/src/gh-tool/pr/core.ts

@@ -449,7 +449,14 @@ export const fetchChecks = Effect.fn("pr.fetchChecks")(function* (
     return yield* gh.runGhJson<CheckResult[]>([...args, "--json", "name,state,bucket,link"]);
   }
 
-  return yield* gh.runGhJson<CheckResult[]>([...args, "--json", "name,state,bucket,link"]);
+  const results = yield* gh.runGhJson<CheckResult[]>([...args, "--json", "name,state,bucket,link"]);
+  if (results.some((c) => c.bucket === "pending")) {
+    yield* Console.warn(
+      `ℹ️  Some checks are still running. Prefer --watch to block until completion instead of polling:\n` +
+        `   bun agent-tools-gh pr checks${pr !== null ? ` --pr ${pr}` : ""} --watch`,
+    );
+  }
+  return results;
 });
 
 export const fetchFailedChecks = Effect.fn("pr.fetchFailedChecks")(function* (pr: number | null) {

package/src/k8s-tool/security.ts

@@ -68,8 +68,10 @@ export function isKubectlCommandAllowed(cmd: string): K8sSecurityCheckResult {
   const kubectlPart = trimmed.split("|")[0].trim();
 
   // Extract verb: first non-flag word
-  const words = kubectlPart.split(/\s+/).filter((w) => !w.startsWith("-"));
-  const verb = words[0]?.toLowerCase();
+  const verb = kubectlPart
+    .split(/\s+/)
+    .find((word) => !word.startsWith("-"))
+    ?.toLowerCase();
 
   if (!verb) {
     return { allowed: false, command: cmd, reason: "Empty kubectl command." };

package/src/shared/error-renderer.ts

@@ -32,12 +32,10 @@ const formatError = (error: unknown): string => {
 };
 
 const formatCause = (cause: Cause.Cause<unknown>): string => {
-  const failures = cause.reasons.filter(Cause.isFailReason);
-  const firstFailure = failures[0];
+  const firstFailure = cause.reasons.find(Cause.isFailReason);
   if (firstFailure !== undefined) return formatError(firstFailure.error);
 
-  const defects = cause.reasons.filter(Cause.isDieReason);
-  const firstDefect = defects[0];
+  const firstDefect = cause.reasons.find(Cause.isDieReason);
   if (firstDefect !== undefined) {
     if (firstDefect.defect instanceof Error)
       return `Unexpected error: ${firstDefect.defect.message}`;