pumuki-ast-hooks 5.3.1

package/scripts/hooks-system/infrastructure/watchdog/token-tracker.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# AI Token Tracker - Monitor Cursor token usage and warn on limits
+# ═══════════════════════════════════════════════════════════════
+# This script tracks token usage in the current AI session and
+# warns when approaching the 1M token limit.
+#
+# Triggered by:
+# - session-loader.sh (on startup)
+# - update-evidence.sh (after each evidence update)
+# ═══════════════════════════════════════════════════════════════
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Paths
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+TOKEN_STATUS_FILE="$REPO_ROOT/.AI_TOKEN_STATUS.txt"
+TOKEN_USAGE_LOG="$REPO_ROOT/.audit_tmp/token-usage.jsonl"
+SESSION_FILE="$REPO_ROOT/.AI_SESSION_START.md"
+
+# Constants
+MAX_TOKENS=1000000
+WARNING_THRESHOLD_85=850000
+WARNING_THRESHOLD_90=900000
+CRITICAL_THRESHOLD_95=950000
+
+#───────────────────────────────────────────────────────────────
+# Get current token count from Cursor (estimation)
+#───────────────────────────────────────────────────────────────
+get_token_estimate() {
+  # Heuristic: Count tokens based on:
+  # 1. Lines in .AI_SESSION_START.md (context loaded)
+  # 2. Recent files edited
+  # 3. Recent commits
+
+  local base_context=50000 # Baseline for rules, memories, etc.
+  local session_tokens=0
+  local file_tokens=0
+  local commit_tokens=0
+
+  # Session context tokens (1 line ≈ 10 tokens)
+  if [[ -f "$SESSION_FILE" ]]; then
+    local session_lines=$(wc -l < "$SESSION_FILE" 2>/dev/null || echo "0")
+    session_tokens=$((session_lines * 10))
+  fi
+
+  # Recent files edited (estimate from git log)
+  local files_changed=$(git diff --name-only HEAD~10..HEAD 2>/dev/null | wc -l || echo "0")
+  file_tokens=$((files_changed * 500)) # Assume 500 tokens per file changed
+
+  # Recent commits (1 commit ≈ 200 tokens)
+  local commits=$(git log --oneline -50 2>/dev/null | wc -l || echo "0")
+  commit_tokens=$((commits * 200))
+
+  # Total estimate
+  local total=$((base_context + session_tokens + file_tokens + commit_tokens))
+
+  echo "$total"
+}
+
+#───────────────────────────────────────────────────────────────
+# Calculate percentage used
+#───────────────────────────────────────────────────────────────
+calculate_percentage() {
+  local used=$1
+  local max=$2
+
+  # Use bc for floating point division
+  local percent=$(echo "scale=2; ($used * 100) / $max" | bc 2>/dev/null || echo "0")
+
+  echo "$percent"
+}
+
+#───────────────────────────────────────────────────────────────
+# Get status color and emoji
+#───────────────────────────────────────────────────────────────
+get_status_indicator() {
+  local used=$1
+  local percent=$2
+
+  if [[ $used -ge $CRITICAL_THRESHOLD_95 ]]; then
+    echo "${RED}🔴 CRITICAL${NC}"
+  elif [[ $used -ge $WARNING_THRESHOLD_90 ]]; then
+    echo "${RED}⚠️  DANGER${NC}"
+  elif [[ $used -ge $WARNING_THRESHOLD_85 ]]; then
+    echo "${YELLOW}⚠️  WARNING${NC}"
+  elif [[ $used -ge 500000 ]]; then
+    echo "${CYAN}📊 MODERATE${NC}"
+  else
+    echo "${GREEN}✅ HEALTHY${NC}"
+  fi
+}
+
+#───────────────────────────────────────────────────────────────
+# Get recommendation message
+#───────────────────────────────────────────────────────────────
+get_recommendation() {
+  local used=$1
+
+  if [[ $used -ge $CRITICAL_THRESHOLD_95 ]]; then
+    echo "🚨 URGENT: Start new session NOW to avoid context loss"
+  elif [[ $used -ge $WARNING_THRESHOLD_90 ]]; then
+    echo "⚠️  Consider wrapping up and starting new session soon"
+  elif [[ $used -ge $WARNING_THRESHOLD_85 ]]; then
+    echo "📝 Plan to conclude work in this session within 1-2 hours"
+  else
+    echo "Continue working normally"
+  fi
+}
+
+#───────────────────────────────────────────────────────────────
+# Update token status file
+#───────────────────────────────────────────────────────────────
+update_token_status() {
+  local tokens_used=$1
+  local percent=$2
+  local status=$3
+  local recommendation=$4
+
+  cat > "$TOKEN_STATUS_FILE" <<EOF
+═══════════════════════════════════════════════════════════
+🔋 AI TOKEN STATUS
+═══════════════════════════════════════════════════════════
+
+Status:     $status
+Used:       ${tokens_used} / ${MAX_TOKENS} tokens (${percent}%)
+Remaining:  $((MAX_TOKENS - tokens_used)) tokens
+
+Recommendation:
+  $recommendation
+
+Last updated: $(date '+%Y-%m-%d %H:%M:%S')
+═══════════════════════════════════════════════════════════
+EOF
+}
+
+#───────────────────────────────────────────────────────────────
+# Log token usage to JSONL
+#───────────────────────────────────────────────────────────────
+log_token_usage() {
+  local tokens_used=$1
+  local percent=$2
+
+  mkdir -p "$(dirname "$TOKEN_USAGE_LOG")"
+
+  local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  local session_id=$(git branch --show-current 2>/dev/null || echo "unknown")
+
+  # Append to JSONL
+  cat >> "$TOKEN_USAGE_LOG" <<EOF
+{"timestamp":"$timestamp","session":"$session_id","tokensUsed":$tokens_used,"maxTokens":$MAX_TOKENS,"percentUsed":$percent}
+EOF
+}
+
+#───────────────────────────────────────────────────────────────
+# Main execution
+#───────────────────────────────────────────────────────────────
+main() {
+  # Get current token estimate
+  local tokens_used=$(get_token_estimate)
+
+  # Calculate percentage
+  local percent=$(calculate_percentage "$tokens_used" "$MAX_TOKENS")
+
+  # Get status indicator
+  local status=$(get_status_indicator "$tokens_used" "$percent")
+
+  # Get recommendation
+  local recommendation=$(get_recommendation "$tokens_used")
+
+  # Update status file
+  update_token_status "$tokens_used" "$percent" "$status" "$recommendation"
+
+  # Log to JSONL
+  log_token_usage "$tokens_used" "$percent"
+
+  # Print to console
+  echo ""
+  echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
+  echo -e "${CYAN}🔋 Token Status:${NC} $status"
+  echo -e "${CYAN}   Used:${NC} ${tokens_used} / ${MAX_TOKENS} (${percent}%)"
+  echo -e "${CYAN}   Remaining:${NC} $((MAX_TOKENS - tokens_used)) tokens"
+  echo ""
+  echo -e "${YELLOW}💡 Recommendation:${NC}"
+  echo -e "   $recommendation"
+  echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}"
+  echo ""
+
+  # Return exit code based on status
+  if [[ $tokens_used -ge $CRITICAL_THRESHOLD_95 ]]; then
+    return 2 # Critical
+  elif [[ $tokens_used -ge $WARNING_THRESHOLD_85 ]]; then
+    return 1 # Warning
+  else
+    return 0 # OK
+  fi
+}
+
+# Execute
+main "$@"

