pumuki-ast-hooks 5.3.1

package/scripts/hooks-system/infrastructure/shell/validators/validate-clean-architecture.sh

@@ -0,0 +1,303 @@
+#!/usr/bin/env bash
+# =============================================================================
+# Clean Architecture Validator
+# =============================================================================
+# Purpose: Auto-validate file paths against Clean Architecture rules
+# Author: Carlos Merlos
+# =============================================================================
+
+set -euo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+VIOLATIONS=0
+
+# =============================================================================
+# Check Forbidden Directories (ALL platforms)
+# =============================================================================
+check_forbidden_directories() {
+  local file="$1"
+  local dir=$(dirname "$file")
+
+  # Forbidden directories (match at start, middle, or end of path)
+  if [[ "$dir" =~ (^|/)lib(/|$) ]]; then
+    echo -e "${RED}❌ VIOLATION: lib/ is FORBIDDEN${NC}"
+    echo -e "   File: $file"
+    echo -e "   Fix: Use ${GREEN}infrastructure/${NC} or ${GREEN}presentation/${NC}"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  if [[ "$dir" =~ (^|/)utils(/|$) ]]; then
+    echo -e "${RED}❌ VIOLATION: utils/ is FORBIDDEN${NC}"
+    echo -e "   File: $file"
+    echo -e "   Fix: Use ${GREEN}application/${NC} or ${GREEN}domain/${NC}"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  if [[ "$dir" =~ (^|/)helpers(/|$) ]]; then
+    echo -e "${RED}❌ VIOLATION: helpers/ is FORBIDDEN${NC}"
+    echo -e "   File: $file"
+    echo -e "   Fix: Use ${GREEN}application/use-cases/${NC}"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  if [[ "$dir" =~ (^|/)docs(/|$) ]]; then
+    echo -e "${RED}❌ VIOLATION: docs/ is FORBIDDEN in Clean Architecture${NC}"
+    echo -e "   File: $file"
+    echo -e "   Fix: Documentation should be:"
+    echo -e "     - README.md in root"
+    echo -e "     - README.md in each module directory"
+    echo -e "     - NOT in separate docs/ folder"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  return 0
+}
+
+# =============================================================================
+# Frontend Rules (React/TypeScript/Next.js)
+# =============================================================================
+validate_frontend_file() {
+  local file="$1"
+  local filename=$(basename "$file")
+  local dir=$(dirname "$file")
+
+  # Hook files (allow both presentation/hooks and app/**/hooks for Next.js App Router)
+  if [[ "$filename" =~ ^use[A-Z].*\.(ts|tsx)$ ]]; then
+    if [[ ! "$dir" =~ presentation/hooks$ ]] && [[ ! "$dir" =~ app/.*/hooks$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Hook file in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: Custom hooks → ${GREEN}presentation/hooks/${NC} or ${GREEN}app/**/hooks/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      echo -e "   Fix: Move to presentation/hooks/ or keep in app feature directory"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # Config files
+  if [[ "$filename" =~ \.config\.(ts|js)$ ]] || [[ "$filename" =~ ^(api|i18n|env)\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ infrastructure/config$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Config file in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: Configuration → ${GREEN}infrastructure/config/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      echo -e "   Fix: Move to infrastructure/config/"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # Store files (Zustand/Redux)
+  if [[ "$filename" =~ Store\.(ts|tsx)$ ]] || [[ "$filename" =~ \.store\.(ts|tsx)$ ]]; then
+    if [[ ! "$dir" =~ presentation/stores$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Store file in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: State stores → ${GREEN}presentation/stores/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      echo -e "   Fix: Move to presentation/stores/"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # Use Case files
+  if [[ "$filename" =~ UseCase\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ application/use-cases$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Use Case in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: Use Cases → ${GREEN}application/use-cases/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      echo -e "   Fix: Move to application/use-cases/"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # Repository implementations
+  if [[ "$filename" =~ Repository\.(ts|js)$ ]] && [[ ! "$filename" =~ ^I[A-Z] ]]; then
+    if [[ ! "$dir" =~ infrastructure/repositories$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Repository implementation in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: Repository impl → ${GREEN}infrastructure/repositories/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      echo -e "   Fix: Move to infrastructure/repositories/"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # Repository interfaces
+  if [[ "$filename" =~ ^I[A-Z].*Repository\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ domain/repositories$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Repository interface in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: Repository interface → ${GREEN}domain/repositories/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      echo -e "   Fix: Move to domain/repositories/"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # FORBIDDEN DIRECTORIES
+  if [[ "$dir" =~ /lib/ ]] && [[ ! "$dir" =~ /node_modules/ ]]; then
+    echo -e "${RED}❌ VIOLATION: File in forbidden 'lib/' directory${NC}"
+    echo -e "   File: $file"
+    echo -e "   Rule: ${RED}NEVER use lib/${NC}"
+    echo -e "   Use instead:"
+    echo -e "     - infrastructure/ (for services, config)"
+    echo -e "     - presentation/ (for hooks, components)"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  if [[ "$dir" =~ /utils/ ]] && [[ ! "$dir" =~ /node_modules/ ]]; then
+    echo -e "${RED}❌ VIOLATION: File in forbidden 'utils/' directory${NC}"
+    echo -e "   File: $file"
+    echo -e "   Rule: ${RED}NEVER use utils/${NC}"
+    echo -e "   Use instead:"
+    echo -e "     - application/ (for business logic)"
+    echo -e "     - domain/ (for domain logic)"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  if [[ "$dir" =~ /helpers/ ]] && [[ ! "$dir" =~ /node_modules/ ]]; then
+    echo -e "${RED}❌ VIOLATION: File in forbidden 'helpers/' directory${NC}"
+    echo -e "   File: $file"
+    echo -e "   Rule: ${RED}NEVER use helpers/${NC}"
+    echo -e "   Use: ${GREEN}application/use-cases/${NC}"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  return 0
+}
+
+# =============================================================================
+# Backend Rules (NestJS)
+# =============================================================================
+validate_backend_file() {
+  local file="$1"
+  local filename=$(basename "$file")
+  local dir=$(dirname "$file")
+
+  # Controller files
+  if [[ "$filename" =~ \.controller\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ presentation/controllers$ ]] && [[ ! "$dir" =~ src/[^/]+$ ]]; then
+      echo -e "${YELLOW}⚠️  WARNING: Controller not in presentation/controllers${NC}"
+      echo -e "   File: $file"
+      echo -e "   Recommended: ${GREEN}presentation/controllers/${NC}"
+      echo -e "   Current: $dir"
+    fi
+  fi
+
+  # Guard files
+  if [[ "$filename" =~ \.guard\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ presentation/guards$ ]] && [[ ! "$dir" =~ src/guards$ ]]; then
+      echo -e "${YELLOW}⚠️  WARNING: Guard not in presentation/guards${NC}"
+      echo -e "   File: $file"
+      echo -e "   Recommended: ${GREEN}presentation/guards/${NC}"
+    fi
+  fi
+
+  # Use Case files
+  if [[ "$filename" =~ UseCase\.(ts|js)$ ]] || [[ "$filename" =~ \.use-case\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ application/use-cases$ ]]; then
+      echo -e "${RED}❌ VIOLATION: Use Case in wrong location${NC}"
+      echo -e "   File: $file"
+      echo -e "   Rule: Use Cases → ${GREEN}application/use-cases/${NC}"
+      echo -e "   Found in: ${RED}$dir${NC}"
+      ((VIOLATIONS++))
+      return 1
+    fi
+  fi
+
+  # DTO files
+  if [[ "$filename" =~ \.dto\.(ts|js)$ ]]; then
+    if [[ ! "$dir" =~ application/dtos$ ]] && [[ ! "$dir" =~ src/[^/]+/dto$ ]]; then
+      echo -e "${YELLOW}⚠️  WARNING: DTO not in application/dtos${NC}"
+      echo -e "   File: $file"
+      echo -e "   Recommended: ${GREEN}application/dtos/${NC}"
+    fi
+  fi
+
+  # FORBIDDEN DIRECTORIES (same as frontend)
+  if [[ "$dir" =~ /lib/ ]] && [[ ! "$dir" =~ /node_modules/ ]]; then
+    echo -e "${RED}❌ VIOLATION: File in forbidden 'lib/' directory${NC}"
+    echo -e "   File: $file"
+    echo -e "   Rule: ${RED}NEVER use lib/${NC} → Use ${GREEN}infrastructure/${NC}"
+    ((VIOLATIONS++))
+    return 1
+  fi
+
+  return 0
+}
+
+# =============================================================================
+# Main Validator
+# =============================================================================
+
+validate_staged_files() {
+  echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+  echo -e "${BLUE}🏗️  Clean Architecture Validator${NC}"
+  echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+  echo ""
+
+  local staged_files=$(git diff --cached --name-only --diff-filter=ACM)
+
+  if [[ -z "$staged_files" ]]; then
+    echo -e "${GREEN}✅ No files to validate${NC}"
+    return 0
+  fi
+
+  local file_count=$(echo "$staged_files" | wc -l | tr -d ' ')
+  echo "📁 Validating $file_count staged file(s)..."
+  echo ""
+
+  while IFS= read -r file; do
+    # Skip non-source files
+    [[ "$file" =~ \.(md|json|yml|yaml|txt|lock)$ ]] && continue
+    [[ "$file" =~ node_modules/ ]] && continue
+    [[ "$file" =~ \.git/ ]] && continue
+
+    # First: Check forbidden directories (applies to ALL platforms)
+    check_forbidden_directories "$file" || continue
+
+    # Then: Detect platform and validate specific rules
+    if [[ "$file" =~ \.(ts|tsx|jsx)$ ]] && [[ "$file" =~ apps/(admin-dashboard|web)/ ]]; then
+      validate_frontend_file "$file"
+    elif [[ "$file" =~ \.(ts|js)$ ]] && [[ "$file" =~ apps/backend/ ]]; then
+      validate_backend_file "$file"
+    fi
+  done <<< "$staged_files"
+
+  echo ""
+  if [[ $VIOLATIONS -gt 0 ]]; then
+    echo -e "${RED}═══════════════════════════════════════════════════════════════${NC}"
+    echo -e "${RED}❌ CLEAN ARCHITECTURE VIOLATED: $VIOLATIONS violation(s)${NC}"
+    echo -e "${RED}═══════════════════════════════════════════════════════════════${NC}"
+    echo ""
+    echo -e "${YELLOW}Fix violations or move files to correct directories.${NC}"
+    echo ""
+    echo -e "${BLUE}Need help? Run:${NC}"
+    echo -e "  ${GREEN}cat .cursorrules${NC}  # See structure rules"
+    echo ""
+    return 1
+  else
+    echo -e "${GREEN}✅ Clean Architecture: All files in correct locations${NC}"
+    return 0
+  fi
+}
+
+# Run validation
+validate_staged_files

package/scripts/hooks-system/infrastructure/shell/validators/validate-conventional-commit.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+MSG_FILE="${1:-}"
+
+if [[ -z "$MSG_FILE" ]] || [[ ! -f "$MSG_FILE" ]]; then
+    exit 0
+fi
+
+MSG=$(cat "$MSG_FILE")
+
+# =============================================================================
+# 1. VALIDATE CONVENTIONAL COMMITS FORMAT
+# =============================================================================
+CONVENTIONAL_HOOK="${HOME}/.cache/pre-commit/repokqr3d6ev/py_env-python3/bin/conventional-pre-commit"
+
+if [[ ! -f "$CONVENTIONAL_HOOK" ]]; then
+    CONVENTIONAL_HOOK=$(find "${HOME}/.cache/pre-commit" -name "conventional-pre-commit" -type f 2>/dev/null | head -1)
+fi
+
+if [[ -n "$CONVENTIONAL_HOOK" ]] && [[ -f "$CONVENTIONAL_HOOK" ]]; then
+    "$CONVENTIONAL_HOOK" -- "$MSG_FILE" || exit 1
+fi
+
+# =============================================================================
+# 2. VALIDATE ENGLISH LANGUAGE (Intelligent Detection)
+# =============================================================================
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LANG_DETECTOR="${SCRIPT_DIR}/../../validators/detect-commit-language.js"
+
+if [[ -f "$LANG_DETECTOR" ]] && command -v node >/dev/null 2>&1; then
+    node "$LANG_DETECTOR" "$MSG_FILE"
+    exit_code=$?
+    if [[ $exit_code -ne 0 ]]; then
+        exit $exit_code
+    fi
+else
+    echo "⚠️  Language detector not available, skipping language validation"
+fi
+
+exit 0

package/scripts/hooks-system/infrastructure/storage/file-operations.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# File Operations - Infrastructure Layer
+# File listing and counting utilities
+
+list_source_files() {
+  local dir="$1"
+  find "$dir" -type f \
+    \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.mjs" -o -name "*.cjs" \) \
+    -not -path "*/node_modules/*" \
+    -not -path "*/dist/*" \
+    -not -path "*/.next/*" \
+    -not -path "*/.turbo/*" \
+    -not -path "*/.vercel/*" \
+    -not -path "*/coverage/*" \
+    -not -path "*/build/*" \
+    -not -path "*/out/*" \
+    -not -path "*/.cache/*" \
+    -not -name "*.d.ts" \
+    -not -name "*.map" \
+    -not -name "*.min.*" \
+    -not -name "*.snap"
+}
+
+count_files() {
+  local list_file="$1"
+  if [[ -f "$list_file" ]]; then
+    wc -l < "$list_file" | tr -d ' '
+  else
+    echo 0
+  fi
+}

package/scripts/hooks-system/infrastructure/telemetry/TelemetryService.js

@@ -0,0 +1,165 @@
+const fs = require('fs');
+const path = require('path');
+
+class TelemetryService {
+    constructor(repoRoot) {
+        this.repoRoot = repoRoot || process.cwd();
+        this.logFile = path.join(this.repoRoot, '.audit_tmp/autonomous-decisions.jsonl');
+        this.thresholds = {
+            autoExecute: 90,
+            ask: 70
+        };
+        this.ensureLogDirectory();
+    }
+
+    ensureLogDirectory() {
+        const dir = path.dirname(this.logFile);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+
+    logDecision(context, decision, userFeedback = null) {
+        const entry = {
+            timestamp: Date.now(),
+            isoTimestamp: new Date().toISOString(),
+            platforms: context.platforms,
+            confidence: context.confidence,
+            decision: decision,
+            userCorrection: userFeedback,
+            accuracy: this.calculateAccuracy(),
+            contextHash: this.hashContext(context)
+        };
+
+        try {
+            fs.appendFileSync(this.logFile, JSON.stringify(entry) + '\n', 'utf-8');
+        } catch (error) {
+            console.error('[TelemetryService] Failed to log decision:', error.message);
+        }
+    }
+
+    hashContext(context) {
+        const str = JSON.stringify({
+            platforms: context.platforms,
+            branch: context.branchName,
+            filesCount: context.stagedFiles?.length || 0
+        });
+        return str.split('').reduce((hash, char) => {
+            return ((hash << 5) - hash) + char.charCodeAt(0);
+        }, 0).toString(36);
+    }
+
+    analyzeDecisions(days = 7) {
+        try {
+            if (!fs.existsSync(this.logFile)) {
+                return {
+                    totalDecisions: 0,
+                    accuracy: 100,
+                    falsePositives: 0,
+                    falseNegatives: 0
+                };
+            }
+
+            const cutoff = Date.now() - (days * 24 * 60 * 60 * 1000);
+            const lines = fs.readFileSync(this.logFile, 'utf-8').split('\n').filter(Boolean);
+
+            const recentDecisions = lines
+                .map(line => {
+                    try {
+                        return JSON.parse(line);
+                    } catch (e) {
+                        return null;
+                    }
+                })
+                .filter(entry => entry && entry.timestamp >= cutoff);
+
+            if (recentDecisions.length === 0) {
+                return {
+                    totalDecisions: 0,
+                    accuracy: 100,
+                    falsePositives: 0,
+                    falseNegatives: 0
+                };
+            }
+
+            const decisionsWithFeedback = recentDecisions.filter(d => d.userCorrection !== null);
+
+            if (decisionsWithFeedback.length === 0) {
+                return {
+                    totalDecisions: recentDecisions.length,
+                    accuracy: null,
+                    falsePositives: 0,
+                    falseNegatives: 0,
+                    note: 'No user feedback yet'
+                };
+            }
+
+            const correct = decisionsWithFeedback.filter(d => d.userCorrection === true).length;
+            const falsePositives = decisionsWithFeedback.filter(d =>
+                d.decision === 'auto-executed' && d.userCorrection === false
+            ).length;
+            const falseNegatives = decisionsWithFeedback.filter(d =>
+                d.decision === 'ignored' && d.userCorrection === false
+            ).length;
+
+            const accuracy = (correct / decisionsWithFeedback.length) * 100;
+
+            return {
+                totalDecisions: recentDecisions.length,
+                decisionsWithFeedback: decisionsWithFeedback.length,
+                accuracy: Math.round(accuracy),
+                falsePositives,
+                falseNegatives,
+                falsePositiveRate: (falsePositives / decisionsWithFeedback.length) * 100
+            };
+
+        } catch (error) {
+            console.error('[TelemetryService] Error analyzing decisions:', error.message);
+            return {
+                totalDecisions: 0,
+                accuracy: null,
+                error: error.message
+            };
+        }
+    }
+
+    calculateAccuracy() {
+        const stats = this.analyzeDecisions(7);
+        return stats.accuracy || null;
+    }
+
+    async adjustThresholds() {
+        const stats = this.analyzeDecisions(30);
+
+        if (!stats.accuracy || stats.decisionsWithFeedback < 10) {
+            console.log('[TelemetryService] Insufficient data to adjust thresholds');
+            return { adjusted: false, reason: 'insufficient-data', stats };
+        }
+
+        if (stats.falsePositiveRate > 15) {
+            this.thresholds.autoExecute = Math.min(95, this.thresholds.autoExecute + 5);
+            console.log(`[TelemetryService] Raising autoExecute threshold to ${this.thresholds.autoExecute}% (too many false positives)`);
+            return { adjusted: true, newThreshold: this.thresholds.autoExecute, stats };
+        }
+
+        if (stats.accuracy >= 95 && this.thresholds.autoExecute > 85) {
+            this.thresholds.autoExecute = Math.max(85, this.thresholds.autoExecute - 2);
+            console.log(`[TelemetryService] Lowering autoExecute threshold to ${this.thresholds.autoExecute}% (high accuracy)`);
+            return { adjusted: true, newThreshold: this.thresholds.autoExecute, stats };
+        }
+
+        return { adjusted: false, reason: 'thresholds-ok', stats };
+    }
+
+    getStats(days = 7) {
+        const analysis = this.analyzeDecisions(days);
+
+        return {
+            period: `${days} days`,
+            ...analysis,
+            currentThresholds: { ...this.thresholds }
+        };
+    }
+}
+
+module.exports = TelemetryService;

package/scripts/hooks-system/infrastructure/telemetry/__tests__/telemetry.spec.js

@@ -0,0 +1,15 @@
+describe('telemetry', () => {
+  describe('TelemetryService', () => {
+    it('should export class', () => {
+      const TelemetryService = require('../TelemetryService');
+      expect(TelemetryService).toBeDefined();
+    });
+  });
+
+  describe('metrics-logger', () => {
+    it('should export module', () => {
+      const mod = require('../metrics-logger');
+      expect(mod).toBeDefined();
+    });
+  });
+});

package/scripts/hooks-system/infrastructure/telemetry/metrics-logger.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+/**
+ * Simple metrics logger stub for the hook-system platform.
+ * Usage (programmatic):
+ *   const { recordMetric } = require('./metrics-logger');
+ *   recordMetric({ hook: 'validate-ai-evidence', status: 'success', durationMs: 123 });
+ *
+ * Usage (CLI):
+ *   node scripts/hooks-system/infrastructure/telemetry/metrics-logger.js \
+ *     --hook validate-ai-evidence --status success --duration 123
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const METRICS_FILE = path.join(process.cwd(), '.audit_tmp', 'hook-metrics.jsonl');
+
+function ensureDir() {
+  const dir = path.dirname(METRICS_FILE);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+function recordMetric(entry) {
+  ensureDir();
+  const payload = {
+    timestamp: Date.now(),
+    ...entry,
+  };
+  fs.appendFileSync(METRICS_FILE, `${JSON.stringify(payload)}\n`, 'utf8');
+  return payload;
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 2; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const value = argv[i + 1];
+      args[key] = value;
+      i++;
+    }
+  }
+  return args;
+}
+
+if (require.main === module) {
+  const args = parseArgs(process.argv);
+  const { hook, status, duration } = args;
+
+  if (!hook || !status) {
+    console.error('Usage: metrics-logger --hook <name> --status <success|failure> [--duration <ms>]');
+    process.exit(1);
+  }
+
+  const durationMs = duration ? Number(duration) : undefined;
+  recordMetric({ hook, status, durationMs });
+  console.log('Metric recorded');
+}
+
+module.exports = {
+  recordMetric,
+};

package/scripts/hooks-system/infrastructure/telemetry/metrics-server.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+
+const PORT = Number(process.env.HOOK_METRICS_PORT || 9464);
+const METRICS_FILE = path.join(process.cwd(), '.audit_tmp', 'hook-metrics.jsonl');
+
+function loadMetrics() {
+  if (!fs.existsSync(METRICS_FILE)) return [];
+  return fs
+    .readFileSync(METRICS_FILE, 'utf8')
+    .trim()
+    .split('\n')
+    .filter(Boolean)
+    .map(line => {
+      try {
+        return JSON.parse(line);
+      } catch (error) {
+        return null;
+      }
+    })
+    .filter(Boolean);
+}
+
+function buildPrometheusMetrics() {
+  const metrics = loadMetrics();
+  const counters = {};
+
+  for (const metric of metrics) {
+    const hook = metric.hook || 'unknown';
+    const status = metric.status || 'unknown';
+    const key = `${hook}:${status}`;
+    counters[key] = (counters[key] || 0) + 1;
+  }
+
+  let output = '# HELP hook_events_total Total number of hook events\n';
+  output += '# TYPE hook_events_total counter\n';
+  for (const [key, value] of Object.entries(counters)) {
+    const [hook, status] = key.split(':');
+    output += `hook_events_total{hook="${hook}",status="${status}"} ${value}\n`;
+  }
+  return output;
+}
+
+const server = http.createServer((req, res) => {
+  if (req.url === '/metrics') {
+    const body = buildPrometheusMetrics();
+    res.writeHead(200, { 'Content-Type': 'text/plain' });
+    res.end(body);
+    return;
+  }
+
+  res.writeHead(404);
+  res.end();
+});
+
+server.listen(PORT, () => {
+  console.log(`Hook-System metrics server running on http://localhost:${PORT}/metrics`);
+});