pumuki-ast-hooks 6.1.11 → 6.1.13

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/package.json

@@ -1,25 +1,25 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.11",
+  "version": "6.1.13",
   "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/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;
@@ -1134,29 +1135,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();
 
@@ -168,16 +169,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')) {
@@ -803,9 +810,14 @@ function finalizeGodClassDetection(analyzer) {
         const signalCount = [sizeOutlier, complexityOutlier].filter(Boolean).length;
 
         if (extremeOutlier || signalCount >= 2) {
+            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/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/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)"}}