pumuki-ast-hooks 6.1.10 → 6.1.11

package/README.md

@@ -13,7 +13,7 @@ Portable, project‑agnostic, multi‑platform enterprise framework to govern AI
 
 ---
 
-## Quick Start (30–60s)
+## Inicio rápido (30–60s)
 
 ```bash
 git init
@@ -22,9 +22,9 @@ npx ast-install
 npx ast-hooks audit
 ```
 
-Default installation mode is `npm-runtime`.
+Modo de instalación por defecto: `npm-runtime`.
 
-To opt into an embedded runtime copy (`vendored` mode):
+Para usar runtime embebido (modo `vendored`):
 
 ```bash
 HOOK_INSTALL_MODE=vendored npx ast-install
@@ -360,58 +360,61 @@ The Git Flow cycle includes branch validation, commits, push, PR, merge (by poli
 
 ---
 
-## 9. Commands Section (MANDATORY – DO NOT CHANGE)
+## 9. Sección de comandos (OBLIGATORIO – NO CAMBIAR)
 
-### Install (dev)
+### Instalación (dev)
 
 ```bash
 npm install --save-dev pumuki-ast-hooks
+npx ast-install
 ```
 
-### Legacy install
+### Instalación (legacy)
 
 ```bash
 npm install --save-dev pumuki-ast-hooks
+npx ast-install
 ```
 
-### Update
+### Actualización
 
 ```bash
 npm install --save-dev pumuki-ast-hooks@latest
-npm run install-hooks
+npx ast-install
 ```
 
-### Uninstall
+### Desinstalación
 
 ```bash
+npx ast-uninstall
 npm uninstall pumuki-ast-hooks
 ```
 
-### Install hooks
+### Instalar hooks
 
 ```bash
 npm run install-hooks
 ```
 
-### Run interactive menu
+### Menú interactivo
 
 ```bash
 npx ast-hooks
 ```
 
-### Version check
+### Verificación de versión
 
 ```bash
 npm run ast:check-version
 ```
 
-### Audit
+### Auditoría
 
 ```bash
 npm run audit
 ```
 
-### Git flow
+### Git Flow
 
 ```bash
 npm run ast:gitflow
@@ -432,7 +435,7 @@ npm run ast:guard:status
 npm run ast:guard:logs
 ```
 
-### Evidence refresh
+### Refresco de evidencia
 
 ```bash
 npm run ast:refresh

package/docs/INSTALLATION.md

@@ -626,7 +626,7 @@ To update:
      npm install --save-dev pumuki-ast-hooks@latest
 
   2. Re-install hooks (to get latest features):
-     npm run install-hooks
+     npx ast-install
 
 What's new in 5.3.1:
   Check CHANGELOG.md: https://github.com/...
@@ -651,7 +651,7 @@ npm install --save-dev pumuki-ast-hooks@5.3.1
 **⚠️ IMPORTANT:** After updating, you MUST re-run the installer to get the latest hooks and configurations:
 
 ```bash
-npm run install-hooks
+npx ast-install
 ```
 
 This ensures:
