feat: add config validation workflow and editor schema hints

.github/workflows/ruby.yml

@@ -11,14 +11,16 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: "20"
 
       - name: Install dependencies
-        run: |
-          sudo apt-get install -yqq yamllint
+        run: sudo apt-get install -yqq yamllint
+
+      - name: Install Node dependencies
+        run: npm ci --ignore-scripts --no-fund --no-audit
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -29,6 +31,9 @@ jobs:
       - name: Run linters
         run: make lint
 
+      - name: Validate configs
+        run: make validate
+
   test:
     strategy:
       fail-fast: false
@@ -38,7 +43,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -53,7 +58,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1

.gitignore

@@ -7,6 +7,7 @@
 /spec/reports/
 /tmp/
 /node_modules/
+/schema/
 
 # rspec failure tracking
 .rspec_status

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations": [
+    "redhat.vscode-yaml"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "yaml.schemas": {
+    "https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json": "lib/html2rss/configs/**/*.yml"
+  }
+}

Makefile

@@ -1,9 +1,16 @@
-default: lint test
+default: lint validate test
 
 lint:
 	yamllint lib/html2rss/configs/ .github/
 	bundle exec rubocop -P -f quiet
-	npx prettier --check lib/**/*.yml .github/**/*.yml  README.md
+	./node_modules/.bin/prettier --check lib/**/*.yml .github/**/*.yml README.md
+
+validate:
+	bundle exec ruby bin/validate_configs
+
+schema:
+	mkdir -p schema
+	bundle exec html2rss schema --write schema/html2rss-config.schema.json
 
 test:
 	bundle exec rspec
@@ -46,4 +53,4 @@ restore-tests:
 
 lintfix:
 	bundle exec rubocop -a
-	npx prettier --write lib/**/*.yml .github/**/*.yml README.md
+	./node_modules/.bin/prettier --write lib/**/*.yml .github/**/*.yml README.md

README.md

@@ -40,6 +40,18 @@ channel:
 
 The `type` field specifies the parameter type (currently only `string` is supported), and `default` provides the default value when no parameter is explicitly provided.
 
+## Validation
+
+Validate configs against the html2rss schema before committing:
+
+```bash
+# Validate all configs
+make validate
+
+# Validate a single config directly
+bundle exec html2rss validate lib/html2rss/configs/github.com/releases.yml
+```
+
 ## Testing
 
 Uses **dynamic test generation** - no individual spec files needed!
