From a03a6f522df3bbfeb977a280a26e6fa827f5c438 Mon Sep 17 00:00:00 2001 From: Phil Leggetter Date: Tue, 4 Aug 2026 20:55:52 +0100 Subject: [PATCH] docs: add KNOWN_ISSUES.md with listen session-expiry entry Documents the hookdeck listen CLI_UNAVAILABLE session-expiry issue, the recommended upgrade to v2.3.2, and the restart workaround. Tracks #323. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01UQV9qtvETd62qg2iDRR6kY --- KNOWN_ISSUES.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 KNOWN_ISSUES.md diff --git a/KNOWN_ISSUES.md b/KNOWN_ISSUES.md new file mode 100644 index 0000000..c1ec915 --- /dev/null +++ b/KNOWN_ISSUES.md @@ -0,0 +1,19 @@ +# Known Issues + +## `hookdeck listen` can stop delivering events after an extended disconnect + +**Symptom:** `hookdeck listen` appears connected but events stop arriving; the Hookdeck +dashboard shows delivery attempts failing with `CLI_UNAVAILABLE`. + +**Why:** A CLI session can expire server-side (for example after your machine has been asleep +or offline for a while). Affected CLI versions don't automatically re-establish it. + +**Recommended fix:** Update to **v2.3.2 or later** — newer versions recover automatically. + +- npm: `npm install -g hookdeck-cli@latest` +- Homebrew: `brew upgrade hookdeck` + +**Workaround (until you update):** Stop (`Ctrl+C`) and restart `hookdeck listen`. This creates +a fresh session and delivery resumes. Logging out / logging in is not required. + +**Tracking:** #323