pumuki-ast-hooks 6.1.0 → 6.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.0",
+  "version": "6.1.1",
   "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": {

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

@@ -28,3 +28,5 @@
 {"timestamp":"2026-01-13T13:58:43.218Z","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-13T17:20:09.962Z","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-13T17:21:43.217Z","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-13T17:53:22.925Z","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-13T17:54:11.574Z","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

@@ -122,3 +122,11 @@
 {"timestamp":"2026-01-13T17:21:43.143Z","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-13T17:21:43.143Z","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-13T17:21:43.143Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-13T17:53:22.813Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-13T17:53:22.821Z","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-13T17:53:22.821Z","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-13T17:53:22.821Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-13T17:54:11.669Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-13T17:54:11.678Z","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-13T17:54:11.678Z","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-13T17:54:11.679Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}

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

@@ -986,3 +986,51 @@
 {"timestamp":1768324903217,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
 {"timestamp":1768324903217,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
 {"timestamp":1768324903217,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802923,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326802924,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326802925,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851571,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851573,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326851573,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326851573,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768326851574,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}

package/scripts/hooks-system/infrastructure/ast/backend/__tests__/god-class-detector.spec.js

@@ -0,0 +1,93 @@
+const { analyzeGodClasses } = require('../detectors/god-class-detector');
+
+describe('god-class-detector', () => {
+    const SyntaxKind = {
+        ClassDeclaration: 'ClassDeclaration',
+        IfStatement: 'IfStatement',
+        ForStatement: 'ForStatement',
+        ForInStatement: 'ForInStatement',
+        ForOfStatement: 'ForOfStatement',
+        WhileStatement: 'WhileStatement',
+        DoStatement: 'DoStatement',
+        SwitchStatement: 'SwitchStatement',
+        ConditionalExpression: 'ConditionalExpression',
+        TryStatement: 'TryStatement',
+        CatchClause: 'CatchClause'
+    };
+
+    function createMockClass({
+        name,
+        methodsCount = 0,
+        propertiesCount = 0,
+        startLine = 1,
+        endLine = 1,
+        fullText = '',
+        complexityCounts = {}
+    }) {
+        return {
+            getName: () => name,
+            getMethods: () => Array.from({ length: methodsCount }, () => ({ getName: () => 'm' })),
+            getProperties: () => Array.from({ length: propertiesCount }, () => ({})),
+            getStartLineNumber: () => startLine,
+            getEndLineNumber: () => endLine,
+            getDescendantsOfKind: (kind) => {
+                const count = complexityCounts[kind] ?? 0;
+                return Array.from({ length: count }, () => ({}));
+            },
+            getFullText: () => fullText
+        };
+    }
+
+    function createMockSourceFile({ path, classes }) {
+        return {
+            getFilePath: () => path,
+            getDescendantsOfKind: (kind) => {
+                if (kind !== SyntaxKind.ClassDeclaration) {
+                    return [];
+                }
+                return classes;
+            }
+        };
+    }
+
+    it('does not stop analyzing when first class is a ValueObject/Dto', () => {
+        const dtoClass = createMockClass({
+            name: 'UserDto',
+            startLine: 1,
+            endLine: 10
+        });
+
+        const bigServiceClass = createMockClass({
+            name: 'BigService',
+            methodsCount: 30,
+            propertiesCount: 10,
+            startLine: 11,
+            endLine: 812,
+            complexityCounts: {
+                [SyntaxKind.IfStatement]: 30,
+                [SyntaxKind.ForStatement]: 10,
+                [SyntaxKind.TryStatement]: 5,
+                [SyntaxKind.CatchClause]: 5
+            }
+        });
+
+        const sourceFile = createMockSourceFile({
+            path: '/apps/backend/src/services/auth.service.ts',
+            classes: [dtoClass, bigServiceClass]
+        });
+
+        const pushFinding = jest.fn();
+
+        analyzeGodClasses(sourceFile, [], {
+            SyntaxKind,
+            pushFinding,
+            godClassBaseline: null,
+            hardMaxLines: 200,
+            softMaxLines: 500,
+            absoluteGodLines: 1000,
+            underThresholdLines: 300
+        });
+
+        expect(pushFinding).toHaveBeenCalled();
+    });
+});

package/scripts/hooks-system/infrastructure/ast/backend/detectors/god-class-detector.js

@@ -21,10 +21,12 @@ function analyzeGodClasses(sourceFile, findings, {
         return;
     }
 
-    sourceFile.getDescendantsOfKind(SyntaxKind.ClassDeclaration).forEach((cls) => {
+    const classes = sourceFile.getDescendantsOfKind(SyntaxKind.ClassDeclaration);
+
+    for (const cls of classes) {
         const className = cls.getName() || '';
         const isValueObject = /Metrics|ValueObject|VO$|Dto$|Entity$/.test(className);
-        if (isValueObject) return;
+        if (isValueObject) continue;
 
         const methodsCount = cls.getMethods().length;
         const propertiesCount = cls.getProperties().length;
@@ -70,7 +72,7 @@ function analyzeGodClasses(sourceFile, findings, {
                 `God class detected: ${methodsCount} methods, ${propertiesCount} properties, ${lineCount} lines, complexity ${complexity}, concerns ${concernCount} - VIOLATES SRP`,
                 findings
             );
-            return;
+            continue;
         }
 
         const isMassiveFile = lineCount > softMax;
@@ -88,7 +90,7 @@ function analyzeGodClasses(sourceFile, findings, {
                     findings
                 );
             }
-            return;
+            continue;
         }
 
         const methodsZ = godClassBaseline.robustZ(methodsCount, godClassBaseline.med.methodsCount, godClassBaseline.mad.methodsCount);
@@ -110,13 +112,13 @@ function analyzeGodClasses(sourceFile, findings, {
         if (isMassiveFile) signalCount++;
 
         if (!isUnderThreshold && (signalCount >= 2 || isAbsoluteGod)) {
-            console.error(`[GOD CLASS DEBUG] ${className}: methods=${methodsCount}, props=${propertiesCount}, lines=${lineCount}, complexity=${complexity}, concerns=${concernCount}, isAbsoluteGod=${isAbsoluteGod}, signalCount=${signalCount}`);
+            console.error(`[GOD CLASS DEBUG] ${className}: methods=${methodsCount}, props=${propertiesCount}, lines=${lineCount}, complexity ${complexity}, concerns ${concernCount}, isAbsoluteGod=${isAbsoluteGod}, signalCount=${signalCount}`);
             pushFinding("backend.antipattern.god_classes", "critical", sourceFile, cls,
                 `God class detected: ${methodsCount} methods, ${propertiesCount} properties, ${lineCount} lines, complexity ${complexity}, concerns ${concernCount} - VIOLATES SRP`,
                 findings
             );
         }
-    });
+    }
 }
 
 module.exports = {

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

@@ -88,3 +88,9 @@
 {"timestamp":"2026-01-13T17:21:44.693Z","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-13T17:21:44.695Z","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-13T17:21:44.695Z","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-13T17:53:24.093Z","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-13T17:53:24.094Z","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-13T17:53:24.095Z","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-13T17:54:13.230Z","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-13T17:54:13.231Z","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-13T17:54:13.231Z","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)"}}