soapstone 0.1.1

data/lib/soapstone/core/fetch_linear_issue.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+class Soapstone::FetchLinearIssue
+  LINEAR_URL = "https://api.linear.app/graphql"
+
+  def self.call
+    new.call
+  end
+
+  def initialize
+    @config = Soapstone::Config::Load.call
+    @git_context = Soapstone::Context::GitBranch.call
+    @linear_context = Soapstone::Context::Linear.call(@git_context.current_branch)
+  end
+
+  def call
+    return unless linear_context.enabled?
+    return unless linear_context.pattern && !linear_context.pattern.empty?
+    return {} if git_context.default_branch?
+    return unless linear_context.matches_pattern?
+
+    response = Faraday.post(LINEAR_URL, payload, headers)
+    body = JSON.parse(response.body)
+    body.dig("data", "issue") || {}
+  end
+
+  private
+
+  attr_reader :config, :git_context, :linear_context
+
+  def headers
+    api_key = config.get("linear", "api_key")
+
+    {
+      "Content-Type" => "application/json",
+      "Authorization" => api_key.to_s.strip
+    }
+  end
+
+  def issue_key
+    match = git_context.current_branch.match(compiled_regex)
+
+    if match
+      match[1] || match[0]  # Use capture group if available, otherwise full match
+    else
+      raise "No Linear ticket found in branch name '#{git_context.current_branch}' using pattern '#{linear_context.pattern}'"
+    end
+  rescue RegexpError => e
+    raise "Invalid regex pattern '#{linear_context.pattern}': #{e.message}"
+  end
+
+  def compiled_regex
+    @compiled_regex ||= Regexp.new(linear_context.pattern, Regexp::IGNORECASE)
+  end
+
+  def payload
+    {
+      query: <<~GRAPHQL,
+        query Issue($id: String!) {
+          issue(id: $id) {
+            identifier
+            title
+            description
+            priority
+            state { name }
+          }
+        }
+      GRAPHQL
+      variables: {id: issue_key}
+    }.to_json
+  end
+end

data/lib/soapstone/core/git_command.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class Soapstone::GitCommand
+  def self.in_git_repository?
+    system("git rev-parse --git-dir > /dev/null 2>&1")
+  end
+
+  def self.staged_files
+    `git diff --cached --name-status`.strip
+  end
+
+  def self.staged_diff
+    `git diff --cached`.strip
+  end
+
+  def self.current_branch
+    `git rev-parse --abbrev-ref HEAD`.strip
+  end
+end

data/lib/soapstone/core/message_presenter.rb

@@ -0,0 +1,91 @@
+class Soapstone::MessagePresenter
+  def self.call(message)
+    new(message).call
+  end
+
+  def initialize(message)
+    @message = message
+  end
+
+  def call
+    message
+      .then(&method(:wrap_message))
+      .then(&method(:format_lists))
+      .then(&method(:enhance_typography))
+      .then(&method(:format_subject_line))
+  end
+
+  def wrap_message(text)
+    subject, body = split_subject_and_body(text)
+
+    if subject.nil? # single line message or no clear body structure
+      Strings.wrap(body, 72)
+    elsif body.strip.empty?
+      subject
+    else
+      "#{subject}\n\n#{wrap_body(body)}"
+    end
+  end
+
+  private
+
+  attr_reader :message
+
+  def split_subject_and_body(text)
+    lines = text.split("\n", -1)  # -1 to keep trailing empty strings
+    blank_index = lines.find_index(&:empty?)
+
+    return [nil, text] unless blank_index
+
+    subject = lines[0...blank_index].join("\n")
+    body = lines[(blank_index + 1)..]&.join("\n") || ""
+
+    [subject, body]
+  end
+
+  def wrap_body(body_text)
+    body_text.split("\n").map do |paragraph|
+      if paragraph.match?(/^\s*(\d+\.\s|[-*]\s)/)
+        wrap_list_item(paragraph, 72)
+      else
+        cleaned = paragraph.gsub(/\s+/, " ").strip
+        Strings.wrap(cleaned, 72)
+      end
+    end.join("\n")
+  end
+
+  def wrap_list_item(text, width)
+    marker_match = text.match(/^(\s*)([-*]\s|\d+\.\s)(.*)/) # Match both bullet and numbered list items, even if indented
+    return Strings.wrap(text, width) unless marker_match
+
+    leading_spaces = marker_match[1]
+    marker = marker_match[2]
+    content = marker_match[3]
+
+    total_indent = leading_spaces.length + marker.length
+    indent = " " * total_indent
+
+    wrapped_content = Strings.wrap(content, width - total_indent)
+    lines = wrapped_content.split("\n")
+
+    ["#{leading_spaces}#{marker}#{lines.first}", *lines[1..].map { |line| "#{indent}#{line}" }].join("\n")
+  end
+
+  def format_lists(text)
+    text.gsub(/^\* (.+)$/) { "- #{$1}" }
+  end
+
+  def enhance_typography(text)
+    text.gsub("...", "…")         # Smart ellipses
+      .gsub("--", "—")            # Em dashes
+      .gsub(/"([^"]+)"/, '"\1"')  # Smart quotes
+  end
+
+  def format_subject_line(text)
+    lines = text.split("\n")
+    return text if lines.first.nil? || lines.first.empty?
+
+    subject = Strings.truncate(lines.first, 50, trailing: "…").sub(/\.$/, "")
+    [subject, *lines[1..]].join("\n")
+  end
+end

