aircana 3.0.0.rc1 → 3.0.0.rc3

data/lib/aircana/plugin_manifest.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module Aircana
+  # Manages Claude Code plugin manifest (plugin.json) files
+  class PluginManifest
+    REQUIRED_FIELDS = %w[name version].freeze
+    OPTIONAL_FIELDS = %w[description author homepage repository license keywords].freeze
+    ALL_FIELDS = (REQUIRED_FIELDS + OPTIONAL_FIELDS).freeze
+
+    attr_reader :plugin_root
+
+    def initialize(plugin_root)
+      @plugin_root = plugin_root
+    end
+
+    # Creates a new plugin manifest with the given attributes
+    def create(attributes = {})
+      validate_required_fields!(attributes)
+
+      manifest_data = build_manifest_data(attributes)
+      write_manifest(manifest_data)
+
+      manifest_path
+    end
+
+    # Reads the existing plugin manifest
+    def read
+      return nil unless exists?
+
+      JSON.parse(File.read(manifest_path))
+    rescue JSON::ParserError => e
+      raise Aircana::Error, "Invalid JSON in plugin manifest: #{e.message}"
+    end
+
+    # Updates the plugin manifest with new values
+    def update(attributes = {})
+      current_data = read || {}
+      updated_data = current_data.merge(attributes.transform_keys(&:to_s))
+
+      validate_required_fields!(updated_data)
+      write_manifest(updated_data)
+
+      manifest_path
+    end
+
+    # Bumps the version number (major, minor, or patch)
+    def bump_version(type = :patch)
+      current_data = read
+      raise Aircana::Error, "No plugin manifest found at #{manifest_path}" unless current_data
+
+      current_version = current_data["version"]
+      new_version = bump_semantic_version(current_version, type)
+
+      update("version" => new_version)
+      new_version
+    end
+
+    # Checks if the plugin manifest exists
+    def exists?
+      File.exist?(manifest_path)
+    end
+
+    # Returns the path to the plugin manifest
+    def manifest_path
+      File.join(plugin_root, ".claude-plugin", "plugin.json")
+    end
+
+    # Returns the directory containing the manifest
+    def manifest_dir
+      File.join(plugin_root, ".claude-plugin")
+    end
+
+    # Validates the current manifest structure
+    def validate!
+      data = read
+      raise Aircana::Error, "No plugin manifest found" unless data
+
+      validate_required_fields!(data)
+      validate_version_format!(data["version"])
+
+      true
+    end
+
+    private
+
+    def build_manifest_data(attributes)
+      data = {
+        "name" => attributes[:name] || attributes["name"],
+        "version" => attributes[:version] || attributes["version"] || "0.1.0"
+      }
+
+      # Add optional fields if provided
+      OPTIONAL_FIELDS.each do |field|
+        value = attributes[field.to_sym] || attributes[field]
+        data[field] = value if value
+      end
+
+      data
+    end
+
+    def write_manifest(data)
+      FileUtils.mkdir_p(manifest_dir)
+      File.write(manifest_path, JSON.pretty_generate(data))
+    end
+
+    def validate_required_fields!(data)
+      REQUIRED_FIELDS.each do |field|
+        unless data[field] || data[field.to_sym]
+          raise Aircana::Error, "Plugin manifest missing required field: #{field}"
+        end
+      end
+    end
+
+    def validate_version_format!(version)
+      return if version.match?(/^\d+\.\d+\.\d+/)
+
+      raise Aircana::Error, "Invalid version format: #{version}. Must be semantic versioning (e.g., 1.0.0)"
+    end
+
+    def bump_semantic_version(version, type)
+      parts = version.split(".").map(&:to_i)
+      raise Aircana::Error, "Invalid version format: #{version}" if parts.size != 3
+
+      case type.to_sym
+      when :major
+        [parts[0] + 1, 0, 0].join(".")
+      when :minor
+        [parts[0], parts[1] + 1, 0].join(".")
+      when :patch
+        [parts[0], parts[1], parts[2] + 1].join(".")
+      else
+        raise Aircana::Error, "Invalid version bump type: #{type}. Must be major, minor, or patch"
+      end
+    end
+
+    class << self
+      # Creates a default plugin name from a directory path
+      def default_plugin_name(directory)
+        File.basename(directory).downcase.gsub(/[^a-z0-9]+/, "-")
+      end
+    end
+  end
+end

data/lib/aircana/system_checker.rb

@@ -98,7 +98,6 @@ module Aircana
       def check_configuration_directories
         {
           global: File.expand_path("~/.aircana"),
-          project: File.join(Dir.pwd, ".aircana"),
           claude_global: File.expand_path("~/.claude"),
           claude_project: File.join(Dir.pwd, ".claude")
         }.transform_values { |path| Dir.exist?(path) }

