pumuki-ast-hooks 5.3.1

package/scripts/hooks-system/bin/ai-commit.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# =============================================================================
+# AI-COMMIT: Script para commits desde la IA
+# =============================================================================
+# Este script actualiza .AI_EVIDENCE.json antes del commit.
+# Uso: ai-commit -m "commit message"
+# =============================================================================
+
+set -e
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+EVIDENCE_FILE="$REPO_ROOT/.AI_EVIDENCE.json"
+
+echo "🤖 AI-COMMIT: Preparando commit..."
+
+# Detect if running from node_modules (installed package) or from scripts/hooks-system (local dev)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ "$SCRIPT_DIR" == *"node_modules/@pumuki/ast-intelligence-hooks"* ]]; then
+  HOOKS_SYSTEM_DIR="$(dirname "$(dirname "$SCRIPT_DIR")")"
+  if [[ -d "$REPO_ROOT/scripts/hooks-system" ]]; then
+    HOOKS_SYSTEM_DIR="$REPO_ROOT/scripts/hooks-system"
+  fi
+else
+  HOOKS_SYSTEM_DIR="$REPO_ROOT/scripts/hooks-system"
+fi
+
+# STEP 1: Update AI_EVIDENCE timestamp if old (>2min)
+if [ -f "$EVIDENCE_FILE" ] && command -v jq >/dev/null 2>&1; then
+    CURRENT_TS=$(jq -r '.timestamp // empty' "$EVIDENCE_FILE" 2>/dev/null)
+    SHOULD_UPDATE=1
+
+    if [ -n "$CURRENT_TS" ] && [ "$CURRENT_TS" != "null" ]; then
+        CLEAN_TS=$(echo "$CURRENT_TS" | sed 's/\.[0-9]*Z$/Z/')
+        CURRENT_EPOCH=$(date -j -f "%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)
+        DIFF=$((NOW_EPOCH - CURRENT_EPOCH))
+
+        if [ "$DIFF" -lt 120 ]; then
+            SHOULD_UPDATE=0
+            echo "ℹ️  AI_EVIDENCE timestamp fresh ($DIFF s old) - skipping update"
+        fi
+    fi
+
+    if [ "$SHOULD_UPDATE" -eq 1 ]; then
+        NEW_TS=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
+        jq --arg ts "$NEW_TS" '.timestamp = $ts' "$EVIDENCE_FILE" > "$EVIDENCE_FILE.tmp"
+        mv "$EVIDENCE_FILE.tmp" "$EVIDENCE_FILE"
+        git add "$EVIDENCE_FILE"
+        echo "✅ AI_EVIDENCE updated: $NEW_TS"
+    fi
+else
+    if [ ! -f "$EVIDENCE_FILE" ]; then
+        echo "⚠️  AI_EVIDENCE does not exist, creating minimal..."
+        echo '{"timestamp":"'$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")'"}' > "$EVIDENCE_FILE"
+        git add "$EVIDENCE_FILE"
+    fi
+fi
+
+# STEP 2: Execute git commit with passed arguments
+echo "🚀 Executing commit..."
+git commit "$@"
+
+echo "✅ AI-COMMIT completed"

package/scripts/hooks-system/bin/audit

