kubeagent 0.1.36 → 0.1.44

package/dist/notify/discord.d.ts

@@ -1,4 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { DiscordChannel } from "../config.js";
-export declare function sendDiscordQuestion(channel: DiscordChannel, question: string, choices: string[] | undefined, clusterContext?: string): Promise<void>;
-export declare function sendDiscord(issues: Issue[], channel: DiscordChannel, clusterContext?: string): Promise<void>;

package/dist/notify/index.d.ts

@@ -1,6 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { KubeAgentConfig, NotificationChannel } from "../config.js";
-export declare function sendNotification(issues: Issue[], config: KubeAgentConfig, clusterContext?: string): Promise<void>;
-export declare function broadcastQuestion(question: string, choices: string[] | undefined, config: KubeAgentConfig, clusterContext?: string): Promise<void>;
-export declare function sendResolve(resolvedKeys: string[], config: KubeAgentConfig, clusterContext?: string): Promise<void>;
-export declare function describeChannel(channel: NotificationChannel): string;

package/dist/notify/pagerduty.d.ts

@@ -1,9 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { PagerDutyChannel } from "../config.js";
-export declare function dedupKey(issue: Issue): string;
-export declare function sendPagerDuty(issues: Issue[], channel: PagerDutyChannel, clusterContext?: string): Promise<void>;
-export declare function resolvePagerDuty(dedupKeys: string[], channel: PagerDutyChannel): Promise<void>;
-export declare function testPagerDutyCredentials(routingKey: string): Promise<{
-    ok: boolean;
-    error?: string;
-}>;

package/dist/notify/pagerduty.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/notify/pagerduty.test.js

@@ -1,97 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-const mockFetch = vi.fn();
-vi.stubGlobal("fetch", mockFetch);
-const channel = { type: "pagerduty", routing_key: "R0123456789abcdef", severity: "warning" };
-const issue = { kind: "pod_crashloop", severity: "critical", namespace: "prod", resource: "api-web", message: "Pod crash-looping (3 times)", details: {}, timestamp: new Date("2026-01-01T00:00:00Z") };
-describe("sendPagerDuty", () => {
-    beforeEach(() => {
-        mockFetch.mockReset();
-        mockFetch.mockResolvedValue({ ok: true, status: 202, json: async () => ({ status: "success" }) });
-    });
-    it("POSTs to PagerDuty Events API v2", async () => {
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await sendPagerDuty([issue], channel, "hetzner-prod");
-        expect(mockFetch.mock.calls[0][0]).toBe("https://events.pagerduty.com/v2/enqueue");
-    });
-    it("sends trigger with correct dedup_key", async () => {
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await sendPagerDuty([issue], channel);
-        const body = JSON.parse(mockFetch.mock.calls[0][1].body);
-        expect(body.event_action).toBe("trigger");
-        expect(body.dedup_key).toBe("kubeagent:pod_crashloop:prod:api-web");
-        expect(body.routing_key).toBe("R0123456789abcdef");
-    });
-    it("maps critical severity correctly", async () => {
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await sendPagerDuty([{ ...issue, severity: "critical" }], channel);
-        const body = JSON.parse(mockFetch.mock.calls[0][1].body);
-        expect(body.payload.severity).toBe("critical");
-    });
-    it("maps warning severity correctly", async () => {
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await sendPagerDuty([{ ...issue, severity: "warning" }], channel);
-        const body = JSON.parse(mockFetch.mock.calls[0][1].body);
-        expect(body.payload.severity).toBe("warning");
-    });
-    it("maps info severity correctly", async () => {
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await sendPagerDuty([{ ...issue, severity: "info" }], channel);
-        const body = JSON.parse(mockFetch.mock.calls[0][1].body);
-        expect(body.payload.severity).toBe("info");
-    });
-    it("fires one request per issue", async () => {
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await sendPagerDuty([issue, { ...issue, kind: "pod_oom", resource: "worker" }], channel);
-        expect(mockFetch).toHaveBeenCalledTimes(2);
-    });
-    it("does not throw on non-2xx", async () => {
-        mockFetch.mockResolvedValue({ ok: false, status: 400, statusText: "Bad Request", json: async () => ({}) });
-        const { sendPagerDuty } = await import("./pagerduty.js");
-        await expect(sendPagerDuty([issue], channel)).resolves.not.toThrow();
-    });
-});
-describe("resolvePagerDuty", () => {
-    beforeEach(() => {
-        mockFetch.mockReset();
-        mockFetch.mockResolvedValue({ ok: true, status: 202, json: async () => ({}) });
-    });
-    it("sends resolve events for each dedup key", async () => {
-        const { resolvePagerDuty } = await import("./pagerduty.js");
-        await resolvePagerDuty(["kubeagent:pod_crashloop:prod:api-web", "kubeagent:pod_oom:prod:worker"], channel);
-        expect(mockFetch).toHaveBeenCalledTimes(2);
-        const body0 = JSON.parse(mockFetch.mock.calls[0][1].body);
-        expect(body0.event_action).toBe("resolve");
-        expect(body0.dedup_key).toBe("kubeagent:pod_crashloop:prod:api-web");
-    });
-    it("does not throw on error", async () => {
-        mockFetch.mockRejectedValue(new Error("network failure"));
-        const { resolvePagerDuty } = await import("./pagerduty.js");
-        await expect(resolvePagerDuty(["kubeagent:pod_crashloop:prod:api-web"], channel)).resolves.not.toThrow();
-    });
-});
-describe("testPagerDutyCredentials", () => {
-    beforeEach(() => {
-        mockFetch.mockReset();
-        mockFetch.mockResolvedValue({ ok: true, status: 202, json: async () => ({}) });
-    });
-    it("returns ok:true when trigger succeeds", async () => {
-        const { testPagerDutyCredentials } = await import("./pagerduty.js");
-        const result = await testPagerDutyCredentials("R0123456789abcdef");
-        expect(result.ok).toBe(true);
-        expect(result.error).toBeUndefined();
-    });
-    it("returns ok:false with error when trigger fails", async () => {
-        mockFetch.mockResolvedValue({ ok: false, status: 400, statusText: "Bad Request", json: async () => ({ message: "Invalid routing key" }) });
-        const { testPagerDutyCredentials } = await import("./pagerduty.js");
-        const result = await testPagerDutyCredentials("bad-key");
-        expect(result.ok).toBe(false);
-        expect(result.error).toBe("Invalid routing key");
-    });
-    it("returns ok:false on network error", async () => {
-        mockFetch.mockRejectedValue(new Error("ECONNREFUSED"));
-        const { testPagerDutyCredentials } = await import("./pagerduty.js");
-        const result = await testPagerDutyCredentials("R0123456789abcdef");
-        expect(result.ok).toBe(false);
-        expect(result.error).toBe("ECONNREFUSED");
-    });
-});

