kubeagent 0.1.33 → 0.1.35

package/README.md

@@ -89,6 +89,15 @@ Supported channels:
 | **Microsoft Teams** | Paste a Teams incoming webhook URL |
 | **Custom Webhook** | Any HTTP endpoint that accepts JSON payloads |
 
+## Observability
+
+The SaaS server exposes:
+
+- `GET /health` for Kubernetes readiness/liveness probes
+- `GET /metrics` for Prometheus scraping
+
+Kubernetes monitoring manifests live in [`k8s/servicemonitor.yaml`](k8s/servicemonitor.yaml) and [`k8s/prometheusrule.yaml`](k8s/prometheusrule.yaml). Internal rollout notes are in [`docs/MONITORING.md`](docs/MONITORING.md).
+
 ## Requirements
 
 - Node.js >= 22

package/dist/cli.js

@@ -18,7 +18,7 @@ import { sendResolve } from "./notify/index.js";
 import { diagnose } from "./diagnoser/index.js";
 import { join } from "node:path";
 import { loadAuth, loginBrowser, loginDevice, createApiKey, showAccount, clearAuth } from "./auth.js";
-import { fetchSlackWebhook } from "./proxy-client.js";
+import { fetchSlackWebhook, pingWatchCycle } from "./proxy-client.js";
 import { createInterface } from "node:readline";
 import { scanProjectDirectory, matchProjectsToWorkloads, bestMatches } from "./onboard/project-matcher.js";
 import { scanCluster } from "./onboard/cluster-scan.js";
@@ -156,6 +156,10 @@ program
         await handleIssues(issues, config, context, noInteractive);
     }, async (resolvedKeys) => {
         await sendResolve(resolvedKeys, config, context);
+    }, () => {
+        if (auth?.apiKey) {
+            void pingWatchCycle(auth);
+        }
     });
     // Handle graceful shutdown
     process.on("SIGINT", () => {
@@ -458,9 +462,11 @@ program
             console.log(`  Extra credits:     ${balance.extraRemaining.toLocaleString()}`);
         }
         console.log(`  Total remaining:   ${balance.totalRemaining.toLocaleString()}`);
+        const isTrial = balance.plan === "trial";
         if (balance.resetsAt) {
             const resetDate = new Date(balance.resetsAt).toLocaleDateString(undefined, { month: "short", day: "numeric", year: "numeric" });
-            console.log(`  Resets:            ${resetDate}`);
+            const label = isTrial ? "Trial ends:       " : "Resets:           ";
+            console.log(`  ${label} ${resetDate}`);
         }
         // Exhausted balance warning
         if (balance.totalRemaining === 0) {
@@ -469,7 +475,8 @@ program
         }
         else if (balance.monthlyTotal > 0 && balance.monthlyRemaining < balance.monthlyTotal * 0.2) {
             const pct = Math.round((balance.monthlyRemaining / balance.monthlyTotal) * 100);
-            console.log("\n" + chalk.yellow(`  ⚠ Low balance: ${pct}% of monthly tokens remaining.`));
+            const noun = isTrial ? "trial tokens" : "monthly tokens";
+            console.log("\n" + chalk.yellow(`  ⚠ Low balance: ${pct}% of ${noun} remaining.`));
             console.log(chalk.dim(`  Upgrade or buy extra credits: `) + chalk.cyan(upgradeUrl));
         }
         console.log();

package/dist/monitor/index.d.ts

@@ -12,6 +12,6 @@ export declare function runChecks(options: KubectlOptions): Promise<Issue[]>;
 export declare function runChecks(options: KubectlOptions, withSummary: true): Promise<CheckSummary>;
 export declare function computeResolvedKeys(activeKeys: Set<string>, currentKeys: Set<string>): string[];
 export declare function updateActiveKeys(activeKeys: Set<string>, resolvedKeys: string[], currentKeys: Set<string>): void;
-export declare function startMonitor(options: KubectlOptions, intervalMs: number, onIssues: IssueCallback, onResolved?: ResolveCallback): {
+export declare function startMonitor(options: KubectlOptions, intervalMs: number, onIssues: IssueCallback, onResolved?: ResolveCallback, onFirstCycle?: () => void): {
     stop: () => void;
 };

package/dist/monitor/index.js

@@ -68,13 +68,15 @@ export function updateActiveKeys(activeKeys, resolvedKeys, currentKeys) {
     for (const k of currentKeys)
         activeKeys.add(k);
 }
-export function startMonitor(options, intervalMs, onIssues, onResolved) {
+export function startMonitor(options, intervalMs, onIssues, onResolved, onFirstCycle) {
     let running = true;
     let inFlight = false;
+    let firstCycleFired = false;
     // Tracks when each pending pod was first seen: "namespace/name" -> Date
     const pendingSince = new Map();
     const activeIssueKeys = new Set();
     let pendingRecheckTimer = null;
+    // fallow-ignore-next-line complexity
     const tick = async () => {
         if (!running || inFlight)
             return;
@@ -126,6 +128,10 @@ export function startMonitor(options, intervalMs, onIssues, onResolved) {
                     console.error("Resolve callback failed:", err.message);
                 }
             }
+            if (!firstCycleFired) {
+                firstCycleFired = true;
+                onFirstCycle?.();
+            }
             if (reportableIssues.length > 0 && running) {
                 process.stdout.write("\r\x1b[K");
                 await onIssues(reportableIssues);

package/dist/proxy-client.d.ts

@@ -24,3 +24,4 @@ export declare function notifyViaServer(auth: AuthState, issues: Array<{
     namespace?: string;
     resource?: string;
 }>, clusterContext?: string): Promise<void>;
+export declare function pingWatchCycle(auth: AuthState): Promise<void>;

package/dist/proxy-client.js

@@ -126,3 +126,16 @@ export async function notifyViaServer(auth, issues, clusterContext) {
         // Silent — don't break the watch loop if server is unreachable
     }
 }
+export async function pingWatchCycle(auth) {
+    const apiKey = auth.apiKey ?? auth.token;
+    try {
+        await fetch(`${auth.serverUrl}/watch-cycle`, {
+            method: "POST",
+            headers: { Authorization: `ApiKey ${apiKey}` },
+            signal: AbortSignal.timeout(5_000),
+        });
+    }
+    catch {
+        // Silent — non-blocking telemetry
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kubeagent",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "AI-powered Kubernetes management CLI",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",