package/scripts/hooks-system/presentation/cli/audit.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Entry point for the audit hook system
+# This script acts as the main CLI interface
+
+set -euo pipefail
+
+# Get the hooks-system directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Robustly find HOOKS_SYSTEM_DIR (works for both local development and node_modules installation)
+if [[ "$SCRIPT_DIR" == *"/node_modules/@pumuki/ast-intelligence-hooks/scripts/hooks-system/presentation/cli"* ]]; then
+    # Installed in node_modules (package includes scripts/hooks-system/...)
+    PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../../../../" && pwd)"
+    HOOKS_SYSTEM_DIR="$PACKAGE_ROOT/scripts/hooks-system"
+elif [[ "$SCRIPT_DIR" == *"/node_modules/@pumuki/ast-intelligence-hooks/presentation/cli"* ]]; then
+    # Installed in node_modules (legacy package layout)
+    HOOKS_SYSTEM_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+else
+    # Local development or other structure
+    HOOKS_SYSTEM_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+fi
+
+INFRASTRUCTURE_DIR="$HOOKS_SYSTEM_DIR/infrastructure"
+
+# If a mode was provided, set AUDIT_OPTION before sourcing the orchestrator
+MODE="${1:-}"
+if [[ -n "$MODE" ]]; then
+  export AUDIT_OPTION="$MODE"
+fi
+
+# Source the orchestrator
+source "$INFRASTRUCTURE_DIR/shell/orchestrators/audit-orchestrator.sh"

