@blogic-cz/agent-tools 0.9.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # @blogic-cz/agent-tools
 
-Safe CLI wrappers for AI coding agents. 7 tools for GitHub, databases, Kubernetes, Azure DevOps, logs, OpenCode sessions, and audit history — with JSON5 config and a credential guard that blocks agents from touching secrets.
+Safe CLI wrappers for AI coding agents. 8 tools for GitHub, Grafana, databases, Kubernetes, Azure DevOps, logs, OpenCode sessions, and audit history — with JSON5 config and a credential guard that blocks agents from touching secrets.
 
 ## Why
 
@@ -33,6 +33,7 @@ Install per-tool skills for only the tools your project uses:
 
 ```bash
 npx skills add blogic-cz/agent-tools --path skill/gh-tool
+npx skills add blogic-cz/agent-tools --path skill/grafana-tool
 npx skills add blogic-cz/agent-tools --path skill/db-tool
 npx skills add blogic-cz/agent-tools --path skill/k8s-tool
 npx skills add blogic-cz/agent-tools --path skill/az-tool
@@ -61,12 +62,13 @@ Follow these steps to set up agent-tools in the consumer project.
 - **Non-JavaScript project** (no `package.json`): Skip installation — run tools directly with `bunx`:
   ```bash
   bunx gh-tool pr status
+  bunx grafana-tool health
   bunx k8s-tool pods --env test
   ```
 
 **Step 2 — Configure**
 
-Ask the user which tools they need (gh, db, k8s, az, logs, session, audit). Create `agent-tools.json5` in the project root with **only the selected tools configured**. See [`examples/agent-tools.json5`](./examples/agent-tools.json5) for the full config reference with all options documented.
+Ask the user which tools they need (gh, grafana, db, k8s, az, logs, session, audit). Create `agent-tools.json5` in the project root with **only the selected tools configured**. See [`examples/agent-tools.json5`](./examples/agent-tools.json5) for the full config reference with all options documented.
 
 Minimal starting config:
 
@@ -98,6 +100,7 @@ Install **only the per-tool skills the project needs** (recommended), or the all
 ```bash
 # Per-tool skills (recommended) — install only what the project uses
 npx skills add blogic-cz/agent-tools --path skill/gh-tool
+npx skills add blogic-cz/agent-tools --path skill/grafana-tool
 npx skills add blogic-cz/agent-tools --path skill/db-tool
 npx skills add blogic-cz/agent-tools --path skill/k8s-tool
 npx skills add blogic-cz/agent-tools --path skill/az-tool
@@ -115,6 +118,7 @@ Available per-tool skills:
 | Skill          | Install when project uses                  |
 | -------------- | ------------------------------------------ |
 | `gh-tool`      | GitHub PRs, issues, workflows, CI checks   |
+| `grafana-tool` | Grafana dashboards, alerts, PromQL, LogQL  |
 | `db-tool`      | SQL queries, schema introspection          |
 | `k8s-tool`     | Kubernetes pods, logs, deployments         |
 | `az-tool`      | Azure DevOps pipelines, builds             |
@@ -181,6 +185,19 @@ bun run agent-tools/example-tool/index.ts ping
       remotePath: "/app/logs",
     },
   },
+  grafana: {
+    // Profile name (selected via --profile, or used automatically when it's the only one)
+    default: {
+      // Environment name (selected via --env)
+      environments: {
+        local: {
+          url: "http://localhost:40300",
+          prometheusUid: "prometheus",
+          lokiUid: "loki",
+        },
+      },
+    },
+  },
 }
 ```
 
@@ -188,6 +205,7 @@ bun run agent-tools/example-tool/index.ts ping
 
 ```bash
 bun gh-tool pr status
+bun grafana-tool dashboards list --env local
 bun k8s-tool kubectl --env test --cmd "get pods"
 bun logs-tool list --env local
 bun audit-tool list --limit 20
@@ -211,6 +229,7 @@ export default { handleToolExecuteBefore };
 | Binary         | Description                                                                                                      |
 | -------------- | ---------------------------------------------------------------------------------------------------------------- |
 | `gh-tool`      | GitHub CLI wrapper — PR management, issues, workflows, composite commands (`review-triage`, `reply-and-resolve`) |
