pumuki-ast-hooks 5.6.10 → 5.6.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "5.6.10",
+  "version": "5.6.12",
   "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": {
@@ -116,6 +116,7 @@
     "skills/",
     "hooks/",
     "docs/",
+    "assets/",
     "index.js",
     "README.md",
     "LICENSE"

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

@@ -8,3 +8,4 @@
 {"timestamp":"2026-01-11T18:44:21.682Z","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-11T18:48:20.329Z","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-11T18:54:50.282Z","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-11T19:08:34.232Z","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

@@ -38,3 +38,7 @@
 {"timestamp":"2026-01-11T18:54:50.515Z","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-11T18:54:50.515Z","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-11T18:54:50.515Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-11T19:08:34.068Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-11T19:08:34.083Z","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-11T19:08:34.083Z","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-11T19:08:34.083Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}

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

@@ -470,3 +470,35 @@
 {"timestamp":1768157690281,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
 {"timestamp":1768157690281,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
 {"timestamp":1768157690281,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768157973980,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768157973980,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768157973980,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768157973980,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514228,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158514229,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514230,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158514231,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158514231,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514231,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158514231,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158514231,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158514232,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158974401,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768158974401,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768158974401,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768158974402,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}

package/scripts/hooks-system/application/services/installation/VSCodeTaskConfigurator.js

@@ -61,25 +61,11 @@ class VSCodeTaskConfigurator {
                 args: [
                     '-lc',
                     [
-                        'ROOT="${workspaceFolder}"',
-                        'PRIMARY="$ROOT/scripts/hooks-system/bin/session-loader.sh"',
-                        'FALLBACK="$ROOT/node_modules/pumuki-ast-hooks/scripts/hooks-system/bin/session-loader.sh"',
-                        'FALLBACK2="$ROOT/node_modules/@pumuki/ast-intelligence-hooks/bin/session-loader.sh"',
-                        'if [ -f "$PRIMARY" ]; then',
-                        '  exec bash "$PRIMARY"',
-                        'elif [ -f "$FALLBACK" ]; then',
-                        '  exec bash "$FALLBACK"',
-                        'elif [ -f "$FALLBACK2" ]; then',
-                        '  exec bash "$FALLBACK2"',
-                        'else',
-                        '  echo "AST Session Loader not found." >&2',
-                        '  echo "Tried:" >&2',
-                        '  echo "  - $PRIMARY" >&2',
-                        '  echo "  - $FALLBACK" >&2',
-                        '  echo "  - $FALLBACK2" >&2',
-                        '  exit 127',
-                        'fi'
-                    ].join('\n')
+                        'bash "${workspaceFolder}/scripts/hooks-system/bin/session-loader.sh"',
+                        '|| bash "${workspaceFolder}/node_modules/pumuki-ast-hooks/scripts/hooks-system/bin/session-loader.sh"',
+                        '|| bash "${workspaceFolder}/node_modules/@pumuki/ast-intelligence-hooks/bin/session-loader.sh"',
+                        '|| (echo "AST Session Loader not found." >&2; exit 127)'
+                    ].join(' ')
                 ],
                 problemMatcher: [],
                 runOptions: {

package/scripts/hooks-system/application/services/installation/__tests__/VSCodeTaskConfigurator.spec.js

@@ -0,0 +1,38 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const VSCodeTaskConfigurator = require('../VSCodeTaskConfigurator');
+
+describe('VSCodeTaskConfigurator', () => {
+    let testRoot;
+
+    beforeEach(() => {
+        testRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'ast-hooks-vscode-task-'));
+    });
+
+    afterEach(() => {
+        if (testRoot && fs.existsSync(testRoot)) {
+            fs.rmSync(testRoot, { recursive: true, force: true });
+        }
+    });
+
+    it('should generate AST Session Loader task with a short command (no multiline bash -lc script)', () => {
+        const configurator = new VSCodeTaskConfigurator(testRoot, null);
+        configurator.configure();
+
+        const tasksJsonPath = path.join(testRoot, '.vscode', 'tasks.json');
+        expect(fs.existsSync(tasksJsonPath)).toBe(true);
+
+        const tasksJson = JSON.parse(fs.readFileSync(tasksJsonPath, 'utf8'));
+        const task = tasksJson.tasks.find(t => t.label === 'AST Session Loader' || t.identifier === 'ast-session-loader');
+        expect(task).toBeTruthy();
+
+        expect(task.command).toBe('bash');
+        expect(Array.isArray(task.args)).toBe(true);
+
+        // Current implementation embeds a multi-line script in args[1] (very noisy in terminal as "Executing task: ...")
+        // We want a single-line command.
+        expect(String(task.args[1] || '')).not.toContain('\n');
+    });
+});

package/scripts/hooks-system/bin/__tests__/session-loader.spec.js

@@ -0,0 +1,14 @@
+const fs = require('fs');
+const path = require('path');
+
+describe('session-loader.sh', () => {
+    it('should not hardcode the displayed version header', () => {
+        const filePath = path.join(__dirname, '..', 'session-loader.sh');
+        const content = fs.readFileSync(filePath, 'utf8');
+
+        expect(content).not.toContain('AST Intelligence Hooks v5.5.22');
+        expect(content).toMatch(/\bVERSION=/);
+        expect(content).toContain('package.json');
+        expect(content).toMatch(/AST Intelligence Hooks v\$VERSION/);
+    });
+});

package/scripts/hooks-system/bin/session-loader.sh

@@ -3,6 +3,8 @@
 # Runs on IDE startup to initialize AST hooks, show context and check tokens
 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
 
+VERSION=$(node -p "require('${REPO_ROOT}/package.json').version" 2>/dev/null || echo "unknown")
+
 BLUE='\033[0;34m'
 CYAN='\033[0;36m'
 GREEN='\033[0;32m'
@@ -22,7 +24,7 @@ fi
 
 echo ""
 echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║         🤖 AST Intelligence Hooks v5.5.22                ║${NC}"
+echo -e "${BLUE}║         🤖 AST Intelligence Hooks v$VERSION                ║${NC}"
 echo -e "${BLUE}║         Workspace Opened - Loading Context...            ║${NC}"
 echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
 echo ""

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

@@ -2,6 +2,7 @@ jest.mock('../BDDTDDWorkflowRules', () => ({
   BDDTDDWorkflowRules: jest.fn().mockImplementation(() => ({ analyze: jest.fn() }))
 }));
 
+const fs = require('fs');
 const { Project } = require('../../ast-core');
 const { runCommonIntelligence } = require('../ast-common');
 
@@ -28,6 +29,35 @@ describe('AST Common Module', () => {
       expect(findings.some(f => f.ruleId === 'common.testing.missing_makesut')).toBe(false);
       expect(findings.some(f => f.ruleId === 'common.testing.missing_track_for_memory_leaks')).toBe(false);
     });
+
+    it('does not report false positives for Swift test files when getFullText is empty (fallback to disk)', () => {
+      const project = new Project({
+        useInMemoryFileSystem: true,
+        skipAddingFilesFromTsConfig: true,
+      });
+
+      const swiftPath = '/tmp/FooTests.spec.swift';
+      const swiftContent = [
+        'import XCTest',
+        'final class FooTests: XCTestCase {',
+        '  private func makeSUT() -> Foo { Foo() }',
+        '  func test_example() {',
+        '    let sut = makeSUT()',
+        '    trackForMemoryLeaks(sut, testCase: self, file: #file, line: #line)',
+        '  }',
+        '}',
+      ].join('\n');
+
+      const sf = project.createSourceFile(swiftPath, swiftContent);
+      jest.spyOn(sf, 'getFullText').mockReturnValue('');
+      jest.spyOn(fs, 'readFileSync').mockReturnValue(swiftContent);
+
+      const findings = [];
+      runCommonIntelligence(project, findings);
+
+      expect(findings.some(f => f.ruleId === 'common.testing.missing_makesut')).toBe(false);
+      expect(findings.some(f => f.ruleId === 'common.testing.missing_track_for_memory_leaks')).toBe(false);
+    });
   });
 
   describe('exports', () => {

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

@@ -1,4 +1,5 @@
 const path = require('path');
+const fs = require('fs');
 const { pushFinding, SyntaxKind, platformOf, getRepoRoot } = require(path.join(__dirname, '../ast-core'));
 const { BDDTDDWorkflowRules } = require(path.join(__dirname, 'BDDTDDWorkflowRules'));
 
@@ -208,11 +209,21 @@ function runCommonIntelligence(project, findings) {
     if (/\/ast-(?:backend|frontend|android|ios|common|core|intelligence)\.js$/.test(filePath)) return;
 
     if (isTestFilePath(filePath)) {
-      const content = sf.getFullText();
+      let content = sf.getFullText();
 
       const ext = path.extname(filePath).toLowerCase();
       const isSwiftOrKotlinTest = ext === '.swift' || ext === '.kt' || ext === '.kts';
 
+      if (isSwiftOrKotlinTest && (!content || content.trim().length === 0)) {
+        try {
+          content = fs.readFileSync(filePath, 'utf8');
+        } catch (error) {
+          if (process.env.DEBUG) {
+            console.debug(`[ast-common] Failed to read test file content for ${filePath}: ${error.message}`);
+          }
+        }
+      }
+
       if (isSwiftOrKotlinTest) {
         if (!shouldSkipMakeSUTRule(filePath) && !hasMakeSUT(content)) {
           pushFinding(

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

@@ -22,3 +22,6 @@
 {"timestamp":"2026-01-11T18:54:53.862Z","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-11T18:54:53.871Z","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-11T18:54:53.873Z","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-11T19:08:37.452Z","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-11T19:08:37.467Z","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-11T19:08:37.468Z","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)"}}