@blogic-cz/agent-tools 1.5.2 → 1.5.4

package/src/logs-tool/index.ts

@@ -1,249 +1,5 @@
 #!/usr/bin/env bun
+import { checkEffectVersion } from "#shared/effect-version";
 
-/**
- * Application Logs Tool for Coding Agents
- *
- * Reads application logs from local development or test/prod environments.
- * For test/prod, uses k8s-tool internally to access logs from PVC.
- *
- * Run with --help for full usage documentation.
- *
- * IMPORTANT FOR AI AGENTS:
- * Use this tool to investigate application behavior and errors.
- * Always start with --list to see available log files.
- * Use --format toon for LLM-optimized output (fewer tokens).
- */
-
-import { Command, Flag } from "effect/unstable/cli";
-import { BunRuntime, BunServices } from "@effect/platform-bun";
-import { Effect, Layer, Option, Result } from "effect";
-
-import type { Environment, LogResult, ReadOptions } from "./types";
-
-import {
-  makeSchemaCommand,
-  formatOption,
-  formatOutput,
-  logText,
-  renderCauseToStderr,
-  VERSION,
-} from "#shared";
-import { AuditServiceLayer, withAudit } from "#shared/audit";
-import { ConfigService, ConfigServiceLayer, getDefaultEnvironment } from "#config";
-import { LogsConfigError, LogsNotFoundError, LogsReadError, LogsTimeoutError } from "./errors";
-import { LogsService, LogsServiceLayer } from "./service";
-
-const profileOption = Flag.optional(
-  Flag.String("profile").pipe(
-    Flag.withDescription(
-      "Named profile from agent-tools.json5 logs section (default: 'default' key or single entry)",
-    ),
-  ),
-);
-
-/**
- * Resolve environment from explicit --env flag, config defaultEnvironment, or fail with hint.
- */
-const resolveEnv = (envOption: Option.Option<string>) =>
-  Effect.gen(function* () {
-    const explicit = Option.getOrUndefined(envOption);
-    if (explicit) return explicit;
-
-    const config = yield* ConfigService;
-    const defaultEnv = getDefaultEnvironment(config);
-
-    if (defaultEnv === "prod") {
-      return yield* new LogsConfigError({
-        message:
-          "Implicit prod access blocked. Config defaultEnvironment is 'prod' but --env was not passed explicitly.",
-        hint: "Pass --env prod explicitly to confirm production access, or change defaultEnvironment to a non-prod value.",
-        nextCommand: "agent-tools-logs list --env prod",
-      });
-    }
-
-    if (defaultEnv) return defaultEnv;
-
-    return yield* new LogsConfigError({
-      message:
-        "No environment specified. Use --env <name> or set defaultEnvironment in agent-tools.json5.",
-      hint: 'Set defaultEnvironment in agent-tools.json5 (e.g. defaultEnvironment: "local") or pass --env explicitly.',
-      nextCommand: "agent-tools-logs list --env local",
-    });
-  });
-
-const buildSource = (
-  mode: "list" | "read",
-  env: Environment,
-  logsConfig: { localDir: string; remotePath: string } | undefined,
-  options: ReadOptions | null,
-): string | undefined => {
-  if (!logsConfig) return undefined;
-
-  if (mode === "list") {
-    return env === "local" ? logsConfig.localDir : `${env}:${logsConfig.remotePath}`;
-  }
-
-  if (env === "local") {
-    const fileName = options?.file ?? "latest";
-    return `${logsConfig.localDir}/${fileName}`;
-  }
-
-  const fileName = options?.file ?? "app.log";
-  return `${env}:${logsConfig.remotePath}/${fileName}`;
-};
-
-const listCommand = Command.make(
-  "list",
-  {
-    env: Flag.optional(Flag.String("env")).pipe(
-      Flag.withDescription(
-        "Target environment (e.g. local, test, prod). Falls back to defaultEnvironment in config.",
-      ),
-    ),
-    format: formatOption,
-    profile: profileOption,
-  },
-  ({ env, format, profile }) =>
-    Effect.gen(function* () {
-      const resolvedEnv = yield* resolveEnv(env);
-      const logsService = yield* LogsService;
-      const startTime = Date.now();
-      const profileName = Option.getOrUndefined(profile);
-
-      const result = yield* logsService
-        .listLogs(resolvedEnv as Environment, profileName)
-        .pipe(Effect.result);
-      const executionTimeMs = Date.now() - startTime;
-
-      const logResult: LogResult = Result.match(result, {
-        onFailure: (error) => ({
-          success: false,
-          error: error.message,
-          source: error instanceof LogsNotFoundError ? error.path : undefined,
-          executionTimeMs,
-          hint:
-            error.hint ??
-            (error instanceof LogsReadError && error.source === "config"
-              ? "Add a 'logs' section to agent-tools.json5 with localDir and remotePath."
-              : undefined),
-          nextCommand:
-            error.nextCommand ??
-            (error instanceof LogsReadError && error.source === "config"
-              ? "agent-tools-logs list --env local"
-              : undefined),
-          retryable: error.retryable ?? (error instanceof LogsTimeoutError ? true : undefined),
-        }),
-        onSuccess: (data) => ({
-          success: true,
-          data,
-          source: buildSource("list", resolvedEnv as Environment, undefined, null),
-          executionTimeMs,
-        }),
-      });
-
-      yield* logText(formatOutput(logResult, format));
-    }),
-).pipe(Command.withDescription("List available log files"));
-
-const readCommand = Command.make(
-  "read",
-  {
-    env: Flag.optional(Flag.String("env")).pipe(
-      Flag.withDescription(
-        "Target environment (e.g. local, test, prod). Falls back to defaultEnvironment in config.",
-      ),
-    ),
-    file: Flag.String("file").pipe(
-      Flag.withDescription("Specific log file to read"),
-      Flag.optional,
-    ),
-    format: formatOption,
-    grep: Flag.String("grep").pipe(
-      Flag.withDescription("Filter lines containing case-insensitive literal text"),
-      Flag.optional,
-    ),
-    pretty: Flag.Boolean("pretty").pipe(
-      Flag.withDescription("Pretty-print JSON log entries"),
-      Flag.withDefault(false),
-    ),
-    profile: profileOption,
-    tail: Flag.Int("tail").pipe(Flag.withDescription("Show last N lines"), Flag.withDefault(100)),
-  },
-  ({ env, file, format, grep, pretty, profile, tail }) =>
-    Effect.gen(function* () {
-      const resolvedEnv = yield* resolveEnv(env);
-      const logsService = yield* LogsService;
-      const startTime = Date.now();
-      const profileName = Option.getOrUndefined(profile);
-
-      const readOptions: ReadOptions = {
-        tail,
-        grep: Option.getOrUndefined(grep),
-        file: Option.getOrUndefined(file),
-        pretty,
-      };
-
-      const result = yield* logsService
-        .readLogs(resolvedEnv as Environment, readOptions, profileName)
-        .pipe(Effect.result);
-      const executionTimeMs = Date.now() - startTime;
-
-      const logResult: LogResult = Result.match(result, {
-        onFailure: (error) => ({
-          success: false,
-          error: error.message,
-          source: error instanceof LogsNotFoundError ? error.path : undefined,
-          executionTimeMs,
-          hint:
-            error.hint ??
-            (error instanceof LogsReadError && error.source === "config"
-              ? "Add a 'logs' section to agent-tools.json5 with localDir and remotePath."
-              : undefined),
-          nextCommand:
-            error.nextCommand ??
-            (error instanceof LogsReadError && error.source === "config"
-              ? "agent-tools-logs read --env local --file app.log"
-              : undefined),
-          retryable: error.retryable ?? (error instanceof LogsTimeoutError ? true : undefined),
-        }),
-        onSuccess: (data) => ({
-          success: true,
-          data,
-          source: buildSource("read", resolvedEnv as Environment, undefined, readOptions),
-          executionTimeMs,
-        }),
-      });
-
-      yield* logText(formatOutput(logResult, format));
-    }),
-).pipe(Command.withDescription("Read application logs"));
-
-const commandsCommand = makeSchemaCommand(() => mainCommand);
-
-const mainCommand = Command.make("logs-tool", {}).pipe(
-  Command.withDescription("Application Logs Tool for Coding Agents"),
-  Command.withSubcommands([listCommand, readCommand, commandsCommand]),
-);
-
-const cli = Command.run(mainCommand, {
-  version: VERSION,
-});
-
-export const run = Command.runWith(mainCommand, {
-  version: VERSION,
-});
-
-const MainLayer = LogsServiceLayer.pipe(
-  Layer.provideMerge(ConfigServiceLayer),
-  Layer.provideMerge(BunServices.layer),
-  Layer.provideMerge(AuditServiceLayer),
-);
-
-const program = withAudit("logs", cli).pipe(
-  Effect.provide(MainLayer),
-  Effect.tapCause(renderCauseToStderr),
-);
-
-BunRuntime.runMain(program, {
-  disableErrorReporting: true,
-});
+if (await checkEffectVersion()) await import("./main");
+else process.exitCode = 1;

