pumuki-ast-hooks 5.3.1

package/scripts/hooks-system/bin/cli.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+
+/**
+ * AST Intelligence Hooks - Main CLI
+ *
+ * Unified CLI to run audits from any project
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const command = process.argv[2];
+const args = process.argv.slice(3);
+
+const HOOKS_ROOT = path.join(__dirname, '..');
+
+function resolveRepoRoot() {
+  try {
+    const output = execSync('git rev-parse --show-toplevel', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+    const trimmed = output.trim();
+    if (trimmed.length > 0) {
+      return trimmed;
+    }
+  } catch (e) {
+    return process.cwd();
+  }
+  return process.cwd();
+}
+
+function buildHealthSnapshot() {
+  const repoRoot = resolveRepoRoot();
+  const result = {
+    ok: true,
+    repoRoot,
+    branch: null,
+    evidence: {
+      exists: false
+    },
+    astWatch: {
+      running: false
+    }
+  };
+
+  try {
+    const branchOutput = execSync('git branch --show-current', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+    const branch = branchOutput.trim();
+    if (branch) {
+      result.branch = branch;
+    }
+  } catch (e) {
+    result.branch = null;
+  }
+
+  const evidencePath = path.join(repoRoot, '.AI_EVIDENCE.json');
+  if (fs.existsSync(evidencePath)) {
+    result.evidence.exists = true;
+    try {
+      const raw = fs.readFileSync(evidencePath, 'utf8');
+      const json = JSON.parse(raw);
+      if (json && typeof json === 'object') {
+        if (json.timestamp) {
+          result.evidence.timestamp = json.timestamp;
+        }
+        if (json.session_id) {
+          result.evidence.sessionId = json.session_id;
+        }
+        if (json.action) {
+          result.evidence.action = json.action;
+        }
+      }
+    } catch (e) {
+      result.evidence.parseError = e.message;
+      result.ok = false;
+    }
+  } else {
+    result.ok = false;
+  }
+
+  const pidPath = path.join(repoRoot, '.ast_watch.pid');
+  const logPath = path.join(repoRoot, '.ast_watch.log');
+  if (fs.existsSync(pidPath)) {
+    try {
+      const pidRaw = fs.readFileSync(pidPath, 'utf8').trim();
+      const pid = parseInt(pidRaw, 10);
+      if (!Number.isNaN(pid)) {
+        result.astWatch.pid = pid;
+        try {
+          const psOutput = execSync(`ps -p ${pid} -o args=`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+          if (psOutput && psOutput.includes('watch-hooks.js')) {
+            result.astWatch.running = true;
+            result.astWatch.command = psOutput.trim();
+          } else {
+            result.ok = false;
+          }
+        } catch (e) {
+          result.ok = false;
+        }
+      } else {
+        result.astWatch.pid = null;
+        result.ok = false;
+      }
+    } catch (e) {
+      result.astWatch.error = e.message;
+      result.ok = false;
+    }
+  } else {
+    result.ok = false;
+  }
+
+  if (fs.existsSync(logPath)) {
+    result.astWatch.logPath = logPath;
+  }
+
+  return result;
+}
+
+const commands = {
+  audit: () => {
+    execSync(`bash ${path.join(HOOKS_ROOT, 'presentation/cli/audit.sh')}`, { stdio: 'inherit' });
+  },
+
+  ast: () => {
+    execSync(`node ${path.join(HOOKS_ROOT, 'infrastructure/ast/ast-intelligence.js')}`, { stdio: 'inherit' });
+  },
+
+  install: () => {
+    execSync(`node ${path.join(HOOKS_ROOT, 'bin/install.js')}`, { stdio: 'inherit' });
+  },
+
+  'verify-policy': () => {
+    execSync(`bash ${path.join(HOOKS_ROOT, 'bin/verify-no-verify.sh')}`, { stdio: 'inherit' });
+  },
+
+  'progress': () => {
+    execSync(`bash ${path.join(HOOKS_ROOT, 'bin/generate-progress-report.sh')}`, { stdio: 'inherit' });
+  },
+
+  health: () => {
+    const snapshot = buildHealthSnapshot();
+    console.log(JSON.stringify(snapshot));
+  },
+
+  watch: () => {
+    execSync(`node ${path.join(HOOKS_ROOT, 'bin/watch-hooks.js')}`, { stdio: 'inherit' });
+  },
+
+  'gitflow': () => {
+    const subcommand = args[0] || 'check';
+    execSync(`bash ${path.join(HOOKS_ROOT, 'infrastructure/shell/gitflow-enforcer.sh')} ${subcommand}`, { stdio: 'inherit' });
+  },
+
+  help: () => {
+    console.log(`
+AST Intelligence Hooks CLI v3.3.0
+
+Usage:
+  ast-hooks <command> [options]
+
+Commands:
+  audit            Run interactive audit menu
+  ast              Run AST Intelligence analysis only
+  install          Install hooks in new project
+  verify-policy    Verify --no-verify policy compliance
+  progress         Show violation progress report
+  health           Show hook-system health snapshot (JSON)
+  gitflow          Check Git Flow compliance (check|reset)
+  help             Show this help message
+  version          Show version
+
+Examples:
+  ast-hooks audit
+  ast-hooks ast
+  ast-hooks install
+  ast-hooks verify-policy
+  ast-hooks progress
+  ast-hooks health
+
+Environment Variables:
+  GIT_BYPASS_HOOK=1    Bypass hook validation (emergency)
+  DEBUG_AST=1          Enable AST debug logging
+  AUDIT_STRICT=1       Force strict mode
+
+Progress Tracking:
+  Use 'progress' to see violations delta since baseline
+  Reports saved in .audit-reports/ after each audit
+
+Policy Verification:
+  Use 'verify-policy' to check for unauthorized --no-verify usage
+  See docs/NO_VERIFY_POLICY.md for details
+
+Documentation:
+  See scripts/hooks-system/docs/guides/USAGE.md
+`);
+  },
+
+  version: () => {
+    const pkg = require('../package.json');
+    console.log(`v${pkg.version}`);
+  }
+};
+
+if (!command || !commands[command]) {
+  commands.help();
+  process.exit(command ? 1 : 0);
+}
+
+commands[command]();

package/scripts/hooks-system/bin/demo-recording.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+
+# Demo Recording Script for AST Intelligence Hooks
+# Requires: asciinema (brew install asciinema)
+# Convert to GIF: agg demo.cast demo.gif
+
+echo "🎬 AST Intelligence Hooks Demo"
+echo "=============================="
+echo ""
+
+# Step 1: Show pumuki-rules
+echo "📋 Step 1: List available rules"
+echo "$ pumuki-rules backend"
+sleep 1
+node bin/pumuki-rules.js backend 2>/dev/null | head -20
+sleep 2
+
+echo ""
+echo "📋 Step 2: Initialize project"
+echo "$ pumuki-init"
+sleep 1
+echo "✅ Detected platforms: backend, frontend"
+echo "✅ Created .pumuki.config.js"
+echo "✅ Installed git hooks"
+sleep 2
+
+echo ""
+echo "📋 Step 3: Run audit"
+echo "$ pumuki-audit"
+sleep 1
+echo "🔍 Analyzing 150 files..."
+echo "   ├── Backend: 45 files"
+echo "   ├── Frontend: 80 files"
+echo "   └── Common: 25 files"
+sleep 1
+echo ""
+echo "📊 Results:"
+echo "   🔴 Critical: 0"
+echo "   🟠 High: 12"
+echo "   🟡 Medium: 45"
+echo "   🟢 Low: 89"
+sleep 2
+
+echo ""
+echo "📋 Step 4: Pre-commit hook"
+echo "$ git commit -m 'feat: add new feature'"
+sleep 1
+echo "🔍 Running AST analysis on staged files..."
+echo "✅ 3 files analyzed"
+echo "✅ No blocking violations"
+echo "✅ Commit allowed"
+sleep 2
+
+echo ""
+echo "🎉 Demo complete!"
+echo ""
+echo "Install: npm install @pumuki/ast-intelligence-hooks"

package/scripts/hooks-system/bin/demo-violations

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# =============================================================================
+# DEMO: Violations API - Clickable Paths & Code Context
+# =============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+API="${SCRIPT_DIR}/violations-api.js"
+
+echo "╔═══════════════════════════════════════════════════════════════╗"
+echo "║  🖱️  DEMO: Rutas CLICKABLES - Violations API                 ║"
+echo "╚═══════════════════════════════════════════════════════════════╝"
+echo ""
+
+echo "🔍 COMANDO 1: List (rutas clickables)"
+echo "─────────────────────────────────────────────────────────────"
+echo "$ violations list common.quality.comments"
+echo ""
+node "$API" list common.quality.comments 2>/dev/null | head -10
+echo ""
+echo "💡 CMD+Click (Mac) o CTRL+Click en cualquier ruta para abrirla"
+echo ""
+echo ""
+
+echo "🔍 COMANDO 2: Show (con contexto de código)"
+echo "─────────────────────────────────────────────────────────────"
+echo "$ violations show common.quality.todo_fixme"
+echo ""
+node "$API" show common.quality.todo_fixme 2>/dev/null | head -40
+echo ""
+echo "💡 Las rutas también son clickables!"
+echo ""
+
+echo "════════════════════════════════════════════════════════════════"
+echo "✅ COMANDOS DISPONIBLES:"
+echo ""
+echo "  ./violations list <ruleId>      # Rutas clickables"
+echo "  ./violations show <ruleId>      # Con contexto código"
+echo "  ./violations summary            # Resumen general"
+echo "  ./violations top [N]            # Top N violaciones"
+echo ""
+echo "  npm run violations:list <rule>  # Desde hooks-system/"
+echo "  npm run violations:show <rule>  # Desde hooks-system/"
+echo ""
+echo "════════════════════════════════════════════════════════════════"

package/scripts/hooks-system/bin/fix-enforcer

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# =============================================================================
+# FIX: Eliminar enforcer de shell actual
+# =============================================================================
+
+echo "╔═══════════════════════════════════════════════════════════════╗"
+echo "║  🔧 FIX: Eliminar enforcer de shell actual                   ║"
+echo "╚═══════════════════════════════════════════════════════════════╝"
+echo ""
+
+echo "📋 Eliminando funciones de memoria..."
+unset -f cd 2>/dev/null && echo "  ✅ cd() eliminada" || echo "  ℹ️  cd no estaba definida"
+unset -f check_gitflow_silent 2>/dev/null && echo "  ✅ check_gitflow_silent() eliminada" || echo "  ℹ️  No estaba definida"
+
+echo ""
+echo "🔍 Buscando si el enforcer está en PROMPT o precmd..."
+env | grep -i gitflow
+echo $PROMPT | grep -i gitflow || echo "  ✅ No está en PROMPT"
+
+echo ""
+echo "════════════════════════════════════════════════════════════════"
+echo "✅ FUNCIONES ELIMINADAS"
+echo ""
+echo "💡 Si el enforcer SIGUE apareciendo:"
+echo "   - Está en PROMPT o precmd_functions"
+echo "   - Mejor abrir terminal NUEVA (fix en .zshrc ya aplicado)"
+echo "════════════════════════════════════════════════════════════════"

package/scripts/hooks-system/bin/fix-gitflow-enforcement.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# Fix Git Flow Enforcement
+# ═══════════════════════════════════════════════════════════════
+# Activa el git-wrapper.sh y limpia ramas obsoletas
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+GIT_WRAPPER_PATH="$REPO_ROOT/scripts/hooks-system/infrastructure/shell/gitflow/git-wrapper.sh"
+
+echo "🔧 Fixing Git Flow Enforcement..."
+echo ""
+
+# 1. Verificar que git-wrapper.sh existe
+if [[ ! -f "$GIT_WRAPPER_PATH" ]]; then
+  echo "❌ Error: git-wrapper.sh not found at $GIT_WRAPPER_PATH"
+  exit 1
+fi
+
+# 2. Hacer ejecutable
+chmod +x "$GIT_WRAPPER_PATH"
+
+# 3. Verificar que está en .zshrc
+if ! grep -q "GIT_WRAPPER_PATH" ~/.zshrc 2>/dev/null; then
+  echo "⚠️  Warning: GIT_WRAPPER_PATH not found in ~/.zshrc"
+  echo "   Adding it now..."
+  cat >> ~/.zshrc << 'EOF'
+
+# Git Flow Enforcement (portable - auto-detect project root)
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+export GIT_WRAPPER_PATH="$PROJECT_ROOT/scripts/hooks-system/infrastructure/shell/gitflow/git-wrapper.sh"
+if [ -f "$GIT_WRAPPER_PATH" ]; then
+    alias git='bash "$GIT_WRAPPER_PATH"'
+fi
+EOF
+  echo "✅ Added to ~/.zshrc"
+else
+  echo "✅ Already in ~/.zshrc"
+fi
+
+# 4. Activar alias en sesión actual
+echo ""
+echo "🔄 Activating alias in current session..."
+export GIT_WRAPPER_PATH="$GIT_WRAPPER_PATH"
+alias git='bash "$GIT_WRAPPER_PATH"'
+
+# 5. Forzar rehash en zsh
+hash -r git 2>/dev/null || true
+
+# 6. Verificar que funciona
+echo ""
+echo "🧪 Testing git-wrapper..."
+if bash "$GIT_WRAPPER_PATH" --version > /dev/null 2>&1; then
+  echo "✅ git-wrapper.sh is executable and working"
+else
+  echo "❌ Error: git-wrapper.sh failed to execute"
+  exit 1
+fi
+
+echo ""
+echo "✅ Git Flow Enforcement fixed!"
+echo ""
+echo "📝 Next steps:"
+echo "   1. Close and reopen your terminal (or run: source ~/.zshrc)"
+echo "   2. Run: git --version (should show wrapper is active)"
+echo "   3. Try: git commit (should enforce Git Flow rules)"
+echo ""

package/scripts/hooks-system/bin/generate-progress-report.sh

@@ -0,0 +1,129 @@
+#!/bin/bash
+
+# Generate Violation Progress Report
+# Compares current violations with baseline
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+REPORTS_DIR=".audit-reports"
+CURRENT_REPORT="${REPORTS_DIR}/latest_ast_summary.json"
+BASELINE_REPORT="${REPORTS_DIR}/baseline_ast_summary.json"
+
+if [[ ! -f "$CURRENT_REPORT" ]]; then
+  echo -e "${RED}❌ No current report found${NC}"
+  echo -e "   Run: bash scripts/hooks-system/presentation/cli/audit.sh"
+  exit 1
+fi
+
+if [[ ! -f "$BASELINE_REPORT" ]]; then
+  echo -e "${YELLOW}⚠️  No baseline found, using current as baseline${NC}"
+  cp "$CURRENT_REPORT" "$BASELINE_REPORT"
+fi
+
+echo ""
+echo -e "${BLUE}${BOLD}═══════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}${BOLD}   📊 VIOLATION PROGRESS REPORT${NC}"
+echo -e "${BLUE}${BOLD}═══════════════════════════════════════════════════════════${NC}"
+echo ""
+
+get_count() {
+  local file=$1
+  local key=$2
+  jq -r "$key // 0" "$file" 2>/dev/null || echo "0"
+}
+
+baseline_total=$(get_count "$BASELINE_REPORT" '.totals.total')
+baseline_crit=$(get_count "$BASELINE_REPORT" '.levels.CRITICAL')
+baseline_high=$(get_count "$BASELINE_REPORT" '.levels.HIGH')
+baseline_med=$(get_count "$BASELINE_REPORT" '.levels.MEDIUM')
+baseline_low=$(get_count "$BASELINE_REPORT" '.levels.LOW')
+
+current_total=$(get_count "$CURRENT_REPORT" '.totals.total')
+current_crit=$(get_count "$CURRENT_REPORT" '.levels.CRITICAL')
+current_high=$(get_count "$CURRENT_REPORT" '.levels.HIGH')
+current_med=$(get_count "$CURRENT_REPORT" '.levels.MEDIUM')
+current_low=$(get_count "$CURRENT_REPORT" '.levels.LOW')
+
+delta_total=$((current_total - baseline_total))
+delta_crit=$((current_crit - baseline_crit))
+delta_high=$((current_high - baseline_high))
+delta_med=$((current_med - baseline_med))
+delta_low=$((current_low - baseline_low))
+
+print_metric() {
+  local label=$1
+  local before=$2
+  local after=$3
+  local delta=$4
+
+  local color=$GREEN
+  local symbol="✅"
+  if [[ $delta -gt 0 ]]; then
+    color=$RED
+    symbol="⚠️"
+  elif [[ $delta -eq 0 ]]; then
+    color=$YELLOW
+    symbol="➖"
+  fi
+
+  printf "  %-30s %6s → %6s   %s%6s%s %s\n" \
+    "$label" "$before" "$after" "$color" "$delta" "$NC" "$symbol"
+}
+
+echo -e "${CYAN}${BOLD}Violations by Severity:${NC}"
+echo ""
+print_metric "🔴 CRITICAL" "$baseline_crit" "$current_crit" "$delta_crit"
+print_metric "🟠 HIGH" "$baseline_high" "$current_high" "$delta_high"
+print_metric "🟡 MEDIUM" "$baseline_med" "$current_med" "$delta_med"
+print_metric "🔵 LOW" "$baseline_low" "$current_low" "$delta_low"
+echo ""
+print_metric "📊 TOTAL VIOLATIONS" "$baseline_total" "$current_total" "$delta_total"
+
+echo ""
+echo -e "${CYAN}${BOLD}Code Health Score:${NC}"
+if [[ $baseline_total -gt 0 ]]; then
+  baseline_health=$((100 - (baseline_total * 100 / 15000)))
+  current_health=$((100 - (current_total * 100 / 15000)))
+  delta_health=$((current_health - baseline_health))
+
+  [[ $baseline_health -lt 0 ]] && baseline_health=0
+  [[ $current_health -lt 0 ]] && current_health=0
+
+  health_color=$GREEN
+  [[ $delta_health -lt 0 ]] && health_color=$RED
+  [[ $delta_health -eq 0 ]] && health_color=$YELLOW
+
+  printf "  %s%% → %s%%   %s%+d%%%s\n" \
+    "$baseline_health" "$current_health" "$health_color" "$delta_health" "$NC"
+fi
+
+echo ""
+echo -e "${CYAN}${BOLD}Top 10 Violation Types:${NC}"
+echo ""
+jq -r '.rules | to_entries | sort_by(-.value) | .[0:10] | .[] | "  \(.key): \(.value)"' "$CURRENT_REPORT"
+
+echo ""
+echo -e "${BLUE}${BOLD}═══════════════════════════════════════════════════════════${NC}"
+echo ""
+
+if [[ $delta_total -lt 0 ]]; then
+  echo -e "${GREEN}✅ Great job! Violations reduced by ${delta_total#-}${NC}"
+elif [[ $delta_total -gt 0 ]]; then
+  echo -e "${YELLOW}⚠️  Violations increased by $delta_total (temporary - new infrastructure)${NC}"
+else
+  echo -e "${YELLOW}➖ No net change in violations${NC}"
+fi
+
+echo ""
+echo -e "${CYAN}Commands:${NC}"
+echo -e "  Update baseline: ${BOLD}cp $CURRENT_REPORT $BASELINE_REPORT${NC}"
+echo -e "  View details:    ${BOLD}jq . $CURRENT_REPORT | less${NC}"
+echo ""

package/scripts/hooks-system/bin/git-leave-branch-check.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+set -euo pipefail
+
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
+if [[ -z "$REPO_ROOT" ]]; then
+  echo "Git repository root not found" >&2
+  exit 1
+fi
+
+cd "$REPO_ROOT"
+
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+current_branch=$(git branch --show-current 2>/dev/null || echo "")
+if [[ -z "$current_branch" ]]; then
+  exit 0
+fi
+
+# Only enforce on fix/ y feature/
+if [[ ! "$current_branch" =~ ^(fix|feature)/ ]]; then
+  exit 0
+fi
+
+# Ensure working tree clean
+if [[ -n "$(git status --porcelain)" ]]; then
+  echo -e "${RED}❌ No puedes abandonar ${current_branch} con cambios pendientes.${NC}"
+  echo -e "${CYAN}Limpia el árbol (commit, stash o descarta) antes de hacer checkout.${NC}"
+  exit 1
+fi
+
+# Evidence freshness (máximo 3 minutos)
+EVIDENCE_FILE=".AI_EVIDENCE.json"
+if [[ -f "$EVIDENCE_FILE" ]]; then
+  evidence_ts=$(jq -r '.timestamp' "$EVIDENCE_FILE" 2>/dev/null || echo "")
+  if [[ -n "$evidence_ts" && "$evidence_ts" != "null" ]]; then
+    clean_ts=$(echo "$evidence_ts" | sed 's/\.[0-9]*Z$/Z/')
+    evidence_epoch=$(date -jf "%Y-%m-%dT%H:%M:%SZ" "$clean_ts" +%s 2>/dev/null || date -d "$clean_ts" +%s 2>/dev/null || echo "0")
+    now_epoch=$(date +%s)
+    age=$((now_epoch - evidence_epoch))
+    if (( age > 180 )); then
+      echo -e "${YELLOW}⚠️  La evidencia tiene ${age}s (>3 min). Ejecuta ai-start/update-evidence antes de salir.${NC}"
+      exit 1
+    fi
+  fi
+fi
+
+# Ensure último commit incluye tests/specs si hay commits
+last_commit=$(git rev-parse HEAD 2>/dev/null || echo "")
+commit_count=$(git rev-list --count HEAD 2>/dev/null || echo "0")
+if [[ -n "$last_commit" ]] && (( commit_count >= 2 )); then
+  files_last_commit=$(git diff --name-only HEAD^ HEAD || echo "")
+  if [[ -n "$files_last_commit" ]]; then
+    if ! echo "$files_last_commit" | grep -qE "(\.spec\.tsx$|\.spec\.ts$|\.test\.tsx$|\.feature$)"; then
+      echo -e "${RED}❌ Último commit sin specs/tests detectados.${NC}"
+      echo -e "${CYAN}Aplica BDD→TDD: asegura que cada commit incluya el spec correspondiente antes de abandonar la rama.${NC}"
+      exit 1
+    fi
+  fi
+fi
+
+# Ensure build/test artefacts no staged (defensa adicional)
+if (( commit_count >= 2 )) && git diff --name-only HEAD^ HEAD | grep -qE "(\.next/|dist/|build/|coverage/)"; then
+  echo -e "${YELLOW}⚠️  El último commit contiene artefactos de build/test. Límpialos antes de salir.${NC}"
+  exit 1
+fi
+
+# A modo informativo, sugerir ejecutar tests antes de salir
+echo -e "${CYAN}🐈 Pumuki: recuerda ejecutar tests (npm run test) y build (npm run build) antes de abandonar ${current_branch}.${NC}"
+
+exit 0

package/scripts/hooks-system/bin/gitflow

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Git Flow Helper Script
+# =============================================================================
+# Usage: gitflow [check|status|workflow|reset]
+# =============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ENFORCER="${SCRIPT_DIR}/../infrastructure/shell/gitflow-enforcer.sh"
+
+if [[ ! -f "$ENFORCER" ]]; then
+  echo "❌ Error: gitflow-enforcer.sh not found"
+  echo "   Expected at: $ENFORCER"
+  exit 1
+fi
+
+bash "$ENFORCER" "${1:-check}"