@@ -55,10 +67,29 @@ make test-config CONFIG=github.com/releases.yml
 make test-domain DOMAIN=github.com
 ```
 
-**Adding new configs**: Just create the YAML file and run tests. No spec file needed.
+**Adding new configs**: Just create the YAML file and run `make validate` then tests. No spec file needed.
 
 **Config folder convention**: Place configs under the registrable domain folder (e.g., `example.com/` or `bbc.co.uk/`). Legacy subdomain folders (e.g., `news.example.com/`) are allowed but not preferred.
 
+## Editor Setup (JSON Schema)
+
+Get inline validation and autocompletion when editing configs in your IDE.
+All config files already carry the schema modeline at the top:
+
+```yaml
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
+```
+
+Any editor with [yaml-language-server](https://github.com/redhat-developer/yaml-language-server)
+support (VS Code + [YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml),
+Neovim, Helix, …) will automatically pick up the schema when opening a config file.
+
+The included `.vscode/settings.json` additionally associates the schema with all
+configs via a glob pattern, so new files get validation before the modeline is added.
+
+> `make schema` writes `schema/html2rss-config.schema.json` locally — useful for
+> offline editing or when you want to pin against the currently installed gem version.
+
 ## Documentation
 
 - [Main Documentation](https://html2rss.github.io/html2rss-configs/)

bin/setup

@@ -1,8 +1,33 @@
 #!/usr/bin/env bash
 set -euo pipefail
 IFS=$'\n\t'
-set -vx
 
+echo "==> Installing Ruby dependencies..."
 bundle install
 
-# Do any other automated setup that you need to do here
+echo
+echo "==> Installing Node dependencies (required for make lint)..."
+npm install --ignore-scripts --no-fund --no-audit
+
+echo
+echo "==> Checking system tools..."
+if command -v yamllint &>/dev/null; then
+  echo "    yamllint: ok ($(yamllint --version))"
+else
+  echo "    yamllint: not found"
+  echo "    Install with one of:"
+  echo "      brew install yamllint"
+  echo "      pip install yamllint"
+fi
+
+echo
+echo "==> Setup complete. Common commands:"
+echo
+echo "    make              # lint + validate + test"
+echo "    make lint         # yamllint, rubocop, prettier"
+echo "    make validate     # validate all configs against the html2rss schema"
+echo "    make test         # run rspec"
+echo
+echo "    make test-config CONFIG=github.com/releases.yml   # test a single config"
+echo "    make test-domain DOMAIN=github.com                # test all configs for a domain"
+echo "    make schema                                        # write schema locally (optional)"

bin/validate_configs

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'html2rss'
+require 'yaml'
+
+files = Dir['lib/html2rss/configs/**/*.yml']
+failed = []
+
+files.each do |file|
+  begin
+    config = YAML.safe_load_file(file, symbolize_names: true)
+    result = Html2rss::Config.validate(config)
+
+    if result.success?
+      puts "ok   #{file}"
+    else
+      puts "FAIL #{file}"
+      result.errors.to_h.each do |key, messages|
+        Array(messages).each { |msg| warn "       #{key}: #{msg}" }
+      end
+      failed << file
+    end
+  rescue Psych::Exception => e
+    puts "FAIL #{file}"
+    warn "       parse: #{e.message}"
+    failed << file
+  rescue StandardError => e
+    puts "FAIL #{file}"
+    warn "       validation: #{e.class}: #{e.message}"
+    failed << file
+  end
+end
+
+puts
+if failed.empty?
+  puts "#{files.size} configs validated successfully."
+else
+  warn "#{failed.size}/#{files.size} configs failed validation."
+  exit 1
+end

lib/html2rss/configs/adfc.de/pressemitteilungen.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.adfc.de/presse/pressemitteilungen/
   time_zone: Europe/Berlin

lib/html2rss/configs/apnews.com/hub.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 parameters:
   section:

lib/html2rss/configs/avherald.com/index.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://avherald.com/

lib/html2rss/configs/bbc.co.uk/available_episodes.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 parameters:
   id:
     type: string

lib/html2rss/configs/bbc.com/mundo.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://www.bbc.com/mundo

lib/html2rss/configs/blog.mondediplo.net/feed.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 parameters:
   blog:
     type: string

lib/html2rss/configs/canarianweekly.com/front.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.canarianweekly.com/
   time_zone: Europe/London

lib/html2rss/configs/cinemascore.com/index.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://webapp.cinemascore.com/guest/surveys
   ttl: 720

lib/html2rss/configs/cleanenergywire.org/news.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.cleanenergywire.org/news-archive
   time_zone: "Europe/Berlin"

lib/html2rss/configs/cnet.com/section_sub.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 parameters:
   section:

lib/html2rss/configs/computerbase.de/meistgelesen.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   title: "computerbase.de: meistgelesen"
   url: https://www.computerbase.de

lib/html2rss/configs/cutle.fish/index.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://cutle.fish/

lib/html2rss/configs/deraktionaer.de/meistgelesen.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   title: "deraktionaer.de: meistgelesen"
   url: https://deraktionaer.de/

lib/html2rss/configs/developer.apple.com/tutorials_data_documentation_technotes_json.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   json: true

lib/html2rss/configs/dfs.de/pressemitteilungen.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.dfs.de/homepage/de/medien/presse/
   time_zone: Europe/Berlin

lib/html2rss/configs/dsw-info.de/presse.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.dsw-info.de/presse
   time_zone: Europe/Berlin

lib/html2rss/configs/espn.com/f1.yml

@@ -1,9 +1,12 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
+strategy: default
 channel:
   url: https://www.espn.com/f1/
   time_zone: UTC
   ttl: 60
 selectors:
   items:
+    s: 'dfd'
     selector: ".headlineStack__list > li"
   title:
     selector: "a"

lib/html2rss/configs/fia.com/documents.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://www.fia.com/documents/championships/fia-formula-one-world-championship-14/season/season-2026-2072

lib/html2rss/configs/formula1.com/latest.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.formula1.com/en/latest/all.html
   time_zone: UTC

lib/html2rss/configs/github.com/releases.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 parameters:
   username:
     type: string

lib/html2rss/configs/iaapa.org/news.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.iaapa.org/news
   time_zone: UTC

lib/html2rss/configs/imdb.com/ratings.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 parameters:
   user_id:
     type: string

lib/html2rss/configs/ingenieur.de/karriere_arbeitsleben_heiko_mell.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://www.ingenieur.de/karriere/arbeitsleben/heiko-mell/

lib/html2rss/configs/kinocheck.de/filmstarts.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://kinocheck.de/filmstarts
   time_zone: Europe/Berlin

lib/html2rss/configs/microsoft.com/azure-products.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://azure.microsoft.com/en-us/products
   language: en

lib/html2rss/configs/newyorker.com/magazine.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://www.newyorker.com/magazine

lib/html2rss/configs/nomanssky.com/news.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://www.nomanssky.com/news/

lib/html2rss/configs/pankow.lebensmittel-kontrollergebnisse.de/search.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://pankow.lebensmittel-kontrollergebnisse.de/Search

lib/html2rss/configs/phys.org/weekly.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://phys.org/weekly-news/
   time_zone: Europe/London

lib/html2rss/configs/rbb24.de/meistgeklickt.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   title: "rbb24.de: meistgeklickt"
   url: https://rbb24.de/

lib/html2rss/configs/robinwood.de/aktuelles.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 channel:
   url: https://www.robinwood.de/was-gibt-es-neues/aktuelles
   time_zone: Europe/Berlin

lib/html2rss/configs/s3.amazonaws.com/popular_movies.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 # This generates a RSS of the daily updated
 # https://github.com/sjlu/popular-movies
 channel:

lib/html2rss/configs/sebastianvettel.de/news.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/html2rss/html2rss/refs/heads/master/schema/html2rss-config.schema.json
 ---
 channel:
   url: https://sebastianvettel.de/news/