aircana 2.0.0 → 3.0.0.rc1

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

@@ -2,7 +2,6 @@
 
 require "json"
 require_relative "generate"
-require_relative "../../generators/project_config_generator"
 
 module Aircana
   module CLI
@@ -10,7 +9,6 @@ module Aircana
       class << self
         def run
           generate_files
-          ensure_project_config_exists
           install_commands_to_claude
           install_hooks_to_claude
         end
@@ -22,14 +20,6 @@ module Aircana
           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)

data/lib/aircana/cli/help_formatter.rb

@@ -26,7 +26,6 @@ module Aircana
           "File Management" => %w[files],
           "Agent Management" => %w[agents],
           "Hook Management" => %w[hooks],
-          "Project Management" => %w[project],
           "System" => %w[generate install doctor dump-context]
         }
       end
@@ -53,7 +52,7 @@ module Aircana
       end
 
       def subcommand?(cmd_name)
-        %w[files agents hooks project].include?(cmd_name)
+        %w[files agents hooks].include?(cmd_name)
       end
 
       def print_subcommand_group(subcommand_name, cmd)

data/lib/aircana/configuration.rb

@@ -19,7 +19,7 @@ module Aircana
       @global_dir = File.join(Dir.home, ".aircana")
       @project_dir = Dir.pwd
       @output_dir = File.join(@global_dir, "aircana.out")
-      @agent_knowledge_dir = File.join(@project_dir, ".aircana", "agents")
+      @agent_knowledge_dir = File.join(@project_dir, ".claude", "agents")
       @hooks_dir = File.join(@project_dir, ".aircana", "hooks")
     end
 

data/lib/aircana/contexts/manifest.rb

@@ -73,14 +73,7 @@ module Aircana
         end
 
         def resolve_agent_path(agent)
-          base_path = File.join(Aircana.configuration.agent_knowledge_dir, agent)
-
-          # If this is a symlink (multi-root scenario), resolve to original
-          if File.symlink?(base_path)
-            File.readlink(base_path)
-          else
-            base_path
-          end
+          File.join(Aircana.configuration.agent_knowledge_dir, agent)
         end
 
         def build_manifest_data(agent, sources)

data/lib/aircana/generators/agents_generator.rb

@@ -64,7 +64,7 @@ module Aircana
       end
 
       def knowledge_path
-        ".aircana/agents/#{agent_name}/knowledge/"
+        ".claude/agents/#{agent_name}/knowledge/"
       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
 

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/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 current project directory. Use `ls .claude/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/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0.rc1
 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
@@ -126,7 +126,6 @@ files:
 - 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/help_formatter.rb
 - lib/aircana/cli/shell_command.rb
 - lib/aircana/cli/subcommand.rb
@@ -149,14 +148,12 @@ 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/human_logger.rb
 - lib/aircana/initializers.rb
 - lib/aircana/llm/claude_client.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
@@ -204,7 +201,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/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