@@ -745,6 +745,7 @@ npm view pumuki-ast-hooks version
 
 ```bash
 # Uninstall
+npx ast-uninstall
 npm uninstall pumuki-ast-hooks
 
 # Remove hooks (optional)

package/hooks/__tests__/pre-tool-use-evidence-validator.spec.js

@@ -0,0 +1,16 @@
+const fs = require('fs');
+const path = require('path');
+
+describe('pre-tool-use-evidence-validator', () => {
+    const filePath = path.join(__dirname, '..', 'pre-tool-use-evidence-validator.ts');
+
+    it('should exist', () => {
+        expect(fs.existsSync(filePath)).toBe(true);
+    });
+
+    it('should include auto-refresh execution of update-evidence', () => {
+        const content = fs.readFileSync(filePath, 'utf8');
+        expect(content).toMatch(/update-evidence\.sh/);
+        expect(content).toMatch(/--auto/);
+    });
+});

package/hooks/pre-tool-use-evidence-validator.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
+import { execSync } from 'child_process';
 import { sendMacOSNotification } from './notify-macos.js';
 
 interface ToolInput {
@@ -34,6 +35,8 @@ interface Violation {
 
 const MAX_AGE_SECONDS = 180;
 
+type ValidationResult = { valid: boolean; code?: string; error?: string };
+
 function utcToEpoch(timestamp: string): number {
     try {
         return Math.floor(new Date(timestamp).getTime() / 1000);
@@ -42,10 +45,11 @@ function utcToEpoch(timestamp: string): number {
     }
 }
 
-function validateEvidence(evidencePath: string): { valid: boolean; error?: string } {
+function validateEvidence(evidencePath: string): ValidationResult {
     if (!existsSync(evidencePath)) {
         return {
             valid: false,
+            code: 'missing',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Missing
 
 📋 VIOLATION:
@@ -69,6 +73,7 @@ This is enforced by pre-commit hooks and PreToolUse validation`
     } catch {
         return {
             valid: false,
+            code: 'invalid_json',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Invalid JSON
 
 📋 VIOLATION:
@@ -86,6 +91,7 @@ This is enforced by pre-commit hooks and PreToolUse validation`
     if (!timestamp || typeof timestamp !== 'string') {
         return {
             valid: false,
+            code: 'missing_timestamp',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Missing Timestamp
 
 📋 VIOLATION:
@@ -102,6 +108,7 @@ This is enforced by pre-commit hooks and PreToolUse validation`
     if (evidenceEpoch === 0) {
         return {
             valid: false,
+            code: 'invalid_timestamp',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Invalid Timestamp Format
 
 📋 VIOLATION:
@@ -119,6 +126,7 @@ This is enforced by pre-commit hooks and PreToolUse validation`
     if (ageSeconds > MAX_AGE_SECONDS) {
         return {
             valid: false,
+            code: 'stale',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Too Old
 
 📋 VIOLATION:
@@ -139,6 +147,7 @@ Evidence must be fresh to ensure rules were read and questions answered`
     if (!rulesRead || (Array.isArray(rulesRead) && rulesRead.length === 0)) {
         return {
             valid: false,
+            code: 'missing_rules',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Missing Rules Read
 
 📋 VIOLATION:
@@ -155,6 +164,7 @@ Evidence must be fresh to ensure rules were read and questions answered`
     if (questionsAnswered !== true) {
         return {
             valid: false,
+            code: 'questions_unanswered',
             error: `⚠️ BLOCKED - .AI_EVIDENCE.json Protocol Questions Not Answered
 
 📋 VIOLATION:
@@ -181,6 +191,7 @@ Evidence must be fresh to ensure rules were read and questions answered`
 
         return {
             valid: false,
+            code: 'gate_blocked',
             error: `🚫 BLOCKED - AI Gate Status: BLOCKED
 
 📋 VIOLATION:
@@ -205,6 +216,45 @@ This ensures code quality standards are maintained`
     return { valid: true };
 }
 
+function resolveUpdateEvidenceScript(projectDir: string): string | null {
+    const candidates = [
+        join(projectDir, 'scripts', 'hooks-system', 'bin', 'update-evidence.sh'),
+        join(projectDir, 'node_modules', 'pumuki-ast-hooks', 'scripts', 'hooks-system', 'bin', 'update-evidence.sh'),
+        join(projectDir, 'node_modules', 'pumuki-ast-hooks', 'bin', 'update-evidence.sh'),
+        join(projectDir, 'bin', 'update-evidence.sh')
+    ];
+
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+
+    return null;
+}
+
+function autoRefreshEvidence(projectDir: string): boolean {
+    const flag = String(process.env.AI_START_AUTO_REFRESH || '').trim().toLowerCase();
+    if (flag === '0' || flag === 'false' || flag === 'no') {
+        return false;
+    }
+
+    const scriptPath = resolveUpdateEvidenceScript(projectDir);
+    if (!scriptPath) {
+        return false;
+    }
+
+    try {
+        execSync(`bash "${scriptPath}" --auto`, {
+            cwd: projectDir,
+            stdio: 'ignore'
+        });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
 async function readStdin(): Promise<string> {
     return new Promise((resolve) => {
         let data = '';
@@ -225,7 +275,12 @@ async function main() {
         const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
         const evidencePath = join(projectDir, '.AI_EVIDENCE.json');
 
-        const validation = validateEvidence(evidencePath);
+        let validation = validateEvidence(evidencePath);
+        if (!validation.valid && validation.code !== 'gate_blocked') {
+            if (autoRefreshEvidence(projectDir)) {
+                validation = validateEvidence(evidencePath);
+            }
+        }
         if (!validation.valid) {
             try {
                 sendMacOSNotification({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.10",
+  "version": "6.1.11",
   "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
   "main": "index.js",
   "bin": {
@@ -136,4 +136,4 @@
     "./skills": "./skills/skill-rules.json",
     "./hooks": "./hooks/index.js"
   }
-}
+}

package/scripts/hooks-system/.audit-reports/auto-recovery.log

@@ -41,3 +41,8 @@
 {"timestamp":"2026-01-15T07:49:00.777Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
 {"timestamp":"2026-01-15T09:57:40.478Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
 {"timestamp":"2026-01-15T14:53:23.342Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
+{"timestamp":"2026-01-21T12:12:12.268Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
+{"timestamp":"2026-01-21T13:01:11.530Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
+{"timestamp":"2026-01-21T13:16:57.700Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
+{"timestamp":"2026-01-21T14:08:08.597Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
+{"timestamp":"2026-01-21T14:14:43.580Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}

package/scripts/hooks-system/.audit-reports/install-wizard.log

@@ -174,3 +174,23 @@
 {"timestamp":"2026-01-15T14:53:23.414Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
 {"timestamp":"2026-01-15T14:53:23.415Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
 {"timestamp":"2026-01-15T14:53:23.415Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-21T12:12:11.691Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-21T12:12:11.709Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
+{"timestamp":"2026-01-21T12:12:11.710Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
+{"timestamp":"2026-01-21T12:12:11.710Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-21T13:01:11.637Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-21T13:01:11.652Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
+{"timestamp":"2026-01-21T13:01:11.652Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
+{"timestamp":"2026-01-21T13:01:11.653Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-21T13:16:58.626Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-21T13:16:58.641Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
+{"timestamp":"2026-01-21T13:16:58.642Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
+{"timestamp":"2026-01-21T13:16:58.642Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-21T14:08:09.347Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-21T14:08:09.372Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
+{"timestamp":"2026-01-21T14:08:09.374Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
+{"timestamp":"2026-01-21T14:08:09.374Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-21T14:14:44.270Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-21T14:14:44.277Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
+{"timestamp":"2026-01-21T14:14:44.277Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
+{"timestamp":"2026-01-21T14:14:44.277Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}

package/scripts/hooks-system/.audit_tmp/hook-metrics.jsonl

@@ -1298,3 +1298,155 @@
 {"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
 {"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
 {"timestamp":1768488803342,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768996398842,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768996398842,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768996398842,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768996398842,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532262,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532263,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997532264,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997532264,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532264,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532264,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997532264,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997532265,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532266,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532266,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997532266,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997532266,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532266,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997532266,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997532267,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997532267,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997567514,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768997567515,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768997567515,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768997567515,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000347952,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000347953,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000347953,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000347953,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471526,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471527,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000471527,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000471527,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471527,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471528,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000471528,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000471528,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471528,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471528,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000471528,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000471529,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000515929,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769000515929,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769000515929,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769000515929,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417697,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417698,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001417698,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001417698,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417698,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417698,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001417698,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001417699,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417700,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001417700,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001417700,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001417700,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001466654,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769001466654,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769001466654,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769001466654,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769002218266,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769002218266,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769002218266,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769002218266,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769002828740,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769002828740,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769002828740,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769002828740,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488587,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488588,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004488588,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004488588,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488588,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488588,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004488589,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004488589,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488589,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488589,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004488589,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004488592,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488592,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488595,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004488595,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004488595,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488595,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004488596,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883578,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004883579,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004905775,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769004905775,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769004905775,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769004905775,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}

package/scripts/hooks-system/infrastructure/ast/text/__tests__/text-scanner.spec.js

@@ -65,5 +65,65 @@ describe('Text Scanner Module', () => {
       const typeSafety = findings.find(f => f.ruleId === 'ios.optionals.type_safety');
       expect(typeSafety).toBeUndefined();
     });
+
+    it('flags switch-based message provider mapping to string literals', () => {
+      const root = fs.mkdtempSync(path.join(os.tmpdir(), 'ast-text-'));
+      const filePath = path.join(root, 'SupportMessageProvider.swift');
+      const content = [
+        'enum SupportStatus {',
+        '  case active',
+        '  case inactive',
+        '}',
+        '',
+        'struct SupportMessageProvider {',
+        '  func message(for status: SupportStatus) -> String {',
+        '    switch status {',
+        '    case .active:',
+        '      return "support.active"',
+        '    case .inactive:',
+        '      return "support.inactive"',
+        '    }',
+        '  }',
+        '}'
+      ].join('\n');
+
+      fs.writeFileSync(filePath, content, 'utf8');
+
+      const findings = [];
+      runTextScanner(root, findings);
+
+      const ocpFinding = findings.find(f => f.ruleId === 'ios.solid.ocp_switch_to_string');
+      expect(ocpFinding).toBeDefined();
+    });
+  });
+
+  describe('android rules', () => {
+    it('flags when-based message provider mapping to string literals', () => {
+      const root = fs.mkdtempSync(path.join(os.tmpdir(), 'ast-text-'));
+      const filePath = path.join(root, 'SupportMessageProvider.kt');
+      const content = [
+        'enum class SupportStatus {',
+        '  ACTIVE,',
+        '  INACTIVE',
+        '}',
+        '',
+        'class SupportMessageProvider {',
+        '  fun message(status: SupportStatus): String {',
+        '    return when (status) {',
+        '      SupportStatus.ACTIVE -> "support.active"',
+        '      SupportStatus.INACTIVE -> "support.inactive"',
+        '    }',
+        '  }',
+        '}'
+      ].join('\n');
+
+      fs.writeFileSync(filePath, content, 'utf8');
+
+      const findings = [];
+      runTextScanner(root, findings);
+
+      const ocpFinding = findings.find(f => f.ruleId === 'android.solid.ocp_switch_to_string');
+      expect(ocpFinding).toBeDefined();
+    });
   });
 });

package/scripts/hooks-system/infrastructure/ast/text/text-scanner.js

@@ -15,6 +15,58 @@ function walk(dir, acc) {
   }
 }
 
+function hasProviderNameHint(content, filePath) {
+  const providerNamePattern = /\b(class|struct|object)\s+[A-Za-z_][A-Za-z0-9_]*(Message|Notice|Localization|Provider|Presenter|Mapper)[A-Za-z0-9_]*\b/i;
+  if (providerNamePattern.test(content)) return true;
+  const baseName = path.basename(filePath, path.extname(filePath));
+  return /Message|Notice|Localization|Provider|Presenter|Mapper/i.test(baseName);
+}
+
+function hasSwiftMappingHint(content) {
+  return /\brawValue\b/.test(content) || /\bDictionary<[^>]*String\b/.test(content) || /\[[A-Za-z_][A-Za-z0-9_]*\s*:\s*String\]/.test(content);
+}
+
+function hasKotlinMappingHint(content) {
+  return /\bmapOf\s*\(|\bmutableMapOf\s*\(|\bMap<[^>]*String\b/.test(content);
+}
+
+function hasSwiftSwitchToString(content) {
+  const switchPattern = /switch\s+[A-Za-z_][A-Za-z0-9_]*\s*\{[^}]*\}/g;
+  let match;
+  while ((match = switchPattern.exec(content)) !== null) {
+    const block = match[0];
+    if (!/\bcase\b/.test(block)) continue;
+    if (!/\"[^\"]+\"/.test(block)) continue;
+    if (!/case\s+(\.|[A-Za-z_][A-Za-z0-9_]*\.)[A-Za-z_][A-Za-z0-9_]*\s*:/.test(block)) continue;
+    if (/\breturn\b/.test(block) || /case\s+[^\n:]+:\s*\"[^\"]+\"/.test(block)) return true;
+  }
+  return false;
+}
+
+function hasKotlinWhenToString(content) {
+  const whenPattern = /when\s*\([^)]*\)\s*\{[^}]*\}/g;
+  let match;
+  while ((match = whenPattern.exec(content)) !== null) {
+    const block = match[0];
+    if (!/[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*\s*->\s*\"[^\"]+\"/.test(block)) continue;
+    return true;
+  }
+  return false;
+}
+
+function shouldFlagMessageProviderSwitch(content, filePath, language) {
+  if (!hasProviderNameHint(content, filePath)) return false;
+  if (language === 'swift') {
+    if (hasSwiftMappingHint(content)) return false;
+    return hasSwiftSwitchToString(content);
+  }
+  if (language === 'kotlin') {
+    if (hasKotlinMappingHint(content)) return false;
+    return hasKotlinWhenToString(content);
+  }
+  return false;
+}
+
 function runTextScanner(root, findings) {
   const files = [];
   let iosAnchorFile = null;
@@ -541,6 +593,11 @@ function runTextScanner(root, findings) {
       if (/Handler\(\)\.post/.test(content) && !/@SuppressLint\("HandlerLeak"\)/.test(content)) {
         pushFileFinding('android.antipattern.handler_leak', 'high', file, 1, 1, 'Handler without weak reference - potential memory leak', findings);
       }
+      const isAnalyzer = /infrastructure\/ast\/|analyzers\/|detectors\/|scanner|analyzer|detector/i.test(file);
+      const isTestFile = /\.(spec|test)\.(js|ts|kt|kts)$/i.test(file);
+      if ((ext === '.kt' || ext === '.kts') && !isAnalyzer && !isTestFile && shouldFlagMessageProviderSwitch(content, file, 'kotlin')) {
+        pushFileFinding('android.solid.ocp_switch_to_string', 'medium', file, 1, 1, 'OCP warning: switch-to-string mapping in message/localization provider - prefer injected map or enum raw values', findings);
+      }
     }
 
     if (plat === 'ios') {
@@ -636,6 +693,9 @@ function runTextScanner(root, findings) {
       if (/Text\(\s*\"[^\"]+\"\s*\)/.test(content) && !/NSLocalizedString|\.localized/.test(content)) {
         pushFileFinding('ios.i18n.hardcoded_strings', 'medium', file, 1, 1, 'Hardcoded string in Text() without localization', findings);
       }
+      if (!isAnalyzer && !isTestFile && shouldFlagMessageProviderSwitch(content, file, 'swift')) {
+        pushFileFinding('ios.solid.ocp_switch_to_string', 'medium', file, 1, 1, 'OCP warning: switch-to-string mapping in message/localization provider - prefer RawRepresentable or injected map', findings);
+      }
       if (/Date\(/.test(content) && !/DateFormatter/.test(content)) {
         pushFileFinding('ios.i18n.missing_date_formatter', 'medium', file, 1, 1, 'Date rendered without DateFormatter', findings);
       }

package/scripts/hooks-system/infrastructure/orchestration/__tests__/intelligent-audit.spec.js

@@ -129,6 +129,46 @@ describe('intelligent-audit', () => {
     expect(updated.timestamp).toBeDefined();
     expect(updated.timestamp).not.toBe(previous.timestamp);
   });
+
+  it('should include medium and low violations in ai_gate output when critical or high exist', async () => {
+    const evidencePath = path.join(process.cwd(), '.AI_EVIDENCE.json');
+    const original = fs.existsSync(evidencePath) ? fs.readFileSync(evidencePath, 'utf8') : null;
+    const minimal = {
+      timestamp: new Date().toISOString(),
+      severity_metrics: {
+        last_updated: new Date().toISOString(),
+        total_violations: 0,
+        by_severity: { CRITICAL: 0, HIGH: 0, MEDIUM: 0, LOW: 0 }
+      },
+      ai_gate: { status: 'ALLOWED', scope: 'staging', last_check: new Date().toISOString(), violations: [], instruction: 'x', mandatory: true }
+    };
+
+    try {
+      fs.writeFileSync(evidencePath, JSON.stringify(minimal, null, 2));
+
+      const mod = require('../intelligent-audit');
+      const violations = [
+        { severity: 'CRITICAL', ruleId: 'rule.critical', filePath: 'apps/a.ts', line: 1, message: 'c' },
+        { severity: 'HIGH', ruleId: 'rule.high', filePath: 'apps/b.ts', line: 2, message: 'h' },
+        { severity: 'MEDIUM', ruleId: 'rule.medium', filePath: 'apps/c.ts', line: 3, message: 'm' },
+        { severity: 'LOW', ruleId: 'rule.low', filePath: 'apps/d.ts', line: 4, message: 'l' }
+      ];
+
+      await mod.updateAIEvidence(violations, { passed: false, blockedBy: 'critical' }, { estimated: 1, percentUsed: 0, remaining: 1 });
+
+      const updated = JSON.parse(fs.readFileSync(evidencePath, 'utf8'));
+      const severities = updated.ai_gate.violations.map(v => v.severity);
+      expect(severities).toEqual(expect.arrayContaining(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']));
+    } finally {
+      if (original === null) {
+        if (fs.existsSync(evidencePath)) {
+          fs.unlinkSync(evidencePath);
+        }
+      } else {
+        fs.writeFileSync(evidencePath, original);
+      }
+    }
+  });
 });
 
 describe('AI_EVIDENCE.json structure validation', () => {

package/scripts/hooks-system/infrastructure/orchestration/intelligent-audit.js

@@ -736,11 +736,10 @@ async function updateAIEvidence(violations, gateResult, tokenUsage) {
     const mediumViolations = violations.filter(v => v.severity === 'MEDIUM');
     const lowViolations = violations.filter(v => v.severity === 'LOW');
 
-    let gateViolations = [...criticalViolations, ...highViolations];
-    if (gateViolations.length === 0) {
-      gateViolations = [...mediumViolations, ...lowViolations];
-    }
-    const blockingViolations = gateViolations.slice(0, 50);
+    const maxGateViolations = env.getNumber('AI_GATE_MAX_VIOLATIONS', 200);
+    const gateViolationsLimit = Number.isFinite(maxGateViolations) && maxGateViolations > 0 ? maxGateViolations : 200;
+    const gateViolations = [...criticalViolations, ...highViolations, ...mediumViolations, ...lowViolations];
+    const blockingViolations = gateViolations.slice(0, gateViolationsLimit);
 
     const gateScope = String(env.get('AI_GATE_SCOPE', 'staging') || 'staging').trim().toLowerCase();
 

package/scripts/hooks-system/infrastructure/shell/gitflow/__tests__/gitflow-enforcer.spec.js

@@ -0,0 +1,17 @@
+const fs = require('fs');
+const path = require('path');
+
+describe('gitflow-enforcer', () => {
+    const scriptPath = path.join(__dirname, '..', 'gitflow-enforcer.sh');
+
+    test('debe ignorar xcuserdata en atomicidad', () => {
+        const script = fs.readFileSync(scriptPath, 'utf8');
+        expect(script).toMatch(/xcuserdata/);
+    });
+
+    test('debe omitir lint:hooks si no esta configurado', () => {
+        const script = fs.readFileSync(scriptPath, 'utf8');
+        expect(script).toMatch(/lint:hooks/);
+        expect(script).toMatch(/no configurado/);
+    });
+});

package/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh

@@ -93,11 +93,24 @@ refresh_evidence() {
   printf "${GREEN}✅ Evidencia renovada (${reason}).${NC}\n"
 }
 
+has_lint_hooks_script() {
+  local pkg="$1"
+  if [[ ! -f "$pkg" ]]; then
+    return 1
+  fi
+  if node -e "const fs=require('fs');const p=JSON.parse(fs.readFileSync(process.argv[1],'utf8'));process.exit(p&&p.scripts&&p.scripts['lint:hooks']?0:1);" "$pkg" >/dev/null 2>&1; then
+    return 0
+  fi
+  return 1
+}
+
 lint_hooks_system() {
   local repo_pkg="${REPO_ROOT}/package.json"
   local hooks_pkg="${REPO_ROOT}/scripts/hooks-system/package.json"
+  local ran=0
 
-  if [[ -f "${repo_pkg}" ]]; then
+  if has_lint_hooks_script "${repo_pkg}"; then
+    ran=1
     printf "${CYAN}🔎 Ejecutando lint (repo root)...${NC}\n"
     if npm --prefix "${REPO_ROOT}" run lint:hooks; then
       printf "${GREEN}✅ Lint hooks-system OK.${NC}\n"
@@ -105,7 +118,8 @@ lint_hooks_system() {
     fi
   fi
 
-  if [[ -f "${hooks_pkg}" ]]; then
+  if has_lint_hooks_script "${hooks_pkg}"; then
+    ran=1
     printf "${CYAN}🔎 Ejecutando lint (scripts/hooks-system)...${NC}\n"
     if npm --prefix "${REPO_ROOT}/scripts/hooks-system" run lint:hooks; then
       printf "${GREEN}✅ Lint hooks-system OK.${NC}\n"
@@ -113,6 +127,11 @@ lint_hooks_system() {
     fi
   fi
 
+  if [[ "$ran" -eq 0 ]]; then
+    printf "${YELLOW}ℹ️  lint:hooks no configurado; se omite.${NC}\n"
+    return 0
+  fi
+
   printf "${RED}❌ Lint hooks-system falló.${NC}\n"
   return 1
 }
@@ -178,12 +197,17 @@ verify_atomic_commit() {
   local roots_list=""
   local root_count=0
   for file in "${files[@]}"; do
+    case "$file" in
+      */xcuserdata/*|*/xcuserdatad/*)
+        continue
+        ;;
+    esac
     local root="${file%%/*}"
     if [[ "$root" == "$file" ]]; then
       root="(root)"
     fi
     case "$root" in
-      .AI_EVIDENCE.json|README.md|CHANGELOG.md|docs )
+      .AI_EVIDENCE.json|README.md|CHANGELOG.md|docs|.audit_tmp|.audit-reports|.cursor|.windsurf|xcuserdata|xcuserdatad )
         continue
         ;;
       "" )

package/scripts/hooks-system/infrastructure/watchdog/__tests__/.audit-reports/token-monitor.log

@@ -127,3 +127,18 @@
 {"timestamp":"2026-01-15T14:53:25.770Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
 {"timestamp":"2026-01-15T14:53:25.772Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
 {"timestamp":"2026-01-15T14:53:25.772Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}
+{"timestamp":"2026-01-21T12:12:08.680Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
+{"timestamp":"2026-01-21T12:12:08.681Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
+{"timestamp":"2026-01-21T12:12:08.681Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}
+{"timestamp":"2026-01-21T13:01:16.348Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
+{"timestamp":"2026-01-21T13:01:16.349Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
+{"timestamp":"2026-01-21T13:01:16.350Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}
+{"timestamp":"2026-01-21T13:17:08.086Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
+{"timestamp":"2026-01-21T13:17:08.088Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
+{"timestamp":"2026-01-21T13:17:08.089Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}
+{"timestamp":"2026-01-21T14:08:15.939Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
+{"timestamp":"2026-01-21T14:08:15.943Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
+{"timestamp":"2026-01-21T14:08:15.945Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}
+{"timestamp":"2026-01-21T14:14:45.047Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
+{"timestamp":"2026-01-21T14:14:45.048Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
+{"timestamp":"2026-01-21T14:14:45.048Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}