gotsha 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2d8a54936a5f4177dc541bf77ad000ff0a047fb987206992a8380fce12bbe98a
+  data.tar.gz: cf1c7d18088b0dc33170416b6803bfcddfa47e44fed4d479eb4a84ae48ee8ef6
+SHA512:
+  metadata.gz: b23a2dd6fc8aa5365f8e8b3d24e1f44d336098333429d0b3359423d84956843f362823ab0becfe96f2970dc9ebffb618a76d7f265b14ab605c3718fb608336eb
+  data.tar.gz: 8d88f4379b75bc59b213d7c94e457d02a529e5376cd1a4243fd835b280061b6f39a4d213aa382280483585744719aa58ce19455f6fb3a73aab181fdcde803c43

data/.gotsha/config.toml

@@ -0,0 +1,10 @@
+post_commit_tests = true
+pre_push_tests = true
+interrupt_push_on_tests_failure = false
+
+commands = [
+  "rubocop",
+  "rspec --order rand"
+]
+
+verbose = false

data/.gotsha/github_action_example.yml

@@ -0,0 +1,29 @@
+# If you want to create Github Action, copy this file into .gihtub folder
+# For example to: .github/workflows/main.yml
+name: Gotsha
+
+on:
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Fetch gotsha notes
+        run: git fetch origin 'refs/notes/gotsha:refs/notes/gotsha'
+
+      - name: Verify gotsha note
+        run: |
+          SHA="${{ github.event.pull_request.head.sha }}"
+          NOTE="$(git notes --ref=gotsha show "$SHA" 2>/dev/null || true)"
+          if [ "$NOTE" = "ok" ]; then
+            echo "✓ gotsha verified for $SHA"
+          else
+            echo "::error ::Missing gotsha note for $SHA"
+            exit 1
+          fi

data/.gotsha/hooks/post-commit

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+[ -f .gotsha/config.toml ] || exit 0
+grep -qE 'post_commit_tests\s*=\s*true' .gotsha/config.toml || exit 0
+exe/gotsha test
+

