aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorSam Scholten2026-08-30 20:51:41 +1000
committerSam Scholten2026-08-30 20:51:41 +1000
commitf84f1c0e26908e2a70777441e1174a26dca10b91 (patch)
tree071b9edc337af700570c65f1ec9ad6b3291bb241 /README.md
parent49d9f3e0eaeeab234c3ec903be43b88919d98eff (diff)
downloadfluxrec-f84f1c0e26908e2a70777441e1174a26dca10b91.tar.gz
fluxrec-f84f1c0e26908e2a70777441e1174a26dca10b91.zip
serve: POST /api/poll manual trigger; rename feed to FluxrecsHEADmain
/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.
Diffstat (limited to 'README.md')
-rw-r--r--README.md3
1 files changed, 3 insertions, 0 deletions
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