package/scripts/hooks-system/presentation/cli/autonomous-status.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+# Autonomous AST Intelligence - Status Dashboard
+
+set -euo pipefail
+
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+TELEMETRY_FILE="$REPO_ROOT/.audit_tmp/autonomous-decisions.jsonl"
+EVIDENCE_FILE="$REPO_ROOT/.AI_EVIDENCE.json"
+
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}   🤖 Autonomous AST Intelligence - Status${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo ""
+
+if [[ ! -f "$EVIDENCE_FILE" ]]; then
+  echo -e "${YELLOW}⚠️  No .AI_EVIDENCE.json found${NC}"
+  exit 1
+fi
+
+TIMESTAMP=$(jq -r '.timestamp' "$EVIDENCE_FILE" 2>/dev/null || echo "unknown")
+SESSION=$(jq -r '.session_id' "$EVIDENCE_FILE" 2>/dev/null || echo "unknown")
+
+CURRENT_TIME=$(date -u +"%s")
+EVIDENCE_TIME=$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$TIMESTAMP" +"%s" 2>/dev/null || echo "0")
+AGE=$((CURRENT_TIME - EVIDENCE_TIME))
+
+echo -e "${CYAN}📊 Current State:${NC}"
+echo -e "   Session: ${GREEN}$SESSION${NC}"
+echo -e "   Evidence Age: ${AGE}s"
+if [[ $AGE -lt 180 ]]; then
+  echo -e "   Status: ${GREEN}✅ Fresh${NC}"
+else
+  echo -e "   Status: ${YELLOW}⚠️  Stale${NC}"
+fi
+echo ""
+
+if [[ -f "$TELEMETRY_FILE" ]]; then
+  echo -e "${CYAN}📈 Autonomous Decisions (Last 7 days):${NC}"
+
+  CUTOFF=$((CURRENT_TIME - 604800))
+  TOTAL=$(awk -v cutoff="$CUTOFF" '
+    {
+      if (match($0, /"timestamp":([0-9]+)/, arr)) {
+        if (arr[1] >= cutoff * 1000) count++
+      }
+    }
+    END { print count+0 }
+  ' "$TELEMETRY_FILE")
+
+  AUTO_EXEC=$(grep -c '"decision":"auto-executed"' "$TELEMETRY_FILE" 2>/dev/null || echo "0")
+  ASKED=$(grep -c '"decision":"ask-user"' "$TELEMETRY_FILE" 2>/dev/null || echo "0")
+  IGNORED=$(grep -c '"decision":"ignored"' "$TELEMETRY_FILE" 2>/dev/null || echo "0")
+
+  echo -e "   Total Decisions: ${TOTAL}"
+  echo -e "   Auto-executed: ${GREEN}${AUTO_EXEC}${NC}"
+  echo -e "   Asked User: ${YELLOW}${ASKED}${NC}"
+  echo -e "   Ignored: ${IGNORED}"
+  echo ""
+
+  WITH_FEEDBACK=$(grep -c '"userCorrection":[^n]' "$TELEMETRY_FILE" 2>/dev/null || echo "0")
+  if [[ $WITH_FEEDBACK -gt 0 ]]; then
+    CORRECT=$(grep '"userCorrection":true' "$TELEMETRY_FILE" | wc -l | tr -d ' ')
+    ACCURACY=$(awk "BEGIN {printf \"%.0f\", ($CORRECT / $WITH_FEEDBACK) * 100}")
+
+    echo -e "${CYAN}🎯 Accuracy:${NC}"
+    echo -e "   Decisions with Feedback: ${WITH_FEEDBACK}"
+    echo -e "   Correct: ${GREEN}${CORRECT}${NC}"
+    echo -e "   Accuracy: ${GREEN}${ACCURACY}%${NC}"
+  else
+    echo -e "${YELLOW}⚠️  No user feedback yet${NC}"
+  fi
+else
+  echo -e "${YELLOW}⚠️  No telemetry data yet${NC}"
+  echo -e "   (Will be created after first autonomous decision)"
+fi
+
+echo ""
+echo -e "${CYAN}⚙️  Current Thresholds:${NC}"
+echo -e "   Auto-execute: ≥ 90%"
+echo -e "   Ask user: 70-89%"
+echo -e "   Ignore: < 70%"
+echo ""
+
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${GREEN}🐈💚 Pumuki Team® - Autonomous Project Intelligence${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"

package/scripts/hooks-system/presentation/cli/categorize-violations.sh

@@ -0,0 +1,179 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# Violations Categorizer (Automatic Report Generator)
+# ═══════════════════════════════════════════════════════════════
+# Generates actionable violation reports by priority
+# Called from: post-commit hook
+# ═══════════════════════════════════════════════════════════════
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Paths
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+AST_SUMMARY="$REPO_ROOT/.audit-reports/latest_ast_summary.json"
+OUTPUT_FILE="$REPO_ROOT/.violations-by-priority.md"
+
+# Check if AST summary exists
+if [[ ! -f "$AST_SUMMARY" ]]; then
+  echo -e "${YELLOW}⚠️  No AST summary found. Run audit first.${NC}"
+  exit 0
+fi
+
+# Extract totals
+CRITICAL=$(jq -r '.levels.CRITICAL // 0' "$AST_SUMMARY")
+HIGH=$(jq -r '.levels.HIGH // 0' "$AST_SUMMARY")
+MEDIUM=$(jq -r '.levels.MEDIUM // 0' "$AST_SUMMARY")
+LOW=$(jq -r '.levels.LOW // 0' "$AST_SUMMARY")
+TOTAL=$((CRITICAL + HIGH + MEDIUM + LOW))
+
+# Generate markdown report
+cat > "$OUTPUT_FILE" <<EOF
+# 🎯 Violations by Priority
+
+**Generated:** $(date +"%Y-%m-%d %H:%M:%S")
+**Commit:** $(git rev-parse --short HEAD 2>/dev/null || echo "N/A")
+**Branch:** $(git branch --show-current 2>/dev/null || echo "N/A")
+
+---
+
+## 📊 Summary
+
+| Severity | Count | Percentage |
+|----------|-------|------------|
+| 🔴 CRITICAL | $CRITICAL | $((CRITICAL * 100 / (TOTAL > 0 ? TOTAL : 1)))% |
+| 🟠 HIGH | $HIGH | $((HIGH * 100 / (TOTAL > 0 ? TOTAL : 1)))% |
+| 🟡 MEDIUM | $MEDIUM | $((MEDIUM * 100 / (TOTAL > 0 ? TOTAL : 1)))% |
+| 🔵 LOW | $LOW | $((LOW * 100 / (TOTAL > 0 ? TOTAL : 1)))% |
+| **TOTAL** | **$TOTAL** | **100%** |
+
+---
+
+## 🔴 CRITICAL Violations (Top 10)
+
+EOF
+
+# Extract top 10 critical violations
+jq -r '
+  [.findings[] | select(.level == "critical")] |
+  sort_by(-.count // -1) |
+  .[:10] |
+  .[] |
+  "### \(.ruleId // "unknown") (\(.count // 1) occurrences)\n\n**Platform:** \(.platform // "unknown")  \n**Severity:** \(.level // "critical")\n\n**Description:** \(.description // "No description")\n\n**Fix:** \(.fix // "Review and fix violations")\n\n---\n"
+' "$AST_SUMMARY" >> "$OUTPUT_FILE" 2>/dev/null || echo "No CRITICAL violations found." >> "$OUTPUT_FILE"
+
+cat >> "$OUTPUT_FILE" <<EOF
+
+## 🟠 HIGH Violations (Top 10)
+
+EOF
+
+# Extract top 10 high violations
+jq -r '
+  [.findings[] | select(.level == "high")] |
+  sort_by(-.count // -1) |
+  .[:10] |
+  .[] |
+  "### \(.ruleId // "unknown") (\(.count // 1) occurrences)\n\n**Platform:** \(.platform // "unknown")  \n**Severity:** \(.level // "high")\n\n**Description:** \(.description // "No description")\n\n**Fix:** \(.fix // "Review and fix violations")\n\n---\n"
+' "$AST_SUMMARY" >> "$OUTPUT_FILE" 2>/dev/null || echo "No HIGH violations found." >> "$OUTPUT_FILE"
+
+cat >> "$OUTPUT_FILE" <<EOF
+
+## 📈 Platform Distribution
+
+EOF
+
+# Platform stats
+jq -r '
+  .platforms |
+  to_entries |
+  sort_by(-.value) |
+  .[] |
+  "- **\(.key):** \(.value) violations"
+' "$AST_SUMMARY" >> "$OUTPUT_FILE"
+
+cat >> "$OUTPUT_FILE" <<EOF
+
+---
+
+## 🎯 Recommended Actions
+
+EOF
+
+# Generate action items based on violations
+if [[ $CRITICAL -gt 0 ]]; then
+  cat >> "$OUTPUT_FILE" <<EOF
+### 🔴 Priority 1: Fix CRITICAL issues ($CRITICAL)
+
+EOF
+  jq -r '
+    [.findings[] | select(.level == "critical")] |
+    sort_by(-.count // -1) |
+    .[:3] |
+    .[] |
+    "1. **\(.ruleId // "unknown")** (\(.count // 1) violations)\n   - \(.fix // "Review and fix")\n"
+  ' "$AST_SUMMARY" >> "$OUTPUT_FILE" 2>/dev/null || echo "No critical actions needed.\n" >> "$OUTPUT_FILE"
+fi
+
+if [[ $HIGH -gt 100 ]]; then
+  cat >> "$OUTPUT_FILE" <<EOF
+
+### 🟠 Priority 2: Address HIGH issues ($HIGH)
+
+Top 3 by volume:
+EOF
+  jq -r '
+    [.findings[] | select(.level == "high")] |
+    sort_by(-.count // -1) |
+    .[:3] |
+    .[] |
+    "1. **\(.ruleId // "unknown")** (\(.count // 1) violations)\n   - \(.fix // "Review and fix")\n"
+  ' "$AST_SUMMARY" >> "$OUTPUT_FILE" 2>/dev/null
+fi
+
+cat >> "$OUTPUT_FILE" <<EOF
+
+---
+
+## 📝 Next Steps
+
+1. Fix all CRITICAL violations first
+2. Address HIGH violations by volume (top 10)
+3. Run audit again: \`bash scripts/hooks-system/presentation/cli/audit.sh\`
+4. Commit fixes atomically with proper evidence
+
+**Report:** \`.violations-by-priority.md\`
+**Detailed JSON:** \`.audit-reports/latest_ast_summary.json\`
+EOF
+
+# Display summary in terminal
+echo ""
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${BLUE}📊 VIOLATIONS REPORT GENERATED${NC}"
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+echo -e "  🔴 CRITICAL: ${RED}$CRITICAL${NC}"
+echo -e "  🟠 HIGH:     ${YELLOW}$HIGH${NC}"
+echo -e "  🟡 MEDIUM:   $MEDIUM"
+echo -e "  🔵 LOW:      $LOW"
+echo -e "  ────────────────"
+echo -e "  📊 TOTAL:    $TOTAL"
+echo ""
+echo -e "${GREEN}✅ Report saved: .violations-by-priority.md${NC}"
+echo ""
+
+if [[ $CRITICAL -gt 0 ]]; then
+  echo -e "${RED}⚠️  ACTION REQUIRED: Fix $CRITICAL CRITICAL violations${NC}"
+elif [[ $HIGH -gt 100 ]]; then
+  echo -e "${YELLOW}⚠️  HIGH violations need attention: $HIGH found${NC}"
+fi
+
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""

package/scripts/hooks-system/presentation/cli/direct-audit-option2.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+# DIRECT AUDIT OPTION 2 - Strict REPO+STAGING (CI/CD)
+# Execute option 2 directly without interactive menu
+
+set -euo pipefail
+
+# Get the hooks-system directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOKS_SYSTEM_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+INFRASTRUCTURE_DIR="$HOOKS_SYSTEM_DIR/infrastructure"
+
+# Set environment for option 2: Strict REPO+STAGING
+export AUDIT_STRICT=1
+export BLOCK_ALL_SEVERITIES=1
+export BLOCK_ON_REPO_VIOLATIONS=1
+export NON_INTERACTIVE=1
+
+# Source the orchestrator but skip menu
+SKIP_MENU=1 source "$INFRASTRUCTURE_DIR/shell/orchestrators/audit-orchestrator.sh" || true
+
+# Execute option 2 directly: full_audit_strict_repo_and_staging
+full_audit_strict_repo_and_staging

package/scripts/hooks-system/presentation/cli/direct-audit.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# DIRECT AUDIT - Execute audit with specified option
+# Usage: bash direct-audit.sh [option]
+# Options: 1=Full audit, 2=Strict REPO+STAGING, 3=Strict STAGING only, etc.
+
+set -euo pipefail
+
+# Get the hooks-system directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOKS_SYSTEM_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+INFRASTRUCTURE_DIR="$HOOKS_SYSTEM_DIR/infrastructure"
+ORCHESTRATOR_DIR="$INFRASTRUCTURE_DIR/shell/orchestrators"
+
+# Get option from argument or default to 2
+OPTION="${1:-2}"
+
+# Validate option
+case "$OPTION" in
+  1|2|3|4|5|6|7|8|9)
+    # Valid option
+    ;;
+  *)
+    echo "Invalid option: $OPTION"
+    echo "Usage: bash direct-audit.sh [1-9]"
+    echo "  1=Full audit, 2=Strict REPO+STAGING, 3=Strict STAGING only, etc."
+    exit 1
+    ;;
+esac
+
+# Execute orchestrator with AUDIT_OPTION environment variable (non-interactive mode)
+export AUDIT_OPTION="$OPTION"
+bash "$ORCHESTRATOR_DIR/audit-orchestrator.sh"