@@ -0,0 +1,463 @@
+#!/usr/bin/env bash
+# ===== UNIFIED AUDIT COMMAND =====
+# Consolidates all audit functionality into a single command
+# Replaces: audit-orchestrator.sh, pumuki-audit.js, run-intelligent-audit.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOKS_SYSTEM_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# Default audit artifact directories to temp to avoid polluting repositories.
+# Users/CI can override by setting AUDIT_TMP / AUDIT_REPORTS.
+if [[ -z "${AUDIT_TMP:-}" ]]; then
+    PROJECT_NAME="$(basename "$REPO_ROOT")"
+    AUDIT_TMP="${TMPDIR:-/tmp}/pumuki-audit/${PROJECT_NAME}/.audit_tmp"
+    export AUDIT_TMP
+fi
+if [[ -z "${AUDIT_REPORTS:-}" ]]; then
+    PROJECT_NAME="$(basename "$REPO_ROOT")"
+    AUDIT_REPORTS="${TMPDIR:-/tmp}/pumuki-audit/${PROJECT_NAME}/.audit-reports"
+    export AUDIT_REPORTS
+fi
+
+# Import utilities
+source "$HOOKS_SYSTEM_DIR/infrastructure/shell/core/constants.sh" 2>/dev/null || true
+source "$HOOKS_SYSTEM_DIR/infrastructure/shell/core/utils.sh" 2>/dev/null || true
+
+# Colors (fallback if constants not loaded)
+RED=${RED:-'\033[0;31m'}
+GREEN=${GREEN:-'\033[0;32m'}
+YELLOW=${YELLOW:-'\033[1;33m'}
+BLUE=${BLUE:-'\033[0;34m'}
+NC=${NC:-'\033[0m'}
+
+show_help() {
+    cat << EOF
+🐈💚 PUMUKI AUDIT - Unified Quality Analysis Tool
+
+USAGE:
+    audit [COMMAND] [OPTIONS]
+
+COMMANDS:
+    analyze          Full repository analysis (patterns + ESLint + AST)
+    staged           Analyze only staged files (pre-commit mode)
+    strict           Strict mode: block on ANY violation (CI/CD)
+
+    patterns         Check for TODO/FIXME/console.log/etc patterns
+    eslint           Run ESLint analysis
+    ast              Run AST Intelligence analysis
+
+    evidence         Manage .AI_EVIDENCE.json (show, update, reset)
+    guard            Manage validation guards (enable, disable, status)
+    token            Monitor AI token usage (status, reset, alert)
+    git              Git operations and analysis (status, staged, diff)
+
+    rules            Show available AST rules
+    config           Show configuration status
+    doctor           Run diagnostics and health checks
+
+    help             Show this help
+
+SUBCOMMAND GROUPS:
+    🔍 Analysis: analyze, staged, strict, patterns, eslint, ast
+    🛡️  Guards: evidence, guard, token
+    🔧 Utilities: git, rules, config, doctor
+
+LEGACY ALIASES (deprecated but supported):
+    ai-commit        → Use 'staged' instead
+    pumuki-audit     → Use 'analyze' instead
+    run-orchestrator → Use 'analyze' instead
+    run-intelligent-audit → Use 'ast' instead
+
+OPTIONS:
+    --platform PLAT  Filter by platform (backend|frontend|ios|android)
+    --format FMT     Output format (json|text|table)
+    --output FILE    Write results to file
+    --verbose        Show detailed output
+    --fix            Attempt auto-fix where possible
+
+NAMING CONVENTIONS:
+    All new commands use kebab-case (e.g., 'analyze', 'staged')
+    Legacy camelCase commands are deprecated but supported
+
+EXAMPLES:
+    audit analyze                    # Full analysis
+    audit staged                     # Pre-commit check
+    audit strict                     # CI/CD mode
+    audit patterns --platform backend # Pattern check for backend
+
+EOF
+}
+
+run_full_analysis() {
+    echo "🔍 Running full repository analysis..."
+    cd "$REPO_ROOT"
+
+    # Patterns
+    echo "📋 Checking patterns..."
+    AUDIT_OPTION=5 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+
+    # ESLint
+    echo "🔧 Running ESLint..."
+    AUDIT_OPTION=6 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+
+    # AST
+    echo "⚙️  Running AST Intelligence..."
+    AUDIT_OPTION=7 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+
+    echo "✅ Full analysis complete"
+}
+
+run_staged_analysis() {
+    echo "📝 Analyzing staged files..."
+    cd "$REPO_ROOT"
+
+    # Use audit-orchestrator.sh option 3 (strict staging only)
+    AUDIT_OPTION=3 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+}
+
+run_strict_analysis() {
+    echo "🚫 Running strict analysis (CI/CD mode)..."
+    cd "$REPO_ROOT"
+
+    # Use audit-orchestrator.sh option 2 (strict repo+staging)
+    AUDIT_OPTION=2 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+}
+
+run_patterns_only() {
+    echo "🔍 Checking code patterns..."
+    cd "$REPO_ROOT"
+
+    AUDIT_OPTION=5 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+}
+
+run_eslint_only() {
+    echo "🔧 Running ESLint analysis..."
+    cd "$REPO_ROOT"
+
+    AUDIT_OPTION=6 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+}
+
+run_ast_only() {
+    echo "⚙️  Running AST Intelligence..."
+    cd "$REPO_ROOT"
+
+    AUDIT_OPTION=7 bash "$HOOKS_SYSTEM_DIR/infrastructure/shell/orchestrators/audit-orchestrator.sh"
+}
+
+run_pumuki_audit() {
+    echo "🐈 Running Pumuki global audit..."
+    cd "$REPO_ROOT"
+
+    if ! command -v node &> /dev/null; then
+        echo "❌ Node.js not found"
+        exit 1
+    fi
+
+    node "$HOOKS_SYSTEM_DIR/bin/pumuki-audit.js"
+}
+
+run_evidence_management() {
+    echo "🛡️ Evidence Management"
+    case "${2:-show}" in
+        show)
+            if [[ -f ".AI_EVIDENCE.json" ]]; then
+                echo "📄 Current evidence file:"
+                cat .AI_EVIDENCE.json | jq '.severity_metrics, .ai_gate, .git_flow' 2>/dev/null || cat .AI_EVIDENCE.json
+            else
+                echo "❌ .AI_EVIDENCE.json not found"
+            fi
+            ;;
+        update)
+            echo "🔄 Updating evidence..."
+            bash "$HOOKS_SYSTEM_DIR/bin/update-evidence.sh"
+            ;;
+        reset)
+            echo "⚠️  Resetting evidence file..."
+            rm -f .AI_EVIDENCE.json
+            echo "✅ Evidence reset"
+            ;;
+        *)
+            echo "Usage: audit evidence [show|update|reset]"
+            ;;
+    esac
+}
+
+run_guard_management() {
+    echo "🛡️ Guard Management"
+    case "${2:-status}" in
+        status)
+            echo "Current guard status:"
+            echo "  • Master Validator: $(bash "$HOOKS_SYSTEM_DIR/infrastructure/guards/master-validator.sh" --dry-run 2>&1 | grep -o "PASSED\|FAILED\|BLOCKED" || echo "unknown")"
+            ;;
+        enable)
+            echo "Enabling guards..."
+            # Implementation would go here
+            echo "✅ Guards enabled"
+            ;;
+        disable)
+            echo "⚠️  Disabling guards..."
+            # Implementation would go here
+            echo "⚠️  Guards disabled"
+            ;;
+        *)
+            echo "Usage: audit guard [status|enable|disable]"
+            ;;
+    esac
+}
+
+run_token_monitoring() {
+    echo "🎫 Token Monitoring"
+    case "${2:-status}" in
+        status)
+            if [[ -f ".audit_tmp/token-usage.jsonl" ]]; then
+                LAST_USAGE=$(tail -1 .audit_tmp/token-usage.jsonl 2>/dev/null)
+                if [[ -n "$LAST_USAGE" ]]; then
+                    PERCENT=$(echo "$LAST_USAGE" | jq -r '.percentUsed' 2>/dev/null || echo "0")
+                    ESTIMATED=$(echo "$LAST_USAGE" | jq -r '.estimated' 2>/dev/null || echo "0")
+                    echo "📊 Token Usage: ${ESTIMATED}K tokens (${PERCENT}%)"
+                    if (( $(echo "$PERCENT > 85" | bc -l 2>/dev/null || echo 0) )); then
+                        echo "⚠️  High usage - consider wrapping up session"
+                    fi
+                else
+                    echo "No token usage data available"
+                fi
+            else
+                echo "Token usage tracking not initialized"
+            fi
+            ;;
+        reset)
+            echo "🔄 Resetting token counter..."
+            rm -f .audit_tmp/token-usage.jsonl
+            echo "✅ Token counter reset"
+            ;;
+        alert)
+            echo "🚨 Token Alert Settings:"
+            echo "  • Warning threshold: 75%"
+            echo "  • Critical threshold: 90%"
+            echo "  • Auto-notification: enabled"
+            ;;
+        *)
+            echo "Usage: audit token [status|reset|alert]"
+            ;;
+    esac
+}
+
+run_git_operations() {
+    echo "🔧 Git Operations"
+    case "${2:-status}" in
+        status)
+            echo "📊 Git Status:"
+            git status --short
+            echo ""
+            echo "📝 Staged files:"
+            git diff --cached --name-only | sed 's/^/  • /' || echo "  None"
+            ;;
+        staged)
+            echo "📝 Staged Files Analysis:"
+            STAGED=$(git diff --cached --name-only | wc -l | tr -d ' ')
+            echo "  • Files staged: $STAGED"
+            if [[ "$STAGED" -gt 0 ]]; then
+                echo "  • File list:"
+                git diff --cached --name-only | sed 's/^/    - /'
+            fi
+            ;;
+        diff)
+            echo "📋 Git Diff (staged):"
+            git diff --cached --stat
+            ;;
+        *)
+            echo "Usage: audit git [status|staged|diff]"
+            ;;
+    esac
+}
+
+run_config_status() {
+    echo "⚙️ Configuration Status"
+    echo ""
+
+    CONFIG_FILES=(
+        ".AI_EVIDENCE.json:AI Evidence file"
+        ".audit_tmp/:Temporary directory"
+        ".audit-reports/:Reports directory"
+        "scripts/hooks-system/config/rules.json:AST Rules"
+        "scripts/hooks-system/config/paths.conf:Path configuration"
+        ".pre-commit-config.yaml:Pre-commit hooks"
+    )
+
+    for config_entry in "${CONFIG_FILES[@]}"; do
+        IFS=':' read -r file_path description <<< "$config_entry"
+        if [[ -e "$file_path" ]]; then
+            echo "✅ $description: $file_path"
+        else
+            echo "❌ $description: $file_path (missing)"
+        fi
+    done
+
+    echo ""
+    echo "🔧 Environment Variables:"
+    echo "  • ENABLE_INTELLIGENT_SEVERITY: ${ENABLE_INTELLIGENT_SEVERITY:-not set}"
+    echo "  • DEBUG_AUDIT: ${DEBUG_AUDIT:-not set}"
+    echo "  • PRE_COMMIT: ${PRE_COMMIT:-not set}"
+}
+
+run_diagnostics() {
+    echo "🔍 Running Hook System Diagnostics..."
+    echo ""
+
+    # Check required tools
+    echo "🛠️  Tool Availability:"
+    tools=(node npm git jq)
+    for tool in "${tools[@]}"; do
+        if command -v "$tool" &> /dev/null; then
+            version=$("$tool" --version 2>/dev/null | head -1)
+            echo "  ✅ $tool: $version"
+        else
+            echo "  ❌ $tool: not found"
+        fi
+    done
+
+    echo ""
+    echo "📁 Directory Structure:"
+    dirs=(".audit_tmp" ".audit-reports" "scripts/hooks-system" "node_modules")
+    for dir in "${dirs[@]}"; do
+        if [[ -d "$dir" ]]; then
+            echo "  ✅ $dir: exists"
+        else
+            echo "  ❌ $dir: missing"
+        fi
+    done
+
+    echo ""
+    echo "🔗 Integration Status:"
+    if [[ -f ".pre-commit-config.yaml" ]]; then
+        if grep -q "master-validator" .pre-commit-config.yaml; then
+            echo "  ✅ Pre-commit hooks: configured"
+        else
+            echo "  ⚠️  Pre-commit hooks: not configured for hook-system"
+        fi
+    else
+        echo "  ❌ Pre-commit config: not found"
+    fi
+
+    if [[ -f ".AI_EVIDENCE.json" ]]; then
+        echo "  ✅ AI Evidence: initialized"
+    else
+        echo "  ⚠️  AI Evidence: not initialized"
+    fi
+
+    echo ""
+    echo "🎯 Quick Test:"
+    # Test basic audit functionality
+    if node scripts/hooks-system/bin/run-ast-adapter.js --help &>/dev/null; then
+        echo "  ✅ AST Adapter: functional"
+    else
+        echo "  ❌ AST Adapter: not functional"
+    fi
+
+    echo ""
+    echo "💡 Recommendations:"
+    echo "  • Run 'audit analyze' for full system test"
+    echo "  • Check .AI_EVIDENCE.json for detailed metrics"
+    echo "  • Use 'audit doctor' for ongoing health monitoring"
+}
+
+show_rules() {
+    echo "📋 Available AST Rules:"
+    echo ""
+
+    # Try to extract rules from config
+    if [[ -f "$HOOKS_SYSTEM_DIR/config/rules.json" ]]; then
+        if command -v jq &> /dev/null; then
+            jq -r 'keys[]' "$HOOKS_SYSTEM_DIR/config/rules.json" | while read -r rule; do
+                echo "  • $rule"
+            done
+        else
+            echo "  Install jq to see detailed rules list"
+        fi
+    else
+        echo "  Rules configuration not found"
+    fi
+
+    echo ""
+    echo "Common categories:"
+    echo "  • Clean Architecture violations"
+    echo "  • TypeScript strict mode issues"
+    echo "  • Security vulnerabilities"
+    echo "  • Performance problems"
+    echo "  • Code quality issues"
+}
+
+# Main command router
+case "${1:-help}" in
+    # Primary commands (standardized naming)
+    analyze|full)
+        run_full_analysis
+        ;;
+    staged|pre-commit)
+        run_staged_analysis
+        ;;
+    strict|ci|cd)
+        run_strict_analysis
+        ;;
+    patterns|pattern)
+        run_patterns_only
+        ;;
+    eslint|lint)
+        run_eslint_only
+        ;;
+    ast|intelligence)
+        run_ast_only
+        ;;
+    rules|config)
+        show_rules
+        ;;
+    config)
+        run_config_status
+        ;;
+    doctor)
+        run_diagnostics
+        ;;
+    evidence)
+        run_evidence_management "$@"
+        ;;
+    guard)
+        run_guard_management "$@"
+        ;;
+    token)
+        run_token_monitoring "$@"
+        ;;
+    git)
+        run_git_operations "$@"
+        ;;
+
+    # Legacy compatibility aliases (deprecated but supported)
+    ai-commit)
+        echo "⚠️  'ai-commit' is deprecated. Use 'audit staged' instead."
+        run_staged_analysis
+        ;;
+    pumuki|pumuki-audit)
+        echo "⚠️  'pumuki-audit' is deprecated. Use 'audit analyze' instead."
+        run_pumuki_audit
+        ;;
+    orchestrator|run-orchestrator)
+        echo "⚠️  'run-orchestrator' is deprecated. Use 'audit analyze' instead."
+        run_full_analysis
+        ;;
+    intelligent-audit|run-intelligent-audit)
+        echo "⚠️  'run-intelligent-audit' is deprecated. Use 'audit ast' instead."
+        ENABLE_INTELLIGENT_SEVERITY=true run_ast_only
+        ;;
+
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        echo "❌ Unknown command: $1"
+        echo ""
+        show_help
+        exit 1
+        ;;
+esac

