newsline-cli 0.1.1 → 0.1.3

package/README.md

@@ -1,86 +1,56 @@
-# newsline
+<div align="center">
 
-Locale-aware one-line news in your Claude Code status line — **fully local**, and it
-**composes with your existing status line** (e.g. an HUD) instead of replacing it.
+**English** · [한국어](readme/ko.md) · [日本語](readme/ja.md) · [Español](readme/es.md) · [Français](readme/fr.md) · [Deutsch](readme/de.md) · [Português](readme/pt.md) · [中文](readme/zh.md)
 
-**English** · [한국어](readme/ko.md)
+</div>
 
-## What it is
+# newsline
 
-A Claude Code status-line utility that shows a rotating, region-appropriate news
-headline at the bottom of your session. Everything runs locally on your machine —
-locale detection, feed fetch, parsing, caching, rendering. It never reads your code,
-prompts, files, or Claude conversations.
+**Waiting for Claude Code to finish? Read the latest one-line news right in your status line.**
+A rotating regional headline sits at the bottom of your session — so a long wait turns into a
+quick news check. It shows *below* your existing status line (your HUD stays).
 
-## Install
+## Install & run — one line
 
-**curl | sh** (macOS / Linux / WSL):
 ```sh
+# curl (macOS / Linux / WSL) — installs and sets up right away
 curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
-```
 
-**Homebrew:**
-```sh
-brew install itdar/tap/newsline
-```
+# Homebrew
+brew install itdar/tap/newsline && newsline init
 
-**From source:**
-```sh
-git clone https://github.com/itdar/cc-plugin && cd cc-plugin && ./install.sh
+# npm
+npm i -g newsline-cli && newsline init
 ```
 
-The **curl | sh** installer runs setup automatically — it prompts you for a language and
-topic, then wires the status line. For **Homebrew** or **from source**, run setup yourself:
-```sh
-newsline init
-```
-`init` asks for a language and topic (a menu — just pick a number), then registers the
-status line, **keeping whatever status line you already have** (your HUD stays visible,
-news shows on the line below). It appears on your next message to Claude — Claude Code
-hot-reloads settings, so no restart is needed.
+The news line appears on your **next message** — no restart. Setup asks for a language & topic
+and keeps your existing status line.
+
+## What it does
 
-_(Skip auto-setup during install with `NEWSLINE_NO_INIT=1`.)_
+- **Your machine fetches and shows the news** — it never touches your code, prompts, files, or
+  Claude conversations.
+- A small **edge service** picks the best regional sources and routes headline clicks, so sources
+  stay fresh without reinstalling. If it's unreachable, newsline **falls back to built-in feeds**.
+- The status line is instant (served from a cache); refreshes run in the background.
 
 ## Configure
 
-Choose during `newsline init`, or edit `~/.config/newsline/config.json` (or set the env var):
+Re-run `newsline init`, or edit `~/.config/newsline/config.json`:
 
-| Key / env var | Default | Meaning |
+| Key | Default | Meaning |
 |---|---|---|
-| `lang` / `NEWSLINE_LANG` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`, or `auto` |
-| `topic` / `NEWSLINE_TOPIC` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
-| `rotate` / `NEWSLINE_ROTATE` | `6` | seconds per headline |
-| `count` / `NEWSLINE_COUNT` | `15` | headlines cached for rotation |
-| `maxlen` / `NEWSLINE_MAXLEN` | `120` | max chars; `max` = no truncation; `NN%` ≈ of terminal width |
-| `icon` / `NEWSLINE_ICON` | `📰` | leading glyph; `none` to remove |
-| `linkhint` / `NEWSLINE_LINKHINT` | off | append a `↗` "opens externally" hint |
-| `api` / `NEWSLINE_API` | — | optional curation API (server-first, local fallback) |
-| `endpoint` / `NEWSLINE_ENDPOINT` | — | click-redirect wrapper |
-
-## How it works
-
-- **`newsline render`** (what the status line runs) prints instantly from cache and never
-  blocks; it kicks off a background refresh when the cache is stale.
-- **`newsline refresh`** fetches a keyless regional RSS/Atom feed locally, parses the top
-  headlines, dedupes, and caches them.
-- Headlines are clickable [OSC 8] links. Whether a plain click vs `Cmd`/`Ctrl`+click opens
-  them is decided by your terminal, not by newsline.
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`, or `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | seconds per headline |
+| `count` | `15` | headlines in rotation |
+| `maxlen` | `120` | max characters (`max` = no cut) |
+| `icon` | `📰` | leading glyph (`none` to hide) |
 
 ## Uninstall
 
 ```sh