data/lib/soapstone/operations/commit.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/object/blank"
+
+class Soapstone::Operations::Commit
+  def self.start
+    new.start
+  end
+
+  def initialize(output: $stdout)
+    @output = output
+    @message_generator = Soapstone::CommitMessageGenerator.new
+  end
+
+  def start
+    display_header
+
+    ensure_in_git_repository
+    ensure_staged_files
+    check_branch_and_warn
+
+    generate_commit_message
+  end
+
+  private
+
+  attr_reader :message_generator, :output
+
+  def display_header
+    output.puts "🎨 Soapstone - Beautiful Commit Messages"
+  end
+
+  def ensure_in_git_repository
+    return if Soapstone::GitCommand.in_git_repository?
+
+    output.puts "❌ Error: Not in a git repository"
+    exit_with_code(1)
+  end
+
+  def ensure_staged_files
+    return if Soapstone::GitCommand.staged_files.present?
+
+    output.puts "⚠️  No staged changes found."
+    output.puts "Run 'git add <files>' to stage changes before creating a commit message."
+    exit_with_code(1)
+  end
+
+  def check_branch_and_warn
+    git_context = Soapstone::Context::GitBranch.call
+    linear_context = Soapstone::Context::Linear.call(git_context.current_branch)
+
+    return unless linear_context.enabled?
+
+    if git_context.default_branch?
+      warn_default_branch(git_context.default_branch)
+    elsif !linear_context.matches_pattern?
+      warn_non_matching_branch(git_context.current_branch, linear_context.pattern)
+    end
+  end
+
+  def generate_commit_message
+    prompt = Soapstone::AI::PromptBuilder.build_prompt
+    message = message_generator.call(prompt)
+    formatted_message = Soapstone::MessagePresenter.call(message)
+    output.puts "💡 Suggested commit message: \n\n#{formatted_message}"
+  end
+
+  def exit_with_code(code)
+    raise SystemExit, code
+  end
+
+  def warn_default_branch(default_branch)
+    output.puts "⚠️  Warning: You are committing directly to your default branch (#{default_branch})."
+    output.puts "   Linear integration will be skipped for this commit."
+    output.puts
+  end
+
+  def warn_non_matching_branch(current_branch, linear_pattern)
+    output.puts "⚠️  Warning: This branch name doesn't match your Linear ticket pattern."
+    output.puts "   Branch: #{current_branch}"
+    output.puts "   Pattern: #{linear_pattern}"
+    output.puts "   Linear integration will be skipped for this commit."
+    output.puts
+  end
+end

data/lib/soapstone/ui/components/box.rb

@@ -0,0 +1,29 @@
+class Soapstone::UI::Components::Box
+  BLANK_LINE = ""
+  LINE_BREAK = "\n"
+
+  def self.call(title, &block)
+    new(title).call(&block)
+  end
+
+  def initialize(title)
+    @title = title
+  end
+
+  def call(&block)
+    TTY::Box.frame(
+      top: 2,
+      left: 2,
+      width: 80,
+      padding: 2,
+      border: {type: :thick, bottom: true},
+      title: {top_left: " #{title} "}
+    ) do
+      yield if block_given?
+    end
+  end
+
+  private
+
+  attr_reader :title
+end

