v0.1.3

A safe, evidence-based doctor for Kubernetes resources stuck in Terminating.
It pinpoints the finalizer and the dead controller / APIService blocking
deletion, cleans truly-orphaned resources first, and clears finalizers only as
a gated last resort — dry-run by default.

Highlights

• 🩺 Diagnose any finalizer-blocked resource — namespaces, CRs, PVs, arbitrary CRDs.
• ⚖️ Evidence-based verdict (strict default, score opt-in) — clears only on hard proof the owner is dead; a live or unreadable signal vetoes it, and time alone never does.
• 🧹 Safe ordering — clean true orphans first, refuse on a dead-backed failurePolicy=Fail webhook, clear the finalizer last.
• 🔒 Proof-bound apply — --confirm digest + per-action re-verify + resourceVersion preconditions + RBAC pre-flight.
• 📦 Homebrew, krew, or static binaries — kubectl finalizer-doctor (alias kubectl fid).

Install

brew install alexremn/tap/finalizer-doctor
# or download a binary from the assets below

⚠️ Clearing a finalizer is irreversible. This tool exists to make that decision
safely — read the safety model first.

---

Full Changelog: v0.1.2...v0.1.3

v0.1.2

A safe, evidence-based doctor for Kubernetes resources stuck in Terminating.
It pinpoints the finalizer and the dead controller / APIService blocking
deletion, cleans truly-orphaned resources first, and clears finalizers only as
a gated last resort — dry-run by default.

Highlights

• 🩺 Diagnose any finalizer-blocked resource — namespaces, CRs, PVs, arbitrary CRDs.
• ⚖️ Evidence-based verdict (strict default, score opt-in) — clears only on hard proof the owner is dead; a live or unreadable signal vetoes it, and time alone never does.
• 🧹 Safe ordering — clean true orphans first, refuse on a dead-backed failurePolicy=Fail webhook, clear the finalizer last.
• 🔒 Proof-bound apply — --confirm digest + per-action re-verify + resourceVersion preconditions + RBAC pre-flight.
• 📦 Homebrew, krew, or static binaries — kubectl finalizer-doctor (alias kubectl fid).

Install

brew install alexremn/tap/finalizer-doctor
# or download a binary from the assets below

⚠️ Clearing a finalizer is irreversible. This tool exists to make that decision
safely — read the safety model first.

---

Full Changelog: v0.1.1...v0.1.2

v0.1.1

A safe, evidence-based doctor for Kubernetes resources stuck in Terminating.
It pinpoints the finalizer and the dead controller / APIService blocking
deletion, cleans truly-orphaned resources first, and clears finalizers only as
a gated last resort — dry-run by default.

Highlights

• 🩺 Diagnose any finalizer-blocked resource — namespaces, CRs, PVs, arbitrary CRDs.
• ⚖️ Evidence-based verdict (strict default, score opt-in) — clears only on hard proof the owner is dead; a live or unreadable signal vetoes it, and time alone never does.
• 🧹 Safe ordering — clean true orphans first, refuse on a dead-backed failurePolicy=Fail webhook, clear the finalizer last.
• 🔒 Proof-bound apply — --confirm digest + per-action re-verify + resourceVersion preconditions + RBAC pre-flight.
• 📦 Homebrew, krew, or static binaries — kubectl finalizer-doctor (alias kubectl fid).

Install

brew install alexremn/tap/finalizer-doctor
# or download a binary from the assets below

⚠️ Clearing a finalizer is irreversible. This tool exists to make that decision
safely — read the safety model first.

---

Full Changelog: v0.1.0...v0.1.1

v0.1.0

A safe, evidence-based doctor for Kubernetes resources stuck in Terminating.
It pinpoints the finalizer and the dead controller / APIService blocking
deletion, cleans truly-orphaned resources first, and clears finalizers only as
a gated last resort — dry-run by default.

Highlights

• 🩺 Diagnose any finalizer-blocked resource — namespaces, CRs, PVs, arbitrary CRDs.
• ⚖️ Evidence-based verdict (strict default, score opt-in) — clears only on hard proof the owner is dead; a live or unreadable signal vetoes it, and time alone never does.
• 🧹 Safe ordering — clean true orphans first, refuse on a dead-backed failurePolicy=Fail webhook, clear the finalizer last.
• 🔒 Proof-bound apply — --confirm digest + per-action re-verify + resourceVersion preconditions + RBAC pre-flight.
• 📦 Homebrew, krew, or static binaries — kubectl finalizer-doctor (alias kubectl fid).

Install

brew install alexremn/tap/finalizer-doctor
# or download a binary from the assets below

⚠️ Clearing a finalizer is irreversible. This tool exists to make that decision safely — read the safety model first.

---

Full changelog: https://github.com/alexremn/finalizer-doctor/commits/v0.1.0