-newsline uninstall      # removes the wiring and restores your previous status line
+newsline uninstall      # restores your previous status line
 ```
 
-## Privacy
-
-Runs locally; detects locale from your system settings (no IP geolocation); fetches public
-feeds directly; never accesses your code, prompts, files, or Claude conversations. Clicks
-pass through a redirect so the project can measure engagement and, in future, use affiliate
-links to fund itself — disclosed here.
-
-## Requirements
-
-`bash`, `python3`. macOS and Linux natively; Windows via WSL or Git Bash.
-
-[OSC 8]: https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
+Needs `bash` + `python3` (macOS / Linux; Windows via WSL).

package/feeds.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "locale language -> ordered keyless RSS/Atom feeds. National outlet first (in-language, higher quality), Google News locale feed last as a guaranteed fallback. fetch.py tries each in order; the first that yields an item wins, so a dead/blocked feed is skipped gracefully. All URLs here were reachability-validated. When adding feeds, also add the article-link domain to ../server/allowlist.json.",
+  "_comment": "locale language -> ordered keyless RSS/Atom feeds. National outlet first (in-language, higher quality), Google News locale feed last as a guaranteed fallback. fetch.py tries each in order; the first that yields an item wins, so a dead/blocked feed is skipped gracefully. All URLs here were reachability-validated. When adding feeds, also add the article-link domain to the server allowlist (cc-server/worker.js allowlistCfg).",
   "en": [
     "https://feeds.bbci.co.uk/news/rss.xml",
     "https://feeds.npr.org/1001/rss.xml",

package/newsline

@@ -40,6 +40,15 @@ v=d.get(sys.argv[2])
 print("" if v is None else v)
 PY
 }
+cfg_get_obj() { # cfg_get_obj <key> — print an object-valued config key as JSON
+  python3 - "$CONFIG" "$1" <<'PY' 2>/dev/null
+import json,sys
+try: d=json.load(open(sys.argv[1]))
+except Exception: d={}
+v=d.get(sys.argv[2])
+print(json.dumps(v,ensure_ascii=False) if isinstance(v,dict) else "")
+PY
+}
 settings_statusline_cmd() { # print current statusLine.command of a settings file
   python3 - "$1" <<'PY' 2>/dev/null
 import json,sys
@@ -49,22 +58,37 @@ sl=d.get("statusLine")
 print(sl.get("command","") if isinstance(sl,dict) else "")
 PY
 }
+settings_statusline_json() { # print the whole statusLine object of a settings file
+  python3 - "$1" <<'PY' 2>/dev/null
+import json,sys
+try: d=json.load(open(sys.argv[1]))
+except Exception: d={}
+sl=d.get("statusLine")
+print(json.dumps(sl,ensure_ascii=False) if isinstance(sl,dict) and sl.get("command") else "")
+PY
+}
 
+# One python spawn for the whole config (render runs on every status-line tick;
+# per-key cfg_get calls here would cost ~10 interpreter startups per tick).
 load_config() {
   [ -f "$CONFIG" ] || return 0
-  local lang topic rotate count api endpoint maxlen icon linkhint
-  lang=$(cfg_get lang);   topic=$(cfg_get topic);   rotate=$(cfg_get rotate)
-  count=$(cfg_get count); api=$(cfg_get api);       endpoint=$(cfg_get endpoint)
-  maxlen=$(cfg_get maxlen); icon=$(cfg_get icon);   linkhint=$(cfg_get linkhint)
-  [ -n "$lang" ] && [ "$lang" != "auto" ] && export NEWSLINE_LANG="$lang"
-  [ -n "$topic" ]    && export NEWSLINE_TOPIC="$topic"
-  [ -n "$rotate" ]   && export NEWSLINE_ROTATE="$rotate"
-  [ -n "$count" ]    && export NEWSLINE_COUNT="$count"
-  [ -n "$maxlen" ]   && export NEWSLINE_MAXLEN="$maxlen"
-  [ -n "$icon" ]     && export NEWSLINE_ICON="$icon"
-  [ -n "$linkhint" ] && export NEWSLINE_LINKHINT="$linkhint"
-  [ -n "$api" ]      && export NEWSLINE_API="$api"
-  [ -n "$endpoint" ] && export NEWSLINE_ENDPOINT="$endpoint"
+  local exports
+  exports=$(python3 - "$CONFIG" <<'PY' 2>/dev/null
+import json,sys,shlex
+env={"lang":"NEWSLINE_LANG","topic":"NEWSLINE_TOPIC","rotate":"NEWSLINE_ROTATE",
+     "count":"NEWSLINE_COUNT","maxlen":"NEWSLINE_MAXLEN","icon":"NEWSLINE_ICON",
+     "linkhint":"NEWSLINE_LINKHINT","api":"NEWSLINE_API","endpoint":"NEWSLINE_ENDPOINT",
+     "base_statusline":"NEWSLINE_BASE"}
+try: d=json.load(open(sys.argv[1]))
+except Exception: d={}
+for k,name in env.items():
+    v=d.get(k)
+    if v is None or v=="": continue
+    if k=="lang" and v=="auto": continue
+    print("export %s=%s" % (name, shlex.quote(str(v))))
+PY
+)
+  [ -n "$exports" ] && eval "$exports"
 }
 
 detect_lang() {
@@ -110,11 +134,10 @@ choose() {
 # ---- subcommands ----
 cmd_render() { # base (existing HUD) first, newsline below — never blocks
   load_config
-  local base input=""
-  base=$(cfg_get base_statusline)
+  local input=""
   [ -t 0 ] || input=$(cat 2>/dev/null)     # consume the session JSON if piped
-  if [ -n "$base" ]; then
-    printf '%s' "$input" | eval "$base" 2>/dev/null   # your HUD, unchanged
+  if [ -n "${NEWSLINE_BASE:-}" ]; then
+    printf '%s' "$input" | eval "$NEWSLINE_BASE" 2>/dev/null   # your HUD, unchanged
     printf '\n'
   fi
   "$HERE/statusline.sh"                                # the news line, below
@@ -172,60 +195,104 @@ cmd_init() {
 
   # Always KEEP an existing status line and show newsline below it (no prompt).
   # Only --no-compose (or an explicit --base) changes this.
-  local existing base=""
+  local existing base="" base_obj=""
   if [ -n "$base_override" ]; then
     base="$base_override"                       # caller supplied the base explicitly
   elif [ "$compose" != "no" ]; then
     existing=$(settings_statusline_cmd "$SETTINGS")
     if [ -n "$existing" ] && ! printf '%s' "$existing" | grep -q "newsline"; then
       base="$existing"                          # first run: capture the real status line
+      base_obj=$(settings_statusline_json "$SETTINGS")   # verbatim, for uninstall
     else
       base=$(cfg_get base_statusline)           # re-init: KEEP the base we already saved
+      base_obj=$(cfg_get_obj base_statusline_obj)
     fi
   fi
 
   mkdir -p "$CONFIG_DIR"
-  python3 - "$CONFIG" "$lang" "$topic" "$rotate" "$count" "$api" "$endpoint" "$base" <<'PY'
-import json,sys
-_,path,lang,topic,rotate,count,api,endpoint,base=sys.argv
-d={"lang":lang,"topic":topic,"rotate":int(rotate),"count":int(count)}
+  python3 - "$CONFIG" "$lang" "$topic" "$rotate" "$count" "$api" "$endpoint" "$base" "$base_obj" <<'PY' || { echo "✗ could not write $CONFIG" >&2; return 1; }
+import json,os,sys
+_,path,lang,topic,rotate,count,api,endpoint,base,base_obj=sys.argv
+try:
+    d={"lang":lang,"topic":topic,"rotate":int(rotate),"count":int(count)}
+except ValueError:
+    sys.stderr.write("newsline: --rotate/--count must be integers\n"); sys.exit(3)
 if api: d["api"]=api
 if endpoint: d["endpoint"]=endpoint
 if base: d["base_statusline"]=base
-json.dump(d,open(path,"w"),indent=2,ensure_ascii=False)
+if base_obj:
+    try: d["base_statusline_obj"]=json.loads(base_obj)
+    except Exception: pass
+tmp=path+".tmp"
+with open(tmp,"w") as f: json.dump(d,f,indent=2,ensure_ascii=False)
+os.replace(tmp,path)
 PY
 
-  python3 - "$SETTINGS" "$RENDER_CMD" <<'PY'
+  python3 - "$SETTINGS" "$RENDER_CMD" <<'PY' || { echo "✗ could not update $SETTINGS — fix the file and re-run: newsline init" >&2; return 1; }
 import json,os,sys
 path,cmd=sys.argv[1],sys.argv[2]
-try: d=json.load(open(path))
-except Exception: d={}
+d={}
+if os.path.exists(path):
+    try:
+        with open(path) as f: raw=f.read().strip()
+        d=json.loads(raw) if raw else {}
+        if not isinstance(d,dict): raise ValueError("settings root is not an object")
+    except Exception:
+        # never clobber a settings file we can't parse
+        sys.stderr.write("newsline: %s is not valid JSON; refusing to modify it\n" % path)
+        sys.exit(3)
 d["statusLine"]={"type":"command","command":cmd,"refreshInterval":5}
 os.makedirs(os.path.dirname(path) or ".",exist_ok=True)
-json.dump(d,open(path,"w"),indent=2,ensure_ascii=False)
+tmp=path+".tmp"
+with open(tmp,"w") as f: json.dump(d,f,indent=2,ensure_ascii=False)
+os.replace(tmp,path)
 PY
 
+  # apply the new language/topic on the next render, not after the old cache expires
+  local cache="${NEWSLINE_CACHE:-$HOME/.cache/newsline}"
+  rm -f "$cache/line" "$cache/feeds.resolved.json" "$cache/feeds.resolved.ok" "$cache/notice" 2>/dev/null
+
   echo "✔ newsline installed (lang=$lang, topic=$topic)."
   [ -n "$base" ] && echo "  composing with your existing status line — it stays visible above the news."
   echo "  It appears on your next message to Claude — no restart needed."
 }
 
 cmd_uninstall() {
-  local base; base=$(cfg_get base_statusline)
-  python3 - "$SETTINGS" "$base" <<'PY'
-import json,sys
-path,base=sys.argv[1],sys.argv[2]
-try: d=json.load(open(path))
-except Exception: d={}
+  local base base_obj
+  base=$(cfg_get base_statusline)
+  base_obj=$(cfg_get_obj base_statusline_obj)
+  python3 - "$SETTINGS" "$base" "$base_obj" <<'PY'
+import json,os,sys
+path,base,base_obj=sys.argv[1],sys.argv[2],sys.argv[3]
+try:
+    with open(path) as f: raw=f.read().strip()
+    d=json.loads(raw) if raw else {}
+    if not isinstance(d,dict): raise ValueError("settings root is not an object")
+except FileNotFoundError:
+    print("no settings file; nothing to revert"); sys.exit(0)
+except Exception:
+    print("settings file is not valid JSON; left as-is"); sys.exit(0)
 sl=d.get("statusLine"); cmd=sl.get("command","") if isinstance(sl,dict) else ""
 if "newsline" in cmd:
-    if base: d["statusLine"]={"type":"command","command":base}
-    else: d.pop("statusLine",None)
-    json.dump(d,open(path,"w"),indent=2,ensure_ascii=False); print("reverted status line")
+    obj=None
+    if base_obj:
+        try: obj=json.loads(base_obj)
+        except Exception: obj=None
+    if isinstance(obj,dict) and obj.get("command"):
+        d["statusLine"]=obj                    # full original (keeps padding etc.)
+    elif base:
+        d["statusLine"]={"type":"command","command":base}
+    else:
+        d.pop("statusLine",None)
+    tmp=path+".tmp"
+    with open(tmp,"w") as f: json.dump(d,f,indent=2,ensure_ascii=False)
+    os.replace(tmp,path)
+    print("reverted status line")
 else:
     print("status line not managed by newsline; left as-is")
 PY
-  rm -f "$CONFIG" 2>/dev/null
+  local cache="${NEWSLINE_CACHE:-$HOME/.cache/newsline}"
+  rm -f "$CONFIG" "$cache/line" "$cache/feeds.resolved.json" "$cache/feeds.resolved.ok" "$cache/notice" 2>/dev/null
   echo "✔ newsline uninstalled."
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newsline-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Locale-aware one-line news in your Claude Code status line — local, composes with your existing status line.",
   "bin": {
     "newsline": "newsline"

package/readme/de.md

@@ -0,0 +1,58 @@
+<div align="center">
+
+[English](../README.md) · [한국어](ko.md) · [日本語](ja.md) · [Español](es.md) · [Français](fr.md) · **Deutsch** · [Português](pt.md) · [中文](zh.md)
+
+</div>
+
+# newsline
+
+**Wartest du darauf, dass Claude Code fertig wird? Lies die neuesten Ein-Zeilen-News direkt in deiner Statusleiste.**
+Eine rotierende regionale Schlagzeile sitzt am unteren Rand deiner Sitzung – so wird aus langem Warten
+ein schneller Blick in die Nachrichten. Sie erscheint *unter* deiner bestehenden Statusleiste (dein HUD
+bleibt erhalten).
+
+## Installieren & starten — eine Zeile
+
+```sh
+# curl (macOS / Linux / WSL) — installiert und richtet sofort ein
+curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
+
+# Homebrew
+brew install itdar/tap/newsline && newsline init
+
+# npm
+npm i -g newsline-cli && newsline init
+```
+
+Die News-Zeile erscheint bei deiner **nächsten Nachricht** – kein Neustart nötig. Die Einrichtung fragt
+nach Sprache und Thema und behält deine bestehende Statusleiste bei.
+
+## Was es macht
+
+- **Dein Rechner holt und zeigt die Nachrichten** – er rührt niemals deinen Code, deine Prompts, Dateien
+  oder Claude-Unterhaltungen an.
+- Ein kleiner **Edge-Dienst** wählt die besten regionalen Quellen aus und leitet Klicks auf Schlagzeilen
+  weiter, sodass die Quellen ohne Neuinstallation aktuell bleiben. Ist er nicht erreichbar, **greift
+  newsline auf die integrierten Feeds zurück**.
+- Die Statusleiste ist sofort da (aus einem Cache); Aktualisierungen laufen im Hintergrund.
+
+## Konfigurieren
+
+Führe `newsline init` erneut aus oder bearbeite `~/.config/newsline/config.json`:
+
+| Schlüssel | Standard | Bedeutung |
+|---|---|---|
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh` oder `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | Sekunden pro Schlagzeile |
+| `count` | `15` | Schlagzeilen im Wechsel |
+| `maxlen` | `120` | maximale Zeichen (`max` = kein Abschneiden) |
+| `icon` | `📰` | vorangestelltes Symbol (`none` zum Ausblenden) |
+
+## Deinstallieren
+
+```sh
+newsline uninstall      # stellt deine vorherige Statusleiste wieder her
+```
+
+Benötigt `bash` + `python3` (macOS / Linux; Windows über WSL).

package/readme/es.md

@@ -0,0 +1,58 @@
+<div align="center">
+
+[English](../README.md) · [한국어](ko.md) · [日本語](ja.md) · **Español** · [Français](fr.md) · [Deutsch](de.md) · [Português](pt.md) · [中文](zh.md)
+
+</div>
+
+# newsline
+
+**¿Esperando a que Claude Code termine? Lee las últimas noticias en una línea, justo en tu barra de estado.**
+Un titular regional rotativo aparece en la parte inferior de tu sesión, así una larga espera se convierte
+en un vistazo rápido a las noticias. Se muestra *debajo* de tu barra de estado actual (tu HUD se mantiene).
+
+## Instalar y ejecutar — una línea
+
+```sh
+# curl (macOS / Linux / WSL) — instala y configura al instante
+curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
+
+# Homebrew
+brew install itdar/tap/newsline && newsline init
+
+# npm
+npm i -g newsline-cli && newsline init
+```
+
+La línea de noticias aparece en tu **próximo mensaje**, sin reiniciar. La configuración te pregunta el
+idioma y el tema, y conserva tu barra de estado actual.
+
+## Qué hace
+
+- **Tu equipo obtiene y muestra las noticias** — nunca toca tu código, prompts, archivos ni
+  conversaciones con Claude.
+- Un pequeño **servicio edge** elige las mejores fuentes regionales y enruta los clics en los titulares,
+  de modo que las fuentes se mantienen actualizadas sin reinstalar. Si no está disponible, newsline
+  **recurre a los feeds integrados**.
+- La barra de estado es instantánea (servida desde una caché); las actualizaciones se ejecutan en
+  segundo plano.
+
+## Configurar
+
+Vuelve a ejecutar `newsline init` o edita `~/.config/newsline/config.json`:
+
+| Clave | Predeterminado | Significado |
+|---|---|---|
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`, o `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | segundos por titular |
+| `count` | `15` | titulares en rotación |
+| `maxlen` | `120` | caracteres máximos (`max` = sin recorte) |
+| `icon` | `📰` | icono inicial (`none` para ocultarlo) |
+
+## Desinstalar
+
+```sh
+newsline uninstall      # restaura tu barra de estado anterior
+```
+
+Necesita `bash` + `python3` (macOS / Linux; Windows mediante WSL).

package/readme/fr.md

@@ -0,0 +1,58 @@
+<div align="center">
+
+[English](../README.md) · [한국어](ko.md) · [日本語](ja.md) · [Español](es.md) · **Français** · [Deutsch](de.md) · [Português](pt.md) · [中文](zh.md)
+
+</div>
+
+# newsline
+
+**En attendant que Claude Code termine ? Lisez l'actualité en une ligne, directement dans votre barre d'état.**
+Un titre régional défile en bas de votre session : une longue attente se transforme en un coup d'œil
+rapide à l'actualité. Il s'affiche *sous* votre barre d'état existante (votre HUD reste en place).
+
+## Installer et lancer — une ligne
+
+```sh
+# curl (macOS / Linux / WSL) — installe et configure immédiatement
+curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
+
+# Homebrew
+brew install itdar/tap/newsline && newsline init
+
+# npm
+npm i -g newsline-cli && newsline init
+```
+
+La ligne d'actualité apparaît dès votre **prochain message** — sans redémarrage. La configuration vous
+demande une langue et un thème, et conserve votre barre d'état existante.
+
+## Ce que ça fait
+
+- **Votre machine récupère et affiche l'actualité** — elle ne touche jamais à votre code, vos prompts,
+  vos fichiers ni vos conversations avec Claude.
+- Un petit **service edge** sélectionne les meilleures sources régionales et route les clics sur les
+  titres, afin que les sources restent à jour sans réinstallation. S'il est injoignable, newsline
+  **bascule sur les flux intégrés**.
+- La barre d'état est instantanée (servie depuis un cache) ; les rafraîchissements s'exécutent en
+  arrière-plan.
+
+## Configurer
+
+Relancez `newsline init`, ou modifiez `~/.config/newsline/config.json` :
+
+| Clé | Par défaut | Signification |
+|---|---|---|
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`, ou `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | secondes par titre |
+| `count` | `15` | titres en rotation |
+| `maxlen` | `120` | caractères maximum (`max` = sans coupure) |
+| `icon` | `📰` | icône de tête (`none` pour masquer) |
+
+## Désinstaller
+
+```sh
+newsline uninstall      # restaure votre barre d'état précédente
+```
+
+Nécessite `bash` + `python3` (macOS / Linux ; Windows via WSL).

package/readme/ja.md

@@ -0,0 +1,57 @@
+<div align="center">
+
+[English](../README.md) · [한국어](ko.md) · **日本語** · [Español](es.md) · [Français](fr.md) · [Deutsch](de.md) · [Português](pt.md) · [中文](zh.md)
+
+</div>
+
+# newsline
+
+**Claude Code の処理が終わるのを待っていますか？最新のひとことニュースをステータスラインで読みましょう。**
+地域のヘッドラインがセッション下部で切り替わり表示され、長い待ち時間がサッとニュースをチェックする
+時間に変わります。既存のステータスライン（HUD）の **下の行に** 表示されるので、HUD はそのまま残ります。
+
+## インストールと実行 — 一行で
+
+```sh
+# curl (macOS / Linux / WSL) — インストールとセットアップを一気に
+curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
+
+# Homebrew
+brew install itdar/tap/newsline && newsline init
+
+# npm
+npm i -g newsline-cli && newsline init
+```
+
+ニュース行は **次のメッセージ** で表示されます — 再起動は不要です。セットアップで言語とトピックを
+尋ね、既存のステータスラインはそのまま保持します。
+
+## 何をするか
+
+- **ニュースの取得と表示はあなたのマシン上で** 行われます — コード・プロンプト・ファイル・Claude との
+  会話には一切触れません。
+- 小さな **エッジサービス** が地域に最適なソースを選び、ヘッドラインのクリックをルーティングします。
+  おかげで再インストールなしでソースが最新に保たれ、エッジに接続できない場合は **内蔵フィードに自動
+  フォールバック** します。
+- ステータスラインはキャッシュから **即座に** 表示され、更新はバックグラウンドで実行されます。
+
+## 設定
+
+`newsline init` を再実行するか、`~/.config/newsline/config.json` を編集します:
+
+| キー | 既定値 | 意味 |
+|---|---|---|
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`、または `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | ヘッドラインごとの表示秒数 |
+| `count` | `15` | 切り替えるヘッドライン数 |
+| `maxlen` | `120` | 最大文字数（`max` = 無制限） |
+| `icon` | `📰` | 先頭アイコン（`none` で非表示） |
+
+## アンインストール
+
+```sh
+newsline uninstall      # 以前のステータスラインを復元します
+```
+
+`bash` と `python3` が必要です（macOS / Linux、Windows は WSL 経由）。

package/readme/ko.md

@@ -1,83 +1,55 @@
-# newsline
+<div align="center">
 
-Claude Code 상태줄에 지역·언어에 맞는 뉴스 한 줄 — **완전 로컬**, 그리고 기존 상태줄(예: HUD)을
-**덮지 않고 그 아래에 붙입니다(compose)**.
+[English](../README.md) · **한국어** · [日本語](ja.md) · [Español](es.md) · [Français](fr.md) · [Deutsch](de.md) · [Português](pt.md) · [中文](zh.md)
 
-[English](../README.md) · **한국어**
+</div>
 
-## 무엇인가
+# newsline
 
-세션 하단에 지역 언어 뉴스 헤드라인을 **회전 표시**하는 Claude Code 상태줄 유틸리티입니다.
-로케일 감지·피드 수집·파싱·캐시·렌더링 전부 **로컬에서** 돌아갑니다. 코드·프롬프트·파일·Claude
-대화는 절대 읽지 않습니다.
+**Claude Code 작업 끝나길 기다리는 동안, 상태줄에서 최신 한줄 뉴스를 확인하세요.**
+긴 작업을 기다리는 시간이 뉴스 한 번 훑는 시간이 됩니다 — 세션 하단에 지역 맞춤 헤드라인이
+회전 표시됩니다. 기존 상태줄(HUD) **아래 줄에** 붙어서, HUD는 그대로 보입니다.
 
-## 설치
+## 설치 & 실행 — 한 줄
 
-**curl | sh** (macOS / Linux / WSL):
 ```sh
