aircana 2.0.0 → 3.0.0.rc2

data/lib/aircana/hooks_manifest.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module Aircana
+  # Manages Claude Code plugin hooks manifest (hooks/hooks.json) files
+  class HooksManifest
+    VALID_EVENTS = %w[PreToolUse PostToolUse UserPromptSubmit SessionStart Notification].freeze
+    VALID_HOOK_TYPES = %w[command validation notification].freeze
+
+    attr_reader :plugin_root
+
+    def initialize(plugin_root)
+      @plugin_root = plugin_root
+    end
+
+    # Creates a new hooks manifest with the given hooks configuration
+    def create(hooks_config = {})
+      validate_hooks_config!(hooks_config)
+      write_manifest(hooks_config)
+
+      manifest_path
+    end
+
+    # Reads the existing hooks manifest
+    def read
+      return nil unless exists?
+
+      JSON.parse(File.read(manifest_path))
+    rescue JSON::ParserError => e
+      raise Aircana::Error, "Invalid JSON in hooks manifest: #{e.message}"
+    end
+
+    # Updates the hooks manifest with new values
+    def update(hooks_config = {})
+      current_data = read || {}
+      updated_data = deep_merge(current_data, hooks_config)
+
+      validate_hooks_config!(updated_data)
+      write_manifest(updated_data)
+
+      manifest_path
+    end
+
+    # Adds a hook to the manifest
+    def add_hook(event:, hook_entry:, matcher: nil)
+      validate_event!(event)
+      validate_hook_entry!(hook_entry)
+
+      current_data = read || {}
+      current_data[event] ||= []
+
+      hook_config = build_hook_config(hook_entry, matcher)
+      current_data[event] << hook_config
+
+      write_manifest(current_data)
+      manifest_path
+    end
+
+    # Removes a hook from the manifest
+    def remove_hook(event:, command:)
+      current_data = read
+      return manifest_path unless current_data && current_data[event]
+
+      current_data[event].reject! do |hook_group|
+        hook_group["hooks"]&.any? { |h| h["command"] == command }
+      end
+
+      current_data.delete(event) if current_data[event].empty?
+
+      write_manifest(current_data)
+      manifest_path
+    end
+
+    # Checks if the hooks manifest exists
+    def exists?
+      File.exist?(manifest_path)
+    end
+
+    # Returns the path to the hooks manifest
+    def manifest_path
+      File.join(plugin_root, "hooks", "hooks.json")
+    end
+
+    # Returns the hooks directory
+    def hooks_dir
+      File.join(plugin_root, "hooks")
+    end
+
+    # Validates the current manifest structure
+    def validate!
+      data = read
+      return true unless data # Empty manifest is valid
+
+      validate_hooks_config!(data)
+      true
+    end
+
+    # Converts old settings.local.json hook format to hooks.json format
+    def self.from_settings_format(settings_hooks)
+      hooks_config = {}
+
+      settings_hooks.each do |event, hook_groups|
+        hooks_config[event] = hook_groups.map do |group|
+          {
+            "hooks" => group["hooks"],
+            "matcher" => group["matcher"]
+          }.compact
+        end
+      end
+
+      hooks_config
+    end
+
+    private
+
+    def build_hook_config(hook_entry, matcher)
+      config = {
+        "hooks" => [hook_entry]
+      }
+      config["matcher"] = matcher if matcher
+      config
+    end
+
+    def write_manifest(data)
+      FileUtils.mkdir_p(hooks_dir)
+      File.write(manifest_path, JSON.pretty_generate(data))
+    end
+
+    def validate_hooks_config!(config)
+      return if config.nil? || config.empty?
+
+      config.each do |event, hook_groups|
+        validate_event!(event)
+
+        raise Aircana::Error, "Hook configuration for #{event} must be an array" unless hook_groups.is_a?(Array)
+
+        hook_groups.each do |group|
+          validate_hook_group!(group)
+        end
+      end
+    end
+
+    def validate_event!(event)
+      return if VALID_EVENTS.include?(event)
+
+      raise Aircana::Error, "Invalid hook event: #{event}. Must be one of: #{VALID_EVENTS.join(", ")}"
+    end
+
+    def validate_hook_group!(group)
+      raise Aircana::Error, "Hook group must be a hash with 'hooks' array" unless group.is_a?(Hash) && group["hooks"]
+
+      raise Aircana::Error, "Hook group 'hooks' must be an array" unless group["hooks"].is_a?(Array)
+
+      group["hooks"].each do |hook|
+        validate_hook_entry!(hook)
+      end
+    end
+
+    def validate_hook_entry!(hook)
+      raise Aircana::Error, "Hook entry must be a hash" unless hook.is_a?(Hash)
+
+      unless hook["type"] && VALID_HOOK_TYPES.include?(hook["type"])
+        raise Aircana::Error, "Hook must have a valid type: #{VALID_HOOK_TYPES.join(", ")}"
+      end
+
+      return if hook["command"]
+
+      raise Aircana::Error, "Hook must have a command"
+    end
+
+    def deep_merge(hash1, hash2)
+      result = hash1.dup
+
+      hash2.each do |key, value|
+        result[key] = if result[key].is_a?(Hash) && value.is_a?(Hash)
+                        deep_merge(result[key], value)
+                      elsif result[key].is_a?(Array) && value.is_a?(Array)
+                        result[key] + value
+                      else
+                        value
+                      end
+      end
+
+      result
+    end
+  end
+end

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