data/lib/soapstone/ui/components/prompt.rb

@@ -0,0 +1,17 @@
+class Soapstone::UI::Components::Prompt
+  def self.call(options: {})
+    new(options: options).call
+  end
+
+  def initialize(options: {})
+    @options = options
+  end
+
+  def call
+    TTY::Prompt.new(help_color: :dim, enable_color: true, interrupt: :exit, **options)
+  end
+
+  private
+
+  attr_reader :options
+end

data/lib/soapstone/ui/menus/ai_settings.rb

@@ -0,0 +1,131 @@
+class Soapstone::UI::Menus::AISettings
+  PROVIDER_OPTIONS = {
+    "open_ai" => "OpenAI",
+    "anthropic" => "Anthropic"
+  }.freeze
+
+  def self.call(config:)
+    new(config: config).call
+  end
+
+  def initialize(config:)
+    @config = config
+    @pastel = Pastel.new
+  end
+
+  def call
+    Soapstone::UI::Screens::Utils.clear
+    enabled = ask_for_ai_enabled
+
+    return unless enabled
+
+    setup_ai_providers
+    set_default_ai_provider
+    show_success_message
+  end
+
+  private
+
+  attr_reader :pastel, :config
+
+  def ask_for_ai_enabled
+    enabled = Soapstone::UI::Prompts::YesNo.call(
+      question: "Do you want to enable AI?",
+      help: "This will enable AI for the project.",
+      default: config.get(:ai, :enabled) || false
+    )
+    config.set(value: enabled, path: %w[ai enabled])
+    enabled
+  end
+
+  def setup_ai_providers
+    loop do
+      provider = ask_which_ai_provider
+      setup_ai_provider(provider)
+      break unless ask_if_other_ai_providers_enabled
+    end
+  end
+
+  def set_default_ai_provider
+    return unless config.get(:ai, :enabled)
+
+    if config.get(:ai, :api_keys).one?
+      config.set(value: config.get(:ai, :api_keys).keys.first, path: %w[ai default_provider])
+    else
+      ask_for_default_ai_provider
+    end
+  end
+
+  def ask_for_default_ai_provider
+    default_provider = Soapstone::UI::Prompts::Select.call(
+      question: "Which AI provider do you want to use by default?",
+      help: "I recommend using Anthropic. You can change this later.",
+      answers: default_provider_options,
+      default: config.get(:ai, :default_provider) || :anthropic
+    )
+    config.set(value: default_provider, path: %w[ai default_provider])
+  end
+
+  def ask_which_ai_provider
+    Soapstone::UI::Prompts::Select.call(
+      question: "Which AI provider do you want to use?",
+      help: "This is the AI provider you want to use.",
+      answers: [
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "OpenAI", value: :open_ai),
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "Anthropic", value: :anthropic)
+      ],
+      default: config.get(:ai, :provider) || :anthropic
+    )
+  end
+
+  def setup_ai_provider(provider)
+    case provider
+    when :open_ai
+      ask_for_openai_api_key
+    when :anthropic
+      ask_for_anthropic_api_key
+    end
+  end
+
+  def ask_for_openai_api_key
+    api_key = Soapstone::UI::Prompts::Ask.call(
+      question: "What is your OpenAI API key?",
+      help: "This is the API key you need to use to authenticate with OpenAI.",
+      default: config.get(:ai, :api_keys, :open_ai) || ""
+    )
+    config.set(value: api_key, path: %w[ai api_keys open_ai])
+  end
+
+  def ask_for_anthropic_api_key
+    api_key = Soapstone::UI::Prompts::Ask.call(
+      question: "What is your Anthropic API key?",
+      help: "This is the API key you need to use to authenticate with Anthropic.",
+      default: config.get(:ai, :api_keys, :anthropic) || ""
+    )
+    config.set(value: api_key, path: %w[ai api_keys anthropic])
+  end
+
+  def ask_if_other_ai_providers_enabled
+    Soapstone::UI::Prompts::YesNo.call(
+      question: "Do you want to add another AI provider?",
+      help: "This will allow you to configure additional AI providers.",
+      default: false
+    )
+  end
+
+  def show_success_message
+    puts
+    puts pastel.green("✅ Configuration updated!")
+    prompt.keypress("Press any key to continue...")
+  end
+
+  def default_provider_options
+    config.get(:ai, :api_keys).map do |provider_name, _|
+      Soapstone::UI::Prompts::SelectAnswer.new(name: PROVIDER_OPTIONS[provider_name], value: provider_name.to_sym)
+    end
+  end
+
+  def prompt
+    @prompt ||= Soapstone::UI::Components::Prompt.call
+  end
+end