package/dist/notify/setup.d.ts

@@ -1,9 +0,0 @@
-import type { NotificationChannel, SlackChannel, TelegramChannel } from "../config.js";
-import type { WebhookChannel, PagerDutyChannel, DiscordChannel, TeamsChannel } from "../config.js";
-export declare function setupSlack(): Promise<SlackChannel | null>;
-export declare function setupTelegram(): Promise<TelegramChannel | null>;
-export declare function setupWebhook(): Promise<WebhookChannel | null>;
-export declare function setupPagerDuty(): Promise<PagerDutyChannel | null>;
-export declare function setupDiscord(): Promise<DiscordChannel | null>;
-export declare function setupTeams(): Promise<TeamsChannel | null>;
-export declare function interactiveAddChannel(): Promise<NotificationChannel | null>;

package/dist/notify/slack.d.ts

@@ -1,4 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { SlackChannel } from "../config.js";
-export declare function sendSlackQuestion(channel: SlackChannel, question: string, choices: string[] | undefined, clusterContext?: string): Promise<void>;
-export declare function sendSlack(issues: Issue[], channel: SlackChannel, clusterContext?: string): Promise<void>;

package/dist/notify/teams.d.ts

@@ -1,3 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { TeamsChannel } from "../config.js";
-export declare function sendTeams(issues: Issue[], channel: TeamsChannel, clusterContext?: string): Promise<void>;

package/dist/notify/telegram.d.ts

@@ -1,9 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { TelegramChannel } from "../config.js";
-export declare function sendTelegramQuestion(channel: TelegramChannel, question: string, choices: string[] | undefined, clusterContext?: string): Promise<void>;
-export declare function sendTelegram(issues: Issue[], channel: TelegramChannel, clusterContext?: string): Promise<void>;
-export declare function autoDetectTelegramChatId(botToken: string): Promise<string | null>;
-export declare function testTelegramCredentials(botToken: string, chatId: string): Promise<{
-    ok: boolean;
-    error?: string;
-}>;

