superkick 0.1.0

data/lib/superkick/cli/monitor.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Superkick
+  class CLI < Thor
+    class MonitorCmd < Thor
+      package_name "superkick monitor"
+
+      desc "list", "List available monitor types and probe-detected configs"
+      option :no_probes, type: :boolean, default: false,
+        desc: "Skip running environment probes"
+      def list
+        Superkick::Monitor.registered.each do |type, klass|
+          $stdout.puts "#{type}:"
+          $stdout.puts "  #{klass.description}" if klass.description
+          $stdout.puts "  required config: #{klass.required_config.join(", ")}" unless klass.required_config.empty?
+          $stdout.puts "  events: #{klass.event_types.join(", ")}" unless klass.event_types.empty?
+
+          probe_klass = klass.probe_class
+          if probe_klass
+            desc = probe_klass.respond_to?(:description) ? probe_klass.description : nil
+            $stdout.puts "  probe: #{desc || "available"}"
+          end
+          $stdout.puts ""
+        end
+
+        unless options[:no_probes]
+          detected = Superkick::Monitor.detect_all(dir: Dir.pwd)
+          unless detected.empty?
+            $stdout.puts "Detected in current environment:"
+            detected.each do |name, config|
+              display_config = config.except("type")
+              $stdout.puts "  #{name} (type: #{config["type"] || name}): #{display_config.map { |k, v| "#{k}=#{v}" }.join(", ")}"
+            end
+          end
+        end
+      end
+
+      desc "install-templates", "Copy default monitor ERB templates to ~/.superkick/templates/"
+      option :force, type: :boolean, default: false, desc: "Overwrite existing templates"
+      def install_templates
+        TemplateRenderer.install_defaults(force: options[:force])
+      end
+
+      default_command :list
+    end
+  end
+end

data/lib/superkick/cli/notifier.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Superkick
+  class CLI < Thor
+    class NotifierCmd < Thor
+      package_name "superkick notifier"
+
+      desc "list", "List available notifier types"
+      def list
+        client = Control.client_from
+
+        unless client.alive?
+          $stdout.puts "Superkick server is not running."
+          return
+        end
+
+        result = client.request("discover_notifiers")
+        notifiers = result[:available_notifiers] || []
+
+        if notifiers.empty?
+          $stdout.puts "No notifier types registered."
+          return
+        end
+
+        notifiers.each do |notifier|
+          label = notifier[:type].to_s
+          label += " (stateful)" if notifier[:stateful]
+          $stdout.puts "#{label}:"
+          $stdout.puts "  #{notifier[:description]}" if notifier[:description]
+          $stdout.puts ""
+        end
+      rescue Control::Client::ServerUnavailable
+        $stdout.puts "Superkick server is not running."
+      end
+
+      default_command :list
+    end
+  end
+end

data/lib/superkick/cli/repository.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Superkick
+  class CLI < Thor
+    class RepositoryCmd < Thor
+      package_name "superkick repository"
+
+      desc "list", "List configured repositories"
+      option :json, type: :boolean, default: false, desc: "Output as JSON"
+      def list
+        client = Control.client_from
+
+        unless client.alive?
+          $stdout.puts "Superkick server is not running."
+          return
+        end
+
+        result = client.request("discover_repositories")
+        repositories = result[:repositories] || []
+
+        if options[:json]
+          $stdout.puts JSON.pretty_generate(repositories)
+          return
+        end
+
+        if repositories.empty?
+          $stdout.puts "No repositories configured."
+          return
+        end
+
+        repositories.each do |repo|
+          $stdout.puts "#{repo[:name]}:"
+          $stdout.puts "  path: #{repo[:path]}" if repo[:path]
+          $stdout.puts "  url: #{repo[:url]}" if repo[:url]
+          $stdout.puts "  vcs: #{repo[:version_control]}" if repo[:version_control]
+          $stdout.puts "  dependencies: #{repo[:dependencies].join(", ")}" if repo[:dependencies]&.any?
+          $stdout.puts ""
+        end
+      rescue Control::Client::ServerUnavailable
+        $stdout.puts "Superkick server is not running."
+      end
+
+      default_command :list
+    end
+  end
+end