package/src/logs-tool/main.ts

@@ -0,0 +1,249 @@
+#!/usr/bin/env bun
+
+/**
+ * Application Logs Tool for Coding Agents
+ *
+ * Reads application logs from local development or test/prod environments.
+ * For test/prod, uses k8s-tool internally to access logs from PVC.
+ *
+ * Run with --help for full usage documentation.
+ *
+ * IMPORTANT FOR AI AGENTS:
+ * Use this tool to investigate application behavior and errors.
+ * Always start with --list to see available log files.
+ * Use --format toon for LLM-optimized output (fewer tokens).
+ */
+
+import { Command, Flag } from "effect/unstable/cli";
+import { BunRuntime, BunServices } from "@effect/platform-bun";
+import { Effect, Layer, Option, Result } from "effect";
+
+import type { Environment, LogResult, ReadOptions } from "./types";
+
+import {
+  makeSchemaCommand,
+  formatOption,
+  formatOutput,
+  logText,
+  renderCauseToStderr,
+  VERSION,
+} from "#shared";
+import { AuditServiceLayer, withAudit } from "#shared/audit";
+import { ConfigService, ConfigServiceLayer, getDefaultEnvironment } from "#config";
+import { LogsConfigError, LogsNotFoundError, LogsReadError, LogsTimeoutError } from "./errors";
+import { LogsService, LogsServiceLayer } from "./service";
+
+const profileOption = Flag.optional(
+  Flag.String("profile").pipe(
+    Flag.withDescription(
+      "Named profile from agent-tools.json5 logs section (default: 'default' key or single entry)",
+    ),
+  ),
+);
+
+/**
+ * Resolve environment from explicit --env flag, config defaultEnvironment, or fail with hint.
+ */
+const resolveEnv = (envOption: Option.Option<string>) =>
+  Effect.gen(function* () {
+    const explicit = Option.getOrUndefined(envOption);
+    if (explicit) return explicit;
+
+    const config = yield* ConfigService;
+    const defaultEnv = getDefaultEnvironment(config);
+
+    if (defaultEnv === "prod") {
+      return yield* new LogsConfigError({
+        message:
+          "Implicit prod access blocked. Config defaultEnvironment is 'prod' but --env was not passed explicitly.",
+        hint: "Pass --env prod explicitly to confirm production access, or change defaultEnvironment to a non-prod value.",
+        nextCommand: "agent-tools-logs list --env prod",
+      });
+    }
+
+    if (defaultEnv) return defaultEnv;
+
+    return yield* new LogsConfigError({
+      message:
+        "No environment specified. Use --env <name> or set defaultEnvironment in agent-tools.json5.",
+      hint: 'Set defaultEnvironment in agent-tools.json5 (e.g. defaultEnvironment: "local") or pass --env explicitly.',
+      nextCommand: "agent-tools-logs list --env local",
+    });
+  });
+
+const buildSource = (
+  mode: "list" | "read",
+  env: Environment,
+  logsConfig: { localDir: string; remotePath: string } | undefined,
+  options: ReadOptions | null,
+): string | undefined => {
+  if (!logsConfig) return undefined;
+
+  if (mode === "list") {
+    return env === "local" ? logsConfig.localDir : `${env}:${logsConfig.remotePath}`;
+  }
+
+  if (env === "local") {
+    const fileName = options?.file ?? "latest";
+    return `${logsConfig.localDir}/${fileName}`;
+  }
+
+  const fileName = options?.file ?? "app.log";
+  return `${env}:${logsConfig.remotePath}/${fileName}`;
+};
+
+const listCommand = Command.make(
+  "list",
+  {
+    env: Flag.optional(Flag.String("env")).pipe(
+      Flag.withDescription(
+        "Target environment (e.g. local, test, prod). Falls back to defaultEnvironment in config.",
+      ),
+    ),
+    format: formatOption,
+    profile: profileOption,
+  },
+  ({ env, format, profile }) =>
+    Effect.gen(function* () {
+      const resolvedEnv = yield* resolveEnv(env);
+      const logsService = yield* LogsService;
+      const startTime = Date.now();
+      const profileName = Option.getOrUndefined(profile);
+
+      const result = yield* logsService
+        .listLogs(resolvedEnv as Environment, profileName)
+        .pipe(Effect.result);
+      const executionTimeMs = Date.now() - startTime;
+
+      const logResult: LogResult = Result.match(result, {
+        onFailure: (error) => ({
+          success: false,
+          error: error.message,
+          source: error instanceof LogsNotFoundError ? error.path : undefined,
+          executionTimeMs,
+          hint:
+            error.hint ??
+            (error instanceof LogsReadError && error.source === "config"
+              ? "Add a 'logs' section to agent-tools.json5 with localDir and remotePath."
+              : undefined),
+          nextCommand:
+            error.nextCommand ??
+            (error instanceof LogsReadError && error.source === "config"
+              ? "agent-tools-logs list --env local"
+              : undefined),
+          retryable: error.retryable ?? (error instanceof LogsTimeoutError ? true : undefined),
+        }),
+        onSuccess: (data) => ({
+          success: true,
+          data,
+          source: buildSource("list", resolvedEnv as Environment, undefined, null),
+          executionTimeMs,
+        }),
+      });
+
+      yield* logText(formatOutput(logResult, format));
+    }),
+).pipe(Command.withDescription("List available log files"));
+
+const readCommand = Command.make(
+  "read",
+  {
+    env: Flag.optional(Flag.String("env")).pipe(
+      Flag.withDescription(
+        "Target environment (e.g. local, test, prod). Falls back to defaultEnvironment in config.",
+      ),
+    ),
+    file: Flag.String("file").pipe(
+      Flag.withDescription("Specific log file to read"),
+      Flag.optional,
+    ),
+    format: formatOption,
+    grep: Flag.String("grep").pipe(
+      Flag.withDescription("Filter lines containing case-insensitive literal text"),
+      Flag.optional,
+    ),
+    pretty: Flag.Boolean("pretty").pipe(
+      Flag.withDescription("Pretty-print JSON log entries"),
+      Flag.withDefault(false),
+    ),
+    profile: profileOption,
+    tail: Flag.Int("tail").pipe(Flag.withDescription("Show last N lines"), Flag.withDefault(100)),
+  },
+  ({ env, file, format, grep, pretty, profile, tail }) =>
+    Effect.gen(function* () {
+      const resolvedEnv = yield* resolveEnv(env);
+      const logsService = yield* LogsService;
+      const startTime = Date.now();
+      const profileName = Option.getOrUndefined(profile);
+
+      const readOptions: ReadOptions = {
+        tail,
+        grep: Option.getOrUndefined(grep),
+        file: Option.getOrUndefined(file),
+        pretty,
+      };
+
+      const result = yield* logsService
+        .readLogs(resolvedEnv as Environment, readOptions, profileName)
+        .pipe(Effect.result);
+      const executionTimeMs = Date.now() - startTime;
+
+      const logResult: LogResult = Result.match(result, {
+        onFailure: (error) => ({
+          success: false,
+          error: error.message,
+          source: error instanceof LogsNotFoundError ? error.path : undefined,
+          executionTimeMs,
+          hint:
+            error.hint ??
+            (error instanceof LogsReadError && error.source === "config"
+              ? "Add a 'logs' section to agent-tools.json5 with localDir and remotePath."
+              : undefined),
+          nextCommand:
+            error.nextCommand ??
+            (error instanceof LogsReadError && error.source === "config"
+              ? "agent-tools-logs read --env local --file app.log"
+              : undefined),
+          retryable: error.retryable ?? (error instanceof LogsTimeoutError ? true : undefined),
+        }),
+        onSuccess: (data) => ({
+          success: true,
+          data,
+          source: buildSource("read", resolvedEnv as Environment, undefined, readOptions),
+          executionTimeMs,
+        }),
+      });
+
+      yield* logText(formatOutput(logResult, format));
+    }),
+).pipe(Command.withDescription("Read application logs"));
+
+const commandsCommand = makeSchemaCommand(() => mainCommand);
+
+const mainCommand = Command.make("logs-tool", {}).pipe(
+  Command.withDescription("Application Logs Tool for Coding Agents"),
+  Command.withSubcommands([listCommand, readCommand, commandsCommand]),
+);
+
+const cli = Command.run(mainCommand, {
+  version: VERSION,
+});
+
+export const run = Command.runWith(mainCommand, {
+  version: VERSION,
+});
+
+const MainLayer = LogsServiceLayer.pipe(
+  Layer.provideMerge(ConfigServiceLayer),
+  Layer.provideMerge(BunServices.layer),
+  Layer.provideMerge(AuditServiceLayer),
+);
+
+const program = withAudit("logs", cli).pipe(
+  Effect.provide(MainLayer),
+  Effect.tapCause(renderCauseToStderr),
+);
+
+BunRuntime.runMain(program, {
+  disableErrorReporting: true,
+});

