pumuki-ast-hooks 5.5.42 → 5.5.43

package/docs/USAGE.md

@@ -61,7 +61,33 @@ Done! You now have AST Intelligence working in your project.
 
 ### Code Analysis
 
-#### Interactive Menu (Recommended)
+### Evidence Guard (auto-refresh)
+
+The Evidence Guard daemon refreshes `.AI_EVIDENCE.json` periodically (default: every 180s).
+
+Notes:
+- The refresh updates evidence and records the current quality gate status.
+- In auto-refresh mode, a failing quality gate does not break the daemon.
+
+Useful commands:
+```bash
+# Daemon control
+npm run ast:guard:start
+npm run ast:guard:stop
+npm run ast:guard:status
+npm run ast:guard:logs
+```
+
+Gate scope:
+```bash
+# Default is staging (only staged files)
+AI_GATE_SCOPE=staging bash ./scripts/hooks-system/bin/update-evidence.sh --auto
+
+# Repository-wide gate evaluation
+AI_GATE_SCOPE=repo bash ./scripts/hooks-system/bin/update-evidence.sh --auto
+```
+
+### Interactive Menu (Recommended)
 
 The library includes an **interactive menu** for selecting audit options:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "5.5.42",
+  "version": "5.5.43",
   "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/infrastructure/orchestration/intelligent-audit.js

@@ -254,6 +254,9 @@ async function runIntelligentAudit() {
     const rawViolations = loadRawViolations();
     console.log(`[Intelligent Audit] Loaded ${rawViolations.length} violations from AST`);
 
+    const autoEvidenceTrigger = String(env.get('AUTO_EVIDENCE_TRIGGER', process.env.AUTO_EVIDENCE_TRIGGER || '') || '').trim().toLowerCase();
+    const isAutoEvidenceRefresh = autoEvidenceTrigger === 'auto';
+
     const gateScope = String(env.get('AI_GATE_SCOPE', 'staging') || 'staging').trim().toLowerCase();
     const isRepoScope = gateScope === 'repo' || gateScope === 'repository';
 
@@ -311,6 +314,11 @@ async function runIntelligentAudit() {
     const gatePolicies = new GatePolicies();
     const gateResult = gatePolicies.apply(enhancedViolations);
 
+    if (isAutoEvidenceRefresh && !gateResult.passed) {
+      console.log('[Intelligent Audit] ℹ️  Auto evidence refresh: preserving gate status but not failing process exit code');
+      gateResult.exitCode = 0;
+    }
+
     console.log(`[Intelligent Audit] Gate status: ${gateResult.passed ? '✅ PASSED' : '❌ FAILED'}`);
     if (gateResult.blockedBy) {
       console.log(`[Intelligent Audit] Blocked by: ${gateResult.blockedBy} violations`);