data/lib/superkick/cli/server.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Superkick
+  class CLI < Thor
+    class Server < Thor
+      package_name "superkick server"
+
+      desc "start", "Start the Superkick server"
+      option :daemonize, type: :boolean, aliases: "-d", default: false,
+        desc: "Run in the background"
+      def start
+        Superkick::Server.start(daemonize: options[:daemonize])
+      end
+
+      desc "stop", "Send SIGTERM to the Superkick server"
+      def stop
+        unless File.exist?(Superkick.config.pid_path)
+          warn "Superkick server is not running (no PID file)."
+          exit(1)
+        end
+
+        pid = File.read(Superkick.config.pid_path).strip.to_i
+        Process.kill("TERM", pid)
+        $stdout.puts "Sent SIGTERM to PID #{pid}."
+      rescue Errno::ESRCH
+        warn "Process #{pid} not found — removing stale PID file."
+        FileUtils.rm_f(Superkick.config.pid_path)
+      end
+
+      desc "status", "Show server and agent status"
+      def status
+        client = Control.client_from
+
+        unless client.alive?
+          $stdout.puts "Superkick server is not running."
+          return
+        end
+
+        ping = client.request("ping")
+        agents = client.request("list_agents")[:agents] || []
+        spawners = client.request("list_spawners")[:spawners] || []
+
+        $stdout.puts "Superkick server running (v#{ping[:version]}, PID #{server_pid})"
+        $stdout.puts ""
+
+        if spawners.any?
+          $stdout.puts "Spawners:"
+          spawners.each do |sp|
+            $stdout.puts "  #{sp[:name]} (#{sp[:type]}): #{sp[:status]}"
+          end
+          $stdout.puts ""
+        end
+
+        if agents.empty?
+          $stdout.puts "  No active agents."
+        else
+          spawned, interactive = agents.partition { |s| s[:spawn_info] }
+
+          if interactive.any?
+            $stdout.puts "Interactive agents:"
+            interactive.each { print_status_line(it) }
+            $stdout.puts ""
+          end
+
+          if spawned.any?
+            $stdout.puts "Spawned agents:"
+            spawned.each do |s|
+              origin = s[:spawn_info][:spawner_name]
+              print_status_line(s, suffix: "via #{origin}")
+            end
+            $stdout.puts ""
+          end
+        end
+      rescue Control::Client::ServerUnavailable
+        $stdout.puts "Superkick server is not running."
+      end
+
+      desc "log", "Tail the server log"
+      option :lines, type: :numeric, aliases: "-n", default: 50,
+        desc: "Number of lines to show"
+      def log
+        unless File.exist?(Superkick.config.log_path)
+          warn "Log file not found: #{Superkick.config.log_path}"
+          exit(1)
+        end
+
+        system("tail", "-n", options[:lines].to_s, "-f", Superkick.config.log_path)
+      end
+
+      default_command :start
+
+      private
+
+      def print_status_line(s, suffix: nil)
+        buf = s[:has_buffer] ? "pty-connected" : "no-pty"
+        line = "  Agent #{s[:agent_id]}: #{s[:monitor_count]} monitor(s) [#{buf}]"
+        line += " (#{suffix})" if suffix
+        $stdout.puts line
+      end
+
+      def server_pid
+        File.exist?(Superkick.config.pid_path) ? File.read(Superkick.config.pid_path).strip : "unknown"
+      end
+    end
+  end
+end

