pumuki-ast-hooks 5.5.0 → 5.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "5.5.0",
+  "version": "5.5.2",
   "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/mcp/ast-intelligence-automation.js

@@ -964,169 +964,189 @@ async function handleMcpMessage(message) {
     }
 }
 
+// Flag to track if MCP has been initialized
+let mcpInitialized = false;
+
 // Start protocol handler
-protocolHandler.start(handleMcpMessage);
+protocolHandler.start(async (message) => {
+    const response = await handleMcpMessage(message);
+
+    // Start polling loops ONLY after receiving 'initialized' notification from Windsurf
+    if (!mcpInitialized && message.includes('"method":"initialized"')) {
+        mcpInitialized = true;
+        process.stderr.write(`[MCP] Received 'initialized' - starting background loops\n`);
+        startPollingLoops();
+    }
+
+    return response;
+});
+
+// Log MCP ready
+process.stderr.write(`[MCP] Server ready for ${REPO_ROOT}\n`);
 
 /**
- * Polling loop for background notifications and automations
+ * Start polling loops for background notifications and automations
+ * Called ONLY after MCP handshake is complete
  */
-setInterval(async () => {
-    try {
-        const now = Date.now();
-        const gitFlowService = getCompositionRoot().getGitFlowService();
-        const gitQuery = getCompositionRoot().getGitQueryAdapter();
-        const evidenceMonitor = getCompositionRoot().getEvidenceMonitor();
-        const orchestrator = getCompositionRoot().getOrchestrator();
-
-        const currentBranch = gitFlowService.getCurrentBranch();
-        const baseBranch = process.env.AST_BASE_BRANCH || 'develop';
-        const isProtectedBranch = ['main', 'master', baseBranch].includes(currentBranch);
-
-        const uncommittedChanges = gitQuery.getUncommittedChanges();
-        const hasUncommittedChanges = uncommittedChanges && uncommittedChanges.length > 0;
-
-        // 1. Protected Branch Guard
-        if (isProtectedBranch && hasUncommittedChanges) {
-            if (now - lastGitFlowNotification > NOTIFICATION_COOLDOWN) {
-                const state = gitQuery.getBranchState(currentBranch);
-                sendNotification(
-                    '⚠️ Git Flow Violation',
-                    `branch=${currentBranch} changes detected on protected branch. Create a feature branch.`,
-                    'Basso'
-                );
-                lastGitFlowNotification = now;
-            }
-        }
-
-        // 2. Evidence Freshness Guard
-        if (evidenceMonitor.isStale() && (now - lastEvidenceNotification > NOTIFICATION_COOLDOWN)) {
-            try {
-                await evidenceMonitor.refresh();
-                sendNotification('🔄 Evidence Auto-Updated', 'AI Evidence has been refreshed automatically', 'Purr');
-            } catch (err) {
-                sendNotification('⚠️ Evidence Stale', `Failed to auto-refresh evidence: ${err.message}`, 'Basso');
+function startPollingLoops() {
+    setInterval(async () => {
+        try {
+            const now = Date.now();
+            const gitFlowService = getCompositionRoot().getGitFlowService();
+            const gitQuery = getCompositionRoot().getGitQueryAdapter();
+            const evidenceMonitor = getCompositionRoot().getEvidenceMonitor();
+            const orchestrator = getCompositionRoot().getOrchestrator();
+
+            const currentBranch = gitFlowService.getCurrentBranch();
+            const baseBranch = process.env.AST_BASE_BRANCH || 'develop';
+            const isProtectedBranch = ['main', 'master', baseBranch].includes(currentBranch);
+
+            const uncommittedChanges = gitQuery.getUncommittedChanges();
+            const hasUncommittedChanges = uncommittedChanges && uncommittedChanges.length > 0;
+
+            // 1. Protected Branch Guard
+            if (isProtectedBranch && hasUncommittedChanges) {
+                if (now - lastGitFlowNotification > NOTIFICATION_COOLDOWN) {
+                    const state = gitQuery.getBranchState(currentBranch);
+                    sendNotification(
+                        '⚠️ Git Flow Violation',
+                        `branch=${currentBranch} changes detected on protected branch. Create a feature branch.`,
+                        'Basso'
+                    );
+                    lastGitFlowNotification = now;
+                }
             }
-            lastEvidenceNotification = now;
-        }
 
-        // 3. Autonomous Orchestration
-        if (orchestrator.shouldReanalyze()) {
-            const decision = await orchestrator.analyzeContext();
-            if (decision.action === 'auto-execute' && decision.platforms.length > 0) {
+            // 2. Evidence Freshness Guard
+            if (evidenceMonitor.isStale() && (now - lastEvidenceNotification > NOTIFICATION_COOLDOWN)) {
                 try {
                     await evidenceMonitor.refresh();
-                    sendNotification('✅ AI Start Executed', `Platforms: ${decision.platforms.map(p => p.platform.toUpperCase()).join(', ')}`, 'Glass');
-                } catch (e) {
-                    sendNotification('❌ AI Start Error', `Failed to execute: ${e.message}`, 'Basso');
+                    sendNotification('🔄 Evidence Auto-Updated', 'AI Evidence has been refreshed automatically', 'Purr');
+                } catch (err) {
+                    sendNotification('⚠️ Evidence Stale', `Failed to auto-refresh evidence: ${err.message}`, 'Basso');
                 }
+                lastEvidenceNotification = now;
             }
-        }
 
-    } catch (error) {
-        if (process.env.DEBUG) console.error('[MCP] Polling loop error:', error);
-    }
-}, 30000);
+            // 3. Autonomous Orchestration
+            if (orchestrator.shouldReanalyze()) {
+                const decision = await orchestrator.analyzeContext();
+                if (decision.action === 'auto-execute' && decision.platforms.length > 0) {
+                    try {
+                        await evidenceMonitor.refresh();
+                        sendNotification('✅ AI Start Executed', `Platforms: ${decision.platforms.map(p => p.platform.toUpperCase()).join(', ')}`, 'Glass');
+                    } catch (e) {
+                        sendNotification('❌ AI Start Error', `Failed to execute: ${e.message}`, 'Basso');
+                    }
+                }
+            }
 
-// AUTO-COMMIT: Only for project code changes (no node_modules, no library)
-setInterval(async () => {
-    if (!AUTO_COMMIT_ENABLED) {
-        return;
-    }
+        } catch (error) {
+            if (process.env.DEBUG) console.error('[MCP] Polling loop error:', error);
+        }
+    }, 30000);
 
-    const now = Date.now();
-    if (now - lastAutoCommitTime < AUTO_COMMIT_INTERVAL) return;
+    // AUTO-COMMIT: Only for project code changes (no node_modules, no library)
+    setInterval(async () => {
+        if (!AUTO_COMMIT_ENABLED) {
+            return;
+        }
 
-    try {
-        const gitFlowService = getCompositionRoot().getGitFlowService();
-        const gitQuery = getCompositionRoot().getGitQueryAdapter();
-        const gitCommand = getCompositionRoot().getGitCommandAdapter();
+        const now = Date.now();
+        if (now - lastAutoCommitTime < AUTO_COMMIT_INTERVAL) return;
 
-        const currentBranch = gitFlowService.getCurrentBranch();
-        const isFeatureBranch = currentBranch.match(/^(feature|fix|hotfix)\//);
+        try {
+            const gitFlowService = getCompositionRoot().getGitFlowService();
+            const gitQuery = getCompositionRoot().getGitQueryAdapter();
+            const gitCommand = getCompositionRoot().getGitCommandAdapter();
 
-        if (!isFeatureBranch) {
-            return;
-        }
+            const currentBranch = gitFlowService.getCurrentBranch();
+            const isFeatureBranch = currentBranch.match(/^(feature|fix|hotfix)\//);
 
-        if (gitFlowService.isClean()) {
-            return;
-        }
+            if (!isFeatureBranch) {
+                return;
+            }
 
-        // Get uncommitted changes
-        const uncommittedChanges = gitQuery.getUncommittedChanges();
-
-        // Detect library installation path
-        const libraryPath = getLibraryInstallPath();
-
-        // Filter changes: project code only
-        const filesToCommit = uncommittedChanges.filter(file => {
-            // Exclude noise
-            if (file.startsWith('node_modules/') ||
-                file.includes('package-lock.json') ||
-                file.startsWith('.git/') ||
-                file.startsWith('.cursor/') ||
-                file.startsWith('.ast-intelligence/') ||
-                file.startsWith('.vscode/') ||
-                file.startsWith('.idea/')) {
-                return false;
+            if (gitFlowService.isClean()) {
+                return;
             }
 
-            // Exclude library itself
-            if (libraryPath && file.startsWith(libraryPath + '/')) {
-                return false;
+            // Get uncommitted changes
+            const uncommittedChanges = gitQuery.getUncommittedChanges();
+
+            // Detect library installation path
+            const libraryPath = getLibraryInstallPath();
+
+            // Filter changes: project code only
+            const filesToCommit = uncommittedChanges.filter(file => {
+                // Exclude noise
+                if (file.startsWith('node_modules/') ||
+                    file.includes('package-lock.json') ||
+                    file.startsWith('.git/') ||
+                    file.startsWith('.cursor/') ||
+                    file.startsWith('.ast-intelligence/') ||
+                    file.startsWith('.vscode/') ||
+                    file.startsWith('.idea/')) {
+                    return false;
+                }
+
+                // Exclude library itself
+                if (libraryPath && file.startsWith(libraryPath + '/')) {
+                    return false;
+                }
+
+                // Code/Doc files only
+                const codeExtensions = ['.ts', '.tsx', '.js', '.jsx', '.swift', '.kt', '.py', '.java', '.go', '.rs', '.md', '.json', '.yaml', '.yml'];
+                return codeExtensions.some(ext => file.endsWith(ext));
+            });
+
+            if (filesToCommit.length === 0) {
+                return;
             }
 
-            // Code/Doc files only
-            const codeExtensions = ['.ts', '.tsx', '.js', '.jsx', '.swift', '.kt', '.py', '.java', '.go', '.rs', '.md', '.json', '.yaml', '.yml'];
-            return codeExtensions.some(ext => file.endsWith(ext));
-        });
+            // Stage files
+            filesToCommit.forEach(file => {
+                gitCommand.add(file);
+            });
 
-        if (filesToCommit.length === 0) {
-            return;
-        }
+            const branchType = currentBranch.split('/')[0];
+            const branchName = currentBranch.split('/').slice(1).join('/');
+            const commitMessage = `${branchType}(auto): ${branchName} - ${filesToCommit.length} files`;
 
-        // Stage files
-        filesToCommit.forEach(file => {
-            gitCommand.add(file);
-        });
+            // Commit
+            gitCommand.commit(commitMessage);
 
-        const branchType = currentBranch.split('/')[0];
-        const branchName = currentBranch.split('/').slice(1).join('/');
-        const commitMessage = `${branchType}(auto): ${branchName} - ${filesToCommit.length} files`;
+            sendNotification('✅ Auto-Commit', `${filesToCommit.length} files in ${currentBranch}`, 'Purr');
+            lastAutoCommitTime = now;
 
-        // Commit
-        gitCommand.commit(commitMessage);
+            if (AUTO_PUSH_ENABLED) {
+                if (gitFlowService.isGitHubAvailable()) {
+                    try {
+                        gitCommand.push('origin', currentBranch);
+                        sendNotification('✅ Auto-Push', `Pushed to origin/${currentBranch}`, 'Glass');
 
-        sendNotification('✅ Auto-Commit', `${filesToCommit.length} files in ${currentBranch}`, 'Purr');
-        lastAutoCommitTime = now;
+                        if (AUTO_PR_ENABLED) {
+                            const baseBranch = process.env.AST_BASE_BRANCH || 'develop';
+                            const branchState = gitQuery.getBranchState(currentBranch);
 
-        if (AUTO_PUSH_ENABLED) {
-            if (gitFlowService.isGitHubAvailable()) {
-                try {
-                    gitCommand.push('origin', currentBranch);
-                    sendNotification('✅ Auto-Push', `Pushed to origin/${currentBranch}`, 'Glass');
-
-                    if (AUTO_PR_ENABLED) {
-                        const baseBranch = process.env.AST_BASE_BRANCH || 'develop';
-                        const branchState = gitQuery.getBranchState(currentBranch);
-
-                        if (branchState.ahead >= 3) {
-                            const prTitle = `Auto-PR: ${branchName}`;
-                            const prUrl = gitFlowService.createPullRequest(currentBranch, baseBranch, prTitle, 'Automated PR by Pumuki Git Flow');
-                            if (prUrl) {
-                                sendNotification('✅ Auto-PR Created', prTitle, 'Hero');
+                            if (branchState.ahead >= 3) {
+                                const prTitle = `Auto-PR: ${branchName}`;
+                                const prUrl = gitFlowService.createPullRequest(currentBranch, baseBranch, prTitle, 'Automated PR by Pumuki Git Flow');
+                                if (prUrl) {
+                                    sendNotification('✅ Auto-PR Created', prTitle, 'Hero');
+                                }
                             }
                         }
-                    }
-                } catch (e) {
-                    if (!e.message.includes('No remote')) {
-                        sendNotification('⚠️ Auto-Push Failed', 'Push manual required', 'Basso');
+                    } catch (e) {
+                        if (!e.message.includes('No remote')) {
+                            sendNotification('⚠️ Auto-Push Failed', 'Push manual required', 'Basso');
+                        }
                     }
                 }
             }
-        }
 
-    } catch (error) {
-        if (process.env.DEBUG) console.error('[MCP] Auto-commit error:', error);
-    }
-}, AUTO_COMMIT_INTERVAL);
+        } catch (error) {
+            if (process.env.DEBUG) console.error('[MCP] Auto-commit error:', error);
+        }
+    }, AUTO_COMMIT_INTERVAL);
+}

package/scripts/hooks-system/infrastructure/mcp/services/McpProtocolHandler.js

@@ -11,6 +11,9 @@ class McpProtocolHandler {
     }
 
     start(messageHandler) {
+        // Log that we're starting
+        process.stderr.write('[MCP] Protocol handler starting...\n');
+
         this.inputStream.on('data', (chunk) => {
             const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk), 'utf8');
             void this._handleChunk(buf, messageHandler);
@@ -25,6 +28,9 @@ class McpProtocolHandler {
             if (this.logger) this.logger.error('MCP_STDIN_ERROR', { error: err.message });
             process.exit(1);
         });
+
+        // Log that we're ready
+        process.stderr.write('[MCP] Protocol handler ready\n');
     }
 
     async _handleChunk(chunk, messageHandler) {