pumuki-ast-hooks 5.3.1

package/scripts/hooks-system/bin/run-ast-adapter.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+/**
+ * AST ADAPTER FOR AST-HOOKS LIBRARY
+ *
+ * Purpose:
+ * Execute legacy AST analysis (scripts/hooks-system/infrastructure/ast/ast-intelligence.js)
+ * and transform its output (ast-summary.json) to the format expected by @pumuki/ast-hooks
+ * (AstFinding[]).
+ *
+ * IMPORTANT: Only returns findings from STAGED files to avoid blocking
+ * commits due to violations in files that are not being committed.
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+const { runASTIntelligence } = require('../infrastructure/ast/ast-intelligence');
+
+const SEVERITY_MAP = {
+    'CRITICAL': 'CRITICAL',
+    'HIGH': 'HIGH',
+    'MEDIUM': 'MEDIUM',
+    'LOW': 'LOW',
+    'error': 'HIGH',
+    'warning': 'MEDIUM',
+    'info': 'LOW'
+};
+
+function getStagedFiles() {
+    try {
+        const result = execSync('git diff --cached --name-only --diff-filter=ACM', { encoding: 'utf8' });
+        return result.trim().split('\n').filter(f => f);
+    } catch {
+        return [];
+    }
+}
+
+async function main() {
+    try {
+        const originalLog = console.log;
+        const originalError = console.error;
+        console.log = () => { };
+
+        await runASTIntelligence();
+
+        console.log = originalLog;
+        console.error = originalError;
+
+        const projectRoot = process.cwd();
+        const summaryPath = path.join(projectRoot, '.audit_tmp', 'ast-summary.json');
+
+        if (!fs.existsSync(summaryPath)) {
+            console.log(JSON.stringify([]));
+            return;
+        }
+
+        const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
+        const findings = summary.findings || [];
+
+        const stagedFiles = getStagedFiles();
+
+        const stagedFindings = findings.filter(f => {
+            if (!f.filePath) return false;
+            const relativePath = f.filePath.replace(projectRoot + '/', '').replace(projectRoot + path.sep, '');
+            return stagedFiles.some(sf => relativePath === sf || f.filePath.endsWith(sf));
+        });
+
+        const astFindings = stagedFindings.map(f => ({
+            severity: SEVERITY_MAP[f.severity] || 'MEDIUM',
+            filePath: f.filePath,
+            ruleId: f.ruleId,
+            message: (f.message || '').substring(0, 200)
+        }));
+
+        console.log(JSON.stringify(astFindings));
+
+    } catch (error) {
+        console.error('[AST Adapter Error]', error);
+        console.log(JSON.stringify([]));
+    }
+}
+
+if (require.main === module) {
+    main();
+}

package/scripts/hooks-system/bin/run-intelligent-audit.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# ===== INTELLIGENT AUDIT WRAPPER =====
+# Integrates Severity Intelligence with existing audit.sh flow
+# OPT-IN: Set ENABLE_INTELLIGENT_SEVERITY=true to activate
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Check if intelligent severity is enabled (OPT-IN)
+if [[ "${ENABLE_INTELLIGENT_SEVERITY:-false}" != "true" ]]; then
+    # NOT enabled - skip silently
+    exit 0
+fi
+
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${BLUE}  INTELLIGENT SEVERITY EVALUATION (BETA)${NC}"
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+# Check if ast-summary.json exists
+if [[ ! -f ".audit_tmp/ast-summary.json" ]]; then
+    echo -e "${YELLOW}⚠️  No ast-summary.json found - skipping intelligent evaluation${NC}"
+    exit 0
+fi
+
+# Run intelligent audit (Node.js)
+cd "$REPO_ROOT"
+
+if ! command -v node &> /dev/null; then
+    echo -e "${YELLOW}⚠️  Node.js not found - skipping intelligent evaluation${NC}"
+    exit 0
+fi
+
+# Run intelligent evaluator
+node scripts/hooks-system/infrastructure/orchestration/intelligent-audit.js
+
+# Capture exit code
+AUDIT_EXIT=$?
+
+# Display reports
+if [[ -f ".audit_tmp/intelligent-report.txt" ]]; then
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    cat .audit_tmp/intelligent-report.txt
+fi
+
+# Show token usage if critical
+if [[ -f ".audit_tmp/token-usage.jsonl" ]]; then
+    LAST_USAGE=$(tail -1 .audit_tmp/token-usage.jsonl)
+    PERCENT=$(echo "$LAST_USAGE" | jq -r '.percentUsed' 2>/dev/null || echo "0")
+
+    if (( $(echo "$PERCENT > 85" | bc -l 2>/dev/null || echo 0) )); then
+        echo ""
+        echo -e "${YELLOW}⚠️  Token usage: ${PERCENT}% - Consider wrapping up session${NC}"
+    fi
+fi
+
+# Exit with audit result
+exit $AUDIT_EXIT

package/scripts/hooks-system/bin/run-orchestrator.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+const ContextDetectionEngine = require('../application/services/ContextDetectionEngine');
+const AutonomousOrchestrator = require('../application/services/AutonomousOrchestrator');
+const PlatformDetectionService = require('../application/services/PlatformDetectionService');
+const HookSystemScheduler = require('../application/services/HookSystemScheduler');
+
+async function main() {
+  const contextEngine = new ContextDetectionEngine(process.cwd());
+  const platformDetector = new PlatformDetectionService();
+  const orchestrator = new AutonomousOrchestrator(contextEngine, platformDetector, null);
+  const scheduler = new HookSystemScheduler({ orchestrator, contextEngine });
+
+  scheduler.start();
+  console.log('Hook-System scheduler started (press Ctrl+C to stop)');
+
+  process.on('SIGINT', () => {
+    scheduler.stop();
+    console.log('\nScheduler stopped');
+    process.exit(0);
+  });
+}
+
+main().catch(error => {
+  console.error('Failed to start orchestrator:', error);
+  process.exit(1);
+});

package/scripts/hooks-system/bin/run-playbook.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+const PlaybookRunner = require('../application/services/PlaybookRunner');
+
+const runner = new PlaybookRunner();
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args.includes('--list')) {
+  console.log('Available playbooks:');
+  for (const playbook of runner.list()) {
+    console.log(`- ${playbook.id}: ${playbook.description}`);
+  }
+  process.exit(0);
+}
+
+const id = args[0];
+try {
+  runner.run(id);
+  console.log(`Playbook '${id}' executed correctly`);
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}

package/scripts/hooks-system/bin/session-loader.sh

@@ -0,0 +1,264 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# AI Session Loader (VS Code Startup)
+# ═══════════════════════════════════════════════════════════════
+# Automatically loads session context when VS Code opens workspace
+# Triggered by: .vscode/tasks.json (runOn: folderOpen)
+# ═══════════════════════════════════════════════════════════════
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+MAGENTA='\033[0;35m'
+NC='\033[0m'
+
+# Paths
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+SESSION_FILE="$REPO_ROOT/.AI_SESSION_START.md"
+TOKEN_STATUS="$REPO_ROOT/.AI_TOKEN_STATUS.txt"
+VIOLATIONS_REPORT="$REPO_ROOT/.violations-by-priority.md"
+
+# Clear screen
+clear
+
+# Banner
+echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║                                                          ║${NC}"
+echo -e "${BLUE}║            🤖 AI SESSION LOADER                          ║${NC}"
+echo -e "${BLUE}║            Workspace Opened - Loading Context...         ║${NC}"
+echo -e "${BLUE}║                                                          ║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Show current branch
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+echo -e "${CYAN}📍 Current Branch: ${MAGENTA}$CURRENT_BRANCH${NC}"
+echo ""
+
+# Show last 3 commits
+echo -e "${CYAN}📝 Recent Commits:${NC}"
+git log --oneline -3 2>/dev/null | sed 's/^/   /' || echo "   No commits yet"
+echo ""
+
+# Show session context
+if [[ -f "$SESSION_FILE" ]]; then
+  echo -e "${CYAN}📖 Session Context:${NC}"
+
+  # Prefer current session from .AI_EVIDENCE.json (auto-updated by ai-start)
+  LOCAL_EVIDENCE_FILE="$REPO_ROOT/.AI_EVIDENCE.json"
+  if [[ -f "$LOCAL_EVIDENCE_FILE" ]]; then
+    CURRENT_SESSION_ID=$(jq -r '.session_id // empty' "$LOCAL_EVIDENCE_FILE" 2>/dev/null || echo "")
+    CURRENT_ACTION=$(jq -r '.action // empty' "$LOCAL_EVIDENCE_FILE" 2>/dev/null || echo "")
+    if [[ -n "$CURRENT_SESSION_ID" ]]; then
+      if [[ -n "$CURRENT_ACTION" && "$CURRENT_ACTION" != "null" ]]; then
+        echo "   **Sesión actual (evidence):** $CURRENT_SESSION_ID - $CURRENT_ACTION"
+      else
+        echo "   **Sesión actual (evidence):** $CURRENT_SESSION_ID"
+      fi
+    fi
+  fi
+
+  # Also show static plan context from .AI_SESSION_START.md (without duplicating Sesión actual)
+  head -20 "$SESSION_FILE" | grep -E "Branch activo|Fase del plan|Progreso total|Violations.*restantes" | sed 's/^/   /' || true
+  echo ""
+fi
+
+# Show token status
+if [[ -f "$TOKEN_STATUS" ]]; then
+  echo -e "${CYAN}🔋 Token Status:${NC}"
+  grep -E "Status:|Used:|Remaining:" "$TOKEN_STATUS" | sed 's/^/   /' || true
+  echo ""
+fi
+
+# Show top violations
+if [[ -f "$VIOLATIONS_REPORT" ]]; then
+  echo -e "${CYAN}🎯 Top Violations:${NC}"
+  grep -A 4 "## 📊 Summary" "$VIOLATIONS_REPORT" | tail -5 | sed 's/^/   /' 2>/dev/null || echo "   No violations report"
+  echo ""
+fi
+
+# Check .AI_EVIDENCE.json freshness
+EVIDENCE_FILE="$REPO_ROOT/.AI_EVIDENCE.json"
+EVIDENCE_AGE=0
+if [[ -f "$EVIDENCE_FILE" ]]; then
+  EVIDENCE_TS=$(jq -r '.timestamp' "$EVIDENCE_FILE" 2>/dev/null || echo "")
+  if [[ -n "$EVIDENCE_TS" ]] && [[ "$EVIDENCE_TS" != "null" ]]; then
+    # Parse ISO 8601 timestamp with timezone offset (e.g., 2025-12-14T08:04:44+01:00)
+    # macOS date command doesn't handle +01:00 format well, so we convert to UTC first
+    if [[ "$EVIDENCE_TS" =~ ^([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2})([+-][0-9]{2}):([0-9]{2})$ ]]; then
+      # Format with timezone offset: convert to epoch using Python or node
+      EVIDENCE_EPOCH=$(python3 -c "from datetime import datetime; print(int(datetime.fromisoformat('$EVIDENCE_TS').timestamp()))" 2>/dev/null || \
+        node -e "console.log(Math.floor(new Date('$EVIDENCE_TS').getTime() / 1000))" 2>/dev/null || \
+        echo "0")
+    elif [[ "$EVIDENCE_TS" =~ ^([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2})Z?$ ]]; then
+      # Format without timezone (assume local time)
+      CLEAN_TS=$(echo "$EVIDENCE_TS" | sed 's/Z$//' | sed 's/\.[0-9]*$//')
+      EVIDENCE_EPOCH=$(date -j -f "%Y-%m-%dT%H:%M:%S" "$CLEAN_TS" +%s 2>/dev/null || echo "0")
+    else
+      EVIDENCE_EPOCH=0
+    fi
+    
+    NOW_EPOCH=$(date +%s)
+    EVIDENCE_AGE=$((NOW_EPOCH - EVIDENCE_EPOCH))
+    
+    # Sanity check: if age is negative or unreasonably large (> 1 year), assume parsing failed
+    if [[ $EVIDENCE_AGE -lt 0 ]] || [[ $EVIDENCE_AGE -gt 31536000 ]]; then
+      EVIDENCE_AGE=0
+      AGE_FORMATTED="unknown"
+    fi
+
+    # Format age in human-readable format
+    if [[ $EVIDENCE_AGE -lt 60 ]]; then
+      AGE_FORMATTED="${EVIDENCE_AGE}s"
+    elif [[ $EVIDENCE_AGE -lt 3600 ]]; then
+      AGE_MIN=$((EVIDENCE_AGE / 60))
+      AGE_SEC=$((EVIDENCE_AGE % 60))
+      AGE_FORMATTED="${AGE_MIN}m ${AGE_SEC}s"
+    elif [[ $EVIDENCE_AGE -lt 86400 ]]; then
+      AGE_HOUR=$((EVIDENCE_AGE / 3600))
+      AGE_MIN=$(( (EVIDENCE_AGE % 3600) / 60 ))
+      AGE_FORMATTED="${AGE_HOUR}h ${AGE_MIN}m"
+    else
+      AGE_DAYS=$((EVIDENCE_AGE / 86400))
+      AGE_HOUR=$(( (EVIDENCE_AGE % 86400) / 3600 ))
+      AGE_FORMATTED="${AGE_DAYS}d ${AGE_HOUR}h"
+    fi
+
+    if [[ $EVIDENCE_AGE -gt 180 ]]; then
+      echo -e "${YELLOW}⚠️  Evidence is stale (${AGE_FORMATTED} old, max 3min)${NC}"
+      echo -e "${CYAN}🔄 Auto-updating evidence...${NC}"
+      
+      # Auto-update evidence if stale
+      UPDATE_EVIDENCE_SCRIPT="$REPO_ROOT/node_modules/@pumuki/ast-intelligence-hooks/bin/update-evidence.sh"
+      if [[ ! -f "$UPDATE_EVIDENCE_SCRIPT" ]]; then
+        # Try scripts/hooks-system path as fallback
+        UPDATE_EVIDENCE_SCRIPT="$REPO_ROOT/scripts/hooks-system/bin/update-evidence.sh"
+      fi
+      
+      # Try node_modules path if script not found in scripts/
+      if [[ ! -x "$UPDATE_EVIDENCE_SCRIPT" ]]; then
+        UPDATE_EVIDENCE_SCRIPT="$REPO_ROOT/node_modules/@pumuki/ast-intelligence-hooks/bin/update-evidence.sh"
+      fi
+      
+      if [[ -x "$UPDATE_EVIDENCE_SCRIPT" ]]; then
+        # Detect platforms from project structure
+        PLATFORMS=""
+        [[ -d "$REPO_ROOT/apps/backend" ]] && PLATFORMS="${PLATFORMS}backend,"
+        [[ -d "$REPO_ROOT/apps/frontend" ]] && PLATFORMS="${PLATFORMS}frontend,"
+        [[ -d "$REPO_ROOT/apps/mobile/ios" ]] && PLATFORMS="${PLATFORMS}ios,"
+        [[ -d "$REPO_ROOT/apps/mobile/android" ]] && PLATFORMS="${PLATFORMS}android,"
+        PLATFORMS="${PLATFORMS%,}" # Remove trailing comma
+        
+        if [[ -n "$PLATFORMS" ]]; then
+          if "$UPDATE_EVIDENCE_SCRIPT" --auto --platforms "$PLATFORMS" >/dev/null 2>&1; then
+            echo -e "${GREEN}✅ Evidence updated${NC}"
+            # Send macOS notification
+            osascript -e "display notification \"Evidence auto-updated at $(date '+%Y-%m-%d %H:%M:%S') (was ${AGE_FORMATTED} old)\" with title \"🔄 Evidence Refreshed\" sound name \"Glass\"" 2>/dev/null || true
+          else
+            echo -e "${YELLOW}⚠️  Evidence update failed${NC}"
+          fi
+        else
+          echo -e "${YELLOW}⚠️  Could not auto-detect platforms, run manually:${NC}"
+          echo -e "${YELLOW}   $UPDATE_EVIDENCE_SCRIPT --auto --platforms <platforms>${NC}"
+        fi
+      else
+        echo -e "${YELLOW}⚠️  Update script not found, run manually:${NC}"
+        echo -e "${YELLOW}   ./scripts/hooks-system/bin/update-evidence.sh --auto --platforms <platforms>${NC}"
+      fi
+      echo ""
+    else
+      echo -e "${GREEN}✅ Evidence fresh (${AGE_FORMATTED} old)${NC}"
+      echo ""
+    fi
+  fi
+fi
+
+# Execute AI Gate Check automatically
+echo -e "${CYAN}🚦 Running AI Gate Check...${NC}"
+UPDATE_EVIDENCE_SCRIPT="$REPO_ROOT/scripts/hooks-system/bin/update-evidence.sh"
+if [[ ! -x "$UPDATE_EVIDENCE_SCRIPT" ]]; then
+  # Try node_modules path
+  UPDATE_EVIDENCE_SCRIPT="$REPO_ROOT/node_modules/@pumuki/ast-intelligence-hooks/bin/update-evidence.sh"
+fi
+if [[ -x "$UPDATE_EVIDENCE_SCRIPT" ]]; then
+  # Update evidence and run audit to get ai_gate (don't use --refresh-only, we need audit)
+  if "$UPDATE_EVIDENCE_SCRIPT" --auto >/dev/null 2>&1; then
+    # Read gate status from evidence
+    if [[ -f "$EVIDENCE_FILE" ]]; then
+      GATE_STATUS=$(jq -r '.ai_gate.status // "UNKNOWN"' "$EVIDENCE_FILE" 2>/dev/null || echo "UNKNOWN")
+      CRITICAL_COUNT=$(jq -r '[.ai_gate.violations[]? | select(.severity == "CRITICAL")] | length' "$EVIDENCE_FILE" 2>/dev/null || echo "0")
+      HIGH_COUNT=$(jq -r '[.ai_gate.violations[]? | select(.severity == "HIGH")] | length' "$EVIDENCE_FILE" 2>/dev/null || echo "0")
+      
+      if [[ "$GATE_STATUS" == "BLOCKED" ]]; then
+        TOTAL_BLOCKING=$((CRITICAL_COUNT + HIGH_COUNT))
+        if [[ $TOTAL_BLOCKING -gt 0 ]]; then
+          echo -e "${RED}   🚫 BLOCKED: ${TOTAL_BLOCKING} blocking violations (${CRITICAL_COUNT} CRITICAL, ${HIGH_COUNT} HIGH)${NC}"
+          osascript -e "display notification \"${TOTAL_BLOCKING} blocking violations detected\" with title \"🚫 AI Gate Blocked\" sound name \"Basso\"" 2>/dev/null || true
+        else
+          echo -e "${GREEN}   ✅ Gate passed${NC}"
+        fi
+      else
+        echo -e "${GREEN}   ✅ Gate passed${NC}"
+      fi
+    fi
+  else
+    echo -e "${YELLOW}   ⚠️  Gate check failed${NC}"
+  fi
+else
+  echo -e "${YELLOW}   ⚠️  Update script not found${NC}"
+fi
+echo ""
+
+# Start realtime guards (watch-hooks + token monitor)
+GUARDS_SCRIPT="$REPO_ROOT/scripts/hooks-system/bin/start-guards.sh"
+if [[ ! -x "$GUARDS_SCRIPT" ]]; then
+  GUARDS_SCRIPT="$REPO_ROOT/node_modules/@pumuki/ast-intelligence-hooks/bin/start-guards.sh"
+fi
+if [[ -x "$GUARDS_SCRIPT" ]]; then
+  echo -e "${CYAN}🛡️  Background guards:${NC}"
+  "$GUARDS_SCRIPT" start || true
+  echo ""
+fi
+
+# Show quick commands
+echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║  🚀 QUICK COMMANDS                                       ║${NC}"
+echo -e "${BLUE}╠══════════════════════════════════════════════════════════╣${NC}"
+echo -e "${BLUE}║  ${NC}ai-start <feature>     ${CYAN}Update evidence & start work${NC}     ${BLUE}║${NC}"
+echo -e "${BLUE}║  ${NC}./scripts/hooks-system/bin/update-evidence.sh --auto --platforms <platforms>${CYAN}Autonomous refresh${NC} ${BLUE}║${NC}"
+echo -e "${BLUE}║  ${NC}git status             ${CYAN}Check current changes${NC}           ${BLUE}║${NC}"
+echo -e "${BLUE}║  ${NC}git log -3             ${CYAN}View recent commits${NC}             ${BLUE}║${NC}"
+echo -e "${BLUE}║  ${NC}bash audit.sh          ${CYAN}Run full audit${NC}                  ${BLUE}║${NC}"
+echo -e "${BLUE}║  ${NC}cat .violations-*      ${CYAN}View violations report${NC}          ${BLUE}║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Auto-start watchdog (DISABLED - notifications were looping)
+# WATCHDOG_PID_FILE="$REPO_ROOT/.ai-watchdog.pid"
+# if [[ ! -f "$WATCHDOG_PID_FILE" ]]; then
+#   echo -e "${CYAN}🐕 Starting AI Watchdog...${NC}"
+#   bash "$REPO_ROOT/scripts/hooks-system/infrastructure/watchdog/ai-watchdog.sh" start 2>/dev/null || echo "   (fswatch not available)"
+#   echo ""
+# fi
+
+# Show readiness
+echo -e "${GREEN}✅ Session loaded - Ready to work!${NC}"
+echo ""
+
+# Reminder with exact command (only if evidence was stale)
+if [[ $EVIDENCE_AGE -gt 180 ]]; then
+  echo -e "${YELLOW}ℹ️  Evidence refreshed. You can start working!${NC}"
+  echo -e "   ${CYAN}To manually refresh: ./scripts/hooks-system/bin/update-evidence.sh --auto --platforms <platforms>${NC}"
+  echo -e "   ${CYAN}(alias: ai-start $CURRENT_BRANCH)${NC}"
+elif [[ $EVIDENCE_AGE -gt 0 ]]; then
+  echo -e "${GREEN}✅ Evidence is fresh - You can start working!${NC}"
+fi
+echo ""
+
+# Return control to user's default shell (zsh)
+exec "$SHELL"

package/scripts/hooks-system/bin/setup-eslint.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const COLORS = {
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  yellow: '\x1b[33m',
+  reset: '\x1b[0m'
+};
+
+class ESLintSetup {
+  constructor() {
+    this.targetRoot = process.cwd();
+    this.hooksSystemPath = path.join(this.targetRoot, 'scripts/hooks-system');
+  }
+
+  installDependencies(appPath, appName) {
+    console.log(`${COLORS.blue}  📦 Installing ESLint dependencies in ${appName}...${COLORS.reset}`);
+
+    const packages = [
+      'eslint',
+      '@typescript-eslint/parser',
+      '@typescript-eslint/eslint-plugin',
+      'eslint-plugin-sonarjs',
+      'eslint-plugin-security'
+    ];
+
+    try {
+      execSync(`cd ${appPath} && npm install --save-dev ${packages.join(' ')}`, {
+        stdio: 'inherit'
+      });
+      console.log(`${COLORS.green}  ✅ Dependencies installed${COLORS.reset}`);
+    } catch (error) {
+      console.log(`${COLORS.yellow}  ⚠️  Failed to install dependencies (may already exist)${COLORS.reset}`);
+    }
+  }
+
+  copyConfig(appPath, appName, templateName) {
+    console.log(`${COLORS.blue}  📝 Creating ESLint config for ${appName}...${COLORS.reset}`);
+
+    const templatePath = path.join(
+      this.hooksSystemPath,
+      'infrastructure/external-tools/eslint',
+      templateName
+    );
+
+    const targetPath = path.join(appPath, 'eslint.config.mjs');
+
+    if (!fs.existsSync(templatePath)) {
+      console.log(`${COLORS.yellow}  ⚠️  Template not found: ${templateName}${COLORS.reset}`);
+      return;
+    }
+
+    fs.copyFileSync(templatePath, targetPath);
+    console.log(`${COLORS.green}  ✅ Config created: ${path.relative(this.targetRoot, targetPath)}${COLORS.reset}`);
+  }
+
+  setupBackend() {
+    const backendPath = path.join(this.targetRoot, 'apps/backend');
+
+    if (!fs.existsSync(backendPath)) {
+      console.log(`${COLORS.yellow}⚠️  Backend not found, skipping...${COLORS.reset}`);
+      return;
+    }
+
+    console.log(`\n${COLORS.blue}🟢 Setting up Backend (NestJS)...${COLORS.reset}`);
+    this.installDependencies(backendPath, 'Backend');
+    this.copyConfig(backendPath, 'Backend', 'backend.config.template.mjs');
+  }
+
+  setupFrontend() {
+    const frontendPaths = [
+      { path: path.join(this.targetRoot, 'apps/admin-dashboard'), name: 'Admin Dashboard' },
+      { path: path.join(this.targetRoot, 'apps/web-app'), name: 'Web App' }
+    ];
+
+    frontendPaths.forEach(({ path: appPath, name }) => {
+      if (fs.existsSync(appPath)) {
+        console.log(`\n${COLORS.blue}🔵 ${name} already has ESLint configured${COLORS.reset}`);
+      }
+    });
+  }
+
+  run() {
+    console.log(`${COLORS.blue}
+╔════════════════════════════════════════════════════════════════╗
+║          ESLint Native Tools Integration Setup                ║
+╚════════════════════════════════════════════════════════════════╝
+${COLORS.reset}`);
+
+    this.setupBackend();
+    this.setupFrontend();
+
+    console.log(`\n${COLORS.green}
+╔════════════════════════════════════════════════════════════════╗
+║                    ✅ Setup Completed!                         ║
+╚════════════════════════════════════════════════════════════════╝
+${COLORS.reset}`);
+
+    console.log(`${COLORS.cyan}Next:${COLORS.reset} Run audit to see ESLint in action:`);
+    console.log(`  ${COLORS.yellow}bash scripts/hooks-system/presentation/cli/audit.sh${COLORS.reset}\n`);
+  }
+}
+
+// Execute
+const setup = new ESLintSetup();
+setup.run();