regresso 0.1.0

data/lib/regresso/web_ui/public/js/app.js

@@ -0,0 +1,117 @@
+const listEl = document.getElementById("results-list");
+const refreshBtn = document.getElementById("refresh");
+const detailTitle = document.getElementById("detail-title");
+const detailMeta = document.getElementById("detail-meta");
+const detailSummary = document.getElementById("detail-summary");
+const detailDiffs = document.getElementById("detail-diffs");
+const filterPath = document.getElementById("filter-path");
+const filterType = document.getElementById("filter-type");
+const statTotal = document.getElementById("stat-total");
+const statPassed = document.getElementById("stat-passed");
+const statFailed = document.getElementById("stat-failed");
+
+let currentId = null;
+
+async function fetchJson(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Request failed: ${response.status}`);
+  }
+  return response.json();
+}
+
+function formatDate(dateString) {
+  const date = new Date(dateString);
+  return date.toLocaleString();
+}
+
+function renderList(results) {
+  listEl.innerHTML = "";
+  if (!results.length) {
+    listEl.innerHTML = '<div class="empty">No results yet.</div>';
+    return;
+  }
+
+  results.forEach((result) => {
+    const item = document.createElement("div");
+    item.className = "list-item" + (result.id === currentId ? " active" : "");
+    item.innerHTML = `
+      <strong>${result.name || "Run"}</strong>
+      <div>${formatDate(result.created_at)}</div>
+      <div>${result.summary ? `diffs: ${result.summary.meaningful_diffs}` : ""}</div>
+    `;
+    item.addEventListener("click", () => selectResult(result.id));
+    listEl.appendChild(item);
+  });
+}
+
+function renderSummary(summary) {
+  if (!summary) {
+    detailSummary.innerHTML = "";
+    return;
+  }
+
+  detailSummary.innerHTML = `
+    <div class="summary-card"><span>Total diffs</span><strong>${summary.total_diffs}</strong></div>
+    <div class="summary-card"><span>Meaningful</span><strong>${summary.meaningful_diffs}</strong></div>
+    <div class="summary-card"><span>Ignored</span><strong>${summary.ignored_diffs}</strong></div>
+    <div class="summary-card"><span>Passed</span><strong>${summary.passed}</strong></div>
+  `;
+}
+
+async function renderDiffs(id) {
+  const params = new URLSearchParams();
+  if (filterPath.value) params.set("path", filterPath.value);
+  if (filterType.value) params.set("type", filterType.value);
+  params.set("format", "html");
+
+  const data = await fetchJson(`/api/results/${id}/diffs?${params.toString()}`);
+  if (!data.diffs.length) {
+    detailDiffs.innerHTML = '<div class="empty">No matching diffs.</div>';
+    return;
+  }
+
+  detailDiffs.innerHTML = data.formatted;
+}
+
+async function selectResult(id) {
+  currentId = id;
+  const result = await fetchJson(`/api/results/${id}`);
+
+  detailTitle.textContent = result.name || "Regression Run";
+  detailMeta.textContent = `Created ${formatDate(result.created_at)}`;
+  renderSummary(result.summary);
+  await renderDiffs(id);
+
+  const results = await fetchJson("/api/results");
+  renderList(results);
+}
+
+async function refresh() {
+  const results = await fetchJson("/api/results");
+  renderList(results);
+
+  const passed = results.filter((item) => item.summary && item.summary.passed).length;
+  statTotal.textContent = results.length;
+  statPassed.textContent = passed;
+  statFailed.textContent = results.length - passed;
+}
+
+filterPath.addEventListener("input", () => {
+  if (currentId) {
+    renderDiffs(currentId);
+  }
+});
+
+filterType.addEventListener("change", () => {
+  if (currentId) {
+    renderDiffs(currentId);
+  }
+});
+
+refreshBtn.addEventListener("click", refresh);
+
+refresh().catch((error) => {
+  console.error(error);
+  listEl.innerHTML = '<div class="empty">Failed to load results.</div>';
+});

data/lib/regresso/web_ui/result_store.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+require "securerandom"
+
+module Regresso
+  module WebUI
+    # Simple file-backed store for Web UI results.
+    class ResultStore
+      # @param storage_path [String,nil]
+      def initialize(storage_path: nil)
+        @storage_path = storage_path || "tmp/regresso_results"
+        @cache = {}
+        FileUtils.mkdir_p(@storage_path)
+      end
+
+      # @param result [Hash]
+      # @return [String] stored result id
+      def store(result)
+        id = SecureRandom.uuid
+        data = { "id" => id, "created_at" => Time.now.utc.iso8601(6) }.merge(result)
+        File.write(path_for(id), JSON.generate(data))
+        @cache[id] = data
+        id
+      end
+
+      # @param id [String]
+      # @return [Hash,nil]
+      def find(id)
+        return @cache[id] if @cache.key?(id)
+
+        path = path_for(id)
+        return nil unless File.exist?(path)
+
+        @cache[id] = JSON.parse(File.read(path))
+      end
+
+      # @return [Array<Hash>]
+      def list
+        Dir.glob(File.join(@storage_path, "*.json")).map do |path|
+          find(File.basename(path, ".json"))
+        end.compact.sort_by { |entry| Time.parse(entry["created_at"].to_s) }.reverse
+      end
+
+      # @param id [String]
+      # @return [void]
+      def delete(id)
+        @cache.delete(id)
+        FileUtils.rm_f(path_for(id))
+      end
+
+      private
+
+      def path_for(id)
+        File.join(@storage_path, "#{id}.json")
+      end
+    end
+  end
+end

data/lib/regresso/web_ui/server.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "sinatra/base"
+require "json"
+require "time"
+require "regresso/web_ui/result_store"
+require "regresso/web_ui/diff_formatter"
+
+module Regresso
+  # Web UI server and helpers.
+  module WebUI
+    # Sinatra-based Web UI server.
+    class Server < Sinatra::Base
+      set :public_folder, File.join(__dir__, "public")
+      set :views, File.join(__dir__, "views")
+      set :result_store, ResultStore.new
+
+      get "/" do
+        erb :index
+      end
+
+      get "/api/results" do
+        content_type :json
+        settings.result_store.list.to_json
+      end
+
+      get "/api/results/:id" do
+        content_type :json
+        result = settings.result_store.find(params[:id])
+        halt 404, { error: "Not found" }.to_json unless result
+        result.to_json
+      end
+
+      post "/api/results" do
+        content_type :json
+        data = JSON.parse(request.body.read)
+        id = settings.result_store.store(data)
+        status 201
+        { id: id, status: "created" }.to_json
+      end
+
+      delete "/api/results/:id" do
+        settings.result_store.delete(params[:id])
+        status 204
+      end
+
+      get "/api/results/:id/diffs" do
+        content_type :json
+        result = settings.result_store.find(params[:id])
+        halt 404, { error: "Not found" }.to_json unless result
+
+        diffs = Array(result["diffs"])
+        if params[:type]
+          diffs = diffs.select { |diff| diff["type"] == params[:type] }
+        end
+        if params[:path]
+          diffs = diffs.select { |diff| diff["path"].to_s.include?(params[:path]) }
+        end
+
+        mode = params[:format] == "html" ? :html : :plain
+        formatter = DiffFormatter.new
+
+        {
+          diffs: diffs,
+          formatted: formatter.format(diffs, mode: mode)
+        }.to_json
+      end
+    end
+  end
+end

data/lib/regresso/web_ui/views/index.erb

@@ -0,0 +1,58 @@
+<section class="app-shell">
+  <header class="app-header">
+    <div>
+      <p class="kicker">Regresso</p>
+      <h1>Regression Hub</h1>
+      <p class="subtitle">Compare environments, surface drift, and keep releases honest.</p>
+    </div>
+    <div class="stats">
+      <div class="stat">
+        <span class="stat-label">Runs</span>
+        <span class="stat-value" id="stat-total">0</span>
+      </div>
+      <div class="stat">
+        <span class="stat-label">Passed</span>
+        <span class="stat-value" id="stat-passed">0</span>
+      </div>
+      <div class="stat">
+        <span class="stat-label">Failed</span>
+        <span class="stat-value" id="stat-failed">0</span>
+      </div>
+    </div>
+  </header>
+
+  <main class="app-main">
+    <section class="panel panel-list">
+      <div class="panel-header">
+        <h2>Recent Runs</h2>
+        <button class="button" id="refresh">Refresh</button>
+      </div>
+      <div class="list" id="results-list"></div>
+    </section>
+
+    <section class="panel panel-detail">
+      <div class="panel-header">
+        <div>
+          <h2 id="detail-title">Select a run</h2>
+          <p class="detail-meta" id="detail-meta">No run selected</p>
+        </div>
+        <div class="filters">
+          <input id="filter-path" class="input" type="text" placeholder="Filter by path">
+          <select id="filter-type" class="select">
+            <option value="">All types</option>
+            <option value="added">Added</option>
+            <option value="removed">Removed</option>
+            <option value="changed">Changed</option>
+          </select>
+        </div>
+      </div>
+
+      <div class="detail-grid">
+        <div class="summary" id="detail-summary"></div>
+        <div class="diffs" id="detail-diffs">
+          <div class="empty">Pick a run to see differences.</div>
+        </div>
+      </div>
+    </section>
+  </main>
+</section>

data/lib/regresso/web_ui/views/layout.erb

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Regresso Web UI</title>
+    <link rel="stylesheet" href="/css/app.css">
+  </head>
+  <body>
+    <%= yield %>
+    <script src="/js/app.js"></script>
+  </body>
+</html>

data/lib/regresso/web_ui.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require_relative "web_ui/result_store"
+require_relative "web_ui/diff_formatter"
+require_relative "web_ui/server"

data/lib/regresso.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative "regresso/version"
+require_relative "regresso/json_path"
+require_relative "regresso/difference"
+require_relative "regresso/configuration"
+require_relative "regresso/differ"
+require_relative "regresso/result"
+require_relative "regresso/comparator"
+require_relative "regresso/adapters/base"
+require_relative "regresso/adapters/proc"
+require_relative "regresso/adapters/json_file"
+require_relative "regresso/adapters/csv"
+require_relative "regresso/adapters/http"
+require_relative "regresso/adapters/database"
+require_relative "regresso/adapters/database_snapshot"
+require_relative "regresso/adapters/graphql"
+require_relative "regresso/adapters/graphql_batch"
+require_relative "regresso/snapshot_manager"
+require_relative "regresso/reporter"
+
+# Regresso provides regression comparison utilities for structured data.
+module Regresso
+  # Base error for Regresso-specific failures.
+  class Error < StandardError; end
+
+  class << self
+    attr_accessor :configuration
+
+    # Yields the global configuration.
+    #
+    # @yieldparam config [Regresso::Configuration]
+    # @return [void]
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+    end
+
+    # Resets the global configuration to defaults.
+    #
+    # @return [void]
+    def reset_configuration!
+      self.configuration = Configuration.new
+    end
+  end
+end

data/sig/regresso.rbs

@@ -0,0 +1,4 @@
+module Regresso
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

data/site/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+ruby ">= 3.2.0"
+
+gem "craze"