s9n-devops-agent 2.0.1 → 2.0.3

package/bin/cs-devops-agent

@@ -51,8 +51,23 @@ switch(command) {
   case 'start':
   case 'session':
     // Start interactive session manager
+    // Try bash script first (for Unix/Mac), fallback to Node implementation for Windows
     const sessionScript = join(rootDir, 'start-devops-session.sh');
-    if (fs.existsSync(sessionScript)) {
+    
+    if (process.platform === 'win32') {
+      // On Windows, check if bash is available, otherwise use Node coordinator
+      import('child_process').then(({ execSync }) => {
+        try {
+          execSync('bash --version', { stdio: 'ignore' });
+          // Bash is available, use the shell script
+          runShellScript(sessionScript, args.slice(1));
+        } catch (e) {
+          // Bash not available, use Node.js session coordinator directly
+          console.log('Starting DevOps Agent session manager...\n');
+          runScript(join(rootDir, 'src', 'session-coordinator.js'), ['start', ...args.slice(1)]);
+        }
+      });
+    } else if (fs.existsSync(sessionScript)) {
       runShellScript(sessionScript, args.slice(1));
     } else {
       console.error('Session script not found. Please ensure the package is properly installed.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s9n-devops-agent",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "CS_DevOpsAgent - Intelligent Git Automation System with multi-agent support and session management",
   "type": "module",
   "main": "src/cs-devops-agent-worker.js",
@@ -10,6 +10,7 @@
   "files": [
     "bin/",
     "src/",
+    "scripts/",
     "docs/",
     "start-devops-session.sh",
     "cleanup-sessions.sh",

package/scripts/changed-areas.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(git rev-parse --show-toplevel)"
+
+# Redirect log output to stderr to keep stdout clean
+exec 3>&1
+exec 1>&2
+source "$ROOT/scripts/lib/log.sh"
+
+BASE="${BASE_REF:-origin/main}"
+HEAD="${HEAD_REF:-HEAD}"
+
+# Allow flags: --base <ref> --head <ref>
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --base) BASE="$2"; shift 2 ;;
+    --head) HEAD="$2"; shift 2 ;;
+    *) log_warn "Unknown flag: $1"; shift ;;
+  esac
+done
+
+log_group_start "Computing changed areas (BASE=$BASE, HEAD=$HEAD)"
+changed_files=$(git diff --name-only "$BASE" "$HEAD" || true)
+if [ -z "${changed_files}" ]; then
+  log_info "No changed files detected."
+  log_group_end
+  exit 0
+fi
+
+# Heuristics:
+# - Ignore tests + scripts + docs when mapping areas
+# - Map first two path segments as <area>/<component> when possible
+# - For monorepos with packages/<pkg> or apps/<app>, area=<pkg|app>, component=inferred child
+areas=()
+
+while IFS= read -r f; do
+  # Normalize and skip
+  [[ -z "$f" ]] && continue
+  [[ "$f" =~ ^test_cases/ ]] && { log_debug "Skip test file $f"; continue; }
+  [[ "$f" =~ ^scripts/ ]] && { log_debug "Skip script $f"; continue; }
+  [[ "$f" =~ ^docs?/ ]] && { log_debug "Skip docs $f"; continue; }
+
+  # CS_DevOpsAgent-specific patterns
+  if [[ "$f" =~ ^worktree-manager\.js$ ]]; then
+    area="worktree"
+    component="manager"
+  elif [[ "$f" =~ ^src/cs-devops-agent-worker\.js$ ]]; then
+    area="cs-devops-agent"
+    component="worker"
+  elif [[ "$f" =~ ^cs-devops-agent-worker\.js$ ]]; then
+    area="cs-devops-agent"
+    component="worker"
+  elif [[ "$f" =~ ^run-with-agent\.js$ ]]; then
+    area="agent"
+    component="runner"
+  elif [[ "$f" =~ ^product_requirement_docs/(.+)\.md$ ]]; then
+    area="docs"
+    component="${BASH_REMATCH[1]}"
+  # Monorepo patterns
+  elif [[ "$f" =~ ^packages/([^/]+)/([^/]+)/ ]]; then
+    area="${BASH_REMATCH[1]}"
+    component="${BASH_REMATCH[2]}"
+  elif [[ "$f" =~ ^apps/([^/]+)/([^/]+)/ ]]; then
+    area="${BASH_REMATCH[1]}"
+    component="${BASH_REMATCH[2]}"
+  elif [[ "$f" =~ ^([^/]+)/([^/]+)/ ]]; then
+    area="${BASH_REMATCH[1]}"
+    component="${BASH_REMATCH[2]}"
+  elif [[ "$f" =~ ^([^/]+)/ ]]; then
+    area="${BASH_REMATCH[1]}"
+    component="default"
+  else
+    area="root"
+    component="default"
+  fi
+
+  path="test_cases/${area}/${component}"
+  log_debug "Map $f -> $path"
+  areas+=("$path")
+done <<< "$changed_files"
+
+# Unique + existing or prospective test dirs
+unique=($(printf "%s\n" "${areas[@]}" | sort -u))
+
+# Output test dirs to original stdout
+exec 1>&3
+for a in "${unique[@]}"; do
+  echo "$a"
+done
+
+# Restore stderr for final log
+exec 1>&2
+log_group_end

package/scripts/coordination/check-file-availability.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# Check if files are available for editing
+
+FILES_TO_CHECK="$@"
+COORD_DIR=".file-coordination/active-edits"
+BLOCKED_FILES=""
+
+for file in $FILES_TO_CHECK; do
+    # Check if file is being edited
+    if [ -n "$(ls -A "$COORD_DIR" 2>/dev/null)" ]; then
+        if grep -l "\"$file\"" "$COORD_DIR"/*.json 2>/dev/null | head -1; then
+            BLOCKED_BY=$(grep -l "\"$file\"" "$COORD_DIR"/*.json | xargs basename | cut -d. -f1)
+            echo "❌ BLOCKED: $file (being edited by $BLOCKED_BY)"
+            BLOCKED_FILES="$BLOCKED_FILES $file"
+        else
+            echo "✅ AVAILABLE: $file"
+        fi
+    else
+        echo "✅ AVAILABLE: $file"
+    fi
+done
+
+if [ -n "$BLOCKED_FILES" ]; then
+    exit 1
+else
+    exit 0
+fi

package/scripts/coordination/declare-file-edits.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# Declare files that will be edited
+
+AGENT="${1:-unknown}"
+SESSION="${2:-$(date +%s)}"
+shift 2
+FILES="$@"
+
+COORD_DIR=".file-coordination"
+DECLARATION_FILE="$COORD_DIR/active-edits/${AGENT}-${SESSION}.json"
+
+# Ensure directory exists
+mkdir -p "$COORD_DIR/active-edits"
+
+# Check if any files are already being edited
+for file in $FILES; do
+    # Check each existing JSON file
+    for json_file in "$COORD_DIR/active-edits"/*.json; do
+        # Skip if no files exist (glob didn't expand)
+        [ -f "$json_file" ] || continue
+        # Skip our own declaration file
+        [ "$json_file" = "$DECLARATION_FILE" ] && continue
+        # Check if this file is already declared
+        if grep -q "\"$file\"" "$json_file" 2>/dev/null; then
+            agent_name=$(basename "$json_file" | cut -d'-' -f1)
+            echo "❌ Cannot declare: $file is already being edited by $agent_name"
+            exit 1
+        fi
+    done
+done
+
+# Create declaration
+cat > "$DECLARATION_FILE" << EOF
+{
+  "agent": "$AGENT",
+  "session": "$SESSION",
+  "files": [$(echo $FILES | sed 's/ /", "/g' | sed 's/^/"/;s/$/"/')],
+  "operation": "edit",
+  "declaredAt": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "estimatedDuration": 300
+}
+EOF
+
+echo "✅ Declared edits for: $FILES"
+echo "Declaration saved to: $DECLARATION_FILE"

package/scripts/coordination/release-file-edits.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Release files after editing
+
+AGENT="${1:-unknown}"
+SESSION="${2:-*}"
+
+COORD_DIR=".file-coordination"
+DECLARATION_FILE="$COORD_DIR/active-edits/${AGENT}-${SESSION}.json"
+
+if ls $DECLARATION_FILE 1> /dev/null 2>&1; then
+    mv $DECLARATION_FILE "$COORD_DIR/completed-edits/" 2>/dev/null || true
+    echo "✅ Released files for $AGENT-$SESSION"
+else
+    echo "⚠️  No active declaration found for $AGENT-$SESSION"
+fi

package/scripts/lib/log.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+LOG_LEVEL="${LOG_LEVEL:-info}"
+TRACE="${TRACE:-0}"
+
+# Map level to numeric
+_level_num() {
+  local level_lower=$(echo "$1" | tr '[:upper:]' '[:lower:]')
+  case "$level_lower" in
+    debug) echo 10 ;;
+    info)  echo 20 ;;
+    warn)  echo 30 ;;
+    error) echo 40 ;;
+    *)     echo 20 ;;
+  esac
+}
+
+should_log() {
+  local want="$(_level_num "${1:-info}")"
+  local cur="$(_level_num "$LOG_LEVEL")"
+  [ "$want" -ge "$cur" ]
+}
+
+ts() { date -u +"%Y-%m-%dT%H:%M:%SZ"; }
+
+_log() {
+  local lvl="$1"; shift
+  if should_log "$lvl"; then
+    local lvl_upper=$(echo "$lvl" | tr '[:lower:]' '[:upper:]')
+    printf "%s [%s] %s\n" "$(ts)" "$lvl_upper" "$*" 1>&2
+  fi
+}
+
+log_debug() { _log debug "$@"; }
+log_info()  { _log info  "$@"; }
+log_warn()  { _log warn  "$@"; }
+log_error() { _log error "$@"; }
+
+log_group_start() {
+  # GitHub/Buildkite-style grouping (harmless locally)
+  echo "::group::$*" || true
+  log_info "$@"
+}
+log_group_end() {
+  echo "::endgroup::" || true
+}

package/scripts/post-install.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install Script for DevOps Agent
+ * =====================================
+ * 
+ * Runs after npm install/update to check and update house rules.
+ * Preserves user customizations while updating our managed sections.
+ */
+
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[36m',
+  red: '\x1b[31m'
+};
+
+async function main() {
+  try {
+    // Check if this is a global install - skip if so
+    const isGlobal = process.env.npm_config_global === 'true' ||
+                     process.env.npm_config_global === true ||
+                     (process.env.npm_config_prefix && 
+                      (process.cwd().startsWith(process.env.npm_config_prefix) ||
+                       // Windows specific global paths
+                       process.cwd().includes('\\npm\\') ||
+                       process.cwd().includes('\\npm-cache\\') ||
+                       process.cwd().includes('/lib/node_modules/') ||
+                       process.cwd().includes('\\node_modules\\')));
+    
+    if (isGlobal) {
+      // Skip post-install for global installations
+      return;
+    }
+
+    // Find project root (where npm install was run)
+    const projectRoot = process.env.INIT_CWD || process.cwd();
+    
+    // Don't run if we're in the DevOps Agent package itself
+    const packageJson = path.join(__dirname, '..', 'package.json');
+    if (fs.existsSync(packageJson)) {
+      const pkg = JSON.parse(fs.readFileSync(packageJson, 'utf8'));
+      if (pkg.name === 's9n-devops-agent') {
+        // We're in the package directory itself, not a project using it
+        const currentPackageJson = path.join(projectRoot, 'package.json');
+        if (fs.existsSync(currentPackageJson)) {
+          const currentPkg = JSON.parse(fs.readFileSync(currentPackageJson, 'utf8'));
+          if (currentPkg.name === 's9n-devops-agent') {
+            // Skip post-install when installing the package itself
+            return;
+          }
+        }
+      }
+    }
+
+    console.log(`\n${colors.bright}DevOps Agent Post-Install${colors.reset}`);
+    console.log(`${colors.dim}Checking house rules...${colors.reset}\n`);
+
+    // Dynamically import HouseRulesManager only when needed
+    const { default: HouseRulesManager } = await import('../src/house-rules-manager.js');
+
+    const manager = new HouseRulesManager(projectRoot);
+    const status = manager.getStatus();
+
+    if (!status.exists) {
+      console.log(`${colors.yellow}No house rules found in your project.${colors.reset}`);
+      
+      // Check if running in CI or if user wants auto-setup
+      const isCI = process.env.CI || process.env.CONTINUOUS_INTEGRATION || 
+                   process.env.GITHUB_ACTIONS || process.env.GITLAB_CI ||
+                   process.env.JENKINS_URL || process.env.TRAVIS;
+      
+      const autoSetup = isCI || process.env.DEVOPS_AUTO_SETUP === 'true';
+      
+      if (autoSetup) {
+        console.log(`${colors.blue}Creating house rules automatically...${colors.reset}`);
+        const result = await manager.updateHouseRules({ createIfMissing: true });
+        if (result.created) {
+          console.log(`${colors.green}✓ Created house rules at: ${path.relative(projectRoot, result.path)}${colors.reset}`);
+          console.log(`${colors.dim}AI agents will now follow project conventions and coordination protocols.${colors.reset}\n`);
+        }
+      } else {
+        console.log(`${colors.bright}House rules help AI agents understand your project.${colors.reset}`);
+        console.log(`\nTo set up house rules, you can:`);
+        console.log(`  1. Run ${colors.green}npm start${colors.reset} (recommended - interactive setup)`);
+        console.log(`  2. Set ${colors.blue}DEVOPS_AUTO_SETUP=true${colors.reset} before npm install`);
+        console.log(`  3. Run ${colors.green}npm run house-rules:update${colors.reset} manually\n`);
+      }
+      return;
+    }
+
+    if (status.needsUpdate) {
+      console.log(`${colors.yellow}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}`);
+      console.log(`${colors.bright}House Rules Update Available${colors.reset}`);
+      console.log(`${colors.yellow}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}\n`);
+      
+      // Show what will be updated
+      const sectionsToUpdate = [];
+      const sectionsToAdd = [];
+      
+      for (const [name, info] of Object.entries(status.managedSections)) {
+        if (info.needsUpdate) {
+          if (info.installed) {
+            sectionsToUpdate.push(`  • ${name} (${info.installedVersion} → ${info.currentVersion})`);
+          } else {
+            sectionsToAdd.push(`  • ${name} (new)`);
+          }
+        }
+      }
+      
+      if (sectionsToUpdate.length > 0) {
+        console.log('Sections to update:');
+        sectionsToUpdate.forEach(s => console.log(s));
+      }
+      
+      if (sectionsToAdd.length > 0) {
+        console.log('Sections to add:');
+        sectionsToAdd.forEach(s => console.log(s));
+      }
+      
+      console.log(`\n${colors.dim}Your custom rules will be preserved.${colors.reset}`);
+      
+      // Check if running in CI environment
+      const isCI = process.env.CI || process.env.CONTINUOUS_INTEGRATION || 
+                   process.env.GITHUB_ACTIONS || process.env.GITLAB_CI ||
+                   process.env.JENKINS_URL || process.env.TRAVIS;
+      
+      if (isCI) {
+        // In CI, auto-update without prompting
+        console.log(`${colors.blue}CI environment detected - auto-updating...${colors.reset}`);
+        const result = await manager.updateHouseRules();
+        if (result.updated) {
+          console.log(`${colors.green}✓ House rules updated successfully!${colors.reset}`);
+          if (result.updatedSections?.length > 0) {
+            console.log(`  Updated: ${result.updatedSections.join(', ')}`);
+          }
+          if (result.addedSections?.length > 0) {
+            console.log(`  Added: ${result.addedSections.join(', ')}`);
+          }
+        }
+      } else {
+        // In interactive environment, provide instructions
+        console.log(`\nTo update, run: ${colors.green}npm start${colors.reset}`);
+        console.log(`Or manually: ${colors.green}node node_modules/s9n-devops-agent/src/house-rules-manager.js update${colors.reset}\n`);
+      }
+    } else {
+      console.log(`${colors.green}✓${colors.reset} House rules are up to date.\n`);
+    }
+  } catch (error) {
+    // Silently fail - don't break npm install
+    if (process.env.DEBUG) {
+      console.error(`${colors.red}Error checking house rules:${colors.reset}`, error.message);
+    }
+  }
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch(() => {
+    // Silent fail for post-install
+    process.exit(0);
+  });
+}
+
+export default main;

package/scripts/repair-house-rules.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+
+# House Rules Repair Script
+# ==========================
+# Checks and repairs house rules if they're missing or corrupted
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;36m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m' # No Color
+
+echo -e "${BOLD}House Rules Health Check${NC}"
+echo -e "${DIM}Checking house rules status...${NC}"
+echo
+
+# Get the directory where this script is located
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Check if house-rules-manager exists
+if [[ ! -f "$ROOT_DIR/src/house-rules-manager.js" ]]; then
+    echo -e "${RED}Error: house-rules-manager.js not found${NC}"
+    echo "Please ensure you're running this from the DevOps Agent directory."
+    exit 1
+fi
+
+# Get status
+STATUS=$(node "$ROOT_DIR/src/house-rules-manager.js" status 2>&1 || echo '{"exists": false}')
+
+# Check if house rules exist
+EXISTS=$(echo "$STATUS" | grep -o '"exists"[[:space:]]*:[[:space:]]*true' || echo "")
+NEEDS_UPDATE=$(echo "$STATUS" | grep -o '"needsUpdate"[[:space:]]*:[[:space:]]*true' || echo "")
+
+if [[ -z "$EXISTS" ]]; then
+    echo -e "${YELLOW}⚠ House rules not found!${NC}"
+    echo
+    echo "This could happen if:"
+    echo "  • The file was accidentally deleted"
+    echo "  • This is a fresh installation"
+    echo "  • The file was moved to a different location"
+    echo
+    echo -n "Create house rules now? (Y/n): "
+    read CREATE_CHOICE
+    
+    if [[ "${CREATE_CHOICE}" != "n" ]] && [[ "${CREATE_CHOICE}" != "N" ]]; then
+        echo -e "${BLUE}Creating house rules...${NC}"
+        RESULT=$(node "$ROOT_DIR/src/house-rules-manager.js" update 2>&1)
+        
+        if echo "$RESULT" | grep -q '"created"[[:space:]]*:[[:space:]]*true'; then
+            echo -e "${GREEN}✓ House rules created successfully!${NC}"
+            
+            # Extract path if possible
+            PATH_LINE=$(echo "$RESULT" | grep -o '"path"[[:space:]]*:[[:space:]]*"[^"]*"' || echo "")
+            if [[ -n "$PATH_LINE" ]]; then
+                FILE_PATH=$(echo "$PATH_LINE" | sed 's/.*"path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+                echo -e "  Location: ${BOLD}$FILE_PATH${NC}"
+            fi
+        else
+            echo -e "${GREEN}✓ House rules restored!${NC}"
+        fi
+    else
+        echo -e "${YELLOW}Skipped house rules creation${NC}"
+        exit 0
+    fi
+    
+elif [[ -n "$NEEDS_UPDATE" ]]; then
+    echo -e "${YELLOW}House rules need updating${NC}"
+    echo
+    echo "Your house rules exist but some sections are outdated."
+    echo -e "${DIM}Your custom rules will be preserved during the update.${NC}"
+    echo
+    
+    # Show what needs updating
+    echo "$STATUS" | node -e "
+        const input = require('fs').readFileSync(0, 'utf8');
+        try {
+            const data = JSON.parse(input);
+            if (data.managedSections) {
+                const updates = [];
+                const additions = [];
+                for (const [name, info] of Object.entries(data.managedSections)) {
+                    if (info.needsUpdate) {
+                        if (info.installed) {
+                            updates.push(\`  • \${name} (\${info.installedVersion} → \${info.currentVersion})\`);
+                        } else {
+                            additions.push(\`  • \${name} (new)\`);
+                        }
+                    }
+                }
+                if (updates.length > 0) {
+                    console.log('Sections to update:');
+                    updates.forEach(u => console.log(u));
+                }
+                if (additions.length > 0) {
+                    console.log('\\nSections to add:');
+                    additions.forEach(a => console.log(a));
+                }
+            }
+        } catch (e) {
+            // Silent fail
+        }
+    " 2>/dev/null || true
+    
+    echo
+    echo -n "Update house rules now? (Y/n): "
+    read UPDATE_CHOICE
+    
+    if [[ "${UPDATE_CHOICE}" != "n" ]] && [[ "${UPDATE_CHOICE}" != "N" ]]; then
+        echo -e "${BLUE}Updating house rules...${NC}"
+        RESULT=$(node "$ROOT_DIR/src/house-rules-manager.js" update 2>&1)
+        echo -e "${GREEN}✓ House rules updated!${NC}"
+    else
+        echo -e "${YELLOW}Skipped house rules update${NC}"
+    fi
+    
+else
+    echo -e "${GREEN}✓ House rules are healthy!${NC}"
+    echo
+    
+    # Show current status
+    echo "$STATUS" | node -e "
+        const input = require('fs').readFileSync(0, 'utf8');
+        try {
+            const data = JSON.parse(input);
+            if (data.path) {
+                console.log(\`  Location: \${data.path}\`);
+            }
+            if (data.managedSections) {
+                console.log('  Managed sections:');
+                for (const [name, info] of Object.entries(data.managedSections)) {
+                    if (info.installed) {
+                        console.log(\`    • \${name} (v\${info.installedVersion})\`);
+                    }
+                }
+            }
+        } catch (e) {
+            // Silent fail
+        }
+    " 2>/dev/null || true
+    
+    echo
+    echo -e "${DIM}All sections are up to date.${NC}"
+fi
+
+echo

package/scripts/run-tests

@@ -0,0 +1,185 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(git rev-parse --show-toplevel)"
+cd "$ROOT"
+
+source "$ROOT/scripts/lib/log.sh"
+
+SCOPE="changed"   # changed | all | path
+TARGET_PATH=""
+BASE_REF="${BASE_REF:-origin/main}"
+HEAD_REF="${HEAD_REF:-HEAD}"
+
+# Parse flags
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --all)     SCOPE="all"; shift ;;
+    --changed) SCOPE="changed"; shift ;;
+    --base)    BASE_REF="$2"; shift 2 ;;
+    --head)    HEAD_REF="$2"; shift 2 ;;
+    -v|--verbose) LOG_LEVEL="debug"; shift ;;
+    -q|--quiet)   LOG_LEVEL="warn"; shift ;;
+    -*)
+      log_warn "Unknown flag: $1"; shift ;;
+    *)
+      # If a path is provided, treat as direct target
+      if [ -d "$1" ]; then
+        SCOPE="path"; TARGET_PATH="$1"; shift
+      else
+        log_warn "Ignoring unknown arg: $1"; shift
+      fi
+      ;;
+  esac
+done
+
+log_group_start "Test run setup"
+log_info "LOG_LEVEL=$LOG_LEVEL TRACE=$TRACE"
+log_info "SCOPE=$SCOPE BASE_REF=$BASE_REF HEAD_REF=$HEAD_REF TARGET_PATH=${TARGET_PATH:-<none>}"
+log_group_end
+
+langs=()
+
+has_any() { git ls-files "$1" >/dev/null 2>&1 && [ -n "$(git ls-files "$1")" ]; }
+
+# AutoCommit is JavaScript-based
+if has_any "*.js" || has_any "package.json"; then langs+=("node"); fi
+if has_any "*.py"; then langs+=("python"); fi
+if has_any "*.go"; then langs+=("go"); fi
+if has_any "pom.xml" || has_any "build.gradle" || has_any "build.gradle.kts"; then langs+=("java"); fi
+if has_any "Gemfile" || has_any "*.rb"; then langs+=("ruby"); fi
+
+if [ ${#langs[@]} -eq 0 ]; then
+  log_warn "No detectable languages. Exiting."
+  exit 0
+fi
+
+# Collect candidate test directories
+declare -a test_dirs=()
+
+if [ "$SCOPE" = "path" ]; then
+  test_dirs+=("$TARGET_PATH")
+elif [ "$SCOPE" = "changed" ]; then
+  if changed=$(scripts/changed-areas.sh --base "$BASE_REF" --head "$HEAD_REF"); then
+    while IFS= read -r line; do
+      [ -z "$line" ] && continue
+      test_dirs+=("$line")
+    done <<< "$changed"
+  fi
+fi
+
+# Fallbacks
+if [ "$SCOPE" = "all" ] || [ ${#test_dirs[@]} -eq 0 ]; then
+  if [ "$SCOPE" = "changed" ]; then
+    log_warn "No targeted test dirs inferred. Falling back to full suite."
+  fi
+  # collect all leaf test folders to avoid scanning entire repo
+  all_dirs=()
+  while IFS= read -r dir; do
+    [ -n "$dir" ] && all_dirs+=("$dir")
+  done < <(find test_cases -type d 2>/dev/null || true)
+  if [ ${#all_dirs[@]} -eq 0 ]; then
+    log_warn "No test_cases/ found. Exiting."
+    exit 0
+  fi
+  test_dirs=("${all_dirs[@]}")
+fi
+
+# De-dup and ensure dirs exist
+test_dirs_dedup=()
+while IFS= read -r dir; do
+  [ -n "$dir" ] && test_dirs_dedup+=("$dir")
+done < <(printf "%s\n" "${test_dirs[@]}" | sort -u)
+test_dirs=("${test_dirs_dedup[@]}")
+log_group_start "Planned test directories"
+printf "%s\n" "${test_dirs[@]}" | sed 's/^/- /'
+log_group_end
+
+run_python() {
+  if ! command -v pytest >/dev/null 2>&1; then
+    log_error "pytest not found. Install with: pip install -U pytest"
+    return 1
+  fi
+  if [ "${#test_dirs[@]}" -gt 0 ]; then
+    pytest -q "${test_dirs[@]}"
+  else
+    pytest -q
+  fi
+}
+
+run_node() {
+  if [ ! -f package.json ]; then
+    log_debug "No package.json; skipping node tests."
+    return 0
+  fi
+  
+  # For AutoCommit, we'll use Jest for testing
+  if npx --yes -- jest --version >/dev/null 2>&1; then
+    if [ "${#test_dirs[@]}" -gt 0 ]; then
+      npx --yes jest --runInBand "${test_dirs[@]}"
+    else
+      npx --yes jest --runInBand
+    fi
+  elif npx --yes -- vitest --version >/dev/null 2>&1; then
+    if [ "${#test_dirs[@]}" -gt 0 ]; then
+      npx --yes vitest run "${test_dirs[@]}"
+    else
+      npx --yes vitest run
+    fi
+  else
+    log_error "Neither jest nor vitest found. Install: npm i -D jest"
+    return 1
+  fi
+}
+
+run_go() {
+  # go test cannot target our folder layout directly; let's run full module
+  go test ./...
+}
+
+run_java() {
+  if [ -f "gradlew" ]; then
+    ./gradlew test
+  elif [ -f "mvnw" ]; then
+    ./mvnw -q -DskipTests=false test
+  elif command -v mvn >/dev/null 2>&1; then
+    mvn -q -DskipTests=false test
+  elif command -v gradle >/dev/null 2>&1; then
+    gradle test
+  else
+    log_error "No Java build tool found (Gradle/Maven)."
+    return 1
+  fi
+}
+
+run_ruby() {
+  if command -v rspec >/dev/null 2>&1; then
+    if [ "${#test_dirs[@]}" -gt 0 ]; then
+      rspec "${test_dirs[@]}"
+    else
+      rspec
+    fi
+  else
+    log_error "rspec not found. Install: bundle add rspec && bundle exec rspec --init"
+    return 1
+  fi
+}
+
+rc=0
+for l in "${langs[@]}"; do
+  log_group_start "Running $l tests"
+  case "$l" in
+    python) run_python || rc=$? ;;
+    node)   run_node   || rc=$? ;;
+    go)     run_go     || rc=$? ;;
+    java)   run_java   || rc=$? ;;
+    ruby)   run_ruby   || rc=$? ;;
+  esac
+  log_group_end
+done
+
+if [ "$rc" -ne 0 ]; then
+  log_error "One or more test suites failed with code $rc"
+else
+  log_info "All planned test suites passed."
+fi
+exit $rc

package/scripts/setup-file-coordination.sh

@@ -0,0 +1,416 @@
+#!/bin/bash
+
+# ============================================================================
+# FILE COORDINATION SYSTEM SETUP
+# ============================================================================
+# Creates a simple file-based coordination system where agents declare
+# which files they're about to edit, preventing conflicts
+# ============================================================================
+
+set -euo pipefail
+
+# Check if we're in the CS_DevOpsAgent directory and go up to the actual project
+CURRENT_DIR="$(pwd)"
+if [[ "$CURRENT_DIR" == *"/CS_DevOpsAgent"* ]] || [[ "$CURRENT_DIR" == *"/DevOpsAgent"* ]]; then
+    # Go up to the parent of Scripts_Dev (or wherever DevOpsAgent is)
+    ROOT="$(cd "$(dirname "$(dirname "$CURRENT_DIR")")" && pwd)"
+    # If that's MVPEmails, go up one more to DistilledConceptExtractor
+    if [[ "$(basename "$ROOT")" == "Scripts_Dev" ]]; then
+        ROOT="$(dirname "$ROOT")"
+    fi
+else
+    ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+fi
+
+COORD_DIR="$ROOT/.file-coordination"
+ACTIVE_EDITS="$COORD_DIR/active-edits"
+COMPLETED_EDITS="$COORD_DIR/completed-edits"
+BLOCKED_FILES="$COORD_DIR/blocked-files"
+
+echo "[INFO] Setting up file coordination system at: $ROOT"
+
+# Check for existing house rules
+# First check if HOUSERULES_PATH was passed from the parent script
+if [ -n "$HOUSERULES_PATH" ] && [ -f "$HOUSERULES_PATH" ]; then
+    # Use the path that was already found by the parent script
+    HOUSERULES_FOUND=true
+    echo "[INFO] Using house rules from parent script: $HOUSERULES_PATH"
+elif [ -f "$ROOT/houserules.md" ]; then
+    HOUSERULES_PATH="$ROOT/houserules.md"
+    HOUSERULES_FOUND=true
+    echo "[INFO] Found existing house rules at: houserules.md"
+elif [ -f "$ROOT/HOUSERULES.md" ]; then
+    HOUSERULES_PATH="$ROOT/HOUSERULES.md"
+    HOUSERULES_FOUND=true
+    echo "[INFO] Found existing house rules at: HOUSERULES.md"
+elif [ -f "$ROOT/.github/HOUSERULES.md" ]; then
+    HOUSERULES_PATH="$ROOT/.github/HOUSERULES.md"
+    HOUSERULES_FOUND=true
+    echo "[INFO] Found existing house rules at: .github/HOUSERULES.md"
+elif [ -f "$ROOT/docs/houserules.md" ]; then
+    HOUSERULES_PATH="$ROOT/docs/houserules.md"
+    HOUSERULES_FOUND=true
+    echo "[INFO] Found existing house rules at: docs/houserules.md"
+else
+    echo ""
+    echo "[PROMPT] No house rules found for AI agents."
+    echo "         House rules help AI agents understand your project conventions."
+    echo ""
+    echo "         Options:"
+    echo "         1) Create new house rules at houserules.md (recommended)"
+    echo "         2) Specify path to existing house rules"
+    echo "         3) Skip (not recommended)"
+    echo ""
+    echo "         Enter choice (1/2/3): "
+    read -r CHOICE
+    
+    case "$CHOICE" in
+        1|"")
+            HOUSERULES_PATH="$ROOT/houserules.md"
+            HOUSERULES_FOUND=false
+            echo "[INFO] Will create comprehensive house rules at: houserules.md"
+            ;;
+        2)
+            echo "[PROMPT] Please enter the path to your house rules file (relative to $ROOT):"
+            read -r CUSTOM_PATH
+            if [ -f "$ROOT/$CUSTOM_PATH" ]; then
+                HOUSERULES_PATH="$ROOT/$CUSTOM_PATH"
+                HOUSERULES_FOUND=true
+                echo "[INFO] Using house rules at: $CUSTOM_PATH"
+            else
+                echo "[WARNING] File not found. Will create house rules at: houserules.md"
+                HOUSERULES_PATH="$ROOT/houserules.md"
+                HOUSERULES_FOUND=false
+            fi
+            ;;
+        3)
+            echo "[WARNING] Skipping house rules setup. This is not recommended!"
+            echo "[WARNING] AI agents may not follow project conventions without house rules."
+            HOUSERULES_PATH="$ROOT/houserules.md"
+            HOUSERULES_FOUND=false
+            ;;
+        *)
+            HOUSERULES_PATH="$ROOT/houserules.md"
+            HOUSERULES_FOUND=false
+            echo "[INFO] Invalid choice. Will create house rules at: houserules.md"
+            ;;
+    esac
+fi
+
+# Create coordination directories
+mkdir -p "$ACTIVE_EDITS"
+mkdir -p "$COMPLETED_EDITS"
+mkdir -p "$BLOCKED_FILES"
+
+# Create the declaration template
+cat > "$COORD_DIR/DECLARE_TEMPLATE.json" << 'EOF'
+{
+  "agent": "agent-name",
+  "session": "session-id",
+  "files": [
+    "path/to/file1.js",
+    "path/to/file2.js"
+  ],
+  "operation": "edit|create|delete",
+  "reason": "Brief description of changes",
+  "declaredAt": "ISO-8601",
+  "estimatedDuration": 300
+}
+EOF
+
+# Create the check script for agents
+cat > "$ROOT/check-file-availability.sh" << 'SCRIPT'
+#!/bin/bash
+# Check if files are available for editing
+
+FILES_TO_CHECK="$@"
+COORD_DIR=".file-coordination/active-edits"
+BLOCKED_FILES=""
+
+for file in $FILES_TO_CHECK; do
+    # Check if file is being edited
+    if grep -l "\"$file\"" "$COORD_DIR"/*.json 2>/dev/null | head -1; then
+        BLOCKED_BY=$(grep -l "\"$file\"" "$COORD_DIR"/*.json | xargs basename | cut -d. -f1)
+        echo "❌ BLOCKED: $file (being edited by $BLOCKED_BY)"
+        BLOCKED_FILES="$BLOCKED_FILES $file"
+    else
+        echo "✅ AVAILABLE: $file"
+    fi
+done
+
+if [ -n "$BLOCKED_FILES" ]; then
+    exit 1
+else
+    exit 0
+fi
+SCRIPT
+chmod +x "$ROOT/check-file-availability.sh"
+
+# Create the declaration script
+cat > "$ROOT/declare-file-edits.sh" << 'SCRIPT'
+#!/bin/bash
+# Declare files that will be edited
+
+AGENT="${1:-unknown}"
+SESSION="${2:-$(date +%s)}"
+shift 2
+FILES="$@"
+
+COORD_DIR=".file-coordination"
+DECLARATION_FILE="$COORD_DIR/active-edits/${AGENT}-${SESSION}.json"
+
+# Check if any files are already being edited
+for file in $FILES; do
+    if grep -l "\"$file\"" "$COORD_DIR/active-edits"/*.json 2>/dev/null | grep -v "$DECLARATION_FILE" | head -1; then
+        echo "❌ Cannot declare: $file is already being edited"
+        exit 1
+    fi
+done
+
+# Create declaration
+cat > "$DECLARATION_FILE" << EOF
+{
+  "agent": "$AGENT",
+  "session": "$SESSION",
+  "files": [$(echo $FILES | sed 's/ /", "/g' | sed 's/^/"/;s/$/"/')]
+  "operation": "edit",
+  "declaredAt": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "estimatedDuration": 300
+}
+EOF
+
+echo "✅ Declared edits for: $FILES"
+echo "Declaration saved to: $DECLARATION_FILE"
+SCRIPT
+chmod +x "$ROOT/declare-file-edits.sh"
+
+# Create the release script
+cat > "$ROOT/release-file-edits.sh" << 'SCRIPT'
+#!/bin/bash
+# Release files after editing
+
+AGENT="${1:-unknown}"
+SESSION="${2:-*}"
+
+COORD_DIR=".file-coordination"
+DECLARATION_FILE="$COORD_DIR/active-edits/${AGENT}-${SESSION}.json"
+
+if ls $DECLARATION_FILE 1> /dev/null 2>&1; then
+    mv $DECLARATION_FILE "$COORD_DIR/completed-edits/" 2>/dev/null || true
+    echo "✅ Released files for $AGENT-$SESSION"
+else
+    echo "⚠️  No active declaration found for $AGENT-$SESSION"
+fi
+SCRIPT
+chmod +x "$ROOT/release-file-edits.sh"
+
+# Add to .gitignore
+if ! grep -q "^.file-coordination" "$ROOT/.gitignore" 2>/dev/null; then
+    echo ".file-coordination" >> "$ROOT/.gitignore"
+    echo "[INFO] Added .file-coordination to .gitignore"
+fi
+
+# Add or update house rules with file coordination protocol
+update_houserules() {
+    local houserules_file="$1"
+    local is_new_file="$2"
+    
+    # Check if coordination rules already exist
+    if grep -q "File Coordination Protocol" "$houserules_file" 2>/dev/null; then
+        echo "[INFO] File coordination rules already present in house rules"
+        return
+    fi
+    
+    echo "[INFO] Setting up house rules with file coordination protocol"
+    
+    # Create backup if file exists
+    if [ -f "$houserules_file" ] && [ -s "$houserules_file" ]; then
+        cp "$houserules_file" "${houserules_file}.backup.$(date +%Y%m%d_%H%M%S)"
+        echo "[INFO] Created backup of existing house rules"
+    fi
+    
+    # If creating new file, add comprehensive template
+    if [ "$is_new_file" = "true" ] || [ ! -f "$houserules_file" ] || [ ! -s "$houserules_file" ]; then
+        cat > "$houserules_file" << 'FULL_TEMPLATE'
+# House Rules for AI Agents
+
+**IMPORTANT: All AI agents (Claude, Cline, Copilot, etc.) must read and follow these rules at the start of each session.**
+
+## Core Principles
+
+1. **Always preserve existing functionality** - Never break working code
+2. **Follow existing patterns** - Match the codebase style and conventions
+3. **Communicate clearly** - Document your changes and reasoning
+4. **Coordinate with others** - Follow the file coordination protocol below
+
+## Project Conventions
+
+### Code Style
+- Follow existing indentation and formatting patterns
+- Maintain consistent naming conventions used in the project
+- Keep functions small and focused
+- Write clear, descriptive variable and function names
+
+### Git Workflow
+- Write clear, descriptive commit messages
+- Follow conventional commit format when applicable (feat:, fix:, docs:, etc.)
+- Keep commits atomic and focused on a single change
+- Never commit sensitive information or credentials
+
+### Testing
+- Write tests for new functionality
+- Ensure existing tests pass before committing
+- Update tests when changing functionality
+
+### Documentation
+- Update README files when adding new features
+- Document complex logic with clear comments
+- Keep API documentation up to date
+- Update CHANGELOG for significant changes
+
+FULL_TEMPLATE
+    fi
+    
+    # Create temporary file with coordination rules at the top (after any main header)
+    TEMP_FILE=$(mktemp)
+    
+    # Check if file has a main header (starts with #)
+    if head -n1 "$houserules_file" | grep -q '^#'; then
+        # Keep the main header
+        head -n1 "$houserules_file" > "$TEMP_FILE"
+        echo "" >> "$TEMP_FILE"
+        
+        # Add coordination rules
+        cat >> "$TEMP_FILE" << 'COORDINATION_RULES'
+## 🚨 CRITICAL: File Coordination Protocol (MUST FOLLOW)
+
+**IMPORTANT: Always check the house rules at the beginning of each session!**
+
+To prevent conflicts with other agents editing the same files, you MUST follow this protocol:
+
+### Before Editing ANY Files:
+
+1. **DECLARE YOUR INTENT FIRST**
+   Create a file at `.file-coordination/active-edits/<your-name>-<session>.json` with:
+   ```json
+   {
+     "agent": "<your-name>",
+     "session": "<session-id>",
+     "files": ["list", "of", "files", "you", "will", "edit"],
+     "operation": "edit",
+     "reason": "Brief description of what you're doing",
+     "declaredAt": "<current-ISO-8601-timestamp>",
+     "estimatedDuration": 300
+   }
+   ```
+
+2. **CHECK FOR CONFLICTS**
+   - Read ALL files in `.file-coordination/active-edits/`
+   - If ANY other agent has declared the same files, you must:
+     - WAIT for them to finish, OR
+     - Choose different files to edit
+
+3. **ONLY EDIT DECLARED FILES**
+   - Never edit files you haven't declared
+   - Stay within your declared scope
+
+4. **RELEASE WHEN DONE**
+   - Delete your declaration file after completing edits
+   - Or move it to `.file-coordination/completed-edits/`
+
+### If You Detect a Conflict:
+- DO NOT proceed with edits
+- Report the conflict to the user
+- Wait or choose alternative files
+
+### Helper Scripts Available:
+- `./scripts/coordination/check-file-availability.sh <files>` - Check if files are available
+- `./scripts/coordination/declare-file-edits.sh <agent> <session> <files>` - Declare your intent
+- `./scripts/coordination/release-file-edits.sh <agent> <session>` - Release files after editing
+
+**This coordination prevents wasted work and merge conflicts!**
+
+---
+
+COORDINATION_RULES
+        
+        # Add the rest of the original content (skipping the first line)
+        tail -n +2 "$houserules_file" >> "$TEMP_FILE"
+    else
+        # No header, add coordination rules at the top
+        cat >> "$TEMP_FILE" << 'COORDINATION_RULES'
+## 🚨 CRITICAL: File Coordination Protocol (MUST FOLLOW)
+
+**IMPORTANT: Always check the house rules at the beginning of each session!**
+
+To prevent conflicts with other agents editing the same files, you MUST follow this protocol:
+
+### Before Editing ANY Files:
+
+1. **DECLARE YOUR INTENT FIRST**
+   Create a file at `.file-coordination/active-edits/<your-name>-<session>.json` with:
+   ```json
+   {
+     "agent": "<your-name>",
+     "session": "<session-id>",
+     "files": ["list", "of", "files", "you", "will", "edit"],
+     "operation": "edit",
+     "reason": "Brief description of what you're doing",
+     "declaredAt": "<current-ISO-8601-timestamp>",
+     "estimatedDuration": 300
+   }
+   ```
+
+2. **CHECK FOR CONFLICTS**
+   - Read ALL files in `.file-coordination/active-edits/`
+   - If ANY other agent has declared the same files, you must:
+     - WAIT for them to finish, OR
+     - Choose different files to edit
+
+3. **ONLY EDIT DECLARED FILES**
+   - Never edit files you haven't declared
+   - Stay within your declared scope
+
+4. **RELEASE WHEN DONE**
+   - Delete your declaration file after completing edits
+   - Or move it to `.file-coordination/completed-edits/`
+
+### If You Detect a Conflict:
+- DO NOT proceed with edits
+- Report the conflict to the user
+- Wait or choose alternative files
+
+### Helper Scripts Available:
+- `./scripts/coordination/check-file-availability.sh <files>` - Check if files are available
+- `./scripts/coordination/declare-file-edits.sh <agent> <session> <files>` - Declare your intent
+- `./scripts/coordination/release-file-edits.sh <agent> <session>` - Release files after editing
+
+**This coordination prevents wasted work and merge conflicts!**
+
+---
+
+COORDINATION_RULES
+        
+        # Add original content
+        cat "$houserules_file" >> "$TEMP_FILE"
+    fi
+    
+    # Replace original file
+    mv "$TEMP_FILE" "$houserules_file"
+    echo "[SUCCESS] Updated house rules with file coordination protocol"
+}
+
+# Update the house rules file
+# Pass whether this is a new file (HOUSERULES_FOUND is false for new files)
+if [ "$HOUSERULES_FOUND" = "false" ]; then
+    update_houserules "$HOUSERULES_PATH" "true"
+else
+    update_houserules "$HOUSERULES_PATH" "false"
+fi
+
+echo "[SUCCESS] File coordination system created!"
+echo ""
+echo "Usage:"
+echo "  1. Check availability:  ./scripts/coordination/check-file-availability.sh file1 file2"
+echo "  2. Declare edits:       ./scripts/coordination/declare-file-edits.sh agent-name session-id file1 file2"
+echo "  3. Release files:       ./scripts/coordination/release-file-edits.sh agent-name session-id"