data/lib/aircana/templates/agents/base_agent.erb

@@ -5,7 +5,7 @@ model: <%=  model %>
 color: <%=  color %>
 ---
 
-<%=  helpers.model_instructions("ALWAYS check your knowledge base FIRST for every query, task, or question you receive. Use `ls .claude/agents/#{agent_name}/knowledge/*.md` to list files from your knowledge base.
+<%=  helpers.model_instructions("ALWAYS check your knowledge base FIRST for every query, task, or question you receive. Use `ls ${CLAUDE_PLUGIN_ROOT}/agents/#{agent_name}/knowledge/*.md` to list files from your knowledge base.
 
 MANDATORY WORKFLOW:
 1. BEFORE responding to ANY request - search and read relevant files in your knowledge base
@@ -18,7 +18,7 @@ Your knowledge base contains domain-specific information that takes priority ove
 
 ## Knowledge Base Integration
 
-Your specialized knowledge is in the current project directory. Use `ls .claude/agents/<%=  agent_name %>/knowledge/*.md` to list available files, then read them with the Read tool.
+Your specialized knowledge is in the plugin directory. Use `ls ${CLAUDE_PLUGIN_ROOT}/agents/<%=  agent_name %>/knowledge/*.md` to list available files, then read them with the Read tool.
 
 This knowledge base contains:
 - Domain-specific documentation from Confluence

data/lib/aircana/templates/hooks/user_prompt_submit.erb

@@ -22,12 +22,6 @@ if [ -f "Gemfile" ]; then
   fi
 fi
 
-# Check for relevant files context
-if [ -d ".aircana/relevant_files" ] && [ "$(ls -A .aircana/relevant_files 2>/dev/null)" ]; then
-  RELEVANT_COUNT=$(ls .aircana/relevant_files | wc -l)
-  CONTEXT_ADDITIONS="${CONTEXT_ADDITIONS}\n\nRelevant Files: $RELEVANT_COUNT files currently in context."
-fi
-
 # Output JSON response with additional context
 if [ -n "$CONTEXT_ADDITIONS" ]; then
   # Escape context for JSON

data/lib/aircana/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Aircana
-  VERSION = "3.0.0.rc1"
+  VERSION = "3.0.0.rc3"
 end

data/spec_target_1760205040_181/agents/test-agent/manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "agent": "test-agent",
+  "sources": [
+    {
+      "type": "confluence",
+      "label": "test-agent",
+      "pages": [
+        {
+          "id": "123"
+        }
+      ]
+    }
+  ]
+}

data/spec_target_1760205220_486/agents/test-agent/manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "agent": "test-agent",
+  "sources": [
+    {
+      "type": "confluence",
+      "label": "test-agent",
+      "pages": [
+        {
+          "id": "123"
+        }
+      ]
+    }
+  ]
+}

data/spec_target_1760205379_250/agents/test-agent/manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "agent": "test-agent",
+  "sources": [
+    {
+      "type": "confluence",
+      "label": "test-agent",
+      "pages": [
+        {
+          "id": "123"
+        }
+      ]
+    }
+  ]
+}

data/spec_target_1760205601_652/agents/test-agent/manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "agent": "test-agent",
+  "sources": [
+    {
+      "type": "confluence",
+      "label": "test-agent",
+      "pages": [
+        {
+          "id": "123"
+        }
+      ]
+    }
+  ]
+}

data/spec_target_1760205608_135/agents/test-agent/manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "agent": "test-agent",
+  "sources": [
+    {
+      "type": "confluence",
+      "label": "test-agent",
+      "pages": [
+        {
+          "id": "123"
+        }
+      ]
+    }
+  ]
+}

data/spec_target_1760205654_952/agents/test-agent/manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0",
+  "agent": "test-agent",
+  "sources": [
+    {
+      "type": "confluence",
+      "label": "test-agent",
+      "pages": [
+        {
+          "id": "123"
+        }
+      ]
+    }
+  ]
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 3.0.0.rc1
+  version: 3.0.0.rc3
 platform: ruby
 authors:
 - Weston Dransfield
@@ -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,7 +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/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
@@ -150,9 +167,11 @@ files:
 - lib/aircana/generators/plan_command_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/system_checker.rb
 - lib/aircana/templates/agents/base_agent.erb
@@ -178,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

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

@@ -1,169 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require_relative "generate"
-
-module Aircana
-  module CLI
-    module Install
-      class << self
-        def run
-          generate_files
-          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 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