Version 1.1 of the hackorum-patch with update checks

This commit adds the necessary infrastructure for the feature both in
the web frontend and in the script. In the future, the script will
notify users if there is an update.

Author: dutow

app/controllers/scripts_controller.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class ScriptsController < ApplicationController
+  def version
+    script_name = params[:name]
+    changelog_path = Rails.root.join("public", "scripts", "#{script_name}.changelog.json")
+
+    unless File.exist?(changelog_path)
+      render json: { error: "Script not found" }, status: :not_found
+      return
+    end
+
+    cache_key = "scripts/#{script_name}/version/#{File.mtime(changelog_path).to_i}"
+
+    changelog_data = Rails.cache.fetch(cache_key, expires_in: 1.day) do
+      JSON.parse(File.read(changelog_path))
+    end
+
+    render json: changelog_data
+  end
+end

config/routes.rb

@@ -77,6 +77,9 @@
 
   # Help pages
   resources :help, only: [:index, :show], param: :slug
+
+  # Script version endpoint
+  get "scripts/:name/version", to: "scripts#version", as: :script_version
   get "person/*email/contributions/:year", to: "people#contributions", as: :person_contributions, format: false
   get "person/*email/activity/:date", to: "people#daily_activity", as: :person_activity, format: false
   get "person/*email/activity/month/:year/:month", to: "people#monthly_activity", as: :person_monthly_activity, format: false

public/scripts/hackorum-patch

@@ -10,9 +10,10 @@ require 'rubygems/package'
 require 'zlib'
 require 'stringio'
 require 'shellwords'
+require 'json'
 
 class HackorumPatch
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 
   def initialize(argv)
     @options = {}
@@ -51,6 +52,7 @@ class HackorumPatch
 
   def run
     print_banner
+    check_version
     validate_arguments!
     validate_git_repository!
 
@@ -150,6 +152,52 @@ class HackorumPatch
     puts ""
   end
 
+  def check_version
+    server_url = @server_url || @options[:server] || 'https://hackorum.dev'
+    version_url = "#{server_url}/scripts/hackorum-patch/version"
+
+    begin
+      uri = URI(version_url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      http.open_timeout = 2
+      http.read_timeout = 2
+
+      request = Net::HTTP::Get.new(uri)
+      response = http.request(request)
+
+      return unless response.is_a?(Net::HTTPSuccess)
+
+      data = JSON.parse(response.body)
+      remote_version = data['current_version']
+
+      return unless remote_version
+
+      local_ver = Gem::Version.new(VERSION)
+      remote_ver = Gem::Version.new(remote_version)
+
+      if remote_ver > local_ver
+        puts "[UPDATE] A newer version (#{remote_version}) is available!"
+
+        newer_versions = (data['versions'] || []).select do |v|
+          Gem::Version.new(v['version']) > local_ver
+        end
+
+        newer_versions.each do |v|
+          puts "  Changes in #{v['version']}:"
+          (v['changes'] || []).each do |change|
+            puts "    - #{change}"
+          end
+        end
+
+        puts "  Download: #{server_url}/help/hackorum-patch"
+        puts ""
+      end
+    rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, Net::OpenTimeout, Net::ReadTimeout, JSON::ParserError, SocketError
+      # Silently ignore version check failures - don't block the script
+    end
+  end
+
   def validate_arguments!
     if @using_local_file
       unless File.exist?(@local_archive)

public/scripts/hackorum-patch.changelog.json

@@ -0,0 +1,15 @@
+{
+  "current_version": "1.1.0",
+  "versions": [
+    {
+      "version": "1.1.0",
+      "date": "2026-01-21",
+      "changes": ["Added version check to notify users of updates"]
+    },
+    {
+      "version": "1.0.0",
+      "date": "2026-01-17",
+      "changes": ["Initial release"]
+    }
+  ]
+}