+| `grafana-tool` | Grafana API wrapper — health, dashboards, datasources, alerts, PromQL, and LogQL queries                         |
 | `audit-tool`   | Audit trail browser — inspect recent tool invocations and purge old entries                                      |
 | `db-tool`      | Database query tool — SQL execution, schema introspection                                                        |
 | `k8s-tool`     | Kubernetes tool — kubectl wrapper + structured commands (`pods`, `logs`, `describe`, `exec`, `top`)              |
@@ -228,7 +247,7 @@ Every tool invocation is automatically recorded to a local SQLite database — z
 
 ### How it works
 
-Each CLI wrapper (`gh`, `k8s`, `db`, `az`, `logs`, `session`, `audit`) writes a row to `~/.agent-tools/audit.sqlite` on every execution. Logging is fire-and-forget — if the database is unavailable or write fails, the tool continues normally. Audit never blocks or slows down your workflow.
+Each CLI wrapper (`gh`, `grafana`, `k8s`, `db`, `az`, `logs`, `session`, `audit`) writes a row to `~/.agent-tools/audit.sqlite` on every execution. Logging is fire-and-forget — if the database is unavailable or write fails, the tool continues normally. Audit never blocks or slows down your workflow.
 
 Entries older than `retentionDays` (default: 90) are automatically purged on each write.
 
@@ -268,16 +287,16 @@ All settings are optional — audit works out of the box with sensible defaults.
 
 ### What gets recorded
 
-| Column      | Description                                            |
-| ----------- | ------------------------------------------------------ |
-| `ts`        | ISO 8601 timestamp                                     |
-| `tool`      | Tool name (`gh`, `k8s`, `db`, `az`, `logs`, `session`) |
-| `project`   | Working directory (`process.cwd()`)                    |
-| `args`      | Command-line arguments (JSON array)                    |
-| `duration`  | Execution time in milliseconds                         |
-| `success`   | `1` (success) or `0` (failure)                         |
-| `error`     | Error message if failed, `null` otherwise              |
-| `exit_code` | Process exit code                                      |
+| Column      | Description                                                       |
+| ----------- | ----------------------------------------------------------------- |
+| `ts`        | ISO 8601 timestamp                                                |
+| `tool`      | Tool name (`gh`, `grafana`, `k8s`, `db`, `az`, `logs`, `session`) |
+| `project`   | Working directory (`process.cwd()`)                               |
+| `args`      | Command-line arguments (JSON array)                               |
+| `duration`  | Execution time in milliseconds                                    |
+| `success`   | `1` (success) or `0` (failure)                                    |
+| `error`     | Error message if failed, `null` otherwise                         |
+| `exit_code` | Process exit code                                                 |
 
 ## Configuration
 
@@ -331,13 +350,14 @@ See [`examples/agent-tools.json5`](./examples/agent-tools.json5) for a complete
 
 Each tool uses its own auth method — no unified token store:
 
-| Tool        | Auth Method                                                                                  |
-| ----------- | -------------------------------------------------------------------------------------------- |
-| `gh-tool`   | `gh` CLI session (`gh auth login`) or `GITHUB_TOKEN` env var                                 |
-| `k8s-tool`  | Existing kubectl context (kubeconfig). Cluster ID from config resolves context automatically |
-| `az-tool`   | `az` CLI session (`az login`)                                                                |
-| `db-tool`   | Password from env var defined by `passwordEnvVar` in config (e.g. `AGENT_TOOLS_DB_PASSWORD`) |
-| `logs-tool` | No auth — reads local files or uses k8s-tool for remote access                               |
+| Tool           | Auth Method                                                                                  |
+| -------------- | -------------------------------------------------------------------------------------------- |
+| `gh-tool`      | `gh` CLI session (`gh auth login`) or `GITHUB_TOKEN` env var                                 |
+| `grafana-tool` | Grafana URL from config plus optional token from `tokenEnvVar`                               |
+| `k8s-tool`     | Existing kubectl context (kubeconfig). Cluster ID from config resolves context automatically |
+| `az-tool`      | `az` CLI session (`az login`)                                                                |
+| `db-tool`      | Password from env var defined by `passwordEnvVar` in config (e.g. `AGENT_TOOLS_DB_PASSWORD`) |
+| `logs-tool`    | No auth — reads local files or uses k8s-tool for remote access                               |
 
 Secrets are **never** stored in the config file. The `db-tool` config references env var **names** only:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "CLI tools for AI coding agent workflows — GitHub, database, Kubernetes, Azure DevOps, logs, sessions, and audit",
   "keywords": [
     "agent",
@@ -9,6 +9,7 @@
     "database",
     "devops",
     "github",
+    "grafana",
     "kubernetes",
     "tools"
   ],
