kx-cli 0.0.5__tar.gz → 0.0.7__tar.gz

{kx_cli-0.0.5/src/kx_cli.egg-info → kx_cli-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kx-cli
-Version: 0.0.5
+Version: 0.0.7
 Summary: kubectl wrapper with index-based resource selection
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
@@ -9,13 +9,16 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typer==0.26.8
+Requires-Dist: typer==0.27.0
 Requires-Dist: kubernetes
 Requires-Dist: rich
 Provides-Extra: dev
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Provides-Extra: build
+Requires-Dist: pyinstaller; extra == "build"
 Dynamic: license-file
 
 <div align="center">
@@ -47,10 +50,42 @@ Dynamic: license-file
 
 ## Install
 
+Requires Python 3.11+ and `kubectl` on your PATH.
+
+With [uv](https://docs.astral.sh/uv/) (recommended):
+
+```bash
+uv tool install kx-cli
+```
+
+With [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install kx-cli
+```
+
+With pip:
+
 ```bash
 pip install kx-cli
 ```
 
+As a kubectl plugin via [krew](https://krew.sigs.k8s.io/) (no Python required; pending krew-index acceptance):
+
+```bash
+kubectl krew install kx
+alias kx="kubectl kx"
+```
+
+Standalone binaries (linux/macOS, amd64/arm64, no Python required) are attached to each [GitHub Release](https://github.com/jzills/kx/releases).
+
+Or try it without installing (the package is `kx-cli`, the command is `kx`):
+
+```bash
+uvx --from kx-cli kx get pods
+pipx run --spec kx-cli kx get pods
+```
+
 ## Usage
 
 ### List resources
@@ -59,29 +94,34 @@ pip install kx-cli
 kx get <resource> [--match|-m <substring>] [kubectl flags...]
 ```
 
-Fetches resources and assigns index numbers. Any extra flags (e.g. `-n <namespace>`, `-A`) are passed through to kubectl. Use `--match`/`-m` to filter results by name (substring, case-insensitive).
+Fetches resources and assigns index numbers. Any extra flags (e.g. `-n <namespace>`, `-A`) are passed through to kubectl. Use `--match`/`-m` to filter results by name (substring, case-insensitive). All-namespace listings (`-A`) are display-only — rows aren't indexed, since names aren't unique across namespaces; scope to a namespace to select.
+
+Known kinds can drop the `get`: `kx pods`, `kx deploy -n kube-system`, `kx svc --match api`. This covers the built-in kinds and their kubectl shorthands (`po`, `deploy`, `svc`, `sts`, ...); existing commands take precedence, so `kx ns 3` still switches namespaces (bare `kx ns` lists them). CRDs and other resource types still use `kx get <resource>`. An integer after a kind is an index into the current state: `kx po 3` (or `kx get po 3`) relists just that pod, erroring if index 3 isn't a pod. Multiple indexes work too: `kx po 1 3`.
 
 ```
 $ kx get pods
-X  NAME                          READY  STATUS   RESTARTS  AGE
-1  api-7d9f4b8c6-xkp2q           1/1    Running  0         2d
-2  worker-6c8b5f7d9-mnt4r        1/1    Running  3         5h
-3  postgres-0                    1/1    Running  0         12d
+Pods · default · 3 items
+  X    NAME                      READY    STATUS     RESTARTS    AGE
+  1    api-7d9f4b8c6-xkp2q       1/1      Running    0            2d
+  2    worker-6c8b5f7d9-mnt4r    1/1      Running    3            5h
+  3    postgres-0                1/1      Running    0           12d
 ```
 
 All subsequent commands reference resources by their `X` index from the last `kx get`.
 
+Global flags: `--no-color` disables styled output, `-v`/`--version` prints the installed version, and `--help` on any command shows usage, examples, and aliases.
+
 ### Commands
 
 <!-- commands-table-start -->
 | Command | Description |
 |---|---|
-| `kx get <resource> [--match/-m text] [kubectl flags...]` | List resources and assign index numbers for use with other commands. |
+| `kx get <resource> [--match/-m str] [kubectl flags...]` | List resources and assign index numbers for use with other commands; shorthand: kx <kind> (e.g. kx pods, kx po 3). |
 | `kx describe <indexes>... [kubectl flags...]` | Show full kubectl describe output for one or more indexed resources. |
 | `kx events <indexes>...` | Show Kubernetes events for one or more indexed resources. |
 | `kx logs <index> [kubectl flags...]` | Stream logs for an indexed resource; aggregates across pods for Deployments, StatefulSets, DaemonSets, and Services. |
 | `kx labels <indexes>... [--selector/-s]` | Show labels for one or more indexed resources; --selector formats output as a label selector. |
-| `kx yaml <indexes>... [--show text]` | Print the raw YAML manifest for one or more indexed resources; --show filters to specific top-level fields. |
+| `kx yaml <indexes>... [--show str]` | Print the raw YAML manifest for one or more indexed resources; --show filters to specific top-level fields. |
 | `kx delete <indexes>... [--yes/-y]` | Delete one or more indexed resources (prompts for confirmation unless --yes). |
 | `kx edit <index> [kubectl flags...]` | Open an indexed resource in your editor via kubectl edit. |
 | `kx exec <index> [<cmd>...] [kubectl flags...]` | Open an interactive shell in an indexed pod (bash, falling back to sh). |
@@ -89,7 +129,9 @@ All subsequent commands reference resources by their `X` index from the last `kx
 | `kx rollout <action> <index>` | Run a rollout action (status, restart, pause, resume, history, undo) on a Deployment, StatefulSet, or DaemonSet. |
 | `kx scale <index> <replicas>` | Scale an indexed Deployment, StatefulSet, or ReplicaSet to a given replica count. |
 | `kx port-forward <index> <port> [kubectl flags...]` | Forward a local port to an indexed resource (Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet, Service). |
-| `kx namespace <index>` | Switch to an indexed namespace; alias: kx ns (run kx get namespaces first). |
+| `kx diagnostic <index>` | Run read-only health diagnostics on an indexed Deployment, StatefulSet, DaemonSet, or Pod; alias: kx diag. |
+| `kx namespace [<index>]` | List namespaces, or switch to an indexed one; alias: kx ns. |
+| `kx theme [<name>]` | List available color themes or persist a choice by name or index. |
 | `kx state [<position>] [--all/-a]` | Show current state, jump to a history position, or list all entries with --all. |
 | `kx drop <position>` | Remove a history entry by position (shown in kx state --all). |
 | `kx back` | Navigate to the previous kx get result. |
@@ -128,7 +170,7 @@ kx delete 3
 
 ## State
 
-`kx` maintains a history of up to 10 `kx get` results in `~/.kx_state.json`. A cursor tracks your current position; index-based commands always resolve against the entry at the cursor.
+`kx` maintains a history of up to 10 `kx get` results in `~/.kx/state.json`. A cursor tracks your current position; index-based commands always resolve against the entry at the cursor.
 
 ```
 $ kx get pods          # saves a new entry, cursor advances
@@ -139,6 +181,29 @@ $ kx state --all       # lists all history entries and the current position
 
 Use `kx state <position>` to jump directly to any history entry, and `kx drop <position>` to remove one.
 
+## Configuration
+
+`kx` reads `~/.kx/config.toml`; environment variables override file settings.
+
+| Key | Env var | Default | Description |
+| --- | --- | --- | --- |
+| `max_history` | `KX_MAX_HISTORY` | `10` | Number of `kx get` results kept in history. |
+| `shells` | `KX_SHELLS` (comma-separated) | `["bash", "sh"]` | Shell candidates for `kx exec`. |
+| `no_color` | `KX_NO_COLOR` | `false` | Disable styled output (same as `--no-color`). |
+| `theme` | `KX_THEME` | `"github-dark"` | Color theme for all output. |
+
+Styled output is emitted only when stdout is a terminal — piped or redirected output is plain text, so `kx get pods | grep worker` stays clean. The [`NO_COLOR`](https://no-color.org/) convention is honored as well.
+
+### Themes
+
+```bash
+kx theme        # list available themes (indexed) with a preview of each
+kx theme nord   # persist a theme to ~/.kx/config.toml
+kx theme 3      # same, selecting by index from the kx theme listing
+```
+
+Prefab themes: `github-dark` (default), `dracula`, `nord`, `gruvbox`, `solarized-dark`, `catppuccin-mocha`, `tokyo-night`, `rose-pine`, `mono`, `light` (for light terminal backgrounds), and `plain` (no styling at all).
+
 ## Development
 
 ```bash

{kx_cli-0.0.5 → kx_cli-0.0.7}/README.md

@@ -27,10 +27,42 @@
 
 ## Install
 
+Requires Python 3.11+ and `kubectl` on your PATH.
+
+With [uv](https://docs.astral.sh/uv/) (recommended):
+
+```bash
+uv tool install kx-cli
+```
+
+With [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install kx-cli
+```
+
+With pip:
+
 ```bash
 pip install kx-cli
 ```
 
+As a kubectl plugin via [krew](https://krew.sigs.k8s.io/) (no Python required; pending krew-index acceptance):
+
+```bash
+kubectl krew install kx
+alias kx="kubectl kx"
+```
+
+Standalone binaries (linux/macOS, amd64/arm64, no Python required) are attached to each [GitHub Release](https://github.com/jzills/kx/releases).
+
+Or try it without installing (the package is `kx-cli`, the command is `kx`):
+
+```bash
+uvx --from kx-cli kx get pods
+pipx run --spec kx-cli kx get pods
+```
+
 ## Usage
 
 ### List resources
@@ -39,29 +71,34 @@ pip install kx-cli
 kx get <resource> [--match|-m <substring>] [kubectl flags...]
 ```
 
-Fetches resources and assigns index numbers. Any extra flags (e.g. `-n <namespace>`, `-A`) are passed through to kubectl. Use `--match`/`-m` to filter results by name (substring, case-insensitive).
+Fetches resources and assigns index numbers. Any extra flags (e.g. `-n <namespace>`, `-A`) are passed through to kubectl. Use `--match`/`-m` to filter results by name (substring, case-insensitive). All-namespace listings (`-A`) are display-only — rows aren't indexed, since names aren't unique across namespaces; scope to a namespace to select.
+
+Known kinds can drop the `get`: `kx pods`, `kx deploy -n kube-system`, `kx svc --match api`. This covers the built-in kinds and their kubectl shorthands (`po`, `deploy`, `svc`, `sts`, ...); existing commands take precedence, so `kx ns 3` still switches namespaces (bare `kx ns` lists them). CRDs and other resource types still use `kx get <resource>`. An integer after a kind is an index into the current state: `kx po 3` (or `kx get po 3`) relists just that pod, erroring if index 3 isn't a pod. Multiple indexes work too: `kx po 1 3`.
 
 ```
 $ kx get pods
-X  NAME                          READY  STATUS   RESTARTS  AGE
-1  api-7d9f4b8c6-xkp2q           1/1    Running  0         2d
-2  worker-6c8b5f7d9-mnt4r        1/1    Running  3         5h
-3  postgres-0                    1/1    Running  0         12d
+Pods · default · 3 items
+  X    NAME                      READY    STATUS     RESTARTS    AGE
+  1    api-7d9f4b8c6-xkp2q       1/1      Running    0            2d
+  2    worker-6c8b5f7d9-mnt4r    1/1      Running    3            5h
+  3    postgres-0                1/1      Running    0           12d
 ```
 
 All subsequent commands reference resources by their `X` index from the last `kx get`.
 
+Global flags: `--no-color` disables styled output, `-v`/`--version` prints the installed version, and `--help` on any command shows usage, examples, and aliases.
+
 ### Commands
 
 <!-- commands-table-start -->
 | Command | Description |
 |---|---|
-| `kx get <resource> [--match/-m text] [kubectl flags...]` | List resources and assign index numbers for use with other commands. |
+| `kx get <resource> [--match/-m str] [kubectl flags...]` | List resources and assign index numbers for use with other commands; shorthand: kx <kind> (e.g. kx pods, kx po 3). |
 | `kx describe <indexes>... [kubectl flags...]` | Show full kubectl describe output for one or more indexed resources. |
 | `kx events <indexes>...` | Show Kubernetes events for one or more indexed resources. |
 | `kx logs <index> [kubectl flags...]` | Stream logs for an indexed resource; aggregates across pods for Deployments, StatefulSets, DaemonSets, and Services. |
 | `kx labels <indexes>... [--selector/-s]` | Show labels for one or more indexed resources; --selector formats output as a label selector. |
-| `kx yaml <indexes>... [--show text]` | Print the raw YAML manifest for one or more indexed resources; --show filters to specific top-level fields. |
+| `kx yaml <indexes>... [--show str]` | Print the raw YAML manifest for one or more indexed resources; --show filters to specific top-level fields. |
 | `kx delete <indexes>... [--yes/-y]` | Delete one or more indexed resources (prompts for confirmation unless --yes). |
 | `kx edit <index> [kubectl flags...]` | Open an indexed resource in your editor via kubectl edit. |
 | `kx exec <index> [<cmd>...] [kubectl flags...]` | Open an interactive shell in an indexed pod (bash, falling back to sh). |
@@ -69,7 +106,9 @@ All subsequent commands reference resources by their `X` index from the last `kx
 | `kx rollout <action> <index>` | Run a rollout action (status, restart, pause, resume, history, undo) on a Deployment, StatefulSet, or DaemonSet. |
 | `kx scale <index> <replicas>` | Scale an indexed Deployment, StatefulSet, or ReplicaSet to a given replica count. |
 | `kx port-forward <index> <port> [kubectl flags...]` | Forward a local port to an indexed resource (Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet, Service). |
-| `kx namespace <index>` | Switch to an indexed namespace; alias: kx ns (run kx get namespaces first). |
+| `kx diagnostic <index>` | Run read-only health diagnostics on an indexed Deployment, StatefulSet, DaemonSet, or Pod; alias: kx diag. |
+| `kx namespace [<index>]` | List namespaces, or switch to an indexed one; alias: kx ns. |
+| `kx theme [<name>]` | List available color themes or persist a choice by name or index. |
 | `kx state [<position>] [--all/-a]` | Show current state, jump to a history position, or list all entries with --all. |
 | `kx drop <position>` | Remove a history entry by position (shown in kx state --all). |
 | `kx back` | Navigate to the previous kx get result. |
@@ -108,7 +147,7 @@ kx delete 3
 
 ## State
 
-`kx` maintains a history of up to 10 `kx get` results in `~/.kx_state.json`. A cursor tracks your current position; index-based commands always resolve against the entry at the cursor.
+`kx` maintains a history of up to 10 `kx get` results in `~/.kx/state.json`. A cursor tracks your current position; index-based commands always resolve against the entry at the cursor.
 
 ```
 $ kx get pods          # saves a new entry, cursor advances
@@ -119,6 +158,29 @@ $ kx state --all       # lists all history entries and the current position
 
 Use `kx state <position>` to jump directly to any history entry, and `kx drop <position>` to remove one.
 
+## Configuration
+
+`kx` reads `~/.kx/config.toml`; environment variables override file settings.
+
+| Key | Env var | Default | Description |
+| --- | --- | --- | --- |
+| `max_history` | `KX_MAX_HISTORY` | `10` | Number of `kx get` results kept in history. |
+| `shells` | `KX_SHELLS` (comma-separated) | `["bash", "sh"]` | Shell candidates for `kx exec`. |
+| `no_color` | `KX_NO_COLOR` | `false` | Disable styled output (same as `--no-color`). |
+| `theme` | `KX_THEME` | `"github-dark"` | Color theme for all output. |
+
+Styled output is emitted only when stdout is a terminal — piped or redirected output is plain text, so `kx get pods | grep worker` stays clean. The [`NO_COLOR`](https://no-color.org/) convention is honored as well.
+
+### Themes
+
+```bash
+kx theme        # list available themes (indexed) with a preview of each
+kx theme nord   # persist a theme to ~/.kx/config.toml
+kx theme 3      # same, selecting by index from the kx theme listing
+```
+
+Prefab themes: `github-dark` (default), `dracula`, `nord`, `gruvbox`, `solarized-dark`, `catppuccin-mocha`, `tokyo-night`, `rose-pine`, `mono`, `light` (for light terminal backgrounds), and `plain` (no styling at all).
+
 ## Development
 
 ```bash

{kx_cli-0.0.5 → kx_cli-0.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kx-cli"
-version = "0.0.5"
+version = "0.0.7"
 description = "kubectl wrapper with index-based resource selection"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -11,7 +11,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "typer==0.26.8",
+    "typer==0.27.0",
     "kubernetes",
     "rich",
 ]
@@ -21,6 +21,10 @@ dev = [
     "ruff",
     "pre-commit",
     "pytest",
+    "pytest-cov",
+]
+build = [
+    "pyinstaller",
 ]
 
 [project.scripts]

{kx_cli-0.0.5 → kx_cli-0.0.7}/src/kx/commands/delete.py

@@ -1,6 +1,8 @@
+from contextlib import nullcontext
+
 from kx.kubectl import KubectlServiceProtocol
 from kx.state import StateServiceProtocol
-from kx.types import Confirm
+from kx.types import Confirm, Status
 
 
 class DeleteCommand:
@@ -9,14 +11,19 @@ class DeleteCommand:
         state: StateServiceProtocol,
         kubectl: KubectlServiceProtocol,
         confirm: Confirm,
+        status: Status | None = None,
     ):
         self.state = state
         self.kubectl = kubectl
         self.confirm = confirm
+        self.status = status or (lambda _msg: nullcontext())
 
     def execute(self, index: int, yes: bool) -> str:
         name, namespace, kind = self.state.fields(index)
+        # The confirm prompt must stay outside the spinner: a prompt inside a
+        # Live region breaks input.
         if not yes:
             self.confirm(f"Delete {kind}/{name} in {namespace}?")
-        self.kubectl.run(["delete", kind, name, "-n", namespace])
+        with self.status("deleting"):
+            self.kubectl.run(["delete", kind, name, "-n", namespace])
         return f"Deleted {kind}/{name}"

{kx_cli-0.0.5 → kx_cli-0.0.7}/src/kx/commands/describe.py

@@ -1,4 +1,5 @@
 from kx.kubectl import KubectlServiceProtocol
+from kx.refresh import ensure_exists
 from kx.state import StateServiceProtocol
 
 
@@ -11,8 +12,11 @@ class DescribeCommand:
         self.state = state
         self.kubectl = kubectl
 
-    def execute(self, index: int, extra_args: list[str] = []) -> None:
+    def execute(self, index: int, extra_args: list[str] | None = None) -> None:
+        extra_args = extra_args or []
         name, namespace, kind = self.state.fields(index)
-        self.kubectl.run_interactive(
+        rc = self.kubectl.run_interactive(
             ["describe", kind, name, "-n", namespace, *extra_args]
         )
+        if rc != 0:
+            ensure_exists(self.kubectl, kind, name, namespace)

kx_cli-0.0.7/src/kx/commands/diagnostic.py

@@ -0,0 +1,195 @@
+from kx.diagnostics import (
+    ContainerDiagnostic,
+    DiagnosticData,
+    DiagnosticReport,
+    DiagnosticsServiceProtocol,
+    Finding,
+    PodDiagnostic,
+    ReplicaHealth,
+    Severity,
+)
+from kx.kinds import Kind
+from kx.state import StateServiceProtocol
+
+_SUPPORTED_KINDS = {Kind.Deployment, Kind.StatefulSet, Kind.DaemonSet, Kind.Pod}
+_RESTART_WARN_THRESHOLD = 5
+
+_IMAGE_PULL_REASONS = {"ImagePullBackOff", "ErrImagePull", "InvalidImageName"}
+_CONFIG_ERROR_REASONS = {"CreateContainerConfigError", "CreateContainerError"}
+
+
+class DiagnosticCommand:
+    def __init__(
+        self,
+        state: StateServiceProtocol,
+        diagnostics: DiagnosticsServiceProtocol,
+    ):
+        self.state = state
+        self.diagnostics = diagnostics
+
+    def execute(self, index: int) -> DiagnosticReport:
+        name, namespace, kind = self.state.fields(index)
+        if kind not in _SUPPORTED_KINDS:
+            raise ValueError(f"diagnostic is not supported for '{kind}'.")
+        return build_report(self.diagnostics.gather(kind, name, namespace))
+
+
+def build_report(data: DiagnosticData) -> DiagnosticReport:
+    findings: list[Finding] = []
+
+    if data.replicas is not None:
+        findings.extend(_replica_findings(data.replicas))
+    for pod in data.pods:
+        findings.extend(_pod_findings(pod))
+    findings.extend(_event_findings(data.warning_events))
+
+    # Prioritize: highest severity first, stable within a severity.
+    findings.sort(key=lambda f: f.severity, reverse=True)
+    verdict = max((f.severity for f in findings), default=Severity.OK)
+
+    return DiagnosticReport(
+        kind=data.kind,
+        name=data.name,
+        namespace=data.namespace,
+        verdict=verdict,
+        findings=findings,
+        pods=data.pods,
+        warning_events=data.warning_events,
+    )
+
+
+def _replica_findings(replicas: ReplicaHealth) -> list[Finding]:
+    findings: list[Finding] = []
+    gen = replicas.generation
+    observed = replicas.observed_generation
+    if gen is not None and observed is not None and observed < gen:
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Rollout stalled: observed generation {observed} behind spec generation {gen}",
+            )
+        )
+    if replicas.ready < replicas.desired:
+        severity = (
+            Severity.CRITICAL
+            if replicas.ready == 0 and replicas.desired > 0
+            else Severity.WARNING
+        )
+        findings.append(
+            Finding(
+                severity,
+                f"Only {replicas.ready}/{replicas.desired} replicas ready",
+            )
+        )
+    if replicas.available < replicas.desired:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"{replicas.available}/{replicas.desired} replicas available",
+            )
+        )
+    if replicas.updated < replicas.desired:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Rollout in progress: {replicas.updated}/{replicas.desired} replicas updated",
+            )
+        )
+    return findings
+
+
+def _pod_findings(pod: PodDiagnostic) -> list[Finding]:
+    findings: list[Finding] = []
+
+    for container in pod.containers:
+        findings.extend(_container_findings(pod.name, container))
+
+    if pod.phase == "Pending" and not pod.scheduling.schedulable:
+        detail = pod.scheduling.message or pod.scheduling.reason or "unschedulable"
+        findings.append(
+            Finding(Severity.CRITICAL, f"Pod {pod.name} unschedulable: {detail}")
+        )
+    elif pod.phase == "Pending":
+        findings.append(Finding(Severity.WARNING, f"Pod {pod.name} pending"))
+    elif pod.phase == "Failed":
+        findings.append(Finding(Severity.CRITICAL, f"Pod {pod.name} failed"))
+    elif (
+        pod.phase == "Running"
+        and pod.ready_containers < pod.total_containers
+        and not any(c.waiting_reason for c in pod.containers)
+    ):
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Pod {pod.name}: {pod.ready_containers}/{pod.total_containers} containers ready",
+            )
+        )
+    return findings
+
+
+def _container_findings(pod_name: str, container: ContainerDiagnostic) -> list[Finding]:
+    findings: list[Finding] = []
+    reason = container.waiting_reason
+
+    if reason == "CrashLoopBackOff":
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"CrashLoopBackOff in pod {pod_name} ({container.restart_count} restarts)",
+            )
+        )
+    elif reason in _IMAGE_PULL_REASONS:
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Image pull failure ({reason}) in pod {pod_name}",
+            )
+        )
+    elif reason in _CONFIG_ERROR_REASONS:
+        detail = container.waiting_message or reason
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Container config error in pod {pod_name}: {detail}",
+            )
+        )
+    elif reason is not None:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Container {container.name} in pod {pod_name} waiting: {reason}",
+            )
+        )
+
+    if "OOMKilled" in (container.terminated_reason, container.last_terminated_reason):
+        findings.append(Finding(Severity.CRITICAL, f"OOMKilled in pod {pod_name}"))
+    elif container.terminated_reason not in (None, "Completed") and container.exit_code:
+        findings.append(
+            Finding(
+                Severity.CRITICAL,
+                f"Container {container.name} in pod {pod_name} terminated: "
+                f"{container.terminated_reason} (exit {container.exit_code})",
+            )
+        )
+
+    if reason is None and container.restart_count >= _RESTART_WARN_THRESHOLD:
+        findings.append(
+            Finding(
+                Severity.WARNING,
+                f"Container {container.name} in pod {pod_name} "
+                f"restarted {container.restart_count} times",
+            )
+        )
+    return findings
+
+
+def _event_findings(events) -> list[Finding]:
+    # The message is deliberately omitted: the WARNING EVENTS section renders it
+    # in full, so repeating it here only bloats the summary.
+    return [
+        Finding(
+            Severity.WARNING,
+            f"{event.reason} ×{event.count} on {event.kind}/{event.name}",
+        )
+        for event in events
+    ]

