aircana 0.1.0 → 1.0.0

data/lib/aircana/system_checker.rb

@@ -23,6 +23,16 @@ 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/hooks/bundle_install.erb

@@ -0,0 +1,63 @@
+#!/bin/bash
+# Bundle install hook generated by Aircana
+# This hook runs bundle install when Gemfile changes are detected
+
+# Get the tool details
+TOOL_NAME="$1"
+TOOL_PARAMS="$2"
+
+# Only act on file modification tools
+case "$TOOL_NAME" in
+  "Edit"|"Write"|"MultiEdit")
+    ;;
+  *)
+    exit 0
+    ;;
+esac
+
+# Check if Gemfile was modified
+if ! echo "$TOOL_PARAMS" | grep -q "Gemfile"; then
+  exit 0
+fi
+
+# Check if this is a Ruby project
+if [ ! -f "Gemfile" ]; then
+  exit 0
+fi
+
+echo "Gemfile modified, running bundle install..."
+
+# Run bundle install
+if command -v bundle >/dev/null 2>&1; then
+  bundle install
+  BUNDLE_EXIT_CODE=$?
+
+  if [ $BUNDLE_EXIT_CODE -eq 0 ]; then
+    cat << EOF
+{
+      "type": "advanced",
+      "decision": "allow",
+      "message": "Bundle install completed successfully after Gemfile modification."
+    }
+EOF
+  else
+    cat << EOF
+{
+      "type": "advanced",
+      "decision": "allow",
+      "message": "Bundle install failed. You may need to run 'bundle install' manually.\n\nError code: $BUNDLE_EXIT_CODE"
+    }
+EOF
+  fi
+else
+  cat << EOF
+{
+    "type": "advanced",
+    "decision": "allow",
+    "message": "Bundler not found. Please install bundler and run 'bundle install' manually."
+  }
+EOF
+fi
+
+# Always allow the modification to proceed
+exit 0

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

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Post-tool-use hook generated by Aircana
+# This hook runs after a tool has been executed
+
+# Get tool execution details
+TOOL_NAME="$1"
+TOOL_PARAMS="$2"
+TOOL_RESULT="$3"
+EXIT_CODE="$4"
+
+# Log the tool execution
+echo "$(date): Tool '$TOOL_NAME' completed with exit code: $EXIT_CODE" >> ~/.aircana/hooks.log
+
+# Initialize context for response
+ADDITIONAL_CONTEXT=""
+
+# Handle specific tools
+case "$TOOL_NAME" in
+  "Edit"|"Write")
+    # Auto-update relevant files context if code files were modified
+    if echo "$TOOL_PARAMS" | grep -E "\.(rb|js|py|ts)$" && [ "$EXIT_CODE" -eq 0 ]; then
+      ADDITIONAL_CONTEXT="Code file modified - consider updating relevant files context."
+    fi
+    ;;
+  "Bash")
+    # Handle bash command results
+    if [ "$EXIT_CODE" -ne 0 ]; then
+      echo "Bash command failed: $TOOL_PARAMS" >> ~/.aircana/hooks.log
+      ADDITIONAL_CONTEXT="Previous bash command failed with exit code $EXIT_CODE."
+    fi
+    ;;
+esac
+
+# Output appropriate JSON response
+if [ -n "$ADDITIONAL_CONTEXT" ]; then
+  # Escape context for JSON
+  ESCAPED_CONTEXT=$(echo -n "$ADDITIONAL_CONTEXT" | sed 's/"/\\"/g')
+  cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PostToolUse",
+    "additionalContext": "$ESCAPED_CONTEXT"
+  }
+}
+EOF
+else
+  # No additional context needed
+  echo "{}"
+fi

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

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Pre-tool-use hook generated by Aircana
+# This hook runs before any tool is executed
+
+# Get the tool name and parameters
+TOOL_NAME="$1"
+TOOL_PARAMS="$2"
+
+# Log the tool usage (optional)
+echo "$(date): About to use tool: $TOOL_NAME" >> ~/.aircana/hooks.log
+
+# Basic validation example
+case "$TOOL_NAME" in
+  "Bash")
+    # Add validation for bash commands
+    if echo "$TOOL_PARAMS" | grep -q "rm -rf /"; then
+      cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": "Dangerous command detected: rm -rf /"
+  }
+}
+EOF
+      exit 0
+    fi
+    ;;
+  "Edit"|"Write")
+    # Validate file operations
+    # Add custom validation logic here
+    ;;
+esac
+
+# Allow the tool to proceed
+cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "allow"
+  }
+}
+EOF

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

