Highlights

• KubernetesClient — the top-level client, constructed from a kubeconfig path, a kubeconfig dict, or an in-cluster service-account context.

• A workload primitives layer — typed helpers for Job, Deployment, StatefulSet, PersistentVolumeClaim, Service, and Ingress, each exposing apply, delete, get, list, and waiter methods built on codecraftai-foundations.

• Consistent typed return objects — every method returns a typed result object (DTOs under model/), not a raw dict.

• Consistent failure shape — API errors are reclassified into named exceptions (KubernetesResourceNotFoundError, KubernetesConflictError, etc.) so callers do not decode ApiException status codes.

• All public APIs normalize the underlying client to the ccai Aspects pattern — callers control timeouts, retries, and logging; no behaviour-modifying decorators.

Repository Structure

• development/ - Runtime environment scripts.

• repository-setup/ - Repository homing and setup scripts.

• source/packages/ccai/interop/kubernetes/ - Package source code.

• source/testroots/testbase/ccai/tests/interop/kubernetes/ - TestBase test roots.

• specs/ - Requirements, design, and task documentation (Kiro-style).

• userguide/ - Standards, conventions, and documentation.

Environment Setup

When working in a Codex container:

./development/setup-agent-container

For local development:

./repository-setup/rehome-repository
./development/setup-environment

Running Tests

source .venv/bin/activate
testbase testing run --root ./source/testroots/testbase --includes=testbase.ccai.tests

Standards and Conventions

• Naming conventions: userguide/10-02-naming-conventions.rst

• Code organization: userguide/10-01-code-organization.rst

• Coding standards: userguide/10-00-coding-standards.rst

Additional Resources

• User guide entry point: userguide/userguide.rst