Foreground server logo, chat stream trust, and hub edit/scroll polish

.github/actions/update-repo-description/action.yaml

@@ -0,0 +1,52 @@
+name: Update repo description
+description: Randomly pick a repository description from a JSON5 pool (holiday / lunar / jieqi) and apply it via gh.
+inputs:
+  token:
+    description: GitHub token with administration write (GITHUB_TOKEN is not enough; use a PAT)
+    required: true
+  config:
+    description: Path to descriptions JSON5 (relative to workspace)
+    required: false
+    default: .github/repo-descriptions.json
+  repository:
+    description: Target repository (owner/name)
+    required: false
+    default: ${{ github.repository }}
+  timezone:
+    description: IANA timezone used to resolve "today" for holiday matching
+    required: false
+    default: Asia/Shanghai
+  date:
+    description: Override today's date as YYYY-MM-DD (testing)
+    required: false
+    default: ''
+outputs:
+  description:
+    description: The description that was applied
+    value: ${{ steps.pick.outputs.description }}
+  holiday:
+    description: Matched holiday name, empty if none
+    value: ${{ steps.pick.outputs.holiday }}
+  date:
+    description: Calendar date used for selection (YYYY-MM-DD)
+    value: ${{ steps.pick.outputs.date }}
+runs:
+  using: composite
+  steps:
+    - name: Install picker deps
+      shell: bash
+      run: python3 -m pip install --quiet json5 sxtwl
+    - name: Pick description
+      id: pick
+      shell: bash
+      run: python3 "${{ github.action_path }}/pick.py" "${{ inputs.config }}" "${{ inputs.timezone }}" "${{ inputs.date }}"
+    - name: Apply description
+      shell: bash
+      env:
+        GH_TOKEN: ${{ inputs.token }}
+        DESCRIPTION: ${{ steps.pick.outputs.description }}
+        REPOSITORY: ${{ inputs.repository }}
+      run: |
+        set -euo pipefail
+        echo "Updating $REPOSITORY description → $DESCRIPTION"
+        gh repo edit "$REPOSITORY" --description "$DESCRIPTION"

.github/actions/update-repo-description/pick.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""Pick a repo description from JSON5 config (gregorian / lunar / jieqi / yearday)."""
+
+from __future__ import annotations
+
+import os
+import random
+import sys
+from datetime import date, datetime
+from zoneinfo import ZoneInfo
+
+import json5
+import sxtwl
+
+# sxtwl jieqi index order (寿星天文历)
+JIEQI = (
+	'冬至', '小寒', '大寒', '立春', '雨水', '惊蛰',
+	'春分', '清明', '谷雨', '立夏', '小满', '芒种',
+	'夏至', '小暑', '大暑', '立秋', '处暑', '白露',
+	'秋分', '寒露', '霜降', '立冬', '小雪', '大雪',
+)
+
+
+def solar_day(today: date):
+	return sxtwl.fromSolar(today.year, today.month, today.day)
+
+
+def lunar_month_day(today: date) -> str | None:
+	"""Lunar MM-DD for non-leap months; leap months do not match festivals."""
+	day = solar_day(today)
+	if day.isLunarLeap():
+		return None
+	return f'{day.getLunarMonth():02d}-{day.getLunarDay():02d}'
+
+
+def solar_term_name(today: date) -> str | None:
+	day = solar_day(today)
+	if not day.hasJieQi():
+		return None
+	return JIEQI[day.getJieQi()]
+
+
+def holiday_matches(holiday: dict, today: date) -> bool:
+	if any(date_value in (today.strftime('%m-%d'), today.isoformat()) for date_value in holiday.get('dates') or ()):
+		return True
+	lunar_dates = holiday.get('lunar') or ()
+	if lunar_dates:
+		lunar_date = lunar_month_day(today)
+		if lunar_date and lunar_date in lunar_dates:
+			return True
+	terms = holiday.get('jieqi') or ()
+	if terms:
+		solar_term = solar_term_name(today)
+		if solar_term and solar_term in terms:
+			return True
+	yearday = holiday.get('yearday')
+	return yearday is not None and today.timetuple().tm_yday == yearday
+
+
+def match_holiday(config: dict, today: date) -> dict | None:
+	for holiday in config.get('holidays') or ():
+		if holiday_matches(holiday, today):
+			return holiday
+	return None
+
+
+def pick_pool(config: dict, today: date) -> tuple[list[str], str | None]:
+	holiday = match_holiday(config, today)
+	if holiday:
+		return list(holiday.get('descriptions') or ()), holiday.get('name') or 'holiday'
+	core = list(config.get('core') or ())
+	extras = config.get('extras')
+	extras = list(extras) if isinstance(extras, list) else []
+	if core and extras:
+		pool = core if random.random() < 0.7 else extras
+	elif core:
+		pool = core
+	else:
+		pool = extras
+	return pool, None
+
+
+def resolve_today(timezone: str, date_override: str) -> date:
+	if date_override:
+		return date.fromisoformat(date_override)
+	return datetime.now(ZoneInfo(timezone)).date()
+
+
+def write_github_output(description: str, holiday_name: str | None, today: date) -> None:
+	path = os.environ.get('GITHUB_OUTPUT')
+	if not path:
+		return
+	with open(path, 'a', encoding='utf-8') as output_file:
+		output_file.write('description<<EOF\n')
+		output_file.write(f'{description}\n')
+		output_file.write('EOF\n')
+		output_file.write(f'holiday={holiday_name or ""}\n')
+		output_file.write(f'date={today.isoformat()}\n')
+
+
+def main(arguments: list[str] | None = None) -> int:
+	arguments = list(sys.argv[1:] if arguments is None else arguments)
+	if len(arguments) < 1:
+		print('usage: pick.py <config.json> [timezone] [YYYY-MM-DD]', file=sys.stderr)
+		return 2
+	config_path = arguments[0]
+	timezone = arguments[1] if len(arguments) > 1 and arguments[1] else 'Asia/Shanghai'
+	date_override = arguments[2] if len(arguments) > 2 else ''
+
+	with open(config_path, encoding='utf-8') as config_file:
+		config = json5.load(config_file)
+
+	today = resolve_today(timezone, date_override)
+	pool, holiday_name = pick_pool(config, today)
+	if not pool:
+		print(f'No descriptions available for today ({today.isoformat()})', file=sys.stderr)
+		return 1
+	description = random.choice(pool)
+	if len(description) > 350:
+		print(f'Description exceeds 350 characters ({len(description)})', file=sys.stderr)
+		return 1
+
+	write_github_output(description, holiday_name, today)
+	print(f'date={today.isoformat()}', file=sys.stderr)
+	if holiday_name:
+		print(f'holiday={holiday_name}', file=sys.stderr)
+	print(f'description={description}', file=sys.stderr)
+	return 0
+
+
+if __name__ == '__main__':
+	raise SystemExit(main())