package/src/observability-tool/index.ts

@@ -1,36 +1,5 @@
 #!/usr/bin/env bun
+import { checkEffectVersion } from "#shared/effect-version";
 
-import { BunRuntime, BunServices } from "@effect/platform-bun";
-import { Console, Effect, Layer } from "effect";
-import type { Cause } from "effect";
-import { Command } from "effect/unstable/cli";
-
-import { ConfigServiceLayer } from "#config";
-import { AuditServiceLayer, withAudit } from "#shared/audit";
-import { makeSchemaCommand, VERSION } from "#shared";
-
-import { metricsCommand } from "./metrics";
-import { logsCommand } from "./logs";
-import { traceCommand } from "./trace";
-
-const renderCauseToStderr = (cause: Cause.Cause<unknown>) => Console.error(cause.toString());
-
-const commandsCommand = makeSchemaCommand(() => mainCommand);
-
-const mainCommand = Command.make("observability-tool", {}).pipe(
-  Command.withDescription(
-    "LGTM observability queries — Tempo traces, Loki logs, Prometheus metrics",
-  ),
-  Command.withSubcommands([traceCommand, metricsCommand, logsCommand, commandsCommand]),
-);
-
-const cli = Command.run(mainCommand, { version: VERSION });
-
-const MainLayer = Layer.mergeAll(BunServices.layer, ConfigServiceLayer, AuditServiceLayer);
-
-const program = withAudit("observability", cli).pipe(
-  Effect.provide(MainLayer),
-  Effect.tapCause(renderCauseToStderr),
-);
-
-BunRuntime.runMain(program, { disableErrorReporting: true });
+if (await checkEffectVersion()) await import("./main");
+else process.exitCode = 1;

