fix(llms): add deadline slack to pipeline timeout checks; tighten docs prose

Author: ma111e

cmd/server/internal/services/llms.go

@@ -695,10 +695,11 @@ func (s *LLMsServer) runAnalysisPipeline(ctx context.Context, req *protos.Analyz
 	// Ensure the pipeline has at least 60 minutes total (tasks run sequentially;
 	// each individual Stream call gets its own provider-configured sub-deadline below).
 	const pipelineTimeout = 60 * time.Minute
+	const deadlineSlack = 1 * time.Minute // absorb elapsed time / equal-deadline callers
 	if deadline, ok := ctx.Deadline(); ok {
 		remaining := time.Until(deadline)
 		log.Infof("Context deadline: %v (remaining: %v)", deadline, remaining)
-		if remaining < pipelineTimeout {
+		if remaining < pipelineTimeout-deadlineSlack {
 			log.Warnf("Context deadline shorter than preferred pipeline timeout (%v < %v); preserving caller cancellation", remaining, pipelineTimeout)
 		}
 	} else {
@@ -875,10 +876,11 @@ func (s *LLMsServer) AnalyzeArticleWithProgress(ctx context.Context, req *protos
 
 func (s *LLMsServer) AnalyzeArticleOneShot(ctx context.Context, req *protos.AnalyzeArticleWithProviderModelRequest, onTask func(taskName, status string, taskIndex, totalTasks int, err error)) (*protos.AnalyzeArticleWithProviderModelResponse, error) {
 	const oneShotTimeout = 60 * time.Minute
+	const deadlineSlack = 1 * time.Minute // absorb elapsed time / equal-deadline callers
 	if deadline, ok := ctx.Deadline(); ok {
 		remaining := time.Until(deadline)
 		log.Infof("Context deadline: %v (remaining: %v)", deadline, remaining)
-		if remaining < oneShotTimeout {
+		if remaining < oneShotTimeout-deadlineSlack {
 			log.Warnf("Context deadline shorter than preferred one-shot timeout (%v < %v); preserving caller cancellation", remaining, oneShotTimeout)
 		}
 	} else {

docs/README.md

@@ -4,8 +4,8 @@ Downlink is a feed aggregator and content-analysis platform for security news. I
 RSS/Atom feeds, scrapes full article content, scores and summarizes each article with an
 LLM, and assembles ranked digests it can publish to GitHub Pages and Discord.
 
-New here? Start with [getting-started.md](getting-started.md). The project
-[README](../README.md) has the high-level overview and install instructions.
+Start with [getting-started.md](getting-started.md). The project
+[README](../README.md) covers the overview and install.
 
 ## Guides
 

docs/getting-started.md

@@ -1,7 +1,6 @@
 # Getting started
 
-This walks through a first run from a clean checkout. The project README has the same path
-in condensed form; this page adds the details it skips.
+A first run from a clean checkout: install, configure, fetch, and produce a digest.
 
 ## Install
 

docs/github-pages.md

@@ -171,7 +171,7 @@ Each entry in `digests`:
 
 ## 7. Discord publish notification
 
-The `discord_webhook_url` field is distinct from the main `notifications.discord.webhook_url`. It is designed to post a lightweight one-line message when a page goes live:
+The `discord_webhook_url` field is distinct from the main `notifications.discord.webhook_url`. It posts a one-line message when a page goes live:
 
 ```
 📰 New digest published to GitHub Pages: https://you.github.io/digests/downlink-digest-2026-04-24_1200.html