newsline-cli 0.1.8 → 1.0.0

package/README.md

@@ -70,10 +70,30 @@ Re-run `newsline init`, or edit `~/.config/newsline/config.json`:
 | `count` | `15` | headlines in rotation |
 | `maxlen` | `120` | max characters (`max` = no cut) |
 | `icon` | `📰` | leading glyph (`none` to hide) |
-| `color` | `white` | headline color: `default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | headline color: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-Or run `newsline color` — each run steps to the next color (default(gray) → white →
-cyan → yellow → green → blue → magenta → red), shown on the next status-line tick.
+Set one directly with `newsline color <name>` (e.g. `newsline color gray`), or run
+`newsline color` with no name to step to the next color (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist` lists them all with a live
+preview. Changes show on the next status-line tick.
+
+## Update
+
+Update the same way you installed — your language/topic/color settings are kept:
+
+```sh
+# curl — re-run the installer (skips setup, just refreshes the CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code plugin: run `/plugin marketplace update itdar`, then `/reload-plugins`
+(or restart). You can also enable background auto-update under `/plugin` → **Marketplaces**.
 
 ## Uninstall
 

package/newsline

@@ -4,6 +4,8 @@
 #   newsline init        interactive setup: language, topic, status-line wiring.
 #                        COMPOSES with an existing status line (e.g. your HUD),
 #                        so rate-limit / context info stays visible.
+#   newsline color [c]   set the headline color (or cycle to the next when no name).
+#   newsline colorlist   list the available headline colors with a live preview.
 #   newsline render      what settings.json runs each refresh (base HUD + news).
 #   newsline refresh     force a cache refresh now.
 #   newsline once        fetch + print headlines once (debug).
@@ -191,14 +193,14 @@ cmd_init() {
     fi
     local cur_color; cur_color=$(cfg_get color)
     echo "Select headline color (change anytime: newsline color):" >&2
-    choose "${cur_color:-white}" \
-      default "Terminal default (gray)" white "White" cyan "Cyan" yellow "Yellow" \
-      green "Green" blue "Blue" magenta "Magenta" red "Red"
+    choose "${cur_color:-cyan}" \
+      default "Terminal default" cyan "Cyan" gray "Gray" white "White" \
+      yellow "Yellow" green "Green" blue "Blue" magenta "Magenta" red "Red"
     color="$CHOICE"
   else
-    # --yes: keep a color previously set via init/`newsline color`; white on first run
+    # --yes: keep a color previously set via init/`newsline color`; cyan on first run
     lang="${lang:-$detected}"; topic="${topic:-general}"
-    color=$(cfg_get color); [ -n "$color" ] || color="white"
+    color=$(cfg_get color); [ -n "$color" ] || color="cyan"
   fi
 
   # Always KEEP an existing status line and show newsline below it (no prompt).
@@ -266,17 +268,25 @@ PY
   echo "  It appears on your next message to Claude — no restart needed."
 }
 
-cmd_color() { # newsline color — each run steps to the next color (wraps around)
-  local cur new; cur=$(cfg_get color)
-  new=$(python3 - "${cur:-default}" <<'PY'
-import sys
-p=["default","white","cyan","yellow","green","blue","magenta","red"]
-c=sys.argv[1]
-print(p[(p.index(c)+1)%len(p)] if c in p else "default")
-PY
-)
+# canonical headline palette — single source of truth for cycling, listing, and
+# validation. "default" means the terminal's own color (no SGR); the rest map to
+# the SGR codes in statusline.sh (nl_sgr below mirrors that mapping).
+NL_PALETTE="default gray white cyan yellow green blue magenta red"
+
+nl_sgr() { # color name -> SGR params (empty = terminal default). Mirrors statusline.sh.
+  case "$1" in
+    dim)        echo "2"  ;;
+    gray|grey)  echo "90" ;;
+    red)        echo "31" ;;  green)   echo "32" ;;  yellow) echo "33" ;;
+    blue)       echo "34" ;;  magenta) echo "35" ;;  cyan)   echo "36" ;;
+    white)      echo "37" ;;  orange)  echo "38;5;208" ;;
+    *)          echo ""   ;;
+  esac
+}
+
+nl_write_color() { # nl_write_color <name> — persist the chosen color to config
   mkdir -p "$CONFIG_DIR"
-  python3 - "$CONFIG" "$new" <<'PY' || { echo "✗ could not write $CONFIG" >&2; return 1; }
+  python3 - "$CONFIG" "$1" <<'PY' || { echo "✗ could not write $CONFIG" >&2; return 1; }
 import json,os,sys
 path,color=sys.argv[1],sys.argv[2]
 try: d=json.load(open(path))
@@ -287,6 +297,45 @@ tmp=path+".tmp"
 with open(tmp,"w") as f: json.dump(d,f,indent=2,ensure_ascii=False)
 os.replace(tmp,path)
 PY
+}
+
+cmd_colorlist() { # newsline colorlist — list the palette, each shown in its own color
+  local cur c sgr mark; cur=$(cfg_get color); [ -n "$cur" ] || cur=default
+  echo "Headline colors (set with: newsline color <name>):"
+  for c in $NL_PALETTE; do
+    [ "$c" = "$cur" ] && mark="  ← current" || mark=""
+    sgr=$(nl_sgr "$c")
+    if [ -n "$sgr" ]; then
+      printf '  \033[%sm%-8s 📰 sample headline\033[0m%s\n' "$sgr" "$c" "$mark"
+    else
+      printf '  %-8s 📰 sample headline%s\n' "$c" "$mark"
+    fi
+  done
+}
+
+cmd_color() { # newsline color [name] — set a color; with no name, step to the next one
+  local cur new arg; arg="${1:-}"
+  case "$arg" in list|ls|--list) cmd_colorlist; return $? ;; esac
+  if [ -n "$arg" ]; then
+    new="$(printf '%s' "$arg" | tr '[:upper:]' '[:lower:]')"
+    case "$new" in grey) new=gray ;; none|off) new=default ;; esac
+    case " $NL_PALETTE " in
+      *" $new "*) ;;
+      *) echo "✗ unknown color: $arg" >&2
+         echo "  choose from: $NL_PALETTE   (see: newsline colorlist)" >&2
+         return 1 ;;
+    esac
+  else                                   # no name: cycle to the next color, wrapping
+    cur=$(cfg_get color)
+    new=$(NL_PALETTE="$NL_PALETTE" python3 - "${cur:-default}" <<'PY'
+import os,sys
+p=os.environ["NL_PALETTE"].split()
+c=sys.argv[1]
+print(p[(p.index(c)+1)%len(p)] if c in p else p[0])
+PY
+)
+  fi
+  nl_write_color "$new" || return 1
   echo "✔ headline color: $new — preview:"
   load_config
   "$HERE/statusline.sh"; echo
@@ -336,9 +385,11 @@ usage() {
 newsline — local news status-line utility
   newsline init [--lang ko] [--topic tech]    set up & wire the status line
                                               (asks language / topic / color)
-  newsline color                              next headline color: default(gray) → white
-                                              → cyan → yellow → green → blue → magenta
-                                              → red → back to default
+  newsline color [name]                       set headline color (e.g. cyan, gray); with
+                                              no name, step to the next: default → gray →
+                                              white → cyan → yellow → green → blue →
+                                              magenta → red → back to default
+  newsline colorlist                          list the available colors with a preview
   newsline uninstall                          remove & restore previous status line
 EOF
   if [ "${1:-}" = "--all" ]; then
@@ -357,7 +408,8 @@ case "${1:-help}" in
   refresh) shift; cmd_refresh "$@";;
   once) shift; cmd_once "$@";;
   init) shift; cmd_init "$@";;
-  color) shift; cmd_color;;
+  color) shift; cmd_color "$@";;
+  colorlist|colors) shift; cmd_colorlist;;
   uninstall) shift; cmd_uninstall "$@";;
   help|-h|--help) shift; usage "$@";;
   *) usage; exit 1;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newsline-cli",
-  "version": "0.1.8",
+  "version": "1.0.0",
   "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

@@ -73,11 +73,30 @@ Führe `newsline init` erneut aus oder bearbeite `~/.config/newsline/config.json
 | `count` | `15` | Schlagzeilen im Wechsel |
 | `maxlen` | `120` | maximale Zeichen (`max` = kein Abschneiden) |
 | `icon` | `📰` | vorangestelltes Symbol (`none` zum Ausblenden) |
