aircana 0.1.0 → 1.1.0.rc1

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.1.0.rc1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.0.rc1
 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
@@ -140,23 +143,34 @@ files:
 - lib/aircana/contexts/confluence_logging.rb
 - lib/aircana/contexts/confluence_setup.rb
 - lib/aircana/contexts/local.rb
+- lib/aircana/contexts/manifest.rb
 - lib/aircana/contexts/relevant_files.rb
 - lib/aircana/fzf_helper.rb
 - lib/aircana/generators.rb
 - 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 +199,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: []