kubeagent 0.1.43 → 0.1.44

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 {};

package/dist/version-check.test.js

@@ -1,179 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, rmSync, writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-// Mock chalk to return plain strings
-vi.mock("chalk", () => {
-    const identity = (s) => s;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = {
-        get: () => new Proxy(identity, handler),
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        apply: (_t, _this, args) => args[0],
-    };
-    return { default: new Proxy(identity, handler) };
-});
-let tmpHome;
-let originalHome;
-beforeEach(() => {
-    tmpHome = mkdtempSync(join(tmpdir(), "kubeagent-version-test-"));
-    originalHome = process.env.HOME;
-    process.env.HOME = tmpHome;
-});
-afterEach(() => {
-    if (originalHome !== undefined)
-        process.env.HOME = originalHome;
-    else
-        delete process.env.HOME;
-    rmSync(tmpHome, { recursive: true, force: true });
-    vi.restoreAllMocks();
-});
-describe("isBelow", () => {
-    it("returns true when current is older", async () => {
-        const { isBelow } = await import("./version-check.js");
-        expect(isBelow("0.1.5", "0.2.0")).toBe(true);
-        expect(isBelow("0.1.5", "0.1.6")).toBe(true);
-        expect(isBelow("0.0.9", "1.0.0")).toBe(true);
-    });
-    it("returns false when current is equal or newer", async () => {
-        const { isBelow } = await import("./version-check.js");
-        expect(isBelow("0.2.0", "0.2.0")).toBe(false);
-        expect(isBelow("0.2.1", "0.2.0")).toBe(false);
-        expect(isBelow("1.0.0", "0.9.99")).toBe(false);
-    });
-    it("strips a leading v", async () => {
-        const { isBelow } = await import("./version-check.js");
-        expect(isBelow("v0.1.0", "0.2.0")).toBe(true);
-        expect(isBelow("0.1.0", "v0.2.0")).toBe(true);
-    });
-});
-describe("enforceMinVersion", () => {
-    it("exits with code 1 when current version is below min", async () => {
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ minSupported: "0.5.0" }),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        });
-        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation(((_code) => {
-            throw new Error("__exit__");
-        }));
-        const { enforceMinVersion } = await import("./version-check.js");
-        await expect(enforceMinVersion("0.1.0", "https://api.example.com")).rejects.toThrow("__exit__");
-        expect(exitSpy).toHaveBeenCalledWith(1);
-        const output = errSpy.mock.calls.map((c) => c.join(" ")).join("\n");
-        expect(output).toContain("no longer supported");
-        expect(output).toContain("0.5.0");
-    });
-    it("does nothing when current version meets the floor", async () => {
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ minSupported: "0.1.0" }),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        });
-        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => { }));
-        const { enforceMinVersion } = await import("./version-check.js");
-        await enforceMinVersion("0.1.0", "https://api.example.com");
-        expect(exitSpy).not.toHaveBeenCalled();
-        expect(errSpy).not.toHaveBeenCalled();
-    });
-    it("falls back to stale cache on network error", async () => {
-        // Seed an older cached floor for THIS server URL that already proved
-        // this version stale.
-        const url = "https://api.example.com";
-        mkdirSync(join(tmpHome, ".kubeagent"), { recursive: true });
-        writeFileSync(join(tmpHome, ".kubeagent", "version-check.json"), JSON.stringify({
-            [url]: {
-                // checkedAt > 24h ago so we attempt a refetch
-                checkedAt: Date.now() - 48 * 60 * 60 * 1000,
-                minSupported: "0.5.0",
-            },
-        }), "utf-8");
-        globalThis.fetch = vi.fn().mockRejectedValue(new Error("offline"));
-        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation(((_code) => {
-            throw new Error("__exit__");
-        }));
-        const { enforceMinVersion } = await import("./version-check.js");
-        await expect(enforceMinVersion("0.1.0", url)).rejects.toThrow("__exit__");
-        expect(exitSpy).toHaveBeenCalledWith(1);
-        expect(errSpy).toHaveBeenCalled();
-    });
-    it("returns silently with no cache and a network error", async () => {
-        globalThis.fetch = vi.fn().mockRejectedValue(new Error("offline"));
-        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => { }));
-        const { enforceMinVersion } = await import("./version-check.js");
-        await enforceMinVersion("0.1.0", "https://api.example.com");
-        expect(exitSpy).not.toHaveBeenCalled();
-        expect(errSpy).not.toHaveBeenCalled();
-    });
-    it("uses cached value within 24h without refetching", async () => {
-        const url = "https://api.example.com";
-        mkdirSync(join(tmpHome, ".kubeagent"), { recursive: true });
-        writeFileSync(join(tmpHome, ".kubeagent", "version-check.json"), JSON.stringify({ [url]: { checkedAt: Date.now(), minSupported: "0.2.0" } }), "utf-8");
-        const fetchSpy = vi.fn();
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        globalThis.fetch = fetchSpy;
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation(((_code) => {
-            throw new Error("__exit__");
-        }));
-        vi.spyOn(console, "error").mockImplementation(() => { });
-        const { enforceMinVersion } = await import("./version-check.js");
-        await expect(enforceMinVersion("0.1.0", url)).rejects.toThrow("__exit__");
-        expect(fetchSpy).not.toHaveBeenCalled();
-        expect(exitSpy).toHaveBeenCalledWith(1);
-    });
-    it("writes cache after a successful fetch", async () => {
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ minSupported: "0.1.0" }),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        });
-        vi.spyOn(process, "exit").mockImplementation((() => { }));
-        vi.spyOn(console, "error").mockImplementation(() => { });
-        const { enforceMinVersion } = await import("./version-check.js");
-        await enforceMinVersion("0.1.5", "https://api.example.com");
-        const cachePath = join(tmpHome, ".kubeagent", "version-check.json");
-        expect(existsSync(cachePath)).toBe(true);
-        const cache = JSON.parse(readFileSync(cachePath, "utf-8"));
-        expect(cache["https://api.example.com"].minSupported).toBe("0.1.0");
-    });
-    it("does not apply a floor cached for a different server URL", async () => {
-        const otherUrl = "https://other-server.example.com";
-        mkdirSync(join(tmpHome, ".kubeagent"), { recursive: true });
-        writeFileSync(join(tmpHome, ".kubeagent", "version-check.json"), JSON.stringify({
-            [otherUrl]: { checkedAt: Date.now(), minSupported: "99.0.0" },
-        }), "utf-8");
-        // Target server returns a permissive floor; other-server's strict floor
-        // must NOT be applied here.
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ minSupported: "0.1.0" }),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        });
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => { }));
-        vi.spyOn(console, "error").mockImplementation(() => { });
-        const { enforceMinVersion } = await import("./version-check.js");
-        await enforceMinVersion("0.1.0", "https://api.example.com");
-        expect(exitSpy).not.toHaveBeenCalled();
-    });
-    it("ignores the legacy single-entry cache shape", async () => {
-        // Old format: {checkedAt, minSupported} at the root. Should be discarded
-        // since we don't know which server it came from.
-        mkdirSync(join(tmpHome, ".kubeagent"), { recursive: true });
-        writeFileSync(join(tmpHome, ".kubeagent", "version-check.json"), JSON.stringify({ checkedAt: Date.now(), minSupported: "99.0.0" }), "utf-8");
-        globalThis.fetch = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ minSupported: "0.1.0" }),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        });
-        const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => { }));
-        vi.spyOn(console, "error").mockImplementation(() => { });
-        const { enforceMinVersion } = await import("./version-check.js");
-        await enforceMinVersion("0.1.0", "https://api.example.com");
-        // Legacy floor (99.0.0) ignored, fresh fetch (0.1.0) applied — no exit.
-        expect(exitSpy).not.toHaveBeenCalled();
-    });
-});