# SESSION.md — POS-Automation

## Context Files

- `/root/bin/core_homelab.md` — cluster topology, SSH aliases
- `/root/bin/services_directory.md` — active service IPs and domains
- `/root/bin/SESSION.md` — global session memory
- `./CONTEXT.md` — project infrastructure, config keys, known issues
- `./config.example.json` — config template

## Project Summary

POS-only daily news briefing for the **Epson TM-m30** receipt printer (`192.168.0.137:9100`). Fetches unread articles from FreshRSS, selects and summarizes them using Ollama, collects dashboard data (weather, ZFS, Grafana, markets, Uptime Kuma), builds a native ESC/POS receipt via `python-escpos`, and sends it over TCP. Runs daily at 04:30 via cron on CT 166 (`192.168.0.175`). Forked and rewritten from `Seth/PrinterAutomation` — all PDF, CUPS, Telegram, and WhatsApp code removed.

## Gitea

- Repo: `https://git.sethpc.xyz/Seth/POS-Automation`
- Remote: `https://<token>@git.sethpc.xyz/Seth/POS-Automation.git`
- Parent repo: `https://git.sethpc.xyz/Seth/PrinterAutomation`
- API key: see `/root/bin/printer-automation/GITEA_API.md`

---

## Session Notes

### Infrastructure decisions

- **ESC/POS over TCP only** — printer at `192.168.0.137:9100`. No CUPS fallback, no PDF. The TM-m30 accepts raw ESC/POS bytes directly on port 9100.
- **No Telegram/WhatsApp** — alert integrations existed in the parent project but were never intentionally active for POS output. Removed entirely.
- **No CLI flags** — parent script had `--POS` / `--pdfonly` / standard-mode paths. This project is always POS; the script runs one path unconditionally.
- **Config key renames from parent** — `pos_printer_ip` → `printer_ip`, added `printer_port`. Removed: `printer_name`, `remote_path`, `telegram_token`, `telegram_chat_id`, `whatsapp_number`.
- **`config.json` not committed** — `.gitignore` excludes it. Use `config.example.json` as template.
- **This machine is CT 166 (`.175`), not CT 629 (`.174`)** — CT 629 (OpenClaw) is stopped. Cron and manual runs both happen on CT 166 (OpenClaw2). Confirmed via `ip addr`.

### Bug fixes & discoveries

- **Missing weather on cron run** — WMO weather code map was incomplete (e.g. code 73 = moderate snow not mapped, returned `'Unk'`). Expanded map to cover all common WMO codes (51-55 drizzle, 61-65 rain, 71-77 snow/sleet, 80-86 showers, 95-99 storms). Also increased API timeout from 5s → 15s to prevent silent failures. Bare `except: return None` was swallowing the error with no output.
- **Telegram alerts firing unexpectedly** — parent script's top-level `except` block sent Telegram on any unhandled exception. When FreshRSS was unreachable, the no-items fallback crashed on `cups.Connection()` and triggered it. Fixed by removing CUPS and Telegram entirely.
- **FreshRSS unreachable from CT 166 via direct IP** — intermittent `Connection refused` on `192.168.0.157:80` even though host is pingable and Apache is running inside CT 120. Appears to be a transient Proxmox vmbr ARP/firewall state issue — resolves on its own. `fresh.sethpc.xyz` (Caddy) works as fallback but can return 502 when proxying slowly. Best approach: use direct IP, accept occasional failures.
- **Gitea direct IP (`192.168.0.125:80`) unreachable from CT 166** — must use `git.sethpc.xyz` (Caddy, port 443).
- **Archive of old project** — original files from `printer-automation/` were moved to `printer-automation/Archive/` before the Gitea clone was pulled in. Old `summarize_news.py` is preserved there if needed.

### Open threads

- [x] Update crontab to point to `/root/bin/POS-Automation/pos_briefing.py` — runs at 4:58 AM and 3:00 PM daily
- [ ] Uptime Kuma check (`pct exec 147`) always returns None inside a CT — consider querying the Kuma HTTP status API instead
- [ ] ETH-USD yfinance occasionally fails with NoneType — add per-ticker exception handling
- [ ] Investigate why CT 166 intermittently cannot reach CT 120 (`192.168.0.157:80`) — check Proxmox firewall rules on the bridge