@@ -23,6 +24,7 @@
     "agent-tools-az": "./src/az-tool/index.ts",
     "agent-tools-db": "./src/db-tool/index.ts",
     "agent-tools-gh": "./src/gh-tool/index.ts",
+    "agent-tools-grafana": "./src/grafana-tool/index.ts",
     "agent-tools-k8s": "./src/k8s-tool/index.ts",
     "agent-tools-logs": "./src/logs-tool/index.ts",
     "agent-tools-session": "./src/session-tool/index.ts",
@@ -30,6 +32,7 @@
     "az-tool": "./src/az-tool/index.ts",
     "db-tool": "./src/db-tool/index.ts",
     "gh-tool": "./src/gh-tool/index.ts",
+    "grafana-tool": "./src/grafana-tool/index.ts",
     "k8s-tool": "./src/k8s-tool/index.ts",
     "logs-tool": "./src/logs-tool/index.ts",
     "session-tool": "./src/session-tool/index.ts"
@@ -72,6 +75,10 @@
       "types": "./dist/db-tool/*.d.ts",
       "default": "./src/db-tool/*.ts"
     },
+    "#grafana/*": {
+      "types": "./dist/grafana-tool/*.d.ts",
+      "default": "./src/grafana-tool/*.ts"
+    },
     "#logs/*": {
       "types": "./dist/logs-tool/*.d.ts",
       "default": "./src/logs-tool/*.ts"
@@ -101,6 +108,10 @@
     "./config": {
       "types": "./dist/config/index.d.ts",
       "default": "./src/config/index.ts"
+    },
+    "./audit": {
+      "types": "./dist/shared/audit.d.ts",
+      "default": "./src/shared/audit.ts"
     }
   },
   "publishConfig": {
@@ -112,6 +123,7 @@
     "check:ci": "bun check.ts ci",
     "format": "oxfmt",
     "format:check": "oxfmt --check",
+    "grafana-tool": "bun src/grafana-tool/index.ts",
     "gh-tool": "bun src/gh-tool/index.ts",
     "lint": "oxlint -c ./.oxlintrc.json --deny-warnings",
     "lint:fix": "oxlint -c ./.oxlintrc.json --fix",

package/schemas/agent-tools.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://raw.githubusercontent.com/blogic-cz/agent-tools/main/schemas/agent-tools.schema.json",
   "title": "Agent Tools Configuration",
-  "description": "Root configuration for the agent-tools package. Tool-specific sections (azure, kubernetes, database, logs) are maps of named profiles keyed by profile name. Tools choose a profile via --profile <name> (default key is 'default', single-entry maps can be auto-selected). session, audit, and credentialGuard are global sections.",
+  "description": "Root configuration for the agent-tools package. Tool-specific sections (azure, kubernetes, database, grafana, logs) are maps of named profiles keyed by profile name. Tools choose a profile via --profile <name> (default key is 'default', single-entry maps can be auto-selected). session, audit, and credentialGuard are global sections.",
   "type": "object",
   "additionalProperties": true,
   "properties": {
@@ -34,6 +34,14 @@
         "$ref": "#/definitions/DatabaseConfig"
       }
     },
+    "grafana": {
+      "description": "Named Grafana profiles as Record<string, GrafanaConfig>.",
+      "type": "object",
+      "additionalProperties": {
+        "description": "Grafana profile configuration containing one or more environments.",
+        "$ref": "#/definitions/GrafanaConfig"
+      }
+    },
     "logs": {
       "description": "Named logs profiles as Record<string, LogsConfig>.",
       "type": "object",
@@ -192,6 +200,45 @@
       },
       "required": ["environments"]
     },
