kubeagent 0.1.24 → 0.1.26

package/dist/cli.js

@@ -56,8 +56,9 @@ program
 program
     .command("onboard")
     .description("Scan cluster + codebases, interview user, generate knowledge base")
-    .action(async () => {
-    await onboard();
+    .option("-t, --timeout <seconds>", "Max seconds to wait for cluster scan (default: 120)", "120")
+    .action(async (opts) => {
+    await onboard({ timeout: parseInt(opts.timeout, 10) });
 });
 program
     .command("watch")
@@ -457,8 +458,12 @@ program
             const resetDate = new Date(balance.resetsAt).toLocaleDateString(undefined, { month: "short", day: "numeric", year: "numeric" });
             console.log(`  Resets:            ${resetDate}`);
         }
-        // Low-balance warning: < 20% of monthly allocation remaining
-        if (balance.monthlyTotal > 0 && balance.monthlyRemaining < balance.monthlyTotal * 0.2) {
+        // Exhausted balance warning
+        if (balance.totalRemaining === 0) {
+            console.log("\n" + chalk.red("  Balance exhausted.") + " Upgrade or buy credits at " + chalk.cyan(upgradeUrl));
+            // Low-balance warning: < 20% of monthly allocation remaining
+        }
+        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.`));
             console.log(chalk.dim(`  Upgrade or buy extra credits: `) + chalk.cyan(upgradeUrl));

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

@@ -38,5 +38,5 @@ export interface ClusterInfo {
     services: ServiceInfo[];
     ingresses: IngressInfo[];
 }
-export declare function scanCluster(options: KubectlOptions): Promise<ClusterInfo>;
+export declare function scanCluster(options: KubectlOptions, onProgress?: (step: string) => void): Promise<ClusterInfo>;
 export declare function formatClusterMarkdown(info: ClusterInfo): string;

package/dist/onboard/cluster-scan.js

@@ -1,7 +1,8 @@
 import { kubectlJson } from "../kubectl.js";
-export async function scanCluster(options) {
+export async function scanCluster(options, onProgress) {
     const context = options.context ?? "default";
     // Nodes
+    onProgress?.("nodes");
     const nodesRaw = (await kubectlJson(["get", "nodes"], options));
     const nodes = nodesRaw.items.map((n) => ({
         name: n.metadata.name,
@@ -12,9 +13,11 @@ export async function scanCluster(options) {
         os: n.status.nodeInfo.osImage,
     }));
     // Namespaces
+    onProgress?.("namespaces");
     const nsRaw = (await kubectlJson(["get", "namespaces"], options));
     const namespaces = nsRaw.items.map((n) => n.metadata.name);
     // Deployments
+    onProgress?.("deployments");
     const deplRaw = (await kubectlJson(["get", "deployments", "--all-namespaces"], options));
     const deployments = deplRaw.items.map((d) => ({
         name: d.metadata.name,
@@ -23,6 +26,7 @@ export async function scanCluster(options) {
         image: d.spec.template.spec.containers[0]?.image ?? "unknown",
     }));
     // StatefulSets
+    onProgress?.("statefulsets");
     const ssRaw = (await kubectlJson(["get", "statefulsets", "--all-namespaces"], options));
     const statefulsets = ssRaw.items.map((s) => ({
         name: s.metadata.name,
@@ -31,6 +35,7 @@ export async function scanCluster(options) {
         image: s.spec.template.spec.containers[0]?.image ?? "unknown",
     }));
     // Services
+    onProgress?.("services");
     const svcRaw = (await kubectlJson(["get", "services", "--all-namespaces"], options));
     const services = svcRaw.items.map((s) => ({
         name: s.metadata.name,
@@ -39,6 +44,7 @@ export async function scanCluster(options) {
         ports: (s.spec.ports ?? []).map((p) => `${p.port}/${p.protocol}`).join(", "),
     }));
     // Ingresses
+    onProgress?.("ingresses");
     const ingRaw = (await kubectlJson(["get", "ingresses", "--all-namespaces"], options));
     const ingresses = ingRaw.items.map((i) => ({
         name: i.metadata.name,

package/dist/onboard/index.d.ts

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

package/dist/onboard/index.js

@@ -56,8 +56,9 @@ async function configureSafeActions(current) {
     console.log(chalk.dim(`Safe actions set to: ${result.length > 0 ? result.join(", ") : "(none — all require approval)"}`));
     return result;
 }
-export async function onboard() {
+export async function onboard(opts = {}) {
     console.log(chalk.bold("\nKubeAgent Onboarding\n"));
+    const timeoutMs = (opts.timeout ?? 120) * 1000;
     // Step 1: Pick cluster context from list
     const context = await pickContext();
     const kubectlOpts = context ? { context } : {};
@@ -66,8 +67,16 @@ export async function onboard() {
     const spinner = ora("Scanning cluster...").start();
     let clusterInfo;
     try {
-        clusterInfo = await scanCluster(kubectlOpts);
-        spinner.succeed(`Found ${clusterInfo.nodes.length} nodes, ${clusterInfo.deployments.length} deployments, ${clusterInfo.namespaces.length} namespaces`);
+        const scanPromise = scanCluster(kubectlOpts, (step) => {
+            spinner.text = `Scanning cluster — ${step}...`;
+        });
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => reject(new Error(`Cluster scan timed out after ${opts.timeout ?? 120}s`)), timeoutMs);
+        });
+        clusterInfo = await Promise.race([scanPromise, timeoutPromise]);
+        clearTimeout(timeoutId);
+        spinner.succeed(`Found ${clusterInfo.nodes.length} nodes, ${clusterInfo.deployments.length} deployments across ${clusterInfo.namespaces.length} namespaces`);
     }
     catch (err) {
         spinner.fail(`Cluster scan failed: ${err.message}`);
@@ -96,8 +105,12 @@ export async function onboard() {
             const notes = await runInterview({ cluster: clusterInfo, projects });
             const kbDir = join(configDir(), "clusters", contextName);
             ensureKbDir(kbDir);
+            const totalItems = projects.length + 1;
+            const earlyKbSpinner = ora(`Building knowledge base [1/${totalItems}]: cluster...`).start();
             writeClusterKb(kbDir, formatClusterMarkdown(clusterInfo));
-            for (const p of projects) {
+            for (let i = 0; i < projects.length; i++) {
+                const p = projects[i];
+                earlyKbSpinner.text = `Building knowledge base [${i + 2}/${totalItems}]: ${p.name}...`;
                 const mapping = projectMappings.find((m) => m.name === p.name);
                 const mappingNote = mapping ? `**Deployment:** ${mapping.deployment} (${mapping.namespace})\n**Kind:** ${mapping.kind}` : undefined;
                 writeProjectKb(kbDir, p.name, formatProjectMarkdown(p.name, p.path, p.stack, mappingNote));
@@ -105,6 +118,7 @@ export async function onboard() {
             if (notes.size > 0) {
                 writeProjectKb(kbDir, "_notes", `# Onboarding Notes\n\n${Array.from(notes.entries()).map(([q, a]) => `**${q}**\n${a}`).join("\n\n")}\n`);
             }
+            earlyKbSpinner.succeed(`Knowledge base written (${totalItems} file${totalItems !== 1 ? "s" : ""})`);
             const currentSafeActions = existingConfig.remediation?.safe_actions ?? DEFAULT_SAFE_ACTIONS;
             const safeActions = await configureSafeActions(currentSafeActions);
             const existingChannels = existingConfig.notifications?.channels ?? [];
@@ -258,9 +272,13 @@ export async function onboard() {
     // Step 6: Write knowledge base
     const kbDir = join(configDir(), "clusters", contextName);
     ensureKbDir(kbDir);
+    const totalKbItems = projects.length + 1; // +1 for cluster
+    const kbSpinner = ora(`Building knowledge base [1/${totalKbItems}]: cluster...`).start();
     const clusterMd = formatClusterMarkdown(clusterInfo);
     writeClusterKb(kbDir, clusterMd);
-    for (const p of projects) {
+    for (let i = 0; i < projects.length; i++) {
+        const p = projects[i];
+        kbSpinner.text = `Building knowledge base [${i + 2}/${totalKbItems}]: ${p.name}...`;
         const interviewNotes = Array.from(notes.entries())
             .filter(([q]) => q.toLowerCase().includes(p.name.toLowerCase()))
             .map(([q, a]) => `**${q}**\n${a}`)
@@ -280,6 +298,7 @@ export async function onboard() {
             .join("\n\n");
         writeProjectKb(kbDir, "_notes", `# Onboarding Notes\n\n${generalNotes}\n`);
     }
+    kbSpinner.succeed(`Knowledge base written (${totalKbItems} file${totalKbItems !== 1 ? "s" : ""})`);
     // Step 6b: Configure safe actions
     const currentSafeActions = existingConfig.remediation?.safe_actions ?? DEFAULT_SAFE_ACTIONS;
     const safeActions = await configureSafeActions(currentSafeActions);

package/dist/onboard/interview.js

@@ -1,5 +1,6 @@
 import readline from "node:readline";
 import chalk from "chalk";
+import ora from "ora";
 import { loadAuth } from "../auth.js";
 import { proxyRequest } from "../proxy-client.js";
 async function ask(question) {
@@ -29,6 +30,7 @@ export async function runInterview(context) {
         `Projects: ${context.projects.map((p) => `${p.name} (${p.stack.language}/${p.stack.framework})`).join(", ")}`,
     ].join("\n");
     let response;
+    const interviewSpinner = ora("Preparing interview questions...").start();
     try {
         response = await createMessage({
             model: "claude-haiku-4-5-20251001",
@@ -40,8 +42,10 @@ export async function runInterview(context) {
                 },
             ],
         });
+        interviewSpinner.succeed("Interview questions ready");
     }
     catch (err) {
+        interviewSpinner.stop();
         const msg = err.message;
         if (msg === "no_auth") {
             console.log(chalk.yellow("Skipping AI interview — run 'kubeagent login' to enable."));

package/package.json

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