-| `color` | `white` | Farbe der Schlagzeile: `default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | Farbe der Schlagzeile: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-Oder `newsline color` verwenden — jeder Aufruf wechselt zur nächsten Farbe (default(gray) →
-white → cyan → yellow → green → blue → magenta → red), sichtbar beim nächsten
-Statuszeilen-Refresh.
+Eine direkt setzen mit `newsline color <name>` (z. B. `newsline color gray`), oder
+`newsline color` ohne Namen ausführen, um zur nächsten Farbe zu wechseln (default → gray →
+white → cyan → yellow → green → blue → magenta → red). `newsline colorlist` listet alle mit
+Vorschau auf; Änderungen erscheinen beim nächsten Statuszeilen-Refresh.
+
+## Aktualisieren
+
+Aktualisiere so, wie du installiert hast — deine Sprache/Thema/Farbe bleiben erhalten:
+
+```sh
+# curl — Installer erneut ausführen (überspringt die Einrichtung, aktualisiert nur die CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude-Code-Plugin: `/plugin marketplace update itdar`, dann `/reload-plugins`
+(oder neu starten). Aktiviere die automatische Aktualisierung unter `/plugin` → **Marketplaces**.
 
 ## Deinstallieren
 

package/readme/es.md

@@ -72,11 +72,30 @@ Vuelve a ejecutar `newsline init` o edita `~/.config/newsline/config.json`:
 | `count` | `15` | titulares en rotación |
 | `maxlen` | `120` | caracteres máximos (`max` = sin recorte) |
 | `icon` | `📰` | icono inicial (`none` para ocultarlo) |
