docs: add Quickstart guide and fix README accuracy

- Add a step-by-step Quickstart (build, config, demo feeds, apply,
  refresh, generate, view) with the feed apply/reconcile mechanism.
- Add Mistral to the supported providers list.
- Fix the feed scraping field (top-level 'scraping', not a
  'dynamic_scraping' scraper key) and the DOWNLINK_* env prefix.

Author: ma111e

README.md

@@ -1,42 +1,38 @@
-# DOWNLINK
+# Downlink
 
 [![CI](https://github.com/ma111e/downlink/actions/workflows/ci.yml/badge.svg)](https://github.com/ma111e/downlink/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Go Version](https://img.shields.io/badge/go-1.25-00ADD8.svg)](go.mod)
+[![Docker Image](https://img.shields.io/github/v/tag/ma111e/downlink?logo=docker&logoColor=white&label=ghcr.io%2Fma111e%2Fdownlink&color=2496ED)](https://github.com/ma111e/downlink/pkgs/container/downlink)
 
-A feed aggregator and content-analysis platform for security news. DOWNLINK
+A feed aggregator and content-analysis platform for security news. Downlink
 collects RSS/Atom feeds, scrapes full article content, runs each article through
 an LLM for rubric-based scoring and summarization, and assembles ranked digests
 that it can publish to GitHub Pages and Discord.
 
-```
-feeds → scrape → LLM analysis & scoring → digest → publish (GitHub Pages / Discord)
-```
-
 ## Features
 
-- **Multi-provider LLMs** — Anthropic Claude, OpenAI, vLLM, Ollama, and llama.cpp
-  (any OpenAI-compatible endpoint). Configure several and pick one per run.
-- **Rubric scoring** — articles are scored on six dimensions (specificity, severity,
+- **Multi-provider LLMs** Claude, ChatGPT Codex, Mistral, vLLM, Ollama, and llama.cpp
+  (any OpenAI-compatible endpoint)
+- **Scoring** articles are either vibe scored by the LLM or based on six dimensions (specificity, severity,
   breadth, novelty, actionability, credibility) rather than a single opaque number.
   See [`pkg/scoring`](pkg/scoring).
-- **Flexible scraping** — plain RSS, dynamic scraping (Lightpanda), and full-browser
-  scraping (Solimen) with per-feed CSS selectors, triggers, blacklists, and headers.
-- **Digest generation** — categorized, importance-ranked digests with deduplication.
-- **Publishing** — push static digests to GitHub Pages and notify a Discord webhook.
-- **Interfaces** — gRPC API (default `:50051`), an Atom feed export (`:65261`), and the
+- **Flexible scraping** plain RSS, dynamic scraping (Lightpanda), and full-browser
+  scraping ([Solimen](https://github.com/ma111e/solimen)) with per-feed CSS selectors, triggers, blacklists, and headers.
+- **Digest generation** categorized, importance-ranked digests with deduplication.
+- **Publishing** push static digests to GitHub Pages and notify a Discord webhook.
+- **Interfaces** gRPC API (default `:50051`), an Atom feed export (`:65261`), and the
   `dlk` command-line client.
-- **Storage** — embedded SQLite via GORM; no external database required.
 
 ## Architecture
 
 | Component         | Path          | Description                                                         |
 | ----------------- | ------------- | ------------------------------------------------------------------- |
-| Server            | `cmd/server`  | gRPC services + feed manager + Atom feed export. The core daemon.   |
-| CLI (`dlk`)       | `cmd/dlk`     | gRPC client for articles, feeds, analysis, digests, config, queue.  |
+| Server            | `cmd/server`  | gRPC services + feed manager + Atom feed export.   |
+| CLI (`dlk`)       | `cmd/dlk`     | gRPC client for articles, feeds, analysis, digests, config, queue management.  |
 | Shared packages   | `pkg/`        | Scoring, LLM gateway/providers, codex auth, models, protobufs.      |
 
-The server exposes gRPC services for articles, analysis, feeds, digests, queue,
+The server exposes gRPC services for articles, analysis, feeds, digests, queue management,
 config, and auth. The Atom feed server publishes analyzed articles at
 `http://localhost:65261`.
 
@@ -45,16 +41,16 @@ config, and auth. The Atom feed server publishes analyzed articles at
 With Go 1.25+:
 
 ```sh
-go install github.com/ma111e/downlink/cmd/dlk@latest      # CLI
-go install github.com/ma111e/downlink/cmd/server@latest   # server
+go install github.com/ma111e/downlink/cmd/dlk@latest # CLI
+go install github.com/ma111e/downlink/cmd/server@latest # server
 ```
 
 Or build from source:
 
 ```sh
-make all        # builds server + cli
-make server     # build just the server (embeds the git commit)
-make cli        # build just dlk
+make all # builds server + cli
+make server # build just the server
+make cli # build just dlk
 ```
 
 Or with Docker:
@@ -70,59 +66,122 @@ docker run --rm -p 50051:50051 -p 65261:65261 \
 A `docker-compose.yml` is provided that also wires up the optional Solimen
 full-browser scraper.
 
-## Configuration
+## Quickstart
 
-DOWNLINK reads configuration from three sources. Copy the bundled examples and
-fill in your values:
+**1. Build the binaries** (see [Install](#install)):
 
 ```sh
-cp config.example.json config.json   # LLM providers, analysis, notifications
-cp feeds.example.yml   feeds.yml      # feed sources and per-feed scraping rules
-cp .env.example        .env           # runtime/env overrides
+make all # produces ./server and ./dlk
 ```
 
-- **`config.json`** — LLM provider definitions (name, type, model, base URL, API key),
-  the active analysis provider and persona/writing style, and notification settings
-  (Discord webhook, GitHub Pages repo/token/branch). See
-  [config.example.json](config.example.json).
-- **`feeds.yml`** — the list of feeds with per-feed scraping strategy, CSS selectors,
-  triggers, blacklists, and custom HTTP headers. See [feeds.example.yml](feeds.example.yml).
-- **`.env` / environment** — every server flag has a `DOWNLINK_*` env var equivalent
-  (loaded via Viper). See [.env.example](.env.example). Precedence: CLI flag → env/`.env`
-  → `config.json` → default.
+**2. Create your config** and enable at least one LLM provider (analysis needs one;
+fetching feeds does not):
+
+```sh
+cp config.example.json config.json
+$EDITOR config.json # enable a provider + fill in its api_key
+```
 
-> **Secrets:** `config.json`, `.env`, and `feeds.yml` are gitignored. Never commit
-> real API keys, tokens, or webhook URLs.
+**3. Write a demo `feeds.yml`** with a few public security feeds:
+
+```yaml
+feeds:
+  - url: https://cert.gov.ua/api/articles/rss
+    title: Cert-UA
+    type: rss
+    enabled: true
+    scraping: dynamic # "dynamic" (Lightpanda) or "full_browser" (Solimen); omit for static RSS
+    scraper:
+      article: div.article-item__content # CSS selector for the article body
+  - url: https://www.bleepingcomputer.com/feed/
+    title: Bleeping Computer
+    type: rss
+    enabled: true
+    scraper:
+      triggers:
+          loaded:
+              - article .article_section
+    scraping: full_browser
+    selectors:
+      article: div.articleBody
+  - url: https://feeds.feedburner.com/TheHackersNews
+    title: The Hacker News
+    type: rss
+    enabled: true
+    scraper:
+      triggers:
+          loaded:
+              - div.main-box
+    scraping: full_browser
+    selectors:
+      article: '#articlebody'
+      cutoff: .stophere
 
-## Running
+```
+
+> The quickstart mixes scraping modes: `scraping: dynamic` needs **Lightpanda** and
+> `scraping: full_browser` needs **Solimen**. The `--auto-start-*` flags in step 4
+> launch both in Docker. For a no-dependencies first run, drop the
+> `scraping`/`scraper`/`selectors` keys to use plain RSS.
 
-Start the server:
+**4. Start the server** (in one terminal). The quickstart feeds use both scrapers, so start
+them too (requires Docker):
 
 ```sh
-./server --refresh                     # fetch all feeds on startup
-./server --port 50051 --log-level info
+./server --auto-start-lightpanda --auto-start-solimen
 ```
 
-Use the CLI against a running server:
+**5. Apply the feeds.** `dlk feed apply` reconciles the database to match the file —
+feeds in the file are created or updated, and feeds no longer listed are disabled
+(their articles are kept). Preview first with `--dry-run`:
 
 ```sh
-dlk feed list
-dlk article list
-dlk analysis run
-dlk digest generate
-dlk --help
+./dlk feed apply -f feeds.yml --dry-run # show what would change
+./dlk feed apply -f feeds.yml # apply it
 ```
 
-Check versions:
+**6. Fetch and generate a digest.** `digest generate` analyzes any not-yet-scored
+articles with your LLM provider, then assembles the ranked digest:
 
 ```sh
-./server --version
-dlk --version
+./dlk feed refresh all # pull the latest articles
+./dlk digest generate  # analyze + assemble the ranked digest
 ```
 
+**7. View the result:**
+
+```sh
+./dlk digest list # list generated digests
+./dlk digest get  # pick one and view it (add --markdown for prose)
+```
+
+`./dlk feed export -f feeds.yml` does the reverse of step 5: it writes the feeds
+currently in the database back out to a YAML file.
+
+## Configuration
+
+Downlink reads configuration from three sources. Copy the bundled examples and
+fill in your values:
+
+```sh
+cp config.example.json config.json # LLM providers, analysis, notifications
+cp feeds.example.yml feeds.yml # feed sources and per-feed scraping rules
+cp .env.example .env # runtime/env overrides
+```
+
+- **`config.json`** LLM provider definitions (name, type, model, base URL, API key),
+  the active analysis provider and persona/writing style, and notification settings
+  (Discord webhook, GitHub Pages repo/token/branch). See
+  [config.example.json](config.example.json).
+- **`feeds.yml`** the list of feeds with per-feed scraping strategy, CSS selectors,
+  triggers, blacklists, and custom HTTP headers. See [feeds.example.yml](feeds.example.yml).
+- **`.env`** every server flag has a `DOWNLINK_*` env var equivalent
+  (loaded automatically via Viper). See [.env.example](.env.example). Precedence: CLI flag -> env variables/`.env`
+  -> `config.json` -> default.
+
 ## Publishing digests
 
-DOWNLINK can publish generated digests to GitHub Pages and announce them on Discord.
+Downlink can publish generated digests to GitHub Pages and announce them on Discord.
 See [docs/github-pages.md](docs/github-pages.md) for the full setup, including
 `--init-gh-pages` and the required token scopes.