+# curl (macOS / Linux / WSL) — 설치 + 셋업까지 바로
 curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
-```
 
-**Homebrew:**
-```sh
-brew install itdar/tap/newsline
-```
+# Homebrew
+brew install itdar/tap/newsline && newsline init
 
-**소스에서:**
-```sh
-git clone https://github.com/itdar/cc-plugin && cd cc-plugin && ./install.sh
+# npm
+npm i -g newsline-cli && newsline init
 ```
 
-**curl | sh** 설치는 셋업까지 **자동**입니다 — 언어·분야를 물어본 뒤 상태줄을 연결해요.
-**Homebrew**나 **소스** 설치는 직접 실행:
-```sh
-newsline init
-```
-`init`이 언어·분야를 물어보고(메뉴에서 번호 선택), 상태줄을 등록합니다. **기존 상태줄은 그대로
-두고**(HUD 유지) 그 아래 줄에 뉴스를 보여줍니다. Claude Code가 설정을 핫리로드하므로 **재시작
-없이 다음 메시지 때 바로** 나타납니다.
+뉴스 줄은 **다음 메시지 때** 나타납니다 — 재시작 불필요. 셋업은 언어·분야를 물어보고, 기존
+상태줄은 유지합니다.
+
+## 무엇을 하나
 
-_(설치 중 자동 셋업을 끄려면 `NEWSLINE_NO_INIT=1`.)_
+- **뉴스 수집·표시는 내 컴퓨터에서** 이뤄집니다 — 코드·프롬프트·파일·Claude 대화는 건드리지 않아요.
+- 작은 **엣지 서비스**가 지역에 맞는 최적 소스를 골라주고 헤드라인 클릭을 라우팅합니다. 덕분에
+  재설치 없이 소스가 최신으로 유지되고, 엣지가 불통이면 **내장 피드로 자동 폴백**합니다.
+- 상태줄은 캐시에서 **즉시** 표시되고, 갱신은 백그라운드에서 돕니다.
 
 ## 설정
 
-`newsline init`에서 고르거나, `~/.config/newsline/config.json`을 편집(또는 환경변수 설정):
+`newsline init` 재실행 또는 `~/.config/newsline/config.json` 편집:
 
-| 키 / 환경변수 | 기본값 | 의미 |
+| 키 | 기본값 | 의미 |
 |---|---|---|
-| `lang` / `NEWSLINE_LANG` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh` 또는 `auto` |
-| `topic` / `NEWSLINE_TOPIC` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
-| `rotate` / `NEWSLINE_ROTATE` | `6` | 헤드라인당 노출 초 |
-| `count` / `NEWSLINE_COUNT` | `15` | 회전용으로 캐시할 헤드라인 수 |
-| `maxlen` / `NEWSLINE_MAXLEN` | `120` | 최대 글자수; `max`=무제한; `NN%`≈터미널 폭 비율 |
-| `icon` / `NEWSLINE_ICON` | `📰` | 앞 아이콘; `none`이면 제거 |
-| `linkhint` / `NEWSLINE_LINKHINT` | off | 끝에 `↗`(외부 열기) 힌트 추가 |
-| `api` / `NEWSLINE_API` | — | 선택: 큐레이션 API (서버 우선, 실패 시 로컬 폴백) |
-| `endpoint` / `NEWSLINE_ENDPOINT` | — | 클릭 리다이렉트 래퍼 |
-
-## 동작 방식
-
-- **`newsline render`** (상태줄이 호출) — 캐시에서 **즉시** 출력하고 절대 막지 않으며, 캐시가
-  낡았으면 백그라운드 refresh를 트리거합니다.
-- **`newsline refresh`** — keyless 지역 RSS/Atom 피드를 로컬에서 받아 상위 헤드라인을 파싱·중복
-  제거·캐시합니다.
-- 헤드라인은 클릭 가능한 [OSC 8] 링크입니다. 그냥 클릭 vs `Cmd`/`Ctrl`+클릭으로 열리는지는
-  newsline이 아니라 **터미널 설정**이 결정합니다.
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh` 또는 `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | 헤드라인당 노출 초 |
+| `count` | `15` | 회전 헤드라인 수 |
+| `maxlen` | `120` | 최대 글자수 (`max`=무제한) |
+| `icon` | `📰` | 앞 아이콘 (`none`이면 제거) |
 
 ## 제거
 
 ```sh
-newsline uninstall      # 연결을 제거하고 이전 상태줄로 복구
+newsline uninstall      # 이전 상태줄로 복구
 ```
 