package/src/observability-tool/main.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env bun
+
+import { BunRuntime, BunServices } from "@effect/platform-bun";
+import { Console, Effect, Layer } from "effect";
+import type { Cause } from "effect";
+import { Command } from "effect/unstable/cli";
+
+import { ConfigServiceLayer } from "#config";
+import { AuditServiceLayer, withAudit } from "#shared/audit";
+import { makeSchemaCommand, VERSION } from "#shared";
+
+import { metricsCommand } from "./metrics";
+import { logsCommand } from "./logs";
+import { traceCommand } from "./trace";
+
+const renderCauseToStderr = (cause: Cause.Cause<unknown>) => Console.error(cause.toString());
+
+const commandsCommand = makeSchemaCommand(() => mainCommand);
+
+const mainCommand = Command.make("observability-tool", {}).pipe(
+  Command.withDescription(
+    "LGTM observability queries — Tempo traces, Loki logs, Prometheus metrics",
+  ),
+  Command.withSubcommands([traceCommand, metricsCommand, logsCommand, commandsCommand]),
+);
+
+const cli = Command.run(mainCommand, { version: VERSION });
+
+const MainLayer = Layer.mergeAll(BunServices.layer, ConfigServiceLayer, AuditServiceLayer);
+
+const program = withAudit("observability", cli).pipe(
+  Effect.provide(MainLayer),
+  Effect.tapCause(renderCauseToStderr),
+);
+
+BunRuntime.runMain(program, { disableErrorReporting: true });