-| `color` | `white` | color del titular: `default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | color del titular: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-O usa `newsline color` — cada ejecución pasa al siguiente color (default(gray) → white →
-cyan → yellow → green → blue → magenta → red), visible en el próximo refresco de la
-línea de estado.
+Fija uno directamente con `newsline color <nombre>` (p. ej. `newsline color gray`), o usa
+`newsline color` sin nombre para pasar al siguiente color (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist` los muestra todos con una
+vista previa; los cambios se ven en el próximo refresco de la línea de estado.
+
+## Actualizar
+
+Actualiza igual que instalaste — se conservan tus ajustes de idioma/tema/color:
+
+```sh
+# curl — vuelve a ejecutar el instalador (omite la configuración, solo actualiza la CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Plugin de Claude Code: ejecuta `/plugin marketplace update itdar` y luego `/reload-plugins`
+(o reinicia). También puedes activar la actualización automática en `/plugin` → **Marketplaces**.
 
 ## Desinstalar
 

package/readme/fr.md

@@ -73,11 +73,30 @@ Relancez `newsline init`, ou modifiez `~/.config/newsline/config.json` :
 | `count` | `15` | titres en rotation |
 | `maxlen` | `120` | caractères maximum (`max` = sans coupure) |
 | `icon` | `📰` | icône de tête (`none` pour masquer) |
-| `color` | `white` | couleur du titre : `default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | couleur du titre : `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-Ou utilisez `newsline color` — chaque exécution passe à la couleur suivante (default(gray) →
-white → cyan → yellow → green → blue → magenta → red), visible au prochain
-rafraîchissement de la ligne d'état.
+Définissez-en une directement avec `newsline color <nom>` (p. ex. `newsline color gray`), ou
+utilisez `newsline color` sans nom pour passer à la couleur suivante (default → gray → white →
+cyan → yellow → green → blue → magenta → red). `newsline colorlist` les liste toutes avec un
+aperçu ; les changements sont visibles au prochain rafraîchissement de la ligne d'état.
+
+## Mettre à jour
+
+Mettez à jour comme vous avez installé — vos réglages de langue/thème/couleur sont conservés :
+
+```sh
+# curl — relancez l'installateur (ignore la configuration, met juste à jour la CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Plugin Claude Code : `/plugin marketplace update itdar`, puis `/reload-plugins`
+(ou redémarrez). Activez la mise à jour automatique dans `/plugin` → **Marketplaces**.
 
 ## Désinstaller
 

package/readme/ja.md

@@ -71,10 +71,30 @@ npm i -g newsline-cli && newsline init
 | `count` | `15` | 切り替えるヘッドライン数 |
 | `maxlen` | `120` | 最大文字数（`max` = 無制限） |
 | `icon` | `📰` | 先頭アイコン（`none` で非表示） |
