aircana 0.1.0

data/lib/aircana/contexts/confluence_logging.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Aircana
+  module Contexts
+    module ConfluenceLogging
+      private
+
+      def log_request(method, path, query_params = nil, pagination: false)
+        config = Aircana.configuration
+        full_url = "#{config.confluence_base_url}#{path}"
+
+        log_parts = build_request_log_parts(method, full_url, query_params, config)
+        log_message = log_parts.join(" | ")
+
+        output_request_log(log_message, pagination)
+      end
+
+      def log_response(response, context = nil, pagination: false)
+        return if pagination
+
+        status_color = response_status_color(response)
+        status_text = response.success? ? "✓" : "✗"
+
+        log_parts = build_response_log_parts(response, context, status_color, status_text)
+
+        Aircana.human_logger.info "#{log_parts.join(" | ")}\e[0m"
+      end
+
+      def handle_api_error(operation, error, message)
+        Aircana.human_logger.error "Failed to #{operation}: #{error.message}"
+        raise Error, "#{message}: #{error.message}"
+      end
+
+      def build_request_log_parts(method, full_url, query_params, config)
+        log_parts = ["#{method.upcase} #{full_url}"]
+
+        if query_params && !query_params.empty?
+          query_string = query_params.map { |k, v| "#{k}=#{v}" }.join("&")
+          log_parts << "Query: #{query_string}"
+        end
+
+        log_parts << "Auth: Basic #{config.confluence_username}:***"
+        log_parts
+      end
+
+      def output_request_log(log_message, pagination)
+        if pagination
+          print "\r\e[36m🌐 #{log_message}\e[0m\e[K"
+        else
+          Aircana.human_logger.info log_message
+        end
+      end
+
+      def response_status_color(response)
+        response.success? ? "32" : "31"
+      end
+
+      def build_response_log_parts(response, context, status_color, status_text)
+        log_parts = ["\e[#{status_color}m#{status_text} Response: #{response.code}"]
+        log_parts << context if context
+
+        if response.body && !response.body.empty?
+          body_preview = response.body.length > 200 ? "#{response.body[0..200]}..." : response.body
+          log_parts << "Body: #{body_preview}"
+        end
+
+        log_parts
+      end
+    end
+  end
+end

data/lib/aircana/contexts/confluence_setup.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Aircana
+  module Contexts
+    module ConfluenceSetup
+      def setup_httparty
+        config = Aircana.configuration
+
+        self.class.base_uri config.confluence_base_url
+        self.class.basic_auth config.confluence_username, config.confluence_api_token
+        self.class.headers "Content-Type" => "application/json"
+      end
+    end
+  end
+end

