pumuki 6.3.75 → 6.3.76

package/integrations/mcp/enterpriseServer.ts

@@ -39,6 +39,14 @@ type EnterpriseStatusPayload = {
   evidence: ReturnType<typeof toStatusPayload>;
 };
 
+type EnterpriseHealthPayload = {
+  status: 'ok';
+  repoRoot: string;
+  experimentalFeatures: {
+    mcp_enterprise: ReturnType<typeof resolveMcpEnterpriseExperimentalFeature>;
+  };
+};
+
 const ENTERPRISE_RESOURCES = [
   'evidence://status',
   'gitflow://state',
@@ -650,6 +658,14 @@ const buildStatusPayload = (repoRoot: string): EnterpriseStatusPayload => ({
   evidence: toStatusPayload(repoRoot),
 });
 
+const buildHealthPayload = (repoRoot: string): EnterpriseHealthPayload => ({
+  status: 'ok',
+  repoRoot,
+  experimentalFeatures: {
+    mcp_enterprise: readMcpEnterpriseExperimentalState(),
+  },
+});
+
 export const startEnterpriseMcpServer = (
   options: EnterpriseServerOptions = {}
 ): EnterpriseServerHandle => {
@@ -680,7 +696,7 @@ export const startEnterpriseMcpServer = (
         sendJson(res, 405, { error: 'Method not allowed' });
         return;
       }
-      sendJson(res, 200, { status: 'ok' });
+      sendJson(res, 200, buildHealthPayload(repoRoot));
       return;
     }
 

package/integrations/mcp/enterpriseStdioServer.cli.ts

@@ -1,5 +1,6 @@
 import { Socket, createServer } from 'node:net';
 import { startEnterpriseMcpServer } from './enterpriseServer';
+import { resolveMcpEnterpriseExperimentalFeature } from '../policy/experimentalFeatures';
 
 type JsonRpcId = string | number | null;
 
@@ -98,11 +99,32 @@ const fetchJson = async (url: string, options?: RequestInit): Promise<unknown> =
   }
 };
 
+type EnterpriseHealthPayload = {
+  status?: string;
+  repoRoot?: string;
+  experimentalFeatures?: {
+    mcp_enterprise?: {
+      mode?: string;
+    };
+  };
+};
+
+const canReuseEnterpriseHttp = (
+  health: EnterpriseHealthPayload,
+  repoRoot: string,
+  expectedMcpMode: string
+): boolean =>
+  health.status === 'ok'
+  && health.repoRoot === repoRoot
+  && health.experimentalFeatures?.mcp_enterprise?.mode === expectedMcpMode;
+
 const startOrReuseEnterpriseHttp = async (): Promise<{
   host: string;
   port: number;
   startedByThisProcess: boolean;
 }> => {
+  const repoRoot = process.cwd();
+  const expectedMcpMode = resolveMcpEnterpriseExperimentalFeature().mode;
   const host = process.env.PUMUKI_ENTERPRISE_MCP_HOST ?? '127.0.0.1';
   const parsedPort = Number.parseInt(process.env.PUMUKI_ENTERPRISE_MCP_PORT ?? '', 10);
   const preferredPort = Number.isFinite(parsedPort) ? parsedPort : 7391;
@@ -110,16 +132,21 @@ const startOrReuseEnterpriseHttp = async (): Promise<{
 
   const healthUrl = `http://${host}:${requestedPort}/health`;
   try {
-    const health = (await fetchJson(healthUrl)) as { status?: string };
-    if (health.status === 'ok') {
+    const health = (await fetchJson(healthUrl)) as EnterpriseHealthPayload;
+    if (canReuseEnterpriseHttp(health, repoRoot, expectedMcpMode)) {
       return {
         host,
         port: requestedPort,
         startedByThisProcess: false,
       };
     }
-  } catch {
-    // Intentionally ignored: endpoint not available yet.
+  } catch (error) {
+    if (process.env.PUMUKI_DEBUG_MCP === '1') {
+      const message = error instanceof Error ? error.message : String(error);
+      process.stderr.write(
+        `[pumuki-mcp-enterprise-stdio] health probe reuse skipped: ${message}\n`
+      );
+    }
   }
 
   const portInUse = await isPortInUse(host, requestedPort);
@@ -127,7 +154,7 @@ const startOrReuseEnterpriseHttp = async (): Promise<{
   startEnterpriseMcpServer({
     host,
     port: resolvedPort,
-    repoRoot: process.cwd(),
+    repoRoot,
   });
 
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.75",
+  "version": "6.3.76",
   "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": {