@appthrust/kest 0.3.1 → 0.3.2

package/README.md

@@ -254,8 +254,8 @@ await ns.label({
   kind: "ConfigMap",
   name: "my-config",
   labels: {
-    env: "production",   // add a label
-    deprecated: null,    // remove a label
+    env: "production", // add a label
+    deprecated: null, // remove a label
   },
 });
 ```
@@ -310,33 +310,51 @@ test("ConfigMap lifecycle", async (s) => {
 
 ### Markdown Test Reports
 
-When a test fails (or when `KEST_SHOW_REPORT=1` is set), Kest generates a detailed Markdown report showing every action, the exact `kubectl` commands executed, stdout/stderr output, and cleanup results. This provides full transparency into what happened during the test, making troubleshooting straightforward -- for both humans and AI assistants.
+When a test fails (or when `KEST_SHOW_REPORT=1` is set), Kest generates a detailed Markdown report showing every action, the exact `kubectl` commands executed (including stdin manifests), stdout/stderr output, and cleanup results. This provides full transparency into what happened during the test, making troubleshooting straightforward -- for both humans and AI assistants.
 
-```markdown
+````markdown
 # ConfigMap lifecycle
 
 ## Scenario Overview
 
-| #   | Action           | Resource            | Status |
-| --- | ---------------- | ------------------- | ------ |
-| 1   | Create namespace | kest-9hdhj          | ✅     |
-| 2   | Apply            | ConfigMap/my-config | ✅     |
-| 3   | Assert           | ConfigMap/my-config | ✅     |
+| #   | Action                         | Status |
+| --- | ------------------------------ | ------ |
+| 1   | Apply Namespace `kest-9hdhj`   | ✅     |
+| 2   | Apply `ConfigMap` "my-config"  | ✅     |
+| 3   | Assert `ConfigMap` "my-config" | ✅     |
 
 ## Scenario Details
 
 ### Given: a namespace exists
 
-✅ Create Namespace "kest-9hdhj"
+**✅ Apply Namespace `kest-9hdhj`**
+
+```shell
+kubectl apply -f - <<EOF
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: kest-9hdhj
+EOF
+```
+
 ...
 
 ### Cleanup
 
-| #   | Action           | Resource            | Status |
-| --- | ---------------- | ------------------- | ------ |
-| 1   | Delete           | ConfigMap/my-config | ✅     |
-| 2   | Delete namespace | kest-9hdhj          | ✅     |
+| #   | Action                         | Status |
+| --- | ------------------------------ | ------ |
+| 1   | Delete `ConfigMap` "my-config" | ✅     |
+| 2   | Delete Namespace `kest-9hdhj`  | ✅     |
+
+```shellsession
+$ kubectl delete ConfigMap/my-config -n kest-9hdhj
+configmap "my-config" deleted
+
+$ kubectl delete namespace/kest-9hdhj
+namespace "kest-9hdhj" deleted
 ```
+````
 
 ## Getting Started
 
@@ -410,21 +428,21 @@ Entry point for defining a test scenario. The callback receives a `Scenario` obj
 
 The top-level API surface available in every test callback.
 
-| Method                                                                  | Description                                       |
-| ----------------------------------------------------------------------- | ------------------------------------------------- |
-| `apply(manifest, options?)`                                             | Apply a Kubernetes manifest and register cleanup  |
-| `create(manifest, options?)`                                            | Create a Kubernetes resource and register cleanup |
-| `applyStatus(manifest, options?)`                                       | Apply a status subresource (server-side apply)    |
-| `delete(resource, options?)`                                            | Delete a resource by API version, kind, and name  |
-| `label(input, options?)`                                                | Add, update, or remove labels on a resource       |
-| `get(resource, options?)`                                               | Fetch a resource by API version, kind, and name   |
-| `assert(resource, options?)`                                            | Fetch a resource and run assertions with retries  |
-| `assertAbsence(resource, options?)`                                     | Assert that a resource does not exist             |
-| `assertList(resource, options?)`                                        | Fetch a list of resources and run assertions      |
+| Method                                                                  | Description                                                 |
+| ----------------------------------------------------------------------- | ----------------------------------------------------------- |
+| `apply(manifest, options?)`                                             | Apply a Kubernetes manifest and register cleanup            |
+| `create(manifest, options?)`                                            | Create a Kubernetes resource and register cleanup           |
+| `applyStatus(manifest, options?)`                                       | Apply a status subresource (server-side apply)              |
+| `delete(resource, options?)`                                            | Delete a resource by API version, kind, and name            |
+| `label(input, options?)`                                                | Add, update, or remove labels on a resource                 |
+| `get(resource, options?)`                                               | Fetch a resource by API version, kind, and name             |
+| `assert(resource, options?)`                                            | Fetch a resource and run assertions with retries            |
+| `assertAbsence(resource, options?)`                                     | Assert that a resource does not exist                       |
+| `assertList(resource, options?)`                                        | Fetch a list of resources and run assertions                |
 | `newNamespace(name?, options?)`                                         | Create an ephemeral namespace (supports `{ generateName }`) |
