pumuki-ast-hooks 5.3.30 → 5.4.0

package/docs/VIOLATIONS_RESOLUTION_PLAN.md

@@ -45,22 +45,22 @@ gantt
 ## 🔴 Phase 1: BLOCKER Violations (CRITICAL + HIGH)
 | Status | Severity | Count | Owner | DOD (Definition of Done) | Source |
 |--------|-----------|-------|-------------|--------------------------|--------|
-| 🚧 | CRITICAL | 3 | BE | Resolve CRITICAL violations in repository (0 CRITICAL to unblock) | `.audit_tmp/ast-summary.json` / `.violations-by-priority.md` |
-| 🚧 | HIGH | 6 | BE | Resolve HIGH violations in repository (0 HIGH to unblock) | `.audit_tmp/ast-summary.json` / `.violations-by-priority.md` |
+| ✅ | CRITICAL | 0 | BE | Resolve CRITICAL violations in repository (0 CRITICAL to unblock) | `.audit_tmp/ast-summary.json` / `.violations-by-priority.md` |
+| ✅ | HIGH | 0 | BE | Resolve HIGH violations in repository (0 HIGH to unblock) | `.audit_tmp/ast-summary.json` / `.violations-by-priority.md` |
 
 ---
 
-## 🟠 Phase 2: MEDIUM Violations (272)
+## 🟠 Phase 2: MEDIUM Violations (277)
 | Status | Violation | Count | Owner | DOD | Doc |
 |--------|-----------|-------|-------------|-----|-----|
-| 🚧 | MEDIUM | 272 | BE | Resolve remaining medium-complexity violations | [Medium violations](../docs/medium-violations.md) |
+| 🚧 | MEDIUM | 277 | BE | Resolve remaining medium-complexity violations | [Medium violations](../docs/medium-violations.md) |
 
 ---
 
-## 🔵 Phase 3: LOW Violations (213)
+## 🔵 Phase 3: LOW Violations (218)
 | Status | Violation | Count | Owner | DOD | Doc |
 |--------|-----------|-------|-------------|-----|-----|
-| 🚧 | LOW | 213 | BE/FE | Resolve remaining low-priority violations | [Low violations](../docs/low-violations.md) |
+| 🚧 | LOW | 218 | BE/FE | Resolve remaining low-priority violations | [Low violations](../docs/low-violations.md) |
 
 ---
 
@@ -83,10 +83,10 @@ gantt
 ## 📈 Progress Metrics
 | Phase | Total | Completed | % |
 |------|-------|------------|---|
-| BLOCKERS (CRITICAL + HIGH) | 216 | 0 | 0% |
-| MEDIUM | 122 | 0 | 0% |
-| LOW | 185 | 0 | 0% |
-| **TOTAL** | **523** | **0** | **0%** |
+| BLOCKERS (CRITICAL + HIGH) | 9 | 9 | 100% |
+| MEDIUM | 272 | 0 | 0% |
+| LOW | 213 | 0 | 0% |
+| **TOTAL** | **494** | **9** | **1.8%** |
 
 **Updated risks:**  
 1) Prometheus implementation may require infra changes; 2) Security review depends on team availability; 3) Refactors may impact timelines.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "5.3.30",
+  "version": "5.4.0",
   "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": {
@@ -123,4 +123,4 @@
     "./skills": "./skills/skill-rules.json",
     "./hooks": "./hooks/index.js"
   }
-}
+}

package/scripts/hooks-system/application/CompositionRoot.js

