aircana 2.0.0 → 3.0.0.rc2

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0.rc2
 platform: ruby
 authors:
 - Weston Dransfield
 bindir: exe
 cert_chain: []
-date: 2025-10-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -102,6 +102,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude-plugin/plugin.json"
 - ".devcontainer/devcontainer.json"
 - ".dockerignore"
 - ".rspec_status"
@@ -113,8 +114,23 @@ files:
 - README.md
 - Rakefile
 - SECURITY.md
+- agents/apply_feedback.md
+- agents/executor.md
+- agents/jira.md
+- agents/planner.md
+- agents/reviewer.md
+- agents/sub-agent-coordinator.md
+- agents/test-agent/manifest.json
+- commands/air-apply-feedback.md
+- commands/air-ask-expert.md
+- commands/air-execute.md
+- commands/air-plan.md
+- commands/air-record.md
+- commands/air-review.md
+- commands/sample-command.md
 - compose.yml
 - exe/aircana
+- hooks/hooks.json
 - lib/aircana.rb
 - lib/aircana/cli.rb
 - lib/aircana/cli/app.rb
@@ -125,8 +141,8 @@ files:
 - lib/aircana/cli/commands/dump_context.rb
 - lib/aircana/cli/commands/generate.rb
 - lib/aircana/cli/commands/hooks.rb
-- lib/aircana/cli/commands/install.rb
-- lib/aircana/cli/commands/project.rb
+- lib/aircana/cli/commands/init.rb
+- lib/aircana/cli/commands/plugin.rb
 - lib/aircana/cli/help_formatter.rb
 - lib/aircana/cli/shell_command.rb
 - lib/aircana/cli/subcommand.rb
@@ -149,14 +165,14 @@ files:
 - lib/aircana/generators/helpers.rb
 - lib/aircana/generators/hooks_generator.rb
 - lib/aircana/generators/plan_command_generator.rb
-- lib/aircana/generators/project_config_generator.rb
 - lib/aircana/generators/record_command_generator.rb
 - lib/aircana/generators/review_command_generator.rb
+- lib/aircana/hooks_manifest.rb
 - lib/aircana/human_logger.rb
 - lib/aircana/initializers.rb
 - lib/aircana/llm/claude_client.rb
+- lib/aircana/plugin_manifest.rb
 - lib/aircana/progress_tracker.rb
-- lib/aircana/symlink_manager.rb
 - lib/aircana/system_checker.rb
 - lib/aircana/templates/agents/base_agent.erb
 - lib/aircana/templates/agents/defaults/apply_feedback.erb
@@ -181,6 +197,12 @@ files:
 - lib/aircana/templates/hooks/user_prompt_submit.erb
 - lib/aircana/version.rb
 - sig/aircana.rbs
+- spec_target_1760205040_181/agents/test-agent/manifest.json
+- spec_target_1760205220_486/agents/test-agent/manifest.json
+- spec_target_1760205379_250/agents/test-agent/manifest.json
+- spec_target_1760205601_652/agents/test-agent/manifest.json
+- spec_target_1760205608_135/agents/test-agent/manifest.json
+- spec_target_1760205654_952/agents/test-agent/manifest.json
 homepage: https://github.com/westonkd/aircana
 licenses:
 - MIT
@@ -204,7 +226,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Humble workflow and context utilities for engineering with agents
 test_files: []

data/lib/aircana/cli/commands/install.rb