kx_cli-0.0.7/src/kx/commands/edit.py

@@ -0,0 +1,18 @@
+from kx.kubectl import KubectlServiceProtocol
+from kx.refresh import ensure_exists
+from kx.state import StateServiceProtocol
+
+
+class EditCommand:
+    def __init__(self, state: StateServiceProtocol, kubectl: KubectlServiceProtocol):
+        self.state = state
+        self.kubectl = kubectl
+
+    def execute(self, index: int, extra_args: list[str] | None = None) -> None:
+        extra_args = extra_args or []
+        name, namespace, kind = self.state.fields(index)
+        rc = self.kubectl.run_interactive(
+            ["edit", kind, name, "-n", namespace, *extra_args]
+        )
+        if rc != 0:
+            ensure_exists(self.kubectl, kind, name, namespace)

{kx_cli-0.0.5 → kx_cli-0.0.7}/src/kx/commands/events.py

@@ -1,11 +1,19 @@
 from kx.events import EventsServiceProtocol
+from kx.kubectl import KubectlServiceProtocol
+from kx.refresh import ensure_exists
 from kx.state import StateServiceProtocol
 
 
 class EventsCommand:
-    def __init__(self, state: StateServiceProtocol, events: EventsServiceProtocol):
+    def __init__(
+        self,
+        state: StateServiceProtocol,
+        events: EventsServiceProtocol,
+        kubectl: KubectlServiceProtocol,
+    ):
         self.state = state
         self.events = events
