pumuki-ast-hooks 5.3.6 → 5.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "5.3.6",
+  "version": "5.3.8",
   "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/.AI_TOKEN_STATUS.txt

@@ -12,5 +12,5 @@ Source: file
 
 ℹ️  Data is stale. Ensure guards are running and refreshing token usage.
 
-Last updated: 2025-12-29T16:15:44.360Z
+Last updated: 2025-12-29T16:45:45.428Z
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

package/scripts/hooks-system/.audit-reports/notifications.log

@@ -526,3 +526,13 @@
 {"timestamp":"2025-12-29T16:09:44.150Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"46322b8d-19ff-4888-8ce9-d901a54191d4","type":"token_ok"},"context":{}}
 {"timestamp":"2025-12-29T16:12:44.258Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"eac1ff0f-5133-41b1-a324-40c38c8b8f02","type":"token_ok"},"context":{}}
 {"timestamp":"2025-12-29T16:15:44.361Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"b013b103-7ea4-4f60-aebd-e9c0b4f21438","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:18:44.475Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"adfff9a0-05b6-495e-ae81-38855a5dca1a","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:21:44.578Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"c252550d-1535-4f24-be5f-fe09722460df","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:24:44.692Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"06440138-fee0-484f-804c-dee11c93267f","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:27:44.777Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"4d383913-396e-47d2-8e63-0fdc1065870c","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:30:44.889Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"6107b078-cca4-4c2c-b81e-81ac891c5373","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:33:45.003Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"e8722220-25f5-45a3-90ff-5f8d7a288d50","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:36:45.100Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"57eedfdf-21d0-4371-970d-4baae6b3a1ce","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:39:45.200Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"93142073-89d9-4c17-9152-6bf6ce181423","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:42:45.315Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"3eea7b8e-8d7a-41c7-a6a2-a2576ca928d5","type":"token_ok"},"context":{}}
+{"timestamp":"2025-12-29T16:45:45.428Z","level":"debug","component":"NotificationCenter","event":"Notification enqueued","data":{"id":"4d18abda-f1d8-4f81-aeb5-f9a2d40b240f","type":"token_ok"},"context":{}}

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

@@ -1582,3 +1582,33 @@
 {"timestamp":"2025-12-29T16:15:44.350Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
 {"timestamp":"2025-12-29T16:15:44.351Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
 {"timestamp":"2025-12-29T16:15:44.362Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:18:44.466Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:18:44.467Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:18:44.476Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:21:44.567Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:21:44.568Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:21:44.579Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:24:44.682Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:24:44.683Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:24:44.692Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:27:44.767Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:27:44.768Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:27:44.777Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:30:44.879Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:30:44.879Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:30:44.890Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:33:44.993Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:33:44.994Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:33:45.003Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:36:45.089Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:36:45.090Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:36:45.100Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:39:45.188Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:39:45.190Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:39:45.200Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:42:45.305Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:42:45.306Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:42:45.315Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}
+{"timestamp":"2025-12-29T16:45:45.419Z","level":"debug","component":"TokenMonitor","event":"CURSOR_SERVICE_USING_FILE","data":{"usage":{"tokensUsed":0,"maxTokens":1000000,"percentUsed":72.36585,"timestamp":"2025-12-29T15:38:11.174Z","source":"file","untrusted":false}},"context":{}}
+{"timestamp":"2025-12-29T16:45:45.420Z","level":"debug","component":"TokenMonitor","event":"TOKEN_MONITOR_METRICS","data":{"timestamp":"2025-12-29T15:38:11.174Z","tokensUsed":0,"maxTokens":1000000,"percentUsed":0,"remainingTokens":1000000,"level":"ok","source":"file","stale":true,"untrusted":false},"context":{}}
+{"timestamp":"2025-12-29T16:45:45.429Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":0,"tokensUsed":0,"maxTokens":1000000,"source":"file","stale":true,"untrusted":false},"context":{"message":"Result level=ok percent=0% used=0/1000000 source=file (stale)"}}

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

@@ -3,93 +3,94 @@ const path = require('path');
 const { execSync, spawnSync } = require('child_process');
 
 const COLORS = {
-    reset: '\x1b[0m',
-    blue: '\x1b[34m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    red: '\x1b[31m',
-    cyan: '\x1b[36m'
+  reset: '\x1b[0m',
+  blue: '\x1b[34m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m'
 };
 
 class GitEnvironmentService {
-    constructor(targetRoot) {
-        this.targetRoot = targetRoot || process.cwd();
+  constructor(targetRoot, version = 'unknown') {
+    this.targetRoot = targetRoot || process.cwd();
+    this.version = version;
+  }
+
+  checkGitRepository() {
+    const gitDir = path.join(this.targetRoot, '.git');
+    if (!fs.existsSync(gitDir)) {
+      this.logError('❌ CRITICAL: Git repository not found!');
+      this.logWarning('   This library REQUIRES a Git repository to function properly.');
+      this.logInfo('   Please run: git init\n');
+      this.logWarning('⚠️  Without Git:');
+      this.logInfo('   • Pre-commit hooks cannot be installed');
+      this.logInfo('   • Git Flow automation will not work');
+      this.logInfo('   • Code analysis on commits is disabled\n');
+      return false;
     }
 
-    checkGitRepository() {
-        const gitDir = path.join(this.targetRoot, '.git');
-        if (!fs.existsSync(gitDir)) {
-            this.logError('❌ CRITICAL: Git repository not found!');
-            this.logWarning('   This library REQUIRES a Git repository to function properly.');
-            this.logInfo('   Please run: git init\n');
-            this.logWarning('⚠️  Without Git:');
-            this.logInfo('   • Pre-commit hooks cannot be installed');
-            this.logInfo('   • Git Flow automation will not work');
-            this.logInfo('   • Code analysis on commits is disabled\n');
-            return false;
-        }
-
-        try {
-            execSync('git rev-parse --show-toplevel', {
-                cwd: this.targetRoot,
-                stdio: 'ignore'
-            });
-            return true;
-        } catch (err) {
-            this.logError('❌ Git repository is not properly initialized!');
-            this.logWarning('   Found .git directory but git commands fail.');
-            this.logInfo('   Please ensure Git is installed and working.\n');
-            return false;
-        }
+    try {
+      execSync('git rev-parse --show-toplevel', {
+        cwd: this.targetRoot,
+        stdio: 'ignore'
+      });
+      return true;
+    } catch (err) {
+      this.logError('❌ Git repository is not properly initialized!');
+      this.logWarning('   Found .git directory but git commands fail.');
+      this.logInfo('   Please ensure Git is installed and working.\n');
+      return false;
     }
-
-    ensureGitInfoExclude() {
-        const gitDir = path.join(this.targetRoot, '.git');
-        if (!fs.existsSync(gitDir)) return;
-
-        const excludePath = path.join(gitDir, 'info', 'exclude');
-        fs.mkdirSync(path.dirname(excludePath), { recursive: true });
-
-        const header = '# AST Intelligence Hooks (generated artifacts)';
-        const patterns = [
-            '.AI_TOKEN_STATUS.txt',
-            '.audit-reports/*.log',
-            '.realtime-guard.pid',
-            '.token-monitor-guard.pid'
-        ];
-
-        let existing = '';
-        if (fs.existsSync(excludePath)) {
-            existing = fs.readFileSync(excludePath, 'utf8');
-            if (existing.includes(header)) return;
-        }
-
-        const block = '\n' + header + '\n' + patterns.join('\n') + '\n';
-        fs.appendFileSync(excludePath, block);
-        this.logSuccess('  ✅ Added artifact patterns to .git/info/exclude');
+  }
+
+  ensureGitInfoExclude() {
+    const gitDir = path.join(this.targetRoot, '.git');
+    if (!fs.existsSync(gitDir)) return;
+
+    const excludePath = path.join(gitDir, 'info', 'exclude');
+    fs.mkdirSync(path.dirname(excludePath), { recursive: true });
+
+    const header = '# AST Intelligence Hooks (generated artifacts)';
+    const patterns = [
+      '.AI_TOKEN_STATUS.txt',
+      '.audit-reports/*.log',
+      '.realtime-guard.pid',
+      '.token-monitor-guard.pid'
+    ];
+
+    let existing = '';
+    if (fs.existsSync(excludePath)) {
+      existing = fs.readFileSync(excludePath, 'utf8');
+      if (existing.includes(header)) return;
     }
 
-    installGitHooks() {
-        const gitHooksDir = path.join(this.targetRoot, '.git/hooks');
-
-        if (!fs.existsSync(gitHooksDir)) {
-            this.logError('✗ .git/hooks directory not found');
-            this.logWarning('  Git hooks cannot be installed without a valid Git repository.');
-            return;
-        }
+    const block = '\n' + header + '\n' + patterns.join('\n') + '\n';
+    fs.appendFileSync(excludePath, block);
+    this.logSuccess('  ✅ Added artifact patterns to .git/info/exclude');
+  }
 
-        const preCommitHook = this.getPreCommitHookContent();
-        const preCommitPath = path.join(gitHooksDir, 'pre-commit');
+  installGitHooks() {
+    const gitHooksDir = path.join(this.targetRoot, '.git/hooks');
 
-        fs.writeFileSync(preCommitPath, preCommitHook);
-        fs.chmodSync(preCommitPath, '755');
-        this.logSuccess('  ✅ Installed pre-commit hook');
+    if (!fs.existsSync(gitHooksDir)) {
+      this.logError('✗ .git/hooks directory not found');
+      this.logWarning('  Git hooks cannot be installed without a valid Git repository.');
+      return;
     }
 
-    getPreCommitHookContent() {
-        return `#!/bin/bash
+    const preCommitHook = this.getPreCommitHookContent();
+    const preCommitPath = path.join(gitHooksDir, 'pre-commit');
+
+    fs.writeFileSync(preCommitPath, preCommitHook);
+    fs.chmodSync(preCommitPath, '755');
+    this.logSuccess('  ✅ Installed pre-commit hook');
+  }
+
+  getPreCommitHookContent() {
+    return `#!/bin/bash
 # AST Intelligence Hooks - Pre-commit
-# Auto-generated by @pumuki/ast-intelligence-hooks v5.3.1
+# Auto-generated by pumuki-ast-hooks v${this.version}
 
 # Check for bypass
 if [[ -n "\${GIT_BYPASS_HOOK}" ]]; then
@@ -155,12 +156,12 @@ fi
 echo "⚠️  ast-intelligence-hooks not found"
 exit 0
 `;
-    }
+  }
 
-    logInfo(msg) { process.stdout.write(`${COLORS.cyan}${msg}${COLORS.reset}\n`); }
-    logSuccess(msg) { process.stdout.write(`${COLORS.green}${msg}${COLORS.reset}\n`); }
-    logWarning(msg) { process.stdout.write(`${COLORS.yellow}${msg}${COLORS.reset}\n`); }
-    logError(msg) { process.stdout.write(`${COLORS.red}${msg}${COLORS.reset}\n`); }
+  logInfo(msg) { process.stdout.write(`${COLORS.cyan}${msg}${COLORS.reset}\n`); }
+  logSuccess(msg) { process.stdout.write(`${COLORS.green}${msg}${COLORS.reset}\n`); }
+  logWarning(msg) { process.stdout.write(`${COLORS.yellow}${msg}${COLORS.reset}\n`); }
+  logError(msg) { process.stdout.write(`${COLORS.red}${msg}${COLORS.reset}\n`); }
 }
 
 module.exports = GitEnvironmentService;

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

@@ -23,6 +23,15 @@ class InstallService {
         // Assuming this script is located at scripts/hooks-system/application/services/installation/InstallService.js
         this.hookSystemRoot = path.resolve(__dirname, '../../../');
 
+        // Read version dynamically from package.json
+        const packageJsonPath = path.resolve(this.hookSystemRoot, '../package.json');
+        try {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            this.version = pkg.version || 'unknown';
+        } catch {
+            this.version = 'unknown';
+        }
+
         // Initialize Audit Logger
         const auditLogPath = path.join(this.targetRoot, '.audit-reports', 'install.log');
         if (!fs.existsSync(path.dirname(auditLogPath))) {
@@ -39,7 +48,7 @@ class InstallService {
             }
         });
 
-        this.gitService = new GitEnvironmentService(this.targetRoot);
+        this.gitService = new GitEnvironmentService(this.targetRoot, this.version);
         this.platformService = new PlatformDetectorService(this.targetRoot);
         this.fsInstaller = new FileSystemInstallerService(this.targetRoot, this.hookSystemRoot, this.logger);
         this.configGenerator = new ConfigurationGeneratorService(this.targetRoot, this.hookSystemRoot);
@@ -98,10 +107,11 @@ class InstallService {
     }
 
     printHeader() {
+        const versionPadded = `v${this.version}`.padStart(24).padEnd(48);
         process.stdout.write(`${COLORS.blue}
 ╔════════════════════════════════════════════════════════════════╗
 ║          AST Intelligence Hooks - Installation Wizard          ║
-║                         v5.3.1                                 ║
+║${versionPadded}                                                ║
 ╚════════════════════════════════════════════════════════════════╝
 ${COLORS.reset}\n`);
     }

package/scripts/hooks-system/infrastructure/shell/orchestrators/audit-orchestrator.sh

@@ -56,7 +56,13 @@ source "$INFRASTRUCTURE_DIR/eslint/eslint-integration.sh"
 
 # Initialize
 START_TIME=$(date +%s)
-ROOT_DIR=$(pwd)
+
+# Determine repository root using git
+if command -v git >/dev/null 2>&1; then
+  ROOT_DIR=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+else
+  ROOT_DIR=$(pwd)
+fi
 
 # Default to temp directories to avoid polluting repositories.
 # Can be overridden by setting AUDIT_TMP / AUDIT_REPORTS.