-## 프라이버시
-
-로컬에서 실행되며, 로케일은 시스템 설정에서 감지(IP 지오로케이션 없음), 공개 피드를 직접
-받아옵니다. 코드·프롬프트·파일·Claude 대화는 접근하지 않습니다. 클릭은 리다이렉트를 거치는데,
-이는 참여도 측정과 향후 제휴 링크(운영 자금)를 위한 것이며 여기에 명시합니다.
-
-## 요구사항
-
-`bash`, `python3`. macOS·Linux는 기본 지원, Windows는 WSL 또는 Git Bash.
-
-[OSC 8]: https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
+`bash` + `python3` 필요 (macOS / Linux; Windows는 WSL).

package/readme/pt.md

@@ -0,0 +1,57 @@
+<div align="center">
+
+[English](../README.md) · [한국어](ko.md) · [日本語](ja.md) · [Español](es.md) · [Français](fr.md) · [Deutsch](de.md) · **Português** · [中文](zh.md)
+
+</div>
+
+# newsline
+
+**Esperando o Claude Code terminar? Leia as últimas notícias em uma linha, direto na sua barra de status.**
+Uma manchete regional rotativa fica na parte de baixo da sua sessão — então uma longa espera vira uma
+olhada rápida nas notícias. Ela aparece *abaixo* da sua barra de status atual (seu HUD permanece).
+
+## Instalar e executar — uma linha
+
+```sh
+# curl (macOS / Linux / WSL) — instala e configura na hora
+curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
+
+# Homebrew
+brew install itdar/tap/newsline && newsline init
+
+# npm
+npm i -g newsline-cli && newsline init
+```
+
+A linha de notícias aparece na sua **próxima mensagem** — sem reiniciar. A configuração pergunta o
+idioma e o tema, e mantém a sua barra de status atual.
+
+## O que faz
+
+- **Sua máquina busca e exibe as notícias** — ela nunca toca no seu código, prompts, arquivos ou
+  conversas com o Claude.
+- Um pequeno **serviço edge** escolhe as melhores fontes regionais e roteia os cliques nas manchetes,
+  mantendo as fontes atualizadas sem reinstalar. Se estiver inacessível, o newsline **usa os feeds
+  integrados como alternativa**.
+- A barra de status é instantânea (servida de um cache); as atualizações rodam em segundo plano.
+
+## Configurar
+
+Execute `newsline init` novamente ou edite `~/.config/newsline/config.json`:
+
+| Chave | Padrão | Significado |
+|---|---|---|
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`, ou `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | segundos por manchete |
+| `count` | `15` | manchetes na rotação |
+| `maxlen` | `120` | máximo de caracteres (`max` = sem corte) |
+| `icon` | `📰` | ícone inicial (`none` para ocultar) |
+
+## Desinstalar
+
+```sh
+newsline uninstall      # restaura a sua barra de status anterior
+```
+
+Precisa de `bash` + `python3` (macOS / Linux; Windows via WSL).

