From f84f1c0e26908e2a70777441e1174a26dca10b91 Mon Sep 17 00:00:00 2001
From: Sam Scholten
Date: Sun, 30 Aug 2026 20:51:41 +1000
Subject: serve: POST /api/poll manual trigger; rename feed to Fluxrecs

/api/poll runs an out-of-schedule poll through the same serialized path
as the scheduler (TryLock, so curls and refreshes can't race the cursor),
is POST-only, and 429s inside a 1-minute cooldown after any run. Response
is JSON: polled/new_run plus the fresh row's stats when entries arrived.
Also rename the RSS channel to Fluxrecs (Miniflux adopts upstream title
changes as the feed name). just poll-now wraps the curl.
---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 2550450..eb84765 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,9 @@ runs.jsonl         server run log; doubles as the RSS render source
 
 ## Notes
 
+- Serve surfaces: `GET /recommendations.xml`, `GET /api/status`, and
+  `POST /api/poll` (out-of-schedule poll; serialized with scheduled polls,
+  short cooldown, `curl -X POST https://server/api/poll`).
 - Never writes to Miniflux. Never needs credentials in the repo.
 - Training stays on the local PC; the server only scores (low RAM).
 - Deploy `serve` only after a `train` run on enough organic stars shows an
-- 
cgit v1.2.3