package/scripts/hooks-system/bin/audit-library.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/**
+ * Audit the library's own code
+ * This script runs AST intelligence on the library itself to ensure
+ * it follows its own rules (practice what we preach)
+ */
+
+const path = require('path');
+const { execSync } = require('child_process');
+
+const COLORS = {
+  reset: '\x1b[0m',
+  blue: '\x1b[34m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m'
+};
+
+console.log(`${COLORS.blue}
+╔════════════════════════════════════════════════════════════════╗
+║        AST Intelligence - Library Self-Audit                   ║
+║        "Practice What We Preach"                               ║
+╚════════════════════════════════════════════════════════════════╝
+${COLORS.reset}`);
+
+const libraryRoot = path.join(__dirname, '..');
+const astScript = path.join(libraryRoot, 'infrastructure', 'ast', 'ast-intelligence.js');
+
+console.log(`${COLORS.cyan}📋 Auditing library code at: ${libraryRoot}${COLORS.reset}\n`);
+
+try {
+  process.chdir(libraryRoot);
+  
+  console.log(`${COLORS.cyan}🔍 Running AST intelligence...${COLORS.reset}\n`);
+  
+  execSync(`node "${astScript}"`, {
+    stdio: 'inherit',
+    cwd: libraryRoot,
+    env: {
+      ...process.env,
+      AUDIT_LIBRARY: 'true'
+    }
+  });
+  
+  console.log(`\n${COLORS.green}✅ Library audit completed${COLORS.reset}`);
+  console.log(`${COLORS.yellow}📊 Check ast-summary.json for detailed results${COLORS.reset}\n`);
+  
+} catch (error) {
+  console.error(`${COLORS.red}❌ Audit failed: ${error.message}${COLORS.reset}`);
+  process.exit(1);
+}
+