data/lib/soapstone/ui/menus/git_settings.rb

@@ -0,0 +1,55 @@
+class Soapstone::UI::Menus::GitSettings
+  def self.call(config:)
+    new(config: config).call
+  end
+
+  def initialize(config:)
+    @config = config
+    @pastel = Pastel.new
+  end
+
+  def call
+    Soapstone::UI::Screens::Utils.clear
+    ask_for_default_branch
+    ask_for_type_style
+    show_success_message
+  end
+
+  private
+
+  attr_reader :pastel, :config
+
+  def ask_for_default_branch
+    default_branch = Soapstone::UI::Prompts::Ask.call(
+      question: "What is the name of your default base branch?",
+      help: "This is the branch that will be used as the base for new branches, it can be changed later or overwritten with --base / -b.",
+      default: config.get("git_settings", "default_branch") || "main"
+    )
+    config.set(value: default_branch, path: %w[git_settings default_branch])
+  end
+
+  def ask_for_type_style
+    type_style = Soapstone::UI::Prompts::Select.call(
+      question: "What is the type of commit style you prefer?",
+      answers: [
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "Conventional", emoji: "\u{2699}\uFE0F ", value: :conventional, help: "ex. feat(scope): message"),
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "Issue-Tracker Driven", emoji: "\u{1F4BE}", value: :issue_tracker_driven, help: "ex. Jira-123: message"),
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "Gitmoji", emoji: "\u{1F41E}", value: :gitmoji, help: "ex. feat: message"),
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "Hybrid", emoji: "\u{1F4A1}", value: :hybrid, help: "ex. feat(Jira-123): message"),
+        Soapstone::UI::Prompts::SelectAnswer.new(name: "None", emoji: "\u{1F6AA}", value: :none, help: "ex. message")
+      ],
+      default: config.get("git_settings", "type_style") || "Conventional"
+    )
+    config.set(value: type_style, path: %w[git_settings type_style])
+  end
+
+  def show_success_message
+    puts
+    puts pastel.green("✅ Configuration updated!")
+    prompt.keypress("Press any key to continue...")
+  end
+
+  def prompt
+    @prompt ||= Soapstone::UI::Components::Prompt.call
+  end
+end

data/lib/soapstone/ui/menus/linear_settings.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+class Soapstone::UI::Menus::LinearSettings
+  def self.call(config:)
+    new(config: config).call
+  end
+
+  def initialize(config:)
+    @config = config
+    @pastel = Pastel.new
+  end
+
+  def call
+    Soapstone::UI::Screens::Utils.clear
+    ask_for_enabled
+    return unless config.get("linear", "enabled")
+
+    ask_for_ticket_regex
+    ask_for_api_key
+    show_success_message
+  end
+
+  private
+
+  attr_reader :config, :pastel
+
+  def ask_for_enabled
+    enabled = Soapstone::UI::Prompts::YesNo.call(
+      question: "Enable Linear integration?",
+      default: config.get("linear", "enabled") || false
+    )
+    config.set(value: enabled, path: %w[linear enabled])
+  end
+
+  def ask_for_ticket_regex
+    default_regex = config.get("linear", "ticket_regex") || "(my-branch-\\d+)"
+    regex = Soapstone::UI::Prompts::Ask.call(
+      question: "Regex to capture Linear issue key from a branch name:",
+      help: "Example: (my-branch-\\d+) captures `my-branch-123` from `my-branch-123-my-feature`.",
+      default: default_regex
+    )
+    config.set(value: regex, path: %w[linear ticket_regex])
+  end
+
+  def ask_for_api_key
+    api_key = Soapstone::UI::Prompts::Ask.call(
+      question: "Your Linear API key:",
+      help: "Generate one from Linear → Settings → Security → API Keys",
+      default: config.get("linear", "api_key") || ""
+    )
+    config.set(value: api_key, path: %w[linear api_key])
+  end
+
+  def show_success_message
+    puts
+    puts pastel.green("✅ Linear settings updated!")
+    Soapstone::UI::Components::Prompt.call.keypress("Press any key to continue...")
+  end
+end

