feat: auto-install config/entertainment.env (default Al-Hasakah weather) on install

DOC/AGENT_Context_Project.md

@@ -107,7 +107,8 @@ Linux_post_install/
 │   └── pos.bash            # Bash tab-completion for the pos CLI
 │
 ├── config/
-│   └── authorized_keys     # SSH public keys (gitignored)
+│   ├── authorized_keys     # SSH public keys (gitignored)
+│   └── entertainment.env   # Default weather location (auto-installed by postinstall)
 │
 ├── compose/
 │   └── scale-tail/         # Git submodule → ScaleTail templates (119+ services)
@@ -364,6 +365,7 @@ All `.service` files in `systemd/` are automatically copied to `/etc/systemd/sys
 ### Runtime Config
 
 - `~/.config/linux_post_install/compose.env` — Docker Compose global defaults
+- `~/.config/linux_post_install/entertainment.env` — entertainment plugin defaults (e.g. weather location); auto-installed from `config/entertainment.env` by `postinstall.sh` (no clobber)
 - `~/.bashrc` — Modified by postinstall (PATH, bash completion)
 
 ### Feature Flags
@@ -468,7 +470,7 @@ Use conventional prefixes: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`
 |------|-------|---------|
 | `install.sh` | 192 | Main orchestrator — 4 phases with CLI flags, `--feature`, prebuilt arch bins |
 | `preinstall.sh` | 54 | System packages + hotspot deps + yt-dlp + fail2ban |
-| `postinstall.sh` | 97 | fail2ban config, PATH, bash completion, systemd (flag-gated) |
+| `postinstall.sh` | 114 | fail2ban config, PATH, bash completion, systemd (flag-gated) |
 | `lib/common.sh` | 121 | Shared library |
 | `lib/flags.sh` | 60 | Feature flag store (set/clear/is_set/value/list/status) |
 | `bin/flag-reader` | 58 | Inspect flags (list/status/`--raw`) |
@@ -482,7 +484,7 @@ Use conventional prefixes: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`
 | `bin/pos-docker-health` | 110 | One-glance container health dashboard (exits 1 if unhealthy) |
 | `bin/pos-docker-ps` | 128 | Enhanced container overview (health, IPs, ports, uptime) |
 | `bin/pos-docker-vbox` | 157 | Disposable Docker-based VMs (create/enter/start/stop/rm/ls) |
-| `bin/pos-entertainment-send` | 122 | Run a public-API plugin and send its output via Telegram (default sender) |
+| `bin/pos-entertainment-send` | 124 | Run a public-API plugin and send its output via Telegram (default sender) |
 | `bin/pos-media-mp3` | 35 | Download audio as MP3 (yt-dlp) |
 | `bin/pos-media-mp4` | 38 | Download video as MP4 (interactive format select) |
 | `bin/pos-network-checkport` | 45 | Check TCP port connectivity |

DOC/POS.md

@@ -225,6 +225,8 @@ Plugins:
 | `weather` | Open-Meteo (no API key) | `~/.config/linux_post_install/entertainment.env`: `WEATHER_LAT`, `WEATHER_LON` (required), `WEATHER_CITY` (optional label) |
 | `joke` | icanhazdadjoke.com (no API key) | None |
 
+**Config auto-install:** `postinstall.sh` copies the repo's `config/entertainment.env` (default: Al-Hasakah, Syria) to `~/.config/linux_post_install/entertainment.env` on install — but only if you haven't already created your own (no clobber). Override the default by creating/editing that file.
+
 **Adding a plugin:** drop an executable script in `entertainment/` (e.g. `myfeed.sh`). It must be non-interactive and print the message to stdout; errors go to stderr (exit nonzero). If it needs coordinates/tokens, read them from `~/.config/linux_post_install/entertainment.env` (chmod 600, env precedence). No registration needed. Dependencies beyond `curl`/`jq` (both in `preinstall.sh` PACKAGES) should be guarded with `command -v … || exit 1`.
 
 **Automation:** the runner is headless/timer-friendly — no TTY prompts, exit 0 on success / 1 on failure. A systemd timer (e.g. hourly) can call `pos entertainment send weather` directly. Note the config files live under the user's `$HOME`, so the timer must run as that user (a systemd **user** unit, or a system unit with `Environment=HOME=/home/<user>`).