pumuki-ast-hooks 5.3.19 → 5.3.21

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

@@ -14,6 +14,50 @@ class HookInstaller {
         };
     }
 
+    getPackageRoot() {
+        let dir = this.hookSystemRoot;
+        for (let i = 0; i < 8; i++) {
+            const pkgJson = path.join(dir, 'package.json');
+            try {
+                if (fs.existsSync(pkgJson) && fs.statSync(pkgJson).isFile()) {
+                    return dir;
+                }
+            } catch (error) {
+                const msg = error && error.message ? error.message : String(error);
+                this.logger?.debug?.('HOOK_INSTALLER_PACKAGE_ROOT_PROBE_ERROR', {
+                    pkgJson,
+                    error: msg
+                });
+            }
+
+            const parent = path.dirname(dir);
+            if (parent === dir) {
+                break;
+            }
+            dir = parent;
+        }
+
+        return path.resolve(this.hookSystemRoot, '..', '..', '..');
+    }
+
+    resolveFirstExistingDir(candidates) {
+        for (const candidate of candidates) {
+            if (!candidate) continue;
+            try {
+                if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+                    return candidate;
+                }
+            } catch (error) {
+                const msg = error && error.message ? error.message : String(error);
+                this.logger?.debug?.('HOOK_INSTALLER_DIR_PROBE_ERROR', {
+                    candidate,
+                    error: msg
+                });
+            }
+        }
+        return null;
+    }
+
     install(platforms) {
         const claudeDir = path.join(this.targetRoot, '.ast-intelligence');
         const claudeSkillsDir = path.join(claudeDir, 'skills');
@@ -31,12 +75,20 @@ class HookInstaller {
     }
 
     installSkills(claudeSkillsDir, platforms) {
-        const librarySkillsDir = path.join(this.hookSystemRoot, 'skills');
+        const packageRoot = this.getPackageRoot();
+        const librarySkillsDir = this.resolveFirstExistingDir([
+            path.join(this.hookSystemRoot, 'skills'),
+            path.join(packageRoot, 'skills')
+        ]);
 
-        if (!fs.existsSync(librarySkillsDir)) {
+        if (!librarySkillsDir) {
             return;
         }
 
+        if (!fs.existsSync(claudeSkillsDir)) {
+            fs.mkdirSync(claudeSkillsDir, { recursive: true });
+        }
+
         const relevantSkills = this.getRelevantSkills(platforms);
 
         relevantSkills.forEach(skillName => {
@@ -58,9 +110,13 @@ class HookInstaller {
     }
 
     installHooks(claudeHooksDir) {
-        const libraryHooksDir = path.join(this.hookSystemRoot, 'hooks');
+        const packageRoot = this.getPackageRoot();
+        const libraryHooksDir = this.resolveFirstExistingDir([
+            path.join(this.hookSystemRoot, 'hooks'),
+            path.join(packageRoot, 'hooks')
+        ]);
 
-        if (!fs.existsSync(libraryHooksDir)) {
+        if (!libraryHooksDir) {
             return;
         }
 
@@ -100,7 +156,8 @@ class HookInstaller {
     }
 
     copyIDERules() {
-        const sourceRulesDir = path.join(this.hookSystemRoot, '.cursor', 'rules');
+        const packageRoot = this.getPackageRoot();
+        const sourceRulesDir = path.join(packageRoot, '.cursor', 'rules');
 
         if (!fs.existsSync(sourceRulesDir)) {
             return;

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

@@ -3,6 +3,7 @@ const path = require('path');
 const { execSync } = require('child_process');
 const crypto = require('crypto');
 const os = require('os');
+const env = require('../../config/env');
 
 const COLORS = {
     reset: '\x1b[0m',
@@ -31,7 +32,7 @@ function computeRepoFingerprint(repoRoot) {
 
 function computeServerIdForRepo(repoRoot) {
     const legacyServerId = 'ast-intelligence-automation';
-    const forced = (process.env.MCP_SERVER_ID || '').trim();
+    const forced = (env.get('MCP_SERVER_ID', '') || '').trim();
     if (forced.length > 0) return forced;
 
     const repoName = path.basename(repoRoot || process.cwd());

package/scripts/hooks-system/application/services/logging/AuditLogger.js

@@ -3,7 +3,6 @@ const path = require('path');
 
 // Import recordMetric for prometheus metrics
 const { recordMetric } = require('../../../infrastructure/telemetry/metrics-logger');
-
 class AuditLogger {
     /**
      * @param {Object} options
@@ -18,7 +17,6 @@ class AuditLogger {
             status: 'started',
             repoRoot: repoRoot.substring(0, 100)
         });
-
         this.repoRoot = repoRoot;
         this.logger = logger;
         this.logPath = filename
@@ -147,7 +145,6 @@ class AuditLogger {
             status: 'started',
             metaKeys: Object.keys(meta || {}).length
         });
-
         const forbidden = ['token', 'password', 'secret', 'authorization', 'auth', 'apiKey'];
         const clone = {};
         Object.entries(meta).forEach(([k, v]) => {
@@ -165,7 +162,6 @@ class AuditLogger {
             status: 'success',
             metaKeys: Object.keys(clone).length
         });
-
         return clone;
     }
 }

package/scripts/hooks-system/application/services/logging/UnifiedLogger.js

@@ -97,10 +97,19 @@ class UnifiedLogger {
             this.rotateFileIfNeeded();
             fs.appendFileSync(this.fileConfig.path, `${JSON.stringify(entry)}\n`, 'utf8');
         } catch (error) {
-            if (process.env.DEBUG) {
-                console.error('[UnifiedLogger] Failed to write log file', {
-                    path: this.fileConfig.path,
-                    error: error.message
+            try {
+                const env = require('../../../config/env');
+                if (env.getBool('DEBUG', false)) {
+                    console.error('[UnifiedLogger] Failed to write log file', {
+                        path: this.fileConfig.path,
+                        error: error.message
+                    });
+                } else {
+                    console.warn('[UnifiedLogger] File logging skipped due to error');
+                }
+            } catch (secondaryError) {
+                console.error('[UnifiedLogger] Secondary logging failure', {
+                    error: secondaryError.message
                 });
             }
         }

package/scripts/hooks-system/application/services/monitoring/EvidenceMonitorService.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
+const env = require('../../config/env');
 
 function resolveUpdateEvidenceScript(repoRoot) {
     const candidates = [
@@ -25,9 +26,9 @@ class EvidenceMonitorService {
         updateScriptPath = resolveUpdateEvidenceScript(repoRoot) || path.join(process.cwd(), 'scripts', 'hooks-system', 'bin', 'update-evidence.sh'),
         notifier = () => { },
         logger = console,
-        autoRefreshEnabled = process.env.HOOK_GUARD_AUTO_REFRESH !== 'false',
-        autoRefreshCooldownMs = Number(process.env.HOOK_GUARD_AUTO_REFRESH_COOLDOWN || 180000),
-        staleThresholdMs = Number(process.env.HOOK_GUARD_EVIDENCE_STALE_THRESHOLD || 10 * 60 * 1000),
+        autoRefreshEnabled = env.getBool('HOOK_GUARD_AUTO_REFRESH', true),
+        autoRefreshCooldownMs = env.getNumber('HOOK_GUARD_AUTO_REFRESH_COOLDOWN', 180000),
+        staleThresholdMs = env.getNumber('HOOK_GUARD_EVIDENCE_STALE_THRESHOLD', 10 * 60 * 1000),
         fsModule = fs,
         execFn = execSync
     } = {}) {

package/scripts/hooks-system/application/services/token/TokenMetricsService.js

@@ -54,7 +54,8 @@ class TokenMetricsService {
         if (untrusted) {
             level = 'ok';
         }
-        const forceLevel = (process.env.TOKEN_MONITOR_FORCE_LEVEL || '').toLowerCase();
+        const env = require('../../config/env');
+        const forceLevel = (env.get('TOKEN_MONITOR_FORCE_LEVEL', '') || '').toLowerCase();
         if (forceLevel === 'warning' || forceLevel === 'critical' || forceLevel === 'ok') {
             level = forceLevel;
         }

package/scripts/hooks-system/bin/cli.js

@@ -121,7 +121,21 @@ const commands = {
   },
 
   ast: () => {
-    execSync(`node ${path.join(HOOKS_ROOT, 'infrastructure/ast/ast-intelligence.js')}`, { stdio: 'inherit' });
+    const env = { ...process.env };
+    const filteredArgs = [];
+
+    for (const arg of args) {
+      if (arg === '--staged') {
+        env.STAGING_ONLY_MODE = '1';
+      } else {
+        filteredArgs.push(arg);
+      }
+    }
+
+    execSync(
+      `node ${path.join(HOOKS_ROOT, 'infrastructure/ast/ast-intelligence.js')} ${filteredArgs.join(' ')}`,
+      { stdio: 'inherit', env }
+    );
   },
 
   install: () => {

package/scripts/hooks-system/bin/guard-env.sh

@@ -1,40 +1,20 @@
 #!/bin/bash
-# ═══════════════════════════════════════════════════════════════
-# Guard Environment Defaults
-# ═══════════════════════════════════════════════════════════════
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+IMPL="$REPO_ROOT/node_modules/@pumuki/ast-intelligence-hooks/scripts/hooks-system/bin/guard-env.sh"
+if [[ -f "$IMPL" ]]; then
+  # shellcheck disable=SC1090
+  source "$IMPL"
+  return 0 2>/dev/null || exit 0
+fi
 
-export HOOK_GUARD_EVIDENCE_STALE_THRESHOLD=${HOOK_GUARD_EVIDENCE_STALE_THRESHOLD:-180000}
-export HOOK_GUARD_EVIDENCE_POLL_INTERVAL=${HOOK_GUARD_EVIDENCE_POLL_INTERVAL:-30000}
-export HOOK_GUARD_EVIDENCE_REMINDER_INTERVAL=${HOOK_GUARD_EVIDENCE_REMINDER_INTERVAL:-120000}
-export HOOK_GUARD_INACTIVITY_GRACE_MS=${HOOK_GUARD_INACTIVITY_GRACE_MS:-60000}
-export HOOK_GUARD_AUTO_REFRESH=${HOOK_GUARD_AUTO_REFRESH:-true}
-export HOOK_GUARD_AI_START=${HOOK_GUARD_AI_START:-true}
-export HOOK_GUARD_AI_START_COOLDOWN=${HOOK_GUARD_AI_START_COOLDOWN:-60000}
-export HOOK_GUARD_EMBEDDED_TOKEN_MONITOR=${HOOK_GUARD_EMBEDDED_TOKEN_MONITOR:-false}
-export HOOK_GUARD_AUTORELOAD_DEBOUNCE=${HOOK_GUARD_AUTORELOAD_DEBOUNCE:-1500}
-export HOOK_GUARD_AUTORELOAD_FORCE=${HOOK_GUARD_AUTORELOAD_FORCE:-5000}
-export HOOK_GUARD_DIRTY_TREE_LIMIT=${HOOK_GUARD_DIRTY_TREE_LIMIT:-24}
-export HOOK_GUARD_DIRTY_TREE_WARNING=${HOOK_GUARD_DIRTY_TREE_WARNING:-12}
-export HOOK_GUARD_DIRTY_TREE_INTERVAL=${HOOK_GUARD_DIRTY_TREE_INTERVAL:-60000}
-export HOOK_GUARD_DIRTY_TREE_REMINDER=${HOOK_GUARD_DIRTY_TREE_REMINDER:-300000}
-export TOKEN_MONITOR_INTERVAL=${TOKEN_MONITOR_INTERVAL:-180}
-export TOKEN_MONITOR_REMINDER_SECONDS=${TOKEN_MONITOR_REMINDER_SECONDS:-180}
-export TOKEN_MONITOR_MIN_DELTA=${TOKEN_MONITOR_MIN_DELTA:-25000}
-export HOOK_GUARD_GITFLOW_AUTOSYNC=${HOOK_GUARD_GITFLOW_AUTOSYNC:-true}
-export HOOK_GUARD_GITFLOW_AUTOSYNC_INTERVAL=${HOOK_GUARD_GITFLOW_AUTOSYNC_INTERVAL:-300000}
-export HOOK_GUARD_GITFLOW_AUTOSYNC_COOLDOWN=${HOOK_GUARD_GITFLOW_AUTOSYNC_COOLDOWN:-900000}
-export HOOK_GUARD_GITFLOW_AUTOCLEAN=${HOOK_GUARD_GITFLOW_AUTOCLEAN:-true}
-export HOOK_GUARD_GITFLOW_MAIN_BRANCH=${HOOK_GUARD_GITFLOW_MAIN_BRANCH:-main}
-export HOOK_GUARD_GITFLOW_DEVELOP_BRANCH=${HOOK_GUARD_GITFLOW_DEVELOP_BRANCH:-develop}
-export HOOK_GUARD_GITFLOW_REQUIRE_CLEAN=${HOOK_GUARD_GITFLOW_REQUIRE_CLEAN:-true}
-export GUARD_AUTOSTART_HEALTHY_INTERVAL=${GUARD_AUTOSTART_HEALTHY_INTERVAL:-0}
-export GUARD_AUTOSTART_HEALTHY_COOLDOWN=${GUARD_AUTOSTART_HEALTHY_COOLDOWN:-900000}
-export HOOK_GUARD_HEARTBEAT_PATH="${HOOK_GUARD_HEARTBEAT_PATH:-.audit_tmp/guard-heartbeat.json}"
-export HOOK_GUARD_HEARTBEAT_INTERVAL=${HOOK_GUARD_HEARTBEAT_INTERVAL:-15000}
-export HOOK_GUARD_HEARTBEAT_MAX_AGE=${HOOK_GUARD_HEARTBEAT_MAX_AGE:-45000}
-export HOOK_GUARD_HEARTBEAT_CHECK_INTERVAL=${HOOK_GUARD_HEARTBEAT_CHECK_INTERVAL:-15000}
-export HOOK_GUARD_HEARTBEAT_NOTIFY_COOLDOWN=${HOOK_GUARD_HEARTBEAT_NOTIFY_COOLDOWN:-180000}
-export HOOK_GUARD_GITFLOW_MONITOR=${HOOK_GUARD_GITFLOW_MONITOR:-true}
-export HOOK_GUARD_GITFLOW_MONITOR_INTERVAL=${HOOK_GUARD_GITFLOW_MONITOR_INTERVAL:-300000}
-export HOOK_GUARD_GITFLOW_BRANCH_COOLDOWN=${HOOK_GUARD_GITFLOW_BRANCH_COOLDOWN:-900000}
-export HOOK_GUARD_DEV_DOCS_AUTO_REFRESH=${HOOK_GUARD_DEV_DOCS_AUTO_REFRESH:-true}
+IMPL="$REPO_ROOT/node_modules/pumuki-ast-hooks/scripts/hooks-system/bin/guard-env.sh"
+if [[ -f "$IMPL" ]]; then
+  # shellcheck disable=SC1090
+  source "$IMPL"
+  return 0 2>/dev/null || exit 0
+fi
+
+echo "guard-env.sh implementation not found. Please reinstall dependencies." >&2
+return 1 2>/dev/null || exit 1