pumuki 6.3.170 → 6.3.172

package/integrations/mcp/evidenceStdioServer.cli.ts

@@ -21,31 +21,6 @@ type JsonRpcResponse = {
 };
 
 const MCP_PROTOCOL_VERSION = '2024-11-05';
-const JSON_RPC_VERSION = '2.0';
-const EVIDENCE_HOST_ENV = 'PUMUKI_EVIDENCE_HOST';
-const EVIDENCE_ROUTE_ENV = 'PUMUKI_EVIDENCE_ROUTE';
-const EVIDENCE_PORT_ENV = 'PUMUKI_EVIDENCE_PORT';
-const PORT_PROBE_TIMEOUT_MS = 600;
-const EPHEMERAL_LISTENER_PORT = 0;
-const EMPTY_TEXT_LENGTH = 0;
-const DECIMAL_RADIX = 10;
-const PROCESS_FAILURE_EXIT_CODE = 1;
-const LINE_BREAK_WIDTH = 1;
-const TOOL_IMPLEMENTATION_VERSION = '1.0.0';
-const JSON_RPC_INVALID_REQUEST = -32600;
-const JSON_RPC_METHOD_NOT_FOUND = -32601;
-const JSON_RPC_INVALID_PARAMS = -32602;
-const JSON_RPC_INTERNAL_ERROR = -32603;
-const JSON_RPC_PARSE_ERROR = -32700;
-const LINE_BREAK_NOT_FOUND = -1;
-
-const readRequiredEnv = (name: string): string => {
-  const value = process.env[name];
-  if (typeof value === 'string' && value.trim().length > EMPTY_TEXT_LENGTH) {
-    return value;
-  }
-  throw new Error(`${name} is required for pumuki MCP evidence stdio bridge.`);
-};
 
 const toJsonRpcId = (value: unknown): JsonRpcId => {
   if (typeof value === 'string' || typeof value === 'number' || value === null) {
@@ -60,7 +35,7 @@ const sendMessage = (message: JsonRpcResponse): void => {
 
 const sendResult = (id: JsonRpcId, result: unknown): void => {
   sendMessage({
-    jsonrpc: JSON_RPC_VERSION,
+    jsonrpc: '2.0',
     id,
     result,
   });
@@ -68,7 +43,7 @@ const sendResult = (id: JsonRpcId, result: unknown): void => {
 
 const sendError = (id: JsonRpcId, code: number, message: string): void => {
   sendMessage({
-    jsonrpc: JSON_RPC_VERSION,
+    jsonrpc: '2.0',
     id,
     error: {
       code,
@@ -77,10 +52,10 @@ const sendError = (id: JsonRpcId, code: number, message: string): void => {
   });
 };
 
-const canConnectToAddress = async (host: string, port: number): Promise<boolean> =>
+const isPortInUse = async (host: string, port: number): Promise<boolean> =>
   await new Promise((resolve) => {
     const socket = new Socket();
-    socket.setTimeout(PORT_PROBE_TIMEOUT_MS);
+    socket.setTimeout(600);
     socket.once('connect', () => {
       socket.destroy();
       resolve(true);
@@ -96,14 +71,13 @@ const canConnectToAddress = async (host: string, port: number): Promise<boolean>
     socket.connect(port, host);
   });
 
-const findAvailableListenerNumber = async (host: string): Promise<number> =>
+const findEphemeralPort = async (host: string): Promise<number> =>
   await new Promise((resolve, reject) => {
     const probe = createServer();
     probe.once('error', reject);
-    probe.listen(EPHEMERAL_LISTENER_PORT, host, () => {
+    probe.listen(0, host, () => {
       const address = probe.address();
-      const port =
-        address && typeof address === 'object' ? address.port : EPHEMERAL_LISTENER_PORT;
+      const port = address && typeof address === 'object' ? address.port : 0;
       probe.close(() => resolve(port));
     });
   });
@@ -111,62 +85,45 @@ const findAvailableListenerNumber = async (host: string): Promise<number> =>
 const fetchJson = async (url: string): Promise<unknown> => {
   const response = await fetch(url);
   const text = await response.text();
-  if (text.trim().length === EMPTY_TEXT_LENGTH) {
+  if (text.trim().length === 0) {
     return {};
   }
   return JSON.parse(text) as unknown;
 };
 
-const writeDebugHealthProbeFailure = (error: unknown): void => {
-  if (process.env.PUMUKI_DEBUG !== '1') {
-    return;
-  }
-
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`[pumuki-mcp-evidence-stdio] health probe fallback: ${message}\n`);
-};
-
 const startOrReuseEvidenceHttp = async (): Promise<{
   host: string;
   port: number;
   route: string;
 }> => {
-  const host = readRequiredEnv(EVIDENCE_HOST_ENV);
-  const route = readRequiredEnv(EVIDENCE_ROUTE_ENV);
-  const parsedListener = Number.parseInt(readRequiredEnv(EVIDENCE_PORT_ENV), DECIMAL_RADIX);
-  if (!Number.isFinite(parsedListener)) {
-    throw new Error(`${EVIDENCE_PORT_ENV} must be a valid listener number.`);
-  }
-  const preferredListener = parsedListener;
-  const requestedListener =
-    preferredListener > EPHEMERAL_LISTENER_PORT
-      ? preferredListener
-      : await findAvailableListenerNumber(host);
-  const healthUrl = `http://${host}:${requestedListener}/health`;
+  const host = process.env.PUMUKI_EVIDENCE_HOST ?? '127.0.0.1';
+  const route = process.env.PUMUKI_EVIDENCE_ROUTE ?? '/ai-evidence';
+  const parsedPort = Number.parseInt(process.env.PUMUKI_EVIDENCE_PORT ?? '', 10);
+  const preferredPort = Number.isFinite(parsedPort) ? parsedPort : 7341;
+  const requestedPort = preferredPort > 0 ? preferredPort : await findEphemeralPort(host);
+  const healthUrl = `http://${host}:${requestedPort}/health`;
 
   try {
     const health = (await fetchJson(healthUrl)) as { status?: string };
     if (health.status === 'ok') {
-      return { host, port: requestedListener, route };
+      return { host, port: requestedPort, route };
     }
-  } catch (error) {
-    writeDebugHealthProbeFailure(error);
+  } catch {
+    // ignored
   }
 
-  const listenerInUse = await canConnectToAddress(host, requestedListener);
-  const resolvedListener = listenerInUse
-    ? await findAvailableListenerNumber(host)
-    : requestedListener;
+  const portInUse = await isPortInUse(host, requestedPort);
+  const resolvedPort = portInUse ? await findEphemeralPort(host) : requestedPort;
   startEvidenceContextServer({
     host,
-    port: resolvedListener,
+    port: resolvedPort,
     route,
     repoRoot: process.cwd(),
   });
 
   return {
     host,
-    port: resolvedListener,
+    port: resolvedPort,
     route,
   };
 };
@@ -234,8 +191,8 @@ const run = async (): Promise<void> => {
   ] as const;
 
   const handleRequest = async (request: JsonRpcRequest): Promise<void> => {
-    if (request.jsonrpc !== JSON_RPC_VERSION) {
-      sendError(toJsonRpcId(request.id), JSON_RPC_INVALID_REQUEST, 'Invalid JSON-RPC version.');
+    if (request.jsonrpc !== '2.0') {
+      sendError(toJsonRpcId(request.id), -32600, 'Invalid JSON-RPC version.');
       return;
     }
 
@@ -251,7 +208,7 @@ const run = async (): Promise<void> => {
         protocolVersion: MCP_PROTOCOL_VERSION,
         serverInfo: {
           name: 'pumuki-evidence-stdio',
-          version: TOOL_IMPLEMENTATION_VERSION,
+          version: '1.0.0',
         },
         capabilities: {
           tools: {
@@ -292,7 +249,7 @@ const run = async (): Promise<void> => {
       const name = typeof params.name === 'string' ? params.name : '';
       const tool = toolsCatalog.find((entry) => entry.name === name);
       if (!tool) {
-        sendError(id, JSON_RPC_INVALID_PARAMS, `Unknown tool: ${name}`);
+        sendError(id, -32602, `Unknown tool: ${name}`);
         return;
       }
       const payload = await fetchJson(`${baseUrl}${tool.path}`);
@@ -327,7 +284,7 @@ const run = async (): Promise<void> => {
       const uri = typeof params.uri === 'string' ? params.uri : '';
       const resource = resourcesCatalog.find((entry) => entry.uri === uri);
       if (!resource) {
-        sendError(id, JSON_RPC_INVALID_PARAMS, `Unknown resource URI: ${uri}`);
+        sendError(id, -32602, `Unknown resource URI: ${uri}`);
         return;
       }
       const payload = await fetchJson(`${baseUrl}${resource.path}`);
@@ -343,31 +300,31 @@ const run = async (): Promise<void> => {
       return;
     }
 
-    sendError(id, JSON_RPC_METHOD_NOT_FOUND, `Method not found: ${method}`);
+    sendError(id, -32601, `Method not found: ${method}`);
   };
 
   const processBuffer = (): void => {
     while (true) {
       const lineEnd = textBuffer.indexOf('\n');
-      if (lineEnd === LINE_BREAK_NOT_FOUND) {
+      if (lineEnd === -1) {
         return;
       }
       const rawLine = textBuffer.slice(0, lineEnd).trim();
-      textBuffer = textBuffer.slice(lineEnd + LINE_BREAK_WIDTH);
-      if (rawLine.length === EMPTY_TEXT_LENGTH) {
+      textBuffer = textBuffer.slice(lineEnd + 1);
+      if (rawLine.length === 0) {
         continue;
       }
       let payload: JsonRpcRequest;
       try {
         payload = JSON.parse(rawLine) as JsonRpcRequest;
       } catch {
-        sendError(null, JSON_RPC_PARSE_ERROR, 'Parse error');
+        sendError(null, -32700, 'Parse error');
         continue;
       }
       void handleRequest(payload).catch((error) => {
         const id = toJsonRpcId(payload.id);
         const message = error instanceof Error ? error.message : 'Internal error';
-        sendError(id, JSON_RPC_INTERNAL_ERROR, message);
+        sendError(id, -32603, message);
       });
     }
   };
@@ -381,5 +338,5 @@ const run = async (): Promise<void> => {
 void run().catch((error) => {
   const message = error instanceof Error ? error.message : 'Unknown MCP stdio bridge error';
   process.stderr.write(`[pumuki-mcp-evidence-stdio] ${message}\n`);
-  process.exit(PROCESS_FAILURE_EXIT_CODE);
+  process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pumuki",
-  "version": "6.3.170",
-  "description": "Enterprise AST Intelligence and delivery gate for AI-assisted teams: Git hooks, SDD/OpenSpec, skills enforcement, MCP context, and audit evidence for iOS, Android, backend, and frontend repositories.",
+  "version": "6.3.172",
+  "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": {
     "pumuki": "bin/pumuki.js",