@@ -1,179 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require_relative "generate"
-require_relative "../../generators/project_config_generator"
-
-module Aircana
-  module CLI
-    module Install
-      class << self
-        def run
-          generate_files
-          ensure_project_config_exists
-          install_commands_to_claude
-          install_hooks_to_claude
-        end
-
-        private
-
-        def generate_files
-          Aircana.human_logger.info("Generating files before installation...")
-          Generate.run
-        end
-
-        def ensure_project_config_exists
-          project_json_path = File.join(Aircana.configuration.project_dir, ".aircana", "project.json")
-          return if File.exist?(project_json_path)
-
-          Aircana.human_logger.info("Creating project.json for multi-root support...")
-          Aircana::Generators::ProjectConfigGenerator.new.generate
-        end
-
-        def install_commands_to_claude
-          claude_commands_dir = File.join(Aircana.configuration.claude_code_project_config_path, "commands")
-          Aircana.create_dir_if_needed(claude_commands_dir)
-
-          copy_command_files(claude_commands_dir)
-          install_agents_to_claude
-        end
-
-        def copy_command_files(destination_dir)
-          Dir.glob("#{Aircana.configuration.output_dir}/commands/*").each do |file|
-            Aircana.human_logger.success("Installing #{file} to #{destination_dir}")
-            FileUtils.cp(file, destination_dir)
-          end
-        end
-
-        def install_agents_to_claude
-          claude_agents_dir = File.join(Aircana.configuration.claude_code_project_config_path, "agents")
-          Aircana.create_dir_if_needed(claude_agents_dir)
-
-          copy_agent_files(claude_agents_dir)
-        end
-
-        def copy_agent_files(destination_dir)
-          agent_files_pattern = File.join(Aircana.configuration.output_dir, "agents", "*.md")
-          Dir.glob(agent_files_pattern).each do |file|
-            agent_name = File.basename(file, ".md")
-            next unless default_agent?(agent_name)
-
-            destination_file = File.join(destination_dir, File.basename(file))
-            # Skip copying if source and destination are the same
-            next if File.expand_path(file) == File.expand_path(destination_file)
-
-            Aircana.human_logger.success("Installing default agent #{file} to #{destination_dir}")
-            FileUtils.cp(file, destination_dir)
-          end
-        end
-
-        def default_agent?(agent_name)
-          require_relative "../../generators/agents_generator"
-          Aircana::Generators::AgentsGenerator.available_default_agents.include?(agent_name)
-        end
-
-        def install_hooks_to_claude
-          return unless Dir.exist?(Aircana.configuration.hooks_dir)
-
-          settings_file = File.join(Aircana.configuration.claude_code_project_config_path, "settings.local.json")
-          install_hooks_to_settings(settings_file)
-        end
-
-        def install_hooks_to_settings(settings_file)
-          settings = load_settings(settings_file)
-          hook_configs = build_hook_configs
-
-          return if hook_configs.empty?
-
-          settings["hooks"] = hook_configs
-          save_settings(settings_file, settings)
-
-          Aircana.human_logger.success("Installed hooks to #{settings_file}")
-        end
-
-        def load_settings(settings_file)
-          if File.exist?(settings_file)
-            JSON.parse(File.read(settings_file))
-          else
-            Aircana.create_dir_if_needed(File.dirname(settings_file))
-            {}
-          end
-        rescue JSON::ParserError
-          Aircana.human_logger.warn("Invalid JSON in #{settings_file}, creating new settings")
-          {}
-        end
-
-        def save_settings(settings_file, settings)
-          File.write(settings_file, JSON.pretty_generate(settings))
-        end
-
-        def build_hook_configs
-          hooks = {}
-
-          # Map hook files to Claude Code hook events and their properties
-          hook_mappings = {
-            "pre_tool_use" => { event: "PreToolUse", matcher: nil },
-            "post_tool_use" => { event: "PostToolUse", matcher: nil },
-            "user_prompt_submit" => { event: "UserPromptSubmit", matcher: nil },
-            "session_start" => { event: "SessionStart", matcher: nil },
-            "notification_sqs" => { event: "Notification", matcher: nil },
-            "rubocop_pre_commit" => { event: "PreToolUse", matcher: "Bash" },
-            "rspec_test" => { event: "PostToolUse", matcher: "Bash" },
-            "bundle_install" => { event: "PostToolUse", matcher: "Bash" }
-          }
-
-          Dir.glob("#{Aircana.configuration.hooks_dir}/*.sh").each do |hook_file|
-            hook_name = File.basename(hook_file, ".sh")
-
-            # Determine mapping for this hook
-            mapping = if hook_mappings.key?(hook_name)
-                        hook_mappings[hook_name]
-                      else
-                        # For custom hooks, try to infer the event type from the filename
-                        infer_hook_mapping(hook_name)
-                      end
-
-            next unless mapping
-
-            event_key = mapping[:event]
-
-            # Create relative path from project root
-            relative_path = File.join(".aircana", "hooks", "#{hook_name}.sh")
-
-            hook_entry = {
-              "hooks" => [
-                {
-                  "type" => "command",
-                  "command" => relative_path
-                }
-              ]
-            }
-
-            # Add matcher if specified
-            hook_entry["matcher"] = mapping[:matcher] if mapping[:matcher]
-
-            hooks[event_key] ||= []
-            hooks[event_key] << hook_entry
-          end
-
-          hooks
-        end
-
-        def infer_hook_mapping(hook_name)
-          # Try to infer the event type from common patterns in the hook name
-          case hook_name
-          when /pre_tool_use|pre_tool|before_tool/i
-            { event: "PreToolUse", matcher: nil }
-          when /user_prompt|prompt_submit|before_prompt/i
-            { event: "UserPromptSubmit", matcher: nil }
-          when /session_start|session_init|startup/i
-            { event: "SessionStart", matcher: nil }
-          else
-            # Default to PostToolUse for unknown custom hooks and post_tool patterns
-            { event: "PostToolUse", matcher: nil }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/aircana/cli/commands/project.rb