data/lib/superkick/cli/setup.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+require "tty-prompt"
+
+module Superkick
+  class CLI < Thor
+    class Setup < Thor
+      package_name "superkick setup"
+
+      desc "start", "Interactive first-time setup"
+      long_desc <<~DESC
+        Walks you through creating a Superkick configuration file, setting up
+        MCP integration with your AI CLI, and installing shell completions.
+
+        Each integration provides a well-documented config snippet with inline
+        comments explaining every option. The generated config.yml is ready to
+        use and easy to evolve.
+      DESC
+      option :driver, type: :string, desc: "AI CLI driver (skip driver prompt)"
+      option :force, type: :boolean, default: false, desc: "Overwrite existing config"
+      option :skip_mcp, type: :boolean, default: false, desc: "Skip MCP configuration"
+      option :skip_completions, type: :boolean, default: false, desc: "Skip shell completion offer"
+      def start
+        @prompt = TTY::Prompt.new
+        @setup = Superkick::Setup.new
+
+        say_welcome
+        return unless check_existing_config
+
+        driver = choose_driver
+        return unless driver
+
+        monitors = choose_items("monitors", @setup.available_monitors)
+        spawners = choose_items("spawners", @setup.available_spawners)
+        notifiers = choose_items("notifications", @setup.available_notifiers, defaults: [:terminal_bell])
+        repository_sources = choose_items("repository sources", @setup.available_repository_sources)
+
+        write_config(driver:, monitors:, spawners:, notifiers:, repository_sources:)
+        configure_mcp(driver) unless options[:skip_mcp]
+        offer_completions unless options[:skip_completions]
+        say_next_steps
+      end
+
+      default_command :start
+
+      private
+
+      def say_welcome
+        $stdout.puts ""
+        $stdout.puts "Welcome to Superkick setup!"
+        $stdout.puts ""
+        $stdout.puts "This will create a config file at #{config_path}"
+        $stdout.puts "and configure your AI CLI to use Superkick's MCP server."
+        $stdout.puts ""
+      end
+
+      def config_path
+        File.join(Superkick.config.base_dir, "config.yml")
+      end
+
+      def check_existing_config
+        return true unless File.exist?(config_path)
+        return true if options[:force]
+
+        @prompt.yes?("#{config_path} already exists. Overwrite?")
+      end
+
+      def choose_driver
+        if options[:driver]
+          driver_name = options[:driver].to_sym
+          begin
+            Driver.lookup(driver_name)
+            return driver_name
+          rescue ArgumentError
+            warn "Unknown driver: #{options[:driver]}"
+            return nil
+          end
+        end
+
+        drivers = @setup.detect_drivers
+        choices = drivers.map do |d|
+          label = d[:name].to_s
+          label += " (#{d[:cli_command]})" if d[:cli_command] != d[:name].to_s
+          label += " ✓" if d[:installed]
+          {name: label, value: d[:name]}
+        end
+
+        @prompt.select("Which AI CLI are you using?", choices)
+      end
+
+      def choose_items(label, available, defaults: [])
+        return [] if available.empty?
+
+        choices = available.map do |item|
+          desc = item[:description]&.split(".")&.first
+          choice_label = item[:label]
+          choice_label += " — #{desc}" if desc
+          {name: choice_label, value: item[:type]}
+        end
+
+        default_indices = defaults.filter_map do |d|
+          choices.index { it[:value] == d }
+        end
+
+        $stdout.puts ""
+        @prompt.multi_select(
+          "Which #{label} would you like to configure?",
+          choices,
+          default: default_indices.map { it + 1 }
+        )
+      end
+
+      def write_config(driver:, monitors:, spawners:, notifiers:, repository_sources:)
+        config_content = @setup.generate_config(
+          driver:,
+          monitors:,
+          spawners:,
+          notifiers:,
+          repository_sources:
+        )
+
+        FileUtils.mkdir_p(Superkick.config.base_dir)
+        File.write(config_path, config_content)
+
+        $stdout.puts ""
+        $stdout.puts "Wrote #{config_path}"
+      end
+
+      def configure_mcp(driver_name)
+        return unless @prompt.yes?("\nConfigure MCP integration for #{driver_name}?")
+
+        Superkick.load_config!
+        Superkick.driver.install_mcp(exe_path: File.expand_path($PROGRAM_NAME))
+        $stdout.puts "MCP configured."
+      rescue => e
+        warn "MCP configuration failed: #{e.message}"
+        warn "You can run `superkick mcp configure` later."
+      end
+
+      def offer_completions
+        shell = File.basename(ENV.fetch("SHELL", "bash"))
+        return unless %w[bash zsh].include?(shell)
+
+        $stdout.puts ""
+        $stdout.puts "To enable shell completions, add this to your .#{shell}rc:"
+        $stdout.puts ""
+        $stdout.puts "  eval \"$(superkick completion #{shell})\""
+        $stdout.puts ""
+      end
+
+      def say_next_steps
+        $stdout.puts "Setup complete! Next steps:"
+        $stdout.puts ""
+        $stdout.puts "  1. Review and edit #{config_path}"
+        $stdout.puts "     (fill in tokens, adjust settings)"
+        $stdout.puts ""
+        $stdout.puts "  2. Start the server:"
+        $stdout.puts "     superkick server start -d"
+        $stdout.puts ""
+        $stdout.puts "  3. Launch your agent:"
+        $stdout.puts "     superkick agent start"
+        $stdout.puts ""
+      end
+    end
+  end
+end