-| `exec(input, options?)`                                                 | Execute shell commands with optional revert       |
-| `useCluster(ref)`                                                       | Create a cluster-bound API surface                |
-| `given(desc)` / `when(desc)` / `then(desc)` / `and(desc)` / `but(desc)` | BDD annotations for reporting                     |
+| `exec(input, options?)`                                                 | Execute shell commands with optional revert                 |
+| `useCluster(ref)`                                                       | Create a cluster-bound API surface                          |
+| `given(desc)` / `when(desc)` / `then(desc)` / `and(desc)` / `but(desc)` | BDD annotations for reporting                               |
 
 ### Namespace / Cluster
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appthrust/kest",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Kubernetes E2E testing framework designed for humans and AI alike",
   "type": "module",
   "module": "ts/index.ts",

package/ts/actions/{apply-namespace.ts → create-namespace.ts}

@@ -1,4 +1,4 @@
-import { apply } from "./apply";
+import { create } from "./create";
 import type { MutateDef } from "./types";
 
 /**
@@ -9,19 +9,19 @@ import type { MutateDef } from "./types";
  * - `{ generateName: string }` -- use the string as a prefix followed by
  *   random characters (e.g. `{ generateName: "foo-" }` → `"foo-d7kpn"`).
  */
-export type ApplyNamespaceInput =
+export type CreateNamespaceInput =
   | undefined
   | string
   | { readonly generateName: string };
 
-export const applyNamespace = {
+export const createNamespace = {
   type: "mutate",
-  name: "ApplyNamespace",
+  name: "CreateNamespace",
   mutate:
     ({ kubectl }) =>
     async (input) => {
       const name = resolveNamespaceName(input);
-      const { revert } = await apply.mutate({ kubectl })({
+      const { revert } = await create.mutate({ kubectl })({
         apiVersion: "v1",
         kind: "Namespace",
         metadata: {
@@ -32,16 +32,16 @@ export const applyNamespace = {
     },
   describe: (input) => {
     if (input === undefined) {
-      return "Apply `Namespace` with auto-generated name";
+      return "Create `Namespace` with auto-generated name";
     }
     if (typeof input === "string") {
-      return `Apply \`Namespace\` "${input}"`;
+      return `Create \`Namespace\` "${input}"`;
     }
-    return `Apply \`Namespace\` with prefix "${input.generateName}"`;
+    return `Create \`Namespace\` with prefix "${input.generateName}"`;
   },
-} satisfies MutateDef<ApplyNamespaceInput, string>;
+} satisfies MutateDef<CreateNamespaceInput, string>;
 
-function resolveNamespaceName(input: ApplyNamespaceInput): string {
+function resolveNamespaceName(input: CreateNamespaceInput): string {
   if (input === undefined) {
     return `kest-${randomConsonantDigits(5)}`;
   }

package/ts/scenario/index.ts

@@ -1,13 +1,13 @@
 import { apply } from "../actions/apply";
-import {
-  type ApplyNamespaceInput,
-  applyNamespace,
-} from "../actions/apply-namespace";
 import { applyStatus } from "../actions/apply-status";
 import { assert } from "../actions/assert";
 import { assertAbsence } from "../actions/assert-absence";
 import { assertList } from "../actions/assert-list";
 import { create } from "../actions/create";
+import {
+  type CreateNamespaceInput,
+  createNamespace,
+} from "../actions/create-namespace";
 import { deleteResource } from "../actions/delete";
 import { exec } from "../actions/exec";
 import { get } from "../actions/get";
@@ -187,10 +187,10 @@ const createQueryFn =
 const createNewNamespaceFn =
   (scenarioDeps: CreateScenarioOptions) =>
   async (
-    name?: ApplyNamespaceInput,
+    name?: CreateNamespaceInput,
     options?: undefined | ActionOptions
   ): Promise<Namespace> => {
-    const namespaceName = await createMutateFn(scenarioDeps, applyNamespace)(
+    const namespaceName = await createMutateFn(scenarioDeps, createNamespace)(
       name,
       options
     );