package/dist/notify/webhook.d.ts

@@ -1,3 +0,0 @@
-import type { Issue } from "../monitor/types.js";
-import type { WebhookChannel } from "../config.js";
-export declare function sendWebhook(issues: Issue[], channel: WebhookChannel, clusterContext?: string): Promise<void>;

package/dist/notify/webhook.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/notify/webhook.test.js

@@ -1,53 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-const mockFetch = vi.fn();
-vi.stubGlobal("fetch", mockFetch);
-const channel = { type: "webhook", url: "https://example.com/hook", secret: "testsecret", severity: "warning" };
-const issue = { kind: "pod_crashloop", severity: "critical", namespace: "prod", resource: "api-web", message: "Pod crash-looping", details: { restartCount: 3 }, timestamp: new Date("2026-01-01T00:00:00Z") };
-describe("sendWebhook", () => {
-    beforeEach(() => {
-        mockFetch.mockReset();
-        mockFetch.mockResolvedValue({ ok: true, status: 200, statusText: "OK" });
-    });
-    it("POSTs to the configured URL", async () => {
-        const { sendWebhook } = await import("./webhook.js");
-        await sendWebhook([issue], channel, "hetzner-prod");
-        expect(mockFetch).toHaveBeenCalledOnce();
-        expect(mockFetch.mock.calls[0][0]).toBe("https://example.com/hook");
-        expect(mockFetch.mock.calls[0][1].method).toBe("POST");
-    });
-    it("sends Authorization: Bearer header when secret is set", async () => {
-        const { sendWebhook } = await import("./webhook.js");
-        await sendWebhook([issue], channel, "hetzner-prod");
-        expect(mockFetch.mock.calls[0][1].headers["Authorization"]).toBe("Bearer testsecret");
-    });
-    it("omits Authorization header when no secret", async () => {
-        const noSecretChannel = { ...channel, secret: undefined };
-        const { sendWebhook } = await import("./webhook.js");
-        await sendWebhook([issue], noSecretChannel);
-        expect(mockFetch.mock.calls[0][1].headers["Authorization"]).toBeUndefined();
-    });
-    it("includes cluster, timestamp, and issues in payload", async () => {
-        const { sendWebhook } = await import("./webhook.js");
-        await sendWebhook([issue], channel, "hetzner-prod");
-        const body = JSON.parse(mockFetch.mock.calls[0][1].body);
-        expect(body.cluster).toBe("hetzner-prod");
-        expect(body.issues).toHaveLength(1);
-        expect(body.issues[0].kind).toBe("pod_crashloop");
-    });
-    it("does not throw on non-2xx response", async () => {
-        mockFetch.mockResolvedValue({ ok: false, status: 500, statusText: "Error" });
-        const { sendWebhook } = await import("./webhook.js");
-        await expect(sendWebhook([issue], channel)).resolves.not.toThrow();
-    });
-    it("does not throw on network error", async () => {
-        mockFetch.mockRejectedValue(new Error("network failure"));
-        const { sendWebhook } = await import("./webhook.js");
-        await expect(sendWebhook([issue], channel)).resolves.not.toThrow();
-    });
-    it("rejects invalid URL without throwing", async () => {
-        const badChannel = { ...channel, url: "not-a-url" };
-        const { sendWebhook } = await import("./webhook.js");
-        await expect(sendWebhook([issue], badChannel)).resolves.not.toThrow();
-        expect(mockFetch).not.toHaveBeenCalled();
-    });
-});

package/dist/onboard/cluster-scan.d.ts

@@ -1,42 +0,0 @@
-import { type KubectlOptions } from "../kubectl.js";
-export interface NodeInfo {
-    name: string;
-    roles: string[];
-    version: string;
-    os: string;
-}
-export interface DeploymentInfo {
-    name: string;
-    namespace: string;
-    replicas: number;
-    image: string;
-}
-export interface StatefulSetInfo {
-    name: string;
-    namespace: string;
-    replicas: number;
-    image: string;
-}
-export interface ServiceInfo {
-    name: string;
-    namespace: string;
-    type: string;
-    ports: string;
-}
-export interface IngressInfo {
-    name: string;
-    namespace: string;
-    hosts: string[];
-    tls: boolean;
-}
-export interface ClusterInfo {
-    context: string;
-    nodes: NodeInfo[];
-    namespaces: string[];
-    deployments: DeploymentInfo[];
-    statefulsets: StatefulSetInfo[];
-    services: ServiceInfo[];
-    ingresses: IngressInfo[];
-}
-export declare function scanCluster(options: KubectlOptions, onProgress?: (step: string) => void): Promise<ClusterInfo>;
-export declare function formatClusterMarkdown(info: ClusterInfo): string;

