@flowwright/executor-k8s

A Kubernetes Executor for FlowWright — it runs each container stage as a Pod, driving the same execution-plan IR the local shell executor runs. Swapping executors changes where steps run, never what runs: the plan is the contract.

FlowWright · Runtime · Core / IR

Use it

import { KubernetesExecutor } from "@flowwright/executor-k8s";

const executor = new KubernetesExecutor({
  namespace: "flowwright",
  // kube client config; defaults to in-cluster / KUBECONFIG
});

// The runtime drives the executor against a compiled ExecutionPlan.
await runtime.execute(plan, { executor });

Public surface

| Area | Main exports | |---|---| | Executor | KubernetesExecutor, KubernetesExecutorOptions | | Pod building | buildPodSpec, buildExecCommand, k8sName | | Kube client | createKubeClient, exitCodeFromStatus, KubeClient, KubeClientConfig, PodManifest, PodStatus |

Design boundary

• Implements the runtime StepExecutor interface — a peer of the local-shell executor, not a fork of it. Both consume the identical IR.
• Each container stage becomes a Pod; stdout/stderr stream back as the same typed events.
• No plan-building, no persistence, no scheduling policy — this package only executes steps.

Development

$ pnpm --filter @flowwright/executor-k8s typecheck
$ pnpm --filter @flowwright/executor-k8s test
$ pnpm --filter @flowwright/executor-k8s build

Requires Node.js 24+. Licensed under MIT.