data/lib/aircana/contexts/local.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Aircana
+  module Contexts
+    class Local
+      def store_content(title:, content:, agent:)
+        agent_dir = create_agent_knowledge_dir(agent)
+        filename = sanitize_filename(title)
+        filepath = File.join(agent_dir, "#{filename}.md")
+
+        File.write(filepath, content)
+        Aircana.human_logger.success "Stored '#{title}' for agent '#{agent}' at #{filepath}"
+
+        filepath
+      end
+
+      private
+
+      def create_agent_knowledge_dir(agent)
+        config = Aircana.configuration
+        agent_dir = File.join(config.agent_knowledge_dir, agent, "knowledge")
+
+        FileUtils.mkdir_p(agent_dir)
+
+        agent_dir
+      end
+
+      def sanitize_filename(title)
+        # Replace invalid characters with safe alternatives
+        # Remove or replace characters that are problematic in filenames
+        sanitized = title.strip
+                         .gsub(%r{[<>:"/\\|?*]}, "-") # Replace invalid chars with hyphens
+                         .gsub(/\s+/, "-")             # Replace spaces with hyphens
+                         .gsub(/-+/, "-")              # Collapse multiple hyphens
+                         .gsub(/^-|-$/, "")            # Remove leading/trailing hyphens
+
+        # Ensure the filename isn't empty and isn't too long
+        sanitized = "untitled" if sanitized.empty?
+        sanitized = sanitized[0, 200] if sanitized.length > 200 # Limit to 200 chars
+
+        sanitized
+      end
+    end
+  end
+end

data/lib/aircana/contexts/relevant_files.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Aircana
+  module Contexts
+    class RelevantFiles
+      class << self
+        # TODO: Honor the provided verbose flag
+        def print(_verbose: false)
+          verbose_generator(default_stream: true).generate
+        end
+
+        def add(files)
+          files = Array(files)
+
+          return if files.empty?
+
+          Aircana.create_dir_if_needed(Aircana.configuration.relevant_project_files_dir)
+
+          files.each do |file|
+            absolute_file_path = File.expand_path(file)
+            link_path = "#{Aircana.configuration.relevant_project_files_dir}/#{File.basename(file)}"
+
+            FileUtils.rm_f(link_path)
+            File.symlink(absolute_file_path, link_path)
+          end
+
+          rewrite_verbose_file
+        end
+
+        def remove(files)
+          files = Array(files)
+
+          return if files.empty?
+
+          Aircana.create_dir_if_needed(Aircana.configuration.relevant_project_files_dir)
+
+          files.each do |file|
+            link_path = "#{Aircana.configuration.relevant_project_files_dir}/#{File.basename(file)}"
+            FileUtils.rm_f(link_path)
+          end
+
+          rewrite_verbose_file
+        end
+
+        def remove_all
+          return unless directory_exists?
+
+          Dir.glob("#{Aircana.configuration.relevant_project_files_dir}/*").each do |file|
+            FileUtils.rm_f(file)
+          end
+
+          return unless Dir.empty?(Aircana.configuration.relevant_project_files_dir)
+
+          Dir.rmdir(Aircana.configuration.relevant_project_files_dir)
+        end
+
+        private
+
+        def rewrite_verbose_file
+          verbose_generator.generate
+
+          # TODO: If the verbose file uses too many tokens, warn and instead use only
+          # the summary generatior or do something smart like summarize file contents
+        end
+
+        def verbose_generator(default_stream: false)
+          Generators::RelevantFilesVerboseResultsGenerator.new(
+            file_out: default_stream ? Aircana.configuration.stream : nil
+          )
+        end
+
+        def directory_exists?
+          Dir.exist?(Aircana.configuration.relevant_project_files_dir)
+        end
+      end
+    end
+  end
+end

data/lib/aircana/fzf_helper.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Aircana
+  class FzfHelper
+    class << self
+      def select_files_interactively(header: "Select files", multi: true)
+        return [] unless fzf_available?
+
+        execute_fzf_selection(header: header, multi: multi)
+      rescue StandardError => e
+        Aircana.human_logger.error "File selection failed: #{e.message}"
+        []
+      end
+
+      def fzf_available?
+        return true if command_available?("fzf")
+
+        handle_missing_dependency
+        false
+      end
+
+      def execute_fzf_selection(header:, multi:)
+        command = build_fzf_command(header: header, multi: multi)
+        result = `#{command}`.strip
+        return [] if result.empty?
+
+        result.split("\n").map(&:strip).reject(&:empty?)
+      end
+
+      private
+
+      def command_available?(command)
+        system("which #{command}", out: File::NULL, err: File::NULL)
+      end
+
+      def handle_missing_dependency
+        Aircana.human_logger.error "fzf is required but not installed"
+        Aircana.human_logger.info "To install fzf:"
+        Aircana.human_logger.info "  • macOS: brew install fzf"
+        Aircana.human_logger.info "  • Ubuntu/Debian: apt install fzf"
+        Aircana.human_logger.info "  • Other: https://github.com/junegunn/fzf#installation"
+      end
+
+      def build_fzf_command(header:, multi:)
+        options = base_fzf_options(header: header, multi: multi)
+        preview_options = preview_command_options
+        key_bindings = key_binding_options
+
+        "#{generate_file_list_command} | fzf #{options} #{preview_options} #{key_bindings}"
+      end
+
+      def base_fzf_options(header:, multi:)
+        options = build_fzf_option_list(multi: multi)
+        options += build_fzf_display_options(header: header)
+        options.join(" ")
+      end
+
+      def build_fzf_option_list(multi:)
+        options = ["--ansi", "--border", "--height=80%", "--layout=reverse", "--info=inline"]
+        options << "--multi" if multi
+        options
+      end
+
+      def build_fzf_display_options(header:)
+        [
+          "--header='#{header}'",
+          "--header-lines=0",
+          "--prompt='❯ '",
+          "--pointer='▶'",
+          "--marker='✓'"
+        ]
+      end
+
+      def preview_command_options
+        preview_cmd = preview_command
+        return "" if preview_cmd.nil?
+
+        [
+          "--preview='#{preview_cmd}'",
+          "--preview-window='right:60%:wrap'",
+          "--preview-label='Preview'"
+        ].join(" ")
+      end
+
+      def preview_command
+        # Try to use bat for syntax highlighting, fall back to head/cat
+        if command_available?("bat")
+          "bat --color=always --style=header,grid --line-range :50 {}"
+        elsif command_available?("head")
+          "head -50 {}"
+        else
+          "cat {}"
+        end
+      end
+
+      def key_binding_options
+        [
+          "--bind='ctrl-a:select-all'",
+          "--bind='ctrl-d:deselect-all'",
+          "--bind='ctrl-/:toggle-preview'",
+          "--bind='ctrl-u:preview-page-up'",
+          "--bind='ctrl-n:preview-page-down'",
+          "--bind='?:toggle-preview'"
+        ].join(" ")
+      end
+
+      def generate_file_list_command
+        # Use fd if available for better performance and .gitignore respect
+        if command_available?("fd")
+          "fd --type f --hidden --exclude .git"
+        else
+          "find . -type f -not -path '*/\\.git/*' -not -path '*/node_modules/*' -not -path '*/\\.vscode/*'"
+        end
+      end
+    end
+  end
+end

data/lib/aircana/generators/agents_generator.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require_relative "../generators"
+
+module Aircana
+  module Generators
+    class AgentsGenerator < BaseGenerator
+      attr_reader :agent_name, :short_description, :description, :model, :color, :default_agent
+
+      AVAILABLE_DEFAULT_AGENTS = %w[planner worker].freeze
+
+      class << self
+        def create_default_agent(agent_name)
+          unless AVAILABLE_DEFAULT_AGENTS.include?(agent_name)
+            raise ArgumentError, "Unknown default agent: #{agent_name}"
+          end
+
+          new(agent_name: agent_name, default_agent: true).generate
+        end
+
+        def available_default_agents
+          AVAILABLE_DEFAULT_AGENTS
+        end
+      end
+
+      def initialize( # rubocop:disable Metrics/ParameterLists
+        agent_name:, short_description: nil, description: nil, model: nil, color: nil,
+        file_in: nil, file_out: nil, default_agent: false
+      )
+        @agent_name = agent_name
+        @short_description = short_description
+        @description = description
+        @model = model
+        @color = color
+        @default_agent = default_agent
+
+        super(
+          file_in: file_in || default_template_path,
+          file_out: file_out || default_output_path
+        )
+      end
+
+      protected
+
+      def locals
+        super.merge({
+                      relevant_project_files_path:, agent_name:, short_description:, description:,
+                      model:, color:, knowledge_path:
+                    })
+      end
+
+      private
+
+      def default_template_path
+        if default_agent
+          File.join(File.dirname(__FILE__), "..", "templates", "agents", "defaults", "#{agent_name}.erb")
+        else
+          File.join(File.dirname(__FILE__), "..", "templates", "agents", "base_agent.erb")
+        end
+      end
+
+      def default_output_path
+        File.join(Aircana.configuration.claude_code_project_config_path, "agents", "#{agent_name}.md")
+      end
+
+      def relevant_project_files_path
+        File.join(Aircana.configuration.relevant_project_files_dir, "relevant_files.md")
+      end
+
+      def knowledge_path
+        ".aircana/agents/#{agent_name}/knowledge"
+      end
+    end
+  end
+end

data/lib/aircana/generators/base_generator.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "erb"
+require "fileutils"
+require_relative "helpers"
+
+module Aircana
+  module Generators
+    class BaseGenerator
+      attr_reader :file_in, :file_out
+
+      def initialize(file_in: nil, file_out: nil)
+        @file_in = file_in
+        @file_out = file_out
+      end
+
+      def generate
+        prepare_output_directory
+        content = generate_content
+        write_content(content)
+
+        file_out
+      end
+
+      private
+
+      def prepare_output_directory
+        return unless file_out.is_a?(String)
+
+        FileUtils.mkdir_p(File.dirname(file_out))
+      end
+
+      def generate_content
+        erb = ERB.new(template)
+        Aircana.human_logger.info "Generating #{file_out} from #{file_in}"
+        # Debug info removed for cleaner output
+        erb.result_with_hash(locals)
+      end
+
+      def write_content(content)
+        if file_out.respond_to?(:write)
+          file_out.write(content)
+        else
+          File.write(file_out, content)
+        end
+      end
+
+      protected
+
+      def locals
+        { helpers: Helpers }
+      end
+
+      private
+
+      def template
+        File.read(file_in)
+      end
+    end
+  end
+end

data/lib/aircana/generators/helpers.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Aircana
+  module Generators
+    module Helpers
+      class << self
+        def model_instructions(instructions, important: false)
+          <<~INSTRUCTIONS
+            INSTRUCTIONS #{"IMPORTANT" if important}:
+            #{instructions}
+          INSTRUCTIONS
+        end
+      end
+    end
+  end
+end

data/lib/aircana/generators/relevant_files_command_generator.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "../generators"
+
+module Aircana
+  module Generators
+    class RelevantFilesCommandGenerator < BaseGenerator
+      def initialize(file_in: nil, file_out: nil)
+        super(
+          file_in: file_in || default_template_path,
+          file_out: file_out || default_output_path
+        )
+      end
+
+      protected
+
+      def locals
+        super.merge({ relevant_project_files_path: })
+      end
+
+      private
+
+      def default_template_path
+        File.join(File.dirname(__FILE__), "..", "templates", "commands", "add_relevant_files.erb")
+      end
+
+      def default_output_path
+        File.join(Aircana.configuration.output_dir, "commands", "ac-add-relevant-files.md")
+      end
+
+      def relevant_project_files_path
+        File.join(Aircana.configuration.relevant_project_files_dir, "relevant_files.md")
+      end
+    end
+  end
+end

data/lib/aircana/generators/relevant_files_verbose_results_generator.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "../generators"
+
+module Aircana
+  module Generators
+    class RelevantFilesVerboseResultsGenerator < BaseGenerator
+      def initialize(file_in: nil, file_out: nil)
+        super(
+          file_in: file_in || default_template_path,
+          file_out: file_out || default_output_path
+        )
+      end
+
+      private
+
+      def locals
+        super.merge({ relevant_files: })
+      end
+
+      def relevant_files
+        Dir.glob("#{Aircana.configuration.relevant_project_files_dir}/*")
+      end
+
+      def default_template_path
+        File.join(File.dirname(__FILE__), "..", "templates", "relevant_files_verbose_results.erb")
+      end
+
+      def default_output_path
+        File.join(Aircana.configuration.relevant_project_files_dir, "relevant_files.md")
+      end
+    end
+  end
+end

data/lib/aircana/generators.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "generators/base_generator"
+require_relative "generators/relevant_files_command_generator"
+require_relative "generators/relevant_files_verbose_results_generator"
+
+module Aircana
+  module Generators
+  end
+end