package/readme/zh.md

@@ -0,0 +1,54 @@
+<div align="center">
+
+[English](../README.md) · [한국어](ko.md) · [日本語](ja.md) · [Español](es.md) · [Français](fr.md) · [Deutsch](de.md) · [Português](pt.md) · **中文**
+
+</div>
+
+# newsline
+
+**等待 Claude Code 完成任务时，直接在状态栏里读一行最新新闻。**
+一条轮播的区域头条位于会话底部——漫长的等待就变成了快速浏览新闻的时间。它显示在你现有状态栏的
+*下方*（你的 HUD 保持不变）。
+
+## 安装并运行 — 一行搞定
+
+```sh
+# curl (macOS / Linux / WSL) — 安装并立即完成设置
+curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh
+
+# Homebrew
+brew install itdar/tap/newsline && newsline init
+
+# npm
+npm i -g newsline-cli && newsline init
+```
+
+新闻行会在你的 **下一条消息** 时出现——无需重启。设置会询问语言和主题，并保留你现有的状态栏。
+
+## 它做什么
+
+- **抓取和显示新闻都在你的电脑上完成**——绝不触碰你的代码、提示词、文件或与 Claude 的对话。
+- 一个小型 **边缘服务** 挑选最合适的区域新闻源并路由头条点击，因此无需重装即可保持新闻源常新。
+  若无法连接，newsline 会 **回退到内置源**。
+- 状态栏即时显示（来自缓存）；刷新在后台进行。
+
+## 配置
+
+重新运行 `newsline init`，或编辑 `~/.config/newsline/config.json`：
+
+| 键 | 默认值 | 含义 |
+|---|---|---|
+| `lang` | `auto` | `ko` `ja` `en` `es` `fr` `de` `pt` `zh`，或 `auto` |
+| `topic` | `general` | `general` `tech` `business` `world` `sports` `science` `health` `entertainment` |
+| `rotate` | `6` | 每条头条显示秒数 |
+| `count` | `15` | 轮播头条数量 |
+| `maxlen` | `120` | 最大字符数（`max` = 不截断） |
+| `icon` | `📰` | 前置图标（`none` 为隐藏） |
+
+## 卸载
+
+```sh
+newsline uninstall      # 恢复你之前的状态栏
+```
+
+需要 `bash` + `python3`（macOS / Linux；Windows 通过 WSL）。