+    "GrafanaEnvTarget": {
+      "description": "Single Grafana environment target.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "description": "Base Grafana URL.",
+          "type": "string"
+        },
+        "tokenEnvVar": {
+          "description": "Environment variable containing a Grafana API token.",
+          "type": "string"
+        },
+        "prometheusUid": {
+          "description": "Grafana datasource UID for Prometheus queries.",
+          "type": "string"
+        },
+        "lokiUid": {
+          "description": "Grafana datasource UID for Loki queries.",
+          "type": "string"
+        }
+      },
+      "required": ["url"]
+    },
+    "GrafanaConfig": {
+      "description": "Grafana profile configuration.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "environments": {
+          "description": "Named Grafana environments as Record<string, GrafanaEnvTarget>.",
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/GrafanaEnvTarget"
+          }
+        }
+      },
+      "required": ["environments"]
+    },
     "LogsConfig": {
       "description": "Logs profile configuration.",
       "type": "object",

package/src/config/index.ts

@@ -4,6 +4,8 @@ export type {
   K8sConfig,
   DbEnvConfig,
   DatabaseConfig,
+  GrafanaConfig,
+  GrafanaEnvTarget,
   LogsConfig,
   AuditConfig,
   CliToolOverride,

package/src/config/loader.ts

@@ -54,6 +54,17 @@ const LogsConfigSchema = Schema.Struct({
   remotePath: Schema.String,
 });
 
+const GrafanaEnvTargetSchema = Schema.Struct({
+  url: Schema.String,
+  tokenEnvVar: Schema.optionalKey(Schema.String),
+  prometheusUid: Schema.optionalKey(Schema.String),
+  lokiUid: Schema.optionalKey(Schema.String),
+});
+
+const GrafanaConfigSchema = Schema.Struct({
+  environments: Schema.Record(Schema.String, GrafanaEnvTargetSchema),
+});
+
 const AuditConfigSchema = Schema.Struct({
   retentionDays: Schema.optionalKey(Schema.Number),
   dbPath: Schema.optionalKey(Schema.String),
@@ -69,6 +80,7 @@ const KNOWN_TOP_LEVEL_KEYS = new Set([
   "azure",
   "kubernetes",
   "database",
+  "grafana",
   "logs",
   "session",
   "audit",
@@ -82,6 +94,7 @@ const AgentToolsConfigSchema = Schema.Struct({
   azure: Schema.optionalKey(Schema.Record(Schema.String, AzureConfigSchema)),
   kubernetes: Schema.optionalKey(Schema.Record(Schema.String, K8sConfigSchema)),
   database: Schema.optionalKey(Schema.Record(Schema.String, DatabaseConfigSchema)),
+  grafana: Schema.optionalKey(Schema.Record(Schema.String, GrafanaConfigSchema)),
   logs: Schema.optionalKey(Schema.Record(Schema.String, LogsConfigSchema)),
   session: Schema.optionalKey(
     Schema.Struct({
@@ -175,7 +188,10 @@ export const ConfigServiceLayer = Layer.effect(
   }),
 );
 
-type ProfiledSection = keyof Pick<AgentToolsConfig, "azure" | "kubernetes" | "database" | "logs">;
+type ProfiledSection = keyof Pick<
+  AgentToolsConfig,
+  "azure" | "kubernetes" | "database" | "grafana" | "logs"
+>;
 
 export function getToolConfig<T>(
   config: AgentToolsConfig | undefined,

package/src/config/types.ts

@@ -43,6 +43,19 @@ export type LogsConfig = {
   remotePath: string;
 };
 
+/** Single Grafana environment connection details */
+export type GrafanaEnvTarget = {
+  url: string;
+  tokenEnvVar?: string;
+  prometheusUid?: string;
+  lokiUid?: string;
+};
+
+/** Grafana profile configuration */
+export type GrafanaConfig = {
+  environments: Record<string, GrafanaEnvTarget>;
+};
+
 export type CliToolOverride = {
   tool: string;
   suggestion: string;
@@ -86,6 +99,8 @@ export type AgentToolsConfig = {
   database?: Record<string, DatabaseConfig>;
   /** Named logs profiles. e.g. { default: { localDir: "...", remotePath: "..." } } */
   logs?: Record<string, LogsConfig>;
+  /** Named Grafana profiles. e.g. { default: { environments: { local: {...}, prod: {...} } } } */
+  grafana?: Record<string, GrafanaConfig>;
   /** Global session config (not per-profile) */
   session?: {
     storagePath: string;

package/src/gh-tool/index.ts

@@ -20,6 +20,7 @@ import {
   prViewCommand,
   prStatusCommand,
   prCreateCommand,
+  prCloseCommand,
   prEditCommand,
   prMergeCommand,
   prThreadsCommand,
@@ -66,6 +67,7 @@ const prCommand = Command.make("pr", {}).pipe(
     prViewCommand,
     prStatusCommand,
     prCreateCommand,
+    prCloseCommand,
     prEditCommand,
     prMergeCommand,
     prThreadsCommand,

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

@@ -17,6 +17,7 @@ import {
 } from "#gh/config";
 
 import {
+  closePR,
   createPR,
   detectPRStatus,
   editPR,
@@ -147,6 +148,44 @@ export const prEditCommand = Command.make(
     }),
 ).pipe(Command.withDescription("Edit an existing PR's title, body, or other metadata"));
 
+export const prCloseCommand = Command.make(
+  "close",
+  {
+    comment: Flag.string("comment").pipe(
+      Flag.withDescription("Comment to add when closing"),
+      Flag.optional,
+    ),
+    commentFile: Flag.string("comment-file").pipe(
+      Flag.withDescription("Read close comment from a file path or '-' for stdin"),
+      Flag.optional,
+    ),
+    deleteBranch: Flag.boolean("delete-branch").pipe(
+      Flag.withDescription("Delete the branch after closing"),
+      Flag.withDefault(false),
+    ),
+    format: formatOption,
+    pr: Flag.integer("pr").pipe(Flag.withDescription("PR number to close")),
+  },
+  ({ comment, commentFile, deleteBranch, format, pr }) =>
+    Effect.gen(function* () {
+      const resolvedComment = yield* resolveOptionalTextInput(
+        "gh-tool pr close",
+        Option.getOrNull(comment),
+        Option.getOrNull(commentFile),
+        "--comment",
+        "--comment-file",
+        "comment",
+      );
+
+      const result = yield* closePR({
+        comment: resolvedComment,
+        deleteBranch,
+        pr,
+      });
+      yield* logFormatted(result, format);
+    }),
+).pipe(Command.withDescription("Close a PR with optional comment and branch deletion"));
+
 export const prMergeCommand = Command.make(
   "merge",
   {

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

@@ -606,6 +606,28 @@ export const mergePR = Effect.fn("pr.mergePR")(function* (opts: {
   return result;
 });
 
+export const closePR = Effect.fn("pr.closePR")(function* (opts: {
+  pr: number;
+  comment: string | null;
+  deleteBranch: boolean;
+}) {
+  const gh = yield* GitHubService;
+
+  const args = ["pr", "close", String(opts.pr)];
+
+  if (opts.comment !== null) {
+    args.push("--comment", opts.comment);
+  }
+
+  if (opts.deleteBranch) {
+    args.push("--delete-branch");
+  }
+
+  yield* gh.runGh(args);
+
+  return yield* viewPR(opts.pr);
+});
+
 export const editPR = Effect.fn("pr.editPR")(function* (opts: {
   pr: number;
   title: string | null;

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

@@ -1,6 +1,7 @@
 export {
   prChecksCommand,
   prChecksFailedCommand,
+  prCloseCommand,
   prCommentCommand,
   prCommentsCommand,
   prCreateCommand,

package/src/grafana-tool/alerts.ts

@@ -0,0 +1,159 @@
+import { Console, Effect } from "effect";
+import { Command, Flag } from "effect/unstable/cli";
+
+import { formatOption, formatOutput } from "#shared";
+
+import {
+  envOption,
+  formatGrafanaError,
+  grafanaFetch,
+  profileOption,
+  resolveConfig,
+} from "./shared";
+
+type AlertRulesResponse = Record<
+  string,
+  Array<{
+    name: string;
+    rules: Array<{
+      name: string;
+      state: string;
+      health: string;
+      lastEvaluation?: string;
+      evaluationTime?: number;
+    }>;
+  }>
+>;
+
+type AlertInstance = {
+  labels: Record<string, string>;
+  annotations: Record<string, string>;
+  state: string;
+  activeAt?: string;
+  value?: string;
+};
+
+const listCommand = Command.make(
+  "list",
+  { format: formatOption, env: envOption, profile: profileOption },
+  ({ format, env, profile }) => {
+    const start = Date.now();
+
+    return Effect.gen(function* () {
+      const config = yield* resolveConfig(env, profile);
+      const data = yield* grafanaFetch<AlertRulesResponse>(
+        config,
+        "/api/ruler/grafana/api/v1/rules",
+      );
+
+      const rules = Object.entries(data).flatMap(([namespace, groups]) =>
+        groups.flatMap((group) =>
+          group.rules.map((rule) => ({
+            name: rule.name,
+            state: rule.state,
+            health: rule.health,
+            namespace,
+            group: group.name,
+            lastEvaluation: rule.lastEvaluation,
+            evaluationTime: rule.evaluationTime,
+          })),
+        ),
+      );
+
+      const result = {
+        success: true,
+        message: `Found ${rules.length} alert rule(s)`,
+        data: { rules, count: rules.length },
+        executionTimeMs: Date.now() - start,
+      };
+
+      yield* Console.log(formatOutput(result, format));
+    }).pipe(
+      Effect.catch((error) =>
+        Effect.gen(function* () {
+          const result = {
+            success: false,
+            message: "Failed to list alert rules",
+            error: formatGrafanaError(error),
+            hint: "Check Grafana is running and accessible",
+            executionTimeMs: Date.now() - start,
+          };
+
+          yield* Console.log(formatOutput(result, format));
+        }),
+      ),
+    );
+  },
+).pipe(Command.withDescription("List all alert rules"));
+
+const statusCommand = Command.make(
+  "status",
+  {
+    format: formatOption,
+    env: envOption,
+    profile: profileOption,
+    all: Flag.boolean("all").pipe(
+      Flag.withDescription("Show all alerts including normal state"),
+      Flag.withDefault(false),
+    ),
+  },
+  ({ format, env, profile, all }) => {
+    const start = Date.now();
+
+    return Effect.gen(function* () {
+      const config = yield* resolveConfig(env, profile);
+      const alerts = yield* grafanaFetch<AlertInstance[]>(
+        config,
+        "/api/alertmanager/grafana/api/v2/alerts",
+      );
+
+      const filtered = all
+        ? alerts
+        : alerts.filter((alert) => alert.state === "firing" || alert.state === "pending");
+      const firingCount = filtered.filter((alert) => alert.state === "firing").length;
+      const pendingCount = filtered.filter((alert) => alert.state === "pending").length;
+
+      const result = {
+        success: true,
+        message:
+          firingCount === 0 && pendingCount === 0
+            ? "No active alerts"
+            : `${firingCount} firing, ${pendingCount} pending alert(s)`,
+        data: {
+          alerts: filtered.map((alert) => ({
+            state: alert.state,
+            labels: alert.labels,
+            annotations: alert.annotations,
+            activeAt: alert.activeAt,
+            value: alert.value,
+          })),
+          firingCount,
+          pendingCount,
+          totalCount: filtered.length,
+        },
+        executionTimeMs: Date.now() - start,
+      };
+
+      yield* Console.log(formatOutput(result, format));
+    }).pipe(
+      Effect.catch((error) =>
+        Effect.gen(function* () {
+          const result = {
+            success: false,
+            message: "Failed to get alert status",
+            error: formatGrafanaError(error),
+            hint: "Check Grafana is running and accessible",
+            executionTimeMs: Date.now() - start,
+          };
+
+          yield* Console.log(formatOutput(result, format));
+        }),
+      ),
+    );
+  },
+).pipe(Command.withDescription("Show firing and pending alerts"));
+
+export const alertsCommand = Command.make("alerts", {}).pipe(
+  Command.withDescription("Alert operations"),
+  Command.withSubcommands([listCommand, statusCommand]),
+);