package/dist/onboard/code-scan.d.ts

@@ -1,9 +0,0 @@
-export interface TechStack {
-    language: string;
-    framework: string;
-    runtimeVersion: string;
-    dependencies: string[];
-    buildTool: string;
-}
-export declare function detectTechStack(codePath: string): TechStack;
-export declare function formatProjectMarkdown(projectName: string, codePath: string, stack: TechStack, extraNotes?: string): string;

package/dist/onboard/index.d.ts

@@ -1,3 +0,0 @@
-export declare function onboard(opts?: {
-    timeout?: number;
-}): Promise<void>;

package/dist/onboard/interview.d.ts

@@ -1,12 +0,0 @@
-import type { ClusterInfo } from "./cluster-scan.js";
-import type { TechStack } from "./code-scan.js";
-interface InterviewContext {
-    cluster: ClusterInfo;
-    projects: Array<{
-        name: string;
-        path: string;
-        stack: TechStack;
-    }>;
-}
-export declare function runInterview(context: InterviewContext): Promise<Map<string, string>>;
-export {};

package/dist/onboard/project-matcher.d.ts

@@ -1,25 +0,0 @@
-import { type TechStack } from "./code-scan.js";
-import type { DeploymentInfo, StatefulSetInfo } from "./cluster-scan.js";
-export interface ProjectCandidate {
-    dir: string;
-    name: string;
-    stack: TechStack;
-    packageName?: string;
-}
-export interface WorkloadRef {
-    name: string;
-    namespace: string;
-    image: string;
-    kind: "Deployment" | "StatefulSet";
-}
-export interface MatchSuggestion {
-    project: ProjectCandidate;
-    workload: WorkloadRef;
-    score: number;
-    reasons: string[];
-}
-/** Scan a parent directory and return all subdirectories that look like code projects. */
-export declare function scanProjectDirectory(parentDir: string): ProjectCandidate[];
-export declare function matchProjectsToWorkloads(projects: ProjectCandidate[], deployments: DeploymentInfo[], statefulsets: StatefulSetInfo[]): MatchSuggestion[];
-/** For each project, return only its best-matching workload (if score ≥ threshold). */
-export declare function bestMatches(suggestions: MatchSuggestion[], threshold?: number): MatchSuggestion[];

package/dist/orchestrator.d.ts

@@ -1,3 +0,0 @@
-import type { Issue } from "./monitor/types.js";
-import type { KubeAgentConfig } from "./config.js";
-export declare function handleIssues(issues: Issue[], config: KubeAgentConfig, clusterContext?: string, noInteractive?: boolean): Promise<void>;

package/dist/proxy-client.d.ts

@@ -1,27 +0,0 @@
-import type { AuthState } from "./auth.js";
-import type { V1MessagesRequest, V1MessagesResponse } from "@kubeagent/shared/v1-messages.js";
-export declare function proxyRequest(auth: AuthState, body: V1MessagesRequest): Promise<V1MessagesResponse>;
-export declare function fetchSlackWebhook(auth: AuthState): Promise<{
-    connected: boolean;
-    webhookUrl?: string;
-    channelName?: string;
-    teamName?: string;
-}>;
-export declare function reportIncident(auth: AuthState, incident: {
-    clusterContext: string;
-    issues: string;
-    analysis: string;
-    actionTaken?: string;
-    verified?: boolean;
-}): Promise<void>;
-export declare function registerWebhook(auth: AuthState, url: string, label: string | undefined, severity: string): Promise<{
-    secret?: string;
-}>;
-export declare function notifyViaServer(auth: AuthState, issues: Array<{
-    kind: string;
-    severity: string;
-    message: string;
-    namespace?: string;
-    resource?: string;
-}>, clusterContext?: string): Promise<void>;
-export declare function pingWatchCycle(auth: AuthState): Promise<void>;

package/dist/render.d.ts

