@blogic-cz/agent-tools 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "CLI tools for AI coding agent workflows — GitHub, database, Kubernetes, Azure DevOps, logs, and sessions",
   "keywords": [
     "agent",
@@ -33,6 +33,19 @@
     "LICENSE"
   ],
   "type": "module",
+  "imports": {
+    "#shared": "./src/shared/index.ts",
+    "#shared/*": "./src/shared/*.ts",
+    "#config": "./src/config/index.ts",
+    "#config/*": "./src/config/*.ts",
+    "#gh/*": "./src/gh-tool/*.ts",
+    "#k8s/*": "./src/k8s-tool/*.ts",
+    "#db/*": "./src/db-tool/*.ts",
+    "#logs/*": "./src/logs-tool/*.ts",
+    "#az/*": "./src/az-tool/*.ts",
+    "#guard": "./src/credential-guard/index.ts",
+    "#session/*": "./src/session-tool/*.ts"
+  },
   "exports": {
     ".": "./src/index.ts",
     "./credential-guard": "./src/credential-guard/index.ts",

package/src/az-tool/index.ts

@@ -3,7 +3,7 @@ import { Command, Flag } from "effect/unstable/cli";
 import { BunRuntime, BunServices } from "@effect/platform-bun";
 import { Console, Effect, Layer, Option } from "effect";
 
-import { formatAny, formatOption, formatOutput, renderCauseToStderr, VERSION } from "../shared";
+import { formatAny, formatOption, formatOutput, renderCauseToStderr, VERSION } from "#shared";
 import {
   findFailedJobs,
   getBuildJobSummary,
@@ -12,7 +12,7 @@ import {
   getBuildTimeline,
 } from "./build";
 import { AzService, AzServiceLayer } from "./service";
-import { ConfigServiceLayer } from "../config";
+import { ConfigServiceLayer } from "#config";
 
 // ---------------------------------------------------------------------------
 // Common flags shared across build subcommands

package/src/az-tool/service.ts

@@ -2,12 +2,12 @@ import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
 import { Effect, Layer, ServiceMap, Stream, Option } from "effect";
 
 import type { InvokeParams } from "./types";
-import type { AzureConfig } from "../config/types";
+import type { AzureConfig } from "#config/types";
 
 import { DIRECT_AZ_COMMANDS, STANDALONE_AZ_COMMANDS } from "./config";
 import { AzSecurityError, AzCommandError, AzTimeoutError, AzParseError } from "./errors";
 import { isCommandAllowed, isInvokeAllowed } from "./security";
-import { ConfigService, getToolConfig } from "../config";
+import { ConfigService, getToolConfig } from "#config";
 
 export class AzService extends ServiceMap.Service<
   AzService,

package/src/config/loader.ts

@@ -73,11 +73,13 @@ async function findConfigFile(startDirectory: string = process.cwd()): Promise<s
 
   while (true) {
     const json5Path = `${currentDirectory}/agent-tools.json5`;
+    // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
     if (await Bun.file(json5Path).exists()) {
       return json5Path;
     }
 
     const jsonPath = `${currentDirectory}/agent-tools.json`;
+    // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
     if (await Bun.file(jsonPath).exists()) {
       return jsonPath;
     }
@@ -107,6 +109,7 @@ export async function loadConfig(): Promise<AgentToolsConfig | undefined> {
       `Invalid agent-tools config at ${configPath}: ${
         error instanceof Error ? error.message : String(error)
       }`,
+      { cause: error },
     );
   }
 }

package/src/credential-guard/index.ts

@@ -14,7 +14,7 @@
  * at infrastructure level (K8s RBAC, file permissions, etc.)
  */
 
-import type { CliToolOverride, CredentialGuardConfig } from "../config/types.ts";
+import type { CliToolOverride, CredentialGuardConfig } from "#config/types.ts";
 
 // ============================================================================
 // TYPES
@@ -108,6 +108,7 @@ const SECRET_PATTERNS = [
       /(?:secret|token|password|passwd|pwd)["  \t:=]+["']?(?!\$\{|process\.env|z\.|generate|create|read|get|fetch|import|export|const|function|return|Schema)[^\s"']{32,}["']?/i,
   },
   {
+    // eslint-disable-next-line eslint/no-useless-concat -- intentionally split to avoid credential guard self-detection
     name: "Priv" + "ate Key",
     pattern: new RegExp("-----BEGIN.*PRIVATE KEY-----"),
   },

package/src/db-tool/config-service.ts

@@ -1,7 +1,7 @@
 import { Effect, Layer, ServiceMap } from "effect";
 
-import { ConfigService, getToolConfig } from "../config";
-import type { DatabaseConfig } from "../config";
+import { ConfigService, getToolConfig } from "#config";
+import type { DatabaseConfig } from "#config";
 
 /**
  * DbConfigService wraps the resolved DatabaseConfig for the selected profile.

package/src/db-tool/index.ts

@@ -5,8 +5,8 @@ import { Console, Effect, Layer, Option } from "effect";
 
 import type { SchemaMode } from "./types";
 
-import { formatOption, formatOutput, renderCauseToStderr, VERSION } from "../shared";
-import { ConfigService, ConfigServiceLayer, getDefaultEnvironment } from "../config";
+import { formatOption, formatOutput, renderCauseToStderr, VERSION } from "#shared";
+import { ConfigService, ConfigServiceLayer, getDefaultEnvironment } from "#config";
 import { makeDbConfigLayer } from "./config-service";
 import { DbConnectionError } from "./errors";
 import { DbService } from "./service";

package/src/db-tool/types.ts

@@ -1,4 +1,4 @@
-import type { Environment, OutputFormat } from "../shared";
+import type { Environment, OutputFormat } from "#shared";
 export type { Environment, OutputFormat };
 
 export type SchemaMode = "tables" | "columns" | "full" | "relationships";

package/src/gh-tool/index.ts

@@ -3,7 +3,7 @@ import { Command } from "effect/unstable/cli";
 import { BunRuntime, BunServices } from "@effect/platform-bun";
 import { Effect, Layer } from "effect";
 
-import { renderCauseToStderr, VERSION } from "../shared";
+import { renderCauseToStderr, VERSION } from "#shared";
 import {
   issueListCommand,
   issueViewCommand,

package/src/gh-tool/issue.ts

@@ -1,7 +1,7 @@
 import { Command, Flag } from "effect/unstable/cli";
 import { Effect, Option } from "effect";
 
-import { formatOption, logFormatted } from "../shared";
+import { formatOption, logFormatted } from "#shared";
 import { GitHubCommandError } from "./errors";
 import { GitHubService } from "./service";
 

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

@@ -1,15 +1,15 @@
 import { Command, Flag } from "effect/unstable/cli";
 import { Effect, Option } from "effect";
 
-import type { PRStatusResult } from "../types";
+import type { PRStatusResult } from "#gh/types";
 
-import { formatOption, logFormatted } from "../../shared";
+import { formatOption, logFormatted } from "#shared";
 import {
   CI_CHECK_WATCH_TIMEOUT_MS,
   DEFAULT_DELETE_BRANCH,
   DEFAULT_MERGE_STRATEGY,
   MERGE_STRATEGIES,
-} from "../config";
+} from "#gh/config";
 
 import {
   createPR,

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

@@ -1,9 +1,9 @@
 import { Console, Effect, Option } from "effect";
 
-import type { BranchPRDetail, CheckResult, MergeResult, MergeStrategy, PRInfo } from "../types";
+import type { BranchPRDetail, CheckResult, MergeResult, MergeStrategy, PRInfo } from "#gh/types";
 
-import { GitHubCommandError, GitHubMergeError, GitHubTimeoutError } from "../errors";
-import { GitHubService } from "../service";
+import { GitHubCommandError, GitHubMergeError, GitHubTimeoutError } from "#gh/errors";
+import { GitHubService } from "#gh/service";
 
 import type { ButStatusJson, PRViewJsonResult } from "./helpers";
 import { runLocalCommand } from "./helpers";
@@ -155,7 +155,7 @@ export const detectPRStatus = Effect.fn("pr.detectPRStatus")(function* () {
     { concurrency: "unbounded" },
   );
 
-  const foundPrs = branchResults.filter((r) => r.openPr !== null).map((r) => r.openPr!);
+  const foundPrs = branchResults.flatMap((r) => (r.openPr === null ? [] : [r.openPr]));
 
   if (foundPrs.length === 0) {
     const branchDetails: BranchPRDetail[] = branchResults.map((r) => ({
@@ -172,7 +172,7 @@ export const detectPRStatus = Effect.fn("pr.detectPRStatus")(function* () {
   if (foundPrs.length === 1) {
     return {
       mode: "single" as const,
-      pr: foundPrs[0]!,
+      pr: foundPrs[0] as PRInfo,
     };
   }
 
@@ -205,7 +205,11 @@ export const createPR = Effect.fn("pr.createPR")(function* (opts: {
           "--limit",
           "1",
         ])
-        .pipe(Effect.map((prs) => (prs.length > 0 ? Option.some(prs[0]!) : Option.none())))
+        .pipe(
+          Effect.map((prs) =>
+            prs.length > 0 ? Option.some(prs[0] as PRInfo) : Option.none<PRInfo>(),
+          ),
+        )
     : gh
         .runGhJson<{ number: number; url: string }>(["pr", "view", "--json", "number,url"])
         .pipe(Effect.option);
@@ -258,7 +262,7 @@ export const createPR = Effect.fn("pr.createPR")(function* (opts: {
     "1",
   ]);
   if (prs.length > 0) {
-    return prs[0]!;
+    return prs[0] as PRInfo;
   }
 
   return yield* Effect.fail(

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

@@ -1,7 +1,7 @@
 import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
 import { Effect, Stream } from "effect";
 
-import { GitHubCommandError } from "../errors";
+import { GitHubCommandError } from "#gh/errors";
 
 export type LocalCommandResult = {
   stdout: string;

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

@@ -7,10 +7,10 @@ import type {
   IsoTimestamp,
   ReviewComment,
   ReviewThread,
-} from "../types";
+} from "#gh/types";
 
-import { GitHubCommandError } from "../errors";
-import { GitHubService } from "../service";
+import { GitHubCommandError } from "#gh/errors";
+import { GitHubService } from "#gh/service";
 
 import { viewPR } from "./core";
 
@@ -190,9 +190,12 @@ export const fetchThreads = Effect.fn("pr.fetchThreads")(function* (
   const threads = response.repository.pullRequest.reviewThreads.nodes;
 
   const mapped: ReviewThread[] = threads
-    .filter((node) => node.comments.nodes.length > 0)
     .map((node) => {
-      const comment = node.comments.nodes[0]!;
+      const comment = node.comments.nodes[0];
+      if (!comment) {
+        return null;
+      }
+
       return {
         threadId: node.id,
         commentId: comment.databaseId,
@@ -201,7 +204,8 @@ export const fetchThreads = Effect.fn("pr.fetchThreads")(function* (
         body: comment.body,
         isResolved: node.isResolved,
       };
-    });
+    })
+    .filter((thread): thread is ReviewThread => thread !== null);
 
   return unresolvedOnly ? mapped.filter((t) => !t.isResolved) : mapped;
 });

package/src/gh-tool/repo.ts

@@ -1,7 +1,7 @@
 import { Command, Flag } from "effect/unstable/cli";
 import { Effect, Option } from "effect";
 
-import { formatOption, logFormatted } from "../shared";
+import { formatOption, logFormatted } from "#shared";
 import { GitHubCommandError } from "./errors";
 import { GitHubService } from "./service";
 

package/src/gh-tool/workflow.ts

@@ -1,7 +1,7 @@
 import { Command, Flag } from "effect/unstable/cli";
 import { Console, Effect, Option } from "effect";
 
-import { formatOption, logFormatted } from "../shared";
+import { formatOption, logFormatted } from "#shared";
 import { GitHubCommandError, GitHubNotFoundError } from "./errors";
 import { GitHubService } from "./service";
 

package/src/k8s-tool/index.ts

@@ -5,10 +5,10 @@ import { Console, Effect, Layer, Option } from "effect";
 
 import type { CommandResult } from "./types";
 
-import { formatOption, formatOutput, renderCauseToStderr, VERSION } from "../shared";
+import { formatOption, formatOutput, renderCauseToStderr, VERSION } from "#shared";
 import { K8sService, K8sServiceLayer } from "./service";
-import { ConfigService, ConfigServiceLayer, getDefaultEnvironment, getToolConfig } from "../config";
-import type { K8sConfig } from "../config";
+import { ConfigService, ConfigServiceLayer, getDefaultEnvironment, getToolConfig } from "#config";
+import type { K8sConfig } from "#config";
 import { K8sContextError } from "./errors";
 
 /**
@@ -78,17 +78,17 @@ const runK8sCommand = (command: string, options: CommonK8sCommandOptions) =>
     const result = yield* k8sService.runKubectl(command, options.dryRun).pipe(
       Effect.catchTags({
         K8sContextError: (error) => {
-          const result: CommandResult = {
+          const errorResult: CommandResult = {
             success: false,
             error: error.message,
             hint: `Verify cluster ID "${k8sConfig.clusterId}" matches a context in kubectl config. Run: kubectl config get-contexts`,
             nextCommand: "kubectl config get-contexts",
             executionTimeMs: 0,
           };
-          return Effect.succeed(result);
+          return Effect.succeed(errorResult);
         },
         K8sCommandError: (error) => {
-          const result: CommandResult = {
+          const errorResult: CommandResult = {
             success: false,
             error: error.message,
             command: error.command,
@@ -96,10 +96,10 @@ const runK8sCommand = (command: string, options: CommonK8sCommandOptions) =>
               error.hint ?? "Check command syntax and ensure the target namespace/resource exists.",
             executionTimeMs: 0,
           };
-          return Effect.succeed(result);
+          return Effect.succeed(errorResult);
         },
         K8sTimeoutError: (error) => {
-          const result: CommandResult = {
+          const errorResult: CommandResult = {
             success: false,
             error: error.message,
             command: error.command,
@@ -108,7 +108,7 @@ const runK8sCommand = (command: string, options: CommonK8sCommandOptions) =>
               `Command timed out after ${error.timeoutMs}ms. Consider increasing timeoutMs in config or narrowing the query.`,
             executionTimeMs: error.timeoutMs,
           };
-          return Effect.succeed(result);
+          return Effect.succeed(errorResult);
         },
       }),
     );

package/src/k8s-tool/service.ts

@@ -4,8 +4,8 @@ import { Effect, Layer, Option, Ref, ServiceMap, Stream } from "effect";
 import type { CommandResult, Environment } from "./types";
 
 import { K8sCommandError, K8sContextError, K8sTimeoutError } from "./errors";
-import { ConfigService, getToolConfig } from "../config";
-import type { K8sConfig } from "../config";
+import { ConfigService, getToolConfig } from "#config";
+import type { K8sConfig } from "#config";
 
 export class K8sService extends ServiceMap.Service<
   K8sService,

package/src/logs-tool/index.ts

@@ -20,8 +20,8 @@ import { Console, Effect, Layer, Option, Result } from "effect";
 
 import type { Environment, LogResult, ReadOptions } from "./types";
 
-import { formatOption, formatOutput, renderCauseToStderr, VERSION } from "../shared";
-import { ConfigService, ConfigServiceLayer, getDefaultEnvironment } from "../config";
+import { formatOption, formatOutput, renderCauseToStderr, VERSION } from "#shared";
+import { ConfigService, ConfigServiceLayer, getDefaultEnvironment } from "#config";
 import { LogsConfigError, LogsNotFoundError, LogsReadError, LogsTimeoutError } from "./errors";
 import { LogsService, LogsServiceLayer } from "./service";
 

package/src/logs-tool/service.ts

@@ -3,10 +3,10 @@ import { Effect, Layer, Result, ServiceMap, Stream } from "effect";
 
 import type { Environment, LogFile, ReadOptions } from "./types";
 
-import { K8sCommandError } from "../k8s-tool/errors";
-import { K8sService, K8sServiceLayer } from "../k8s-tool/service";
-import { ConfigService, ConfigServiceLayer, getToolConfig } from "../config/loader";
-import type { LogsConfig } from "../config/types";
+import { K8sCommandError } from "#k8s/errors";
+import { K8sService, K8sServiceLayer } from "#k8s/service";
+import { ConfigService, ConfigServiceLayer, getToolConfig } from "#config/loader";
+import type { LogsConfig } from "#config/types";
 import { LogsNotFoundError, LogsReadError, type LogsError } from "./errors";
 
 export const parseLogFiles = (output: string): LogFile[] => {

package/src/logs-tool/types.ts

@@ -1,4 +1,4 @@
-import type { Environment, OutputFormat } from "../shared";
+import type { Environment, OutputFormat } from "#shared";
 export type { Environment, OutputFormat };
 
 export type LogFile = {

package/src/session-tool/config.ts

@@ -2,7 +2,7 @@ import { Effect, Layer, ServiceMap } from "effect";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-import { loadConfig } from "../config/loader";
+import { loadConfig } from "#config/loader";
 
 /**
  * Resolves the OpenCode storage base path from config or default.

package/src/session-tool/index.ts

@@ -13,7 +13,7 @@ import { Console, Effect, Layer, Result } from "effect";
 
 import type { MessageSummary, SessionResult } from "./types";
 
-import { formatOption, formatOutput, VERSION } from "../shared";
+import { formatOption, formatOutput, VERSION } from "#shared";
 import { ResolvedPaths, ResolvedPathsLayer } from "./config";
 import { SessionStorageNotFoundError } from "./errors";
 import { formatDate, SessionService, SessionServiceLayer, truncate } from "./service";

package/src/session-tool/service.ts

@@ -51,8 +51,10 @@ const readJsonFilesInTree = (parentDir: string): Effect.Effect<FileEntry[], Sess
         const subPath = `${parentDir}/${subDir}`;
         let files: string[];
         try {
+          // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
           files = await readdir(subPath);
         } catch {
+          /* ignore unreadable files */
           continue;
         }
 
@@ -63,8 +65,11 @@ const readJsonFilesInTree = (parentDir: string): Effect.Effect<FileEntry[], Sess
             try {
               const content = await Bun.file(filePath).text();
               results.push({ filePath, content });
-            } catch {}
+            } catch {
+              /* ignore unreadable files */
+            }
           });