data/.gotsha/hooks/pre-push

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+[ -f .gotsha/config.toml ] || exit 0
+
+grep -qE 'pre_push_tests\s*=\s*true' .gotsha/config.toml && (exe/gotsha status || exe/gotsha test)
+
+push_gotsha_notes() {
+  # if already done before, let's only push the notes and exit
+  git push --no-verify origin refs/notes/gotsha:refs/notes/gotsha && return 0
+
+  # if pushing above failed, it means we need to do some one-time Git setup
+  git fetch origin 'refs/notes/gotsha:refs/notes/gotsha-remote'
+  git notes --ref=gotsha merge -v refs/notes/gotsha-remote
+  git update-ref -d refs/notes/gotsha-remote
+
+  # ... and push again!
+  git push --no-verify origin refs/notes/gotsha:refs/notes/gotsha
+}
+
+push_gotsha_notes

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,19 @@
+AllCops:
+  TargetRubyVersion: 2.6
+  NewCops: disable
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Metrics/MethodLength:
+  Max: 20
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-09-14
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Vitek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,19 @@
+# Gotsha — your local CI (alpha coming soon)
+Pushing untested commits? Gotsha!
+
+## What is it?
+Gotsha is a tiny tool that lets you “sign off” your commit locally: it runs your tests and then stores the test results with the commit SHA (hence the gem name: got-SHA). Your pull request can then be verified against that record, so reviewers know you actually ran the checks before asking for review.
+
+Instead of pushing everything to CI, you can run the same checks locally (faster, cheaper, works offline) and prove you did it. Gotsha will make this proof visible in your pull request.
+
+And the best part? It all happens automatically!
+
+<img width="664" height="523" alt="image" src="https://github.com/user-attachments/assets/6acb4a69-c405-420e-9a05-9b28df4ea1f0" />
+
+Then, you can see the tests results in a Github action:
+
+<img width="1022" height="858" alt="image" src="https://github.com/user-attachments/assets/cf5d6492-02a0-47ee-81ee-4e34234a7983" />
+
+(Screenshots from a real [demo pull request](https://github.com/melounvitek/gotsha/pull/35); check it out!)
+
+Based on your workflow and tests speed, you can configure them to auto-run on every commit, before every push, or just manually. Whenever pushing to remote repository, the Git note (which is what's used to store the test results) gets sent there as well.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/exe/gotsha

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/gotsha"
+
+action = ARGV.first
+
+begin
+  message = Gotsha::ActionDispatcher.call(action)
+  puts("\n✓ Gotsha: #{message}\n\n")
+  exit 0
+rescue Gotsha::Errors::SoftFail => e
+  puts "\n✗ Gotsha: #{e.message}\n\n"
+  exit 0
+rescue Gotsha::Errors::HardFail => e
+  puts "\n✗ Gotsha: #{e.message}\n\n"
+  exit 1
+end

data/lib/gotsha/action_dispatcher.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Gotsha
+  class ActionDispatcher
+    INIT_SETUP_ACTION = "init"
+    DEFAULT_ACTION = "help"
+
+    def self.call(action_name = DEFAULT_ACTION)
+      action_name ||= DEFAULT_ACTION
+
+      new.call(action_name)
+    end
+
+    def call(action_name)
+      @action_name = action_name
+
+      verify_configuration!
+
+      action_class.new.call
+    end
+
+    private
+
+    attr_reader :action_name
+
+    def verify_configuration!
+      return if action_name.to_s == INIT_SETUP_ACTION
+
+      raise(Errors::HardFail, "config files not found, please run `bundle exec gotsha init` first") if UserConfig.blank?
+
+      hooks_dir = BashCommand.run!("git config core.hooksPath").text_output
+
+      unless hooks_dir == Config::HOOKS_DIR
+        raise(Errors::HardFail, "Git hooks not configured, please run `bundle exec gotsha init`")
+      end
+
+      return unless UserConfig.get(:autogenerated)
+
+      raise Errors::HardFail,
+            "autogenerated config detected! Please, remove `autogenerated = true` from `.gotsha/config.toml`"
+    end
+
+    def action_class
+      Kernel.const_get("Gotsha::Actions::#{action_name.capitalize}")
+    rescue NameError
+      raise Errors::HardFail, "unknown command `#{action_name}`. #{Actions::Help.new.call}"
+    end
+  end
+end

data/lib/gotsha/actions/commit.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Commit
+      def call
+        BashCommand.silent_run!('git -c core.hooksPath=/dev/null commit --allow-empty -m "Run Gotsha"')
+
+        Test.new.call
+      end
+    end
+  end
+end

data/lib/gotsha/actions/help.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Help
+      def call
+        commands = Gotsha::Actions.constants.map(&:downcase).sort.join("\n")
+
+        "Available commands: \n\n#{commands}"
+      end
+    end
+  end
+end

data/lib/gotsha/actions/init.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Init
+      def call
+        puts "Creating files..."
+
+        config_files!
+        github_action!
+        hooks!
+
+        # TODO: I don't like this
+        Kernel.system("git config --local core.hooksPath .gotsha/hooks")
+
+        "done"
+      end
+
+      private
+
+      def config_files!
+        return if File.exist?(Config::CONFIG_FILE)
+
+        FileUtils.mkdir_p(Config::CONFIG_DIR)
+
+        File.write(Config::CONFIG_FILE, File.read(Config::CONFIG_TEMPLATE_PATH))
+      end
+
+      def github_action!
+        return if File.exist?(Config::GH_CONFIG_FILE)
+
+        FileUtils.mkdir_p(".github")
+        FileUtils.mkdir_p(".github/workflows")
+        File.write(Config::GH_CONFIG_FILE, File.read(Config::GH_CONFIG_TEMPLATE_PATH))
+      end
+
+      def hooks!
+        return if File.exist?("#{Config::HOOKS_DIR}/post-commit") && File.exist?("#{Config::HOOKS_DIR}/pre-push")
+
+        FileUtils.mkdir_p(Config::HOOKS_DIR)
+
+        %w[post-commit pre-push].each do |hook|
+          src = File.join(Config::HOOKS_TEMPLATES_DIR, "git_hooks", hook)
+          dst = File.join(Config::HOOKS_DIR, hook)
+
+          FileUtils.cp(src, dst)
+          FileUtils.chmod("+x", dst)
+        end
+      end
+    end
+  end
+end

data/lib/gotsha/actions/show.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Show
+      def call
+        command = BashCommand.silent_run!("git --no-pager notes --ref=gotsha show")
+
+        raise(Errors::HardFail, "not verified yet") unless command.success?
+
+        gotsha_result = command.text_output
+
+        raise(Errors::HardFail, gotsha_result) if gotsha_result.start_with?(Test::TESTS_FAILED_NOTE_PREFIX)
+
+        gotsha_result
+      end
+    end
+  end
+end

data/lib/gotsha/actions/status.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Status
+      def call
+        last_commit_sha = BashCommand.run!("git --no-pager rev-parse HEAD").text_output
+
+        last_commit_note =
+          BashCommand.run!("git --no-pager notes --ref=gotsha show #{last_commit_sha}").text_output
+
+        if last_commit_note.start_with?("error: no note found") || last_commit_note.to_s.empty?
+          raise(Errors::HardFail,
+                "not verified yet")
+        end
+
+        raise(Errors::HardFail, "tests failed") if last_commit_note.start_with?(Test::TESTS_FAILED_NOTE_PREFIX)
+
+        unless last_commit_note.start_with?(Test::TESTS_PASSED_NOTE_PREFIX)
+          raise(Errors::HardFail, "unknown note content")
+        end
+
+        "tests passed"
+      end
+    end
+  end
+end

data/lib/gotsha/actions/test.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Test
+      TESTS_PASSED_NOTE_PREFIX = "Tests passed:"
+      TESTS_FAILED_NOTE_PREFIX = "Tests failed:"
+
+      def initialize
+        @tests_text_outputs = []
+      end
+
+      def call
+        ensure_commands_defined!
+        run_commands!
+        create_git_note!(TESTS_PASSED_NOTE_PREFIX)
+
+        "commit verified"
+      end
+
+      private
+
+      def ensure_commands_defined!
+        return if commands.any?
+
+        raise(Errors::HardFail,
+              "please, define some test commands in `.gotsha/config.toml`")
+      end
+
+      def run_commands!
+        commands.each do |command|
+          puts "Running `#{command}`..."
+
+          command_result = BashCommand.run!(command)
+
+          @tests_text_outputs << command_result.text_output
+
+          next if command_result.success?
+
+          create_git_note!(TESTS_FAILED_NOTE_PREFIX)
+          puts command_result.text_output.split("\n").last(20).join("\n")
+
+          raise fail_exception, "tests failed (run `bundle exec gotsha show` for full output)"
+        end
+      end
+
+      def create_git_note!(prefix_text = "")
+        body = +""
+        body << prefix_text.to_s
+        body << "\n\n" unless prefix_text.to_s.empty?
+        body << @tests_text_outputs.join("\n\n")
+
+        b64 = [body].pack("m0") # base64 (no newlines)
+        esc = b64.gsub("'", %q('"'"')) # escape single quotes
+
+        BashCommand.silent_run!(
+          "PAGER=cat GIT_PAGER=cat sh -c 'printf %s \"#{esc}\" | base64 -d | git notes --ref=gotsha add -f -F -'"
+        )
+      end
+
+      def fail_exception
+        if UserConfig.get(:interrupt_push_on_tests_failure)
+          Errors::HardFail
+        else
+          Errors::SoftFail
+        end
+      end
+
+      def commands
+        @commands ||= UserConfig.get(:commands) || []
+      end
+    end
+  end
+end

data/lib/gotsha/actions/uninstall.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Actions
+    class Uninstall
+      def call
+        puts "Removing config files..."
+
+        FileUtils.rm_rf(Config::CONFIG_DIR)
+        FileUtils.rm(Config::GH_CONFIG_FILE)
+
+        puts "Unsetting Git hooks path..."
+        BashCommand.silent_run!("git config --unset core.hooksPath")
+
+        "done"
+      end
+    end
+  end
+end

data/lib/gotsha/bash_command.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "pty"
+require "shellwords"
+
+module Gotsha
+  class BashCommand
+    FORCE_OUTPUT_AFTER = 5
+
+    def self.run!(command)
+      start_time = Time.now
+      UserConfig.get(:verbose) && puts(command)
+
+      stdout = +""
+
+      wrapped = %(script -qefc #{Shellwords.escape(command)} /dev/null)
+
+      io = IO.popen(wrapped, in: File::NULL, err: %i[child out])
+      begin
+        io.each do |line|
+          (UserConfig.get(:verbose) || Time.now - start_time > FORCE_OUTPUT_AFTER) && puts(line)
+          stdout << line
+        end
+      ensure
+        _, status = Process.wait2(io.pid)
+      end
+
+      new(stdout, status)
+    end
+
+    def self.silent_run!(command)
+      return run!(command) if UserConfig.get(:verbose)
+
+      run!("#{command} 2>&1")
+    end
+
+    def initialize(stdout, status)
+      @stdout = stdout
+      @status = status
+    end
+
+    def success?
+      @status.success?
+    end
+
+    def text_output
+      @stdout.to_s.strip
+    end
+  end
+end

data/lib/gotsha/config.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Config
+    CONFIG_DIR = ".gotsha"
+    CONFIG_FILE = File.join(CONFIG_DIR, "config.toml")
+    CONFIG_TEMPLATE_PATH = File.expand_path("templates/config.toml", __dir__)
+    GH_CONFIG_FILE = File.join(".github", "workflows", "gotsha.yml")
+    GH_CONFIG_TEMPLATE_PATH = File.expand_path("templates/github_action_example.yml", __dir__)
+    HOOKS_TEMPLATES_DIR = File.expand_path("templates", __dir__)
+    HOOKS_DIR = File.join(CONFIG_DIR, "hooks")
+  end
+end

data/lib/gotsha/errors.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Gotsha
+  module Errors
+    class HardFail < StandardError; end
+    class SoftFail < StandardError; end
+  end
+end

data/lib/gotsha/templates/config.toml

@@ -0,0 +1,39 @@
+#
+# Gotsha
+#
+# Start by removing the `autogenerated` line below. While doing that,
+# please, check the rest of this file to configure Gotsha as you need
+#
+autogenerated = true # Remove this line to start using Gotsha
+
+#
+# Test commands
+# 
+# This is where you define what tests to run and how.
+# Multiple (comma-separated) commands supported, see the
+# commented examples:
+#
+commands = [
+#  "bundle exec rubocop",
+#  "rspec --order rand",
+#  "docker exec -it great-app rspec"
+]
+
+# Git hooks config
+#
+# Set when Gotsha should run your tests automatically. Every
+# test run stores the test results to the commit.
+#
+# If you decide to not use any hooks,
+# you can create sign-off commit manually by this command:
+#
+# ```
+#   bundle exec gotsha commmit
+# ```
+#
+post_commit_tests = false # run tests for every commit
+pre_push_tests = true # run tests on every push
+interrupt_push_on_tests_failure = false # prohibit pushing when tests fail
+
+# Print out some debug details
+verbose = false

data/lib/gotsha/templates/git_hooks/post-commit

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+[ -f .gotsha/config.toml ] || exit 0
+grep -qE 'post_commit_tests\s*=\s*true' .gotsha/config.toml || exit 0
+bundle exec gotsha test
+

data/lib/gotsha/templates/git_hooks/pre-push

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+[ -f .gotsha/config.toml ] || exit 0
+
+grep -qE 'pre_push_tests\s*=\s*true' .gotsha/config.toml && (bundle exec gotsha status || bundle exec gotsha test)
+
+push_gotsha_notes() {
+  # if already done before, let's only push the notes and exit
+  git push --no-verify origin refs/notes/gotsha:refs/notes/gotsha && return 0
+
+  # if pushing above failed, it means we need to do some one-time Git setup
+  git fetch origin 'refs/notes/gotsha:refs/notes/gotsha-remote'
+  git notes --ref=gotsha merge -v refs/notes/gotsha-remote
+  git update-ref -d refs/notes/gotsha-remote
+
+  # ... and push again!
+  git push --no-verify origin refs/notes/gotsha:refs/notes/gotsha
+}
+
+push_gotsha_notes

data/lib/gotsha/templates/github_action_example.yml

@@ -0,0 +1,44 @@
+name: Gotsha
+
+on:
+  pull_request:
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Fetch Gotsha notes
+        run: git fetch origin 'refs/notes/gotsha:refs/notes/gotsha'
+
+      - name: Show tests output
+        run: |
+          SHA="${{ github.event.pull_request.head.sha }}"
+          if git --no-pager notes --ref=gotsha show "$SHA" >/dev/null 2>&1; then
+            git --no-pager notes --ref=gotsha show "$SHA"
+          else
+            echo "No gotsha note found for $SHA"
+          fi
+
+      - name: Verify
+        run: |
+          SHA="${{ github.event.pull_request.head.sha }}"
+          NOTE="$(git --no-pager notes --ref=gotsha show "$SHA" 2>/dev/null || true)"
+
+          if [ -z "$NOTE" ]; then
+          echo "::error ::Gotsha: not verified yet. Run 'gotsha commit' to verify."
+            exit 1
+          elif [[ "$NOTE" == Tests\ failed:* ]]; then
+          git --no-pager notes --ref=gotsha show "$SHA"
+          echo "::error ::Gotsha: Tests failed"
+            exit 1
+          elif [[ "$NOTE" == Tests\ passed:* ]]; then
+          echo "✓ Gotsha: tests passed"
+          else
+            echo "::error ::Unrecognized Gotsha note format for $SHA"
+            exit 1
+          fi

data/lib/gotsha/user_config.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Gotsha
+  class UserConfig
+    def self.get(key)
+      config = TomlRB.load_file(Config::CONFIG_FILE).transform_keys(&:to_sym)
+
+      ENV["GOTSHA_#{key.to_s.upcase}"] || # this allows changing config via ENV vars
+        config[key]
+    rescue Errno::ENOENT
+      nil
+    end
+
+    def self.blank?
+      TomlRB.load_file(Config::CONFIG_FILE).empty?
+    rescue Errno::ENOENT
+      true
+    end
+  end
+end

data/lib/gotsha/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Gotsha
+  VERSION = "0.1.0"
+end

data/lib/gotsha.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "toml-rb"
+
+require_relative "gotsha/action_dispatcher"
+require_relative "gotsha/actions/commit"
+require_relative "gotsha/actions/help"
+require_relative "gotsha/actions/init"
+require_relative "gotsha/actions/show"
+require_relative "gotsha/actions/test"
+require_relative "gotsha/actions/uninstall"
+require_relative "gotsha/actions/status"
+require_relative "gotsha/bash_command"
+require_relative "gotsha/config"
+require_relative "gotsha/errors"
+require_relative "gotsha/user_config"
+require_relative "gotsha/version"
+
+module Gotsha
+  include Config
+  include Errors
+
+  # Main entry-point: `Gotsha::ActionDispatcher.call(action_name)`
+end

data/sig/gotsha.rbs

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

data/web/index.html

@@ -0,0 +1,142 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <link rel="icon" href="favicon.ico" />
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Gotsha — your local CI</title>
+  <meta name="description" content="Gotsha — sign off your commits locally by running tests & linters and proving it in your PR." />
+  <style>
+    :root{
+      --bg:#0D1117;           /* GitHub dark */
+      --text:#E6EDF3;         /* subtle off-white */
+      --muted:#8B949E;
+      --accent:#00FF66;       /* terminal green */
+      --card:#0F1320;
+      --border:#1F2430;
+    }
+    *{box-sizing:border-box}
+    html,body{height:100%}
+    body{
+      margin:0;
+      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "DejaVu Sans Mono", "Courier New", monospace;
+      background: radial-gradient(1200px 600px at 50% -10%, #101622 0%, var(--bg) 50%);
+      color:var(--text);
+      line-height:1.6;
+    }
+    .container{max-width:980px;margin:0 auto;padding:32px}
+    header{display:flex;align-items:center;gap:18px;margin-top:32px}
+    .logo{width:260px; max-width: 80vw;}
+    .title{font-size:clamp(22px, 4vw, 28px);letter-spacing:.4px}
+    main{margin-top:36px}
+    .hero{
+      display:grid;
+      grid-template-columns: 1fr;
+      gap:22px;
+      background:linear-gradient(180deg, var(--card), rgba(15,19,32,.6));
+      border:1px solid var(--border);
+      border-radius:18px;
+      padding:28px;
+      box-shadow: 0 10px 30px rgba(0,0,0,.35);
+    }
+    .hero h1{
+      margin:0;
+      font-size:clamp(28px, 6vw, 42px);
+      line-height:1.15;
+    }
+    .hero p{margin:0;color:var(--muted);font-size:clamp(14px, 2.5vw, 18px)}
+    .actions{display:flex;gap:12px;flex-wrap:wrap;margin-top:10px}
+    .btn{
+      appearance:none;border:1px solid var(--border);
+      background:#0b111b;color:var(--text);
+      padding:10px 14px;border-radius:10px;text-decoration:none;
+      font-weight:600;
+    }
+    .btn.primary{border-color:color-mix(in srgb, var(--accent) 60%, #000);
+      background:linear-gradient(180deg, color-mix(in srgb, var(--accent) 18%, #000) , #0b111b);
+      color:var(--accent);
+      box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--accent) 35%, #000);
+    }
+    .grid{display:grid;grid-template-columns:1fr;gap:14px;margin-top:20px}
+    .card{
+      border:1px solid var(--border);border-radius:14px;padding:16px;background:#0b111b75
+    }
+    .card h3{margin:0 0 6px 0;font-size:18px}
+    .foot{margin-top:24px;color:var(--muted);font-size:13px}
+    /* subtle animations */
+    @keyframes glow { from { filter: drop-shadow(0 0 0 rgba(0,255,102,0)); }
+                      to   { filter: drop-shadow(0 0 6px rgba(0,255,102,.55)); } }
+    .logo .node{animation: glow 1.6s ease-in-out infinite alternate}
+    @media (prefers-reduced-motion: reduce){ .logo .node{animation:none} }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <svg class="logo" viewBox="0 0 820 210" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Gotsha logo">
+        <defs>
+          <style>
+            .w { fill: #E6EDF3; }
+            .g { fill: #00FF66; }
+            .stroke { stroke: #00FF66; stroke-width: 20; stroke-linecap: round; stroke-linejoin: round; fill: none; }
+          </style>
+        </defs>
+        <!-- Wordmark: Got + SHA -->
+        <g transform="translate(120,148)">
+          <!-- 'Got' -->
+          <text class="w" x="0" y="0" font-size="112" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'DejaVu Sans Mono', 'Courier New', monospace">Got</text>
+          <!-- 'SHA' -->
+          <text class="g" x="215" y="0" font-size="112" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'DejaVu Sans Mono', 'Courier New', monospace">SHA</text>
+        </g>
+        <!-- Checkmark integrated near 'SHA' -->
+        <path class="stroke" d="M660,120 l35,35 70,-80"/>
+      </svg>
+      <div class="title">Your local CI</div>
+    </header>
+
+    <main>
+      <section class="hero" aria-labelledby="hero-title">
+        <h1 id="hero-title">Sign-off your commits locally — and let others see it.</h1>
+        <p>Run tests & linters on your machine, store results as Git notes, and let your PR show your tests output. Quickly and automatically.</p>
+        <div class="actions">
+          <a class="btn primary" href="https://github.com/melounvitek/gotsha" target="_blank">View more details on Github</a>
+          <a class="btn secondary" href="https://github.com/melounvitek/gotsha/pull/35" target="_blank">Demo pull request</a>
+        </div>
+      </section>
+
+      <section class="grid">
+        <article class="card">
+          <h3>1) Runs locally</h3>
+          <p>Gotsha runs the project test suite on your machine. This can happen automatically (for every Git commit or push), or manually; right before you ask for review. You can easily configure it whatever way suits your project best.</p>
+        </article>
+        <article class="card">
+          <h3>2) Stores test results for commit SHA</h3>
+          <p>Test results from every run are attached as <em>Git notes</em> for the recent commit SHA. (Got-SHA... you get it, right?)</p>
+        </article>
+        <article class="card">
+          <h3>3) Displays results in your GitHub PR</h3>
+          <p>Push as usual — the note follows your commit, and tiny Github Action instantly verifies it
+              and makes the tests result visible to reviewers. <a target="_blank" href="https://gotsha.org/failed_build.png">Check it out</a>; it even persist all the colors!</p>
+        </article>
+      </section>
+
+          <!--
+      <section class="card" id="install" aria-labelledby="install-title">
+        <h3 id="install-title">Install</h3>
+          <p>Install</p>
+        <pre><code># RubyGems
+gem install gotsha
+
+# Or add to your Gemfile
+gem 'gotsha'</code></pre>
+      </section>
+          -->
+
+      <p class="foot">
+          © <span id="y"></span> <a target="_blank" href="https://x.com/melounvitek">Vítek Meloun</a> (<a target="_blank" href="mailto:vitek@meloun.info">vitek@meloun.info</a>)
+        </p>
+    </main>
+  </div>
+  <script>document.getElementById('y').textContent = new Date().getFullYear();</script>
+</body>
+</html>

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: gotsha
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vitek Meloun
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: toml-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+email:
+- vitek@meloun.info
+executables:
+- gotsha
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gotsha/config.toml"
+- ".gotsha/github_action_example.yml"
+- ".gotsha/hooks/post-commit"
+- ".gotsha/hooks/pre-push"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/gotsha
+- lib/gotsha.rb
+- lib/gotsha/action_dispatcher.rb
+- lib/gotsha/actions/commit.rb
+- lib/gotsha/actions/help.rb
+- lib/gotsha/actions/init.rb
+- lib/gotsha/actions/show.rb
+- lib/gotsha/actions/status.rb
+- lib/gotsha/actions/test.rb
+- lib/gotsha/actions/uninstall.rb
+- lib/gotsha/bash_command.rb
+- lib/gotsha/config.rb
+- lib/gotsha/errors.rb
+- lib/gotsha/templates/config.toml
+- lib/gotsha/templates/git_hooks/post-commit
+- lib/gotsha/templates/git_hooks/pre-push
+- lib/gotsha/templates/github_action_example.yml
+- lib/gotsha/user_config.rb
+- lib/gotsha/version.rb
+- sig/gotsha.rbs
+- web/favicon.ico
+- web/index.html
+- web/logo.png
+homepage: https://www.gotsha.org/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://www.gotsha.org/
+  source_code_uri: https://github.com/melounvitek/gotsha
+  changelog_uri: https://github.com/melounvitek/gotsha
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'Gotsha: your local CI'
+test_files: []