package/refresh.sh

@@ -16,10 +16,20 @@ FEEDS="${NEWSLINE_FEEDS:-$HERE/feeds.json}"
 # through it so monetization can be switched on later WITHOUT re-shipping.
 ENDPOINT="${NEWSLINE_ENDPOINT:-https://newsline.thesockerrr.workers.dev/r}"
 COUNT="${NEWSLINE_COUNT:-15}"         # how many headlines to cache for rotation
+# Client version, sent to /feed as ?v= for the server-side update nudge.
+# Bump together with package.json when tagging a release.
+export NEWSLINE_VERSION="${NEWSLINE_VERSION:-0.1.0}"
 LOCK="$CACHE_DIR/refresh.lock"
 mkdir -p "$CACHE_DIR" 2>/dev/null
 
 # --- single-flight: if another refresh is already running, bail quietly ---
+# A refresh killed before its EXIT trap runs (SIGKILL, reboot, closed terminal)
+# leaves the lock behind; expire locks older than 120s so refreshes never wedge.
+if [ -d "$LOCK" ]; then
+  now=$(date +%s)
+  lmt=$(stat -f %m "$LOCK" 2>/dev/null || stat -c %Y "$LOCK" 2>/dev/null || echo 0)
+  [ $((now - lmt)) -gt 120 ] && rmdir "$LOCK" 2>/dev/null
+fi
 if ! mkdir "$LOCK" 2>/dev/null; then exit 0; fi
 trap 'rmdir "$LOCK" 2>/dev/null' EXIT
 
