.

Author: gildesmarais

.devcontainer/Dockerfile

@@ -1,38 +1,34 @@
-FROM mcr.microsoft.com/devcontainers/ruby:3.4-bullseye
+FROM ruby:3.4.6-alpine3.21
+
+SHELL ["/bin/sh", "-o", "pipefail", "-c"]
+
+RUN apk add --no-cache \
+    bash \
+    build-base \
+    curl \
+    git \
+    libxml2-dev \
+    libxslt-dev \
+    nodejs \
+    npm \
+    openssl-dev \
+    python3 \
+    tzdata
+
+ARG USER=vscode
+ARG UID=1000
+ARG GID=1000
+
+RUN addgroup -g "$GID" "$USER" \
+  && adduser -D -G "$USER" -u "$UID" "$USER"
 
-# Install Node.js 20
-RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
-  && apt-get install -y nodejs
-
-# Install system dependencies
-RUN apt-get update && apt-get install -y \
-  build-essential \
-  git \
-  curl \
-  && rm -rf /var/lib/apt/lists/*
-
-# Install development gems
-RUN gem install rubocop
-
-# Install global npm packages
-RUN npm install -g prettier
-
-# Create vscode user
-RUN groupadd --gid 1000 vscode \
-  && useradd --uid 1000 --gid vscode --shell /bin/bash --create-home vscode
-
-# Set up workspace
 WORKDIR /workspace
-RUN chown -R vscode:vscode /workspace
+RUN chown -R "$USER":"$USER" /workspace
 
-# Switch to vscode user
-USER vscode
+ENV BUNDLE_PATH=/usr/local/bundle
 
-# Set up environment
-RUN echo 'export BUNDLE_PATH="/usr/local/bundle"' >> ~/.bashrc
+USER "$USER"
 
-# Expose port
 EXPOSE 3000
 
-# Keep container running
 CMD ["sleep", "infinity"]

.github/copilot-instructions.md

@@ -41,10 +41,11 @@ Fix rubocop `RSpec/MultipleExpectations` adding rspec tag `:aggregate_failures`.
 - ✅ Add caching headers where appropriate (`Rack::Cache`).
 - ✅ Errors: friendly messages for users, detailed logging internally.
 - ✅ **Frontend**: Use Astro components in `frontend/src/`. Keep it simple.
-- ✅ **CSS**: Use frontend styles in `frontend/public/styles.css`. Water.css for fallback.
+- ✅ **CSS**: Use frontend styles provided by Astro Starlight.
 - ✅ **Specs**: RSpec for Ruby, build tests for frontend.
 
 ## Don't
+
 - ❌ Don't use Ruby's URI class or addressable gem directly. Strictly use `Html2rss::Url` only.
 - ❌ Don't bypass SSRF filter or weaken CSP.
 - ❌ Don't add databases, ORMs, or background jobs.
@@ -53,23 +54,6 @@ Fix rubocop `RSpec/MultipleExpectations` adding rspec tag `:aggregate_failures`.
 - ❌ Don't modify `frontend/dist/` - it's generated by build process.
 - ❌ NEVER expose the auth token a user provides.
 
-## Project Structure
-
-- `app.rb` – main Roda app
-- `app/` – core modules (config, cache, ssrf, health)
-- `routes/` – route handlers (`hash_branch`)
-- `helpers/` – pure helper modules (`module_function`)
-- `views/` – ERB templates (fallback)
-- `public/` – static assets (CSS/JS, minimal)
-- `frontend/` – Astro frontend application
-  - `src/pages/` – Astro pages (index.astro, gallery.astro)
-  - `src/layouts/` – Astro layouts (Layout.astro)
-  - `public/` – frontend static assets
-  - `package.json` – Node.js dependencies
-  - `astro.config.mjs` – Astro configuration
-- `config/feeds.yml` – feed definitions
-- `spec/` – RSpec tests + VCR cassettes
-
 ## Environment
 
 - `RACK_ENV` – environment
@@ -78,6 +62,7 @@ Fix rubocop `RSpec/MultipleExpectations` adding rspec tag `:aggregate_failures`.
 - `SENTRY_DSN` (optional)
 
 ### Verification Steps
+
 - Run `ruby -c app.rb` to check syntax
 - Run `bundle exec rspec` to verify tests
 - Check `bundle install` removes unused dependencies

.gitignore

@@ -40,6 +40,5 @@
 /frontend/dist/
 /frontend/.astro/
 /frontend/node_modules/
-/frontend/package-lock.json
 /public/frontend
 .yardoc

.vscode/extensions.json

@@ -2,7 +2,6 @@
   "recommendations": [
     "redhat.vscode-yaml",
     "esbenp.prettier-vscode",
-    "github.copilot",
     "shopify.ruby-lsp"
   ]
 }

Gemfile

@@ -30,6 +30,7 @@ group :development do
   gem 'rubocop-rake', require: false
   gem 'rubocop-rspec', require: false
   gem 'rubocop-thread_safety', require: false
+  gem 'ruby-lsp', require: false
   gem 'yard', require: false
 end
 

Gemfile.lock

@@ -142,6 +142,8 @@ GEM
     rack-unreloader (2.1.0)
     rainbow (3.1.1)
     rake (13.2.1)
+    rbs (3.9.5)
+      logger
     regexp_parser (2.11.3)
     reverse_markdown (3.0.0)
       nokogiri
@@ -190,6 +192,10 @@ GEM
     rubocop-thread_safety (0.7.2)
       lint_roller (~> 1.1)
       rubocop (~> 1.72, >= 1.72.1)
+    ruby-lsp (0.26.1)
+      language_server-protocol (~> 3.17.0)
+      prism (>= 1.2, < 2.0)
+      rbs (>= 3, < 5)
     ruby-progressbar (1.13.0)
     sanitize (7.0.0)
       crass (~> 1.0.2)
@@ -255,6 +261,7 @@ DEPENDENCIES
   rubocop-rake
   rubocop-rspec
   rubocop-thread_safety
+  ruby-lsp
   sentry-ruby
   simplecov
   ssrf_filter
@@ -268,7 +275,7 @@ CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
   bigdecimal (3.2.3) sha256=ffd11d1ac67a0d3b2f44aec0a6487210b3f813f363dd11f1fcccf5ba00da4e1b
-  byebug (12.0.0) sha256=d4a150d291cca40b66ec9ca31f754e93fed8aa266a17335f71bb0afa7fca1a1e
+  byebug (12.0.0)
   climate_control (1.2.0) sha256=36b21896193fa8c8536fa1cd843a07cf8ddbd03aaba43665e26c53ec1bd70aa5
   concurrent-ruby (1.3.5) sha256=813b3e37aca6df2a21a3b9f1d497f8cbab24a2b94cab325bffe65ee0f6cbebc6
   crack (1.0.0) sha256=c83aefdb428cdc7b66c7f287e488c796f055c0839e6e545fec2c7047743c4a49
@@ -321,6 +328,7 @@ CHECKSUMS
   rack-unreloader (2.1.0) sha256=18879cf2ced8ca21a01836bca706f65cce6ebe3f7d9d8a5157ce68ca62c7263a
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.2.1) sha256=46cb38dae65d7d74b6020a4ac9d48afed8eb8149c040eccf0523bec91907059d
+  rbs (3.9.5)
   regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
   reverse_markdown (3.0.0) sha256=ab228386765a0259835873cd07054b62939c40f620c77c247eafaaa3b23faca4
   rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
@@ -337,6 +345,7 @@ CHECKSUMS
   rubocop-rake (0.7.1) sha256=3797f2b6810c3e9df7376c26d5f44f3475eda59eb1adc38e6f62ecf027cbae4d
   rubocop-rspec (3.6.0) sha256=c0e4205871776727e54dee9cc91af5fd74578001551ba40e1fe1a1ab4b404479
   rubocop-thread_safety (0.7.2) sha256=bd51449c420b1ddda5672b71a39706367402beb55aaf19fc020c1868717f31f6
+  ruby-lsp (0.26.1)
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   sanitize (7.0.0) sha256=269d1b9d7326e69307723af5643ec032ff86ad616e72a3b36d301ac75a273984
   sentry-ruby (5.24.0) sha256=420b15f4d81cf1cfddc4cb73d2282bcbaf111fe3554a6aa142f4cee2b870c437

Makefile

@@ -23,10 +23,6 @@ setup: ## Full development setup
 
 dev: ## Start development server with live reload
 	@echo "Starting html2rss-web development environment..."
-	@echo "Ruby server: http://localhost:3000"
-	@echo "Astro dev server: http://localhost:3001 (with live reload)"
-	@echo "Main development URL: http://localhost:3001"
-	@echo ""
 	@bin/dev
 
 dev-ruby: ## Start Ruby server only

app.rb

@@ -153,7 +153,7 @@ def development? = self.class.development?
 
           r.get do
             JSON.generate({ success: true,
-                            data: { api: { name: 'html2rss-web API', version: '1.0.0',
+                            data: { api: { name: 'html2rss-web API',
                                            description: 'RESTful API for converting websites to RSS feeds' } } })
           end
         end

app/api/v1/health.rb

@@ -26,7 +26,6 @@ def show(request)
                 health: {
                   status: 'healthy',
                   timestamp: Time.now.iso8601,
-                  version: '1.0.0',
                   environment: ENV.fetch('RACK_ENV', 'development'),
                   uptime: Process.clock_gettime(Process::CLOCK_MONOTONIC),
                   checks: {}