pumuki-ast-hooks 6.1.11 → 6.2.0

package/README.md

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

package/docs/SEVERITY_AUDIT.md

@@ -0,0 +1,137 @@
+# Auditoría de Severidades - Framework AST Intelligence
+
+## Criterios de Clasificación
+
+### CRITICAL
+- **Vulnerabilidades de seguridad** que exponen datos sensibles
+- **Data loss** potencial o corrupción de datos
+- **Crashes** probables en producción
+- **Violaciones de seguridad** críticas
+
+### HIGH
+- **Bugs probables** que causan comportamiento incorrecto
+- **Memory leaks** y problemas de gestión de memoria
+- **Concurrency issues** que pueden causar race conditions
+- **Violaciones SOLID** que impactan arquitectura
+
+### MEDIUM
+- **Code smells** que afectan mantenibilidad
+- **Performance** no crítico pero medible
+- **Violaciones de patrones** establecidos
+- **Deuda técnica** acumulable
+
+### LOW
+- **Sugerencias de estilo** y mejores prácticas
+- **Optimizaciones** opcionales
+- **Mejoras** de legibilidad
+- **Warnings** informativos
+
+---
+
+## Reglas por Severidad
+
+### CRITICAL (3 reglas)
+
+| Regla | Justificación |
+|-------|---------------|
+| `ios.security.sensitive_userdefaults` | Credenciales en UserDefaults = vulnerabilidad de seguridad |
+| `ios.security.hardcoded_secrets` | API keys/tokens hardcodeados = exposición de secretos |
+| `backend.antipattern.god_classes` | Clases God extremas = arquitectura colapsada |
+
+### HIGH (12 reglas)
+
+| Regla | Justificación |
+|-------|---------------|
+| `ios.force_unwrapping` | Force unwrap = crash probable en runtime |
+| `ios.safety.force_unwrap_property` | Propiedades force unwrap = crash al acceder |
+| `ios.memory.missing_weak_self` | Retain cycles = memory leaks |
+| `ios.concurrency.task_no_error_handling` | Errores sin manejar = crashes silenciosos |
+| `ios.concurrency.async_ui_update` | UI updates fuera MainActor = crashes/bugs visuales |
+| `ios.quality.long_function` | Funciones >50 líneas = bugs difíciles de detectar |
+| `ios.quality.high_complexity` | Complejidad >10 = bugs probables |
+| `ios.swiftui.complex_body` | Body >100 líneas = performance/bugs |
+| `ios.antipattern.singleton` | Singletons = testing imposible, acoplamiento |
+| `ios.architecture.repository_no_protocol` | Repositorios sin protocolo = violación DIP |
+| `ios.architecture.usecase_wrong_layer` | UseCase en capa incorrecta = arquitectura rota |
+| `ios.solid.srp.god_class` | God class detectada = violación SRP crítica |
+
+### MEDIUM (15 reglas)
+
+| Regla | Justificación |
+|-------|---------------|
+| `ios.quality.pyramid_of_doom` | Anidación profunda = legibilidad/mantenibilidad |
+| `ios.quality.too_many_params` | >5 parámetros = difícil de usar/mantener |
+| `ios.quality.nested_closures` | >3 closures = callback hell, usar async/await |
+| `ios.encapsulation.public_mutable` | Propiedades públicas mutables = encapsulación rota |
+| `ios.swiftui.too_many_state` | >5 @State = considerar ViewModel |
+| `ios.swiftui.observed_without_state` | @ObservedObject sin ownership = bugs sutiles |
+| `ios.solid.isp.fat_protocol` | Protocolo >5 requisitos = violación ISP |
+| `ios.architecture.usecase_no_execute` | UseCase sin execute() = patrón inconsistente |
+| `ios.architecture.usecase_void` | UseCase retorna Void = no testable |
+| `ios.testing.missing_makesut` | Test sin makeSUT = código duplicado |
+| `ios.naming.god_naming` | Nombres Manager/Helper = posible God class |
+| `ios.i18n.hardcoded_strings` | >3 strings hardcodeados = i18n faltante |
+| `ios.accessibility.missing_labels` | Imágenes sin labels = accesibilidad rota |
+| `ios.solid.dip.concrete_dependency` | Dependencias concretas = violación DIP |
+| `ios.solid.ocp.modification` | Modificar en lugar de extender = violación OCP |
+
+### LOW (8 reglas)
+
+| Regla | Justificación |
+|-------|---------------|
+| `ios.imports.unused` | Imports sin usar = ruido, build time |
+| `ios.performance.non_final_class` | Clases no final = optimización perdida |
+| `ios.codable.missing_coding_keys` | CodingKeys opcionales = mejor control |
+| `ios.performance.large_equatable` | Equatable >5 props = performance menor |
+| `ios.concurrency.task_cancellation` | Task sin cancelación = recursos no liberados |
+| `ios.performance.blocking_main_thread` | Operaciones síncronas = UI freeze potencial |
+| `ios.testing.missing_leak_tracking` | Tests sin leak tracking = leaks no detectados |
+| `ios.quality.magic_numbers` | Números mágicos = legibilidad |
+
+---
+
+## Cambios Recomendados
+
+### Ninguno - Clasificación Correcta
+
+Tras la auditoría, **todas las severidades están correctamente asignadas** según los criterios establecidos:
+
+- ✅ **CRITICAL**: Solo vulnerabilidades de seguridad y arquitectura colapsada
+- ✅ **HIGH**: Bugs probables, memory leaks, crashes
+- ✅ **MEDIUM**: Code smells, mantenibilidad, patrones
+- ✅ **LOW**: Optimizaciones, estilo, mejoras opcionales
+
+---
+
+## Estadísticas
+
+| Severidad | Cantidad | % |
+|-----------|----------|---|
+| CRITICAL | 3 | 8% |
+| HIGH | 12 | 32% |
+| MEDIUM | 15 | 39% |
+| LOW | 8 | 21% |
+| **TOTAL** | **38** | **100%** |
+
+---
+
+## Validación
+
+### Criterios Aplicados
+
+1. **CRITICAL**: ¿Expone datos sensibles o causa data loss?
+2. **HIGH**: ¿Causa crashes o memory leaks probables?
+3. **MEDIUM**: ¿Afecta mantenibilidad o patrones?
+4. **LOW**: ¿Es optimización o mejora opcional?
+
+### Resultado
+
+✅ **Todas las reglas cumplen con los criterios de su severidad asignada**
+
+No se requieren reclasificaciones.
+
+---
+
+**Auditoría completada:** 24 Enero 2026  
+**Framework:** pumuki-ast-hooks v6.1.13  
+**Total reglas auditadas:** 38

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.11",
+  "version": "6.2.0",
   "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": {
-    "pumuki-ast-hooks": "./bin/pumuki-mcp-server.js",
-    "audit": "./bin/audit",
-    "ast-hooks": "./bin/cli.js",
-    "ast-install": "./bin/install.js",
-    "ast-uninstall": "./bin/uninstall.js",
-    "ast-violations": "./bin/violations-api.js",
-    "ast-check-version": "./bin/check-version.js",
-    "ast-gitflow": "./scripts/hooks-system/bin/gitflow-cycle.js",
-    "ai-commit": "./bin/ai-commit.sh",
-    "hook-run-orchestrator": "./bin/run-orchestrator.js",
-    "hook-watch": "./bin/watch-hooks.js",
-    "hook-status": "./bin/hook-status.js",
-    "hook-predict": "./bin/predictive-hooks.js",
-    "hook-playbook": "./bin/run-playbook.js",
-    "hook-doc-drift": "./bin/check-doc-drift.js",
-    "hook-plan-review": "./bin/plan-review.js"
+    "pumuki-ast-hooks": "bin/pumuki-mcp-server.js",
+    "audit": "bin/audit",
+    "ast-hooks": "bin/cli.js",
+    "ast-install": "bin/install.js",
+    "ast-uninstall": "bin/uninstall.js",
+    "ast-violations": "bin/violations-api.js",
+    "ast-check-version": "bin/check-version.js",
+    "ast-gitflow": "scripts/hooks-system/bin/gitflow-cycle.js",
+    "ai-commit": "bin/ai-commit.sh",
+    "hook-run-orchestrator": "bin/run-orchestrator.js",
+    "hook-watch": "bin/watch-hooks.js",
+    "hook-status": "bin/hook-status.js",
+    "hook-predict": "bin/predictive-hooks.js",
+    "hook-playbook": "bin/run-playbook.js",
+    "hook-doc-drift": "bin/check-doc-drift.js",
+    "hook-plan-review": "bin/plan-review.js"
   },
   "scripts": {
     "install-hooks": "node bin/install.js",
@@ -81,7 +81,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/SwiftEnProfundidad/ast-intelligence-hooks.git"
+    "url": "git+https://github.com/SwiftEnProfundidad/ast-intelligence-hooks.git"
   },
   "bugs": {
     "url": "https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/issues"

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

@@ -46,3 +46,5 @@
 {"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":{}}
+{"timestamp":"2026-01-21T14:19:14.000Z","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:43:15.797Z","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

@@ -194,3 +194,11 @@
 {"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":{}}
+{"timestamp":"2026-01-21T14:19:14.062Z","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:19:14.069Z","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:19:14.070Z","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:19:14.070Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-21T14:43:15.954Z","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:43:15.961Z","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:43:15.961Z","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:43:15.961Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}

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

@@ -1450,3 +1450,59 @@
 {"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"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005153999,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005154000,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005445389,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769005445389,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769005445390,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769005445390,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595796,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006595797,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006595797,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595797,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006595797,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006595797,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006595797,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006619003,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1769006619004,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1769006619004,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1769006619004,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}

package/scripts/hooks-system/infrastructure/ast/ios/__tests__/ios-srp-helpers.spec.js

@@ -0,0 +1,62 @@
+const { summarizeSwiftTypes, evaluateMultipleTypeGroups, resolveSrpSeverity, isThinWrapperSummary } = require('../utils/ios-srp-helpers');
+
+describe('ios srp heuristics', () => {
+  it('flags multiple unrelated types by group', () => {
+    const content = `
+struct User { let id: String }
+struct Order { let id: String }
+struct Product { let id: String }
+`;
+    const summaries = summarizeSwiftTypes(content);
+    const result = evaluateMultipleTypeGroups(summaries);
+    expect(result.shouldFlag).toBe(true);
+    expect(result.distinctGroups).toBeGreaterThan(1);
+  });
+
+  it('does not flag multiple types with shared prefix', () => {
+    const content = `
+struct UserView { var body: some View { Text("x") } }
+final class UserViewModel { func load() {} }
+final class UserRouter { func route() {} }
+`;
+    const summaries = summarizeSwiftTypes(content);
+    const result = evaluateMultipleTypeGroups(summaries);
+    expect(result.shouldFlag).toBe(false);
+  });
+
+  it('counts methods without nested type members', () => {
+    const content = `
+struct Wrapper {
+  struct Nested { func inner() {} }
+  func outer() {}
+}
+`;
+    const summaries = summarizeSwiftTypes(content);
+    const wrapper = summaries.find((item) => item.name === 'Wrapper');
+    expect(wrapper.methodsCount).toBe(1);
+  });
+
+  it('detects thin wrappers', () => {
+    const content = `
+struct TokenSpyStorageState {
+  var savedTokens: [String]
+  var deletedTokensCount: Int
+}
+
+final class AccessTokenSpyStorage {
+  var state: TokenSpyStorageState
+}
+`;
+    const summaries = summarizeSwiftTypes(content);
+    const wrapper = summaries.find((item) => item.name === 'AccessTokenSpyStorage');
+    expect(isThinWrapperSummary(wrapper)).toBe(true);
+  });
+
+  it('resolves severity by layer', () => {
+    const config = { coreSeverity: 'critical', defaultSeverity: 'high', testSeverity: 'low' };
+    expect(resolveSrpSeverity('Apps/Domain/User.swift', config)).toBe('critical');
+    expect(resolveSrpSeverity('Apps/Application/UserUseCase.swift', config)).toBe('critical');
+    expect(resolveSrpSeverity('Apps/Tests/UserTests.swift', config)).toBe('low');
+    expect(resolveSrpSeverity('Apps/Presentation/UserView.swift', config)).toBe('high');
+  });
+});

package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSASTIntelligentAnalyzer.js

@@ -211,6 +211,29 @@ class iOSASTIntelligentAnalyzer {
 
     collectAllNodes(this, substructure, null);
     await analyzeCollectedNodes(this, displayPath);
+
+    this.detectForceUnwrapping(displayPath);
+  }
+
+  detectForceUnwrapping(filePath) {
+    const lines = this.fileContent.split('\n');
+    lines.forEach((line, index) => {
+      const matches = [...line.matchAll(/(\w+)!/g)];
+      matches.forEach(match => {
+        const charBefore = match.index > 0 ? line[match.index - 1] : '';
+        const isLogicalNegation = charBefore === '!' || /[&|=<>]/.test(charBefore);
+
+        if (!isLogicalNegation) {
+          this.pushFinding(
+            'ios.force_unwrapping',
+            'high',
+            filePath,
+            index + 1,
+            `Force unwrapping (!) detected on '${match[1]}' - use if let or guard let instead`
+          );
+        }
+      });
+    });
   }
 
   safeStringify(obj) {

package/scripts/hooks-system/infrastructure/ast/ios/analyzers/iOSEnterpriseChecks.js

@@ -287,9 +287,16 @@ function analyzeConcurrency({ content, filePath, addFinding }) {
             'Manual main thread dispatch - use @MainActor annotation');
     }
 
-    if (content.includes('Task {') && !content.includes('.cancel()') && !content.includes('Task.isCancelled')) {
-        addFinding('ios.concurrency.task_cancellation', 'low', filePath, 1,
-            'Task without cancellation handling');
+    if (content.includes('Task {')) {
+        const hasCancelCheck = content.includes('Task.isCancelled') ||
+            content.includes('Task.checkCancellation') ||
+            content.includes('withTaskCancellationHandler') ||
+            content.includes('.cancel()');
+
+        if (!hasCancelCheck) {
+            addFinding('ios.concurrency.task_cancellation', 'low', filePath, 1,
+                'Task without cancellation handling - consider guard !Task.isCancelled or try Task.checkCancellation()');
+        }
     }
 
     if (content.includes('var ') && content.includes('queue') && !content.includes('actor')) {
@@ -304,9 +311,16 @@ function analyzeTesting({ content, filePath, addFinding }) {
             'Test file without XCTest or Quick import');
     }
 
-    if (filePath.includes('Test') && !content.includes('makeSUT') && content.includes('func test')) {
-        addFinding('ios.testing.missing_makesut', 'medium', filePath, 1,
-            'Test without makeSUT pattern - centralize system under test creation');
+    if (filePath.includes('Test') && content.includes('func test')) {
+        const hasMakeSUT = /func\s+(private\s+)?make[Ss][Uu][Tt]\b/.test(content) ||
+            /func\s+(private\s+)?make_sut\b/.test(content) ||
+            /func\s+(private\s+)?sut\b/.test(content);
+        const testCount = (content.match(/func\s+test/g) || []).length;
+
+        if (!hasMakeSUT && testCount >= 3) {
+            addFinding('ios.testing.missing_makesut', 'medium', filePath, 1,
+                'Test without makeSUT pattern - centralize system under test creation');
+        }
     }
 
     if (filePath.includes('Test') && !content.includes('trackForMemoryLeaks') && content.includes('class')) {

package/scripts/hooks-system/infrastructure/ast/ios/ast-ios.js

@@ -17,6 +17,7 @@ const { iOSCICDRules } = require(path.join(__dirname, 'analyzers/iOSCICDRules'))
 const { iOSForbiddenLiteralsAnalyzer } = require(path.join(__dirname, 'analyzers/iOSForbiddenLiteralsAnalyzer'));
 const { iOSASTIntelligentAnalyzer } = require(path.join(__dirname, 'analyzers/iOSASTIntelligentAnalyzer'));
 const { iOSModernPracticesRules } = require(path.join(__dirname, 'analyzers/iOSModernPracticesRules'));
+const { summarizeSwiftTypes, evaluateMultipleTypeGroups, resolveSrpSeverity, isThinWrapperSummary } = require(path.join(__dirname, 'utils/ios-srp-helpers'));
 
 function detectForbiddenTestableImport({ filePath, content }) {
   if (!filePath || !content) return null;
@@ -36,8 +37,16 @@ function detectMissingMakeSUT({ filePath, content }) {
   if (!content.includes('XCTest')) return null;
   const hasTests = /func\s+test\w*\s*\(/.test(content);
   if (!hasTests) return null;
-  const hasMakeSUT = /func\s+makeSUT\b/.test(content);
+
+  const hasMakeSUT = /func\s+(private\s+)?make[Ss][Uu][Tt]\b/.test(content) ||
+    /func\s+(private\s+)?make_sut\b/.test(content) ||
+    /func\s+(private\s+)?sut\b/.test(content);
+
   if (hasMakeSUT) return null;
+
+  const testCount = (content.match(/func\s+test/g) || []).length;
+  if (testCount < 3) return null;
+
   return {
     ruleId: 'ios.testing.missing_make_sut',
     severity: 'high',
@@ -128,10 +137,6 @@ async function runIOSIntelligence(project, findings, platform) {
 
     if (platformOf(filePath) !== "ios") return;
 
-    sf.getDescendantsOfKind(SyntaxKind.NonNullExpression).forEach((expr) => {
-      pushFinding("ios.force_unwrapping", "high", sf, expr, "Force unwrapping (!) detected - use if let or guard let instead", findings);
-    });
-
     const completionHandlerFilePath = sf.getFilePath();
     const isAnalyzer = /infrastructure\/ast\/|analyzers\/|detectors\/|scanner|analyzer|detector/i.test(completionHandlerFilePath);
     const isCompletionTestFile = /\.(spec|test)\.(js|ts|swift)$/i.test(completionHandlerFilePath);
@@ -1134,29 +1139,42 @@ async function runIOSIntelligence(project, findings, platform) {
     // ==========================================
 
 
-    const typePattern = /\b(class|struct|enum|protocol)\s+\w+/g;
-    const classCount = (content.match(typePattern) || []).length;
-    if (classCount > 3 && !filePath.includes('Generated')) {
+    const typeSummaries = summarizeSwiftTypes(content);
+    const typeGroups = evaluateMultipleTypeGroups(typeSummaries);
+    if (typeGroups.shouldFlag && !filePath.includes('Generated')) {
+      const severity = resolveSrpSeverity(filePath, {
+        coreSeverity: 'high',
+        defaultSeverity: 'medium',
+        testSeverity: 'low'
+      });
       pushFinding(
         "ios.solid.srp_multiple_types",
-        "high",
+        severity,
         sf,
         sf,
-        `File defines ${classCount} types - split into separate files (SRP: one responsibility per file)`,
+        `File defines ${typeGroups.totalTypes} types across ${typeGroups.distinctGroups} domains - split by responsibility (SRP)`,
         findings
       );
     }
 
-    if (content.includes('class') || content.includes('struct')) {
-      const funcPattern = /func\s+\w+/g;
-      const funcCount = (content.match(funcPattern) || []).length;
-      if (funcCount > 20) {
+    const godClassSeverityConfig = {
+      coreSeverity: 'critical',
+      defaultSeverity: 'high',
+      testSeverity: 'low'
+    };
+    const godClassThreshold = 20;
+    for (const summary of typeSummaries) {
+      if (isThinWrapperSummary(summary)) {
+        continue;
+      }
+      if (summary.methodsCount > godClassThreshold) {
+        const severity = resolveSrpSeverity(filePath, godClassSeverityConfig);
         pushFinding(
           "ios.solid.srp_god_class",
-          "critical",
+          severity,
           sf,
           sf,
-          `Type has ${funcCount} methods - split responsibilities (SRP: classes should have one reason to change)`,
+          `Type '${summary.name}' has ${summary.methodsCount} methods - split responsibilities (SRP: one reason to change)`,
           findings
         );
       }

package/scripts/hooks-system/infrastructure/ast/ios/detectors/ios-ast-intelligent-strategies.js

@@ -1,5 +1,6 @@
 const path = require('path');
 const DIValidationService = require('../../../../application/DIValidationService');
+const { resolveSrpSeverity, isThinWrapperSummary } = require('../utils/ios-srp-helpers');
 
 const diValidationService = new DIValidationService();
 
@@ -119,17 +120,33 @@ function analyzeImportsAST(analyzer, filePath) {
     const unusedImportAllowlist = new Set(['Foundation', 'SwiftUI', 'UIKit', 'Combine']);
 
     const foundationTypeUsage = /\b(Data|Date|URL|UUID|Decimal|NSNumber|NSDecimalNumber|NSSet|NSDictionary|NSArray|IndexPath|Notification|FileManager|Bundle|Locale|TimeZone|Calendar|DateComponents|URLRequest|URLSession)\b/;
+    const swiftUIUsage = /\b(View|some View|Text|VStack|HStack|ZStack|Button|Image|List|NavigationView|NavigationStack|\.font|\.padding|\.frame|\.background|\.foregroundColor|@State|@Binding|@ObservedObject|@StateObject|@Environment)\b/;
+    const uiKitUsage = /\b(UIViewController|UIView|UITableView|UICollectionView|UIButton|UILabel|UIImageView|UINavigationController|viewDidLoad|viewWillAppear)\b/;
+    const combineUsage = /\b(Publisher|AnyPublisher|PassthroughSubject|CurrentValueSubject|@Published|sink|subscribe|eraseToAnyPublisher)\b/;
+
     for (const imp of analyzer.imports) {
         if (!unusedImportAllowlist.has(imp.name)) continue;
 
         let isUsed = analyzer.allNodes.some((n) => {
             const typename = n['key.typename'] || '';
             const name = n['key.name'] || '';
-            return typename.includes(imp.name) || name.includes(imp.name);
+            const inheritedTypes = n['key.inheritedtypes'] || [];
+            const conformsToView = inheritedTypes.some(t => (t['key.name'] || '') === 'View');
+            return typename.includes(imp.name) || name.includes(imp.name) || (imp.name === 'SwiftUI' && conformsToView);
         });
+
         if (!isUsed && imp.name === 'Foundation') {
             isUsed = foundationTypeUsage.test(content);
         }
+        if (!isUsed && imp.name === 'SwiftUI') {
+            isUsed = swiftUIUsage.test(content);
+        }
+        if (!isUsed && imp.name === 'UIKit') {
+            isUsed = uiKitUsage.test(content);
+        }
+        if (!isUsed && imp.name === 'Combine') {
+            isUsed = combineUsage.test(content);
+        }
 
         if (!isUsed) {
             analyzer.pushFinding('ios.imports.unused', 'low', filePath, imp.line, `Unused import: ${imp.name}`);
@@ -168,16 +185,22 @@ async function analyzeClassAST(analyzer, node, filePath) {
 
     if (name && !/Spec$|Test$|Mock/.test(name) && !name.includes('Coordinator')) {
         const complexity = calculateComplexityAST(substructure);
-        analyzer.godClassCandidates.push({
-            name,
-            filePath,
-            line,
-            methodsCount: methods.length,
-            significantMethodsCount: significantMethods.length,
+        const isThinWrapper = isThinWrapperSummary({
+            methodsCount: significantMethods.length,
             propertiesCount: properties.length,
-            bodyLength,
-            complexity,
         });
+        if (!isThinWrapper) {
+            analyzer.godClassCandidates.push({
+                name,
+                filePath,
+                line,
+                methodsCount: methods.length,
+                significantMethodsCount: significantMethods.length,
+                propertiesCount: properties.length,
+                bodyLength,
+                complexity,
+            });
+        }
     }
 
     if (name.includes('ViewController')) {
@@ -291,8 +314,12 @@ async function analyzeClassAST(analyzer, node, filePath) {
     }
 
     if (filePath.includes('Test') && name.includes('Test')) {
-        const hasMakeSUT = methods.some((m) => (m['key.name'] || '').includes('makeSUT'));
-        if (!hasMakeSUT && methods.length > 2) {
+        const hasMakeSUT = methods.some((m) => {
+            const methodName = (m['key.name'] || '').toLowerCase();
+            return methodName.includes('makesut') || methodName.includes('make_sut') || methodName === 'sut';
+        });
+        const testMethods = methods.filter(m => (m['key.name'] || '').startsWith('test'));
+        if (!hasMakeSUT && testMethods.length >= 3) {
             analyzer.pushFinding('ios.testing.missing_makesut', 'medium', filePath, line, `Test class '${name}' missing makeSUT() factory`);
         }
     }
@@ -424,8 +451,11 @@ function analyzeFunctionAST(analyzer, node, filePath) {
     const ifStatements = countStatementsOfType(substructure, 'stmt.if');
     const guardStatements = countStatementsOfType(substructure, 'stmt.guard');
 
-    if (ifStatements > 3 && guardStatements === 0) {
-        analyzer.pushFinding('ios.quality.pyramid_of_doom', 'medium', filePath, line, `Function '${name}' has ${ifStatements} nested ifs - use guard clauses`);
+    const hasEarlyReturns = (analyzer.fileContent || '').includes('return') && guardStatements > 0;
+    const nestingLevel = calculateNestingDepth(substructure);
+
+    if (nestingLevel >= 3 && !hasEarlyReturns) {
+        analyzer.pushFinding('ios.quality.pyramid_of_doom', 'medium', filePath, line, `Function '${name}' has ${nestingLevel} levels of nesting - use guard clauses for early returns`);
     }
 
     const isAsync = attributes.includes('async');
@@ -458,12 +488,16 @@ function analyzePropertyAST(analyzer, node, filePath) {
     const isMutable = isComputed ? hasAccessorSet : true;
 
     const hasSetterAccessRestriction = attributes.some(a => String(a).startsWith('setter_access'));
-    if (isPublic && isInstance && isMutable && !hasSetterAccessRestriction) {
+    const isProtocolRequirement = name === 'body' || attributes.some(a => String(a).includes('protocol'));
+
+    if (isPublic && isInstance && isMutable && !hasSetterAccessRestriction && !isProtocolRequirement) {
         analyzer.pushFinding('ios.encapsulation.public_mutable', 'medium', filePath, line, `Public mutable property '${name}' - consider private(set)`);
     }
 }
 
 function analyzeClosuresAST(analyzer, filePath) {
+    const isStruct = analyzer.structs.length > 0;
+
     for (const closure of analyzer.closures) {
         const closureText = analyzer.safeStringify(closure);
         const hasSelfReference = closureText.includes('"self"') || closureText.includes('key.name":"self');
@@ -471,10 +505,16 @@ function analyzeClosuresAST(analyzer, filePath) {
         const parentFunc = closure._parent;
         const isEscaping = parentFunc && (parentFunc['key.typename'] || '').includes('@escaping');
 
-        if (hasSelfReference && isEscaping) {
-            const hasWeakCapture = closureText.includes('weak') || closureText.includes('unowned');
+        if (hasSelfReference && isEscaping && !isStruct) {
+            const offset = closure['key.offset'] || 0;
+            const length = closure['key.length'] || 100;
+            const closureCode = (analyzer.fileContent || '').substring(offset, offset + length);
 
-            if (!hasWeakCapture) {
+            const hasExplicitSelfInCode = /\bself\b/.test(closureCode);
+            const hasWeakCapture = /\[.*weak.*\]/.test(closureCode) || /\[.*unowned.*\]/.test(closureCode);
+            const hasCaptureListWithoutSelf = /\[[^\]]+\]/.test(closureCode) && !/\[.*self.*\]/.test(closureCode);
+
+            if (hasExplicitSelfInCode && !hasWeakCapture && !hasCaptureListWithoutSelf) {
                 const line = closure['key.line'] || 1;
                 analyzer.pushFinding('ios.memory.missing_weak_self', 'high', filePath, line, 'Escaping closure captures self without [weak self]');
             }
@@ -543,14 +583,27 @@ function analyzeAdditionalRules(analyzer, filePath) {
         analyzer.pushFinding('ios.concurrency.dispatch_queue', 'medium', filePath, line, 'DispatchQueue detected - use async/await in new code');
     }
 
-    if (/Task\s*\{/.test(analyzer.fileContent || '') && !/Task\s*\{[^}]*do\s*\{/.test(analyzer.fileContent || '')) {
-        const line = analyzer.findLineNumber('Task {');
-        analyzer.pushFinding('ios.concurrency.task_no_error_handling', 'high', filePath, line, 'Task without do-catch - handle errors');
-    }
+    const taskMatches = [...(analyzer.fileContent || '').matchAll(/Task\s*\{([^}]*(?:\{[^}]*\}[^}]*)*)\}/gs)];
+    taskMatches.forEach(match => {
+        const taskBody = match[1] || '';
+        const hasTryCall = /\btry\s+/.test(taskBody);
+        const hasDoBlock = /\bdo\s*\{/.test(taskBody);
 
-    if ((analyzer.fileContent || '').includes('UserDefaults') && /password|token|secret|key/i.test(analyzer.fileContent || '')) {
-        const line = analyzer.findLineNumber('UserDefaults');
-        analyzer.pushFinding('ios.security.sensitive_userdefaults', 'critical', filePath, line, 'Sensitive data in UserDefaults - use Keychain');
+        if (hasTryCall && !hasDoBlock) {
+            const line = analyzer.findLineNumber(match[0].substring(0, 20));
+            analyzer.pushFinding('ios.concurrency.task_no_error_handling', 'high', filePath, line, 'Task with throwing calls (try) without do-catch - handle errors');
+        }
+    });
+
+    if ((analyzer.fileContent || '').includes('UserDefaults')) {
+        const content = analyzer.fileContent || '';
+        const hasSensitiveData = /UserDefaults.*\.set.*\b(password|token|secret|apiKey|authToken|accessToken|refreshToken)\b/i.test(content) ||
+            /\.set.*\b(password|token|secret|apiKey|authToken|accessToken|refreshToken)\b.*UserDefaults/i.test(content);
+
+        if (hasSensitiveData) {
+            const line = analyzer.findLineNumber('UserDefaults');
+            analyzer.pushFinding('ios.security.sensitive_userdefaults', 'critical', filePath, line, 'Sensitive credentials in UserDefaults - use Keychain for passwords/tokens');
+        }
     }
 
     const hardcodedStrings = (analyzer.fileContent || '').match(/Text\s*\(\s*"[^"]{10,}"\s*\)/g) || [];
@@ -686,15 +739,35 @@ function countStatementsOfType(substructure, stmtType) {
     let count = 0;
     const traverse = (nodes) => {
         if (!Array.isArray(nodes)) return;
-        for (const node of nodes) {
-            if ((node['key.kind'] || '').includes(stmtType)) count++;
-            traverse(node['key.substructure'] || []);
+        for (const n of nodes) {
+            if ((n['key.kind'] || '').includes(stmtType)) count++;
+            traverse(n['key.substructure']);
         }
     };
     traverse(substructure);
     return count;
 }
 
+function calculateNestingDepth(substructure) {
+    let maxDepth = 0;
+    const traverse = (nodes, currentDepth) => {
+        if (!Array.isArray(nodes)) return;
+        for (const n of nodes) {
+            const kind = n['key.kind'] || '';
+            let depth = currentDepth;
+
+            if (kind.includes('stmt.if') || kind.includes('stmt.guard') || kind.includes('stmt.for') || kind.includes('stmt.while')) {
+                depth++;
+                maxDepth = Math.max(maxDepth, depth);
+            }
+
+            traverse(n['key.substructure'], depth);
+        }
+    };
+    traverse(substructure, 0);
+    return maxDepth;
+}
+
 async function checkDependencyInjectionAST(analyzer, properties, filePath, className, line) {
     await diValidationService.validateDependencyInjection(analyzer, properties, filePath, className, line);
 }
@@ -802,10 +875,18 @@ function finalizeGodClassDetection(analyzer) {
 
         const signalCount = [sizeOutlier, complexityOutlier].filter(Boolean).length;
 
-        if (extremeOutlier || signalCount >= 2) {
+        const isTestDouble = /Spy$|Mock$|Stub$|Fake$|Dummy$/i.test(c.name) ||
+            c.filePath.includes('Test') && /Double|Spy|Mock|Stub/i.test(c.name);
+
+        if ((extremeOutlier || signalCount >= 2) && !isTestDouble) {
+            const severity = resolveSrpSeverity(c.filePath, {
+                coreSeverity: 'critical',
+                defaultSeverity: 'high',
+                testSeverity: 'low',
+            });
             analyzer.pushFinding(
                 'ios.solid.srp.god_class',
-                'critical',
+                severity,
                 c.filePath,
                 c.line,
                 `God class '${c.name}': ${c.methodsCount} methods (z=${methodsZ.toFixed(2)}), ${c.propertiesCount} properties (z=${propsZ.toFixed(2)}), body ${c.bodyLength} (z=${bodyZ.toFixed(2)}), complexity ${c.complexity} (z=${complexityZ.toFixed(2)}) - VIOLATES SRP`

package/scripts/hooks-system/infrastructure/ast/ios/parsers/SourceKittenExtractor.js

@@ -119,14 +119,19 @@ class SourceKittenExtractor {
         const forceUnwraps = [];
         const lines = (fileContent || '').split('\n');
         lines.forEach((line, index) => {
-            const matches = [...line.matchAll(/(\w+)\s*!/g)];
+            const matches = [...line.matchAll(/(\w+)!/g)];
             matches.forEach(match => {
-                forceUnwraps.push({
-                    line: index + 1,
-                    column: match.index + 1,
-                    variable: match[1],
-                    context: line.trim(),
-                });
+                const charBefore = match.index > 0 ? line[match.index - 1] : '';
+                const isLogicalNegation = charBefore === '!' || /[&|=<>]/.test(charBefore);
+
+                if (!isLogicalNegation) {
+                    forceUnwraps.push({
+                        line: index + 1,
+                        column: match.index + 1,
+                        variable: match[1],
+                        context: line.trim(),
+                    });
+                }
             });
         });
         return forceUnwraps;

package/scripts/hooks-system/infrastructure/ast/ios/utils/ios-srp-helpers.js

@@ -0,0 +1,162 @@
+function resolveSrpSeverity(filePath, { coreSeverity, defaultSeverity, testSeverity }) {
+  const normalized = String(filePath || '').replace(/\\/g, '/');
+  const isTest = /Tests|Test|Spec/.test(normalized);
+  if (isTest) return testSeverity || defaultSeverity;
+  const isCore = normalized.includes('/Domain/') || normalized.includes('/Application/');
+  if (isCore) return coreSeverity || defaultSeverity;
+  return defaultSeverity;
+}
+
+function findMatchingBraceIndex(content, startIndex) {
+  let depth = 0;
+  let inString = false;
+  let stringChar = '';
+  let inLineComment = false;
+  let inBlockComment = false;
+
+  for (let i = startIndex; i < content.length; i += 1) {
+    const current = content[i];
+    const next = content[i + 1];
+
+    if (inLineComment) {
+      if (current === '\n') inLineComment = false;
+      continue;
+    }
+
+    if (inBlockComment) {
+      if (current === '*' && next === '/') {
+        inBlockComment = false;
+        i += 1;
+      }
+      continue;
+    }
+
+    if (inString) {
+      if (current === '\\') {
+        i += 1;
+        continue;
+      }
+      if (current === stringChar) {
+        inString = false;
+      }
+      continue;
+    }
+
+    if (current === '/' && next === '/') {
+      inLineComment = true;
+      i += 1;
+      continue;
+    }
+
+    if (current === '/' && next === '*') {
+      inBlockComment = true;
+      i += 1;
+      continue;
+    }
+
+    if (current === '"' || current === "'") {
+      inString = true;
+      stringChar = current;
+      continue;
+    }
+
+    if (current === '{') depth += 1;
+    if (current === '}') {
+      depth -= 1;
+      if (depth === 0) return i;
+    }
+  }
+
+  return -1;
+}
+
+function extractSwiftTypeBlocks(content) {
+  const blocks = [];
+  const pattern = /(^|\n)\s*(?:public|internal|fileprivate|private|open)?\s*(?:final\s+)?(class|struct|enum|protocol)\s+([A-Za-z_][A-Za-z0-9_]*)[^\n{]*\{/g;
+  let match = pattern.exec(content);
+  while (match) {
+    const name = match[3];
+    const braceIndex = match.index + match[0].lastIndexOf('{');
+    const endIndex = findMatchingBraceIndex(content, braceIndex);
+    if (endIndex !== -1) {
+      blocks.push({
+        name,
+        openIndex: braceIndex,
+        closeIndex: endIndex,
+        body: content.slice(braceIndex + 1, endIndex)
+      });
+      pattern.lastIndex = endIndex + 1;
+    }
+    match = pattern.exec(content);
+  }
+  return blocks;
+}
+
+function stripNestedTypeBlocks(content) {
+  const nestedBlocks = extractSwiftTypeBlocks(content);
+  if (nestedBlocks.length === 0) return content;
+  const sorted = nestedBlocks.slice().sort((a, b) => b.openIndex - a.openIndex);
+  let output = content;
+  for (const block of sorted) {
+    const length = block.closeIndex - block.openIndex + 1;
+    output = `${output.slice(0, block.openIndex)}${' '.repeat(length)}${output.slice(block.closeIndex + 1)}`;
+  }
+  return output;
+}
+
+function countFunctions(content) {
+  const matches = content.match(/\bfunc\s+[A-Za-z_][A-Za-z0-9_]*/g) || [];
+  return matches.length;
+}
+
+function countProperties(content) {
+  const matches = content.match(/(^|\n)\s*(?:@[A-Za-z0-9_.]+\s*)*(var|let)\s+[A-Za-z_][A-Za-z0-9_]*/g) || [];
+  return matches.length;
+}
+
+function splitTypeName(name) {
+  return String(name).match(/[A-Z]+(?![a-z])|[A-Z]?[a-z]+|[0-9]+/g) || [name];
+}
+
+function getTypeGroupKey(name) {
+  const parts = splitTypeName(name);
+  return parts[0] || name;
+}
+
+function summarizeSwiftTypes(content) {
+  const blocks = extractSwiftTypeBlocks(String(content || ''));
+  return blocks.map((block) => {
+    const sanitizedBody = stripNestedTypeBlocks(block.body);
+    return {
+      name: block.name,
+      methodsCount: countFunctions(sanitizedBody),
+      propertiesCount: countProperties(sanitizedBody),
+      groupKey: getTypeGroupKey(block.name)
+    };
+  });
+}
+
+function evaluateMultipleTypeGroups(summaries) {
+  const groups = new Set((summaries || []).map((item) => item.groupKey).filter(Boolean));
+  const totalTypes = (summaries || []).length;
+  const distinctGroups = groups.size;
+  const shouldFlag = totalTypes >= 3 && distinctGroups >= 2;
+  return {
+    totalTypes,
+    distinctGroups,
+    shouldFlag,
+    groups: Array.from(groups)
+  };
+}
+
+function isThinWrapperSummary(summary) {
+  if (!summary) return false;
+  return summary.methodsCount === 0 && summary.propertiesCount <= 1;
+}
+
+module.exports = {
+  summarizeSwiftTypes,
+  evaluateMultipleTypeGroups,
+  resolveSrpSeverity,
+  isThinWrapperSummary
+};

package/scripts/hooks-system/infrastructure/severity/policies/gate-policies.js

@@ -27,8 +27,11 @@ class GatePolicies {
       LOW: this.checkLevel('LOW', grouped.LOW || [], effectivePolicies.LOW || effectivePolicies['LOW'])
     };
 
-    const passed = !results.CRITICAL.failed && !results.HIGH.failed;
-    const blockedBy = results.CRITICAL.failed ? 'CRITICAL' : (results.HIGH.failed ? 'HIGH' : null);
+    const passed = !results.CRITICAL.failed && !results.HIGH.failed && !results.MEDIUM.failed && !results.LOW.failed;
+    const blockedBy = results.CRITICAL.failed ? 'CRITICAL' :
+      (results.HIGH.failed ? 'HIGH' :
+        (results.MEDIUM.failed ? 'MEDIUM' :
+          (results.LOW.failed ? 'LOW' : null)));
 
     return {
       passed,

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

@@ -62,6 +62,15 @@ evidence_age() {
 ensure_evidence_fresh() {
   local age
   age=$(evidence_age)
+  
+  # En modo check (pre-commit), SIEMPRE refrescar para analizar staged files
+  if [[ "${GITFLOW_STRICT_CHECK:-false}" == "true" ]]; then
+    printf "${CYAN}🔄 Refrescando evidencia para staged files...${NC}\n"
+    refresh_evidence "pre-commit"
+    return
+  fi
+  
+  # En otros modos, usar umbral de tiempo
   if [[ "$age" == "-1" ]]; then
     printf "${YELLOW}⚠️  Evidencia ausente o inválida. Refrescando...${NC}\n"
     refresh_evidence "missing"

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

@@ -142,3 +142,9 @@
 {"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)"}}
+{"timestamp":"2026-01-21T14:19:16.416Z","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:19:16.417Z","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:19:16.418Z","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:43:17.747Z","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:43:17.748Z","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:43:17.749Z","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)"}}