@@ -1,156 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "tty-prompt"
-require_relative "../../symlink_manager"
-require_relative "../../generators/project_config_generator"
-
-module Aircana
-  module CLI
-    module Project
-      class << self
-        def init
-          generator = Aircana::Generators::ProjectConfigGenerator.new
-          config_path = generator.generate
-
-          Aircana.human_logger.success "Initialized project.json at #{config_path}"
-          Aircana.human_logger.info "Add folders using: aircana project add <path>"
-        end
-
-        def add(folder_path)
-          project_json_path = File.join(Aircana.configuration.project_dir, ".aircana", "project.json")
-
-          # Create project.json if it doesn't exist
-          init unless File.exist?(project_json_path)
-
-          # Validate folder exists
-          full_path = File.join(Aircana.configuration.project_dir, folder_path)
-          unless Dir.exist?(full_path)
-            Aircana.human_logger.error "Folder not found: #{folder_path}"
-            return
-          end
-
-          # Load existing config
-          config = JSON.parse(File.read(project_json_path))
-          config["folders"] ||= []
-
-          # Check if folder already exists
-          if config["folders"].any? { |f| f["path"] == folder_path }
-            Aircana.human_logger.warn "Folder already configured: #{folder_path}"
-            return
-          end
-
-          # Add the folder
-          config["folders"] << { "path" => folder_path }
-
-          # Save updated config
-          File.write(project_json_path, JSON.pretty_generate(config))
-
-          Aircana.human_logger.success "Added folder: #{folder_path}"
-
-          # Check what agents/knowledge would be available
-          check_folder_contents(folder_path)
-
-          # Offer to sync
-          prompt = TTY::Prompt.new
-          sync if prompt.yes?("Would you like to sync symlinks now?")
-        end
-
-        def remove(folder_path)
-          project_json_path = File.join(Aircana.configuration.project_dir, ".aircana", "project.json")
-
-          unless File.exist?(project_json_path)
-            Aircana.human_logger.error "No project.json found. Run 'aircana project init' first."
-            return
-          end
-
-          # Load existing config
-          config = JSON.parse(File.read(project_json_path))
-          config["folders"] ||= []
-
-          # Remove the folder
-          original_count = config["folders"].size
-          config["folders"].reject! { |f| f["path"] == folder_path }
-
-          if config["folders"].size == original_count
-            Aircana.human_logger.warn "Folder not found in configuration: #{folder_path}"
-            return
-          end
-
-          # Save updated config
-          File.write(project_json_path, JSON.pretty_generate(config))
-
-          Aircana.human_logger.success "Removed folder: #{folder_path}"
-
-          # Clean up symlinks
-          Aircana::SymlinkManager.cleanup_broken_symlinks
-        end
-
-        def list
-          project_json_path = File.join(Aircana.configuration.project_dir, ".aircana", "project.json")
-
-          unless File.exist?(project_json_path)
-            Aircana.human_logger.info "No project.json found. Run 'aircana project init' to create one."
-            return
-          end
-
-          config = JSON.parse(File.read(project_json_path))
-          folders = config["folders"] || []
-
-          if folders.empty?
-            Aircana.human_logger.info "No folders configured."
-            Aircana.human_logger.info "Add folders using: aircana project add <path>"
-            return
-          end
-
-          Aircana.human_logger.info "Configured folders:"
-          folders.each do |folder|
-            folder_path = folder["path"]
-            status = Dir.exist?(File.join(Aircana.configuration.project_dir, folder_path)) ? "✓" : "✗"
-            Aircana.human_logger.info "  #{status} #{folder_path}"
-
-            # Show available agents if folder exists
-            check_folder_contents(folder_path, indent: "    ") if status == "✓"
-          end
-        end
-
-        def sync
-          Aircana.human_logger.info "Syncing multi-root project symlinks..."
-
-          stats = Aircana::SymlinkManager.sync_multi_root_agents
-
-          if stats[:agents].zero? && stats[:knowledge].zero?
-            Aircana.human_logger.info "No agents or knowledge bases to link."
-          else
-            Aircana.human_logger.success "Sync complete: #{stats[:agents]} agents, #{stats[:knowledge]} knowledge bases"
-          end
-        end
-
-        private
-
-        def check_folder_contents(folder_path, indent: "  ")
-          agents_dir = File.join(folder_path, ".claude", "agents")
-          knowledge_dir = File.join(folder_path, ".aircana", "agents")
-
-          agents = []
-          knowledge = []
-
-          agents = Dir.glob("#{agents_dir}/*.md").map { |f| File.basename(f, ".md") } if Dir.exist?(agents_dir)
-
-          if Dir.exist?(knowledge_dir)
-            knowledge = Dir.glob("#{knowledge_dir}/*").select { |d| File.directory?(d) }
-                           .map { |d| File.basename(d) }
-          end
-
-          Aircana.human_logger.info "#{indent}Agents: #{agents.join(", ")}" if agents.any?
-
-          Aircana.human_logger.info "#{indent}Knowledge: #{knowledge.join(", ")}" if knowledge.any?
-
-          return unless agents.empty? && knowledge.empty?
-
-          Aircana.human_logger.info "#{indent}No agents or knowledge found"
-        end
-      end
-    end
-  end
-end