+        self.kubectl = kubectl
 
     def execute(self, index: int) -> str:
         name, namespace, kind = self.state.fields(index)
@@ -13,6 +21,9 @@ class EventsCommand:
         filtered = self.events.filter(all_events, name, kind)
 
         if not filtered:
+            # Deleted resources keep their events ~1h; only an empty result
+            # warrants checking whether the target itself is gone.
+            ensure_exists(self.kubectl, kind, name, namespace)
             return "No events found"
 
         output = []

{kx_cli-0.0.5 → kx_cli-0.0.7}/src/kx/commands/exec.py

@@ -2,6 +2,7 @@ import subprocess
 
 from kx.kinds import Kind
 from kx.kubectl import KubectlServiceProtocol
+from kx.refresh import ensure_exists
 from kx.state import StateServiceProtocol
 
 
@@ -17,8 +18,9 @@ class ExecCommand:
         self.shells = shells
 
     def execute(
-        self, index: int, cmd: list[str] | None, extra_args: list[str] = []
+        self, index: int, cmd: list[str] | None, extra_args: list[str] | None = None
     ) -> None:
+        extra_args = extra_args or []
         name, namespace, kind = self.state.fields(index)
         if kind != Kind.Pod:
             raise ValueError("exec is only supported for pods.")
@@ -28,6 +30,7 @@ class ExecCommand:
                 stderr=subprocess.DEVNULL,
             )
             if rc != 0:
+                ensure_exists(self.kubectl, str(Kind.Pod), name, namespace)
                 raise ValueError(f"Command failed in container (exit {rc}).")
         else:
             for shell in self.shells:
@@ -49,6 +52,7 @@ class ExecCommand:
                         ["exec", "-it", name, "-n", namespace, *extra_args, "--", shell]
                     )
                     return
+            ensure_exists(self.kubectl, str(Kind.Pod), name, namespace)
             raise ValueError(
                 "No shell found in container. Provide an explicit command: kx exec <index> -- /path/to/binary"
             )