+        // eslint-disable-next-line eslint/no-await-in-loop -- sequential directory walk, each iteration may short-circuit
         await Promise.all(reads);
       }
 
@@ -90,7 +95,9 @@ const readJsonFilesFlat = (dir: string): Effect.Effect<FileEntry[], SessionError
           try {
             const content = await Bun.file(filePath).text();
             results.push({ filePath, content });
-          } catch {}
+          } catch {
+            /* ignore unreadable files */
+          }
         });
       await Promise.all(reads);
 
@@ -191,7 +198,13 @@ export class SessionService extends ServiceMap.Service<
             }
           }
 
-          return summaries.sort((left, right) => right.created - left.created);
+          return (
+            summaries as MessageSummary[] & {
+              toSorted(
+                compareFn: (left: MessageSummary, right: MessageSummary) => number,
+              ): MessageSummary[];
+            }
+          ).toSorted((left, right) => right.created - left.created);
         }),
 
         searchSummaries: (summaries: MessageSummary[], query: string): MessageSummary[] => {

package/src/session-tool/types.ts

@@ -1,4 +1,4 @@
-import type { OutputFormat } from "../shared";
+import type { OutputFormat } from "#shared";
 
 export type { OutputFormat };
 

package/src/shared/bun.ts

@@ -51,7 +51,7 @@ export async function runCommand(
   };
 }
 
-export async function runShellCommand(
+export function runShellCommand(
   command: string,
   options: CommandOptions = {},
 ): Promise<CommandResult> {

package/src/shared/index.ts

@@ -8,6 +8,7 @@ export { commonArgOptions, parseCommonArgs } from "./cli";
 
 export { renderCauseToStderr } from "./error-renderer";
 
+// eslint-disable-next-line import/no-relative-parent-imports -- package.json lives at project root, outside src/
 import pkg from "../../package.json" with { type: "json" };
 export const VERSION = pkg.version;