data/lib/soapstone/ui/prompts/ask.rb

@@ -0,0 +1,24 @@
+class Soapstone::UI::Prompts::Ask
+  def self.call(question:, default: nil, required: false, help: nil)
+    new(question: question, default: default, required: required, help: help).call
+  end
+
+  def initialize(question:, default: nil, required: false, help: nil)
+    @question = question
+    @default = default
+    @required = required
+    @help = help
+  end
+
+  def call
+    prompt.ask(question, default: default, required: required, help: help)
+  end
+
+  private
+
+  attr_reader :question, :default, :required, :help
+
+  def prompt
+    @prompt ||= TTY::Prompt.new(help_color: :dim, enable_color: true, interrupt: :exit)
+  end
+end

data/lib/soapstone/ui/prompts/select.rb

@@ -0,0 +1,50 @@
+class Soapstone::UI::Prompts::Select
+  def self.call(question:, answers:, default: nil, help: nil)
+    new(question: question, answers: answers, default: default, help: help).call
+  end
+
+  def initialize(question:, answers:, default: nil, help: nil)
+    @question = question
+    @answers = answers
+    @default = find_default_name(default)
+    @help = help
+  end
+
+  def call
+    prompt.select(question, formatted_answers, default: default, help: help, show_help: :always, cycle: true)
+  end
+
+  private
+
+  attr_reader :question, :answers, :default, :help
+
+  def prompt
+    @prompt ||= TTY::Prompt.new(help_color: :dim, active_color: :red, enable_color: true, interrupt: :exit, symbols: {marker: "\u25B6"}).tap do |p|
+      p.on(:keypress) do |event|
+        p.trigger(:keydown) if event.value == "j"
+        p.trigger(:keyup) if event.value == "k"
+      end
+    end
+  end
+
+  def find_default_name(default_value)
+    return if default_value.nil?
+
+    answers.find { |a| a.value == default_value.to_sym }&.name
+  end
+
+  def formatted_answers
+    pastel = Pastel.new
+
+    answers.map do |answer|
+      name = answer.name
+      name.prepend("#{answer.emoji} ") if answer.emoji
+      name.concat(" #{answer.help && pastel.dim("(#{answer.help})")}") if answer.help
+
+      {
+        name: name,
+        value: answer.value
+      }
+    end
+  end
+end

data/lib/soapstone/ui/prompts/select_answer.rb

@@ -0,0 +1,10 @@
+class Soapstone::UI::Prompts::SelectAnswer
+  def initialize(name:, value:, emoji: nil, help: nil)
+    @name = name
+    @emoji = emoji
+    @value = value
+    @help = help
+  end
+
+  attr_reader :name, :emoji, :value, :help
+end

data/lib/soapstone/ui/prompts/yes_no.rb

@@ -0,0 +1,25 @@
+class Soapstone::UI::Prompts::YesNo
+  def self.call(question:, default: nil, help: nil)
+    new(question: question, default: default, help: help).call
+  end
+
+  def initialize(question:, default: nil, help: nil)
+    @question = question
+    @default = default
+    @help = help
+  end
+
+  def call
+    prompt.yes?(question, help: help) do |q|
+      q.default(default) if default
+    end
+  end
+
+  private
+
+  attr_reader :question, :default, :help
+
+  def prompt
+    @prompt ||= TTY::Prompt.new(help_color: :dim, enable_color: true, interrupt: :exit)
+  end
+end

data/lib/soapstone/ui/screens/utils.rb

@@ -0,0 +1,5 @@
+class Soapstone::UI::Screens::Utils
+  def self.clear
+    system("clear") || system("cls")
+  end
+end