@@ -0,0 +1,72 @@
+#!/bin/bash
+# RSpec test hook generated by Aircana
+# This hook runs relevant tests when Ruby files are modified
+
+# Get the tool details
+TOOL_NAME="$1"
+TOOL_PARAMS="$2"
+
+# Only act on file modification tools
+case "$TOOL_NAME" in
+  "Edit"|"Write"|"MultiEdit")
+    ;;
+  *)
+    exit 0
+    ;;
+esac
+
+# Check if this is a Ruby project with RSpec
+if [ ! -f "Gemfile" ] || ! grep -q "rspec" Gemfile 2>/dev/null; then
+  exit 0
+fi
+
+# Extract file path from tool parameters (basic extraction)
+MODIFIED_FILE=$(echo "$TOOL_PARAMS" | grep -o '"[^"]*\.rb"' | head -1 | tr -d '"')
+
+if [ -z "$MODIFIED_FILE" ]; then
+  exit 0
+fi
+
+# Determine which specs to run based on the modified file
+SPEC_FILE=""
+
+# Check for corresponding spec file
+if echo "$MODIFIED_FILE" | grep -q "^lib/"; then
+  # For lib files, look for spec file
+  SPEC_FILE="spec/$(echo "$MODIFIED_FILE" | sed 's|^lib/||' | sed 's|\.rb$|_spec.rb|')"
+elif echo "$MODIFIED_FILE" | grep -q "^app/"; then
+  # For Rails app files
+  SPEC_FILE="spec/$(echo "$MODIFIED_FILE" | sed 's|^app/||' | sed 's|\.rb$|_spec.rb|')"
+elif echo "$MODIFIED_FILE" | grep -q "_spec\.rb$"; then
+  # If the modified file is already a spec file
+  SPEC_FILE="$MODIFIED_FILE"
+fi
+
+# Check if spec file exists
+if [ -n "$SPEC_FILE" ] && [ -f "$SPEC_FILE" ]; then
+  echo "Running tests for modified file: $MODIFIED_FILE"
+
+  # Run the specific test
+  if command -v bundle >/dev/null 2>&1; then
+    bundle exec rspec "$SPEC_FILE" --format progress
+  else
+    rspec "$SPEC_FILE" --format progress
+  fi
+
+  RSPEC_EXIT_CODE=$?
+
+  if [ $RSPEC_EXIT_CODE -ne 0 ]; then
+    cat << EOF
+{
+  "type": "advanced",
+  "decision": "allow",
+  "message": "Tests failed for $SPEC_FILE. Consider fixing the failing tests.\n\nYou can run: bundle exec rspec $SPEC_FILE"
+}
+EOF
+  else
+    echo "Tests passed for $SPEC_FILE"
+  fi
+fi
+
+# Always allow the modification to proceed
+exit 0

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

@@ -0,0 +1,55 @@
+#!/bin/bash
+# RuboCop pre-commit hook generated by Aircana
+# This hook runs RuboCop before allowing commits
+
+# Get the tool name and parameters
+TOOL_NAME="$1"
+TOOL_PARAMS="$2"
+
+# Only act on Bash commands that look like git commits
+if [ "$TOOL_NAME" != "Bash" ]; then
+  exit 0
+fi
+
+# Check if this is a git commit command
+if ! echo "$TOOL_PARAMS" | grep -q "git commit"; then
+  exit 0
+fi
+
+# Check if we're in a Ruby project
+if [ ! -f "Gemfile" ] && [ ! -f ".rubocop.yml" ]; then
+  exit 0
+fi
+
+# Get list of staged Ruby files
+RUBY_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(rb)$' | tr '\n' ' ')
+
+if [ -z "$RUBY_FILES" ]; then
+  # No Ruby files to check
+  exit 0
+fi
+
+echo "Running RuboCop on staged Ruby files..."
+
+# Run RuboCop on staged files
+if command -v bundle >/dev/null 2>&1 && [ -f "Gemfile" ]; then
+  bundle exec rubocop $RUBY_FILES
+else
+  rubocop $RUBY_FILES
+fi
+
+RUBOCOP_EXIT_CODE=$?
+
+if [ $RUBOCOP_EXIT_CODE -ne 0 ]; then
+  cat << EOF
+{
+  "type": "advanced",
+  "decision": "deny",
+  "message": "RuboCop found style violations. Please fix them before committing.\n\nYou can run: bundle exec rubocop $RUBY_FILES --auto-correct\n\nOr fix them manually and try again."
+}
+EOF
+  exit 1
+fi
+
+# RuboCop passed, allow the commit
+exit 0

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