@@ -49,14 +59,58 @@ esac
 # --- server-first feed selection (COARSE context only), local fallback ---
 # resolve.py tries $NEWSLINE_API/feed; on any failure it returns local feeds.json.
 # We send lang/country/localtime/dow/tz only — no personal data, no tracking id.
+# The resolved list is reused for NEWSLINE_API_TTL seconds (feed curation changes
+# rarely) so the curation API is hit at most hourly, not on every refresh.
 RESOLVED="$CACHE_DIR/feeds.resolved.json"
+RESOLVE_STAMP="$CACHE_DIR/feeds.resolved.ok"
+RESOLVE_TTL="${NEWSLINE_API_TTL:-3600}"
 export NEWSLINE_COUNTRY="$country"
 export NEWSLINE_LOCALTIME="$(date +%H%M)"
 export NEWSLINE_DOW="$(date +%u)"
 export NEWSLINE_TZ="$(date +%z)"
-if ! python3 "$HERE/resolve.py" "$lang" "$FEEDS" "${NEWSLINE_API:-https://newsline.thesockerrr.workers.dev}" > "$RESOLVED" 2>/dev/null \
-   || [ ! -s "$RESOLVED" ]; then
-  cp "$FEEDS" "$RESOLVED" 2>/dev/null   # last-ditch fallback to bundled feeds
+need_resolve=1
+if [ -s "$RESOLVED" ] && [ -f "$RESOLVE_STAMP" ]; then
+  now=$(date +%s)
+  smt=$(stat -f %m "$RESOLVE_STAMP" 2>/dev/null || stat -c %Y "$RESOLVE_STAMP" 2>/dev/null || echo 0)
+  [ $((now - smt)) -lt "$RESOLVE_TTL" ] && need_resolve=0
+fi
+if [ "$need_resolve" = "1" ]; then
+  if python3 "$HERE/resolve.py" "$lang" "$FEEDS" "${NEWSLINE_API:-https://newsline.thesockerrr.workers.dev}" > "$RESOLVED.tmp" 2>/dev/null \
+     && [ -s "$RESOLVED.tmp" ]; then
+    mv -f "$RESOLVED.tmp" "$RESOLVED"
+    touch "$RESOLVE_STAMP"
+  else
+    rm -f "$RESOLVED.tmp" 2>/dev/null
+    [ -s "$RESOLVED" ] || cp "$FEEDS" "$RESOLVED" 2>/dev/null   # last-ditch fallback to bundled feeds
+  fi
+fi
+
+# --- server-driven update nudge: one extra line below the news --------------
+# If the server flagged this client as too old (RESOLVED has "_update"),
+# write the notice line statusline.sh appends; otherwise clear it. Skipped
+# (cleared) when this client already meets minVersion, so the nudge stops
+# right after an update even while the old RESOLVED is still cached.
+NOTICE="$CACHE_DIR/notice"
+msg=$(python3 -c '
+import json, os, sys
+try:
+    u = json.load(open(sys.argv[1])).get("_update") or {}
+except Exception:
+    u = {}
+def pv(s): return [int(x) if x.isdigit() else 0 for x in str(s).split(".")]
+mv, cur = u.get("minVersion", ""), os.environ.get("NEWSLINE_VERSION", "")
+print("" if (mv and cur and pv(cur) >= pv(mv)) else u.get("message", ""))
+' "$RESOLVED" 2>/dev/null | tr -d '\000-\037')
+if [ -n "$msg" ]; then
+  case "$HERE" in                      # install channel by where we live
+    *"/node_modules/"*)      ucmd="npm i -g newsline-cli" ;;
+    *[Cc]ellar*|*linuxbrew*) ucmd="brew upgrade newsline" ;;
+    *) ucmd="curl -fsSL https://raw.githubusercontent.com/itdar/cc-plugin/master/install.sh | sh" ;;
+  esac
+  # yellow line, command in bold bright yellow — mirrors Claude Code's own update nudge
+  printf '\033[33m[%s] Run: \033[1;93m%s\033[0m\n' "$msg" "$ucmd" > "$NOTICE.tmp" && mv -f "$NOTICE.tmp" "$NOTICE"
+else
+  rm -f "$NOTICE" 2>/dev/null
 fi
 
 # --- fetch + parse + build the line; write atomically, keep old cache on failure ---

package/resolve.py