data/lib/aircana/generators/project_config_generator.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base_generator"
-require "json"
-
-module Aircana
-  module Generators
-    class ProjectConfigGenerator < 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
-
-      def generate
-        # Create the project.json with default content
-        project_config = default_project_config
-
-        Aircana.create_dir_if_needed(File.dirname(file_out))
-        File.write(file_out, JSON.pretty_generate(project_config))
-
-        Aircana.human_logger.success "Generated project.json at #{file_out}"
-        file_out
-      end
-
-      private
-
-      def default_template_path
-        # We don't use a template for this, generate directly
-        nil
-      end
-
-      def default_output_path
-        File.join(Aircana.configuration.project_dir, ".aircana", "project.json")
-      end
-
-      def default_project_config
-        {
-          "folders" => [],
-          "_comment" => [
-            "Add folders to include agents from sub-projects",
-            "Example:",
-            "  'folders': [",
-            "    { 'path': 'frontend' },",
-            "    { 'path': 'backend' },",
-            "    { 'path': 'shared/utils' }",
-            "  ]"
-          ]
-        }
-      end
-    end
-  end
-end

data/lib/aircana/symlink_manager.rb

@@ -1,158 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "fileutils"
-
-module Aircana
-  class SymlinkManager
-    class << self
-      def sync_multi_root_agents
-        project_json_path = File.join(Aircana.configuration.project_dir, ".aircana", "project.json")
-
-        unless File.exist?(project_json_path)
-          Aircana.human_logger.info "No project.json found, skipping multi-root sync"
-          return { agents: 0, knowledge: 0 }
-        end
-
-        begin
-          config = JSON.parse(File.read(project_json_path))
-          folders = config["folders"] || []
-
-          if folders.empty?
-            Aircana.human_logger.info "No folders configured in project.json"
-            return { agents: 0, knowledge: 0 }
-          end
-
-          cleanup_broken_symlinks
-          create_symlinks_for_folders(folders)
-        rescue JSON::ParserError => e
-          Aircana.human_logger.error "Invalid JSON in project.json: #{e.message}"
-          { agents: 0, knowledge: 0 }
-        end
-      end
-
-      def cleanup_broken_symlinks
-        claude_agents_dir = File.join(Aircana.configuration.project_dir, ".claude", "agents")
-        aircana_agents_dir = File.join(Aircana.configuration.project_dir, ".aircana", "agents")
-
-        [claude_agents_dir, aircana_agents_dir].each do |dir|
-          next unless Dir.exist?(dir)
-
-          Dir.glob("#{dir}/*").each do |path|
-            if File.symlink?(path) && !File.exist?(path)
-              File.delete(path)
-              Aircana.human_logger.info "Removed broken symlink: #{path}"
-            end
-          end
-        end
-      end
-
-      def create_symlinks_for_folders(folders)
-        stats = { agents: 0, knowledge: 0 }
-
-        folders.each do |folder_config|
-          folder_path = folder_config["path"]
-          next unless folder_path_valid?(folder_path)
-
-          prefix = folder_path.tr("/", "_")
-
-          stats[:agents] += link_agents(folder_path, prefix)
-          stats[:knowledge] += link_knowledge(folder_path, prefix)
-        end
-
-        Aircana.human_logger.success "Linked #{stats[:agents]} agents and #{stats[:knowledge]} knowledge bases"
-        stats
-      end
-
-      def link_agents(folder_path, prefix)
-        source_dir = File.join(folder_path, ".claude", "agents")
-        target_dir = File.join(Aircana.configuration.project_dir, ".claude", "agents")
-
-        return 0 unless Dir.exist?(source_dir)
-
-        FileUtils.mkdir_p(target_dir)
-        linked = 0
-
-        Dir.glob("#{source_dir}/*.md").each do |agent_file|
-          agent_name = File.basename(agent_file, ".md")
-          link_name = "#{prefix}_#{agent_name}.md"
-          target_path = File.join(target_dir, link_name)
-
-          # Use relative paths for symlinks
-          relative_path = calculate_relative_path(target_dir, agent_file)
-
-          File.symlink(relative_path, target_path) unless File.exist?(target_path)
-          linked += 1
-          Aircana.human_logger.info "Linked agent: #{link_name}"
-        end
-
-        linked
-      end
-
-      def link_knowledge(folder_path, prefix)
-        source_dir = File.join(folder_path, ".aircana", "agents")
-        target_dir = File.join(Aircana.configuration.project_dir, ".aircana", "agents")
-
-        return 0 unless Dir.exist?(source_dir)
-
-        FileUtils.mkdir_p(target_dir)
-        linked = 0
-
-        Dir.glob("#{source_dir}/*").each do |agent_dir|
-          next unless File.directory?(agent_dir)
-
-          agent_name = File.basename(agent_dir)
-          link_name = "#{prefix}_#{agent_name}"
-          target_path = File.join(target_dir, link_name)
-
-          # Use relative paths for symlinks
-          relative_path = calculate_relative_path(target_dir, agent_dir)
-
-          File.symlink(relative_path, target_path) unless File.exist?(target_path)
-          linked += 1
-          Aircana.human_logger.info "Linked knowledge: #{link_name}"
-        end
-
-        linked
-      end
-
-      def folder_path_valid?(folder_path)
-        full_path = File.join(Aircana.configuration.project_dir, folder_path)
-
-        unless Dir.exist?(full_path)
-          Aircana.human_logger.warn "Folder not found: #{folder_path}"
-          return false
-        end
-
-        true
-      end
-
-      def calculate_relative_path(from_dir, to_path)
-        # Calculate the relative path from one directory to another
-        from = Pathname.new(File.expand_path(from_dir))
-        to = Pathname.new(File.expand_path(to_path))
-        to.relative_path_from(from).to_s
-      end
-
-      # Helper methods for resolving symlinked agent paths
-      def resolve_agent_path(agent_name)
-        agent_path = File.join(Aircana.configuration.agent_knowledge_dir, agent_name)
-
-        if File.symlink?(agent_path)
-          File.readlink(agent_path)
-        else
-          agent_path
-        end
-      end
-
-      def agent_is_symlinked?(agent_name)
-        agent_path = File.join(Aircana.configuration.agent_knowledge_dir, agent_name)
-        File.symlink?(agent_path)
-      end
-
-      def resolve_symlinked_path(path)
-        File.symlink?(path) ? File.readlink(path) : path
-      end
-    end
-  end
-end