ci: fix setup-go cache and refresh docs
ci / check (push) Successful in 54s
ci / check (pull_request) Successful in 56s

setup-go@v5 aborts when go.sum is missing, and this stdlib-only module has none. Disable the action cache and cap the job at 10 minutes.

Lead the README with what the service does and a runnable quick start, fix stale contract and cache comments, and remove comments that only restate the code.
This commit is contained in:
Noel Sabia committed 2026-11-14 09:14:09 +01:00
1 parent 80c8eeb0b9
commit f4693af748
12 files changed
+66 -26

No files matched your search

+1
View File
@@ -157,6 +157,7 @@ func (s *Server) handleContext(w http.ResponseWriter, _ *http.Request) {
cached := true
if s.cache != nil {
ctx = s.cache.Context()
// A failed refresh keeps the old context in place, so mark it cached.
cached = !s.cache.Fresh()
}
s.setVersions(w)
+1
View File
@@ -87,6 +87,7 @@ func (s *Server) liveForecast(ctx context.Context, sensor, horizon, scenarioName
ctxData := s.cache.Context()
precip := ctxData.Weather.Now.PrecipMM
// A zero override means "no scenario rain"; keep the cached current value.
if state.Scenario.Weather.PrecipMM > 0 {
precip = state.Scenario.Weather.PrecipMM
}
+2 -2
View File
@@ -13,8 +13,8 @@ import (
"pulsecast/api/internal/model"
)
// maxTrainBody bounds an uploaded CSV. The raw dataset is ~18 MB; 64 MB leaves
// room for a larger export without letting the API accept unbounded bodies.
// maxTrainBody bounds an uploaded CSV so a client cannot stream an unbounded
// body through the proxy.
const maxTrainBody = 64 << 20
// handleTrain proxies POST /api/train to FastAPI. The request is queued there,
+3 -1
View File
@@ -1,5 +1,5 @@
// Package api wires the HTTP handlers, scenario state, SSE hub and cache
// fallback into the Go service described by CONTRACT.md.
// fallback into the Go service.
package api
import (
@@ -108,6 +108,8 @@ var methodTable = map[string][]string{
"/api/stream": {"GET"},
}
// routeCheck keeps unknown routes and methods in the JSON error envelope;
// ServeMux would otherwise answer them in plain text.
func (s *Server) routeCheck(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
methods, ok := methodTable[r.URL.Path]