@@ -1,5 +0,0 @@
-export declare function renderMarkdown(text: string): string;
-/** Print a labelled section divider: ── Label ──────────── */
-export declare function sectionHeader(label: string, color?: import("chalk").ChalkInstance): void;
-/** Print a two-line command approval box. */
-export declare function commandBox(cmd: string): void;

package/dist/telemetry.d.ts

@@ -1 +0,0 @@
-export declare function sendTelemetry(cliVersion: string): void;

package/dist/telemetry.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/telemetry.test.js

@@ -1,18 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { join } from "node:path";
-import { homedir } from "node:os";
-const TELEMETRY_DIR = join(homedir(), ".kubeagent");
-const SENT_FILE = join(TELEMETRY_DIR, ".telemetry-sent");
-describe("sendTelemetry", () => {
-    it("module exports sendTelemetry function", async () => {
-        const mod = await import("./telemetry.js");
-        expect(typeof mod.sendTelemetry).toBe("function");
-    });
-    it("does not throw when called", async () => {
-        // If marker file already exists from a real run, this just returns early.
-        // If not, it fires a fetch that will fail silently (no server).
-        // Either way it should not throw.
-        const { sendTelemetry } = await import("./telemetry.js");
-        expect(() => sendTelemetry("0.0.0-test")).not.toThrow();
-    });
-});

package/dist/update-notifier.d.ts

@@ -1 +0,0 @@
-export declare function checkForUpdate(): Promise<void>;

package/dist/update-notifier.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/update-notifier.test.js

@@ -1,50 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-// Mock chalk to return plain strings
-vi.mock("chalk", () => {
-    const identity = (s) => s;
-    const handler = {
-        get: () => new Proxy(identity, handler),
-        apply: (_t, _this, args) => args[0],
-    };
-    return { default: new Proxy(identity, handler) };
-});
-describe("update-notifier", () => {
-    let originalFetch;
-    beforeEach(() => {
-        originalFetch = globalThis.fetch;
-    });
-    afterEach(() => {
-        globalThis.fetch = originalFetch;
-        vi.restoreAllMocks();
-    });
-    it("prints update message when newer version exists", async () => {
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ version: "99.0.0" }),
-        });
-        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
-        const { checkForUpdate } = await import("./update-notifier.js");
-        await checkForUpdate();
-        expect(spy).toHaveBeenCalled();
-        const output = spy.mock.calls.map((c) => c.join(" ")).join("\n");
-        expect(output).toContain("Update available");
-        expect(output).toContain("99.0.0");
-    });
-    it("prints nothing when already up to date", async () => {
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ version: "0.0.1" }),
-        });
-        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
-        const { checkForUpdate } = await import("./update-notifier.js");
-        await checkForUpdate();
-        expect(spy).not.toHaveBeenCalled();
-    });
-    it("prints nothing on network error", async () => {
-        globalThis.fetch = vi.fn().mockRejectedValue(new Error("offline"));
-        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
-        const { checkForUpdate } = await import("./update-notifier.js");
-        await checkForUpdate();
-        expect(spy).not.toHaveBeenCalled();
-    });
-});

package/dist/verifier.d.ts

@@ -1,9 +0,0 @@
-import type { Issue, IssueKind } from "./monitor/types.js";
-import type { KubectlOptions } from "./kubectl.js";
-export interface VerificationResult {
-    passed: boolean;
-    remainingIssues: Issue[];
-    message: string;
-}
-export declare function evaluateResult(currentIssues: Issue[], originalIssueKinds: IssueKind[]): VerificationResult;
-export declare function verify(originalIssueKinds: IssueKind[], kubectlOptions: KubectlOptions, cooldownMs?: number): Promise<VerificationResult>;

package/dist/version-check.d.ts

@@ -1,14 +0,0 @@
-export declare function isBelow(version: string, floor: string): boolean;
-/**
- * Verifies that the running CLI is still supported by the server at
- * `serverUrl`.
- *
- * Behaviour:
- *   - Fetches the server's `minSupported` version (cached per-server for 24h).
- *   - If the running version is strictly below the floor, prints a mandatory-
- *     update message and exits the process with code 1.
- *   - On network failure with no cached value, returns silently — we don't
- *     want to lock users out when the server is unreachable for transient
- *     reasons. A stale cache is preferred over no cache when offline.
- */
-export declare function enforceMinVersion(currentVersion: string, serverUrl: string): Promise<void>;

package/dist/version-check.test.d.ts

@@ -1 +0,0 @@
-export {};