feat: integrate html2rss validate CLI and add editor schema support

- CI: bump actions/checkout and actions/setup-node to v4; add "Validate
  configs" step to the lint job using `make validate`
- Makefile: add `validate` target (html2rss validate over all configs),
  add `schema` target (html2rss schema --write); include validate in the
  default goal; drop obsolete migrate-tests/restore-tests targets whose
  backing script no longer exists; fix double-space in prettier invocation
- README: add Validation section documenting `make validate` and the
  single-file CLI; add Editor Setup section explaining how to generate
  schema/html2rss-config.schema.json and use it in VS Code or any
  yaml-language-server editor via the modeline comment
- .vscode/settings.json: associate generated schema with all configs so
  VS Code + YAML extension provides inline validation automatically
- .gitignore: exclude /schema/ (generated artifact)

https://claude.ai/code/session_01MYdMDpKySqfU1E3qgdikoe

Author: claude

.github/workflows/ruby.yml

@@ -11,14 +11,13 @@ 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: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -29,6 +28,9 @@ jobs:
       - name: Run linters
         run: make lint
 
+      - name: Validate configs
+        run: make validate
+
   test:
     strategy:
       fail-fast: false
@@ -38,7 +40,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 +55,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/settings.json

@@ -0,0 +1,5 @@
+{
+  "yaml.schemas": {
+    "./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
+	npx prettier --check lib/**/*.yml .github/**/*.yml README.md
+
+validate:
+	find lib/html2rss/configs -name '*.yml' -print0 | xargs -0 -n1 bundle exec html2rss validate
+
+schema:
+	mkdir -p schema
+	bundle exec html2rss schema --write schema/html2rss-config.schema.json
 
 test:
 	bundle exec rspec
@@ -39,18 +46,6 @@ test-debug:
 	fi
 	DEBUG_CONFIG=$(CONFIG) bundle exec rspec spec/html2rss/configs_dynamic_spec.rb
 
-# Migration commands
-migrate-tests:
-	bin/migrate_to_dynamic_tests
-
-restore-tests:
-	@if [ -d "spec/html2rss/configs_backup" ]; then \
-		cp -r spec/html2rss/configs_backup/* spec/html2rss/configs/; \
-		echo "✅ Restored tests from backup"; \
-	else \
-		echo "❌ No backup found"; \
-	fi
-
 lintfix:
 	bundle exec rubocop -a
 	npx 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,35 @@ 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.
+
+**Step 1** — Generate the schema from the installed gem:
+
+```bash
+make schema
+# writes schema/html2rss-config.schema.json
+```
+
+**Step 2** — The included `.vscode/settings.json` automatically associates the schema
+with all configs in `lib/html2rss/configs/`. Open the project in VS Code and the
+[YAML extension](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
+will pick it up immediately.
+
+For other editors that support the `yaml-language-server` protocol, add this
+modeline at the top of any config file:
+
+```yaml
+# yaml-language-server: $schema=../../../../schema/html2rss-config.schema.json
+```
+
+> Re-run `make schema` after upgrading the html2rss gem to keep the schema in sync.
+
 ## Documentation
 
 - [Main Documentation](https://html2rss.github.io/html2rss-configs/)