@@ -23,16 +23,6 @@ module Aircana
           "Arch" => "pacman -S git",
           "Other" => "https://git-scm.com/downloads"
         }
-      },
-      "jq" => {
-        purpose: "JSON parsing for multi-root configuration",
-        install: {
-          "macOS" => "brew install jq",
-          "Ubuntu/Debian" => "apt install jq",
-          "Fedora/CentOS" => "dnf install jq",
-          "Arch" => "pacman -S jq",
-          "Other" => "https://jqlang.github.io/jq/download/"
-        }
       }
     }.freeze
 
@@ -108,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 .aircana/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 .aircana/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/session_start.erb

@@ -1,127 +1,12 @@
 #!/bin/bash
-# Multi-root project support hook for Aircana
+# Session start hook for Aircana
 # This hook runs when a new Claude Code session starts
 
-PROJECT_JSON=".aircana/project.json"
-CLAUDE_AGENTS_DIR=".claude/agents"
-AIRCANA_AGENTS_DIR=".aircana/agents"
-
 # Create log directory if it doesn't exist
 mkdir -p ~/.aircana
 
 # Log session start
 echo "$(date): New Claude Code session started in $(pwd)" >> ~/.aircana/hooks.log
 
-# Check if jq is available
-if ! command -v jq &> /dev/null; then
-    echo "$(date): Warning - jq not found. Multi-root support disabled." >> ~/.aircana/hooks.log
-    echo "{}"
-    exit 0
-fi
-
-# Check if project.json exists
-if [ ! -f "$PROJECT_JSON" ]; then
-    echo "$(date): No project.json found, skipping multi-root setup" >> ~/.aircana/hooks.log
-    echo "{}"
-    exit 0
-fi
-
-echo "$(date): Processing multi-root configuration from $PROJECT_JSON" >> ~/.aircana/hooks.log
-
-# Ensure directories exist
-mkdir -p "$CLAUDE_AGENTS_DIR" 2>/dev/null
-mkdir -p "$AIRCANA_AGENTS_DIR" 2>/dev/null
-
-# Clean up existing symlinks (only remove symlinks, not real files)
-find "$CLAUDE_AGENTS_DIR" -type l -delete 2>/dev/null
-find "$AIRCANA_AGENTS_DIR" -type l -delete 2>/dev/null
-
-# Parse folders from project.json
-FOLDERS=$(jq -r '.folders[]?.path // empty' "$PROJECT_JSON" 2>/dev/null)
-
-if [ -z "$FOLDERS" ]; then
-    echo "$(date): No folders configured in project.json" >> ~/.aircana/hooks.log
-    echo "{}"
-    exit 0
-fi
-
-# Track what we've linked for reporting
-LINKED_AGENTS=0
-LINKED_KNOWLEDGE=0
-
-# Create symlinks for each configured folder
-for folder in $FOLDERS; do
-    # Validate folder exists
-    if [ ! -d "$folder" ]; then
-        echo "$(date): Warning - folder '$folder' not found, skipping" >> ~/.aircana/hooks.log
-        continue
-    fi
-
-    echo "$(date): Processing folder: $folder" >> ~/.aircana/hooks.log
-
-    # Get folder name for prefix (replace slashes with underscores for nested paths)
-    PREFIX=$(echo "$folder" | tr '/' '_')
-
-    # Link agents from sub-folder .claude/agents
-    if [ -d "$folder/.claude/agents" ]; then
-        for agent_file in "$folder/.claude/agents"/*.md; do
-            if [ ! -f "$agent_file" ]; then
-                continue
-            fi
-
-            AGENT_NAME=$(basename "$agent_file" .md)
-            LINK_NAME="${PREFIX}_${AGENT_NAME}.md"
-            TARGET_PATH="$CLAUDE_AGENTS_DIR/$LINK_NAME"
-
-            # Create relative path from .claude/agents to the agent file
-            RELATIVE_PATH=$(realpath --relative-to="$CLAUDE_AGENTS_DIR" "$agent_file" 2>/dev/null)
-
-            if [ -n "$RELATIVE_PATH" ]; then
-                ln -sf "$RELATIVE_PATH" "$TARGET_PATH"
-                echo "$(date): Linked agent: $LINK_NAME -> $RELATIVE_PATH" >> ~/.aircana/hooks.log
-                ((LINKED_AGENTS++))
-            fi
-        done
-    fi
-
-    # Link knowledge from sub-folder .aircana/agents
-    if [ -d "$folder/.aircana/agents" ]; then
-        for agent_dir in "$folder/.aircana/agents"/*; do
-            if [ ! -d "$agent_dir" ]; then
-                continue
-            fi
-
-            AGENT_NAME=$(basename "$agent_dir")
-            LINK_NAME="${PREFIX}_${AGENT_NAME}"
-            TARGET_PATH="$AIRCANA_AGENTS_DIR/$LINK_NAME"
-
-            # Create relative path from .aircana/agents to the knowledge directory
-            RELATIVE_PATH=$(realpath --relative-to="$AIRCANA_AGENTS_DIR" "$agent_dir" 2>/dev/null)
-
-            if [ -n "$RELATIVE_PATH" ]; then
-                ln -sf "$RELATIVE_PATH" "$TARGET_PATH"
-                echo "$(date): Linked knowledge: $LINK_NAME -> $RELATIVE_PATH" >> ~/.aircana/hooks.log
-                ((LINKED_KNOWLEDGE++))
-            fi
-        done
-    fi
-done
-
-# Report results
-echo "$(date): Multi-root setup complete - linked $LINKED_AGENTS agents and $LINKED_KNOWLEDGE knowledge bases" >> ~/.aircana/hooks.log
-
-# Return success with optional context
-if [ $LINKED_AGENTS -gt 0 ] || [ $LINKED_KNOWLEDGE -gt 0 ]; then
-    CONTEXT="Multi-root: Linked $LINKED_AGENTS agents and $LINKED_KNOWLEDGE knowledge bases from configured folders."
-    ESCAPED_CONTEXT=$(echo -n "$CONTEXT" | sed 's/"/\\"/g')
-    cat << EOF
-{
-  "hookSpecificOutput": {
-    "hookEventName": "SessionStart",
-    "additionalContext": "$ESCAPED_CONTEXT"
-  }
-}
-EOF
-else
-    echo "{}"
-fi
+# Return success
+echo "{}"

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 = "2.0.0"
+  VERSION = "3.0.0.rc2"
 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"
+        }
+      ]
+    }
+  ]
+}