-| `color` | `white` | 見出しの文字色：`default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | 見出しの文字色：`default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-`newsline color` を実行するたびに次の色へ進みます（default(gray) → white → cyan → yellow →
-green → blue → magenta → red の順で循環、次のステータスライン更新で反映）。
+`newsline color <名前>` で色を直接指定でき（例：`newsline color gray`）、名前なしで
+`newsline color` を実行すると次の色へ進みます（default → gray → white → cyan → yellow →
+green → blue → magenta → red）。`newsline colorlist` で全色をプレビュー付きで一覧でき、
+変更は次のステータスライン更新で反映されます。
+
+## アップデート
+
+インストールした方法と同じ手順で更新できます — 言語・トピック・色の設定は保持されます:
+
+```sh
+# curl — インストーラを再実行（セットアップはスキップし、CLI のみ更新）
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code プラグイン: `/plugin marketplace update itdar` を実行後、`/reload-plugins`
+（または再起動）。`/plugin` → **Marketplaces** でバックグラウンド自動更新も有効にできます。
 
 ## アンインストール
 

package/readme/ko.md

@@ -67,10 +67,30 @@ npm i -g newsline-cli && newsline init
 | `count` | `15` | 회전 헤드라인 수 |
 | `maxlen` | `120` | 최대 글자수 (`max`=무제한) |
 | `icon` | `📰` | 앞 아이콘 (`none`이면 제거) |
-| `color` | `white` | 뉴스 글자 색: `default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | 뉴스 글자 색: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-`newsline color`를 실행할 때마다 다음 색으로 넘어갑니다 (default(gray) → white → cyan →
-yellow → green → blue → magenta → red 순환, 다음 상태줄 갱신 때 반영).
+`newsline color <이름>`으로 색을 바로 지정하거나(예: `newsline color gray`), 이름 없이
+`newsline color`를 실행하면 다음 색으로 넘어갑니다 (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist`로 전체 색 목록을 미리보기와
+함께 확인할 수 있고, 변경은 다음 상태줄 갱신 때 반영됩니다.
+
+## 업데이트
+
+설치했던 방식 그대로 업데이트하면 됩니다 — 언어·분야·색 설정은 유지됩니다:
+
+```sh
+# curl — 설치 스크립트 재실행 (셋업은 건너뛰고 CLI만 갱신)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code 플러그인: `/plugin marketplace update itdar` 실행 후 `/reload-plugins`
+(또는 재시작). `/plugin` → **Marketplaces**에서 백그라운드 자동 업데이트도 켤 수 있습니다.
 
 ## 제거
 

package/readme/pt.md

@@ -71,11 +71,30 @@ Execute `newsline init` novamente ou edite `~/.config/newsline/config.json`:
 | `count` | `15` | manchetes na rotação |
 | `maxlen` | `120` | máximo de caracteres (`max` = sem corte) |
 | `icon` | `📰` | ícone inicial (`none` para ocultar) |
-| `color` | `white` | cor da manchete: `default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | cor da manchete: `default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-Ou use `newsline color` — cada execução avança para a próxima cor (default(gray) → white →
-cyan → yellow → green → blue → magenta → red), visível no próximo refresh da linha
-de status.
+Defina uma diretamente com `newsline color <nome>` (ex.: `newsline color gray`), ou use
+`newsline color` sem nome para avançar para a próxima cor (default → gray → white → cyan →
+yellow → green → blue → magenta → red). `newsline colorlist` mostra todas com uma prévia;
+as mudanças aparecem no próximo refresh da linha de status.
+
+## Atualizar
+
+Atualize da mesma forma que instalou — suas configurações de idioma/tema/cor são mantidas:
+
+```sh
+# curl — execute o instalador de novo (pula a configuração, só atualiza a CLI)
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Plugin do Claude Code: `/plugin marketplace update itdar` e depois `/reload-plugins`
+(ou reinicie). Ative a atualização automática em `/plugin` → **Marketplaces**.
 
 ## Desinstalar
 

package/readme/zh.md

@@ -65,10 +65,29 @@ npm i -g newsline-cli && newsline init
 | `count` | `15` | 轮播头条数量 |
 | `maxlen` | `120` | 最大字符数（`max` = 不截断） |
 | `icon` | `📰` | 前置图标（`none` 为隐藏） |
-| `color` | `white` | 新闻文字颜色：`default` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
+| `color` | `cyan` | 新闻文字颜色：`default` `gray` `white` `cyan` `yellow` `green` `blue` `magenta` `red` |
 
-也可以运行 `newsline color` — 每次执行切换到下一种颜色（default(gray) → white → cyan →
-yellow → green → blue → magenta → red，下次状态栏刷新即生效）。
+用 `newsline color <名称>` 直接设置颜色（如 `newsline color gray`），或不带名称运行
+`newsline color` 切换到下一种颜色（default → gray → white → cyan → yellow → green → blue →
+magenta → red）。`newsline colorlist` 会列出所有颜色并附带预览，更改在下次状态栏刷新时生效。
+
+## 更新
+
+按你安装的方式更新即可 — 语言/主题/颜色设置会保留：
+
+```sh
+# curl — 重新运行安装脚本（跳过设置，仅更新 CLI）
+curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | NEWSLINE_NO_INIT=1 sh
+
+# Homebrew
+brew update && brew upgrade newsline
+
+# npm
+npm i -g newsline-cli@latest
+```
+
+Claude Code 插件：运行 `/plugin marketplace update itdar`，然后 `/reload-plugins`
+（或重启）。也可在 `/plugin` → **Marketplaces** 中启用后台自动更新。
 
 ## 卸载
 

package/refresh.sh

@@ -23,7 +23,7 @@ case "$API" in off|OFF|none|local) API="" ;; esac
 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.8}"
+export NEWSLINE_VERSION="${NEWSLINE_VERSION:-1.0.0}"
 LOCK="$CACHE_DIR/refresh.lock"
 mkdir -p "$CACHE_DIR" 2>/dev/null