@@ -2,9 +2,11 @@
 """newsline · resolve which feeds to use — server-first, local fallback, topic-aware.
 
 Tries the operator's curation API (NEWSLINE_API) with a short timeout, sending only
-COARSE CONTEXT (lang, country, localtime, dow, tz, topic) — never personal data. On
-ANY failure it falls back to the bundled feeds.json. If a topic preference is set
-(NEWSLINE_TOPIC), a keyless Google News topic feed is prepended so that topic leads.
+COARSE CONTEXT (lang, country, localtime, dow, tz, topic) — never personal data.
+The server's list is used AS-IS (it handles topic: vertical partners first, then
+Google's topic feed). Only when the server is unreachable does the local fallback
+kick in: bundled feeds.json, with a keyless Google News topic feed prepended if a
+topic preference is set (NEWSLINE_TOPIC) so the topic still leads offline.
 
 Prints a feeds.json-shaped object fetch.py consumes:  {"<lang>": [...], "default": [...]}
 
@@ -32,6 +34,10 @@ GN_TOPICS = {
 }
 LANG_COUNTRY = {"ko": "KR", "ja": "JP", "en": "US", "de": "DE",
                 "fr": "FR", "es": "ES", "pt": "BR", "zh": "CN"}
+# Google News wants regioned codes for some languages (bare "pt"/"zh" 404s or
+# serves the wrong edition).
+GN_HL = {"pt": "pt-BR", "zh": "zh-CN", "en": "en-US"}
+GN_CEID_LANG = {"pt": "pt-419", "zh": "zh-Hans"}
 
 
 def topic_feed(lang, country, topic):
@@ -42,8 +48,10 @@ def topic_feed(lang, country, topic):
     if not t:
         return None
     gl = country or LANG_COUNTRY.get(lang, lang.upper())
+    hl = GN_HL.get(lang, lang)
+    cl = GN_CEID_LANG.get(lang, lang)
     return (f"https://news.google.com/rss/headlines/section/topic/{t}"
-            f"?hl={lang}&gl={gl}&ceid={gl}:{lang}")
+            f"?hl={hl}&gl={gl}&ceid={gl}:{cl}")
 
 
 def local_feeds(lang, path):
@@ -56,6 +64,7 @@ def local_feeds(lang, path):
 
 
 def server_feeds(lang, api_base):
+    """Return (feeds_or_None, update_or_None) from the curation API."""
     params = {
         "lang": lang,
         "country": os.environ.get("NEWSLINE_COUNTRY", ""),
@@ -63,14 +72,22 @@ def server_feeds(lang, api_base):
         "dow": os.environ.get("NEWSLINE_DOW", ""),
         "tz": os.environ.get("NEWSLINE_TZ", ""),
         "topic": os.environ.get("NEWSLINE_TOPIC", ""),
+        "v": os.environ.get("NEWSLINE_VERSION", ""),
     }
     url = api_base.rstrip("/") + "/feed?" + urllib.parse.urlencode(params)
     req = urllib.request.Request(url, headers={"User-Agent": "newsline/0.1"})
     obj = json.loads(urllib.request.urlopen(req, timeout=TIMEOUT).read())
+    update = obj.get("update")
+    if not isinstance(update, dict):
+        update = None
     feeds = obj.get("feeds")
-    if isinstance(feeds, list) and feeds and all(isinstance(x, str) for x in feeds):
-        return feeds
-    return None
+    if isinstance(feeds, list):
+        # fetch.py urlopens these — accept only http(s) URLs
+        feeds = [x for x in feeds
+                 if isinstance(x, str) and x.startswith(("http://", "https://"))]
+    else:
+        feeds = None
+    return (feeds or None), update
 
 
 def main():
@@ -81,22 +98,26 @@ def main():
 
     local_urls, default = local_feeds(lang, local_path)
 
-    feeds = None
+    feeds = update = None
     if api_base:
         try:
-            feeds = server_feeds(lang, api_base)   # server-first
+            feeds, update = server_feeds(lang, api_base)   # server-first, used AS-IS
         except Exception:
-            feeds = None                            # any issue -> local fallback
-    feeds = feeds or local_urls or default
-
-    # topic preference leads (keyless Google News topic feed), general as backup
-    tfeed = topic_feed(lang, os.environ.get("NEWSLINE_COUNTRY", ""), os.environ.get("NEWSLINE_TOPIC", ""))
-    if tfeed:
-        feeds = [tfeed] + [f for f in feeds if f != tfeed]
+            feeds, update = None, None              # any issue -> local fallback
+    if not feeds:
+        # server unreachable: bundled feeds, topic preference prepended locally
+        feeds = local_urls or default
+        tfeed = topic_feed(lang, os.environ.get("NEWSLINE_COUNTRY", ""),
+                           os.environ.get("NEWSLINE_TOPIC", ""))
+        if tfeed:
+            feeds = [tfeed] + [f for f in feeds if f != tfeed]
 
     if not feeds:
         return 1
-    sys.stdout.write(json.dumps({lang: feeds, "default": default or feeds}, ensure_ascii=False))
+    out = {lang: feeds, "default": default or feeds}
+    if update:
+        out["_update"] = update   # refresh.sh turns this into the notice line
+    sys.stdout.write(json.dumps(out, ensure_ascii=False))
     return 0
 
 

package/statusline.sh

@@ -31,6 +31,8 @@ if [ -s "$CACHE_FILE" ]; then
   n=$(awk 'END{print NR}' "$CACHE_FILE" 2>/dev/null)
   if [ "${n:-0}" -gt 0 ] 2>/dev/null; then
     rot="${NEWSLINE_ROTATE:-6}"          # seconds each headline stays up
+    case "$rot" in ''|*[!0-9]*) rot=6 ;; esac
+    [ "$rot" -ge 1 ] || rot=6            # 0 would divide by zero below
     now="${NEWSLINE_NOW:-$(date +%s)}"   # NEWSLINE_NOW overrides clock (tests/debug)
     idx=$(( (now / rot) % n + 1 ))
     sed -n "${idx}p" "$CACHE_FILE"
@@ -40,3 +42,10 @@ if [ -s "$CACHE_FILE" ]; then
 else
   printf '📰 …'   # first run, before the first refresh lands
 fi
+
+# --- server-driven update nudge (written/cleared by refresh.sh), below the news ---
+NOTICE_FILE="$CACHE_DIR/notice"
+if [ -s "$NOTICE_FILE" ]; then
+  [ -s "$CACHE_FILE" ] || printf '\n'   # placeholder path prints without a newline
+  head -1 "$NOTICE_FILE"
+fi