From 541318c8f0747c1784cae9e429ea7120316961ca Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Wed, 13 May 2026 20:02:41 -0500
Subject: fix(telega): don't auto-install at init; let MELPA staleness slide

The use-package form defaulted to `:ensure t`, which made init crash when MELPA's archive index pointed at a dated snapshot tarball (`telega-20260503.1332.tar`) that had already rotated off the server -- the install fetch hit a 404 and took the whole startup down with a `file-error`.

Switched to `:ensure nil` so the module configures telega without trying to install it. The `:commands telega` autoload stub still wires `C-; G`; pressing it before the package is installed signals a void-function instead. Commentary now documents the one-time install (`M-x package-refresh-contents` + `M-x package-install RET telega`).
---
 modules/telega-config.el | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/modules/telega-config.el b/modules/telega-config.el
index aada717f..003fa15d 100644
--- a/modules/telega-config.el
+++ b/modules/telega-config.el
@@ -16,6 +16,20 @@
 ;; interactive and happens inside `M-x telega'.  This module does not
 ;; script it.
 ;;
+;; Install:
+;;
+;;   M-x package-refresh-contents
+;;   M-x package-install RET telega
+;;
+;; The refresh is important.  MELPA rotates dated snapshot tarballs out
+;; from under the cached archive index periodically, so if the local
+;; archive-contents file points at a snapshot that no longer exists on
+;; the server the install fails with a 404.  Refreshing pulls a current
+;; index.  This module deliberately sets `:ensure nil' so a stale
+;; archive doesn't take Emacs init down at startup; if the package
+;; isn't installed yet, `C-; G' will signal a void-function until the
+;; install runs once.
+;;
 ;; Launcher: =C-; G= (mnemonic: teleGram).  Neither =C-; t= (test-runner
 ;; menu) nor =C-; m t= (music "repeat track") were available, so the
 ;; launcher lives at a free top-level letter rather than under a
@@ -27,6 +41,7 @@
 
 (use-package telega
   :defer t
+  :ensure nil
   :commands (telega)
   :custom
   (telega-use-docker t))
-- 
cgit v1.2.3