@appthrust/kest 0.1.0 → 0.1.2

package/README.md

@@ -1,10 +1,12 @@
 # Kest
 
+![Kest – Kubernetes E2E testing designed for humans and AI alike](social-preview.svg)
+
 > **Preview Release** -- Kest is currently in `0.x` preview. The API may change based on feedback. Breaking changes can occur in any `0.x` release. A stable `1.0.0` will be released once the API solidifies. Feel free to [open an issue](https://github.com/appthrust/kest/issues/new) if you have any feedback.
 
-**TypeScript-first E2E testing framework for Kubernetes**
+**Kubernetes E2E testing designed for humans and AI alike**
 
-Kest makes it easy to write reliable end-to-end tests for Kubernetes controllers, operators, and admission webhooks. You write test scenarios in TypeScript with full type safety, autocompletion, and the familiar `expect()` API.
+Kest makes it easy to write reliable end-to-end tests for Kubernetes controllers, operators, and admission webhooks. You write test scenarios in TypeScript with full type safety, autocompletion, and the familiar `expect()` API. When a test fails, Kest generates structured Markdown reports that are easy for humans to scan and for AI assistants to parse -- making troubleshooting straightforward regardless of who (or what) is debugging.
 
 ```ts
 import { expect } from "bun:test";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@appthrust/kest",
-  "version": "0.1.0",
-  "description": "TypeScript-first E2E testing framework for Kubernetes controllers, operators, and webhooks",
+  "version": "0.1.2",
+  "description": "Kubernetes E2E testing framework designed for humans and AI alike",
   "type": "module",
   "module": "ts/index.ts",
   "exports": {

package/ts/actions/apply.ts

@@ -17,7 +17,9 @@ export const apply = {
       await kubectl.apply(result.value);
       return {
         async revert() {
-          await kubectl.delete(result.value.kind, result.value.metadata.name);
+          await kubectl.delete(result.value.kind, result.value.metadata.name, {
+            ignoreNotFound: true,
+          });
         },
         output: undefined,
       };

package/ts/kubectl/index.ts

@@ -126,17 +126,26 @@ export interface Kubectl {
    *
    * @param resource - The resource type (e.g., "configmap", "namespace")
    * @param name - The name of the resource to delete
-   * @param context - Optional context overrides for this call
+   * @param options - Optional delete options (ignoreNotFound, context)
    * @returns The trimmed stdout from kubectl (e.g., "configmap \"my-config\" deleted")
    * @throws Error if kubectl exits with non-zero code
    */
   delete(
     resource: string,
     name: string,
-    context?: KubectlContext
+    options?: KubectlDeleteOptions
   ): Promise<string>;
 }
 
+export interface KubectlDeleteOptions {
+  /**
+   * If true, adds `--ignore-not-found` so that deleting a resource
+   * that does not exist succeeds silently instead of failing.
+   */
+  readonly ignoreNotFound?: undefined | boolean;
+  readonly context?: undefined | KubectlContext;
+}
+
 export class RealKubectl implements Kubectl {
   private readonly recorder: Recorder;
   private readonly cwd: undefined | string;
@@ -260,13 +269,17 @@ export class RealKubectl implements Kubectl {
   async delete(
     resource: string,
     name: string,
-    context?: KubectlContext
+    options?: KubectlDeleteOptions
   ): Promise<string> {
+    const args: [string, ...Array<string>] = ["delete", `${resource}/${name}`];
+    if (options?.ignoreNotFound) {
+      args.push("--ignore-not-found");
+    }
     return await this.runKubectl({
-      args: ["delete", `${resource}/${name}`],
+      args,
       stdoutLanguage: "text",
       stderrLanguage: "text",
-      overrideContext: context,
+      overrideContext: options?.context,
     });
   }