@@ -1,31 +1,8 @@
-const MacOSNotificationAdapter = require('../infrastructure/adapters/MacOSNotificationAdapter');
-const FileEvidenceAdapter = require('../infrastructure/adapters/FileEvidenceAdapter');
-const GitQueryAdapter = require('../infrastructure/adapters/GitQueryAdapter');
-const GitCommandAdapter = require('../infrastructure/adapters/GitCommandAdapter');
-const GitHubCliAdapter = require('../infrastructure/adapters/GitHubCliAdapter');
-const AstAnalyzerAdapter = require('../infrastructure/adapters/AstAnalyzerAdapter');
-
-const AutonomousOrchestrator = require('./services/AutonomousOrchestrator');
-const ContextDetectionEngine = require('./services/ContextDetectionEngine');
-const PlatformDetectionService = require('./services/PlatformDetectionService');
-const AutoExecuteAIStartUseCase = require('./use-cases/AutoExecuteAIStartUseCase');
-
-// Services & Monitors
-const RealtimeGuardService = require('./services/RealtimeGuardService');
-const UnifiedLogger = require('./services/logging/UnifiedLogger');
-const NotificationCenterService = require('./services/notification/NotificationCenterService');
-const GitFlowService = require('./services/GitFlowService');
-const EvidenceMonitor = require('./services/monitoring/EvidenceMonitor');
-const GitTreeMonitor = require('./services/monitoring/GitTreeMonitor');
-const TokenMonitor = require('./services/monitoring/TokenMonitor');
-const ActivityMonitor = require('./services/monitoring/ActivityMonitor');
-const DevDocsMonitor = require('./services/monitoring/DevDocsMonitor');
-const AstMonitor = require('./services/monitoring/AstMonitor');
-const AuditLogger = require('./services/logging/AuditLogger');
-
+const AdapterFactory = require('./factories/AdapterFactory');
+const ServiceFactory = require('./factories/ServiceFactory');
+const MonitorFactory = require('./factories/MonitorFactory');
 const path = require('path');
 const fs = require('fs');