data/lib/superkick/cli/spawner.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Superkick
+  class CLI < Thor
+    class Spawner < Thor
+      package_name "superkick spawner"
+
+      desc "list", "List configured spawner monitors and their status"
+      option :json, type: :boolean, default: false, desc: "Output as JSON"
+      def list
+        client = Control.client_from
+
+        unless client.alive?
+          $stdout.puts "Superkick server is not running."
+          return
+        end
+
+        resp = client.request("list_spawners")
+        spawners = resp[:spawners] || []
+
+        if options[:json]
+          $stdout.puts JSON.pretty_generate(spawners)
+          return
+        end
+
+        if spawners.empty?
+          $stdout.puts "No spawners configured."
+          return
+        end
+
+        spawners.each do |sp|
+          line = "#{sp[:name]} (type: #{sp[:type]}) [#{sp[:status]}]"
+          workflow_parts = []
+          workflow_parts << "on_complete: #{sp[:on_complete_target]}" if sp[:on_complete_target]
+          workflow_parts << "on_fail: #{sp[:on_fail_target]}" if sp[:on_fail_target]
+          line += "  -> #{workflow_parts.join(", ")}" if workflow_parts.any?
+          $stdout.puts line
+          $stdout.puts ""
+        end
+      rescue Control::Client::ServerUnavailable
+        $stdout.puts "Superkick server is not running."
+      end
+
+      desc "start NAME", "Start a stopped spawner"
+      def start(name)
+        client = Control.client_from
+        reply = client.request("start_spawner", spawner_name: name)
+
+        if reply.success?
+          $stdout.puts "Starting spawner #{name}."
+        else
+          warn "Error: #{reply.error_message}"
+          exit(1)
+        end
+      rescue Control::Client::ServerUnavailable
+        warn "Superkick server is not running."
+        exit(1)
+      end
+
+      desc "stop NAME", "Stop a running spawner"
+      def stop(name)
+        client = Control.client_from
+        reply = client.request("stop_spawner", spawner_name: name)
+
+        if reply.success?
+          $stdout.puts "Stopping spawner #{name}."
+        else
+          warn "Error: #{reply.error_message}"
+          exit(1)
+        end
+      rescue Control::Client::ServerUnavailable
+        warn "Superkick server is not running."
+        exit(1)
+      end
+
+      desc "install-templates", "Copy default spawner ERB templates to ~/.superkick/templates/spawners/"
+      option :force, type: :boolean, default: false, desc: "Overwrite existing templates"
+      def install_templates
+        TemplateRenderer.install_spawner_defaults(force: options[:force])
+      end
+
+      default_command :list
+    end
+  end
+end