@@ -0,0 +1,127 @@
+#!/bin/bash
+# Multi-root project support 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

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

@@ -0,0 +1,46 @@
+#!/bin/bash
+# User prompt submit hook generated by Aircana
+# This hook runs when the user submits a prompt
+
+# Get the user prompt
+USER_PROMPT="$1"
+
+# Add context information based on project state
+CONTEXT_ADDITIONS=""
+
+# Check if this is a Ruby project and add relevant info
+if [ -f "Gemfile" ]; then
+  CONTEXT_ADDITIONS="${CONTEXT_ADDITIONS}\n\nProject Context: This is a Ruby project with Gemfile present."
+
+  # Check for common Ruby frameworks
+  if grep -q "rails" Gemfile 2>/dev/null; then
+    CONTEXT_ADDITIONS="${CONTEXT_ADDITIONS} Rails framework detected."
+  fi
+
+  if grep -q "rspec" Gemfile 2>/dev/null; then
+    CONTEXT_ADDITIONS="${CONTEXT_ADDITIONS} RSpec testing framework in use."
+  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
+  ESCAPED_CONTEXT=$(echo -n "$CONTEXT_ADDITIONS" | sed 's/"/\\"/g' | tr '\n' ' ' | sed 's/  */ /g')
+  cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "$ESCAPED_CONTEXT"
+  }
+}
+EOF
+else
+  # No additional context needed
+  echo "{}"
+fi

data/lib/aircana/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Aircana
-  VERSION = "0.1.0"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Weston Dransfield
@@ -93,9 +93,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description: A Ruby CLI utility for context management and Claude Codeintegration.
-  Aircana helps manage relevant files for developmentsessions, create specialized
-  Claude Code agents, and optionally syncknowledge from Confluence.
+description: Aircana provides context management and workflow utilities for software
+  engineering with AI agents, including file organization and template generation.
 email:
 - weston@dransfield.dev
 executables:
@@ -127,10 +126,14 @@ files:
 - lib/aircana/cli/commands/doctor_checks.rb
 - lib/aircana/cli/commands/doctor_helpers.rb
 - lib/aircana/cli/commands/dump_context.rb
+- lib/aircana/cli/commands/files.rb
 - lib/aircana/cli/commands/generate.rb
+- lib/aircana/cli/commands/hooks.rb
 - lib/aircana/cli/commands/install.rb
 - lib/aircana/cli/commands/plan.rb
+- lib/aircana/cli/commands/project.rb
 - lib/aircana/cli/commands/work.rb
+- lib/aircana/cli/help_formatter.rb
 - lib/aircana/cli/shell_command.rb
 - lib/aircana/cli/subcommand.rb
 - lib/aircana/configuration.rb
@@ -146,17 +149,27 @@ files:
 - lib/aircana/generators/agents_generator.rb
 - lib/aircana/generators/base_generator.rb
 - lib/aircana/generators/helpers.rb
+- lib/aircana/generators/hooks_generator.rb
+- lib/aircana/generators/project_config_generator.rb
 - lib/aircana/generators/relevant_files_command_generator.rb
 - lib/aircana/generators/relevant_files_verbose_results_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/planner.erb
 - lib/aircana/templates/agents/defaults/worker.erb
 - lib/aircana/templates/commands/add_relevant_files.erb
+- lib/aircana/templates/hooks/bundle_install.erb
+- lib/aircana/templates/hooks/post_tool_use.erb
+- lib/aircana/templates/hooks/pre_tool_use.erb
+- lib/aircana/templates/hooks/rspec_test.erb
+- lib/aircana/templates/hooks/rubocop_pre_commit.erb
+- lib/aircana/templates/hooks/session_start.erb
+- lib/aircana/templates/hooks/user_prompt_submit.erb
 - lib/aircana/templates/relevant_files_verbose_results.erb
 - lib/aircana/version.rb
 - sig/aircana.rbs
@@ -185,5 +198,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Workflow and context utilities for engineering with agents
+summary: Humble workflow and context utilities for engineering with agents
 test_files: []