-const env = require('../config/env');
 
 class CompositionRoot {
     constructor(repoRoot) {
@@ -36,6 +13,39 @@ class CompositionRoot {
         this.auditDir = path.join(repoRoot, '.audit-reports');
         this.tempDir = path.join(repoRoot, '.audit_tmp');
         this._ensureDirectories([this.auditDir, this.tempDir]);
+
+        // Initialize factories lazily
+        this._adapterFactory = null;
+        this._serviceFactory = null;
+        this._monitorFactory = null;
+
+        // Create dynamic proxy for automatic delegation
+        return new Proxy(this, {
+            get(target, prop) {
+                // If method exists in CompositionRoot, use it
+                if (typeof target[prop] === 'function' && target.hasOwnProperty(prop)) {
+                    return target[prop].bind(target);
+                }
+
+                // Delegate to specialized factories
+                if (target._serviceFactory && typeof target._serviceFactory[prop] === 'function') {
+                    return target._serviceFactory[prop].bind(target._serviceFactory);
+                }
+                if (target._adapterFactory && typeof target._adapterFactory[prop] === 'function') {
+                    return target._adapterFactory[prop].bind(target._adapterFactory);
+                }
+                if (target._monitorFactory && typeof target._monitorFactory[prop] === 'function') {
+                    return target._monitorFactory[prop].bind(target._monitorFactory);
+                }
+
+                // Para acceso a propiedades de factories
+                if (prop === '_serviceFactory') return target._serviceFactory;
+                if (prop === '_adapterFactory') return target._adapterFactory;
+                if (prop === '_monitorFactory') return target._monitorFactory;
+
+                return target[prop];
+            }
+        });
     }
 
     _ensureDirectories(dirs) {
@@ -46,283 +56,48 @@ class CompositionRoot {
         });
     }
 
-    getLogger() {
-        if (!this.instances.has('logger')) {
-            this.instances.set('logger', new UnifiedLogger({
-                component: 'HookSystem',
-                file: {
-                    enabled: true,
-                    path: path.join(this.auditDir, 'guard-audit.jsonl'),
-                    level: env.get('HOOK_LOG_LEVEL', env.isProd ? 'warn' : 'info')
-                },
-                console: {
-                    enabled: false,
-                    level: 'info'
-                }
-            }));
-        }
-        return this.instances.get('logger');
-    }
-
-    getNotificationService() {
-        if (!this.instances.has('notificationService')) {
-            const logger = this.getLogger();
-            this.instances.set('notificationService', new NotificationCenterService({
-                repoRoot: this.repoRoot,
-                logger
-            }));
-        }
-        return this.instances.get('notificationService');
-    }
-
-    getAuditLogger() {
-        if (!this.instances.has('auditLogger')) {
-            const logger = this.getLogger();
-            this.instances.set('auditLogger', new AuditLogger({
-                repoRoot: this.repoRoot,
-                filename: path.join('.audit_tmp', 'audit.log'),
-                logger
-            }));
-        }
-        return this.instances.get('auditLogger');
-    }
-
-    // --- Infrastructure Adapters ---
-
-    getNotificationAdapter() {
-        if (!this.instances.has('notificationAdapter')) {
-            this.instances.set('notificationAdapter', new MacOSNotificationAdapter());
-        }
-        return this.instances.get('notificationAdapter');
-    }
-
-    getEvidenceAdapter() {
-        if (!this.instances.has('evidenceAdapter')) {
-            this.instances.set('evidenceAdapter', new FileEvidenceAdapter(this.repoRoot));
-        }
-        return this.instances.get('evidenceAdapter');
-    }
-
-    getGitQueryAdapter() {
-        if (!this.instances.has('gitQuery')) {
-            const logger = this.getLogger();
-            this.instances.set('gitQuery', new GitQueryAdapter({ repoRoot: this.repoRoot, logger }));
-        }
-        return this.instances.get('gitQuery');
-    }
-
-    getGitCommandAdapter() {
-        if (!this.instances.has('gitCommand')) {
-            const logger = this.getLogger();
-            this.instances.set('gitCommand', new GitCommandAdapter({ repoRoot: this.repoRoot, logger }));
-        }
-        return this.instances.get('gitCommand');
-    }
-
-    getGitHubAdapter() {
-        if (!this.instances.has('github')) {
-            const logger = this.getLogger();
-            this.instances.set('github', new GitHubCliAdapter(this.repoRoot, logger));
+    _getAdapterFactory() {
+        if (!this._adapterFactory) {
+            this._adapterFactory = new AdapterFactory(this.repoRoot, this.instances, this.getLogger());
         }
-        return this.instances.get('github');
+        return this._adapterFactory;
     }
 
-    getAstAdapter() {
-        if (!this.instances.has('ast')) {
-            this.instances.set('ast', new AstAnalyzerAdapter(this.repoRoot));
+    _getServiceFactory() {
+        if (!this._serviceFactory) {
+            this._serviceFactory = new ServiceFactory(this.repoRoot, this.instances, this._getAdapterFactory());
         }
-        return this.instances.get('ast');
+        return this._serviceFactory;
     }
 
-    // --- Domain Services ---
-
-    getContextDetectionEngine() {
-        if (!this.instances.has('contextEngine')) {
-            const gitQuery = this.getGitQueryAdapter();
-            const logger = this.getLogger();
-            this.instances.set('contextEngine', new ContextDetectionEngine(gitQuery, logger));
+    _getMonitorFactory() {
+        if (!this._monitorFactory) {
+            this._monitorFactory = new MonitorFactory(this.repoRoot, this.instances, this._getServiceFactory());
         }
-        return this.instances.get('contextEngine');
+        return this._monitorFactory;
     }
 
-    getPlatformDetectionService() {
-        if (!this.instances.has('platformDetector')) {
-            this.instances.set('platformDetector', new PlatformDetectionService());
-        }
-        return this.instances.get('platformDetector');
-    }
-
-    getOrchestrator() {
-        if (!this.instances.has('orchestrator')) {
-            const contextEngine = this.getContextDetectionEngine();
-            const platformDetector = this.getPlatformDetectionService();
-            const logger = this.getLogger();
-            // Note: RulesLoader is currently null in Factory, maintaining that behavior or adding if needed
-
-            this.instances.set('orchestrator', new AutonomousOrchestrator(
-                contextEngine,
-                platformDetector,
-                null,
-                logger
-            ));
-        }
-        return this.instances.get('orchestrator');
+    // Essential methods that are not delegated
+    getLogger() {
+        return this._getServiceFactory().getLogger();
     }
 
-    getAutoExecuteAIStartUseCase() {
-        if (!this.instances.has('autoExecuteAIStart')) {
-            const orchestrator = this.getOrchestrator();
-            const logger = this.getLogger();
-            this.instances.set('autoExecuteAIStart', new AutoExecuteAIStartUseCase(orchestrator, this.repoRoot, logger));
-        }
-        return this.instances.get('autoExecuteAIStart');
+    getMonitors() {
+        return this._getMonitorFactory().getMonitors();
     }
 
-    getBlockCommitUseCase() {
-        if (!this.instances.has('blockCommit')) {
-            const BlockCommitUseCase = require('./use-cases/BlockCommitUseCase');
-            this.instances.set('blockCommit', new BlockCommitUseCase());
-        }
-        return this.instances.get('blockCommit');
+    getRealtimeGuardService() {
+        const monitors = this.getMonitors();
+        return this._getServiceFactory().getRealtimeGuardService(monitors);
     }
 
+    // MCP Protocol Handler (kept here as it's specific to MCP infrastructure)
     getMcpProtocolHandler(inputStream, outputStream) {
         const McpProtocolHandler = require('../infrastructure/mcp/services/McpProtocolHandler');
         const logger = this.getLogger();
         return new McpProtocolHandler(inputStream, outputStream, logger);
     }
 
-    // --- Monitors ---
-
-    getEvidenceMonitor() {
-        if (!this.instances.has('evidenceMonitor')) {
-            this.instances.set('evidenceMonitor', new EvidenceMonitor(this.repoRoot, {
-                staleThresholdMs: env.getNumber('HOOK_GUARD_EVIDENCE_STALE_THRESHOLD', 180000),
-                pollIntervalMs: env.getNumber('HOOK_GUARD_EVIDENCE_POLL_INTERVAL', 30000),
-                reminderIntervalMs: env.getNumber('HOOK_GUARD_EVIDENCE_REMINDER_INTERVAL', 60000)
-            }));
-        }
-        return this.instances.get('evidenceMonitor');
-    }
-
-    getGitTreeMonitor() {
-        if (!this.instances.has('gitTreeMonitor')) {
-            this.instances.set('gitTreeMonitor', new GitTreeMonitor(this.repoRoot, {
-                stagedThreshold: env.getNumber('HOOK_GUARD_DIRTY_TREE_STAGED_LIMIT', 10),
-                unstagedThreshold: env.getNumber('HOOK_GUARD_DIRTY_TREE_UNSTAGED_LIMIT', 15),
-                totalThreshold: env.getNumber('HOOK_GUARD_DIRTY_TREE_TOTAL_LIMIT', 20),
-                checkIntervalMs: env.getNumber('HOOK_GUARD_DIRTY_TREE_INTERVAL', 60000),
-                reminderMs: env.getNumber('HOOK_GUARD_DIRTY_TREE_REMINDER', 300000)
-            }));
-        }
-        return this.instances.get('gitTreeMonitor');
-    }
-
-    getTokenMonitor() {
-        if (!this.instances.has('tokenMonitor')) {
-            this.instances.set('tokenMonitor', new TokenMonitor(this.repoRoot));
-        }
-        return this.instances.get('tokenMonitor');
-    }
-
-    getGitFlowService() {
-        if (!this.instances.has('gitFlowService')) {
-            const logger = this.getLogger();
-            const gitQuery = this.getGitQueryAdapter();
-            const gitCommand = this.getGitCommandAdapter();
-            const github = this.getGitHubAdapter();
-
-            this.instances.set('gitFlowService', new GitFlowService(this.repoRoot, {
-                developBranch: env.get('HOOK_GUARD_GITFLOW_DEVELOP_BRANCH', 'develop'),
-                mainBranch: env.get('HOOK_GUARD_GITFLOW_MAIN_BRANCH', 'main'),
-                autoSyncEnabled: env.getBool('HOOK_GUARD_GITFLOW_AUTOSYNC', true),
-                autoCleanEnabled: env.getBool('HOOK_GUARD_GITFLOW_AUTOCLEAN', true),
-                requireClean: env.getBool('HOOK_GUARD_GITFLOW_REQUIRE_CLEAN', true)
-            }, logger, gitQuery, gitCommand, github));
-        }
-        return this.instances.get('gitFlowService');
-    }
-
-    getActivityMonitor() {
-        if (!this.instances.has('activityMonitor')) {
-            const logger = this.getLogger();
-            this.instances.set('activityMonitor', new ActivityMonitor({
-                repoRoot: this.repoRoot,
-                inactivityGraceMs: env.getNumber('HOOK_GUARD_INACTIVITY_GRACE_MS', 420000),
-                logger
-            }));
-        }
-        return this.instances.get('activityMonitor');
-    }
-
-    getDevDocsMonitor() {
-        if (!this.instances.has('devDocsMonitor')) {
-            const logger = this.getLogger();
-            const notificationService = this.getNotificationService();
-            this.instances.set('devDocsMonitor', new DevDocsMonitor({
-                repoRoot: this.repoRoot,
-                checkIntervalMs: env.getNumber('HOOK_GUARD_DEV_DOCS_CHECK_INTERVAL', 300000),
-                staleThresholdMs: env.getNumber('HOOK_GUARD_DEV_DOCS_STALE_THRESHOLD', 86400000),
-                autoRefreshEnabled: env.getBool('HOOK_GUARD_DEV_DOCS_AUTO_REFRESH', true),
-                logger,
-                notificationService
-            }));
-        }
-        return this.instances.get('devDocsMonitor');
-    }
-
-    getAstMonitor() {
-        if (!this.instances.has('astMonitor')) {
-            const logger = this.getLogger();
-            const notificationService = this.getNotificationService();
-            this.instances.set('astMonitor', new AstMonitor({
-                repoRoot: this.repoRoot,
-                debounceMs: env.getNumber('HOOK_AST_WATCH_DEBOUNCE', 8000),
-                cooldownMs: env.getNumber('HOOK_AST_WATCH_COOLDOWN', 30000),
-                enabled: env.getBool('HOOK_AST_WATCH', true),
-                logger,
-                notificationService
-            }));
-        }
-        return this.instances.get('astMonitor');
-    }
-
-    getMonitors() {
-        return {
-            evidence: this.getEvidenceMonitor(),
-            gitTree: this.getGitTreeMonitor(),
-            token: this.getTokenMonitor(),
-            gitFlow: this.getGitFlowService(),
-            activity: this.getActivityMonitor(),
-            devDocs: this.getDevDocsMonitor(),
-            ast: this.getAstMonitor()
-        };
-    }
-
-    getRealtimeGuardService() {
-        if (!this.instances.has('guardService')) {
-            const logger = this.getLogger();
-            const notificationService = this.getNotificationService();
-            const monitors = this.getMonitors();
-            const orchestrator = this.getOrchestrator();
-            const auditLogger = this.getAuditLogger();
-            const config = {
-                debugLogPath: path.join(this.auditDir, 'guard-debug.log'),
-                repoRoot: this.repoRoot
-            };
-
-            this.instances.set('guardService', new RealtimeGuardService({
-                logger,
-                notificationService,
-                monitors,
-                orchestration: orchestrator,
-                config,
-                auditLogger
-            }));
-        }
-        return this.instances.get('guardService');
-    }
-
     static createForProduction(repoRoot) {
         return new CompositionRoot(repoRoot);
     }

package/scripts/hooks-system/application/factories/AdapterFactory.js

@@ -0,0 +1,58 @@
+const MacOSNotificationAdapter = require('../../adapters/MacOSNotificationAdapter');
+const FileEvidenceAdapter = require('../../adapters/FileEvidenceAdapter');
+const GitQueryAdapter = require('../../adapters/GitQueryAdapter');
+const GitCommandAdapter = require('../../adapters/GitCommandAdapter');
+const GitHubCliAdapter = require('../../adapters/GitHubCliAdapter');
+const AstAnalyzerAdapter = require('../../adapters/AstAnalyzerAdapter');
+
+class AdapterFactory {
+    constructor(repoRoot, instances, logger) {
+        this.repoRoot = repoRoot;
+        this.instances = instances;
+        this.logger = logger;
+    }
+
+    getNotificationAdapter() {
+        if (!this.instances.has('notificationAdapter')) {
+            this.instances.set('notificationAdapter', new MacOSNotificationAdapter());
+        }
+        return this.instances.get('notificationAdapter');
+    }
+
+    getEvidenceAdapter() {
+        if (!this.instances.has('evidenceAdapter')) {
+            this.instances.set('evidenceAdapter', new FileEvidenceAdapter(this.repoRoot));
+        }
+        return this.instances.get('evidenceAdapter');
+    }
+
+    getGitQueryAdapter() {
+        if (!this.instances.has('gitQuery')) {
+            this.instances.set('gitQuery', new GitQueryAdapter({ repoRoot: this.repoRoot, logger: this.logger }));
+        }
+        return this.instances.get('gitQuery');
+    }
+
+    getGitCommandAdapter() {
+        if (!this.instances.has('gitCommand')) {
+            this.instances.set('gitCommand', new GitCommandAdapter({ repoRoot: this.repoRoot, logger: this.logger }));
+        }
+        return this.instances.get('gitCommand');
+    }
+
+    getGitHubAdapter() {
+        if (!this.instances.has('github')) {
+            this.instances.set('github', new GitHubCliAdapter(this.repoRoot, this.logger));
+        }
+        return this.instances.get('github');
+    }
+
+    getAstAdapter() {
+        if (!this.instances.has('ast')) {
+            this.instances.set('ast', new AstAnalyzerAdapter(this.repoRoot));
+        }
+        return this.instances.get('ast');
+    }
+}
+
+module.exports = AdapterFactory;

package/scripts/hooks-system/application/factories/MonitorFactory.js

@@ -0,0 +1,104 @@
+const EvidenceMonitor = require('../services/monitoring/EvidenceMonitor');
+const GitTreeMonitor = require('../services/monitoring/GitTreeMonitor');
+const TokenMonitor = require('../services/monitoring/TokenMonitor');
+const ActivityMonitor = require('../services/monitoring/ActivityMonitor');
+const DevDocsMonitor = require('../services/monitoring/DevDocsMonitor');
+const AstMonitor = require('../services/monitoring/AstMonitor');
+const env = require('../../config/env');
+
+class MonitorFactory {
+    constructor(repoRoot, instances, serviceFactory) {
+        this.repoRoot = repoRoot;
+        this.instances = instances;
+        this.serviceFactory = serviceFactory;
+    }
+
+    getEvidenceMonitor() {
+        if (!this.instances.has('evidenceMonitor')) {
+            this.instances.set('evidenceMonitor', new EvidenceMonitor(this.repoRoot, {
+                staleThresholdMs: env.getNumber('HOOK_GUARD_EVIDENCE_STALE_THRESHOLD', 180000),
+                pollIntervalMs: env.getNumber('HOOK_GUARD_EVIDENCE_POLL_INTERVAL', 30000),
+                reminderIntervalMs: env.getNumber('HOOK_GUARD_EVIDENCE_REMINDER_INTERVAL', 60000)
+            }));
+        }
+        return this.instances.get('evidenceMonitor');
+    }
+
+    getGitTreeMonitor() {
+        if (!this.instances.has('gitTreeMonitor')) {
+            this.instances.set('gitTreeMonitor', new GitTreeMonitor(this.repoRoot, {
+                stagedThreshold: env.getNumber('HOOK_GUARD_DIRTY_TREE_STAGED_LIMIT', 10),
+                unstagedThreshold: env.getNumber('HOOK_GUARD_DIRTY_TREE_UNSTAGED_LIMIT', 15),
+                totalThreshold: env.getNumber('HOOK_GUARD_DIRTY_TREE_TOTAL_LIMIT', 20),
+                checkIntervalMs: env.getNumber('HOOK_GUARD_DIRTY_TREE_INTERVAL', 60000),
+                reminderMs: env.getNumber('HOOK_GUARD_DIRTY_TREE_REMINDER', 300000)
+            }));
+        }
+        return this.instances.get('gitTreeMonitor');
+    }
+
+    getTokenMonitor() {
+        if (!this.instances.has('tokenMonitor')) {
+            this.instances.set('tokenMonitor', new TokenMonitor(this.repoRoot));
+        }
+        return this.instances.get('tokenMonitor');
+    }
+
+    getActivityMonitor() {
+        if (!this.instances.has('activityMonitor')) {
+            const logger = this.serviceFactory.getLogger();
+            this.instances.set('activityMonitor', new ActivityMonitor({
+                repoRoot: this.repoRoot,
+                inactivityGraceMs: env.getNumber('HOOK_GUARD_INACTIVITY_GRACE_MS', 420000),
+                logger
+            }));
+        }
+        return this.instances.get('activityMonitor');
+    }
+
+    getDevDocsMonitor() {
+        if (!this.instances.has('devDocsMonitor')) {
+            const logger = this.serviceFactory.getLogger();
+            const notificationService = this.serviceFactory.getNotificationService();
+            this.instances.set('devDocsMonitor', new DevDocsMonitor({
+                repoRoot: this.repoRoot,
+                checkIntervalMs: env.getNumber('HOOK_GUARD_DEV_DOCS_CHECK_INTERVAL', 300000),
+                staleThresholdMs: env.getNumber('HOOK_GUARD_DEV_DOCS_STALE_THRESHOLD', 86400000),
+                autoRefreshEnabled: env.getBool('HOOK_GUARD_DEV_DOCS_AUTO_REFRESH', true),
+                logger,
+                notificationService
+            }));
+        }
+        return this.instances.get('devDocsMonitor');
+    }
+
+    getAstMonitor() {
+        if (!this.instances.has('astMonitor')) {
+            const logger = this.serviceFactory.getLogger();
+            const notificationService = this.serviceFactory.getNotificationService();
+            this.instances.set('astMonitor', new AstMonitor({
+                repoRoot: this.repoRoot,
+                debounceMs: env.getNumber('HOOK_AST_WATCH_DEBOUNCE', 8000),
+                cooldownMs: env.getNumber('HOOK_AST_WATCH_COOLDOWN', 30000),
+                enabled: env.getBool('HOOK_AST_WATCH', true),
+                logger,
+                notificationService
+            }));
+        }
+        return this.instances.get('astMonitor');
+    }
+
+    getMonitors() {
+        return {
+            evidence: this.getEvidenceMonitor(),
+            gitTree: this.getGitTreeMonitor(),
+            token: this.getTokenMonitor(),
+            gitFlow: this.serviceFactory.getGitFlowService(),
+            activity: this.getActivityMonitor(),
+            devDocs: this.getDevDocsMonitor(),
+            ast: this.getAstMonitor()
+        };
+    }
+}
+
+module.exports = MonitorFactory;